CIccTagSpectralViewingConditions Class Reference

#include <IccTagBasic.h>

Inheritance diagram for CIccTagSpectralViewingConditions:

Collaboration diagram for CIccTagSpectralViewingConditions:

Public Member Functions
	CIccTagSpectralViewingConditions ()
	CIccTagSpectralViewingConditions (const CIccTagSpectralViewingConditions &ITRCS)
virtual	~CIccTagSpectralViewingConditions ()
icFloatNumber *	applyRangeToObserver (const icSpectralRange &newRange) const
virtual void	Describe (std::string &sDescription, int nVerboseness)
virtual void	DetachIO ()
virtual const icChar *	GetClassName () const
virtual IIccExtensionTag *	GetExtension ()
const icFloatNumber *	getIlluminant (icSpectralRange &illumRange) const
icFloatNumber	getIlluminantCCT () const
const icFloatNumber *	getObserver (icSpectralRange &observerRange) const
CIccMatrixMath *	getObserverMatrix (const icSpectralRange &newRange) const
icIlluminant	getStdIllumiant () const
icStandardObserver	getStdObserver () const
virtual icArraySignature	GetTagArrayType () const
virtual icStructSignature	GetTagStructType () const
virtual icTagTypeSignature	GetType () const
virtual bool	IsArrayType ()
virtual bool	IsMBBType ()
virtual bool	IsNumArrayType () const
virtual bool	IsSupported ()
virtual CIccTag *	NewCopy () const
CIccTagSpectralViewingConditions &	operator= (const CIccTagSpectralViewingConditions &RespCurveSet16Tag)
virtual bool	Read (icUInt32Number size, CIccIO *pIO)
virtual bool	Read (icUInt32Number size, CIccIO *pIO, CIccProfile *pProfile)
virtual bool	ReadAll ()
bool	setIlluminant (icFloatNumber *pWhiteXYZ)
bool	setIlluminant (icIlluminant illumId, const icSpectralRange &illumRange, const icFloatNumber *illum, icFloatNumber illumCCT=0.0f)
bool	setObserver (icStandardObserver observerId, const icSpectralRange &observerRange, const icFloatNumber *observer)
virtual icValidateStatus	Validate (std::string sigPath, std::string &sReport, const CIccProfile *pProfile=NULL) const
virtual bool	Write (CIccIO *pIO)

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

Data Fields
icFloatXYZNumber	m_illuminantXYZ
icUInt32Number	m_nReserved
icUInt16Number	m_reserved2
icUInt16Number	m_reserved3
icFloatXYZNumber	m_surroundXYZ

Protected Attributes
icFloatNumber	m_colorTemperature
icFloatNumber *	m_illuminant
icSpectralRange	m_illuminantRange
icFloatNumber *	m_observer
icSpectralRange	m_observerRange
icIlluminant	m_stdIlluminant
icStandardObserver	m_stdObserver

Detailed Description

Class: CIccTagSpectralViewingConditions

Purpose: The responseCurveSet16 Tag type

Constructor & Destructor Documentation

CIccTagSpectralViewingConditions() [1/2]

CIccTagSpectralViewingConditions::CIccTagSpectralViewingConditions

(

)

Name: CIccTagSpectralViewingConditions::CIccTagSpectralViewingConditions

Purpose: Constructor

{
  m_stdObserver = icStdObs1931TwoDegrees;
  m_observerRange.start = 0;
  m_observerRange.end = 0;
  m_observerRange.steps = 0;
  m_observer = NULL;
 
  m_stdIlluminant = icIlluminantD50;
  m_colorTemperature = 5000.0f;
 
  m_illuminantRange.start = 0;
  m_illuminantRange.end = 0;
  m_illuminantRange.steps = 0;
 
  m_illuminant = 0;
 
  m_illuminantXYZ.X = 0;
  m_illuminantXYZ.Y = 0;
  m_illuminantXYZ.Z = 0;
 
  m_surroundXYZ.X = 0;
  m_surroundXYZ.Y = 0;
  m_surroundXYZ.Z = 0;
}

References icSpectralRange::end, icIlluminantD50, icStdObs1931TwoDegrees, m_colorTemperature, m_illuminant, m_illuminantRange, m_illuminantXYZ, m_observer, m_observerRange, m_stdIlluminant, m_stdObserver, m_surroundXYZ, icSpectralRange::start, icSpectralRange::steps, icFloatXYZNumber::X, icFloatXYZNumber::Y, and icFloatXYZNumber::Z.

CIccTagSpectralViewingConditions() [2/2]

CIccTagSpectralViewingConditions::CIccTagSpectralViewingConditions

(

const CIccTagSpectralViewingConditions &

SVCT

)

