L_LoadICCProfile

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

L_LTCLR_API L_INT L_LoadICCProfile(pszFilename, pICCProfile, pLoadOptions)

L_TCHAR* pszFilename;

/* name of the file to load */

pICCPROFILEEXT pICCProfile;

/* pointer to a structure */

 pLOADFILEOPTION pLoadOptions;

/* pointer to optional extended load options */

Loads an ICC profile saved/embedded in an image file.

Parameter

Description

pszFilename

Character string containing the name of the file from which to load the ICC profile.

pICCProfile

Pointer to an ICCPROFILEEXT structure to be updated with the loaded ICC Profile.

pLoadOptions

Pointer to optional extended load options. Pass NULL to use the default load options, and the profile will be loaded from page 1.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

ICC profiles can be loaded from JPEG, TIFF or EPS files. TIFF files are multipage, so a profile can be loaded from a particular page using the pLoadOptions parameter.

Initialize the structure pointed to by pICCProfile first by calling L_InitICCProfile. If L_LoadICCProfile succeeds, free the ICC profile by calling L_FreeICCProfile. In fact, when any ICCPROFILEEXT structure initialized by L_InitICCProfile is no longer needed, the memory must be freed by calling L_FreeICCProfile.

To save an ICC Profile to an image file, call L_SaveICCProfile.

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_FillICCProfileStructure, L_FillICCProfileFromICCFile, L_InitICCHeader, L_SetICCCMMType, L_SetICCDeviceClass, L_SetICCColorSpace, L_SetICCConnectionSpace, L_SetICCPrimaryPlatform, L_SetICCFlags, L_SetICCDevManufacturer, L_SetICCDevModel, L_SetICCDeviceAttributes, 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: Loading an ICC Profile

Example

For an example, refer to L_InitICCProfile.