source/dng_color_space.h

/*****************************************************************************/
// Copyright 2006 Adobe Systems Incorporated
// All Rights Reserved.
//
// NOTICE:  Adobe permits you to use, modify, and distribute this file in
// accordance with the terms of the Adobe license agreement accompanying it.
/*****************************************************************************/

/* $Id: //mondo/dng_sdk_1_4/dng_sdk/source/dng_color_space.h#2 $ */ 
/* $DateTime: 2012/07/11 10:36:56 $ */
/* $Change: 838485 $ */
/* $Author: tknoll $ */

/** \file
 *  Standard gamma functions and color spaces used within the DNG SDK.
 */

#ifndef __dng_color_space__
#define __dng_color_space__

/*****************************************************************************/

#include "dng_1d_function.h"
#include "dng_classes.h"
#include "dng_matrix.h"
#include "dng_types.h"

/*****************************************************************************/

/// \brief A dng_1d_function for gamma encoding in sRGB color space

class dng_function_GammaEncode_sRGB: public dng_1d_function
	{
	
	public:
	
		virtual real64 Evaluate (real64 x) const;
			
		virtual real64 EvaluateInverse (real64 y) const;
	
		static const dng_1d_function & Get ();
	
	};

/*****************************************************************************/

/// \brief A dng_1d_function for gamma encoding with 1.8 gamma.

class dng_function_GammaEncode_1_8: public dng_1d_function
	{
	
	public:
	
		virtual real64 Evaluate (real64 x) const;
			
		virtual real64 EvaluateInverse (real64 y) const;
	
		static const dng_1d_function & Get ();
	
	};
			
/*****************************************************************************/

/// \brief A dng_1d_function for gamma encoding with 2.2 gamma.

class dng_function_GammaEncode_2_2: public dng_1d_function
	{
	
	public:
	
		virtual real64 Evaluate (real64 x) const;
			
		virtual real64 EvaluateInverse (real64 y) const;
	
		static const dng_1d_function & Get ();
	
	};
			
/*****************************************************************************/

/// \brief An abstract color space

class dng_color_space
	{
	
	protected:
	
		dng_matrix fMatrixToPCS;
		
		dng_matrix fMatrixFromPCS;
		
	public:
	
		virtual ~dng_color_space ();
	
		/// Return a matrix which transforms source data in this color space into the
		/// Profile Connection Space.

		const dng_matrix & MatrixToPCS () const
			{
			return fMatrixToPCS;
			}
		
		/// Return a matrix which transforms Profile Connection Space data into this
		/// color space.

		const dng_matrix & MatrixFromPCS () const
			{
			return fMatrixFromPCS;
			}

		/// Predicate which is true if this color space is monochrome (has only a
		/// single column).

		bool IsMonochrome () const
			{
			return fMatrixToPCS.Cols () == 1;
			}
		
		/// Getter for the gamma function for this color space.

		virtual const dng_1d_function & GammaFunction () const;

		/// Returns true if this color space is linear. (I.e. has gamma 1.0.)

		bool IsLinear () const
			{
			return GammaFunction ().IsIdentity ();
			}

		/// Map an input value through this color space's encoding gamma.

		real64 GammaEncode (real64 x) const
			{
			return GammaFunction ().Evaluate (x);
			}

		/// Map an input value through this color space's decoding gamma (inverse of
		/// the encoding gamma).

		real64 GammaDecode (real64 y) const
			{
			return GammaFunction ().EvaluateInverse (y);
			}
			
		/// Getter for ICC profile, if this color space has one.
		/// \param size Out parameter which receives size on return.
		/// \param data Receives bytes of profile.
		/// \retval Returns true if this color space has an ICC profile, false otherwise.

		virtual bool ICCProfile (uint32 &size,
								 const uint8 *&data) const;
								 
	protected:
	
		dng_color_space ();
			
		void SetMonochrome ();
		
		void SetMatrixToPCS (const dng_matrix_3by3 &M);
		
	};

