Как пропустить пустые страницы при TWAIN сканировании?

В этом разделе

Пустые страницы при TWAIN сканировании можно пропускать 2 способами:

используя возможности TWAIN сканера изображений
используя возможности библиотеки (SDK)

1. Пропуск пустых страниц при использовании возможностей TWAIN сканера изображений

Для начала необходимо проверить, поддерживает ли TWAIN сканер изображений возможность пропуска пустых страниц - проверьте, поддерживает ли TWAIN сканер возможность ICAP_AUTODISCARDBLANKPAGES.

Если TWAIN сканер поддерживает возможность ICAP_AUTODISCARDBLANKPAGES, то вам нужно установить значение возможности таким образом, чтобы определить нужно ли пропускать пустые страницы.
Допустимые значения возможности ICAP_AUTODISCARDBLANKPAGES:

-2 - TWAIN сканер изображений НЕ должен пропускать пустые страницы при сканировании
-1 - TWAIN сканер изображений должен пропускать пустые страницы при сканировании

Вот C#/VB.NET код, который демонстрирует, как пропускать пустые страницы, если TWAIN сканер изображений поддерживает эту возможность:

/// <summary>
/// Synchronously acquires images from TWAIN device and skips blank pages using TWAIN capability.
/// </summary>
public void SynchronouslyAcquireImagesFromTwainDeviceAndSkipBlankPagesUsingTwainCapability()
{
    try
    {
        using (Vintasoft.Twain.DeviceManager deviceManager = new Vintasoft.Twain.DeviceManager())
        {
            // open the device manager
            deviceManager.Open();

            // get reference to the default device
            Vintasoft.Twain.Device device = deviceManager.DefaultDevice;

            // set scanning settings
            device.TransferMode = Vintasoft.Twain.TransferMode.Memory;
            device.ShowUI = false;

            // open the device
            device.Open();

            // get a reference to the IAutoDiscardBlankPages capability
            Vintasoft.Twain.DeviceCapability autoDiscardBlankPagesCap = device.Capabilities.Find(Vintasoft.Twain.DeviceCapabilityId.IAutoDiscardBlankPages);
            // if discarding of blank pages is not supported
            if (autoDiscardBlankPagesCap == null)
                System.Windows.Forms.MessageBox.Show("Device cannot automatically discard blank pages.");
            else
                // enable discarding of blank pages
                autoDiscardBlankPagesCap.SetValue(true);

            // synchronously acquire image(s) from TWAIN device
            Vintasoft.Twain.AcquireModalState acquireModalState;
            do
            {
                acquireModalState = device.AcquireModal();
                switch (acquireModalState)
                {
                    case Vintasoft.Twain.AcquireModalState.ImageAcquired:
                        // add the acquired image to a TIFF file
                        device.AcquiredImage.Save(@"d:\test.tif");

                        // dispose the acquired image
                        device.AcquiredImage.Dispose();
                        break;

                    case Vintasoft.Twain.AcquireModalState.ScanCompleted:
                        // output current state
                        System.Console.WriteLine("Scan completed.");
                        break;

                    case Vintasoft.Twain.AcquireModalState.ScanCanceled:
                        // output current state
                        System.Console.WriteLine("Scan canceled.");
                        break;

                    case Vintasoft.Twain.AcquireModalState.ScanFailed:
                        // output current state
                        System.Console.WriteLine(string.Format("Scan failed: {0}", device.ErrorString));
                        break;
                }
            }
            while (acquireModalState != Vintasoft.Twain.AcquireModalState.None);

            // close the device
            device.Close();

            // close the device manager
            deviceManager.Close();
        }
    }
    catch (Vintasoft.Twain.TwainException ex)
    {
        System.Console.WriteLine("Error: " + ex.Message);
    }

    System.Console.ReadLine();
}

VB.NET

