L_FillICCProfileFromICCFile

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

L_LTCLR_API L_INT L_FillICCProfileFromICCFile(pszFileName, pICCProfile)

L_TCHAR * pszFileName;

/* name of the file to load */

pICCPROFILEEXT pICCProfile;

/* pointer to a structure */

Fills the ICCPROFILEEXT structure fields with the appropriate ICC data from the specified file.

Parameter

Description

pszFileName

Character string containing the name of the ICC file from which to get the ICC data.

pICCProfile

Pointer to an ICCPROFILEEXT structure to be filled with the data.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function fills the ICCPROFILEEXT structure directly from an ICC file.

The ICCPROFILEEXT structure must be initialized, by calling L_InitICCProfile, before calling this function.

If the version of the ICC file is v4 or more (i.e. consistent with the ICC specification ICC.1:2004-10), the data inside the ICC file will be extracted into the structure. Otherwise, the ICC will be loaded into a buffer, and a pointer to that buffer will be stored in the pData field of the ICCPROFILEEXT structure, and its size will be in the uDataSize field of the same structure.

To save an ICC Profile to an ICC Profile file call L_GenerateICCFile.

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.

See Also

Functions:

L_InitICCProfile, L_FreeICCProfile, L_SaveICCProfile, L_LoadICCProfile, L_FillICCProfileStructure, 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_SetICCProfileId, L_2bFixed2bNumberToDouble, L_U8Fixed8NumberToDouble, L_DoubleToU8Fixed8Number, L_DoubleTo2bFixed2bNumber, L_SetICCTagData, L_GetICCTagData, L_CreateICCTagData, L_DeleteICCTag, L_GenerateICCFile, L_GenerateICCPointer, L_GetICCTagTypeSig, L_FreeICCTagType, L_ConvertParametricCurveTypeToBuffer, L_ConvertCurveTypeToBuffer, L_ConvertCLUTToBuffer, L_GetParametricCurveNumberOfParameters

Topics:

Using ICC Profile Functions

 

ICC Profile Functions: Loading an ICC Profile

Example

This example fills the structure with ICC data directly from an ICC file.

pICCPROFILEEXT FillICCProfileFromICCFileExample(pICCPROFILEEXT pIccProfile, L_TCHAR* pszFileName, L_INT *nRet)
{
   *nRet = L_FillICCProfileFromICCFile(pszFileName, pIccProfile);

   return pIccProfile;
}