In This Topic ▼

L_LoadICCProfile

Summary

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

Syntax

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

L_LTCLR_API L_INT L_LoadICCProfile(pszFilename, pICCProfile, pLoadOptions)

Parameters

L_TCHAR* pszFilename

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

pICCPROFILEEXT pICCProfile

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

pLOADFILEOPTION 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

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

ICC profiles can be loaded from JPEG, TIFF, PSD 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.

Call L_FillICCProfileStructure to extract the ICC header from the ICC data and fill the ICCPROFILEEXT.pIccHeader member. Once this is done, you can find out from the header how to use this profile.

For example:

If the ICC profile colorspace is RGB, the profile can be used to convert the image data after loading.
If the ICC profile colorspace is CMYK or YCbCr, it is expected to apply this profile during the load.

The profile color space is specified in ICCPROFILEEXT.pIccHeader->uColorSpace. If this value is: