In This Topic ▼

LICCProfile::Load

Summary

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

Syntax

#include "ltwrappr.h"

L_INT LICCProfile::Load(pszFilename, pLoadOptions);

Parameters

L_TCHAR * pszFilename

Character string containing the name of the file from which to load the 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 LICCProfile class object first by calling LICCProfile::Initialize. If LICCProfile::Load succeeds, free the ICC profile by calling LICCProfile::Free. In fact, when any LICCProfile class object initialized by LICCProfile::Initialize is no longer needed, the memory must be freed by calling LICCProfile::Free.

To save an ICC Profile to an image file, call LICCProfile::Save.

Call LICCProfile::Fill 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: