#include <IccTagLut.h>

Inheritance diagram for CIccTagCurve:

Collaboration diagram for CIccTagCurve:

Public Member Functions
virtual icFloatNumber	Apply (icFloatNumber v) const
	Name: CIccTagCurve::Apply.

virtual void	Begin ()

	CIccTagCurve (const CIccTagCurve &ITCurve)
	Name: CIccTagCurve::CIccTagCurve.

	CIccTagCurve (int nSize=0)
	Name: CIccTagCurve::CIccTagCurve.

virtual void	Describe (std::string &sDescription, int nVerboseness)
	Name: CIccTagCurve::Describe.

virtual void	DumpLut (std::string &sDescription, const icChar *szName, icColorSpaceSignature csSig, int nIndex, int nVerboseness)
	Name: CIccTagCurve::DumpLut.

virtual const icChar *	GetClassName () const

icFloatNumber *	GetData (icUInt32Number index)

icUInt32Number	GetSize () const

virtual icTagTypeSignature	GetType () const
	Function: GetType()

virtual bool	IsIdentity ()
	Name: CIccTagCurve::IsIdentity.

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

CIccTagCurve &	operator= (const CIccTagCurve &CurveTag)
	Name: CIccTagCurve::operator=.

icFloatNumber &	operator[] (icUInt32Number index)

virtual bool	Read (icUInt32Number size, CIccIO *pIO)
	Name: CIccTagCurve::Read.

bool	SetGamma (icFloatNumber gamma)
	Name: refIccMAX::CIccTagCurve::SetGamma.

bool	SetSize (icUInt32Number nSize, icTagCurveSizeInit nSizeOpt=icInitZero)
	Name: CIccTagCurve::SetSize.

virtual icValidateStatus	Validate (std::string sigPath, std::string &sReport, const CIccProfile *pProfile=NULL) const
	Name: CIccTagCurve::Validate.

virtual bool	Write (CIccIO *pIO)
	Name: CIccTagCurve::Write.

virtual	~CIccTagCurve ()
	Name: CIccTagCurve::~CIccTagCurve.

Public Member Functions inherited from CIccCurve
	CIccCurve ()

icFloatNumber	Find (icFloatNumber v)

virtual	~CIccCurve ()

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
icFloatNumber *	m_Curve

icUInt16Number	m_nMaxIndex

icUInt32Number	m_nSize

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

Protected Member Functions inherited from CIccCurve
icFloatNumber	Find (icFloatNumber v, icFloatNumber p0, icFloatNumber v0, icFloatNumber p1, icFloatNumber v1)
	Name: CIccCurve::Find.

Detailed Description

Class: CIccTagCurve.

Purpose: The curveType tag

Definition at line 127 of file IccTagLut.h.

Constructor & Destructor Documentation

◆ CIccTagCurve() [1/2]

CIccTagCurve::CIccTagCurve ( int nSize = 0 )

Name: CIccTagCurve::CIccTagCurve.

Purpose: Constructor

Definition at line 143 of file IccTagLut.cpp.

{
    m_nSize = nSize <0 ? 0 : nSize;
  if (m_nSize>0)
    m_Curve = (icFloatNumber*)calloc(nSize, sizeof(icFloatNumber));
  else
    m_Curve = NULL;
}

◆ CIccTagCurve() [2/2]

CIccTagCurve::CIccTagCurve ( const CIccTagCurve & ITCurve )

Name: CIccTagCurve::CIccTagCurve.

Purpose: Copy Constructor

Args: ITCurve = The CIccTagCurve object to be copied

Definition at line 163 of file IccTagLut.cpp.

{
  m_nSize = ITCurve.m_nSize;
  m_nMaxIndex = ITCurve.m_nMaxIndex;
 
  m_Curve = (icFloatNumber*)calloc(m_nSize, sizeof(icFloatNumber));
  memcpy(m_Curve, ITCurve.m_Curve, m_nSize*sizeof(icFloatNumber));
}

References m_Curve, m_nMaxIndex, and m_nSize.

