Interface for illuminant objects with configurable properties. More...

#include <IIlluminant.h>

Inheritance diagram for icmm::IIlluminant:

Public Member Functions
virtual void	SetWhitePoint (const icmm::CVarColor &whitePoint)=0
	Sets the white point for this illuminant.

virtual QString	GetIlluminantName () const =0
	Gets the human-readable name of this illuminant.

virtual void	SetIlluminantName (const QString &illuminantName)=0
	Sets the human-readable name for this illuminant.

virtual StandardIlluminant	GetIlluminantType () const =0
	Gets the standard illuminant type.

virtual void	SetIlluminantType (const StandardIlluminant &illuminantType)=0
	Sets the standard illuminant type.

Public Member Functions inherited from icmm::IWhitePointProvider
virtual icmm::CVarColor	GetWhitePoint () const =0
	Gets the white point as a color value.

Public Member Functions inherited from istd::IChangeable
virtual int	GetSupportedOperations () const
	Get set of flags for supported operations.

virtual bool	CopyFrom (const IChangeable &object, CompatibilityMode mode=CM_WITHOUT_REFS)
	Copy this object from another one.

virtual bool	IsEqual (const IChangeable &object) const
	Compare this object with another object.

virtual istd::TUniqueInterfacePtr< istd::IChangeable >	CloneMe (CompatibilityMode mode=CM_WITHOUT_REFS) const
	Make a copy of this object.

virtual bool	ResetData (CompatibilityMode mode=CM_WITHOUT_REFS)
	Reset data to its default state.

virtual void	BeginChanges (const ChangeSet &changeSet)
	Starts the change transaction.

virtual void	EndChanges (const ChangeSet &changeSet)
	Ends the change transaction.

virtual void	BeginChangeGroup (const ChangeSet &changeSet)
	Starts group of changes.

virtual void	EndChangeGroup (const ChangeSet &changeSet)
	Ends group of changes.

Public Member Functions inherited from istd::IPolymorphic
virtual	~IPolymorphic ()

Public Member Functions inherited from iser::ISerializable
virtual bool	Serialize (IArchive &archive)=0
	Load or store state of this object as a archive stream.

virtual quint32	GetMinimalVersion (int versionId) const
	Get minimal needed version to correct storing of this data.

Additional Inherited Members
Public Types inherited from istd::IChangeable
enum	ChangeFlags { CF_ACF_INTERNAL = 0 , CF_ALL_DATA , CF_ANY , CF_DESTROYING , CF_DELEGATED , CF_NO_UNDO }
	Data model change notification flags. More...

enum	SupportedOperations { SO_NONE = 0 , SO_OBSERVE = 1 << 0 , SO_COPY = 1 << 1 , SO_CLONE = 1 << 2 , SO_COMPARE = 1 << 3 , SO_RESET = 1 << 4 }
	Flags for supported operations. More...

enum	CompatibilityMode { CM_STRICT , CM_WITHOUT_REFS , CM_WITH_REFS , CM_CONVERT }
	Control how relationship betweeen objects are interpreted. More...

typedef QMultiMap< QByteArray, QVariant >	ChangeInfoMap

Static Public Member Functions inherited from istd::IChangeable
static const ChangeSet &	GetNoChanges ()
	Get empty set of changes.

static const ChangeSet &	GetAnyChange ()
	Get anonymous change set.

static const ChangeSet &	GetAllChanges ()
	Get anonymous change set.

static const ChangeSet &	GetDelegatedChanges ()
	Get delegated change set.

Protected Member Functions inherited from istd::IChangeable
virtual void	OnBeginChanges ()
	Callback function for begin change event.

virtual void	OnEndChanges (const ChangeSet &changeSet)
	Callback function for end change event.

Detailed Description

Interface for illuminant objects with configurable properties.

Purpose

IIlluminant extends IWhitePointProvider to represent a complete light source specification. It combines white point information with additional metadata like illuminant name and type, enabling proper color adaptation and device-independent color management.

Illuminant Concept

An illuminant represents:

Light source: The spectral power distribution of light
White point: The XYZ coordinates considered as "white"
Standard type: Predefined standard (D65, D50, A, etc.)
Name: Human-readable identifier

Standard Illuminant Types

Daylight illuminants:**

D65: 6504K daylight - standard for displays (sRGB, Rec. 709)
D50: 5003K daylight - standard for printing (ICC profiles)
D55: 5503K mid-morning daylight
D75: 7504K north sky daylight

