IccPcc.h

Go to the documentation of this file.

/** @file
    File:       IccPcc.h
 
    Contains:   Header for implementation of the IIccProfileConnectionConditions interface class.
 
    Version:    V1
 
    Copyright:  (c) see ICC Software License
*/
 
/*
 * The ICC Software License, Version 0.2
 *
 *
 * Copyright (c) 2003-2012 The International Color Consortium. All rights 
 * reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer. 
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * 3. In the absence of prior written permission, the names "ICC" and "The
 *    International Color Consortium" must not be used to imply that the
 *    ICC organization endorses or promotes products derived from this
 *    software.
 *
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL THE INTERNATIONAL COLOR CONSORTIUM OR
 * ITS CONTRIBUTING MEMBERS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of the The International Color Consortium. 
 *
 *
 * Membership in the ICC is encouraged when this software is used for
 * commercial purposes. 
 *
 *  
 * For more information on The International Color Consortium, please
 * see <http://www.color.org/>.
 *  
 * 
 */
 
////////////////////////////////////////////////////////////////////// 
// HISTORY:
//
// -Initial implementation by Max Derhak 4-10-2012
//
//////////////////////////////////////////////////////////////////////
 
#if !defined(_ICCPCC_H)
#define _ICCPCC_H
 
#include "IccDefs.h"
 
#ifdef USEREFICCMAXNAMESPACE
namespace refIccMAX {
#endif
 
class ICCPROFLIB_API CIccProfile;
class ICCPROFLIB_API CIccTagSpectralViewingConditions;
class ICCPROFLIB_API CIccTagMultiProcessElement;
class ICCPROFLIB_API CIccMatrixMath;
 
/**
**************************************************************************
* Type: Class
* 
* Purpose: 
*  Interface for accessing Connection Conditions
**************************************************************************
*/
class ICCPROFLIB_API IIccProfileConnectionConditions
{
public:
  virtual ~IIccProfileConnectionConditions() {}
 
  virtual const CIccTagSpectralViewingConditions *getPccViewingConditions() = 0;
  virtual CIccTagMultiProcessElement *getCustomToStandardPcc() = 0;
  virtual CIccTagMultiProcessElement *getStandardToCustomPcc() = 0;
 
  bool isEquivalentPcc(IIccProfileConnectionConditions &IPCC);
  bool isStandardPcc();
  bool hasIlluminantSPD();
 
  icFloatNumber getObserverIlluminantScaleFactor();
  icFloatNumber getObserverWhiteScaleFactor(const icFloatNumber *pWhite, const icSpectralRange &whiteRange);
 
 
  icFloatNumber *getEmissiveObserver(const icSpectralRange &range, const icFloatNumber *pWhite, icFloatNumber *obsMatrix=NULL);  //Caller responsible for freeing results if obsMatrix is NULL
  CIccMatrixMath *getReflectanceObserver(const icSpectralRange &rangeRef);  //Caller responsible for deleting results of returned CIccMatrixMath object
 
  icIlluminant getPccIlluminant();
  icFloatNumber getPccCCT();
  icStandardObserver getPccObserver();
 
  virtual void getNormIlluminantXYZ(icFloatNumber *pXYZ)=0;
  virtual void getLumIlluminantXYZ(icFloatNumber *pXYZ)=0;
  virtual bool getMediaWhiteXYZ(icFloatNumber *pXYZ)=0;
};
 
 
/**
**************************************************************************
* Type: Class
* 
* Purpose: 
*  Class used for defining combined connection conditions where the 
*  viewing conditions are the combined result of information from
*  the profile and external connection conditions based on whether
*  reflectance or emission is used.
**************************************************************************
*/
class ICCPROFLIB_API CIccCombinedConnectionConditions : public IIccProfileConnectionConditions
{
public:
  CIccCombinedConnectionConditions(CIccProfile *pProfile, IIccProfileConnectionConditions *pAppliedPCC, bool bReflectance=false);
  virtual ~CIccCombinedConnectionConditions();
 
  virtual const CIccTagSpectralViewingConditions *getPccViewingConditions();
  virtual CIccTagMultiProcessElement *getCustomToStandardPcc();
  virtual CIccTagMultiProcessElement *getStandardToCustomPcc();
 
  virtual void getNormIlluminantXYZ(icFloatNumber *pXYZ);
  virtual void getLumIlluminantXYZ(icFloatNumber *pXYZLum);
  virtual bool getMediaWhiteXYZ(icFloatNumber *pXYZ);
 
protected:
  CIccTagSpectralViewingConditions *m_pViewingConditions;
  icFloatNumber m_illuminantXYZ[3];
  icFloatNumber m_illuminantXYZLum[3];
  icFloatNumber m_mediaXYZ[3];
  IIccProfileConnectionConditions *m_pPCC;
  bool m_bValidMediaXYZ;
  bool m_bValidIllumXYZ;
};
 
 
#ifdef USEREFICCMAXNAMESPACE
} //namespace refIccMAX
#endif
 
#endif // !defined(_ICCPCC_H)