TRANSFEROPTIONS

typedef struct _tagTransferOptions
{
   L_UINT uStructSize; 
   TWAIN_TRANSFER_MODES TransferMode; 
   L_TCHAR szFileName[L_MAX_PATH]; 
   L_UINT uFileFormat; 
   L_UINT uCompType; 
} TRANSFEROPTIONS,  * pTRANSFEROPTIONS;

The TRANSFEROPTIONS structure provides information about transfer options to be used in the acquisition process.

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value.

TransferMode

Specifies the transfer mode. For possible values, refer to the TWAIN_TRANSFER_MODES enumeration.

szFileName

Character string that contains the file name to transfer if the TransferMode is set to TWAIN_TRANSFER_FILE flag.

uFileFormat

The file format to transfer if the TransferMode is set to TWAIN_TRANSFER_FILE flag. Possible values are (according to the TWAIN 1.9 specification)

 

Value

Meaning

 

TWFF_TIFF

Tagged image file.

 

TWFF_PICT

Macintosh PICT.

 

TWFF_BMP

Windows regular bitmap.

 

TWFF_XBM

X-Windows bitmap.

 

TWFF_JFIF

JPEG file interchange format.

 

TWFF_FPX

Flash pix file.

 

TWFF_TIFFMULTI

Multi-page tiff file format.

 

TWFF_PNG

PNG file.

 

TWFF_SPIFF

SPIFF file.

 

TWFF_EXIF

EXIF file.

uCompType

The compression type to be used if the TransferMode is set to TWAIN_TRANSFER_MEMORY flag.

 

Value

Meaning

 

TWCP_NONE

No compression is to be used.

 

TWCP_PACKBITS

Pack Bits compression.

 

TWCP_GROUP31D

CCITT Group 3 compression with no End of Line.

 

TWCP_GROUP31DEOL

CCITT Group 3 compression with End of Line.

 

TWCP_GROUP32D

CCITT Group 3 compression (use cap for K Factor).

 

TWCP_GROUP4

CCITT Group 4 compression.

 

TWCP_JPEG

JPEG compression.

 

TWCP_LZW

LZW compression (like gifs).

 

TWCP_JBIG

JBIG compression, used mostly for bitonal images.

 

TWCP_PNG

PNG compressed.

 

TWCP_RLE4

RLE4 compression.

 

TWCP_RLE8

RLE8 compression.

 

TWCP_BITFIELDS

Bit Fields compression.

Comments

pTRANSFEROPTIONS is a pointer to a TRANSFEROPTIONS structure. Where the function parameter type is pTRANSFEROPTIONS, you can declare a TRANSFEROPTIONS variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pTRANSFEROPTIONS variable is necessary only if your program requires a pointer.

TRANSFEROPTIONS is used with the LTwain::SetTransferOptions and LTwain::GetTransferOptions functions.