CIccTagLut16 Class Reference

Class: CIccTagLut16. More...

#include <IccTagLut.h>

Inheritance diagram for CIccTagLut16:

Collaboration diagram for CIccTagLut16:

Public Member Functions
	CIccTagLut16 ()
	Name: CIccTagLut16::CIccTagLut16.
	CIccTagLut16 (const CIccTagLut16 &ITL)
	Name: CIccTagLut16::CIccTagLut16.
virtual icTagTypeSignature	GetType () const
	Function: GetType()
virtual CIccTag *	NewCopy () const
	Function: NewCopy(sDescription) Each derived tag will implement it's own NewCopy() function.
CIccTagLut16 &	operator= (const CIccTagLut16 &ITL)
	Name: CIccTagLut16::operator=.
bool	Read (icUInt32Number size, CIccIO *pIO)
	Name: CIccTagLut16::Read.
virtual void	SetColorSpaces (icColorSpaceSignature csInput, icColorSpaceSignature csOutput)
	Name: CIccTagLut16::SetColorSpaces.
virtual bool	UseLegacyPCS () const
virtual icValidateStatus	Validate (std::string sigPath, std::string &sReport, const CIccProfile *pProfile=NULL)
	Name: CIccTagLut16::Validate.
bool	Write (CIccIO *pIO)
	Name: CIccTagLut16::Write.
virtual	~CIccTagLut16 ()
	Name: CIccTagLut16::~CIccTagLut16.
Public Member Functions inherited from CIccMBB
	CIccMBB ()
	Name: CIccMBB::CIccMBB.
	CIccMBB (const CIccMBB &IMBB)
	Name: CIccMBB::CIccMBB.
void	Cleanup ()
	Name: CIccMBB::Cleanup.
virtual void	Describe (std::string &sDescription, int nVerboseness)
	Name: CIccMBB::Describe.
CIccCLUT *	GetCLUT () const
icColorSpaceSignature	GetCsInput ()
icColorSpaceSignature	GetCsOutput ()
LPIccCurve *	GetCurvesA () const
LPIccCurve *	GetCurvesB () const
LPIccCurve *	GetCurvesM () const
CIccMatrix *	GetMatrix () const
virtual icUInt8Number	GetPrecision ()
void	Init (icUInt8Number nInputChannels, icUInt8Number nOutputChannels)
	Name: CIccMBB::Init.
icUInt8Number	InputChannels () const
bool	IsInputB ()
virtual bool	IsInputMatrix ()
virtual bool	IsMBBType ()
CIccCLUT *	NewCLUT (icUInt8Number *pGridPoints, icUInt8Number nPrecision=2)
	Name: CIccMBB::NewCLUT.
CIccCLUT *	NewCLUT (icUInt8Number nGridPoints, icUInt8Number nPrecision=2)
	Name: CIccMBB::NewCLUT.
LPIccCurve *	NewCurvesA ()
	Name: CIccMBB::NewCurvesA.
LPIccCurve *	NewCurvesB ()
	Name: CIccMBB::NewCurvesB.
LPIccCurve *	NewCurvesM ()
	Name: CIccMBB::NewCurvesM.
CIccMatrix *	NewMatrix ()
	Name: CIccMBB::NewMatrix.
CIccMBB &	operator= (const CIccMBB &IMBB)
	Name: CIccMBB::operator=.
icUInt8Number	OutputChannels () const
CIccCLUT *	SetCLUT (CIccCLUT *clut)
	Name: CIccMBB::SetCLUT.
bool	SwapMBCurves ()
virtual	~CIccMBB ()
	Name: CIccMBB::~CIccMBB.
Public Member Functions inherited from CIccTag
	CIccTag ()
	Name: CIccTag::CIccTag.
virtual void	DetachIO ()
	Function: ReadAll() - Read All sub data for tag from file.
virtual const icChar *	GetClassName () const
virtual IIccExtensionTag *	GetExtension ()
virtual icArraySignature	GetTagArrayType () const
virtual icStructSignature	GetTagStructType () const
virtual bool	IsArrayType ()
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 icValidateStatus	Validate (std::string sigPath, std::string &sReport, const CIccProfile *pProfile=NULL) const
	Function: Validate Each derived tag will implement it's own IsValid() function.
virtual	~CIccTag ()
	Name: CIccTag::CIccTag.