Name: CIccTagSpectralViewingConditions::CIccTagSpectralViewingConditions

Purpose: Copy Constructor

Args: SVCT = The CIccTagSpectralViewingConditions object to be copied

{
  m_stdObserver = SVCT.m_stdObserver;
  m_observerRange.start = SVCT.m_observerRange.start;
  m_observerRange.end = SVCT.m_observerRange.end;
  m_observerRange.steps = SVCT.m_observerRange.steps;
 
  if (SVCT.m_observer && SVCT.m_observerRange.steps) {
    m_observer = new icFloat32Number[SVCT.m_observerRange.steps*3];
    if (m_observer) {
      memcpy(m_observer, SVCT.m_observer, SVCT.m_observerRange.steps*3*sizeof(icFloat32Number));
    }
  }
  else {
    m_observer = NULL;
  }
 
  m_stdIlluminant = SVCT.m_stdIlluminant;
  m_colorTemperature = SVCT.m_colorTemperature;
 
  m_illuminantRange.start = 0;
  m_illuminantRange.end = 0;
  m_illuminantRange.steps = 0;
 
  if (SVCT.m_illuminant && SVCT.m_illuminantRange.steps) {
    m_illuminant = new icFloat32Number[SVCT.m_illuminantRange.steps];
    if (m_illuminant) {
      memcpy(m_illuminant, SVCT.m_illuminant, SVCT.m_illuminantRange.steps*sizeof(icFloat32Number));
    }
  }
  else {
    m_illuminant = NULL;
  }
 
  m_illuminantXYZ.X = 0;
  m_illuminantXYZ.Y = 0;
  m_illuminantXYZ.Z = 0;
 
  m_surroundXYZ.X = 0;
  m_surroundXYZ.Y = 0;
  m_surroundXYZ.Z = 0;
}

References icSpectralRange::end, m_colorTemperature, m_illuminant, m_illuminantRange, m_illuminantXYZ, m_observer, m_observerRange, m_stdIlluminant, m_stdObserver, m_surroundXYZ, icSpectralRange::start, icSpectralRange::steps, icFloatXYZNumber::X, icFloatXYZNumber::Y, and icFloatXYZNumber::Z.

Referenced by NewCopy().

Here is the caller graph for this function:

~CIccTagSpectralViewingConditions()

CIccTagSpectralViewingConditions::~CIccTagSpectralViewingConditions ( )

virtual

Name: CIccTagSpectralViewingConditions::~CIccTagResponseCurveSet16

Purpose: Destructor

{
  if (m_observer)
    delete [] m_observer;
 
  if (m_illuminant)
    delete [] m_illuminant;
}

References m_illuminant, and m_observer.

Member Function Documentation

applyRangeToObserver()

icFloatNumber * CIccTagSpectralViewingConditions::applyRangeToObserver

(

const icSpectralRange &

newRange

)

const

{
  int n = newRange.steps*3;
  icFloatNumber *rv = (icFloatNumber*)malloc(n*sizeof(icFloatNumber));
 
  CIccMatrixMath *range = CIccMatrixMath::rangeMap(m_observerRange, newRange);
  if (range) {
    range->VectorMult(rv, m_observer);
    range->VectorMult(&rv[newRange.steps], &m_observer[m_observerRange.steps]);
    range->VectorMult(&rv[newRange.steps*2], &m_observer[m_observerRange.steps*2]);
    delete range;
  }
  else {
    memcpy(rv, m_observer, m_observerRange.steps*3*sizeof(icFloatNumber));
  }
 
  return rv;
}

References m_observer, m_observerRange, CIccMatrixMath::rangeMap(), icSpectralRange::steps, and CIccMatrixMath::VectorMult().

Here is the call graph for this function:

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()

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

virtual