◆ ~CIccTagCurve()

CIccTagCurve::~CIccTagCurve ( )

virtual

Name: CIccTagCurve::~CIccTagCurve.

Purpose: Destructor

Definition at line 208 of file IccTagLut.cpp.

{
  if (m_Curve)
    free(m_Curve);
}

Member Function Documentation

◆ Apply()

icFloatNumber CIccTagCurve::Apply ( icFloatNumber v ) const

virtual

Name: CIccTagCurve::Apply.

Purpose: Applies the curve to the value passed.

Args: v = value to be passed through the curve.

Return: The value modified by the curve.

Reimplemented from CIccCurve.

Definition at line 568 of file IccTagLut.cpp.

{
  if(v<0.0) v = 0.0;
  else if(v>1.0) v = 1.0;
 
  icUInt32Number nIndex = (icUInt32Number)(v * m_nMaxIndex);
 
  if (!m_nSize) {
    return v;
  }
  if (m_nSize==1) {
    //Convert 0.0 to 1.0 float to 16bit and then convert from u8Fixed8Number
    icFloatNumber dGamma = (icFloatNumber)(m_Curve[0] * 65535.0 / 256.0);
    return (icFloatNumber)pow(v, dGamma);
  }
  if (nIndex == m_nMaxIndex) {
    return m_Curve[nIndex];
  }
  else {
    icFloatNumber nDif = v*m_nMaxIndex - nIndex;
    icFloatNumber p0 = m_Curve[nIndex];
 
    icFloatNumber rv = p0 + (m_Curve[nIndex+1]-p0)*nDif;
    if (rv>1.0)
      rv=1.0;
 
    return rv;
  }
}

Referenced by CIccTagLut8::Write().

Here is the caller graph for this function:

◆ Begin()

virtual void CIccTagCurve::Begin ( )

inlinevirtual

Reimplemented from CIccCurve.

Definition at line 152 of file IccTagLut.h.

152{m_nMaxIndex = (icUInt16Number)m_nSize - 1;}

icUInt16Number

unsigned short icUInt16Number

Definition icProfileHeader.h:256

◆ Describe()

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

virtual

Name: CIccTagCurve::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 318 of file IccTagLut.cpp.

{
  icChar buf[128], *ptr;
 
  if (!m_nSize) {
    sprintf(buf, "BEGIN_CURVE In_Out\n");
    sDescription += buf;
    sDescription += "Y = X\n";
  }
  else if (m_nSize==1) {
    icFloatNumber dGamma = (icFloatNumber)(m_Curve[0] * 256.0);
    sprintf(buf, "BEGIN_CURVE In_Out\n");
    sDescription += buf;
    sprintf(buf, "Y = X ^ %.4lf\n", dGamma);
    sDescription += buf;
  }
  else {
    int i;
 
    sprintf(buf, "BEGIN_LUT In_Out 1 1\n");
    sDescription += buf;
 
    if (nVerboseness > 75) {
      sDescription += "IN OUT\n";
 
      for (i=0; i<(int)m_nSize; i++) {
        ptr = buf;
 
        icColorValue(buf, (icFloatNumber)i/(m_nSize-1), icSigMCH1Data, 1);
        ptr += strlen(buf);
 
        strcpy(ptr, " ");
        ptr ++;
 
        icColorValue(ptr, m_Curve[i], icSigMCH1Data, 1);
 
        ptr += strlen(ptr);
 
        strcpy(ptr, "\n");
       sDescription += buf;
      }
    }
  }
}

References icColorValue(), and icSigMCH1Data.

Here is the call graph for this function:

◆ DumpLut()

void CIccTagCurve::DumpLut	(	std::string &	sDescription,
		const icChar *	szName,
		icColorSpaceSignature	csSig,
		int	nIndex,
		int	nVerboseness )

virtual

Name: CIccTagCurve::DumpLut.

Purpose: Dump data associated with the tag to a string. Basically has the same function as Describe()

