L_LoadICCProfile

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

L_LTCLR_API L_INT L_LoadICCProfile(pszFilename, pICCProfile, pLoadOptions)

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

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:

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

Required DLLs and Libraries

Platforms

Win32, x64.

Help Version 22.0.2021.8.20
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Color Conversion C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.