Name: CIccTagSpectralViewingConditions::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];
  CIccInfo info;
 
  sprintf(buf, "StdObserver: %s\n\n", info.GetStandardObserverName(m_stdObserver));
  sDescription += buf;
 
  sprintf(buf, "Illuminant Tristimulus values: X = %.4lf, Y = %.4lf, Z = %.4lf\n\n", 
    m_illuminantXYZ.X, m_illuminantXYZ.Y,m_illuminantXYZ.Z);
  sDescription += buf;
 
  if (m_observer) {
    sprintf(buf, "Observer Functions: start=%.1fnm end=%.1fnm, steps=%d\n", 
            icF16toF(m_observerRange.start), icF16toF(m_observerRange.end), m_observerRange.steps);
    sDescription += buf;
 
    if (nVerboseness > 75) {
        icFloat32Number *ptr = m_observer;
        int i, j;
        for (j=0; j<3; j++) {
          for (i=0; i<m_observerRange.steps; i++) {
            sprintf(buf, " %.4f", *ptr);
            sDescription += buf;
            ptr++;
          }
          sDescription += "\n\n";
        }
    }
  }
  else {
    sDescription += "No custom Observer defined\n\n";
  }
 
  sDescription += "StdIlluminant Type: ";
 
  sDescription += info.GetIlluminantName(m_stdIlluminant);
  sDescription += "\n";
 
  sprintf(buf, "Color Temperature: %.1fK\n\n", m_colorTemperature);
  sDescription += buf;
 
  if (m_illuminant) {
    sprintf(buf, "Illuminant SPD: start=%.1fm end=%.1fnm, steps=%d\n", 
      icF16toF(m_illuminantRange.start), icF16toF(m_illuminantRange.end), m_illuminantRange.steps);
    sDescription += buf;
    if (nVerboseness > 75) {
        icFloat32Number *ptr = m_illuminant;
        int i;
        for (i=0; i<m_illuminantRange.steps; i++) {
          sprintf(buf, " %.4f", *ptr);
          sDescription += buf;
          ptr++;
        }
    }
    sDescription += "\n\n";
  }
  else {
    sDescription += "No custom Observer defined\n\n";
  }
 
  sprintf(buf, "Surround Tristimulus values: X = %.4lf, Y = %.4lf, Z = %.4lf\n",
    m_surroundXYZ.X, m_surroundXYZ.Y, m_surroundXYZ.Z);
  sDescription += buf;
}

References icSpectralRange::end, CIccInfo::GetIlluminantName(), CIccInfo::GetStandardObserverName(), icF16toF(), m_colorTemperature, m_illuminant, m_illuminantRange, m_illuminantXYZ, m_observer, m_observerRange, m_stdIlluminant, m_stdObserver, m_surroundXYZ, icSpectralRange::start, icSpectralRange::steps, icFloatXYZNumber::X, icFloatXYZNumber::Y, and icFloatXYZNumber::Z.

Here is the call graph for this function:

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()

virtual const icChar * CIccTagSpectralViewingConditions::GetClassName ( ) const

inlinevirtual

Reimplemented from CIccTag.

Reimplemented in CIccTagXmlSpectralViewingConditions.

{ return "CIccTagSpectralViewingConditions"; }

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:

getIlluminant()

const icFloatNumber * CIccTagSpectralViewingConditions::getIlluminant

(

icSpectralRange &

illumRange

)

const

{
  if (!m_illuminant || !m_illuminantRange.steps) {
    for (int i = 0; i < NUM_KNOWN_ILLUM; i++) {
      if (m_stdIlluminant == icKnownIllums[i].illum) {
        illumRange = icKnownIllumObsRange;
        return &icKnownIllums[i].spd[0];
      }
    }
  }
 
  illumRange = m_illuminantRange;
  return m_illuminant;
}

References icKnownIllumObsRange, icKnownIllums, icIllumDef::illum, m_illuminant, m_illuminantRange, m_stdIlluminant, icIllumDef::spd, and icSpectralRange::steps.

Referenced by CIccCombinedConnectionConditions::CIccCombinedConnectionConditions(), CIccMpeReflectanceCLUT::Begin(), CIccMpeReflectanceObserver::Begin(), IIccProfileConnectionConditions::getObserverIlluminantScaleFactor(), IIccProfileConnectionConditions::getReflectanceObserver(), IIccProfileConnectionConditions::hasIlluminantSPD(), and Validate().

Here is the caller graph for this function:

getIlluminantCCT()

icFloatNumber CIccTagSpectralViewingConditions::getIlluminantCCT ( ) const

inline

{ return m_colorTemperature; }

References m_colorTemperature.

Referenced by CIccCombinedConnectionConditions::CIccCombinedConnectionConditions(), and IIccProfileConnectionConditions::getPccCCT().

Here is the caller graph for this function:

getObserver()

const icFloatNumber * CIccTagSpectralViewingConditions::getObserver

(

icSpectralRange &

observerRange

)

const

{
  if (!m_observer || !m_observerRange.steps) {
    for (int i = 0; i < NUM_KNOWN_OBSERVERS; i++) {
      if (m_stdObserver == icKnownObservers[i].obs) {
        observerRange = icKnownIllumObsRange;
        return &icKnownObservers[i].cmf[0];
      }
    }
  }
 
  observerRange = m_observerRange;
  return m_observer;
}

References icObserverDef::cmf, icKnownIllumObsRange, icKnownObservers, m_observer, m_observerRange, m_stdObserver, icObserverDef::obs, and icSpectralRange::steps.

Referenced by IIccProfileConnectionConditions::getEmissiveObserver(), IIccProfileConnectionConditions::getObserverIlluminantScaleFactor(), IIccProfileConnectionConditions::getObserverWhiteScaleFactor(), and Validate().

Here is the caller graph for this function:

getObserverMatrix()

CIccMatrixMath * CIccTagSpectralViewingConditions::getObserverMatrix

(

const icSpectralRange &

newRange

)

const

{
  CIccMatrixMath *pMtx=new CIccMatrixMath(3, newRange.steps);
 
  CIccMatrixMath *range = CIccPcsXform::rangeMap(m_observerRange, newRange);
  if (range) {
    range->VectorMult(pMtx->entry(0), m_observer);
    range->VectorMult(pMtx->entry(1), &m_observer[m_observerRange.steps]);
    range->VectorMult(pMtx->entry(2), &m_observer[m_observerRange.steps*2]);
    delete range;
  }
  else {
    memcpy(pMtx->entry(0), m_observer, m_observerRange.steps*3*sizeof(icFloatNumber));
  }
 
  return pMtx;
}

References CIccMatrixMath::CIccMatrixMath(), CIccMatrixMath::entry(), m_observer, m_observerRange, icSpectralRange::steps, and CIccMatrixMath::VectorMult().

Referenced by IIccProfileConnectionConditions::getReflectanceObserver().

Here is the call graph for this function:

Here is the caller graph for this function:

getStdIllumiant()

icIlluminant CIccTagSpectralViewingConditions::getStdIllumiant ( ) const

inline

{ return m_stdIlluminant; }

References m_stdIlluminant.

Referenced by CIccCombinedConnectionConditions::CIccCombinedConnectionConditions(), and IIccProfileConnectionConditions::getPccIlluminant().

Here is the caller graph for this function:

getStdObserver()

icStandardObserver CIccTagSpectralViewingConditions::getStdObserver ( ) const

inline

{ return m_stdObserver; }

References m_stdObserver.

Referenced by IIccProfileConnectionConditions::getPccObserver().

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()

virtual icTagTypeSignature CIccTagSpectralViewingConditions::GetType ( ) const

inlinevirtual

Function: GetType()

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

Reimplemented from CIccTag.

{ return icSigSpectralViewingConditionsType ; }

References icSigSpectralViewingConditionsType.

Referenced by Write().

Here is the caller graph for this function:

IsArrayType()

virtual bool CIccTag::IsArrayType ( )

inlinevirtualinherited

Reimplemented in CIccTagXYZ, CIccTagChromaticity, CIccTagSparseMatrixArray, CIccTagFixedNum< T, Tsig >, CIccTagNum< T, Tsig >, CIccTagFloatNum< T, Tsig >, and CIccTagData.

{ return false; }

Referenced by MyTagDialog::MyTagDialog(), and DumpTag().

Here is the caller graph for this function:

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()

virtual bool CIccTag::IsNumArrayType ( ) const

inlinevirtualinherited

Reimplemented in CIccTagSparseMatrixArray, CIccTagFixedNum< T, Tsig >, CIccTagNum< T, Tsig >, and CIccTagFloatNum< T, Tsig >.

{ return false;} //If true then CIccTag can be cast as a CIccTagNumArray

Referenced by CIccArrayNamedColor::FindDeviceColor(), CIccArrayNamedColor::FindPcsColor(), CIccArrayNamedColor::FindSpectralColor(), CIccTagStruct::GetElemNumberValue(), CIccStructNamedColor::GetNumArray(), CIccMpeXmlTintArray::ParseXml(), and CIccMpeTintArray::Read().

Here is the caller graph for this function:

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()

virtual CIccTag * CIccTagSpectralViewingConditions::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 CIccTagSpectralViewingConditions(*this);}

References CIccTagSpectralViewingConditions().

Referenced by CIccCombinedConnectionConditions::CIccCombinedConnectionConditions().

Here is the call graph for this function:

Here is the caller graph for this function:

operator=()

CIccTagSpectralViewingConditions & CIccTagSpectralViewingConditions::operator=

(

const CIccTagSpectralViewingConditions &

SVCT

)

Name: CIccTagSpectralViewingConditions::operator=

Purpose: Copy Operator

Args: specViewCondTag = The CIccTagSpectralViewingConditions object to be copied

