CIccTagNum< T, Tsig > Class Template Reference

#include <IccTagBasic.h>

Inheritance diagram for CIccTagNum< T, Tsig >:

Collaboration diagram for CIccTagNum< T, Tsig >:

Public Member Functions
	CIccTagNum (const CIccTagNum< T, Tsig > &ITNum)
	CIccTagNum (int nSize=1)
virtual	~CIccTagNum ()
void	Describe (std::string &sDescription, int nVerboseness)
virtual void	Describe (std::string &sDescription, int nVerboseness)
virtual void	DetachIO ()
virtual const icChar *	GetClassName () const
virtual IIccExtensionTag *	GetExtension ()
virtual icUInt32Number	GetNumValues () const
icUInt32Number	GetSize () const
	Returns the size of the data array.
virtual icArraySignature	GetTagArrayType () const
virtual icStructSignature	GetTagStructType () const
virtual icTagTypeSignature	GetType () const
bool	GetValues (icFloatNumber *DstVector, icUInt32Number nStart, icUInt32Number nVectorSize) const
bool	GetValues (icFloatNumber *DstVector, icUInt32Number nStart, icUInt32Number nVectorSize) const
virtual bool	GetValues (icFloatNumber *DstVector, icUInt32Number nStart=0, icUInt32Number nVectorSize=1) const
bool	Interpolate (icFloatNumber *DstVector, icFloatNumber pos, icUInt32Number nVectorSize, icFloatNumber *zeroVals) const
bool	Interpolate (icFloatNumber *DstVector, icFloatNumber pos, icUInt32Number nVectorSize, icFloatNumber *zeroVals) const
virtual bool	Interpolate (icFloatNumber *DstVector, icFloatNumber val, icUInt32Number nVectorSize=1, icFloatNumber *zeroVals=NULL) const
virtual bool	IsArrayType ()
virtual bool	IsMatrixArray () const
virtual bool	IsMBBType ()
virtual bool	IsNumArrayType () const
virtual bool	IsSupported ()
virtual CIccTag *	NewCopy () const
CIccTagNum &	operator= (const CIccTagNum< T, Tsig > &NumTag)
T &	operator[] (icUInt32Number index)
virtual bool	Read (icUInt32Number size, CIccIO *pIO)
virtual bool	Read (icUInt32Number size, CIccIO *pIO, CIccProfile *pProfile)
virtual bool	ReadAll ()
bool	SetSize (icUInt32Number nSize, bool bZeroNew=true)
virtual icValidateStatus	Validate (std::string sigPath, std::string &sReport, const CIccProfile *pProfile=NULL) const
bool	ValuePos (icFloatNumber &DstPos, icFloatNumber val, bool &bNoZero) const
bool	ValuePos (icFloatNumber &DstPos, icFloatNumber val, bool &bNoZero) const
virtual bool	ValuePos (icFloatNumber &DstPos, icFloatNumber val, bool &bNoZero) const
virtual bool	Write (CIccIO *pIO)

Static Public Member Functions
static CIccTag *	Create (icTagTypeSignature sig)

Data Fields
icUInt32Number	m_nReserved

Protected Attributes
icUInt32Number	m_nSize
T *	m_Num

Detailed Description

template<class T, icTagTypeSignature Tsig>
class CIccTagNum< T, Tsig >

Class: CIccTagNum

Purpose: A template class for arrays of integers

Derived Tags: CIccTagUInt8, CIccTagUInt16, CIccTagUInt32 and CIccTagUInt64

Constructor & Destructor Documentation

CIccTagNum() [1/2]

template<class T , icTagTypeSignature Tsig>

CIccTagNum< T, Tsig >::CIccTagNum

(

int

nSize = 1

)

Name: CIccTagNum::CIccTagNum

Purpose: Constructor

Args: nSize = number of data entries

{
  m_nSize = nSize;
  if (m_nSize <1)
    m_nSize = 1;
  m_Num = (T*)calloc(nSize, sizeof(T));
}

References CIccTagNum< T, Tsig >::m_nSize, and CIccTagNum< T, Tsig >::m_Num.

CIccTagNum() [2/2]

template<class T , icTagTypeSignature Tsig>

CIccTagNum< T, Tsig >::CIccTagNum

(

const CIccTagNum< T, Tsig > &

ITNum

)

Name: CIccTagNum::CIccTagNum

Purpose: Copy Constructor

Args: ITNum = The CIccTagNum object to be copied

{
  m_nSize = ITNum.m_nSize;
 
  m_Num = (T*)calloc(m_nSize, sizeof(T));
  memcpy(m_Num, ITNum.m_Num, m_nSize * sizeof(T));
}

References CIccTagNum< T, Tsig >::m_nSize, and CIccTagNum< T, Tsig >::m_Num.

~CIccTagNum()

template<class T , icTagTypeSignature Tsig>

CIccTagNum< T, Tsig >::~CIccTagNum ( )

virtual

Name: CIccTagNum::~CIccTagNum

Purpose: Destructor

{
  if (m_Num)
    free(m_Num);
}

References CIccTagNum< T, Tsig >::m_Num.

Member Function Documentation

Create()

CIccTag * CIccTag::Create ( icTagTypeSignature  sig )

staticinherited

Name: CIccTag::Create

Purpose: This is a static tag creator based upon tag signature type

Args: sig = tag type signature

Return: Pointer to Allocated tag

{
  return CIccTagCreator::CreateTag(sig);
}

References CIccTagCreator::CreateTag().

Referenced by CIccDefaultEncProfileConverter::ConvertFromParams(), CIccTagStruct::LoadElem(), CIccProfileXml::ParseTag(), CIccTagXmlStruct::ParseTag(), CIccMpeXmlTintArray::ParseXml(), CIccTagXmlArray::ParseXml(), CIccMpeTintArray::Read(), CIccTagLutAtoB::Read(), CIccTagLut8::Read(), CIccTagLut16::Read(), CIccTagLut8::SetColorSpaces(), CIccTagLut16::SetColorSpaces(), and CIccProfileDescText::SetType().

Here is the call graph for this function:

Here is the caller graph for this function:

Describe() [1/2]

void CIccTagNum< icUInt64Number, icSigUInt64ArrayType >::Describe ( std::string &  sDescription, int  nVerboseness  )

virtual

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

Parameter(s): sDescription - A string to put the tag's description into.

• verbosenss - integer value. Default=0. The larger the value, the more verbose the output.

Reimplemented from CIccTag.

{
  icChar buf[128];
 
  if (m_nSize == 1 ) {
    sprintf(buf, "Value = %llu (0x016%llx)\n", m_Num[0], m_Num[0]);
    sDescription += buf;
  }
  else {
    icUInt32Number i;
    sDescription.reserve(sDescription.size() + m_nSize*79);
 
    for (i=0; i<m_nSize; i++) {
      sprintf(buf, "Value = %llu (0x016%llx)\n", m_Num[i], m_Num[i]);
      sDescription += buf;
    }
  }
}

Describe() [2/2]

template<class T , icTagTypeSignature Tsig>

void CIccTagNum< T, Tsig >::Describe ( std::string &  sDescription, int  nVerboseness  )

virtual

Name: CIccTagNum::Describe

Purpose: Dump data associated with the tag to a string

Args: sDescription - string to concatenate tag dump to

Reimplemented from CIccTag.

{
  icChar buf[128] = {0};
 
  if (m_nSize == 1 ) {
    switch (sizeof(T)) {
      case 1:
        sprintf(buf, "Value = %u (0x02%x)\n", m_Num[0], m_Num[0]);
        break;
      case 2:
        sprintf(buf, "Value = %u (0x04%x)\n", m_Num[0], m_Num[0]);
        break;
      case 4:
        sprintf(buf, "Value = %u (0x08%x)\n", m_Num[0], m_Num[0]);
        break;
      case 8:
        sprintf(buf, "Value = %u (0x016%x)\n", m_Num[0], m_Num[0]);
        break;
      default:
        sprintf(buf, "Value = %u (0x%x)\n", m_Num[0], m_Num[0]);
        break;
    }
    sDescription += buf;
  }
  else {
    icUInt32Number i;
    sDescription.reserve(sDescription.size() + m_nSize*79);
 
    for (i=0; i<m_nSize; i++) {
      switch (sizeof(T)) {
      case 1:
        sprintf(buf, "Value = %u (0x02%x)\n", m_Num[i], m_Num[i]);
        break;
      case 2:
        sprintf(buf, "Value = %u (0x04%x)\n", m_Num[i], m_Num[i]);
        break;
      case 4:
        sprintf(buf, "Value = %u (0x08%x)\n", m_Num[i], m_Num[i]);
        break;
      case 8:
        sprintf(buf, "Value = %u (0x016%x)\n", m_Num[i], m_Num[i]);
        break;
      default:
        sprintf(buf, "Value = %u (0x%x)\n", m_Num[i], m_Num[i]);
        break;
      }
      sDescription += buf;
    }
  }
}

References CIccTagNum< T, Tsig >::m_nSize, and CIccTagNum< T, Tsig >::m_Num.

DetachIO()

virtual void CIccTag::DetachIO ( )

inlinevirtualinherited

Function: ReadAll() - Read All sub data for tag from file. Called by CIccProfile::ReadAll() to read all sub data for tag

Returns true if ReadAll is successful.

{}

GetClassName()

template<class T , icTagTypeSignature Tsig>

const icChar * CIccTagNum< T, Tsig >::GetClassName ( ) const

virtual

Name: CIccTagNum::GetClassName

Purpose: Returns the tag type class name

Reimplemented from CIccTag.

Reimplemented in CIccTagXmlNum< T, A, Tsig >.

{
  if (sizeof(T)==sizeof(icUInt8Number))
    return "CIccTagUInt8";
  else if (sizeof(T)==sizeof(icUInt16Number))
    return "CIccTagUInt16";
  else if (sizeof(T)==sizeof(icUInt32Number))
    return "CIccTagUInt32";
  else if (sizeof(T)==sizeof(icUInt64Number))
    return "CIccTagUInt64";
  else
    return "CIccTagNum<>";
}

GetExtension()

virtual IIccExtensionTag * CIccTag::GetExtension ( )

inlinevirtualinherited

Reimplemented in CIccTagXmlUnknown, CIccTagXmlText, CIccTagXmlUtf8Text, CIccTagXmlZipUtf8Text, CIccTagXmlZipXml, CIccTagXmlUtf16Text, CIccTagXmlTextDescription, CIccTagXmlSignature, CIccTagXmlNamedColor2, CIccTagXmlXYZ, CIccTagXmlChromaticity, CIccTagXmlCicp, CIccTagXmlSparseMatrixArray, CIccTagXmlFixedNum< T, Tsig >, CIccTagXmlNum< T, A, Tsig >, CIccTagXmlFloatNum< T, A, Tsig >, CIccTagXmlMeasurement, CIccTagXmlMultiLocalizedUnicode, CIccTagXmlTagData, CIccTagXmlDateTime, CIccTagXmlColorantOrder, CIccTagXmlColorantTable, CIccTagXmlViewingConditions, CIccTagXmlSpectralDataInfo, CIccTagXmlSpectralViewingConditions, CIccTagXmlProfileSeqDesc, CIccTagXmlResponseCurveSet16, CIccTagXmlCurve, CIccTagXmlParametricCurve, CIccTagXmlSegmentedCurve, CIccTagXmlLutAtoB, CIccTagXmlLutBtoA, CIccTagXmlLut8, CIccTagXmlLut16, CIccTagXmlMultiProcessElement, CIccTagXmlProfileSequenceId, CIccTagXmlDict, CIccTagXmlStruct, CIccTagXmlArray, CIccTagXmlGamutBoundaryDesc, CIccTagXmlEmbeddedHeightImage, CIccTagXmlEmbeddedNormalImage, and CIccTagXmlEmbeddedProfile.

{return NULL;}

Referenced by icCurvesFromXml(), icCurvesToXml(), icProfDescToXml(), icXmlParseProfDesc(), CIccProfileXml::ParseTag(), CIccTagXmlStruct::ParseTag(), CIccMpeXmlTintArray::ParseXml(), CIccTagXmlArray::ParseXml(), CIccMpeXmlTintArray::ToXml(), CIccTagXmlStruct::ToXml(), CIccTagXmlArray::ToXml(), and CIccProfileXml::ToXmlWithBlanks().

Here is the caller graph for this function:

GetNumValues()

template<class T , icTagTypeSignature Tsig>

virtual icUInt32Number CIccTagNum< T, Tsig >::GetNumValues ( ) const

inlinevirtual

Implements CIccTagNumArray.

{ return GetSize(); }

References CIccTagNum< T, Tsig >::GetSize().

Here is the call graph for this function:

GetSize()

template<class T , icTagTypeSignature Tsig>

icUInt32Number CIccTagNum< T, Tsig >::GetSize ( ) const

inline

Returns the size of the data array.

{ return m_nSize; }

References CIccTagNum< T, Tsig >::m_nSize.

Referenced by CIccTagNum< T, Tsig >::GetNumValues().

Here is the caller graph for this function:

GetTagArrayType()

virtual icArraySignature CIccTag::GetTagArrayType ( ) const

inlinevirtualinherited

Reimplemented in CIccTagArray.

{ return icSigUndefinedArray; }

References icSigUndefinedArray.

Referenced by icGetTagArrayHandlerOfType(), and CIccProfileXml::ParseTag().

Here is the caller graph for this function:

GetTagStructType()

virtual icStructSignature CIccTag::GetTagStructType ( ) const

inlinevirtualinherited

Reimplemented in CIccTagStruct.

{ return icSigUndefinedStruct; }

References icSigUndefinedStruct.

Referenced by icGetTagStructHandlerOfType(), CIccArrayColorantInfo::Validate(), and CIccArrayNamedColor::Validate().

Here is the caller graph for this function:

GetType()

template<class T , icTagTypeSignature Tsig>

virtual icTagTypeSignature CIccTagNum< T, Tsig >::GetType ( ) const

inlinevirtual

Function: GetType()

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

Reimplemented from CIccTag.

{ return Tsig; }

Referenced by CIccTagNum< T, Tsig >::Write().

Here is the caller graph for this function:

GetValues() [1/3]

bool CIccTagNum< icUInt32Number, icSigUInt32ArrayType >::GetValues ( icFloatNumber *  DstVector, icUInt32Number  nStart, icUInt32Number  nVectorSize  ) const

virtual

Implements CIccTagNumArray.

{
  return false;
}

GetValues() [2/3]

bool CIccTagNum< icUInt64Number, icSigUInt64ArrayType >::GetValues ( icFloatNumber *  DstVector, icUInt32Number  nStart, icUInt32Number  nVectorSize  ) const

virtual

Implements CIccTagNumArray.

{
  return false;
}

GetValues() [3/3]

template<class T , icTagTypeSignature Tsig>

bool CIccTagNum< T, Tsig >::GetValues ( icFloatNumber *  DstVector, icUInt32Number  nStart = 0, icUInt32Number  nVectorSize = 1  ) const

virtual

Name: CIccTagNum::GetValues

Purpose: Gets values from the num array tag as floating point numbers

Args: nSize - number of data entries, bZeroNew - flag to zero newly formed values

Implements CIccTagNumArray.

{
  if (nVectorSize+nStart >m_nSize)
    return false;
 
  icUInt32Number i;
  
  switch (Tsig) {
    case icSigUInt8ArrayType:
      for (i=0; i<m_nSize; i++) {
        DstVector[i] = icU8toF((icUInt8Number)(m_Num[i+nStart]));
      }
      break;
    case icSigUInt16ArrayType:
      for (i=0; i<m_nSize; i++) {
        DstVector[i] = icU16toF((icUInt16Number)(m_Num[i+nStart]));
      }
      break;
    case icSigUInt32ArrayType: //Not Supported
    case icSigUInt64ArrayType: //Not Supported
    default:
      return false;
  }
  return true;
}

References icSigUInt16ArrayType, icSigUInt32ArrayType, icSigUInt64ArrayType, icSigUInt8ArrayType, icU16toF(), icU8toF(), CIccTagNum< T, Tsig >::m_nSize, and CIccTagNum< T, Tsig >::m_Num.

Here is the call graph for this function:

Interpolate() [1/3]

bool CIccTagNum< icUInt32Number, icSigUInt32ArrayType >::Interpolate ( icFloatNumber *  DstVector, icFloatNumber  pos, icUInt32Number  nVectorSize, icFloatNumber *  zeroVals  ) const

virtual

Implements CIccTagNumArray.

{
  return false;
}

Interpolate() [2/3]

bool CIccTagNum< icUInt64Number, icSigUInt64ArrayType >::Interpolate ( icFloatNumber *  DstVector, icFloatNumber  pos, icUInt32Number  nVectorSize, icFloatNumber *  zeroVals  ) const

virtual

Implements CIccTagNumArray.

{
  return false;
}

Interpolate() [3/3]

template<class T , icTagTypeSignature Tsig>

bool CIccTagNum< T, Tsig >::Interpolate ( icFloatNumber *  DstVector, icFloatNumber  pos, icUInt32Number  nVectorSize = 1, icFloatNumber *  zeroVals = NULL  ) const

virtual

Name: CIccTagNum::Interpolate

Purpose: Gets values from the num array tag as floating point numbers

Args: nSize - number of data entries, bZeroNew - flag to zero newly formed values

Implements CIccTagNumArray.

{
  icUInt32Number nVector = m_nSize / nVectorSize;
 
  if (!nVector)
    return false;
 
  if (zeroVals)
    nVector ++;
  else if (nVector<=1)
    return false;
 
  if (pos<0.0)
    pos=0.0;
  if (pos>1.0)
    pos=1.0;
 
  icFloatNumber fpos = (icFloatNumber)(nVector-1) * pos;
  icUInt32Number iPos = (icUInt32Number)fpos;
  icFloatNumber x = fpos - iPos;
 
  if (iPos == nVector-1) {
    iPos--;
    x = (icFloatNumber)1.0;
  }
 
  T *lo, *hi;
 
  if (!zeroVals) {
    if (!iPos) {
      lo = NULL;
      hi = m_Num;
    }
    else {
      lo = &m_Num[(iPos-1)*nVectorSize];
      hi = &lo[nVectorSize];
    }
  }
  else {
    lo = &m_Num[iPos*nVectorSize];
    hi = &lo[nVectorSize];
  }
  
  icUInt32Number i;
 
  switch (Tsig) {
    case icSigUInt8ArrayType:
      if (!lo) {
        if (zeroVals) {
          for (i = 0; i < m_nSize; i++) {
            DstVector[i] = zeroVals[i] * (1.0f - x) + icU8toF((icUInt8Number)hi[i]) * x;
          }
        }
        else {
          for (i = 0; i < m_nSize; i++) {
            DstVector[i] = icU8toF((icUInt8Number)hi[i]) * x;
          }
        }
      }
      else {
        for (i=0; i<m_nSize; i++) {
          DstVector[i] = icU8toF((icUInt8Number)lo[i])*(1.0f-x) + icU8toF((icUInt8Number)hi[i])*x;
        }
      }
      break;
    case icSigUInt16ArrayType:
      if (!lo) {
        if (zeroVals) {
          for (i = 0; i < m_nSize; i++) {
            DstVector[i] = zeroVals[i] * (1.0f - x) + icU16toF((icUInt16Number)hi[i]) * x;
          }
        }
        else {
          for (i = 0; i < m_nSize; i++) {
            DstVector[i] = icU16toF((icUInt16Number)hi[i]) * x;
          }
        }
      }
      else {
        for (i=0; i<m_nSize; i++) {
          DstVector[i] = icU16toF((icUInt16Number)lo[i])*(1.0f-x) + icU16toF((icUInt16Number)hi[i])*x;
        }
      }
      break;
    case icSigUInt32ArrayType:
    case icSigUInt64ArrayType:
    default:
      return false;
  }
  return true;
}

