LFile::SaveICCProfile
#include "ltwrappr.h"
#include "ltclr.h"
L_INT LFile::SaveICCProfile(pICCProfile, pSaveOptions)
|
pICCPROFILEEXT pICCProfile; |
/* pointer to a structure */ |
|
pSAVEFILEOPTION pSaveOptions; |
/* pointer to optional extended save options */ |
Saves (embeds) an ICC profile in an image file.
|
Parameter |
Description |
|
pICCProfile |
Pointer to an ICCPROFILEEXT structure that contains the ICC profile to save/embed. |
|
pSaveOptions |
Pointer to optional extended save options. Pass NULL to use the default save options, and the profile will be saved on page 1. |
Returns
|
SUCCESS |
The function was successful. |
|
< 1 |
An error occurred. Refer to Return Codes. |
Comments
ICC profiles can be saved into JPEG, TIFF or GIF files. TIFF files are multipage, so the profile can be saved to a particular page using the pSaveOptions parameter.
Initialize the structure pointed to by pICCProfile first by calling LFile::InitICCProfileExt. If LFile::SaveICCProfileExt 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.
The pData member of the ICCPROFILEEXT structure points to one block of memory that contains the entire ICC profile. The uDataSize contains the size of the material pointed to by pData.
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::LoadICCProfileExt, Class Members |
|
Topics: |
|
|
|
Example
For an example, refer to LFile::InitICCProfileExt.