CIccTagNamedColor2 Class Reference

Class: CIccTagNamedColor2. More...

#include <IccTagBasic.h>

Inheritance diagram for CIccTagNamedColor2:

Collaboration diagram for CIccTagNamedColor2:

Public Member Functions
	CIccTagNamedColor2 (const CIccTagNamedColor2 &ITNC)
	Name: CIccTagNamedColor2::CIccTagNamedColor2.
	CIccTagNamedColor2 (int nSize=1, int nDeviceCoords=0)
	Name: CIccTagNamedColor2::CIccTagNamedColor2.
virtual void	Describe (std::string &sDescription, int nVerboseness)
	Name: CIccTagNamedColor2::Describe.
icInt32Number	FindCachedPCSColor (icFloatNumber *pPCS, icFloatNumber dMinDE=1000.0) const
	Name: CIccTagNamedColor2::FindPCSColor.
icInt32Number	FindColor (const icChar *szColor) const
	Name: CIccTagNamedColor2::FindColor.
icInt32Number	FindDeviceColor (icFloatNumber *pDevColor) const
	Name: CIccTagNamedColor2::FindDeviceColor.
icInt32Number	FindPCSColor (icFloatNumber *pPCS, icFloatNumber dMinDE=1000.0)
	Name: CIccTagNamedColor2::FindPCSColor.
icInt32Number	FindRootColor (const icChar *szRootColor) const
	Name: CIccTagNamedColor2::FindRootColor.
virtual const icChar *	GetClassName () const
bool	GetColorName (std::string &sColorName, icInt32Number index) const
	Name: CIccTagNamedColor2::GetColorName.
icUInt32Number	GetDeviceCoords () const
icColorSpaceSignature	GetDeviceSpace () const
SIccNamedColorEntry *	GetEntry (icUInt32Number index) const
icColorSpaceSignature	GetPCS () const
const icChar *	GetPrefix () const
icUInt32Number	GetSize () const
const icChar *	GetSufix () const
virtual icTagTypeSignature	GetType () const
	Function: GetType()
icUInt32Number	GetVendorFlags () const
bool	InitFindCachedPCSColor ()
	Name: CIccTagNamedColor2::InitFindPCSColor.
void	Lab2ToLab4 (icFloatNumber *Dst, const icFloatNumber *Src) const
	Name: CIccTagNamedColor2::Lab2ToLab4.
void	Lab4ToLab2 (icFloatNumber *Dst, const icFloatNumber *Src) const
	Name: CIccTagNamedColor2::Lab4ToLab2.
icFloatNumber	NegClip (icFloatNumber v) const
	Name: CIccTagNamedColor2::NegClip.
virtual CIccTag *	NewCopy () const
	Function: NewCopy(sDescription) Each derived tag will implement it's own NewCopy() function.
CIccTagNamedColor2 &	operator= (const CIccTagNamedColor2 &NamedColor2Tag)
	Name: CIccTagNamedColor2::operator=.
SIccNamedColorEntry &	operator[] (icUInt32Number index) const
virtual bool	Read (icUInt32Number size, CIccIO *pIO)
	Name: CIccTagNamedColor2::Read.
void	ResetPCSCache ()
	Call ResetPCSCache() if entry values change between calls to FindPCSColor()
virtual void	SetColorSpaces (icColorSpaceSignature csPCS, icColorSpaceSignature csDevice)
	Name: CIccTagNamedColor2::SetColorSpaces.
void	SetPrefix (const icChar *szPrefix)
	Name: CIccTagNamedColor2::SetPrefix.
bool	SetSize (icUInt32Number nSize, icInt32Number nDeviceCoords=-1)
	Name: CIccTagNamedColor2::SetSize.
void	SetSufix (const icChar *szSufix)
	Name: CIccTagNamedColor2::SetSufix.
void	SetVendorFlags (icUInt32Number nVendorFlags)
icFloatNumber	UnitClip (icFloatNumber v) const
	Name: CIccTagNamedColor2::UnitClip.
virtual bool	UseLegacyPCS () const
virtual icValidateStatus	Validate (std::string sigPath, std::string &sReport, const CIccProfile *pProfile=NULL) const
	Name: CIccTagNamedColor2::Validate.
virtual bool	Write (CIccIO *pIO)
	Name: CIccTagNamedColor2::Write.
virtual	~CIccTagNamedColor2 ()
	Name: CIccTagNamedColor2::~CIccTagNamedColor2.
Public Member Functions inherited from CIccTag
	CIccTag ()
	Name: CIccTag::CIccTag.
virtual void	DetachIO ()
	Function: ReadAll() - Read All sub data for tag from file.
virtual IIccExtensionTag *	GetExtension ()
virtual icArraySignature	GetTagArrayType () const
virtual icStructSignature	GetTagStructType () const
virtual bool	IsArrayType ()
virtual bool	IsMBBType ()
virtual bool	IsNumArrayType () const
virtual bool	IsSupported ()
	Function: IsSupported(size, pIO) - Check if tag fully supported for apply purposes.
virtual bool	Read (icUInt32Number size, CIccIO *pIO, CIccProfile *pProfile)
	Function: Read(size, pIO) - Read tag from file.
virtual bool	ReadAll ()
	Function: ReadAll() - Read All sub data for tag from file.
virtual	~CIccTag ()
	Name: CIccTag::CIccTag.

Protected Attributes
icColorSpaceSignature	m_csDevice
icColorSpaceSignature	m_csPCS
SIccNamedColorEntry *	m_NamedColor
SIccNamedLabEntry *	m_NamedLab
icUInt32Number	m_nColorEntrySize
	For quick response of repeated FindPCSColor.
icUInt32Number	m_nDeviceCoords
icUInt32Number	m_nSize
icUInt32Number	m_nVendorFlags
icChar	m_szPrefix [32]
icChar	m_szSufix [32]

Additional Inherited Members
Static Public Member Functions inherited from CIccTag
static CIccTag *	Create (icTagTypeSignature sig)
	Name: CIccTag::Create.
Public Attributes inherited from CIccTag
icUInt32Number	m_nReserved

Detailed Description

Class: CIccTagNamedColor2.

Purpose: the NamedColor2 tag - an array of Named Colors

Definition at line 581 of file IccTagBasic.h.

Constructor & Destructor Documentation

CIccTagNamedColor2() [1/2]

CIccTagNamedColor2::CIccTagNamedColor2	(	int	nSize = 1,
		int	nDeviceCoords = 0 )

Name: CIccTagNamedColor2::CIccTagNamedColor2.

Purpose: Constructor

Args: nSize = number of named color entries, nDeviceCoords = number of device channels

Definition at line 2660 of file IccTagBasic.cpp.

{
  m_nSize = nSize <1 ? 1 : nSize;
  m_nVendorFlags = 0;
  m_nDeviceCoords = nDeviceCoords;
  if (nDeviceCoords<0)
    m_nDeviceCoords = nDeviceCoords = 0;
 
  if (nDeviceCoords>0)
    nDeviceCoords--;
 
  m_szPrefix[0] = '\0';
  m_szSufix[0] = '\0';
  m_csPCS = icSigUnknownData;
  m_csDevice = icSigUnknownData;
 
  m_nColorEntrySize = 32/*rootName*/ + (3/*PCS*/ + 1/*iAny*/ + nDeviceCoords)*sizeof(icFloatNumber);
 
  m_NamedColor = (SIccNamedColorEntry*)calloc(nSize, m_nColorEntrySize);
 
  m_NamedLab = NULL;
}

References icSigUnknownData.

CIccTagNamedColor2() [2/2]

CIccTagNamedColor2::CIccTagNamedColor2

(

const CIccTagNamedColor2 &

ITNC

)

Name: CIccTagNamedColor2::CIccTagNamedColor2.

Purpose: Copy Constructor

Args: ITNC = The CIccTagNamedColor2 object to be copied

Definition at line 2694 of file IccTagBasic.cpp.

{
  m_nColorEntrySize = ITNC.m_nColorEntrySize;
  m_nVendorFlags = ITNC.m_nVendorFlags;
  m_nDeviceCoords = ITNC.m_nDeviceCoords;
  m_nSize = ITNC.m_nSize;
 
  m_csPCS = ITNC.m_csPCS;
  m_csDevice = ITNC.m_csDevice;
 
  memcpy(m_szPrefix, ITNC.m_szPrefix, sizeof(m_szPrefix));
  memcpy(m_szSufix, ITNC.m_szSufix, sizeof(m_szSufix));
 
  m_NamedColor = (SIccNamedColorEntry*)calloc(m_nSize, m_nColorEntrySize);
  memcpy(m_NamedColor, ITNC.m_NamedColor, m_nColorEntrySize*m_nSize);
 
  m_NamedLab = NULL;
}

References m_csDevice, m_csPCS, m_NamedColor, m_nColorEntrySize, m_nDeviceCoords, m_nSize, m_nVendorFlags, m_szPrefix, and m_szSufix.

~CIccTagNamedColor2()

CIccTagNamedColor2::~CIccTagNamedColor2 ( )

virtual

Name: CIccTagNamedColor2::~CIccTagNamedColor2.

Purpose: Destructor

Definition at line 2759 of file IccTagBasic.cpp.

{
  if (m_NamedColor)
    free(m_NamedColor);
 
  if (m_NamedLab)
    delete [] m_NamedLab;
}

Member Function Documentation

Describe()

void CIccTagNamedColor2::Describe ( std::string & sDescription, int nVerboseness )

virtual

Name: CIccTagNamedColor2::Describe.

Purpose: Dump data associated with the tag to a string

Args: sDescription - string to concatenate tag dump to

Reimplemented from CIccTag.

Definition at line 3001 of file IccTagBasic.cpp.

{
  icChar buf[128], szColorVal[40], szColor[40];
 
  icUInt32Number i, j;
  SIccNamedColorEntry *pNamedColor=m_NamedColor;
 
  sDescription.reserve(sDescription.size() + m_nSize*79);
 
  sprintf(buf, "BEGIN_NAMED_COLORS flags=%08x %u %u\n", m_nVendorFlags, m_nSize, m_nDeviceCoords);
  sDescription += buf;
 
  sprintf(buf, "Prefix=\"%s\"\n", m_szPrefix);
  sDescription += buf;
 
  sprintf(buf, "Sufix= \"%s\"\n", m_szSufix);
  sDescription += buf;
 
  for (i=0; i<m_nSize; i++) {
    sprintf(buf, "Color[%u]: %s :", i, pNamedColor->rootName);
    sDescription += buf;
    
    icFloatNumber pcsCoord[3] ={0};
    for (j=0; j<3; j++)
      pcsCoord[j] = pNamedColor->pcsCoords[j];
 
    if (m_csPCS==icSigLabData) {
      for (j=0; j<3; j++)
        pcsCoord[j] = (icFloatNumber)(pcsCoord[j] * 65535.0 / 65280.0);
    }
 
    for (j=0; j<3; j++) {
      icColorIndexName(szColor, m_csPCS, j, 3, "P");
      icColorValue(szColorVal, pcsCoord[j], m_csPCS, j);
      sprintf(buf, " %s=%s", szColor, szColorVal);
      sDescription += buf;
    }
    if (m_nDeviceCoords) {
      sDescription += " :";
      for (j=0; j<m_nDeviceCoords; j++) {
        icColorIndexName(szColor, m_csDevice, j, m_nDeviceCoords, "D");
        icColorValue(szColorVal, pNamedColor->deviceCoords[j], m_csDevice, j);
        sprintf(buf, " %s=%s", szColor, szColorVal);
        sDescription += buf;
      }
    }
    sDescription += "\n";
 
    pNamedColor = (SIccNamedColorEntry*)((icChar*)pNamedColor + m_nColorEntrySize);
  }
}

References SIccNamedColorEntry::deviceCoords, icColorIndexName(), icColorValue(), icSigLabData, SIccNamedColorEntry::pcsCoords, and SIccNamedColorEntry::rootName.

Here is the call graph for this function:

FindCachedPCSColor()

icInt32Number CIccTagNamedColor2::FindCachedPCSColor	(	icFloatNumber *	pPCS,
		icFloatNumber	dMinDE = 1000.0 ) const

Name: CIccTagNamedColor2::FindPCSColor.

Purpose: Find the PCS color within the specified deltaE

Args: pPCS = PCS co-ordinates, dMinDE = the minimum deltaE (tolerance)

Return: Index of the named color array where the PCS color was found, if the color was not found within the tolerance -1 is returned

Definition at line 3164 of file IccTagBasic.cpp.

{
  icFloatNumber dCalcDE, dLeastDE=0.0;
  icFloatNumber pLabIn[3];
  icFloatNumber *pXYZ, *pLab;
  icInt32Number leastDEindex = -1;
  if (m_csPCS != icSigLabData) {
    pXYZ = pPCS;
    icXyzFromPcs(pXYZ);
    icXYZtoLab(pLabIn,pXYZ);
  }
  else {
    Lab2ToLab4(pLabIn, pPCS);
    icLabFromPcs(pLabIn);
  }
 
  if (!m_NamedLab)
    return -1;
 
  for (icUInt32Number i=0; i<m_nSize; i++) {
    pLab = m_NamedLab[i].lab;
 
    dCalcDE = icDeltaE(pLabIn, pLab);
 
    if (i==0) {
      dLeastDE = dCalcDE;
      leastDEindex = i;
    }
 
    if (dCalcDE<dMinDE) {
      if (dCalcDE<dLeastDE) {
        dLeastDE = dCalcDE;
        leastDEindex = i;
      }      
    }
  }
 
  return leastDEindex;
}

References icDeltaE(), icLabFromPcs(), icSigLabData, icXyzFromPcs(), and icXYZtoLab().

Here is the call graph for this function:

FindColor()

icInt32Number CIccTagNamedColor2::FindColor

(

const icChar *

szColor

)

const

Name: CIccTagNamedColor2::FindColor.

Purpose: Find the color with given name

Args: szColor = the color name

Return: Index of the named color array where the color name was found, if the color was not found -1 is returned

Definition at line 3239 of file IccTagBasic.cpp.

{
  std::string sColorName;
  icInt32Number i, j;
 
  j = (icInt32Number)strlen(m_szPrefix);
  if (j != 0) {  
    if (strncmp(szColor, m_szPrefix, j))
      return -1;
  }
 
  j = (icInt32Number)strlen(m_szSufix);
  i = (icInt32Number)strlen(szColor);
  if (j != 0) {
    if (strncmp(szColor+(i-j), m_szSufix, j))
      return -1;    
  }
 
 
  for ( i=0; i<(icInt32Number)m_nSize; i++) {
    sColorName = m_szPrefix;
    sColorName += m_NamedColor[i].rootName;
    sColorName += m_szSufix;
 
    if (strcmp(sColorName.c_str(),szColor) == 0)
      return i;
  }
 
  return -1;
}

FindDeviceColor()

icInt32Number CIccTagNamedColor2::FindDeviceColor

(

icFloatNumber *

pDevColor

)

const

Name: CIccTagNamedColor2::FindDeviceColor.

Purpose: Find the device color

Args: pDevColor = device color co-ordinates

Return: Index of the named color array where the closest device color was found, if device representation is absent -1 is returned.

Definition at line 3283 of file IccTagBasic.cpp.

{
  if (!m_nDeviceCoords)
    return -1;
  
  icFloatNumber dCalcDiff=0.0, dLeastDiff=0.0;
  icFloatNumber *pDevOut;
  icInt32Number leastDiffindex = -1;
 
 
  for (icUInt32Number i=0; i<m_nSize; i++) {
    pDevOut = m_NamedColor[i].deviceCoords;
 
    for (icUInt32Number j=0; j<m_nDeviceCoords; j++) {
      dCalcDiff += (pDevColor[j]-pDevOut[j])*(pDevColor[j]-pDevOut[j]);
    }
    dCalcDiff = (icFloatNumber)sqrt(dCalcDiff);
 
    if (i==0) {
      dLeastDiff = dCalcDiff;
      leastDiffindex = i;
    }
 
    if (dCalcDiff<dLeastDiff) {
      dLeastDiff = dCalcDiff;
      leastDiffindex = i;
    }      
 
    dCalcDiff = 0.0;
  }
 
  return leastDiffindex;
}

FindPCSColor()

icInt32Number CIccTagNamedColor2::FindPCSColor	(	icFloatNumber *	pPCS,
		icFloatNumber	dMinDE = 1000.0 )

Name: CIccTagNamedColor2::FindPCSColor.

Purpose: Find the PCS color within the specified deltaE

Args: pPCS = PCS co-ordinates, dMinDE = the minimum deltaE (tolerance)

Return: Index of the named color array where the PCS color was found, if the color was not found within the tolerance -1 is returned

Definition at line 3218 of file IccTagBasic.cpp.

{
  if (!m_NamedLab)
    InitFindCachedPCSColor();
 
  return FindCachedPCSColor(pPCS, dMinDE);
}

FindRootColor()

icInt32Number CIccTagNamedColor2::FindRootColor

(

const icChar *

szRootColor

)

const

Name: CIccTagNamedColor2::FindRootColor.

Purpose: Find the root color name

Args: szRootColor = string containing the root color name to be found

Return: Index of the named color array where the root color name was found, if the color was not found -1 is returned

Definition at line 3084 of file IccTagBasic.cpp.

{
  for (icUInt32Number i=0; i<m_nSize; i++) {
    if (stricmp(m_NamedColor[i].rootName,szRootColor) == 0)
      return i;
  }
 
  return -1;
}

References stricmp.

Referenced by CMConvertColorNameToIndex().

Here is the caller graph for this function:

GetClassName()

virtual const icChar * CIccTagNamedColor2::GetClassName ( ) const

inlinevirtual

Reimplemented from CIccTag.

Reimplemented in CIccTagXmlNamedColor2.

Definition at line 591 of file IccTagBasic.h.

{ return "CIccTagNamedColor2"; }

GetColorName()

bool CIccTagNamedColor2::GetColorName	(	std::string &	sColorName,
		icInt32Number	index ) const

Name: CIccTagNamedColor2::GetColorName.

Purpose: Extracts the color name from the named color array

Args: sColorName = string where color name will be stored, index = array index of the color name

Return: true = if the index is within range, false = index out of range

Definition at line 3332 of file IccTagBasic.cpp.

{
  if (index > (icInt32Number)m_nSize-1)
    return false;
 
  sColorName += m_szPrefix;
  SIccNamedColorEntry * pNamedColor = (SIccNamedColorEntry*)((icChar*)m_NamedColor + m_nColorEntrySize * index);
  sColorName += pNamedColor->rootName;
  sColorName += m_szSufix;
 
  return true;
}

References SIccNamedColorEntry::rootName.

GetDeviceCoords()

icUInt32Number CIccTagNamedColor2::GetDeviceCoords ( ) const

inline

Definition at line 629 of file IccTagBasic.h.

{return m_nDeviceCoords;}

Referenced by CMGetNamedProfileInfo().

Here is the caller graph for this function:

GetDeviceSpace()

icColorSpaceSignature CIccTagNamedColor2::GetDeviceSpace ( ) const

inline

Definition at line 634 of file IccTagBasic.h.

{return m_csDevice;}

GetEntry()

SIccNamedColorEntry * CIccTagNamedColor2::GetEntry ( icUInt32Number index ) const

inline

Definition at line 626 of file IccTagBasic.h.

{return (SIccNamedColorEntry*)((icUInt8Number*)m_NamedColor + index * m_nColorEntrySize);}

Referenced by CMConvertIndexToColorName().

Here is the caller graph for this function:

GetPCS()

icColorSpaceSignature CIccTagNamedColor2::GetPCS ( ) const

inline

Definition at line 633 of file IccTagBasic.h.

{return m_csPCS;}

GetPrefix()

const icChar * CIccTagNamedColor2::GetPrefix ( ) const

inline

Definition at line 600 of file IccTagBasic.h.

{ return m_szPrefix; }

Referenced by CMGetNamedProfileInfo().

Here is the caller graph for this function:

GetSize()

icUInt32Number CIccTagNamedColor2::GetSize ( ) const

inline

Definition at line 628 of file IccTagBasic.h.

{ return m_nSize; }

Referenced by CMConvertIndexToColorName(), and CMGetNamedProfileInfo().

Here is the caller graph for this function:

GetSufix()