References icSigUInt16ArrayType, icSigUInt32ArrayType, icSigUInt64ArrayType, icSigUInt8ArrayType, icU16toF(), icU8toF(), CIccTagNum< T, Tsig >::m_nSize, and CIccTagNum< T, Tsig >::m_Num.

Here is the call graph for this function:

IsArrayType()

template<class T , icTagTypeSignature Tsig>

virtual bool CIccTagNum< T, Tsig >::IsArrayType ( )

inlinevirtual

Reimplemented from CIccTag.

{ return m_nSize > 1; }

References CIccTagNum< T, Tsig >::m_nSize.

IsMatrixArray()

template<class T , icTagTypeSignature Tsig>

virtual bool CIccTagNum< T, Tsig >::IsMatrixArray ( ) const

inlinevirtual

Implements CIccTagNumArray.

{ return false; }

IsMBBType()

virtual bool CIccTag::IsMBBType ( )

inlinevirtualinherited

Reimplemented in CIccMBB.

{ return false; } //If true then CIccTag can be cast as an CIccMBB 

Referenced by CIccProfileXml::ParseTag().

Here is the caller graph for this function:

IsNumArrayType()

template<class T , icTagTypeSignature Tsig>

virtual bool CIccTagNum< T, Tsig >::IsNumArrayType ( ) const

inlinevirtual

Reimplemented from CIccTag.

{ return true; }

IsSupported()

virtual bool CIccTag::IsSupported ( )

inlinevirtualinherited

Function: IsSupported(size, pIO) - Check if tag fully supported for apply purposes. By Default inherited classes are supported. Unknown tag types are not supported.

Returns true if tag type is supported.

Reimplemented in CIccTagUnknown, CIccTagEmbeddedProfile, and CIccTagMultiProcessElement.

{ return true; }

NewCopy()

template<class T , icTagTypeSignature Tsig>

virtual CIccTag * CIccTagNum< T, Tsig >::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.

{ return new CIccTagNum<T, Tsig>(*this); }

operator=()

template<class T , icTagTypeSignature Tsig>

CIccTagNum< T, Tsig > & CIccTagNum< T, Tsig >::operator=

(

const CIccTagNum< T, Tsig > &

ITNum

)

Name: CIccTagNum::operator=

Purpose: Copy Operator

Args: ITNum = The CIccTagNum object to be copied

{
  if (&ITNum == this)
    return *this;
 
  m_nSize = ITNum.m_nSize;
 
  m_Num = (T*)calloc(m_nSize, sizeof(T));
  memcpy(m_Num, ITNum.m_Num, m_nSize * sizeof(T));
 
  return *this;
}

References CIccTagNum< T, Tsig >::m_nSize, and CIccTagNum< T, Tsig >::m_Num.

operator[]()

template<class T , icTagTypeSignature Tsig>

T & CIccTagNum< T, Tsig >::operator[] ( icUInt32Number  index )

inline

{return m_Num[index];}

References CIccTagNum< T, Tsig >::m_Num.

Read() [1/2]

template<class T , icTagTypeSignature Tsig>

bool CIccTagNum< T, Tsig >::Read ( icUInt32Number  size, CIccIO *  pIO  )

virtual

Name: CIccTagNum::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.

