VintaSoft Twain .NET SDK 15.3: Руководство для .NET разработчика
Vintasoft.WiaImageScanning Namespace / WiaAcquiredImage Class / Save Methods / Save(String,WiaImageEncoderSettings) Method
Синтаксис Exceptions Ремарки Example Требования Смотрите также
В этом разделе
    Save(String,WiaImageEncoderSettings) Метод (WiaAcquiredImage)
    В этом разделе
    Сохраняет это изображение в файл.
    Синтаксис

    Parameters

    filename
    Имя файла, в который необходимо сохранить изображение.
    encoderSettings
    Настройки энкодера изображений.
    Исключения
    ИсключениеОписание
    Выбрасывается, если filename равно null.
    Ремарки

    Изображение можно:
    - сохранить как файл изображения (BMP, JPEG, PNG, TIFF)
    - добавить в многостраничный TIFF файл
    - сохранить в новый PDF документ или PDF/A
    - добавить в существующий PDF документ или PDF/A

    Доступные сжатия для изображений, сохраненных в TIFF файл:
    - без сжатия
    - сжатие факса CCITT Group 4
    - сжатие LZW
    - сжатие ZIP
    - сжатие JPEG

    Доступные сжатия для изображений, сохраненных в PDF документ:
    - без сжатия
    - сжатие факса CCITT Group 4
    - сжатие LZW
    - сжатие ZIP
    - сжатие JPEG

    Изображение можно добавить в PDF документ, совместимый со стандартом PDF версии 1.4 или более ранней.


    Изображение будет сохранено как файл BMP, если

    • encoderSettings имеет значение null, а filename содержит расширение "bmp"
    • encoderSettings не имеет значение null, а encoderSettings является экземпляром типа WiaBmpEncoderSettings

    Изображение будет сохранено как JPEG файл, если
    • encoderSettings имеет значение null и filename не содержит расширение 'bmp', 'png', 'pdf', 'tif' и 'tiff'
    • encoderSettings не имеет значение null и encoderSettings является экземпляром типа WiaJpegEncoderSettings

    Изображение будет сохранено как PDF файл, если
    • encoderSettings имеет значение null и filename содержит расширение 'pdf'
    • encoderSettings не равен null и encoderSettings является экземпляром типа WiaPdfEncoderSettings

    Изображение будет сохранено как файл PNG, если
    • encoderSettings равен null и filename содержит расширение 'png'
    • encoderSettings не равен null и encoderSettings является экземпляром типа WiaPngEncoderSettings

    Изображение будет сохранено как TIFF файл, если
    • encoderSettings имеет значение null, а filename содержит расширение 'tif' или 'tiff'
    • encoderSettings не имеет значение null, а encoderSettings является экземпляром типа WiaTiffEncoderSettings

    Пример

    Вот C#/VB.NET код, который демонстрирует, как получить изображения с устройства WIA и сохранить их в TIFF файл.

    
    ''' <summary>
    ''' Acquires images from WIA device and saves images to a TIFF file.
    ''' </summary>
    Public Sub AcquireImagesFromWiaDeviceAndSaveImagesToTiffFile()
        ' create WIA device manager
        Using deviceManager As New Vintasoft.WiaImageScanning.WiaDeviceManager()
            ' open WIA device manager
            deviceManager.Open()
    
            ' get count of WIA devices
            Dim deviceCount As Integer = deviceManager.Devices.Count
            If deviceCount = 0 Then
                System.Console.WriteLine("Devices are not found.")
                Return
            End If
    
            ' select the first WIA device
            Dim device As Vintasoft.WiaImageScanning.WiaDevice = deviceManager.Devices(0)
    
            ' open WIA device
            device.Open()
    
            Dim acquiredImage As Vintasoft.WiaImageScanning.WiaAcquiredImage = Nothing
            Do
                Try
                    ' acquire image from WIA device
                    acquiredImage = device.AcquireImageSync()
                    ' if image is received
                    If acquiredImage IsNot Nothing Then
                        System.Console.WriteLine("Image is acquired.")
    
                        ' create TIFF encoder settings
                        Dim tiffEncoderSettings As New Vintasoft.WiaImageScanning.ImageEncoders.WiaTiffEncoderSettings()
                        ' specify that image must be added to a TIFF file
                        tiffEncoderSettings.TiffMultiPage = True
                        ' specify image must be compressed with LZW compression
                        tiffEncoderSettings.TiffCompression = Vintasoft.WiaImageScanning.ImageEncoders.WiaTiffCompression.LZW
    
                        ' process acquired image
                        acquiredImage.Save("test.tif", tiffEncoderSettings)
                    Else
                        ' if image is not received
                        System.Console.WriteLine("Scan is completed.")
                        Exit Try
                    End If
                Catch ex As System.Exception
                    System.Console.WriteLine(String.Format("Scan is failed: {0}", ex.Message))
                    Exit Try
                End Try
                ' while image is acquired
            Loop While acquiredImage IsNot Nothing
    
            ' close WIA device
            device.Close()
    
            ' close WIA device manager
            deviceManager.Close()
        End Using
    
        System.Console.ReadLine()
    End Sub
    
    
    
    /// <summary>
    /// Acquires images from WIA device and saves images to a TIFF file.
    /// </summary>
    public void AcquireImagesFromWiaDeviceAndSaveImagesToTiffFile()
    {
        // create WIA device manager
        using (Vintasoft.WiaImageScanning.WiaDeviceManager deviceManager = new Vintasoft.WiaImageScanning.WiaDeviceManager())
        {
            // open WIA device manager
            deviceManager.Open();
    
            // get count of WIA devices
            int deviceCount = deviceManager.Devices.Count;
            if (deviceCount == 0)
            {
                System.Console.WriteLine("Devices are not found.");
                return;
            }
    
            // select the first WIA device
            Vintasoft.WiaImageScanning.WiaDevice device = deviceManager.Devices[0];
    
            // open WIA device
            device.Open();
    
            Vintasoft.WiaImageScanning.WiaAcquiredImage acquiredImage = null;
            do
            {
                try
                {
                    // acquire image from WIA device
                    acquiredImage = device.AcquireImageSync();
                    // if image is received
                    if (acquiredImage != null)
                    {
                        System.Console.WriteLine("Image is acquired.");
    
                        // create TIFF encoder settings
                        Vintasoft.WiaImageScanning.ImageEncoders.WiaTiffEncoderSettings tiffEncoderSettings =
                            new Vintasoft.WiaImageScanning.ImageEncoders.WiaTiffEncoderSettings();
                        // specify that image must be added to a TIFF file
                        tiffEncoderSettings.TiffMultiPage = true;
                        // specify image must be compressed with LZW compression
                        tiffEncoderSettings.TiffCompression = Vintasoft.WiaImageScanning.ImageEncoders.WiaTiffCompression.LZW;
    
                        // process acquired image
                        acquiredImage.Save("test.tif", tiffEncoderSettings);
                    }
                    // if image is not received
                    else
                    {
                        System.Console.WriteLine("Scan is completed.");
                        break;
                    }
                }
                catch (System.Exception ex)
                {
                    System.Console.WriteLine(string.Format("Scan is failed: {0}", ex.Message));
                    break;
                }
            }
            // while image is acquired
            while (acquiredImage != null);
    
            // close WIA device
            device.Close();
    
            // close WIA device manager
            deviceManager.Close();
        }
    
        System.Console.ReadLine();
    }
    
    

    Требования

    Целевые платформы: .NET 9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

    Смотрите также