const icChar * CIccTagNamedColor2::GetSufix ( ) const

inline

Definition at line 603 of file IccTagBasic.h.

{ return m_szSufix; }

Referenced by CMGetNamedProfileInfo().

Here is the caller graph for this function:

GetType()

virtual icTagTypeSignature CIccTagNamedColor2::GetType ( ) const

inlinevirtual

Function: GetType()

Purpose: Get Tag Type. Each derived tag will implement it's own GetType() function.

Reimplemented from CIccTag.

Definition at line 590 of file IccTagBasic.h.

{ return icSigNamedColor2Type; }

References icSigNamedColor2Type.

GetVendorFlags()

icUInt32Number CIccTagNamedColor2::GetVendorFlags ( ) const

inline

Definition at line 606 of file IccTagBasic.h.

{ return m_nVendorFlags; }

Referenced by CMGetNamedProfileInfo().

Here is the caller graph for this function:

InitFindCachedPCSColor()

bool CIccTagNamedColor2::InitFindCachedPCSColor

(

)

Name: CIccTagNamedColor2::InitFindPCSColor.

Purpose: Initialization needed for using FindPCSColor

Return: true if successfull, false if failure

Definition at line 3121 of file IccTagBasic.cpp.

{
  icFloatNumber *pXYZ, *pLab;
 
  if (!m_NamedLab) {
    m_NamedLab = new SIccNamedLabEntry[m_nSize];
    if (!m_NamedLab)
      return false;
 
    if (m_csPCS != icSigLabData) {
      for (icUInt32Number i=0; i<m_nSize; i++) {
        pLab = m_NamedLab[i].lab;
        pXYZ = m_NamedColor[i].pcsCoords;
        icXyzFromPcs(pXYZ);
        icXYZtoLab(pLab, pXYZ);
      }
    }
    else {
      for (icUInt32Number i=0; i<m_nSize; i++) {
        pLab = m_NamedLab[i].lab;
        Lab2ToLab4(pLab, m_NamedColor[i].pcsCoords);
        icLabFromPcs(pLab);
      }
    }
  }
 
  return true;
}

References icLabFromPcs(), icSigLabData, icXyzFromPcs(), icXYZtoLab(), and SIccNamedLabEntry::lab.

Here is the call graph for this function:

Lab2ToLab4()

void CIccTagNamedColor2::Lab2ToLab4	(	icFloatNumber *	Dst,
		const icFloatNumber *	Src ) const

Name: CIccTagNamedColor2::Lab2ToLab4.

Purpose: Convert version 2 Lab to version 4 Lab

Args: Dst = array to store version 4 Lab coordinates, Src = array containing version 2 Lab coordinates

Definition at line 3402 of file IccTagBasic.cpp.

{
  Dst[0] = UnitClip((icFloatNumber)(Src[0] * 65535.0 / 65280.0));
  Dst[1] = UnitClip((icFloatNumber)(Src[1] * 65535.0 / 65280.0));
  Dst[2] = UnitClip((icFloatNumber)(Src[2] * 65535.0 / 65280.0));
}

References UnitClip().

Here is the call graph for this function:

Lab4ToLab2()

void CIccTagNamedColor2::Lab4ToLab2	(	icFloatNumber *	Dst,
		const icFloatNumber *	Src ) const

Name: CIccTagNamedColor2::Lab4ToLab2.

Purpose: Convert version 4 Lab to version 2 Lab

Args: Dst = array to store version 2 Lab coordinates, Src = array containing version 4 Lab coordinates

Definition at line 3421 of file IccTagBasic.cpp.

{
  Dst[0] = (icFloatNumber)(Src[0] * 65280.0 / 65535.0);
  Dst[1] = (icFloatNumber)(Src[1] * 65280.0 / 65535.0);
  Dst[2] = (icFloatNumber)(Src[2] * 65280.0 / 65535.0);
}

NegClip()

icFloatNumber CIccTagNamedColor2::NegClip

(

icFloatNumber

v

)

const

Name: CIccTagNamedColor2::NegClip.

Purpose: Negative numbers are clipped to zero

Args: v = number to be clipped

Return: Clipped number

Definition at line 3381 of file IccTagBasic.cpp.

{
  if (v<0)
    v=0;
  
  return v;
}

NewCopy()

virtual CIccTag * CIccTagNamedColor2::NewCopy ( ) const

inlinevirtual

Function: NewCopy(sDescription) Each derived tag will implement it's own NewCopy() function.

Parameter(s): none

Returns a new CIccTag object that is a copy of this object.

Reimplemented from CIccTag.

Definition at line 587 of file IccTagBasic.h.

{return new CIccTagNamedColor2(*this);}

operator=()

CIccTagNamedColor2 & CIccTagNamedColor2::operator=

(

const CIccTagNamedColor2 &

NamedColor2Tag

)

Name: CIccTagNamedColor2::operator=.

Purpose: Copy Operator

Args: NamedColor2Tag = The CIccTagNamedColor2 object to be copied

Definition at line 2724 of file IccTagBasic.cpp.

