DTWAIN File Transfer Constants

Top  Previous  Next

The following constants are used for the DTWAIN_AcquireFile and DTWAIN_AcquireFileEx functions.

 

These constants describe the various image file types that DTWAIN can save acquired images to using the DTWAIN file transfer support.  Any Twain Source, regardless of make or model of the device, can acquire to the file types below.  To use the constants defined below, the DTWAIN_USESOURCEMODE flag must not be set when you specify the file control flags in the call to DTWAIN_AcquireFile or DTWAIN_AcquireFileEx. Note:  These constants are not to be used if using the Source's internal file transfer support (see Source Internal File Support below for the proper constants to use for DTWAIN_EnumFileXferFormats).

 

File Type        

Value        

Description




DTWAIN_BMP                

100        

Windows Bitmap (BMP format)

DTWAIN_ICO

8000

Windows ICON file (width/height <= 255 pixels)

DTWAIN_ICO_VISTA

8001

Vista Windows ICON file (width/height > 255 pixels)

DTWAIN_JPEG        

200        

JPEG (JFIF) Format

DTWAIN_PCX

300        

Microsoft Paintbrush (PCX format)

*DTWAIN_DCX

301

Multi-page PCX file

DTWAIN_TGA

400

Targa (TGA format)

DTWAIN_TIFFLZW

500

TIFF Using LZW compression

DTWAIN_TIFFNONE

600        

Uncompressed TIFF

DTWAIN_TIFFG3        

700        

TIFF Using Group 3 Encoding (CCITT Group 3 Fax)

DTWAIN_TIFFG4                

800        

TIFF Using Group 4 Encoding (CCITT Group 4 Fax)

DTWAIN_TIFFPACKBITS        

801

TIFF PACKBITS (Mac RLE Encoding)

DTWAIN_TIFFDEFLATE

802

TIFF Using zlib Deflate compression

DTWAIN_TIFFJPEG        

803

TIFF Using JPEG compression

*DTWAIN_TIFFNONEMULTI        

900

Multi-page uncompressed TIFF

*DTWAIN_TIFFG3MULTI        

901

Multi-page TIFF Using Group 3 Encoding (CCITT Group 3 Fax)

*DTWAIN_TIFFG4MULTI        

902

Multi-page TIFF Using Group 4 Encoding (CCITT Group 4 Fax)

*DTWAIN_TIFFPACKBITSMULTI        

903

Multi-page TIFF PACKBITS (Mac RLE Encoding)

*DTWAIN_TIFFDEFLATEMULTI        

904

Multi-page TIFF Using zlib Deflate compression

*DTWAIN_TIFFJPEGMULTI        

905        

Multi-page TIFF Using JPEG compression

*DTWAIN_TIFFLZWMULTI

906

Multi-page TIFF Using LZW compression

DTWAIN_WMF        

850        

Windows Metafile (WMF) (32.bit  DLL only)

DTWAIN_EMF        

851

Windows Enhanced Metafile (EMF) (32 bit only)

DTWAIN_GIF

950

GIF Format

DTWAIN_PNG                

1000        

Portable Network Graphics (PNG)

DTWAIN_PSD        

2000        

Adobe Photoshop (PSD) (32 bit DLL only)

DTWAIN_PDF

250

Adobe Portable Document Format (PDF)**

*DTWAIN_PDFMULTI

251

Multi-page PDF file**

DTWAIN_JPEG2000

3000

JPEG-2000 Format

DTWAIN_POSTSCRIPT1

4000

Adobe PostScript Level 1**

DTWAIN_POSTSCRIPT2

4001

Adobe PostScript Level 2**

DTWAIN_POSTSCRIPT3

4002

Adobe PostScript Level 3**

*DTWAIN_POSTSCRIPT1MULTI

4003

Multi-page PostScript Level 1**

*DTWAIN_POSTSCRIPT2MULTI

4004

Multi-page PostScript Level 2**

*DTWAIN_POSTSCRIPT3MULTI

4005

Multi-page PostScript Level 3**

DTWAIN_TEXT

6000

Text file***

DTWAIN_TEXTMULTI

6001

Multi-page Text file***

DTWAIN_WBMP

8500

Wireless Bitmap (width/height limited to 255 pixels)

 

* The multi-page file types are supported only for Twain devices that can acquire multiple pages (for example, a scanner equipped with an automatic document feeder) or if the DTWAIN_SetMultipageScanMode has been set with DTWAIN_FILESAVE_UICLOSE or DTWAIN_FILESAVE_SOURCECLOSE option.  Otherwise, the multi-page file types revert to their single-page equivalent.

 

** PDF and PostScript option is available only with DTWAIN / PDF support.

 

*** Text file support is only available if one of the supported OCR engines is installed.

 


 

 

Source Internal File Support

These constants describe the image file types that a Source can save an acquired image to if the Source's internal file transfer support is used.  These constants are to be used only for the internal file transfer that the Source provides. Note that not all Sources have File transfer support.  If the Twain Source does not support file transfers, you must use one of the constants defined above!.

 

When calling DTWAIN_AcquireFile or DTWAIN_AcquireFileEx and specifying the DTWAIN_USESOURCEMODE flag, the Source is responsible for the file transfer, and DTWAIN provides no other support except to initiate the transfer.  Problems with improper files being generated, incorrect bitmaps, etc. are not the responsibility of DTWAIN when specifying DTWAIN_USESOURCEMODE.

 

These constants are returned by the DTWAIN_EnumFileXferFormats  and are to be used when acquiring an image using the Source's internal file transfer.

DTWAIN Constant

Value

Description




DTWAIN_FF_TIFF        

0

TIFF Format

DTWAIN_FF_PICT        

1

Macintosh PICT format

DTWAIN_FF_BMP

2

Windows BMP Format

DTWAIN_FF_XBM                

3        

X Bitmap Format

DTWAIN_FF_JFIF        

4        

JFIF (JPEG) Format

DTWAIN_FF_FPX        

5

Flash Pix Format

DTWAIN_FF_TIFFMULTI        

6        

Multi-Page TIFF

DTWAIN_FF_PNG        

7

PNG Format

DTWAIN_FF_SPIFF        

8

SPIFF format

DTWAIN_FF_EXIF        

9

EXIF format