You are here: GdPicture.NET > Documentation > Classes > GdPictureImaging Class > GdPictureImaging Methods > TWAIN Features
logo.gif
ContentsIndexHome
PreviousUpNext
TWAIN Features

These methods are available in:

  • GdPicture.NET Document Imaging SDK Ultimate.
  • GdPicture.NET Document Imaging SDK.
  • GdPicture.NET TWAIN PRO SDK.
  • GdPicture.NET TWAIN SDK.

 
Name 
Description 
 
Acquires a single image, from the currently selected Data Source to a DIB handle. 
 
Acquires a single image, from the currently selected Data Source to a file.
This function uses only the File transfer mode.
The disk file mode is ideal when transferring large images that might encounter memory limitations with Native or memory mode.
However, Disk File mode is a bit slower than other transfer mode.

-> The output image format should be negotiated with the TwainSetImageFileFormat() function.
-> The output image compression should be negotiated with the TwainSetCompression() function.  
 
Acquires a single image, from the currently selected Data Source.  
 
Returns the degree of certainty of a bar code the engine has in the accuracy of the information obtained on the last acquired image.  
 
If barcode detection is enabled, returns the number of bar codes found on the last acquired image.  
 
Returns the orientation of a bar code found on the last acquired image.  
 
Returns the type of a bar code found on the last acquired image.  
 
Returns the text of a bar code found on the last acquired image.  
 
Returns the X coordinate of a bar code found on the last acquired image.  
 
Returns the Y coordinate of a bar code found on the last acquired image.  
 
Closes the open Data Source, if any.
If the source is enabled, disables it first.  
 
Closes the Data Source Manager, if it is open.
If a source is open, disables and closes it as needed.  
 
Disables the open Data Source, if any.
This closes the source's user interface.  
 
Asks to the opened source to enable or disable the duplex scanning mode.  
 
Signals the Data Source to stop all the transfers.  
 
Signals the Data Source to stop the current transfer.
Go to either State 6 (TWAIN_TRANSFER_READY) if it has more transfers ready, or to State 5 (TWAIN_SOURCE_ENABLED) if it does not.  
 
If barcode detection is available, returns the number of bar code types that can be detected.  
 
Returns a supported bar code type which can be detected by the opened source.  
 
Returns the number of available bit depths values which can be used by the opened source in its current configuration.  
 
Returns an available bit depth value which can be used by the opened source in its current configuration.  
 
Returns the number of available brightness values which can be used by the opened source in its current configuration.  
 
Returns an available brightness value which can be used by the opened source in its current configuration.  
 
Returns an available numeric value for the selected TWAIN capability which can be used by the opened source in its current configuration.
This function should be used to determine what are the supported value which can be used with the TwainSetCapCurrentNumeric() function.  
 
Returns an available string value for the selected TWAIN capability which can be used by the opened source in its current configuration.
This function should be used to determine what are the supported value which can be used with the TwainSetCapCurrentString() function.  
 
Returns the number of available values for the selected TWAIN capability which can be used with it by the opened source in its current configuration.  
 
Returns the number of available compression values which can be used by the opened source in its current configuration for file transfer mode.  
 
Returns an available compression value which can be used by the opened source in its current configuration for file transfer mode.  
 
Returns the number of available contrast values which can be used by the opened source in its current configuration.  
 
Returns an available contrast value which can be used by the opened source in its current configuration.  
 
Returns the number of available file format values which can be used by the opened source in its current configuration for file transfer mode.  
 
Returns an available image file format value which can be used by the opened source in its current configuration for file transfer mode.  
 
Returns the number of available paper size values which can be used by the opened source.  
 
Returns an available paper size value which can be used by the opened source.  
 
Returns the number of available pixel types values which can be used by the opened source in its current configuration.  
 
Returns an available pixel type value which can be used by the opened source in its current configuration.  
 
Returns the number of available X Resolutions values which can be used by the opened source in its current configuration.  
 
Returns an available X Resolution value which can be used by the opened source in its current configuration.  
 