Args: sDescription = string to concatenate tag dump to, szName = name of the curve to be printed, csSig = color space signature of the LUT data, nIndex = the channel number of color space

Reimplemented from CIccCurve.

Definition at line 378 of file IccTagLut.cpp.

{
  icChar buf[128], *ptr;
 
  if (!m_nSize) {
    sprintf(buf, "BEGIN_CURVE %s\n", szName);
    sDescription += buf;
    sDescription += "Y = X\n";
  }
  else if (m_nSize==1) {
    icFloatNumber dGamma = (icFloatNumber)(m_Curve[0] * 256.0);
    sprintf(buf, "BEGIN_CURVE %s\n", szName);
    sDescription += buf;
    sprintf(buf, "Y = X ^ %.4lf\n", dGamma);
    sDescription += buf;
  }
  else {
    int i;
 
    sprintf(buf, "BEGIN_LUT %s 1 1\n", szName);
 
    if (nVerboseness > 75) {
      sDescription += buf;
      sDescription += "IN OUT\n";
 
      sDescription.reserve(sDescription.size() + m_nSize * 20);
 
      for (i=0; i<(int)m_nSize; i++) {
        ptr = buf;
 
        icColorValue(buf, (icFloatNumber)i/(m_nSize-1), csSig, nIndex);
        ptr += strlen(buf);
 
        strcpy(ptr, " ");
        ptr ++;
 
        icColorValue(ptr, m_Curve[i], csSig, nIndex);
 
        ptr += strlen(ptr);
 
        strcpy(ptr, "\n");
 
        sDescription += buf;
      }
    }
  }
}

References icColorValue(), and szName.

Here is the call graph for this function:

◆ GetClassName()

virtual const icChar * CIccTagCurve::GetClassName ( ) const

inlinevirtual

Reimplemented from CIccTag.

Reimplemented in CIccTagXmlCurve.

Definition at line 137 of file IccTagLut.h.

137{ return "CIccTagCurve"; }

◆ GetData()

icFloatNumber * CIccTagCurve::GetData ( icUInt32Number index )

inline

Definition at line 147 of file IccTagLut.h.

147{return &m_Curve[index];}

◆ GetSize()

icUInt32Number CIccTagCurve::GetSize ( ) const

inline

Definition at line 148 of file IccTagLut.h.

148{ return m_nSize; }

Referenced by CIccTagLut16::Validate(), CIccTagLut8::Validate(), and CIccTagLut8::Write().

Here is the caller graph for this function:

◆ GetType()

virtual icTagTypeSignature CIccTagCurve::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 136 of file IccTagLut.h.

136{ return icSigCurveType; }

icSigCurveType

@ icSigCurveType

Definition icProfileHeader.h:533

References icSigCurveType.

◆ IsIdentity()

bool CIccTagCurve::IsIdentity ( )

virtual

Name: CIccTagCurve::IsIdentity.

Purpose: Checks if this is an identity curve.

Return: true if the curve is an identity

Reimplemented from CIccCurve.

Definition at line 535 of file IccTagLut.cpp.

{
  if (!m_nSize) {
    return true;
  }
 
  if (m_nSize==1) {
    return  IsUnity(icFloatNumber(m_Curve[0]*65535.0/256.0));
  }
 
  icUInt32Number i;
  for (i=0; i<m_nSize; i++) {
    if (fabs(m_Curve[i]-((icFloatNumber)i/(icFloatNumber)m_nMaxIndex))>VERYSMALLNUM) {
      return false;
    }
  }
 
  return true;
}

References IsUnity(), and VERYSMALLNUM.

Here is the call graph for this function:

◆ NewCopy()

virtual CIccTag * CIccTagCurve::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 CIccCurve.

Definition at line 133 of file IccTagLut.h.

133{ return new CIccTagCurve(*this);}

CIccTagCurve::CIccTagCurve

CIccTagCurve(int nSize=0)

Name: CIccTagCurve::CIccTagCurve.

Definition IccTagLut.cpp:143

◆ operator=()

