L_SaveICCProfile

#include "ltkrn.h"
#include "ltclr.h"

L_INT EXT_FUNCTION L_SaveICCProfile(pszFilename, pICCProfile, pSaveOptions)

L_TCHAR L_FAR * pszFilename;

/* name of a file */

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

pszFilename

Character string containing the name of the file in which to save/embed an ICC profile.

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 L_InitICCProfileExt. If L_SaveICCProfile  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.

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. As tags are added or deleted, these members are not automatically updated. Ordinarily, to update these members, you must call L_GenerateICCPointer.

And since L_SaveICCProfile depends on the values of pData and uDataSize, unless they already have correct data, they must be updated by calling L_GenerateICCPointer.

Note: The maximum size of an ICC profile that can be saved inside a JPEG file is 65533 bytes (0xFFFD). If the ICC profile has size exceeds the 65533 bytes, the function will return ERROR_MARKER_SIZE_TOO_BIG error code.

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

Functions:

L_FreeICCProfile, L_InitICCProfile, L_LoadICCProfile, L_InitICCProfileExt, L_FreeICCProfileExt, L_LoadICCProfileExt, L_FillICCProfileStructure, L_FillICCProfileFromICCFile, L_InitICCHeader, L_SetICCCMMType, L_SetICCDeviceClass, L_SetICCColorSpace, L_SetICCConnectionSpace, L_SetICCPrimaryPlatform, L_SetICCFlags, L_SetICCDevManufacturer, L_SetICCDevModel, L_SetICCDeviceAttributes, L_SetICCRenderingIntent, L_SetICCCreator, L_SetICCDateTime, L_2bFixed2bNumberToDouble, L_DoubleTo2bFixed2bNumber, L_SetICCTagData, L_GetICCTagData, L_CreateICCTagData, L_DeleteICCTag, L_GenerateICCFile, L_GenerateICCPointer, L_GetICCTagTypeSig, L_FreeICCTagType

Topics:

Using ICC Profile Functions

 

ICC Profile Functions: Saving an ICC Profile

Example

For an example, refer to L_InitICCProfileExt.