LFile::LoadICCProfileExt
#include "ltwrappr.h"
#include "ltclr.h"
L_INT LFile::LoadICCProfileExt(pICCProfile, pLoadOptions)
|
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 |
|
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 LFile::InitICCProfileExt. If LFile::LoadICCProfileExt succeeds, free the ICC profile by calling LFile::FreeICCProfileExt. In fact, when any ICCPROFILEEXT structure initialized by LFile::InitICCProfileExt is no longer needed, the memory must be freed by calling LFile::FreeICCProfileExt.
To save an ICC Profile to an image file, call LFile::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. |
See Also
|
Functions: |
LFile::FreeICCProfile, LFile::InitICCProfile, LFile::LoadICCProfile, LFile::InitICCProfileExt, LFile::FreeICCProfileExt, LFile::SaveICCProfile |
|
Topics: |
|
|
|
Example
For an example, refer to LFile::InitICCProfileExt.