{
  if (&NamedColor2Tag == this)
    return *this;
 
  m_nColorEntrySize = NamedColor2Tag.m_nColorEntrySize;
  m_nVendorFlags = NamedColor2Tag.m_nVendorFlags;
  m_nDeviceCoords = NamedColor2Tag.m_nDeviceCoords;
  m_nSize = NamedColor2Tag.m_nSize;
 
  m_csPCS = NamedColor2Tag.m_csPCS;
  m_csDevice = NamedColor2Tag.m_csDevice;
 
  memcpy(m_szPrefix, NamedColor2Tag.m_szPrefix, sizeof(m_szPrefix));
  memcpy(m_szSufix, NamedColor2Tag.m_szSufix, sizeof(m_szSufix));
 
  if (m_NamedColor)
    free(m_NamedColor);
  m_NamedColor = (SIccNamedColorEntry*)calloc(m_nSize, m_nColorEntrySize);
  memcpy(m_NamedColor, NamedColor2Tag.m_NamedColor, m_nColorEntrySize*m_nSize);
 
  m_NamedLab = NULL;
 
  return *this;
}

References m_csDevice, m_csPCS, m_NamedColor, m_nColorEntrySize, m_nDeviceCoords, m_nSize, m_nVendorFlags, m_szPrefix, and m_szSufix.

operator[]()

SIccNamedColorEntry & CIccTagNamedColor2::operator[] ( icUInt32Number index ) const

inline

Definition at line 625 of file IccTagBasic.h.

{return *(SIccNamedColorEntry*)((icUInt8Number*)m_NamedColor + index * m_nColorEntrySize);}

Read()

bool CIccTagNamedColor2::Read ( icUInt32Number size, CIccIO * pIO )

virtual

Name: CIccTagNamedColor2::Read.

Purpose: Read in the tag contents into a data block

Args: size - # of bytes in tag, pIO - IO object to read tag from

Return: true = successful, false = failure

Reimplemented from CIccTag.

Definition at line 2875 of file IccTagBasic.cpp.

{
  icTagTypeSignature sig;
  icUInt32Number nNum, nCoords;
 
  icUInt32Number nTagHdrSize = sizeof(icTagTypeSignature) + 
                               sizeof(icUInt32Number) + //m_nReserved=0
                               sizeof(icUInt32Number) + //VendorFlags
                               sizeof(icUInt32Number) + //Num Colors
                               sizeof(icUInt32Number) + //Num Device Coords
                               sizeof(m_szPrefix) + 
                               sizeof(m_szSufix); 
  if (nTagHdrSize > size)
    return false;
 
  if (!pIO) {
    return false;
  }
 
  if (!pIO->Read32(&sig) ||
      !pIO->Read32(&m_nReserved) ||
      !pIO->Read32(&m_nVendorFlags) ||
      !pIO->Read32(&nNum) ||
      !pIO->Read32(&nCoords) ||
      pIO->Read8(m_szPrefix, sizeof(m_szPrefix))!=sizeof(m_szPrefix) ||
      pIO->Read8(m_szSufix, sizeof(m_szSufix))!=sizeof(m_szSufix)) {
    return false;
  }
 
  size -= nTagHdrSize;
 
  icUInt32Number nCount = size / (32+(3+nCoords)*sizeof(icUInt16Number));
 
  if (nCount < nNum)
    return false;
 
  if (!SetSize(nNum, nCoords))
    return false;
 
  icUInt32Number i;
  SIccNamedColorEntry *pNamedColor=m_NamedColor;
 
  for (i=0; i<nNum; i++) {
    if (pIO->Read8(&pNamedColor->rootName, sizeof(pNamedColor->rootName))!=sizeof(pNamedColor->rootName) ||
        pIO->ReadUInt16Float(&pNamedColor->pcsCoords, 3)!=3)
      return false;
    if (nCoords) {
      if (pIO->ReadUInt16Float(&pNamedColor->deviceCoords, nCoords)!=(icInt32Number)nCoords)
        return false;
    }
    pNamedColor = (SIccNamedColorEntry*)((icChar*)pNamedColor + m_nColorEntrySize);
  }
 
  return true;
}

References SIccNamedColorEntry::deviceCoords, SIccNamedColorEntry::pcsCoords, CIccIO::Read32(), CIccIO::Read8(), CIccIO::ReadUInt16Float(), SIccNamedColorEntry::rootName, and sig.

Here is the call graph for this function:

ResetPCSCache()

void CIccTagNamedColor2::ResetPCSCache

(

)

Call ResetPCSCache() if entry values change between calls to FindPCSColor()

Name: CIccTagNamedColor2::ResetPCSCache.

Purpose: This function is called if entry values change between calls to FindPCSColor()

Definition at line 3103 of file IccTagBasic.cpp.

{
  if (m_NamedLab) {
    delete [] m_NamedLab;
    m_NamedLab = NULL;
  }
}

SetColorSpaces()

void CIccTagNamedColor2::SetColorSpaces ( icColorSpaceSignature csPCS, icColorSpaceSignature csDevice )

virtual

Name: CIccTagNamedColor2::SetColorSpaces.

Purpose: Set the device and PCS color space of the tag

Args: csPCS = PCS color space signature, csDevice = Device color space signature

Definition at line 3065 of file IccTagBasic.cpp.

{
   m_csPCS = csPCS;
   m_csDevice = csDevice;
}