''' <summary>
''' Synchronously acquires images from TWAIN device and skips blank pages using TWAIN capability.
''' </summary>
Public Sub SynchronouslyAcquireImagesFromTwainDeviceAndSkipBlankPagesUsingTwainCapability()
        Try
                Using deviceManager As New Vintasoft.Twain.DeviceManager()
                        ' open the device manager
                        deviceManager.Open()

                        ' get reference to the default device
                        Dim device As Vintasoft.Twain.Device = deviceManager.DefaultDevice

                        ' set scanning settings
                        device.TransferMode = Vintasoft.Twain.TransferMode.Memory
                        device.ShowUI = False

                        ' open the device
                        device.Open()

                        ' get a reference to the IAutoDiscardBlankPages capability
                        Dim autoDiscardBlankPagesCap As Vintasoft.Twain.DeviceCapability = device.Capabilities.Find(Vintasoft.Twain.DeviceCapabilityId.IAutoDiscardBlankPages)
                        ' if discarding of blank pages is not supported
                        If autoDiscardBlankPagesCap Is Nothing Then
                                System.Windows.Forms.MessageBox.Show("Device cannot automatically discard blank pages.")
                        Else
                                ' enable discarding of blank pages
                                autoDiscardBlankPagesCap.SetValue(True)
                        End If

                        ' synchronously acquire image(s) from TWAIN device
                        Dim acquireModalState As Vintasoft.Twain.AcquireModalState
                        Do
                                acquireModalState = device.AcquireModal()
                                Select Case acquireModalState
                                        Case Vintasoft.Twain.AcquireModalState.ImageAcquired
                                                ' add the acquired image to a TIFF file
                                                device.AcquiredImage.Save("d:\test.tif")

                                                ' dispose the acquired image
                                                device.AcquiredImage.Dispose()
                                                Exit Select

                                        Case Vintasoft.Twain.AcquireModalState.ScanCompleted
                                                ' output current state
                                                System.Console.WriteLine("Scan completed.")
                                                Exit Select

                                        Case Vintasoft.Twain.AcquireModalState.ScanCanceled
                                                ' output current state
                                                System.Console.WriteLine("Scan canceled.")
                                                Exit Select

                                        Case Vintasoft.Twain.AcquireModalState.ScanFailed
                                                ' output current state
                                                System.Console.WriteLine(String.Format("Scan failed: {0}", device.ErrorString))
                                                Exit Select
                                End Select
                        Loop While acquireModalState <> Vintasoft.Twain.AcquireModalState.None

                        ' close the device
                        device.Close()

                        ' close the device manager
                        deviceManager.Close()
                End Using
        Catch ex As Vintasoft.Twain.TwainException
                System.Console.WriteLine("Error: " + ex.Message)
        End Try

        System.Console.ReadLine()
End Sub

Преимущества этой техники:

Когда TWAIN сканер изображений пропускает пустую страницу при сканировании - он не отправляет страницу в приложение и тем самым экономит память.

Недостатки этой техники:

Только профессиональные, довольно дорогие TWAIN сканеры поддерживают пропуск пустых страниц.

2. Пропуск пустых страниц с использованием возможностей библиотеки (SDK)

Алгоритм этой техники довольно прост. TWAIN сканер отправляет в библиотеку все изображения отсканированных страниц, а библиотека проверяет, является ли изображение пустым, используя метод Vintasoft.Twain.AcquiredImage.IsBlank.

Вот C#/VB.NET код, который демонстрирует, как пропускать пустые страницы с помощью метода IsBlank:

/// <summary>
/// Synchronously acquires images from TWAIN device and skips blank pages using AcquiredImage.IsBlank method.
/// </summary>
public void SynchronouslyAcquireImagesFromTwainDeviceAndSkipBlankPagesUsingIsBlankMethod()
{
    try
    {
        using (Vintasoft.Twain.DeviceManager deviceManager = new Vintasoft.Twain.DeviceManager())
        {
            // open the device manager
            deviceManager.Open();

            // get reference to the default device
            Vintasoft.Twain.Device device = deviceManager.DefaultDevice;

            // set scanning settings
            device.TransferMode = Vintasoft.Twain.TransferMode.Memory;
            device.ShowUI = false;

            // open the device
            device.Open();

            // synchronously acquire image(s) from TWAIN device
            Vintasoft.Twain.AcquireModalState acquireModalState;
            do
            {
                acquireModalState = device.AcquireModal();
                switch (acquireModalState)
                {
                    case Vintasoft.Twain.AcquireModalState.ImageAcquired:
                        // if acquired image is not blank
                        if (!device.AcquiredImage.IsBlank(0.01f))
                            // add the acquired image to a TIFF file
                            device.AcquiredImage.Save(@"d:\test.tif");

                        // dispose the acquired image
                        device.AcquiredImage.Dispose();
                        break;

                    case Vintasoft.Twain.AcquireModalState.ScanCompleted:
                        // output current state
                        System.Console.WriteLine("Scan completed.");
                        break;

                    case Vintasoft.Twain.AcquireModalState.ScanCanceled:
                        // output current state
                        System.Console.WriteLine("Scan canceled.");
                        break;

                    case Vintasoft.Twain.AcquireModalState.ScanFailed:
                        // output current state
                        System.Console.WriteLine(string.Format("Scan failed: {0}", device.ErrorString));
                        break;
                }
            }
            while (acquireModalState != Vintasoft.Twain.AcquireModalState.None);

            // close the device
            device.Close();

            // close the device manager
            deviceManager.Close();
        }
    }
    catch (Vintasoft.Twain.TwainException ex)
    {
        System.Console.WriteLine("Error: " + ex.Message);
    }

    System.Console.ReadLine();
}

VB.NET

''' <summary>
''' Synchronously acquires images from TWAIN device and skips blank pages using AcquiredImage.IsBlank method.
''' </summary>
Public Sub SynchronouslyAcquireImagesFromTwainDeviceAndSkipBlankPagesUsingIsBlankMethod()
        Try
                Using deviceManager As New Vintasoft.Twain.DeviceManager()
                        ' open the device manager
                        deviceManager.Open()

                        ' get reference to the default device
                        Dim device As Vintasoft.Twain.Device = deviceManager.DefaultDevice

                        ' set scanning settings
                        device.TransferMode = Vintasoft.Twain.TransferMode.Memory
                        device.ShowUI = False

                        ' open the device
                        device.Open()

                        ' synchronously acquire image(s) from TWAIN device
                        Dim acquireModalState As Vintasoft.Twain.AcquireModalState
                        Do
                                acquireModalState = device.AcquireModal()
                                Select Case acquireModalState
                                        Case Vintasoft.Twain.AcquireModalState.ImageAcquired
                                                ' if acquired image is not blank
                                                If Not device.AcquiredImage.IsBlank(0.01F) Then
                                                        ' add the acquired image to a TIFF file
                                                        device.AcquiredImage.Save("d:\test.tif")
                                                End If

                                                ' dispose the acquired image
                                                device.AcquiredImage.Dispose()
                                                Exit Select

                                        Case Vintasoft.Twain.AcquireModalState.ScanCompleted
                                                ' output current state
                                                System.Console.WriteLine("Scan completed.")
                                                Exit Select

                                        Case Vintasoft.Twain.AcquireModalState.ScanCanceled
                                                ' output current state
                                                System.Console.WriteLine("Scan canceled.")
                                                Exit Select

                                        Case Vintasoft.Twain.AcquireModalState.ScanFailed
                                                ' output current state
                                                System.Console.WriteLine(String.Format("Scan failed: {0}", device.ErrorString))
                                                Exit Select
                                End Select
                        Loop While acquireModalState <> Vintasoft.Twain.AcquireModalState.None

                        ' close the device
                        device.Close()

                        ' close the device manager
                        deviceManager.Close()
                End Using
        Catch ex As Vintasoft.Twain.TwainException
                System.Console.WriteLine("Error: " + ex.Message)
        End Try

        System.Console.ReadLine()
End Sub

Преимущества этой техники:

Она подходит для любого TWAIN сканера.

Недостатки этой техники:

Расход памяти больше, чем в первой технике.

Отправить отзыв