Save(String,SaneImageEncoderSettings) Method (SaneAcquiredImage)
Saves this image to a file.
Image can be:
- saved as image file (BMP, JPEG, PNG, TIFF)
- added to multipage TIFF file
- saved into new PDF or PDF/A document
- added to existing PDF or PDF/A document
Available compressions for images saved into TIFF file:
- without compression
- CCITT Group 4 Fax compression
- LZW compression
- ZIP compression
- JPEG compression
Available compressions for images saved into PDF document:
- without compression
- CCITT Group 4 Fax compression
- LZW compression
- ZIP compression
- JPEG compression
Image can be added to a PDF document compatible with version 1.4 or earlier of PDF standard.
Image will be saved as BMP file if
- encoderSettings is null and filename contains 'bmp' extension
- encoderSettings is not null and encoderSettings is an instance of type SaneBmpEncoderSettings
Image will be saved as JPEG file if
- encoderSettings is null and filename contains not 'bmp', 'png', 'pdf', 'tif' and 'tiff' extension
- encoderSettings is not null and encoderSettings is an instance of type SaneJpegEncoderSettings
Image will be saved as PDF file if
- encoderSettings is null and filename contains 'pdf' extension
- encoderSettings is not null and encoderSettings is an instance of type SanePdfEncoderSettings
Image will be saved as PNG file if
- encoderSettings is null and filename contains 'png' extension
- encoderSettings is not null and encoderSettings is an instance of type SanePngEncoderSettings
Image will be saved as TIFF file if
- encoderSettings is null and filename contains 'tif' or 'tiff' extension
- encoderSettings is not null and encoderSettings is an instance of type SaneTiffEncoderSettings
This C#/VB.NET code shows how to acquire images from SANE device and save images to a TIFF file.
''' <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();
}
Target Platforms: .NET 8, .NET 7; .NET 6