Save(String,EsclImageEncoderSettings) Метод (EsclAcquiredImage)
Сохраняет это изображение в файл.
Изображение можно:
- сохранить как файл изображения (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 9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5