Image Intent Constants

Image intent constants specify what type of data the image is meant to represent. The WIA_IPS_CUR_INTENT scanner property uses these flags. To provide an intent, combine an intended image type flag with an intended size/quality flag by using the OR operator. WIA_INTENT_NONE should not be combined with any other flags. Note that an image cannot be both grayscale and color.

The following are valid image intent constants:

Intended image type flagsDescription
WIA_INTENT_NONEDefault value. Do not preset any properties.
WIA_INTENT_IMAGE_TYPE_COLORPreset properties for color content.
WIA_INTENT_IMAGE_TYPE_GRAYSCALEPreset properties for grayscale content.
WIA_INTENT_IMAGE_TYPE_TEXTPreset properties for text content.
WIA_INTENT_IMAGE_TYPE_MASKMask for all of the image type flags.

 

Intended image size/quality flagsDescription
WIA_INTENT_MINIMIZE_SIZEPreset properties to minimize image size.
WIA_INTENT_MAXIMIZE_QUALITYPreset properties to maximize image quality.
WIA_INTENT_SIZE_MASKMask for all of the size/quality flags.
WIA_INTENT_BEST_PREVIEWSpecifies the best quality preview.

 

The following list shows the C/C++ constant name followed by the corresponding name in parentheses that is used in scripting. The script names are from the WiaIntent enumerated type. Note that not all constants are available through script.

Constant/valueDescription
WIA_INTENT_IMAGE_TYPE_COLOR
0x00000001

Preset properties for color content.

WIA_INTENT_IMAGE_TYPE_GRAYSCALE
0x00000002

Preset properties for grayscale content.

WIA_INTENT_IMAGE_TYPE_TEXT
0x00000004

Preset properties for text content.

WIA_INTENT_MINIMIZE_SIZE
0x00010000

Preset properties to minimize image size.

WIA_INTENT_MAXIMIZE_QUALITY
0x00020000

Preset properties to maximize image quality.

WIA_INTENT_BEST_PREVIEW
0x00040000

Specifies the best quality preview.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wiadef.h

 

 

Show: