L_SetICCDeviceAttributes

#include "ltkrn.h"
#include "ltclr.h"

L_LTCLR_API L_INT L_SetICCDeviceAttributes(pICCProfile, uAttributes)

pICCPROFILEEXT pICCProfile;

/* pointer to a structure */

L_IccUInt64Number uAttributes;

/* profile attributes value */

Sets the device attributes for the ICC profile.

Parameter

Description

pICCProfile

Pointer to the ICCPROFILEEXT structure for which to set the device attributes.

uAttributes

Flags that identify attributes unique to a particular device. You can use a bitwise OR (|) to specify one flag from each group.

The following flags indicate the transparency of the media:

 

Value

Meaning

 

ICC_REFLECTIVE

[0x0000000000000000] Reflective media

 

ICC_TRANSPARENCY

[0x0000000000000001] Transparent media

 

The following flags indicate if the media is glossy or matte:

 

Value

Meaning

 

ICC_GLOSSY

[0x0000000000000000] Glossy media

 

ICC_MATTE

[0x0000000000000002] Matte media

 

 

The following flags indicate media polarity:

 

Value

Meaning

 

ICC_MEDIA_POLARITY_POSITIVE

[0x0000000000000000] Positive media polarity

 

ICC_MEDIA_POLARITY_NEGATIVE

[0x0000000000000004] Negative media polarity

 

The following flags indicate if the media is colored:

 

Value

Meaning

 

ICC_COLOR_MEDIA

[0x0000000000000000] Color media

 

ICC_BLACK_AND_WHITE

[0x0000000000000008] Black and white media

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The device attributes are unique to a particular device setup.

Note that these attributes describe the media itself, not the data in the ICC profile. For example, a profile for a color scanner that has been loaded with black and white film will have the attribute ICC_BLACK_AND_WHITE, regardless of the value in the data color space field.

The device attributes are contained within the "header" information in the ICCPROFILEEXT structure. Calling L_InitICCHeader will reset the device attributes and the other header information to the default values.

Required DLLs and Libraries

LTCLR

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 95 / 98 / Me, Windows 2000 / XP.

See Also

Functions:

L_InitICCProfile, L_FreeICCProfile, L_SaveICCProfile, L_LoadICCProfile, L_FillICCProfileStructure, L_FillICCProfileFromICCFile, L_InitICCHeader, L_SetICCCMMType, L_SetICCDeviceClass, L_SetICCColorSpace, L_SetICCConnectionSpace, L_SetICCPrimaryPlatform, L_SetICCFlags, L_SetICCDevManufacturer, L_SetICCDevModel, L_SetICCRenderingIntent, L_SetICCCreator, L_SetICCDateTime, L_SetICCProfileId, L_2bFixed2bNumberToDouble, L_U8Fixed8NumberToDouble, L_DoubleToU8Fixed8Number, L_DoubleTo2bFixed2bNumber, L_SetICCTagData, L_GetICCTagData, L_CreateICCTagData, L_DeleteICCTag, L_GenerateICCFile, L_GenerateICCPointer, L_GetICCTagTypeSig, L_FreeICCTagType, L_ConvertParametricCurveTypeToBuffer, L_ConvertCurveTypeToBuffer, L_ConvertCLUTToBuffer, L_GetParametricCurveNumberOfParameters

Topics:

Using ICC Profile Functions

 

ICC Profile Functions: Creating an ICC Profile

Example

For an example, refer to L_InitICCHeader.