{
  icTagTypeSignature sig;
 
  if (sizeof(icTagTypeSignature) + 
      sizeof(icUInt32Number) + 
      sizeof(T) > size)
    return false;
 
  if (!pIO) {
    return false;
  }
 
  if (!pIO->Read32(&sig))
    return false;
 
  if (!pIO->Read32(&m_nReserved))
    return false;
 
  icUInt32Number nSize=((size-2*sizeof(icUInt32Number)) / sizeof(T));
 
  if (!SetSize(nSize))
    return false;
 
  if (sizeof(T)==sizeof(icUInt8Number)) {
    if (pIO->Read8(m_Num, nSize) != (icInt32Number)nSize )
      return false;
  }
  else if (sizeof(T)==sizeof(icUInt16Number)) {
    if (pIO->Read16(m_Num, nSize) != (icInt32Number)nSize )
      return false;
  }
  else if (sizeof(T)==sizeof(icUInt32Number)) {
    if (pIO->Read32(m_Num, nSize) != (icInt32Number)nSize )
      return false;
  }
  else if (sizeof(T)==sizeof(icUInt64Number)) {
    if (pIO->Read64(m_Num, nSize) != (icInt32Number)nSize )
      return false;
  }
  else
    return false;
 
  return true;
}

References CIccTag::m_nReserved, CIccTagNum< T, Tsig >::m_Num, CIccIO::Read16(), CIccIO::Read32(), CIccIO::Read64(), CIccIO::Read8(), and CIccTagNum< T, Tsig >::SetSize().

Here is the call graph for this function:

Read() [2/2]

virtual bool CIccTag::Read ( icUInt32Number  size, CIccIO *  pIO, CIccProfile *  pProfile  )

inlinevirtualinherited

Function: Read(size, pIO) - Read tag from file. Each derived tag will implement it's own Read() function.

Parameter(s): size - number of bytes in tag including the type signature. pIO - IO object used to read in tag. The IO object should already be initialized to point to the begining of the tag.

Returns true if Read is successful.

Reimplemented in CIccTagEmbeddedProfile.

{ return Read(size, pIO); }

References CIccTag::Read().

Here is the call graph for this function:

ReadAll()

virtual bool CIccTag::ReadAll ( )

inlinevirtualinherited

Function: ReadAll() - Read All sub data for tag from file. Called by CIccProfile::ReadAll() to read all sub data for tag

Returns true if ReadAll is successful.

Reimplemented in CIccTagEmbeddedProfile.

{ return true; }

SetSize()

template<class T , icTagTypeSignature Tsig>

bool CIccTagNum< T, Tsig >::SetSize	(	icUInt32Number	nSize,
		bool	bZeroNew = true
	)

Name: CIccTagNum::SetSize

Purpose: Sets the size of the data array.

Args: nSize - number of data entries, bZeroNew - flag to zero newly formed values

{
  if (nSize==m_nSize)
    return true;
 
  m_Num = (T*)icRealloc(m_Num, nSize*sizeof(T));
 
  if (!m_Num) {
    m_nSize = 0;
    return false;
  }
 
  if (bZeroNew && m_nSize < nSize) {
    memset(&m_Num[m_nSize], 0, (nSize-m_nSize)*sizeof(T));
  }
  m_nSize = nSize;
 
  return true;
}

References CIccTagNum< T, Tsig >::m_nSize, and CIccTagNum< T, Tsig >::m_Num.

Referenced by CIccTagNum< T, Tsig >::Read().

Here is the caller graph for this function:

Validate()

template<class T , icTagTypeSignature Tsig>

icValidateStatus CIccTagNum< T, Tsig >::Validate ( std::string  sigPath, std::string &  sReport, const CIccProfile *  pProfile = NULL  ) const

virtual

Function: Validate Each derived tag will implement it's own IsValid() function

Parameter(s): sig - signature of tag being validated, sDescription - A string to put tag validation report.

Name: CIccTag::Validate

Purpose: Check tag data validity. In base class we only look at the tag's reserved data value

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.

{
  icValidateStatus rv = icValidateOK;
  //Check # of channels 
  if (icGetFirstSigPathSig(sigPath) == icSigMaterialDefaultValuesTag && 
      pProfile &&
      m_nSize != icGetMaterialColorSpaceSamples(pProfile->m_Header.mcs)) {
    CIccInfo Info;
    std::string sSigPathName = Info.GetSigPathName(sigPath);
 
    sReport += icMsgValidateCriticalError;
    sReport += sSigPathName;
    sReport += " - Number of material default values does not match MCS in header.\n";
    rv = icMaxStatus(rv, icValidateCriticalError);
  }
 
  rv = icMaxStatus(rv, CIccTagNumArray::Validate(sigPath, sReport, pProfile));
 
  return rv;
}

References CIccInfo::GetSigPathName(), icGetFirstSigPathSig(), icGetMaterialColorSpaceSamples(), icMaxStatus(), icMsgValidateCriticalError, icSigMaterialDefaultValuesTag, icValidateCriticalError, icValidateOK, CIccTagNum< T, Tsig >::m_nSize, icHeader::mcs, and CIccTag::Validate().

Here is the call graph for this function:

ValuePos() [1/3]

