#include <IccTagLut.h>

Public Member Functions
	CIccMatrix (bool bUseConstants=true)

	CIccMatrix (const CIccMatrix &MatrixClass)

virtual	~CIccMatrix ()

virtual void	Apply (icFloatNumber *Pixel) const

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

virtual bool	IsIdentity ()

CIccMatrix &	operator= (const CIccMatrix &MatrixClass)

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

Data Fields
bool	m_bUseConstants

icFloatNumber	m_e [12]

Detailed Description

Class: CIccMatrix

Purpose: The base matrix class

Constructor & Destructor Documentation

◆ CIccMatrix() [1/2]

CIccMatrix::CIccMatrix ( bool bUseConstants = true )

Name: CIccMatrix::CIccMatrix

Purpose: Constructor

Args: bUseConstants = true if the matrix contains additional row for constants

{
  m_bUseConstants = bUseConstants;
  m_e[0] = m_e[4] = m_e[8] = 1.0;
  m_e[1] = m_e[2] = m_e[3] =
    m_e[5] = m_e[6] = m_e[7] = 0.0;
 
  if (!m_bUseConstants) {
    m_e[9] = m_e[10] = m_e[11] = 0.0;
  }
}

References m_bUseConstants, and m_e.

Referenced by CIccTagLutAtoB::Read().

Here is the caller graph for this function:

◆ CIccMatrix() [2/2]

CIccMatrix::CIccMatrix ( const CIccMatrix & MatrixClass )

Name: CIccMatrix::CIccMatrix

Purpose: Copy Constructor

Args: MatrixClass = The CIccMatrix object to be copied

{
  m_bUseConstants = MatrixClass.m_bUseConstants;
  memcpy(m_e, MatrixClass.m_e, sizeof(m_e));
}

References m_bUseConstants, and m_e.

Referenced by CIccMBB::CIccMBB(), and CIccMBB::operator=().

Here is the caller graph for this function:

◆ ~CIccMatrix()

virtual CIccMatrix::~CIccMatrix ( )

inlinevirtual

265{}

Member Function Documentation

◆ Apply()

void CIccMatrix::Apply ( icFloatNumber * Pixel ) const

virtual

Name: CIccMatrix::Apply

Purpose: Multiplies the pixel by the matrix.

Args: Pixel = Pixel to be multiplied by the matrix

{
  icFloatNumber a=Pixel[0];
  icFloatNumber b=Pixel[1];
  icFloatNumber c=Pixel[2];
 
  icFloatNumber x = m_e[0]*a + m_e[1]*b + m_e[2]*c;
  icFloatNumber y = m_e[3]*a + m_e[4]*b + m_e[5]*c;
  icFloatNumber z = m_e[6]*a + m_e[7]*b + m_e[8]*c;
 
  if (m_bUseConstants) {
    x += m_e[9];
    y += m_e[10];
    z += m_e[11];
  }
 
  Pixel[0] = x;
  Pixel[1] = y;
  Pixel[2] = z;
}

References m_bUseConstants, and m_e.

◆ DumpLut()

void CIccMatrix::DumpLut	(	std::string &	sDescription,
		const icChar *	szName,
		int	nVerboseness
	)

Name: CIccTagParametricCurve::DumpLut

Purpose: Dump the matrix data to a string.

Args: sDescription = string to concatenate tag dump to, szName = name of the curve to be printed

{
  icChar buf[128];
 
  sprintf(buf, "BEGIN_MATRIX %s\n", szName);
  sDescription += buf;
 
  if (!m_bUseConstants) {
    sprintf(buf, "%8.4lf %8.4lf %8.4lf\n",
      m_e[0], m_e[1], m_e[2]);
    sDescription += buf;
    sprintf(buf, "%8.4lf %8.4lf %8.4lf\n",
      m_e[3], m_e[4], m_e[5]);
    sDescription += buf;
    sprintf(buf, "%8.4lf %8.4lf %8.4lf\n",
      m_e[6], m_e[7], m_e[8]);
    sDescription += buf;
  }
  else {
    sprintf(buf, "%8.4lf %8.4lf %8.4lf  +  %8.4lf\n",
      m_e[0], m_e[1], m_e[2], m_e[9]);
    sDescription += buf;
    sprintf(buf, "%8.4lf %8.4lf %8.4lf  +  %8.4lf\n",
      m_e[3], m_e[4], m_e[5], m_e[10]);
    sDescription += buf;
    sprintf(buf, "%8.4lf %8.4lf %8.4lf  +  %8.4lf\n",
      m_e[6], m_e[7], m_e[8], m_e[11]);
    sDescription += buf;
  }
}

References m_bUseConstants, and m_e.

Referenced by CIccMBB::Describe().

Here is the caller graph for this function:

◆ IsIdentity()

bool CIccMatrix::IsIdentity ( )

virtual

Name: CIccMatrix::IsIdentity

Purpose: Checks if the matrix is identity

Return: true if matrix is identity and uses no constants, else false

{
  if (m_bUseConstants) {
    if (fabs(m_e[9])>0.0 || fabs(m_e[10])>0.0 || fabs(m_e[11])>0.0) {
      return false;
    }
  }
 
  if (!IsUnity(m_e[0]) || !IsUnity(m_e[4]) || !IsUnity(m_e[8])) {
    return false;
  }
 
  if (fabs(m_e[1])>0.0 || fabs(m_e[2])>0.0 || fabs(m_e[3])>0.0 ||
      fabs(m_e[5])>0.0 || fabs(m_e[6])>0.0 || fabs(m_e[7])>0.0) 
  {
    return false;
  }
 
  return true;
}

References IsUnity(), m_bUseConstants, and m_e.

Here is the call graph for this function:

◆ operator=()

CIccMatrix & CIccMatrix::operator= ( const CIccMatrix & MatrixClass )

Name: CIccMatrix::operator=

Purpose: Copy Operator

Args: MatrixClass = The CIccMatrix object to be copied

{
  if (&MatrixClass == this)
    return *this;
 
  m_bUseConstants = MatrixClass.m_bUseConstants;
  memcpy(m_e, MatrixClass.m_e, sizeof(m_e));
 
  return *this;
}

References m_bUseConstants, and m_e.

◆ Validate()

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

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

{
  icValidateStatus rv = icValidateOK;
  icSignature sig = icGetFirstSigPathSig(sigPath);
 
  if (sig==icSigLut8Type || sig==icSigLut16Type) {
    if (pProfile->m_Header.pcs!=icSigXYZData) {
      CIccInfo Info;
      std::string sSigPathName = Info.GetSigPathName(sigPath);
      icFloatNumber sum=0.0;
      for (int i=0; i<9; i++) {
        sum += m_e[i];
      }
      if (m_e[0]!=1.0 || m_e[4]!=1.0 || m_e[9]!=1.0 || sum!=3.0) {
        sReport += icMsgValidateNonCompliant;
        sReport += sSigPathName;
        sReport += " - Matrix must be identity.\n";
        rv = icValidateNonCompliant;
      }
    }
  }
 
  return rv;
}