ICAP_ICCPROFILE

Description

Informs the application if the source has an ICC profile and can embed or link it in the current ICAP_IMAGEFILEFORMAT. Tells the source if the application would like an ICC profile embedded or linked into the image file the source will write.

Application

Use this ICAP to determine if the source supports embedding or linking of ICC profiles into files and to control whether or not the source does so.

Source

Values

This should only be supported if ICAP_IMAGEFILEFORMAT is set to a file format that supports the embedding or linking of profiles and the source has an ICC profile it can embed.

Since the given ICAP_PIXELTYPE may not have been determined at the time this is called, the source should ignore the current ICAP_PIXELTYPE. For example, if the source has an ICC profile for color data, but not grayscale or monochrome data, it should offer values as if all pixeltypes are supported. In the case of TWPT_SRGB, the source should embed the sRGB ICC profile to the file if told to embed a profile.

Type: TW_UNIT

Value after MSG_OPENDS: (may be remembered from a previous session)

After MSG_RESET/MSG_RESETALL: (selected by the data source writer)

Allowed Values: TWIC_NONE TWIC_EMBED TWIC_LINK

Containers

MSG_GET TW_ONEVALUE TW_ENUMERATION

MSG_GETCURRENT TW_ONEVALUE

MSG_GETDEFAULT TW_ONEVALUE

MSG_SET TW_ONEVALUE

MSG_SETCONSTRAINT TW_ONEVALUE

TW_ENUMERATION

MSG_RESET TW_ONEVALUE

MSG_QUERYSUPPORT TW_ONEVALUE

Required By

None

TWAIN Version Introduced

Version 1.91

Related