bool CIccTagNum< icUInt32Number, icSigUInt32ArrayType >::ValuePos ( icFloatNumber &  DstPos, icFloatNumber  val, bool &  bNoZero  ) const

virtual

Implements CIccTagNumArray.

{
  return false;
}

ValuePos() [2/3]

bool CIccTagNum< icUInt64Number, icSigUInt64ArrayType >::ValuePos ( icFloatNumber &  DstPos, icFloatNumber  val, bool &  bNoZero  ) const

virtual

Implements CIccTagNumArray.

{
  return false;
}

ValuePos() [3/3]

template<class T , icTagTypeSignature Tsig>

bool CIccTagNum< T, Tsig >::ValuePos ( icFloatNumber &  DstPos, icFloatNumber  val, bool &  bNoZero  ) const

virtual

Name: CIccTagNum::ValuePos

Purpose: Gets position of a value int the num array tag

Args: DstPos - position of val in array val - value to look for in array. bNoZero - flag indicating whether first entry is zero

Implements CIccTagNumArray.

{
  if(val<0.0)
    return false;
 
  icFloatNumber nv = 0.0;
  icFloatNumber lv = 0.0;
  switch (Tsig) {
    case icSigUInt8ArrayType:
      lv = icU8toF((icUInt8Number)m_Num[0]);
      break;
    case icSigUInt16ArrayType:
      lv = icU16toF((icUInt16Number)m_Num[0]);
      break;
    case icSigUInt32ArrayType:
    case icSigUInt64ArrayType:
    default:
      return false;
  }
  bNoZero = (lv!=0.0);
 
  if (val<lv) {
    DstPos = val/lv - 1.0f;
    return true;
  }
 
  icUInt32Number i;
  for (i=1; i<m_nSize; i++, lv=nv) {
    switch (Tsig) {
      case icSigUInt8ArrayType:
        nv = icU8toF((icUInt8Number)m_Num[i]);
        break;
      case icSigUInt16ArrayType:
        nv = icU16toF((icUInt16Number)m_Num[i]);
        break;
      case icSigUInt32ArrayType:
      case icSigUInt64ArrayType:
      default:
        return false;
    }
    if (val<=nv) {
      DstPos = (val-lv)/(nv-lv) + i - 1.0f;
      return true;
    }
  }
 
  return false;
}

References icSigUInt16ArrayType, icSigUInt32ArrayType, icSigUInt64ArrayType, icSigUInt8ArrayType, icU16toF(), icU8toF(), CIccTagNum< T, Tsig >::m_nSize, and CIccTagNum< T, Tsig >::m_Num.

Here is the call graph for this function:

Write()

template<class T , icTagTypeSignature Tsig>

bool CIccTagNum< T, Tsig >::Write ( CIccIO *  pIO )

virtual

Name: CIccTagNum::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.

{
  icTagTypeSignature sig = GetType();
 
  if (!pIO)
   return false;
 
  if (!pIO->Write32(&sig))
   return false;
 
  if (!pIO->Write32(&m_nReserved))
    return false;
 
  if (sizeof(T)==sizeof(icUInt8Number)) {
    if (pIO->Write8(m_Num, m_nSize) != (icInt32Number)m_nSize)
      return false;
  }
  else if (sizeof(T)==sizeof(icUInt16Number)) {
    if (pIO->Write16(m_Num, m_nSize) != (icInt32Number)m_nSize)
      return false;
  }
  else if (sizeof(T)==sizeof(icUInt32Number)) {
    if (pIO->Write32(m_Num, m_nSize) != (icInt32Number)m_nSize)
      return false;
  }
  else if (sizeof(T)==sizeof(icUInt64Number)) {
    if (pIO->Write64(m_Num, m_nSize) != (icInt32Number)m_nSize)
      return false;
  }
  else
    return false;
 
  return true;
}

References CIccTagNum< T, Tsig >::GetType(), CIccTag::m_nReserved, CIccTagNum< T, Tsig >::m_nSize, CIccTagNum< T, Tsig >::m_Num, CIccIO::Write16(), CIccIO::Write32(), CIccIO::Write64(), and CIccIO::Write8().

Here is the call graph for this function:

Field Documentation

m_nReserved

icUInt32Number CIccTag::m_nReserved

inherited

