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 flags Description
WIA_INTENT_NONE Default value. Do not preset any properties.
WIA_INTENT_IMAGE_TYPE_COLOR Preset properties for color content.
WIA_INTENT_IMAGE_TYPE_GRAYSCALE Preset properties for grayscale content.
WIA_INTENT_IMAGE_TYPE_TEXT Preset properties for text content.
WIA_INTENT_IMAGE_TYPE_MASK Mask for all of the image type flags.

 

Intended image size/quality flags Description
WIA_INTENT_MINIMIZE_SIZE Preset properties to minimize image size.
WIA_INTENT_MAXIMIZE_QUALITY Preset properties to maximize image quality.
WIA_INTENT_SIZE_MASK Mask for all of the size/quality flags.
WIA_INTENT_BEST_PREVIEW Specifies 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/value Description
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

Requirement Value
Minimum supported client
Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Wiadef.h