{
  m_stdObserver = SVCT.m_stdObserver;
  m_observerRange.start = SVCT.m_observerRange.start;
  m_observerRange.end = SVCT.m_observerRange.end;
  m_observerRange.steps = SVCT.m_observerRange.steps;
 
  if (SVCT.m_observer && SVCT.m_observerRange.steps) {
    m_observer = new icFloat32Number[SVCT.m_observerRange.steps*3];
    if (m_observer) {
      memcpy(m_observer, SVCT.m_observer, SVCT.m_observerRange.steps*3*sizeof(icFloat32Number));
    }
  }
  else {
    m_observer = NULL;
  }
 
  m_stdIlluminant = SVCT.m_stdIlluminant;
  m_colorTemperature = SVCT.m_colorTemperature;
 
  m_illuminantRange.start = 0;
  m_illuminantRange.end = 0;
  m_illuminantRange.steps = 0;
 
  if (SVCT.m_illuminant && SVCT.m_illuminantRange.steps) {
    m_illuminant = new icFloat32Number[SVCT.m_illuminantRange.steps];
    if (m_illuminant) {
      memcpy(m_illuminant, SVCT.m_illuminant, SVCT.m_illuminantRange.steps*sizeof(icFloat32Number));
    }
  }
  else {
    m_illuminant = NULL;
  }
 
  m_illuminantXYZ.X = 0;
  m_illuminantXYZ.Y = 0;
  m_illuminantXYZ.Z = 0;
 
  m_surroundXYZ.X = 0;
  m_surroundXYZ.Y = 0;
  m_surroundXYZ.Z = 0;
 
  return *this;
}

References icSpectralRange::end, m_colorTemperature, m_illuminant, m_illuminantRange, m_illuminantXYZ, m_observer, m_observerRange, m_stdIlluminant, m_stdObserver, m_surroundXYZ, icSpectralRange::start, icSpectralRange::steps, icFloatXYZNumber::X, icFloatXYZNumber::Y, and icFloatXYZNumber::Z.

Read() [1/2]

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

virtual

Name: CIccTagSpectralViewingConditions::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;
 
  //check size properly
  icUInt32Number headerSize = sizeof(icTagTypeSignature) + 
                              sizeof(icUInt32Number)*4;
  if (headerSize > size)
    return false;
 
  if (!pIO) {
    return false;
  }
 
  if (!pIO->Read32(&sig) ||
      !pIO->Read32(&m_nReserved))
    return false;
 
 
  if (!pIO->Read32(&m_stdObserver) ||
      !pIO->Read16(&m_observerRange.start) ||
      !pIO->Read16(&m_observerRange.end) ||
      !pIO->Read16(&m_observerRange.steps) ||
      !pIO->Read16(&m_reserved2))
    return false;
 
  icUInt32Number vals;
 
  if (m_observer) {
    delete [] m_observer;
    m_observer = NULL;
  }
 
  icUInt32Number observerSize = 0;
 
  if (m_observerRange.steps) {
    vals = m_observerRange.steps * 3;
 
    observerSize = vals * sizeof(icFloat32Number);
 
    if (headerSize + observerSize > size)
      return false;
    
    m_observer = new icFloat32Number[vals];
    if (!m_observer)
      return false;
 
    if (pIO->ReadFloat32Float(&m_observer[0], vals) != vals)
      return false;
  }
 
  icUInt32Number illumInfoSize = 2 * sizeof(icUInt32Number) + 4 * sizeof(icUInt16Number);
  if (headerSize + observerSize +illumInfoSize > size)
    return false;
 
  if (!pIO->Read32(&m_stdIlluminant) ||
      !pIO->ReadFloat32Float(&m_colorTemperature) ||
      !pIO->Read16(&m_illuminantRange.start) ||
      !pIO->Read16(&m_illuminantRange.end) ||
      !pIO->Read16(&m_illuminantRange.steps) ||
      !pIO->Read16(&m_reserved3))
    return false;
 
 
  if (m_illuminant) {
    delete [] m_illuminant;
    m_illuminant = NULL;
  }
 
  icUInt32Number illuminantSize = 0;
 
  if (m_illuminantRange.steps) {
    vals = m_illuminantRange.steps;
 
    illuminantSize = vals * sizeof(icFloat32Number);
 
    if (headerSize + observerSize + illumInfoSize + illuminantSize > size)
      return false;
 
    m_illuminant = new icFloat32Number[vals];
    if (!m_illuminant)
      return false;
 
    if (pIO->ReadFloat32Float(&m_illuminant[0], vals) != vals)
      return false;
  }
  else {
    setIlluminant(m_stdIlluminant, m_illuminantRange, NULL, m_colorTemperature);
  }
 
  if (headerSize + observerSize + illumInfoSize + illuminantSize + 6*sizeof(icFloat32Number) > size)
    return false;
 
  if (pIO->ReadFloat32Float(&m_illuminantXYZ, 3)!=3 ||
      pIO->ReadFloat32Float(&m_surroundXYZ, 3)!=3)
    return false;
 
  return true;
}