CIccTagCurve & CIccTagCurve::operator= ( const CIccTagCurve & CurveTag )

Name: CIccTagCurve::operator=.

Purpose: Copy Operator

Args: CurveTag = The CIccTagCurve object to be copied

Definition at line 183 of file IccTagLut.cpp.

{
  if (&CurveTag == this)
    return *this;
 
  m_nSize = CurveTag.m_nSize;
  m_nMaxIndex = CurveTag.m_nMaxIndex;
 
  if (m_Curve)
    free(m_Curve);
  m_Curve = (icFloatNumber*)calloc(m_nSize, sizeof(icFloatNumber));
  memcpy(m_Curve, CurveTag.m_Curve, m_nSize*sizeof(icFloatNumber));
 
  return *this;
}

References m_Curve, m_nMaxIndex, and m_nSize.

◆ operator[]()

icFloatNumber & CIccTagCurve::operator[] ( icUInt32Number index )

inline

Definition at line 146 of file IccTagLut.h.

146{return m_Curve[index];}

◆ Read()

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

virtual

Name: CIccTagCurve::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 229 of file IccTagLut.cpp.

{
  icTagTypeSignature sig;
 
  icUInt32Number headerSize = sizeof(icTagTypeSignature) +
                              sizeof(icUInt32Number) +
                              sizeof(icUInt32Number);
  if (headerSize > size)
    return false;
 
  if (!pIO) {
    return false;
  }
 
  if (!pIO->Read32(&sig))
    return false;
 
  if (!pIO->Read32(&m_nReserved))
    return false;
 
  icUInt32Number nSize;
 
  if (!pIO->Read32(&nSize))
    return false;
 
  if (headerSize + (icUInt64Number)nSize * sizeof(icUInt16Number) > size)
    return false;
 
  if (!SetSize(nSize, icInitNone))
    return false;
 
  if (m_nSize) {
    if (pIO->ReadUInt16Float(m_Curve, m_nSize)!=(icInt32Number)m_nSize)
      return false;
  }
 
  return true;
}

References icInitNone, CIccIO::Read32(), CIccIO::ReadUInt16Float(), and sig.

Here is the call graph for this function:

◆ SetGamma()

bool CIccTagCurve::SetGamma ( icFloatNumber gamma )

Name: refIccMAX::CIccTagCurve::SetGamma.

Purpose: Set the curve with a single gamma value.

Args: gamma - gamma value to use

Definition at line 502 of file IccTagLut.cpp.

{
  if (!SetSize(1, icInitNone))
    return false;
 
  icInt16Number whole = (icInt16Number)gamma;
  icFloatNumber frac = gamma - (icFloatNumber)whole;
 
  m_Curve[0] = (icFloatNumber)((whole * 256) + (frac*256.0)) / (icFloatNumber)65535.0; 
  return true;
}

References icInitNone.

◆ SetSize()

bool CIccTagCurve::SetSize	(	icUInt32Number	nSize,
		icTagCurveSizeInit	nSizeOpt = icInitZero )

Name: CIccTagCurve::SetSize.

Purpose: Sets the size of the curve array.

Args: nSize - number of entries in the curve, nSizeOpt - flag to zero newly formed values

Definition at line 439 of file IccTagLut.cpp.

{
  if (nSize==m_nSize)
    return true;
 
  if (!nSize && m_Curve) {
    free(m_Curve);
    m_Curve = NULL;
  }
  else {
    if (!m_Curve)
      m_Curve = (icFloatNumber*)malloc(nSize*sizeof(icFloatNumber));
    else
      m_Curve = (icFloatNumber*)icRealloc(m_Curve, nSize*sizeof(icFloatNumber));
 
    if (!m_Curve) {
      m_nSize = 0;
      return false;
    }
 
    switch (nSizeOpt) {
    case icInitNone:
    default:
      break;
 
    case icInitZero:
      if (m_nSize < nSize) {
        memset(&m_Curve[m_nSize], 0, (nSize-m_nSize)*sizeof(icFloatNumber));
      }
      break;
 
    case icInitIdentity:
      if (nSize>1) {
        icUInt32Number i;
        icFloatNumber last = (icFloatNumber)(nSize-1);
 
        for (i=0; i<nSize; i++) {
          m_Curve[i] = (icFloatNumber)i/last;
        }
      }
      else if (nSize==1) {
        //Encode a gamma 1.0 u8Fixed8Number converted to 16 bit as a 0.0 to 1.0 float
        m_Curve[0] = (icFloatNumber)(0x0100) / (icFloatNumber)65535.0;
      }
      break;
    }
  }
  m_nSize = nSize;
  m_nMaxIndex = (icUInt16Number)(nSize - 1);
 
  return true;
}