Referenced by CIccTag::CIccTag(), CIccTagMultiProcessElement::CIccTagMultiProcessElement(), CIccTagMultiProcessElement::CIccTagMultiProcessElement(), CIccTagMultiProcessElement::operator=(), CIccProfileXml::ParseTag(), CIccTagXmlStruct::ParseTag(), CIccMpeXmlTintArray::ParseXml(), CIccTagXmlArray::ParseXml(), CIccTagText::Read(), CIccTagUtf8Text::Read(), CIccTagZipUtf8Text::Read(), CIccTagUtf16Text::Read(), CIccTagTextDescription::Read(), CIccTagSignature::Read(), CIccTagNamedColor2::Read(), CIccTagXYZ::Read(), CIccTagChromaticity::Read(), CIccTagCicp::Read(), CIccTagSparseMatrixArray::Read(), CIccTagFixedNum< T, Tsig >::Read(), CIccTagNum< T, Tsig >::Read(), CIccTagFloatNum< T, Tsig >::Read(), CIccTagMeasurement::Read(), CIccTagMultiLocalizedUnicode::Read(), CIccTagData::Read(), CIccTagDateTime::Read(), CIccTagColorantOrder::Read(), CIccTagColorantTable::Read(), CIccTagViewingConditions::Read(), CIccTagProfileSeqDesc::Read(), CIccTagResponseCurveSet16::Read(), CIccTagSpectralDataInfo::Read(), CIccTagSpectralViewingConditions::Read(), CIccTagEmbeddedHeightImage::Read(), CIccTagEmbeddedNormalImage::Read(), CIccTagStruct::Read(), CIccTagArray::Read(), CIccTagDict::Read(), CIccTagCurve::Read(), CIccTagParametricCurve::Read(), CIccTagLutAtoB::Read(), CIccTagLut8::Read(), CIccTagLut16::Read(), CIccTagGamutBoundaryDesc::Read(), CIccTagMultiProcessElement::Read(), CIccTagProfileSequenceId::Read(), CIccTagEmbeddedProfile::Read(), CIccTag::Validate(), CIccTagText::Write(), CIccTagUtf8Text::Write(), CIccTagZipUtf8Text::Write(), CIccTagUtf16Text::Write(), CIccTagTextDescription::Write(), CIccTagSignature::Write(), CIccTagNamedColor2::Write(), CIccTagXYZ::Write(), CIccTagChromaticity::Write(), CIccTagCicp::Write(), CIccTagSparseMatrixArray::Write(), CIccTagFixedNum< T, Tsig >::Write(), CIccTagNum< T, Tsig >::Write(), CIccTagFloatNum< T, Tsig >::Write(), CIccTagMeasurement::Write(), CIccTagMultiLocalizedUnicode::Write(), CIccTagData::Write(), CIccTagDateTime::Write(), CIccTagColorantOrder::Write(), CIccTagColorantTable::Write(), CIccTagViewingConditions::Write(), CIccTagProfileSeqDesc::Write(), CIccTagResponseCurveSet16::Write(), CIccTagSpectralDataInfo::Write(), CIccTagSpectralViewingConditions::Write(), CIccTagEmbeddedHeightImage::Write(), CIccTagEmbeddedNormalImage::Write(), CIccTagStruct::Write(), CIccTagArray::Write(), CIccTagDict::Write(), CIccTagEmbeddedProfile::Write(), CIccTagCurve::Write(), CIccTagParametricCurve::Write(), CIccTagLutAtoB::Write(), CIccTagLut8::Write(), CIccTagLut16::Write(), CIccTagGamutBoundaryDesc::Write(), CIccTagMultiProcessElement::Write(), and CIccTagProfileSequenceId::Write().

m_nSize

template<class T , icTagTypeSignature Tsig>

icUInt32Number CIccTagNum< T, Tsig >::m_nSize

protected

Referenced by CIccTagNum< T, Tsig >::CIccTagNum(), CIccTagNum< T, Tsig >::CIccTagNum(), CIccTagNum< T, Tsig >::Describe(), CIccTagNum< T, Tsig >::GetSize(), CIccTagNum< T, Tsig >::GetValues(), CIccTagNum< T, Tsig >::Interpolate(), CIccTagNum< T, Tsig >::IsArrayType(), CIccTagNum< T, Tsig >::operator=(), CIccTagNum< T, Tsig >::SetSize(), CIccTagNum< T, Tsig >::Validate(), CIccTagNum< T, Tsig >::ValuePos(), and CIccTagNum< T, Tsig >::Write().

m_Num

template<class T , icTagTypeSignature Tsig>

T* CIccTagNum< T, Tsig >::m_Num

protected

Referenced by CIccTagNum< T, Tsig >::CIccTagNum(), CIccTagNum< T, Tsig >::CIccTagNum(), CIccTagNum< T, Tsig >::~CIccTagNum(), CIccTagNum< T, Tsig >::Describe(), CIccTagNum< T, Tsig >::GetValues(), CIccTagNum< T, Tsig >::Interpolate(), CIccTagNum< T, Tsig >::operator=(), CIccTagNum< T, Tsig >::operator[](), CIccTagNum< T, Tsig >::Read(), CIccTagNum< T, Tsig >::SetSize(), CIccTagNum< T, Tsig >::ValuePos(), and CIccTagNum< T, Tsig >::Write().

---

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

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