References icSpectralRange::end, m_colorTemperature, m_illuminant, m_illuminantRange, m_illuminantXYZ, CIccTag::m_nReserved, m_observer, m_observerRange, m_reserved2, m_reserved3, m_stdIlluminant, m_stdObserver, m_surroundXYZ, CIccIO::Read16(), CIccIO::Read32(), CIccIO::ReadFloat32Float(), setIlluminant(), icSpectralRange::start, and icSpectralRange::steps.

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; }

setIlluminant() [1/2]

bool CIccTagSpectralViewingConditions::setIlluminant

(

icFloatNumber *

pWhiteXYZ

)

{
  icSpectralRange zeroRange;
  memset(&zeroRange, 0, sizeof(zeroRange));
  icFloatNumber white[3] = {0};
  white[0] = pWhiteXYZ[0] / pWhiteXYZ[1];
  white[1] = 1.0;
  white[2] = pWhiteXYZ[2] / pWhiteXYZ[1];
 
  if (!pWhiteXYZ || !icNotZero(pWhiteXYZ[1])) {
    setIlluminant(icIlluminantUnknown, zeroRange, NULL);
    return false;
  }
 
  if (m_stdObserver == icStdObs1931TwoDegrees) {
    if ((icIsNear(white[0], icD50XYZ[0]) && icIsNear(white[2], icD50XYZ[2])) ||
        (icIsNear(white[0], 0.9642f, 0.0001f) && icIsNear(white[2], 0.8251f, 0.0001f))) {
      return setIlluminant(icIlluminantD50, zeroRange, NULL, 5000);
    }
    else if (icIsNear(white[0], 0.9505f, 0.0001f) && icIsNear(white[2], 1.0888f, 0.0001f)) {
      return setIlluminant(icIlluminantD65, zeroRange, NULL, 6504);
    }
  }
//   else if (m_stdObserver == icStdObs1964TenDegrees) {
//     setIlluminant(icIlluminantUnknown, zeroRange, NULL);
//     return false;
//   }
 
  setIlluminant(icIlluminantUnknown, zeroRange, NULL);
  return false;
}

References icD50XYZ, icIlluminantD50, icIlluminantD65, icIlluminantUnknown, icIsNear(), icStdObs1931TwoDegrees, m_stdObserver, and setIlluminant().

Referenced by CIccDefaultEncProfileConverter::ConvertFromParams().

Here is the call graph for this function:

Here is the caller graph for this function:

setIlluminant() [2/2]

bool CIccTagSpectralViewingConditions::setIlluminant	(	icIlluminant	illumId,
		const icSpectralRange &	illumRange,
		const icFloatNumber *	illum,
		icFloatNumber	illumCCT = 0.0f
	)

{
  m_stdIlluminant = illumId;
  m_colorTemperature = illumCCT;
 
  if (m_illuminant) {
    delete[] m_illuminant;
    m_illuminant = nullptr;
  }
 
  m_illuminantRange = illumRange;
 
  if (illumRange.steps && illum) {
    icUInt32Number size = illumRange.steps;
    m_illuminant = new icFloatNumber[size]; // Replaced malloc with new[]
    if (m_illuminant)
      memcpy(m_illuminant, illum, size * sizeof(icFloatNumber)); // Retained memcpy
    else {
      memset(&m_illuminantRange, 0, sizeof(m_illuminantRange));
      return false;
    }
  } else {
    if (!illum)
      memset(&m_illuminantRange, 0, sizeof(m_illuminantRange));
 
    m_illuminant = nullptr;
  }
 
  return true;
}

References m_colorTemperature, m_illuminant, m_illuminantRange, m_stdIlluminant, and icSpectralRange::steps.

Referenced by CIccCombinedConnectionConditions::CIccCombinedConnectionConditions(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), and setIlluminant().

Here is the caller graph for this function:

setObserver()

bool CIccTagSpectralViewingConditions::setObserver	(	icStandardObserver	observerId,
		const icSpectralRange &	observerRange,
		const icFloatNumber *	observer
	)

{
  m_stdObserver = observerId;
  m_observerRange = observerRange;
  if (m_observer) {
    delete [] m_observer;
  }
 
  if (observerRange.steps && observer) {
    icUInt32Number size = observerRange.steps * 3;
    m_observer = new icFloatNumber[size];
    if (m_observer)
      memcpy(m_observer, observer, size*sizeof(icFloatNumber));
    else {
      memset(&m_observerRange, 0, sizeof(m_observerRange));
      return false;
    }
  }
  else {
    if (!observer)
      memset(&m_observerRange, 0, sizeof(m_illuminantRange));
 
    m_observer = NULL;
  }
 
  return true;
}

