In This Topic ▼

L_GenerateICCFile

Summary

Generates an ICC profile file.

Syntax

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

L_LTCLR_API L_INT L_GenerateICCFile(pICCProfile, pszFileName)

Parameters

pICCPROFILEEXT pICCProfile

Pointer to the ICCPROFILEEXT structure that will be used to generate the ICC profile file.

L_TCHAR * pszFileName

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

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function will generate an ICC profile file that can be used in other applications.

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_GenerateICCFile depends on pData and uDataSize, unless they already have correct data, they must be updated by calling L_GenerateICCPointer.

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

Win32, x64.

Example

This function will generate an ICC profile file.

L_INT GenerateICCFileExample(pICCPROFILEEXT pICCProfile, 
                                             L_TCHAR      * pszFilename) 
{ 
   L_INT nRet; 
   nRet = L_GenerateICCFile(pICCProfile, pszFilename); 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
}