Protected Attributes
icUInt8Number	m_nReservedByte
icS15Fixed16Number	m_XYZMatrix [9]
Protected Attributes inherited from CIccMBB
bool	m_bInputMatrix
bool	m_bUseMCurvesAsBCurves
CIccCLUT *	m_CLUT
icColorSpaceSignature	m_csInput
icColorSpaceSignature	m_csOutput
LPIccCurve *	m_CurvesA
LPIccCurve *	m_CurvesB
LPIccCurve *	m_CurvesM
CIccMatrix *	m_Matrix
icUInt8Number	m_nInput
icUInt8Number	m_nOutput

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: CIccTagLut16.

Purpose: The Lut16 tag type

Definition at line 577 of file IccTagLut.h.

Constructor & Destructor Documentation

CIccTagLut16() [1/2]

CIccTagLut16::CIccTagLut16

(

)

Name: CIccTagLut16::CIccTagLut16.

Purpose: Constructor

Definition at line 4897 of file IccTagLut.cpp.

{
  memset(m_XYZMatrix, 0, sizeof(m_XYZMatrix));
  m_XYZMatrix[0] = m_XYZMatrix[4] = m_XYZMatrix[8] = icDtoF(1.0);
  m_nReservedByte = 0;
}

References icDtoF(), m_nReservedByte, and m_XYZMatrix.

Here is the call graph for this function:

CIccTagLut16() [2/2]

CIccTagLut16::CIccTagLut16

(

const CIccTagLut16 &

ITL

)

Name: CIccTagLut16::CIccTagLut16.

Purpose: Copy Constructor

Args: ITL = The CIccTagUnknown object to be copied

Definition at line 4915 of file IccTagLut.cpp.

                                                  : CIccMBB(ITL)
{
  memcpy(&m_XYZMatrix, &ITL.m_XYZMatrix, sizeof(m_XYZMatrix));
  m_nReservedByte = 0;
}

References m_nReservedByte, and m_XYZMatrix.

~CIccTagLut16()

CIccTagLut16::~CIccTagLut16 ( )

virtual

Name: CIccTagLut16::~CIccTagLut16.

Purpose: Destructor

Definition at line 4952 of file IccTagLut.cpp.

{
}

Member Function Documentation

GetType()

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

{ return icSigLut16Type; }

References icSigLut16Type.

Referenced by Read(), Validate(), and Write().

Here is the caller graph for this function:

NewCopy()

virtual CIccTag * CIccTagLut16::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 CIccMBB.

Definition at line 583 of file IccTagLut.h.

{return new CIccTagLut16(*this);}

operator=()

CIccTagLut16 & CIccTagLut16::operator=

(

const CIccTagLut16 &

ITL

)

Name: CIccTagLut16::operator=.

Purpose: Copy Operator

Args: ITL = The CIccTagLut16 object to be copied

Definition at line 4932 of file IccTagLut.cpp.

{
  if (&ITL==this)
    return *this;
 
  CIccMBB::operator=(ITL);
  memcpy(&m_XYZMatrix, &ITL.m_XYZMatrix, sizeof(m_XYZMatrix));
 
  return *this;
}

References m_XYZMatrix, and CIccMBB::operator=().

Here is the call graph for this function:

Read()

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

virtual

Name: CIccTagLut16::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 4971 of file IccTagLut.cpp.

{
  icTagTypeSignature sig;
  icUInt32Number nStart, nEnd;
  icUInt8Number i, nGrid;
  icUInt16Number nInputEntries, nOutputEntries;
  LPIccCurve *pCurves;
  CIccTagCurve *pCurve;
 
  if (size<13*sizeof(icUInt32Number) || !pIO) {
    return false;
  }
 
  nStart = pIO->Tell();
  nEnd = nStart + size;
 
  if (!pIO->Read32(&sig) ||
      !pIO->Read32(&m_nReserved) ||
      !pIO->Read8(&m_nInput) ||
      !pIO->Read8(&m_nOutput) ||
      !pIO->Read8(&nGrid) ||
      !pIO->Read8(&m_nReservedByte) ||
      pIO->Read32(m_XYZMatrix, 9) != 9 ||
      !pIO->Read16(&nInputEntries) ||
      !pIO->Read16(&nOutputEntries))
    return false;
 
  if (sig!=GetType())
    return false;
 
 
  //B Curves
  pCurves = NewCurvesB();
 
  for (i=0; i<m_nInput; i++) {
    if (nInputEntries*sizeof(icUInt16Number) > nEnd - pIO->Tell())
      return false;
 
    pCurves[i] = pCurve = (CIccTagCurve*)CIccTag::Create(icSigCurveType);
 
    if (!pCurve->SetSize(nInputEntries))
      return false;
 
    if (pIO->ReadUInt16Float(&(*pCurve)[0], nInputEntries) != nInputEntries)
      return false;
  }
 
  //CLUT
  m_CLUT = new CIccCLUT(m_nInput, m_nOutput);
 
  if (!m_CLUT->Init(nGrid, nEnd - pIO->Tell(), 2))
    return false;
 
  if (!m_CLUT->ReadData(nEnd - pIO->Tell(), pIO, 2))
    return false;
 
  //A Curves
  pCurves = NewCurvesA();
 
  for (i=0; i<m_nOutput; i++) {
    if (nOutputEntries*sizeof(icUInt16Number) > nEnd - pIO->Tell())
      return false;
 
    pCurves[i] = pCurve = (CIccTagCurve*)CIccTag::Create(icSigCurveType);
 
    if (!pCurve->SetSize(nOutputEntries))
      return false;
 
    if (pIO->ReadUInt16Float(&(*pCurve)[0], nOutputEntries) != nOutputEntries)
      return false;
  }
  return true;
}