References m_illuminantRange, m_observer, m_observerRange, m_stdObserver, and icSpectralRange::steps.

Validate()

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

virtual

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

{
  icValidateStatus rv = CIccTag::Validate(sigPath, sReport, pProfile);
 
  CIccInfo Info;
  std::string sSigPathName = Info.GetSigPathName(sigPath);
 
  rv = icMaxStatus(rv, Info.CheckData(sReport, m_illuminantXYZ, sSigPathName + ":>illuminantXYZ"));
  rv = icMaxStatus(rv, Info.CheckData(sReport, m_surroundXYZ, sSigPathName + ":>surroundXYZ"));
 
  rv = icMaxStatus(rv, Info.CheckLuminance(sReport, m_illuminantXYZ, sSigPathName + ":>illuminantXYZ"));
  rv = icMaxStatus(rv, Info.CheckLuminance(sReport, m_surroundXYZ, sSigPathName + ":>surroundXYZ"));
 
  icSpectralRange range;
 
  if (getObserver(range)) {
    rv = icMaxStatus(rv, Info.CheckData(sReport, range, sSigPathName + ":>observerRange"));
 
    if (!m_observer && pProfile && pProfile->m_Header.version < icVersionNumberV5_1) {
      sReport += icMsgValidateNonCompliant;
      sReport += sSigPathName;
      sReport += " - Missing Observer CMF not supported by profile version!\r\n";
      rv = icMaxStatus(rv, icValidateNonCompliant);
    }
  }
  else {
    rv = icMaxStatus(rv, Info.CheckData(sReport, m_observerRange, sSigPathName + ":>observerRange"));
 
    sReport += icMsgValidateCriticalError;
    sReport += sSigPathName;
    sReport += " - Missing Observer CMF!\r\n";
    rv = icMaxStatus(rv, icValidateCriticalError);
  }
 
  if (getIlluminant(range)) {
    rv = icMaxStatus(rv, Info.CheckData(sReport, range, sSigPathName + ":>illuminantRange"));
 
    if (!m_illuminant && pProfile && pProfile->m_Header.version < icVersionNumberV5_1) {
      sReport += icMsgValidateNonCompliant;
      sReport += sSigPathName;
      sReport += " - Missing illuminant SPD not supported by profile version!\r\n";
      rv = icMaxStatus(rv, icValidateNonCompliant);
    }
  }
  else {
    rv = icMaxStatus(rv, Info.CheckData(sReport, m_illuminantRange, sSigPathName + ":>illuminantRange"));
    sReport += icMsgValidateCriticalError;
    sReport += sSigPathName;
    sReport += " - Missing Illuminant SPD!\r\n";
    rv = icMaxStatus(rv, icValidateCriticalError);
  }
 
  return rv;
}

References CIccInfo::CheckData(), CIccInfo::CheckData(), CIccInfo::CheckLuminance(), getIlluminant(), getObserver(), CIccInfo::GetSigPathName(), icMaxStatus(), icMsgValidateCriticalError, icMsgValidateNonCompliant, icValidateCriticalError, icValidateNonCompliant, m_illuminant, m_illuminantRange, m_illuminantXYZ, m_observer, m_observerRange, m_surroundXYZ, CIccTag::Validate(), and icHeader::version.

Here is the call graph for this function:

Write()

bool CIccTagSpectralViewingConditions::Write ( CIccIO *  pIO )

virtual

Name: CIccTagSpectralViewingConditions::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) ||
      !pIO->Write32(&m_nReserved))
    return false;
 
 
  if (!pIO->Write32(&m_stdObserver) ||
      !pIO->Write16(&m_observerRange.start) ||
      !pIO->Write16(&m_observerRange.end) ||
      !pIO->Write16(&m_observerRange.steps) ||
      !pIO->Write16(&m_reserved2))
    return false;
 
  icUInt32Number vals = m_observerRange.steps*3;
 
  if (vals)
    if (pIO->WriteFloat32Float(&m_observer[0], vals) != vals)
      return false;
 
  if (!pIO->Write32(&m_stdIlluminant) ||
    !pIO->WriteFloat32Float(&m_colorTemperature) ||
    !pIO->Write16(&m_illuminantRange.start) ||
    !pIO->Write16(&m_illuminantRange.end) ||
    !pIO->Write16(&m_illuminantRange.steps) ||
    !pIO->Write16(&m_reserved3))
    return false;
 
  vals = m_illuminantRange.steps;
 
  if (vals)
    if (pIO->WriteFloat32Float(&m_illuminant[0], vals) != vals)
      return false;
 
  if (pIO->WriteFloat32Float(&m_illuminantXYZ, 3)!=3 ||
      pIO->WriteFloat32Float(&m_surroundXYZ, 3)!=3)
    return false;
 
  return true;
}

