LICCProfile::CreateTagData

Summary

Creates an ICC tag.

Syntax

static L_INT LICCProfile::CreateTagData(pDestTagData, pSrcTagData, uTagTypeSig)

Parameters

L_UCHAR * pDestTagData

Pointer to a buffer to be updated with the newly created tag.

L_UCHAR * pSrcTagData

Pointer to a buffer that contains the original tag data.

L_UINT32 uTagTypeSig

A value that indicates the signature of the tag type to be created. Possible values include private tag types and the values listed in ICCTAGTYPESIGNATURE.

Returns

Comments

This function does not insert a tag into the ICC profile. It only creates a tag and updates the pDestTagData parameter with a pointer to the newly created tag. This is cast to the desired tag type.

This function converts the original source data, which is in little Endian format, into the ICC profile format, which is in big Endian format.

Before exiting the program, call LICCProfile::FreeTagType to free the contents of the allocated pDestTagData. In addition, the user should free the pDestTagData pointer itself, since the user allocated it.

Required DLLs and Libraries

• LTCLR
• 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.

See Also

Functions

• LICCProfile::Free
• LICCProfile::Initialize
• LICCProfile::Load
• LICCProfile::Save
• LICCProfile::Fill
• LICCProfile::InitHeader
• LICCProfile::SetCMMType
• LICCProfile::SetDeviceClass
• LICCProfile::SetColorSpace
• LICCProfile::SetConnectionSpace
• LICCProfile::SetPrimaryPlatform
• LICCProfile::SetFlags
• LICCProfile::SetDevManufacturer
• LICCProfile::SetDevModel
• LICCProfile::SetDeviceAttributes
• LICCProfile::SetRenderingIntent
• LICCProfile::SetCreator
• LICCProfile::SetDateTime
• LICCProfile::Convert2bFixed2bNumberToDouble
• LICCProfile::ConvertDoubleTo2bFixed2bNumber
• LICCProfile::SetTagData
• LICCProfile::GetTagData
• LICCProfile::DeleteTag
• LICCProfile::GenerateFile
• LICCProfile::GeneratePointer
• LICCProfile::GetTagTypeSig
• LICCProfile::FreeTagType
• Class Members

Topics

• Using ICC Profile Functions
• ICC Profile Functions: Tags

Example

This example will create an ICC tag

L_INT LICCProfile_CreateTagDataExample() 
{ 
   L_INT nRet = FAILURE; 
   SYSTEMTIME SystemTime;  
   ICCTAG_DATE_TIME_TYPE IccSrcDateTimeType;  
   ICCTAG_DATE_TIME_TYPE IccDstDateTimeType;  
   // Preparing the structure 
   GetSystemTime(&SystemTime);  
   IccSrcDateTimeType.DateTime.uYear = SystemTime.wYear;  
   IccSrcDateTimeType.DateTime.uMonth = SystemTime.wMonth;  
   IccSrcDateTimeType.DateTime.uDay = SystemTime.wDay;  
   IccSrcDateTimeType.DateTime.uHours = SystemTime.wHour;  
   IccSrcDateTimeType.DateTime.uMinutes = SystemTime.wMinute;  
   IccSrcDateTimeType.DateTime.uSeconds = SystemTime.wSecond;  
   // Creating tag type data 
   nRet = LICCProfile::CreateTagData((L_UCHAR  *) &IccDstDateTimeType, (L_UCHAR  *) & IccSrcDateTimeType, DateTimeTypeSig); 
 
   // Freeing the tag type 
   if (nRet == SUCCESS) 
      LICCProfile::FreeTagType ((L_UCHAR  *)(&IccDstDateTimeType), DateTimeTypeSig); 
 
   return nRet; 
}