Returns the number of available Y Resolutions values which can be used by the opened source in its current configuration.  
 
Returns an available Y Resolution value which can be used by the opened source in its current configuration.  
 
Returns the pixel bit depths for the Current value of PixelType. For example, when using TwainSetPixelType(TWPT_GRAY), this capability specifies whether this is 8-bit gray or 4-bit gray.  
 
Returns Reduction Method the Source should use to reduce the bit depth of the data.  
 
Returns the current brightness.  
 
Returns as numeric, the current value of a TWAIN capability.  
 
Returns the name of the opened source.  
 
Returns as string, the current value of a TWAIN capability.  
 
Returns the name of the default TWAIN source into the dialog of source selection.  
 
Returns the starting endorser / imprinter number for the next acquisition.  
 
Asks if the TWAIN Source's GUI runs as modal or modeless.  
 
Returns the number of sources available.  
 
Returns the name of an available TWAIN source.  
 
Returns the Item type used by a TWAIN capability.  
 
Returns the three parameters that define a Range for a TWAIN capability. Many capabilities allow users to select their current value from a range of regularly spaced values. The capability can specify the minimum and maximum acceptable values and the incremental step size between values. For example, resolution might be supported from 100 to 600 in steps of 50 (100, 150, 200, ..., 550, 600).  
 
Returns the current image compression used by the selected twain source for file transfer mode.  
 
Returns the current contrast.  
 
Returns the duplex scanning support.  
 
Asks to the opened source for current Gamma correction value to apply to the scanned image.  
 
Asks if the user interface should be hidden or not during an acquisition process.  
 
Returns the current image file format used by the selected twain source for file transfer mode.  
 
Returns the physical area (a rectangle) to be acquired during the next image transfer.  
 
Returns the last condition code from the last message sent to TWAIN.  
 
Returns the last result code from the last message sent to TWAIN.  
 
Asks to the opened source for current algorithm used to remove noise for the selected twain source.  
 
Asks to the opened source which edge of the “paper” the image’s “top” is aligned with.
This information is used to adjust the frames to match the scanning orientation of the paper.  
 
Gets the current paper size.  
 
Returns the maximum height of the scanning area (in inches).  
 
Returns the maximum width of the scanning area (in inches).  
 
Returns the pixel 'flavor' (0 is black or white).
CHOCOLATE means this pixel represents the darkest data value that can be generated by the device (the darkest available optical value may measure greater than 0).
VANILLA means this pixel represents the lightest data value that can be generated by the device (the lightest available optical value may measure greater than 0).  
 
Asks the source for the current pixel type.  
 
Returns the color data formats There are two Options, "planar" And "chunky."  
 
Returns the current resolution in Dot per inch of the selected scanner.  
 
Asks to the opened source for current rotation to apply to the scanned image data prior to transfer.  
 
Returns the last Twain status.  
 
Returns the dividing line between black and white. This is the value the Source will use to threshold, if needed, when scanning B&W image.  
 
Asks to the opened source for current horizontal scaling to apply to the scanned image.  
 
Asks to the opened source for current vertical scaling to apply to the scanned image.  
 
Queries the current device for UI support for preview mode.  
 
Asks to the opened source if it has a document feeder.  
 
Asks to the opened source if it has a flatbed.  
 
Asks to the opened source if she can support the auto-brightness images capability.  
 
Asks to the opened source if the auto-brightness images capability is enabled or not.  
 
Asks to the opened source if she can support the automatic page feeding capability.
When AutoFeed capability is enabled, the Source will automatically feed the next page from the document feeder after the number of frames negotiated for capture from each page are acquired.  
 
Asks to the opened source if the automatic page feeding capability is enabled or not.  
 
Asks to the opened source if she can support the Automatic border detection capability.  
 
Asks to the opened source if the Automatic border detection capability is enabled or not.  
 
Asks to the opened source if she can support the Automatic Deskew capability.  
 
Asks to the opened source if the Automatic Deskew capability is enabled or not.  
 
Asks to the opened source if she can support the Automatic discard blank images capability.  
 
