LICCProfile::Load

Summary

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

Syntax

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

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:

• RgbData - An ICC profile with a RGB colorspace.
• CmykData - An ICC profile with a CMYK colorspace.
• Otherwise - other type of ICC profile. See ICCCOLORSPACE for the complete list.

Required DLLs and Libraries

• LTCLR
• LTFIL
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions

• LICCProfile::Free
• LICCProfile::Initialize
• LICCProfile::Save
• LICCProfile::Fill
• LICCProfile::InitHeader
• LICCProfile::SetCMMType
• LICCProfile::SetDeviceClass
• LICCProfile::SetColorSpace
• LICCProfile::SetConnectionSpace
• LICCProfile::SetPrimaryPlatform
• LICCProfile::SetFlags
• LICCProfile::SetDevManufacturer
• LICCProfile::SetDevModel
• LICCProfile::SetDeviceAttributes
• LICCProfile::SetRenderingIntent
• LICCProfile::SetCreator
• LICCProfile::SetDateTime
• LICCProfile::Convert2bFixed2bNumberToDouble
• LICCProfile::ConvertDoubleTo2bFixed2bNumber
• LICCProfile::SetTagData
• LICCProfile::GetTagData
• LICCProfile::CreateTagData
• LICCProfile::DeleteTag
• LICCProfile::GenerateFile
• LICCProfile::GeneratePointer
• LICCProfile::GetTagTypeSig
• LICCProfile::FreeTagType
• Class Members

Topics

• Using ICC Profile Functions
• ICC Profile Functions: Loading an ICC Profile

Example

For an example, refer to LICCProfile::Initialize.