L_LoadICCProfileExt
#include "ltkrn.h"
#include "ltclr.h"
L_INT EXT_FUNCTION L_LoadICCProfileExt(pszFilename, pICCProfile, pLoadOptions)
|
/* name of the file to load */ | |
|
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 |
|
pszFilename |
Character string containing the name of the file from which to load the ICC profile. |
|
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 L_InitICCProfileExt. If L_LoadICCProfileExt succeeds, free the ICC profile by calling L_FreeICCProfileExt. In fact, when any ICCPROFILEEXT structure initialized by L_InitICCProfileExt is no longer needed, the memory must be freed by calling L_FreeICCProfileExt.
To save an ICC Profile to an image file, call L_SaveICCProfile.
Required DLLs and Libraries
|
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. |
Platforms
Windows 95 / 98 / Me, Windows 2000 / XP.
See Also
Example
For an example, refer to L_InitICCProfileExt.