Asks to the opened source if the Automatic discard blank images capability is enabled or not.  
 
Asks to the opened source if she can support the Automatic rotation of images capability.
This capability depends on intelligent features within the Source to automatically rotate the image to the correct position.  
 
Asks to the opened source if the automatic rotation of images capability is enabled or not.  
 
Asks to the opened source if she can support the automatic scan capability.
This capability is intended to boost the performance of a Source.
The fundamental assumption behind AutoScan is that the device is able to capture images without waiting for the Application to request the image transfers.
The default behavior is undefined, because some high volume devices are capable of anything but TwainIsAutoScanAvailable() return value being equal to TRUE.  
 
Asks to the opened source if the automatic scan capability is enabled or not.  
 
Asks to the opened source if she can support the auto-size images capability.  
 
Asks to the opened source if the auto-size images capability is enabled or not.  
 
This function find out if TWAIN is installed on the system.
It takes a little time on the first call.  
 
Asks to the opened source if she can support the barcode detection capability.  
 
Asks to the opened source if the barcode detection capability is enabled or not.  
 
Returns the online statue of the current data source.  
 
Ask to the opened source if duplex scanning is currently enabled or not.  
 
Asks to the opened source if she can support endorser / imprinter capability.  
 
Asks to the opened source if there are documents in the feeder.  
 
Asks to the opened source if the document feeder is selected.  
 
Asks to the opened source if the current data source supports file transfer mode.  
 
Asks to the opened source if she can support the gamma correction capability.  
 
Asks to the opened source if she can support the noise filter capability.  
 
Asks to the opened source if she can support the image orientation capability.  
 
Ask to the opened source if the device supports a kind of pixel type.  
 
Asks to the opened source if she can support the image rotation capability.  
 
Asks to the opened source if she can support the image horizontal scaling capability.  
 
Asks to the opened source if she can support the image vertical scaling capability.  
 
Asks if the last acquisition process failed.  
 
Loads from a file, settings of the opened source, e.g. DPI, paper size, color format.  
 
Starts to log twain operations into file.  
 
Stops to log twain operations previously started by the TwainLogStart() function.  
 
This opens the source selected in the Select Source dialog.
If some source is already open, does nothing and returns TRUE.
First this function for each scanning process or to set the TWAIN state to 4 (TWAIN_SOURCE_OPEN) when the TWAIN state is 3 (TWAIN_SM_OPEN) or 2 (TWAIN_SM_LOADED) or 1 (TWAIN_PRESESSION).  
 
Opens the source with the given name.
If another source is open, closes it and attempts to open the specified source.
First this function for each scanning process or to set the TWAIN state to 4 (TWAIN_SOURCE_OPEN) when the TWAIN state is 3 (TWAIN_SM_OPEN) or 2 (TWAIN_SM_LOADED) or 1 (TWAIN_PRESESSION).  
 
Sets the current TWAIN capability value to default value.  
 
Asks to the opened device to reset the area to scan, sometimes called the ROI (Region of Interest).  
 
Saves to a file current settings of the opened source, e.g. DPI, paper size, color format.  
 
Asks to the opened source to select or deselect the document feeder.  
 
Select twain device for capture. This function posts the Source Manager's Select Source dialog box.  
 
Asks to the component to register your application into TWAIN.  
 
Try to enable or disable autobrightness scanning.  
 
Try to enable or disable the Source’s automatic document feeding process.
If you enable auto feed scanning, this function selects the feeder.
So to start scanning pages from an ADF, just do: TwainSetAutoFeed(TRUE).  
 
If this option is available on opened source, try to enable or disable the automatic border detection. It reduces or removes the border generated around an image by the scanner scanning its own platen (the area not covered by the paper).  
 
If this option is available on opened source, try to enable or disable the automatic deskew correction of an image. It may also affect the dimensions of the image.  
 
If this option is available on opened source, try to enable or disable the automatic discard blank page capability.  
 
If this option is available on opened source, try to enable or disable the automatic rotation of image capability.  
 