References CIccTag::Create(), GetType(), icSigCurveType, CIccCLUT::Init(), CIccMBB::m_CLUT, CIccMBB::m_nInput, CIccMBB::m_nOutput, CIccTag::m_nReserved, m_nReservedByte, m_XYZMatrix, CIccMBB::NewCurvesA(), CIccMBB::NewCurvesB(), CIccIO::Read16(), CIccIO::Read32(), CIccIO::Read8(), CIccCLUT::ReadData(), CIccIO::ReadUInt16Float(), CIccTagCurve::SetSize(), sig, and CIccIO::Tell().

Here is the call graph for this function:

SetColorSpaces()

void CIccTagLut16::SetColorSpaces ( icColorSpaceSignature csInput, icColorSpaceSignature csOutput )

virtual

Name: CIccTagLut16::SetColorSpaces.

Purpose: Sets the input and output color spaces

Args: csInput = input color space signature, csOutput = output color space signature

Reimplemented from CIccMBB.

Definition at line 5058 of file IccTagLut.cpp.

{
  if (csInput==icSigXYZData) {
    int i;
 
    if (!m_CurvesM && IsInputMatrix()) { //Transfer ownership of curves
      m_CurvesM = m_CurvesB;
      m_CurvesB = NULL;
 
      LPIccCurve *pCurves = NewCurvesB();
      CIccTagCurve *pCurve;
      for (i=0; i<m_nInput; i++) {
        pCurves[i] = pCurve = (CIccTagCurve*)CIccTag::Create(icSigCurveType);
        pCurve->SetSize(0);
      }
 
      m_bUseMCurvesAsBCurves = true;
    }
 
    if (!m_Matrix) {
      CIccMatrix *pMatrix = NewMatrix();
      for (i=0; i<9; i++) {
        pMatrix->m_e[i] = icFtoD(m_XYZMatrix[i]);
      }
 
      pMatrix->m_bUseConstants=false;
    }
  }
  else {
    m_XYZMatrix[0] = m_XYZMatrix[4] = m_XYZMatrix[8] = icDtoF(1.0);
    m_XYZMatrix[1] = m_XYZMatrix[2] = m_XYZMatrix[3] =
    m_XYZMatrix[5] = m_XYZMatrix[6] = m_XYZMatrix[7] = 0;
  }
 
  CIccMBB::SetColorSpaces(csInput, csOutput);
}

References CIccTag::Create(), icDtoF(), icFtoD(), icSigCurveType, icSigXYZData, CIccMBB::IsInputMatrix(), CIccMatrix::m_bUseConstants, CIccMBB::m_bUseMCurvesAsBCurves, CIccMBB::m_CurvesB, CIccMBB::m_CurvesM, CIccMatrix::m_e, CIccMBB::m_Matrix, CIccMBB::m_nInput, m_XYZMatrix, CIccMBB::NewCurvesB(), CIccMBB::NewMatrix(), CIccMBB::SetColorSpaces(), and CIccTagCurve::SetSize().

Here is the call graph for this function:

UseLegacyPCS()

virtual bool CIccTagLut16::UseLegacyPCS ( ) const

inlinevirtual

Reimplemented from CIccMBB.

Definition at line 587 of file IccTagLut.h.

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

Validate()

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

virtual

Name: CIccTagLut16::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 CIccMBB.

Definition at line 5201 of file IccTagLut.cpp.