References icInitIdentity, icInitNone, icInitZero, and icRealloc().

Referenced by CIccTagLut16::Read(), CIccTagLut8::Read(), CIccTagLut16::SetColorSpaces(), and CIccTagLut8::SetColorSpaces().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Validate()

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

virtual

Name: CIccTagCurve::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 613 of file IccTagLut.cpp.

{
  icValidateStatus rv = CIccTag::Validate(sigPath, sReport, pProfile);
 
  CIccInfo Info;
  std::string sSigPathName = Info.GetSigPathName(sigPath);
  icSignature sig = icGetFirstSigPathSig(sigPath);
 
  if (sig==icSigBlueTRCTag || sig==icSigRedTRCTag || sig==icSigGreenTRCTag || sig==icSigGrayTRCTag) {
    if (m_nSize>1) {
      if (m_Curve) {
        if (m_Curve[0]>0.0 || m_Curve[m_nSize-1]<1.0) {
          sReport += icMsgValidateWarning;
          sReport += sSigPathName;
          sReport += " - Curve cannot be accurately inverted.\n";
          rv = icMaxStatus(rv, icValidateWarning);
        }
      }
    }
  }
 
  return rv;
}

References CIccInfo::GetSigPathName(), icGetFirstSigPathSig(), icMaxStatus(), icMsgValidateWarning, icSigBlueTRCTag, icSigGrayTRCTag, icSigGreenTRCTag, icSigRedTRCTag, icValidateWarning, sig, and CIccTag::Validate().

Here is the call graph for this function:

◆ Write()

bool CIccTagCurve::Write ( CIccIO * pIO )

virtual

Name: CIccTagCurve::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 282 of file IccTagLut.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_nSize))
    return false;
 
  if (m_nSize)
    if (pIO->WriteUInt16Float(m_Curve, m_nSize)!=(icInt32Number)m_nSize)
      return false;
 
  pIO->Align32();
 
  return true;
}

References CIccIO::Align32(), sig, CIccIO::Write32(), and CIccIO::WriteUInt16Float().

Here is the call graph for this function:

Member Data Documentation

◆ m_Curve

icFloatNumber* CIccTagCurve::m_Curve

protected

Definition at line 158 of file IccTagLut.h.

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

◆ m_nMaxIndex

icUInt16Number CIccTagCurve::m_nMaxIndex

protected

Definition at line 160 of file IccTagLut.h.

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

◆ m_nSize

icUInt32Number CIccTagCurve::m_nSize

protected

Definition at line 159 of file IccTagLut.h.

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

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

IccProfLib/IccTagLut.h
IccProfLib/IccTagLut.cpp

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CIccTagCurve() [1/2]

◆ CIccTagCurve() [2/2]

◆ ~CIccTagCurve()

Member Function Documentation

◆ Apply()

◆ Begin()

◆ Describe()

◆ DumpLut()

◆ GetClassName()

◆ GetData()

◆ GetSize()

◆ GetType()

◆ IsIdentity()

◆ NewCopy()

◆ operator=()

◆ operator[]()

◆ Read()

◆ SetGamma()

◆ SetSize()

◆ Validate()

◆ Write()

Member Data Documentation

◆ m_Curve

◆ m_nMaxIndex

◆ m_nSize