Tries to enable or disable the auto scan scanning capability. Setting this to TRUE gives the scanner permission to 'scan ahead'.
i.e. to pull pages from the feeder and scan them before they have been requested.
On high-speed scanners, you may have to enable auto scan to achieve the maximum scanning rate.  
 
If this option is available on opened source, try to enable or disable the auto-size images.  
 
Tells to the control to close or not the opened source after a scan process.  
 
If this option is available on opened source, try to enable or disable the barcode detection.  
 
Specifies the pixel bit depths for the Current value of PixelType.
For example, when using TwainSetPixelType(TWPT_GRAY), this capability specifies whether this is 8-bit gray or 4-bit gray.  
 
Tries to specifies the Reduction Method the Source should use to reduce the bit depth of the data.  
 
Tries to set the current brightness for the next acquisition.  
 
Changes the current value of a TWAIN capability from a numeric value.
The TwainGetAvailableCapValueNoNumeric() function should be used to determine what are the supported value which can be used with this function.  
 
Changes the current value of a TWAIN capability.  
 
Tries to set the current image compression to use by the selected twain source for file transfer mode.
Since only certain file formats support compression, this capability must be negotiated after setting the desired file format with the TwainSetImageFileFormat() function.  
 
Tries to set the current contrast for the next acquisition.  
 
Turns On or Off the Debug Mode of GDTWAIN.
Displays a message box for each step of the scanning process.  
 
Specifies the path TWAIN Data Source Manager.
The TWAIN DSM is the windows library (dll) providing support for the TWAIN standard.
Can be TWAIN_32.DLL or TWAINDSM.DLL for TWAIN 2.0 support. By default, the toolkits searches the Windows path for the TWAIN DSM but on Citrix the Windows directory can be redirected for users.  
 
Tries to specify the starting endorser / imprinter number for the next acquisition. All other endorser/imprinter properties should be handled through the data source’s user interface.  
 
Turns On or Off the error message box of GDTWAIN.
Displays a message box for each error appends.  
 
Tries to set the current gamma correction value for the selected twain source.  
 
Tells the source to hide or show the user interface before acquisition.  
 
Tries to set the current image file format to use by the selected twain source for file transfer mode.  
 
Specifies the physical area (a rectangle) to be acquired during the next image transfer.  
 
Tells the source to show or hide progress indicators during acquisition.  
 
Set TRUE to run the TWAIN Source's GUI modal or FALSE to run it modeless. Please note that to successfully run modal, it may be necessary for the application to disable inputs to its windows while the Source’s GUI is running.  
 
Changes the multiple transfers mode for acquisition.  
 
Tries to set the current algorithm used to remove noise for the selected twain source.  
 
Asks to the opened source to define which edge of the “paper” the image’s “top” is aligned with. This information is used to adjust the frames to match the scanning orientation of the paper.  
 
Sets the current paper size.  
 
Try to specify the pixel 'flavor' (0 is black or white).
CHOCOLATE means this pixel represents the darkest data value that can be generated by the device (the darkest available optical value may measure greater than 0).
VANILLA means this pixel represents the lightest data value that can be generated by the device (the lightest available optical value may measure greater than 0).  
 
Tries to set the current pixel type for the selected twain source.  
 
Try to specify the color data formats There are two Options, "planar" And "chunky".  
 
Tries to set the current resolution (in both x & y).
Resolution is in dots per inch.  
 
Asks to the opened source to rotate the scanned image data prior to transfer.  
 
Try to specify the dividing line between black and white. This is the value the Source will use to threshold, if needed, when scanning B&W image.  
 
Negotiates with open Source the number of images application will accept.  
 
Tries to set the current image horizontal scaling factor for the selected twain source.  
 
Tries to set the current image vertical scaling factor for the selected twain source.  
 
Starts the selected device's settings dialog, if this is supported.  
 
Unloads the Data Source Manager and release the TWAIN32.DLL.  
 
Asks if during the last acquisition process the user asked to close the device.  
What do you think about this topic? Send feedback!
Copyright (c) 2009-2011 www.gdpicture.com. All rights reserved.