{
  icValidateStatus rv = CIccMBB::Validate(sigPath, sReport, pProfile);
 
  CIccInfo Info;
  std::string sSigPathName = Info.GetSigPathName(sigPath);
  icSignature sig = icGetFirstSigPathSig(sigPath);
 
  if (!pProfile) {
    rv = icMaxStatus(rv, icValidateWarning);
    return rv;
  }
 
  switch(sig) {
  case icSigAToB0Tag:
  case icSigAToB1Tag:
  case icSigAToB2Tag:
  case icSigBToA0Tag:
  case icSigBToA1Tag:
  case icSigBToA2Tag:
  case icSigGamutTag:
    {
      icUInt32Number nInput, nOutput;
      if (sig==icSigAToB0Tag || sig==icSigAToB1Tag || sig==icSigAToB2Tag || sig==icSigGamutTag) {
        nInput = icGetSpaceSamples(pProfile->m_Header.pcs);
        nOutput = icGetSpaceSamples(pProfile->m_Header.colorSpace);
      }
      else {
        nInput = icGetSpaceSamples(pProfile->m_Header.colorSpace);
        nOutput = icGetSpaceSamples(pProfile->m_Header.pcs);
      }
 
      if (sig==icSigGamutTag) {
        nOutput = 1;
      }
 
      icUInt8Number i;
      if (m_CurvesB) {
        for (i=0; i<nInput; i++) {
          if (m_CurvesB[i]) {
            rv = icMaxStatus(rv, m_CurvesB[i]->Validate(sigPath+icGetSigPath(GetType()), sReport, pProfile));
            if (m_CurvesB[i]->GetType()==icSigCurveType) {
              CIccTagCurve *pTagCurve = (CIccTagCurve*)m_CurvesB[i];
              if (pTagCurve->GetSize()==1) {
                sReport += icMsgValidateCriticalError;
                sReport += sSigPathName;
                sReport += " - lut16Tags do not support single entry gamma curves.\n";
                rv = icMaxStatus(rv, icValidateCriticalError);
              }
            }
          }
          else {
            sReport += icMsgValidateCriticalError;
            sReport += sSigPathName;
            sReport += " - Incorrect number of B-curves.\n";
            rv = icMaxStatus(rv, icValidateCriticalError);
          }
        }
      }
 
      if (m_Matrix) {
        rv = icMaxStatus(rv, m_Matrix->Validate(sigPath + icGetSigPath(GetType()), sReport, pProfile));
      }
      else {
        int sum=0;
        for (int i=0; i<9; i++) {
          sum += m_XYZMatrix[i];
        }
        if (m_XYZMatrix[0]!=1.0 || m_XYZMatrix[4]!=1.0 || m_XYZMatrix[8]!=1.0 || sum!=3.0) {
          sReport += icMsgValidateWarning;
          sReport += sSigPathName;
          sReport += " - Matrix must be identity.\n";
          rv = icMaxStatus(rv, icValidateWarning);
        }
      }
 
      if (m_CurvesA) {
 
        for (i=0; i<nOutput; i++) {
          if (m_CurvesA[i]) {
            rv = icMaxStatus(rv, m_CurvesA[i]->Validate(sigPath+icGetSigPath(GetType()), sReport, pProfile));
            if (m_CurvesA[i]->GetType()==icSigCurveType) {
              CIccTagCurve *pTagCurve = (CIccTagCurve*)m_CurvesA[i];
              if (pTagCurve->GetSize()==1) {
                sReport += icMsgValidateCriticalError;
                sReport += sSigPathName;
                sReport += " - lut16Tags do not support single entry gamma curves.\n";
                rv = icMaxStatus(rv, icValidateCriticalError);
              }
            }
          }
          else {
            sReport += icMsgValidateCriticalError;
            sReport += sSigPathName;
            sReport += " - Incorrect number of A-curves.\n";
            rv = icMaxStatus(rv, icValidateCriticalError);
          }
        }
 
      }
 
      break;
    }
  default:
    {
    }
  }
 
 
  return rv;
}

References CIccInfo::GetSigPathName(), CIccTagCurve::GetSize(), GetType(), icGetFirstSigPathSig(), icGetSigPath(), icGetSpaceSamples(), icMaxStatus(), icMsgValidateCriticalError, icMsgValidateWarning, icSigAToB0Tag, icSigAToB1Tag, icSigAToB2Tag, icSigBToA0Tag, icSigBToA1Tag, icSigBToA2Tag, icSigCurveType, icSigGamutTag, icValidateCriticalError, icValidateWarning, CIccMBB::m_CurvesA, CIccMBB::m_CurvesB, CIccMBB::m_Matrix, m_XYZMatrix, sig, CIccMatrix::Validate(), CIccMBB::Validate(), and Validate().

