VintaSoft Twain .NET SDK 14.1: Руководство для .NET разработчика
Vintasoft.Sane Namespace / SaneAcquiredImage Class / Save Methods / Save(String,SaneImageEncoderSettings) Method
Синтаксис Exceptions Ремарки Example Требования Смотрите также
В этом разделе
    Save(String,SaneImageEncoderSettings) Метод (SaneAcquiredImage)
    В этом разделе
    Сохраняет это изображение в файл.
    Синтаксис
    'Declaration
    
    Public Overloads Sub Save( _
    ByVal filename
    Имя файла, в котором должно быть сохранено изображение.
    As String, _
    ByVal encoderSettings
    Настройки кодировщика изображения.
    As Vintasoft.Sane.ImageEncoders.SaneImageEncoderSettings _
    )

    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, совместимый с версией 1.4 или ранее стандарта PDF.


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

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

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

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

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

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

    Пример

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

    
    ''' <summary>
    ''' Acquires images from SANE device and saves images to a TIFF file.
    ''' </summary>
    Public Sub AcquireImagesFromSaneDeviceAndSaveImagesToTiffFile()
            ' create SANE device manager
            Using deviceManager As New Vintasoft.Sane.SaneLocalDeviceManager()
                    ' open SANE device manager
                    deviceManager.Open()
    
                    ' get count of SANE 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 SANE device
                    Dim device As Vintasoft.Sane.SaneLocalDevice = deviceManager.Devices(0)
    
                    ' open SANE device
                    device.Open()
    
                    Dim acquiredImage As Vintasoft.Sane.SaneAcquiredImage
                    Do
                            Try
                                    ' acquire image from SANE 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.Sane.ImageEncoders.SaneTiffEncoderSettings()
                                            ' specify that image must be added to a TIFF file
                                            tiffEncoderSettings.TiffMultiPage = True
                                            ' specify image must be compressed with LZW compression
                                            tiffEncoderSettings.TiffCompression = Vintasoft.Sane.ImageEncoders.SaneTiffCompression.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 device has more images to scan
                    Loop While device.HasMoreImagesToScan
    
                    ' close SANE device
                    device.Close()
    
                    ' close SANE device manager
                    deviceManager.Close()
            End Using
    
            System.Console.ReadLine()
    End Sub
    
    
    
    /// <summary>
    /// Acquires images from SANE device and saves images to a TIFF file.
    /// </summary>
    public void AcquireImagesFromSaneDeviceAndSaveImagesToTiffFile()
    {
        // create SANE device manager
        using (Vintasoft.Sane.SaneLocalDeviceManager deviceManager = new Vintasoft.Sane.SaneLocalDeviceManager())
        {
            // open SANE device manager
            deviceManager.Open();
    
            // get count of SANE devices
            int deviceCount = deviceManager.Devices.Count;
            if (deviceCount == 0)
            {
                System.Console.WriteLine("Devices are not found.");
                return;
            }
    
            // select the first SANE device
            Vintasoft.Sane.SaneLocalDevice device = deviceManager.Devices[0];
    
            // open SANE device
            device.Open();
    
            Vintasoft.Sane.SaneAcquiredImage acquiredImage;
            do
            {
                try
                {
                    // acquire image from SANE device
                    acquiredImage = device.AcquireImageSync();
                    // if image is received
                    if (acquiredImage != null)
                    {
                        System.Console.WriteLine("Image is acquired.");
    
                        // create TIFF encoder settings
                        Vintasoft.Sane.ImageEncoders.SaneTiffEncoderSettings tiffEncoderSettings =
                            new Vintasoft.Sane.ImageEncoders.SaneTiffEncoderSettings();
                        // specify that image must be added to a TIFF file
                        tiffEncoderSettings.TiffMultiPage = true;
                        // specify image must be compressed with LZW compression
                        tiffEncoderSettings.TiffCompression = Vintasoft.Sane.ImageEncoders.SaneTiffCompression.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 device has more images to scan
            while (device.HasMoreImagesToScan);
    
            // close SANE device
            device.Close();
    
            // close SANE device manager
            deviceManager.Close();
        }
    
        System.Console.ReadLine();
    }
    
    

    Требования

    Целевые платформы: .NET 8; .NET 7; .NET 6

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