/*****************************************************************************/

/// Singleton class for sRGB color space.

class dng_space_sRGB: public dng_color_space
	{
	
	protected:
	
		dng_space_sRGB ();
		
	public:

		/// Returns dng_function_GammaEncode_sRGB

		virtual const dng_1d_function & GammaFunction () const;

		/// Returns sRGB IEC61966-2.1 ICC profile

		virtual bool ICCProfile (uint32 &size,
								 const uint8 *&data) const;

		/// Static method for getting single global instance of this color space.

		static const dng_color_space & Get ();
	
	};

/*****************************************************************************/

/// \brief Singleton class for AdobeRGB color space.

class dng_space_AdobeRGB: public dng_color_space
	{
	
	protected:
	
		dng_space_AdobeRGB ();
		
	public:
	
		/// Returns dng_function_GammaEncode_1_8

		virtual const dng_1d_function & GammaFunction () const;

		/// Returns AdobeRGB (1998) ICC profile

		virtual bool ICCProfile (uint32 &size,
								 const uint8 *&data) const;
		
		/// Static method for getting single global instance of this color space.

		static const dng_color_space & Get ();
	
	};

/*****************************************************************************/

/// \brief Singleton class for ColorMatch color space.

class dng_space_ColorMatch: public dng_color_space
	{
	
	protected:
	
		dng_space_ColorMatch ();
		
	public:
	
		/// Returns dng_function_GammaEncode_1_8

		virtual const dng_1d_function & GammaFunction () const;
		
		/// Returns ColorMatch RGB ICC profile

		virtual bool ICCProfile (uint32 &size,
								 const uint8 *&data) const;
		
		/// Static method for getting single global instance of this color space.

		static const dng_color_space & Get ();
	
	};

/*****************************************************************************/

/// \brief Singleton class for ProPhoto RGB color space.

class dng_space_ProPhoto: public dng_color_space
	{
	
	protected:
	
		dng_space_ProPhoto ();
		
	public:
	
		/// Returns dng_function_GammaEncode_1_8

		virtual const dng_1d_function & GammaFunction () const;
		
		/// Returns ProPhoto RGB ICC profile

		virtual bool ICCProfile (uint32 &size,
								 const uint8 *&data) const;
		
		/// Static method for getting single global instance of this color space.

		static const dng_color_space & Get ();
	
	};

/*****************************************************************************/

/// \brief Singleton class for gamma 1.8 grayscale color space.

class dng_space_GrayGamma18: public dng_color_space
	{
	
	protected:
	
		dng_space_GrayGamma18 ();
		
	public:
	
		/// Returns dng_function_GammaEncode_1_8

		virtual const dng_1d_function & GammaFunction () const;
		
		/// Returns simple grayscale gamma 1.8 ICC profile

		virtual bool ICCProfile (uint32 &size,
								 const uint8 *&data) const;
		
		/// Static method for getting single global instance of this color space.

		static const dng_color_space & Get ();
	
	};

/*****************************************************************************/

/// \brief Singleton class for gamma 2.2 grayscale color space.

class dng_space_GrayGamma22: public dng_color_space
	{
	
	protected:
	
		dng_space_GrayGamma22 ();
		
	public:

		/// Returns dng_function_GammaEncode_2_2

		virtual const dng_1d_function & GammaFunction () const;
		
		/// Returns simple grayscale gamma 2.2 ICC profile

		virtual bool ICCProfile (uint32 &size,
								 const uint8 *&data) const;
		
		/// Static method for getting single global instance of this color space.

		static const dng_color_space & Get ();
	
	};

/*****************************************************************************/

class dng_space_fakeRGB: public dng_color_space
	{
	
	protected:
	
		dng_space_fakeRGB ();
		
	public:

		static const dng_color_space & Get ();
	
	};

/*****************************************************************************/

#endif

/*****************************************************************************/