Referenced by Validate().

Here is the call graph for this function:

Here is the caller graph for this function:

Write()

bool CIccTagLut16::Write ( CIccIO * pIO )

virtual

Name: CIccTagLut16::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 5109 of file IccTagLut.cpp.

{
  icTagTypeSignature sig = GetType();
  icUInt8Number i, nGrid;
  icS15Fixed16Number XYZMatrix[9];
  icUInt16Number nInputEntries, nOutputEntries;
  LPIccCurve *pCurves;
  CIccTagCurve *pCurve;
 
  if (m_Matrix) {
    for (i=0; i<9; i++) {
      XYZMatrix[i] = icDtoF(m_Matrix->m_e[i]);
    }
  }
  else {
    memset(XYZMatrix, 0, 9*sizeof(icS15Fixed16Number));
    XYZMatrix[0] = XYZMatrix[4] = XYZMatrix[8] = icDtoF(1.0);
  }
 
  if (m_bUseMCurvesAsBCurves) {
    pCurves = m_CurvesM;
  }
  else {
    pCurves = m_CurvesB;
  }
 
  if (!pCurves || !m_CurvesA || !m_CLUT)
    return false;
 
  nGrid = m_CLUT->GridPoints();
 
  nInputEntries = (icUInt16Number)(((CIccTagCurve*)pCurves[0])->GetSize());
  nOutputEntries = (icUInt16Number)(((CIccTagCurve*)m_CurvesA[0])->GetSize());
 
  if (!pIO->Write32(&sig) ||
      !pIO->Write32(&m_nReserved) ||
      !pIO->Write8(&m_nInput) ||
      !pIO->Write8(&m_nOutput) ||
      !pIO->Write8(&nGrid) ||
      !pIO->Write8(&m_nReservedByte) ||
      pIO->Write32(XYZMatrix, 9) != 9 ||
      !pIO->Write16(&nInputEntries) ||
      !pIO->Write16(&nOutputEntries))
    return false;
 
  //B Curves
  for (i=0; i<m_nInput; i++) {
    if (pCurves[i]->GetType()!=icSigCurveType)
      return false;
 
    pCurve = (CIccTagCurve*)pCurves[i];
    if (!pCurve)
      return false;
 
    if (pIO->WriteUInt16Float(&(*pCurve)[0], nInputEntries) != nInputEntries)
      return false;
  }
 
  //CLUT
  if (!m_CLUT->WriteData(pIO, 2))
    return false;
 
  //A Curves
  pCurves = m_CurvesA;
 
  for (i=0; i<m_nOutput; i++) {
    if (pCurves[i]->GetType()!=icSigCurveType)
      return false;
 
    pCurve = (CIccTagCurve*)pCurves[i];
 
    if (pIO->WriteUInt16Float(&(*pCurve)[0], nOutputEntries) != nOutputEntries)
      return false;
  }
  return true;
}

References GetType(), CIccCLUT::GridPoints(), icDtoF(), icSigCurveType, CIccMBB::m_bUseMCurvesAsBCurves, CIccMBB::m_CLUT, CIccMBB::m_CurvesA, CIccMBB::m_CurvesB, CIccMBB::m_CurvesM, CIccMatrix::m_e, CIccMBB::m_Matrix, CIccMBB::m_nInput, CIccMBB::m_nOutput, CIccTag::m_nReserved, m_nReservedByte, sig, CIccIO::Write16(), CIccIO::Write32(), CIccIO::Write8(), CIccCLUT::WriteData(), and CIccIO::WriteUInt16Float().

Here is the call graph for this function:

Member Data Documentation

m_nReservedByte

icUInt8Number CIccTagLut16::m_nReservedByte

protected

Definition at line 596 of file IccTagLut.h.

Referenced by CIccTagLut16(), CIccTagLut16(), Read(), and Write().

m_XYZMatrix

icS15Fixed16Number CIccTagLut16::m_XYZMatrix[9]

protected

Definition at line 597 of file IccTagLut.h.

Referenced by CIccTagLut16(), CIccTagLut16(), operator=(), Read(), SetColorSpaces(), and Validate().

---

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

• IccProfLib/IccTagLut.h
• IccProfLib/IccTagLut.cpp