In This Topic ▼

AcquireToImage Method

Summary

Acquires one image from a TWAIN source.

Syntax

C++

public RasterImage AcquireToImage( 
   TwainUserInterfaceFlags flags 
)

Public Function AcquireToImage( _ 
   ByVal flags As TwainUserInterfaceFlags _ 
) As RasterImage

public: 
RasterImage^ AcquireToImage(  
   TwainUserInterfaceFlags flags 
)

Parameters

flags
Indicates whether to display the manufacturer's user interface.

Return Value

One of the DialogResult values. If an error occurs, an exception is thrown.

Remarks

Use the Acquire method to acquire one or more images. Use the AcquireFast method to acquire one or more images and save them to one or more files. The number of pages to acquire can be determined by getting the TWAIN source's capabilities. To change the number of pages to acquire, set the appropriate capability to the desired number. This method will get images from the selected TWAIN source and pass them into an RasterImage object to the AcquirePage event through the TwainAcquirePageEventArgs class. For each image acquired by the currently selected TWAIN source, an AcquirePage event is generated. The Acquire method acquires pages in the following transfer modes:

Native - gets the images being scanned into the memory as a whole.
Memory Buffered - gets images from the source as strips of data. These strips can be merged to get the whole image.

To set the transfer mode, call SetCapability with the appropriate capability constant. For more information, refer to How to Acquire from the Twain Source.

Example

using Leadtools; 
using Leadtools.Twain; 
 
public void AcquireToImageExample(IntPtr parent) 
{ 
   TwainSession session = new TwainSession(); 
   session.Startup(parent, "manufacturer", "productFamily", "version", "application", TwainStartupFlags.None); 
 
   TwainCapability twCap = new TwainCapability(); 
 
   twCap.Information.Type = TwainCapabilityType.ImageTransferMechanism; 
   twCap.Information.ContainerType = TwainContainerType.OneValue; 
   twCap.OneValueCapability.ItemType = TwainItemType.Uint16; 
   twCap.OneValueCapability.Value = TwainCapabilityValue.TransferMechanismNative; 
 
   session.SetCapability(twCap, TwainSetCapabilityMode.Set); 
   RasterImage img = session.AcquireToImage(TwainUserInterfaceFlags.Show); 
 
   // 
   // save the acquired image here... 
   // 
 
   session.Shutdown(); 
}

Imports Leadtools 
Imports Leadtools.Twain 
 
Public Sub AcquireToImageExample(ByVal parent As IntPtr) 
   Dim session As TwainSession = New TwainSession() 
   session.Startup(parent, "manufacturer", "productFamily", "version", "application", TwainStartupFlags.None) 
 
   Dim twCap As TwainCapability = New TwainCapability() 
 
   twCap.Information.Type = TwainCapabilityType.ImageTransferMechanism 
   twCap.Information.ContainerType = TwainContainerType.OneValue 
   twCap.OneValueCapability.ItemType = TwainItemType.Uint16 
   twCap.OneValueCapability.Value = TwainCapabilityValue.TransferMechanismNative 
 
   session.SetCapability(twCap, TwainSetCapabilityMode.Set) 
   Dim img As RasterImage = session.AcquireToImage(TwainUserInterfaceFlags.Show) 
 
   ' 
   ' save the acquired image here... 
   ' 
 
   session.Shutdown() 
End Sub