L_SetICCRenderingIntent

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

L_LTCLR_API L_INT L_SetICCRenderingIntent(pICCProfile, uRenderingIntent)

pICCPROFILEEXT pICCProfile;

/* pointer to a structure */

ICCRENDERINGINTENT uRenderingIntent;

/* rendering intent value */

Sets the rendering intent of an ICC profile.

Parameter

Description

pICCProfile

Pointer to ICCPROFILEEXT structure whose rendering intent value will be set.

uRenderingIntent

A value that indicates the rendering intent. For a list of possible values, refer to ICCRENDERINGINTENT.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The value set using this function specifies the rendering intent used when this profile combines with another profile. In a sequence of more than two profiles, it applies to the combination of this profile and the next profile in the sequence and not to the entire sequence. Typically, the user or application will set the rendering intent dynamically at runtime or embedding time. Therefore, this flag may not have any meaning until the profile is used in some context, e.g. in a device link or an embedded source profile.

The rendering intent is one of the values contained within the "header" information in the ICCPROFILEEXT structure. Calling L_InitICCHeader will reset the rendering intent 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_SetICCDeviceAttributes, 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.