Incandescent:**
A: 2856K tungsten lamp - household lighting

Fluorescent:**
F2: Cool white fluorescent - office lighting
F7: Broad-band daylight fluorescent
F11: Narrow-band white fluorescent

Special:**
E: Equal energy - theoretical reference
C: Average daylight (obsolete, replaced by D series)

Usage Examples

// Example 1: Creating and configuring an illuminant
icmm::CIlluminant* CreateD65Illuminant()
{
       icmm::CIlluminant* illuminant = new icmm::CIlluminant();
       
       // Set standard type
       illuminant->SetIlluminantType(icmm::StandardIlluminant::SI_D65);
       illuminant->SetIlluminantName("D65");
       
       // Set white point (D65 XYZ coordinates)
       icmm::CVarColor whitePoint(3);
       whitePoint.SetElement(0, 0.95047);  // X
       whitePoint.SetElement(1, 1.00000);  // Y (normalized to 1.0)
       whitePoint.SetElement(2, 1.08883);  // Z
       illuminant->SetWhitePoint(whitePoint);
       
       return illuminant;
}
 
// Example 2: Querying illuminant properties
void InspectIlluminant(const icmm::IIlluminant* illuminant)
{
       // Get type and name
       icmm::StandardIlluminant type = illuminant->GetIlluminantType();
       QString name = illuminant->GetIlluminantName();
       
       qDebug() << "Illuminant:" << name;
       
       // Get white point
       icmm::CVarColor wp = illuminant->GetWhitePoint();
       if (wp.GetElementsCount() >= 3) {
              qDebug() << "White Point XYZ:" 
                       << wp.GetElement(0) << wp.GetElement(1) << wp.GetElement(2);
       }
}
 
// Example 3: Chromatic adaptation between illuminants
icmm::CVarColor AdaptColor(const icmm::CVarColor& colorXyz,
                                            const icmm::IIlluminant* sourceIlluminant,
                                            const icmm::IIlluminant* destIlluminant)
{
       // Get white points
       icmm::CVarColor sourceWP = sourceIlluminant->GetWhitePoint();
       icmm::CVarColor destWP = destIlluminant->GetWhitePoint();
       
       // Apply chromatic adaptation transform
       // (Bradford, von Kries, etc.)
       // This ensures colors look consistent under different lighting
       
       icmm::CVarColor adaptedColor = colorXyz;
       // ... adaptation calculation ...
       
       return adaptedColor;
}
 
// Example 4: Display vs. print illuminants
void SetupColorManagement()
{
       // Display workflow (D65)
       icmm::CIlluminant displayIlluminant;
       displayIlluminant.SetIlluminantType(icmm::StandardIlluminant::SI_D65);
       displayIlluminant.SetIlluminantName("D65");
       
       // Print workflow (D50)
       icmm::CIlluminant printIlluminant;
       printIlluminant.SetIlluminantType(icmm::StandardIlluminant::SI_D50);
       printIlluminant.SetIlluminantName("D50");
       
       // Colors need adaptation when going from display to print
       bool needsAdaptation = 
              (displayIlluminant.GetIlluminantType() != 
               printIlluminant.GetIlluminantType());
}
 
// Example 5: Working with tristimulus specifications
void CreateColorSpecification(icmm::IIlluminant* illuminant)
{
       // Illuminants are used in tristimulus specifications
       // to define the viewing conditions for color spaces
       
       // Create RGB specification with illuminant
       // icmm::CTristimulusSpecification spec;
       // spec.SetIlluminant(std::shared_ptr<IIlluminant>(illuminant));
       
       // This specification can then be used with RGB color models
       // to ensure accurate, device-independent color
}
 
// Example 7: Illuminant selection helper
icmm::StandardIlluminant SelectIlluminant(const QString& purpose)
{
       if (purpose == "display" || purpose == "web") {
              return icmm::StandardIlluminant::SI_D65;
       } else if (purpose == "print") {
              return icmm::StandardIlluminant::SI_D50;
       } else if (purpose == "photography") {
              return icmm::StandardIlluminant::SI_D65;  // or D50 for some workflows
       } else if (purpose == "tungsten") {
              return icmm::StandardIlluminant::SI_A;
       }
       
       return icmm::StandardIlluminant::SI_D65;  // Default
}