SetPrefix()

void CIccTagNamedColor2::SetPrefix

(

const icChar *

szPrefix

)

Name: CIccTagNamedColor2::SetPrefix.

Purpose: Set contents of suffix member field

Args: szPrefix - string to set prefix to

Definition at line 2837 of file IccTagBasic.cpp.

{
  strncpy(m_szPrefix, szPrefix, sizeof(m_szPrefix));
  m_szPrefix[sizeof(m_szPrefix)-1]='\0';
}

SetSize()

bool CIccTagNamedColor2::SetSize	(	icUInt32Number	nSize,
		icInt32Number	nDeviceCoords = -1 )

Name: CIccTagNamedColor2::SetSize.

Purpose: Sets the size of the named color array.

Args: nSize - number of named color entries, nDeviceCoords - number of device channels

Definition at line 2779 of file IccTagBasic.cpp.

{
  if (nSize <1)
    nSize = 1;
  if (nDeviceCoords<0)
    nDeviceCoords = m_nDeviceCoords;
 
  icInt32Number nNewCoords=nDeviceCoords;
 
  if (nDeviceCoords>0)
    nDeviceCoords--;
 
  icUInt32Number nColorEntrySize = 32/*rootName*/ + (3/*PCS*/ + 1/*iAny*/ + nDeviceCoords)*sizeof(icFloatNumber);
 
  SIccNamedColorEntry* pNamedColor = (SIccNamedColorEntry*)calloc(nSize, nColorEntrySize);
 
  if (!pNamedColor)
    return false;
 
  icUInt32Number i, nCopy = __min(nSize, m_nSize);
  icUInt32Number j, nCoords = __min(nNewCoords, (icInt32Number)m_nDeviceCoords);
 
  for (i=0; i<nCopy; i++) {
    SIccNamedColorEntry *pFrom = (SIccNamedColorEntry*)((icChar*)m_NamedColor + i*m_nColorEntrySize);
    SIccNamedColorEntry *pTo = (SIccNamedColorEntry*)((icChar*)pNamedColor + i*nColorEntrySize);
 
    strcpy(pTo->rootName, pFrom->rootName);
    for (j=0; j<3; j++)
      pTo->pcsCoords[j] = pFrom->pcsCoords[j];
 
    for (j=0; j<nCoords; j++) {
      pTo->deviceCoords[j] = pFrom->deviceCoords[j];
    }
  }
  free(m_NamedColor);
 
  m_nColorEntrySize = nColorEntrySize;
 
  m_NamedColor = pNamedColor;
  m_nSize = nSize;
  m_nDeviceCoords = nNewCoords;
 
  ResetPCSCache();
 
  return true;
}

References __min, SIccNamedColorEntry::deviceCoords, SIccNamedColorEntry::pcsCoords, and SIccNamedColorEntry::rootName.

SetSufix()

void CIccTagNamedColor2::SetSufix

(

const icChar *

szSufix

)

Name: CIccTagNamedColor2::SetSufix.

Purpose: Set contents of suffix member field

Args: szPrefix - string to set prefix to

Definition at line 2854 of file IccTagBasic.cpp.

{
  strncpy(m_szSufix, szSufix, sizeof(m_szSufix));
  m_szSufix[sizeof(m_szSufix)-1]='\0';
}

SetVendorFlags()

void CIccTagNamedColor2::SetVendorFlags ( icUInt32Number nVendorFlags )

inline

Definition at line 607 of file IccTagBasic.h.

{m_nVendorFlags = nVendorFlags;}

UnitClip()

icFloatNumber CIccTagNamedColor2::UnitClip

(

icFloatNumber

v

)

const

Name: CIccTagNamedColor2::UnitClip.

Purpose: Clip number so that its between 0-1

Args: v = number to be clipped

Return: Clipped number

Definition at line 3358 of file IccTagBasic.cpp.

{
  if (v<0)
    v = 0;
  if (v>1.0)
    v = 1.0;
 
  return v;
}

UseLegacyPCS()

virtual bool CIccTagNamedColor2::UseLegacyPCS ( ) const

inlinevirtual

Definition at line 593 of file IccTagBasic.h.

{ return true; } //Treat Lab Encoding differently?

Validate()

icValidateStatus CIccTagNamedColor2::Validate ( std::string sigPath, std::string & sReport, const CIccProfile * pProfile = NULL ) const

virtual

Name: CIccTagNamedColor2::Validate.

Purpose: Check tag data validity.

Args: sig = signature of tag being validated, sReport = String to add report information to

Return: icValidateStatusOK if valid, or other error status.

Reimplemented from CIccTag.

Definition at line 3443 of file IccTagBasic.cpp.