References icSpectralRange::end, GetType(), m_colorTemperature, m_illuminant, m_illuminantRange, m_illuminantXYZ, CIccTag::m_nReserved, m_observer, m_observerRange, m_reserved2, m_reserved3, m_stdIlluminant, m_stdObserver, m_surroundXYZ, icSpectralRange::start, icSpectralRange::steps, CIccIO::Write16(), CIccIO::Write32(), and CIccIO::WriteFloat32Float().

Here is the call graph for this function:

Field Documentation

m_colorTemperature

icFloatNumber CIccTagSpectralViewingConditions::m_colorTemperature

protected

Referenced by CIccTagSpectralViewingConditions(), CIccTagSpectralViewingConditions(), Describe(), getIlluminantCCT(), operator=(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), setIlluminant(), CIccTagXmlSpectralViewingConditions::ToXml(), and Write().

m_illuminant

icFloatNumber* CIccTagSpectralViewingConditions::m_illuminant

protected

Referenced by CIccTagSpectralViewingConditions(), CIccTagSpectralViewingConditions(), ~CIccTagSpectralViewingConditions(), Describe(), getIlluminant(), operator=(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), setIlluminant(), CIccTagXmlSpectralViewingConditions::ToXml(), Validate(), and Write().

m_illuminantRange

icSpectralRange CIccTagSpectralViewingConditions::m_illuminantRange

protected

Referenced by CIccTagSpectralViewingConditions(), CIccTagSpectralViewingConditions(), Describe(), getIlluminant(), operator=(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), setIlluminant(), setObserver(), CIccTagXmlSpectralViewingConditions::ToXml(), Validate(), and Write().

m_illuminantXYZ

icFloatXYZNumber CIccTagSpectralViewingConditions::m_illuminantXYZ

Referenced by CIccCombinedConnectionConditions::CIccCombinedConnectionConditions(), CIccTagSpectralViewingConditions(), CIccTagSpectralViewingConditions(), CIccDefaultEncProfileConverter::ConvertFromParams(), Describe(), operator=(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), CIccTagXmlSpectralViewingConditions::ToXml(), Validate(), and Write().

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(), 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(), 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_observer

icFloatNumber* CIccTagSpectralViewingConditions::m_observer

protected

Referenced by CIccTagSpectralViewingConditions(), CIccTagSpectralViewingConditions(), ~CIccTagSpectralViewingConditions(), applyRangeToObserver(), Describe(), getObserver(), getObserverMatrix(), operator=(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), setObserver(), CIccTagXmlSpectralViewingConditions::ToXml(), Validate(), and Write().

m_observerRange

icSpectralRange CIccTagSpectralViewingConditions::m_observerRange

protected

Referenced by CIccTagSpectralViewingConditions(), CIccTagSpectralViewingConditions(), applyRangeToObserver(), Describe(), getObserver(), getObserverMatrix(), operator=(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), setObserver(), CIccTagXmlSpectralViewingConditions::ToXml(), Validate(), and Write().

m_reserved2

icUInt16Number CIccTagSpectralViewingConditions::m_reserved2

Referenced by CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), CIccTagXmlSpectralViewingConditions::ToXml(), and Write().

m_reserved3

icUInt16Number CIccTagSpectralViewingConditions::m_reserved3

Referenced by CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), CIccTagXmlSpectralViewingConditions::ToXml(), and Write().

m_stdIlluminant

icIlluminant CIccTagSpectralViewingConditions::m_stdIlluminant

protected

Referenced by CIccTagSpectralViewingConditions(), CIccTagSpectralViewingConditions(), Describe(), getIlluminant(), getStdIllumiant(), operator=(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), setIlluminant(), CIccTagXmlSpectralViewingConditions::ToXml(), and Write().

m_stdObserver

icStandardObserver CIccTagSpectralViewingConditions::m_stdObserver

protected

Referenced by CIccTagSpectralViewingConditions(), CIccTagSpectralViewingConditions(), Describe(), getObserver(), getStdObserver(), operator=(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), setIlluminant(), setObserver(), CIccTagXmlSpectralViewingConditions::ToXml(), and Write().

m_surroundXYZ

icFloatXYZNumber CIccTagSpectralViewingConditions::m_surroundXYZ

Referenced by CIccTagSpectralViewingConditions(), CIccTagSpectralViewingConditions(), CIccDefaultEncProfileConverter::ConvertFromParams(), Describe(), operator=(), CIccTagXmlSpectralViewingConditions::ParseXml(), Read(), CIccTagXmlSpectralViewingConditions::ToXml(), Validate(), and Write().

---

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

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