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

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 является экземпляром типа EsclBmpEncoderSettings

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

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

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

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

Пример

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


''' <summary>
''' Acquires images from eSCL device and saves images to a TIFF file.
''' </summary>
Public Sub AcquireImagesFromEsclDeviceAndSaveImagesToTiffFile()
    ' create eSCL device manager
    Using deviceManager As New Vintasoft.EsclImageScanning.EsclDeviceManager()
        ' open eSCL device manager
        deviceManager.Open()

        ' wait while the eSCL device manager searches for eSCL devices
        System.Threading.Thread.Sleep(deviceManager.DeviceSearchTimeout)
        ' get count of eSCL 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 eSCL device
        Dim device As Vintasoft.EsclImageScanning.EsclDevice = deviceManager.Devices(0)

        ' open eSCL device
        device.Open()

        Dim acquiredImage As Vintasoft.EsclImageScanning.EsclAcquiredImage = Nothing
        Do
            Try
                ' acquire image from eSCL 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.EsclImageScanning.ImageEncoders.EsclTiffEncoderSettings()
                    ' specify that image must be added to a TIFF file
                    tiffEncoderSettings.TiffMultiPage = True
                    ' specify image must be compressed with LZW compression
                    tiffEncoderSettings.TiffCompression = Vintasoft.EsclImageScanning.ImageEncoders.EsclTiffCompression.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 eSCL device
        device.Close()

        ' close eSCL device manager
        deviceManager.Close()
    End Using

    System.Console.ReadLine()
End Sub


/// <summary>
/// Acquires images from eSCL device and saves images to a TIFF file.
/// </summary>
public void AcquireImagesFromEsclDeviceAndSaveImagesToTiffFile()
{
    // create eSCL device manager
    using (Vintasoft.EsclImageScanning.EsclDeviceManager deviceManager = new Vintasoft.EsclImageScanning.EsclDeviceManager())
    {
        // open eSCL device manager
        deviceManager.Open();

        // wait while the eSCL device manager searches for eSCL devices
        System.Threading.Thread.Sleep(deviceManager.DeviceSearchTimeout);
        // get count of eSCL devices
        int deviceCount = deviceManager.Devices.Count;
        if (deviceCount == 0)
        {
            System.Console.WriteLine("Devices are not found.");
            return;
        }

        // select the first eSCL device
        Vintasoft.EsclImageScanning.EsclDevice device = deviceManager.Devices[0];

        // open eSCL device
        device.Open();

        Vintasoft.EsclImageScanning.EsclAcquiredImage acquiredImage = null;
        do
        {
            try
            {
                // acquire image from eSCL device
                acquiredImage = device.AcquireImageSync();
                // if image is received
                if (acquiredImage != null)
                {
                    System.Console.WriteLine("Image is acquired.");

                    // create TIFF encoder settings
                    Vintasoft.EsclImageScanning.ImageEncoders.EsclTiffEncoderSettings tiffEncoderSettings =
                        new Vintasoft.EsclImageScanning.ImageEncoders.EsclTiffEncoderSettings();
                    // specify that image must be added to a TIFF file
                    tiffEncoderSettings.TiffMultiPage = true;
                    // specify image must be compressed with LZW compression
                    tiffEncoderSettings.TiffCompression = Vintasoft.EsclImageScanning.ImageEncoders.EsclTiffCompression.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 eSCL device
        device.Close();

        // close eSCL device manager
        deviceManager.Close();
    }

    System.Console.ReadLine();
}

Требования

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

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