{
  icValidateStatus rv = CIccTag::Validate(sigPath, sReport, pProfile);
 
  CIccInfo Info;
  std::string sSigPathName = Info.GetSigPathName(sigPath);
 
  if (!m_nSize) {
    sReport += icMsgValidateWarning;
    sReport += sSigPathName;
    sReport += " - Empty tag!\n";
    rv = icMaxStatus(rv, icValidateWarning);
  }
 
  if (m_nDeviceCoords) {
    if (pProfile) {
      icUInt32Number nCoords = icGetSpaceSamples(pProfile->m_Header.colorSpace);
      if (m_nDeviceCoords != nCoords) {
        sReport += icMsgValidateNonCompliant;
        sReport += sSigPathName;
        sReport += " - Incorrect number of device co-ordinates.\n";
        rv = icMaxStatus(rv, icValidateNonCompliant);
      }
    }
    else {
      sReport += icMsgValidateWarning;
      sReport += sSigPathName;
      sReport += " - Tag validation incomplete: Pointer to profile unavailable.\n";
      rv = icMaxStatus(rv, icValidateWarning);
    }
  }
 
 
  return rv;
}

References CIccInfo::GetSigPathName(), icGetSpaceSamples(), icMaxStatus(), icMsgValidateNonCompliant, icMsgValidateWarning, icValidateNonCompliant, icValidateWarning, and CIccTag::Validate().

Here is the call graph for this function:

Write()

bool CIccTagNamedColor2::Write ( CIccIO * pIO )

virtual

Name: CIccTagNamedColor2::Write.

Purpose: Write the tag to a file

Args: pIO - The IO object to write tag to.

Return: true = succesful, false = failure

Reimplemented from CIccTag.

Definition at line 2945 of file IccTagBasic.cpp.

{
  icTagTypeSignature sig = GetType();
 
  if (!pIO)
   return false;
 
  if (!pIO->Write32(&sig))
   return false;
 
  if (!pIO->Write32(&m_nReserved))
    return false;
 
  if (!pIO->Write32(&m_nVendorFlags))
    return false;
 
  if (!pIO->Write32(&m_nSize))
    return false;
 
  if (!pIO->Write32(&m_nDeviceCoords))
    return false;
 
  if (!pIO->Write8(m_szPrefix, sizeof(m_szPrefix)))
    return false;
 
  if (!pIO->Write8(m_szSufix, sizeof(m_szSufix)))
    return false;
 
  icUInt32Number i;
  SIccNamedColorEntry *pNamedColor=m_NamedColor;
 
  for (i=0; i<m_nSize; i++) {
    if (pIO->Write8(&pNamedColor->rootName, sizeof(pNamedColor->rootName))!=sizeof(pNamedColor->rootName) ||
        pIO->WriteUInt16Float(&pNamedColor->pcsCoords, 3)!=3)
      return false;
    if (m_nDeviceCoords) {
      if (pIO->WriteUInt16Float(&pNamedColor->deviceCoords, m_nDeviceCoords) != (icInt32Number)m_nDeviceCoords)
        return false;
    }
    pNamedColor = (SIccNamedColorEntry*)((icChar*)pNamedColor + m_nColorEntrySize);
  }
 
  return true;
}

References SIccNamedColorEntry::deviceCoords, SIccNamedColorEntry::pcsCoords, SIccNamedColorEntry::rootName, sig, CIccIO::Write32(), CIccIO::Write8(), and CIccIO::WriteUInt16Float().

Here is the call graph for this function:

Member Data Documentation

m_csDevice

icColorSpaceSignature CIccTagNamedColor2::m_csDevice

protected

Definition at line 657 of file IccTagBasic.h.

Referenced by CIccTagNamedColor2(), and operator=().

m_csPCS

icColorSpaceSignature CIccTagNamedColor2::m_csPCS

protected

Definition at line 656 of file IccTagBasic.h.

Referenced by CIccTagNamedColor2(), and operator=().

m_NamedColor

SIccNamedColorEntry* CIccTagNamedColor2::m_NamedColor

protected

Definition at line 648 of file IccTagBasic.h.

Referenced by CIccTagNamedColor2(), and operator=().

m_NamedLab

SIccNamedLabEntry* CIccTagNamedColor2::m_NamedLab

protected

Definition at line 649 of file IccTagBasic.h.

m_nColorEntrySize

icUInt32Number CIccTagNamedColor2::m_nColorEntrySize

protected

For quick response of repeated FindPCSColor.

Definition at line 650 of file IccTagBasic.h.

Referenced by CIccTagNamedColor2(), and operator=().

m_nDeviceCoords

icUInt32Number CIccTagNamedColor2::m_nDeviceCoords

protected

Definition at line 653 of file IccTagBasic.h.

Referenced by CIccTagNamedColor2(), and operator=().

m_nSize

icUInt32Number CIccTagNamedColor2::m_nSize

protected

Definition at line 654 of file IccTagBasic.h.

Referenced by CIccTagNamedColor2(), and operator=().

m_nVendorFlags

icUInt32Number CIccTagNamedColor2::m_nVendorFlags

protected

Definition at line 652 of file IccTagBasic.h.

Referenced by CIccTagNamedColor2(), and operator=().

m_szPrefix

icChar CIccTagNamedColor2::m_szPrefix[32]

protected

Definition at line 645 of file IccTagBasic.h.

Referenced by CIccTagNamedColor2(), and operator=().

m_szSufix

icChar CIccTagNamedColor2::m_szSufix[32]

protected

Definition at line 646 of file IccTagBasic.h.

Referenced by CIccTagNamedColor2(), and operator=().

---

The documentation for this class was generated from the following files:

• IccProfLib/IccTagBasic.h
• IccProfLib/IccTagBasic.cpp