L_InitICCProfileExt
#include "ltkrn.h"
#include "ltclr.h"
L_INT EXT_FUNCTION L_InitICCProfileExt(pICCProfile, uStructSize)
pICCPROFILEEXT pICCProfile; |
/* pointer to a structure */ |
L_UINT uStructSize; |
/* size of a structure */ |
Initializes an ICCPROFILEEXT structure.
Parameter |
Description |
pICCProfile |
Pointer to the ICCPROFILEEXT structure to initialize. |
uStructSize |
Value that indicates the size of the structure pointed to by pICCProfile. Pass sizeof(ICCPROFILEEXT). |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
The parameter pICCProfile must be allocated before sending it to the function.
An ICCPROFILEEXT structure must be initialized before loading an ICC Profile. To initialize an ICCPROFILEEXT structure, call L_InitICCProfileExt with the uStructSize parameter set to sizeof(MEMICCPROFILEEXT).
This function should be called before calling L_InitICCHeader. If this function is called after L_InitICCHeader, the default values set by L_InitICCHeader will be lost.
When the ICCPROFILEEXT structure is no longer needed, be sure to free the memory allocated by calling L_FreeICCProfileExt.
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. |
Platforms
Windows 95 / 98 / Me, Windows 2000 / XP, Windows CE.
See Also
Example
/* This example initializes an ICC Profile, and then loads an ICC Profile from an Image, and after that it is freed */
ICCPROFILEEXT iccProfile;
// Initialize the ICCPROFILEEXT structure
L_InitICCProfileExt(&iccProfile, sizeof(ICCPROFILEEXT));
// Load an ICC Profile that is embedded in an image
L_LoadICCProfileExt (TEXT("image1.jpg"), &iccProfile, NULL);
// Fill the ICCPROFILEEXT structure with the ICC data loaded from the image
L_FillICCProfileStructure (&iccProfile, iccProfile.pData, iccProfile.uDataSize);
// Save the ICC Profile into another image
L_SaveICCProfile (TEXT("image2.jpg"), &iccProfile, NULL);
// Free the ICCPROFILEEXT structure
L_FreeICCProfileExt (&iccProfile);