CemitterPair

C++	Python
Cmaxwell::CmultiValue::CemitterPair	CemitterPair

Class used to set the emitter pair when the emission type is set to Color + Luminance.

Emitters can be defined:

1. Using color + luminance.
2. Using Temperature of emission.
3. Using an MXI texture.

When emitters are set using color + luminance the color can be set:

1.1.a Using RGB color
1.1.b Using Correlated Temperature color

When emitters are set using color + luminance the luminance can be set:

1.2.a Using Watts and efficacy
1.2.b LuminousPower (Lumen)
1.2.c illuminance (Lumen/m2)
1.2.d luminousIntensity (Cd)
1.2.b luminance (Cd/m2)

Cmaxwell::CmultiValue::CemitterPair is used to read/write each parameter.

Methods

Name	Description
CemitterPair	Class constructor.

Properties --TODO-- revisar

	Name	Description
Crgb	rgb	Color. Cmaxwell::CmaterialEmitter::Cpair::pEmissionColor = "rgb".
Cxyz	xyz	Correlated temperature color. Cmaxwell::CmaterialEmitter::Cpair::pEmissionColor = "xyz".
real	temperature	Temperature color. Cmaxwell::CmaterialEmitter::Cpair::pEmissionColor = "temperature".
real	watts	Luminance. Cmaxwell::CmaterialEmitter::Cpair::pLuminance = "wattsAndLuminousEfficacy" and Cmaxwell::CmaterialEmitter::Cpair::pEmissionColor = "rgb" or "xzy".
real	luminousEfficacy	Luminance. Cmaxwell::CmaterialEmitter::Cpair::pLuminance = "wattsAndLuminousEfficacy"and Cmaxwell::CmaterialEmitter::Cpair::pEmissionColor = "rgb" or "xzy".
real	luminousPower	Luminance. Cmaxwell::CmaterialEmitter::Cpair::pLuminance = "luminousPower" and Cmaxwell::CmaterialEmitter::Cpair::pEmissionColor = "rgb" or "xzy".
real	illuminance	Luminance. Cmaxwell::CmaterialEmitter::Cpair::pLuminance = "illuminance" and Cmaxwell::CmaterialEmitter::Cpair::pEmissionColor = "rgb" or "xzy".
real	liminousIntensity	Luminance. Cmaxwell::CmaterialEmitter::Cpair::pLuminance = "luminousIntensity" and Cmaxwell::CmaterialEmitter::Cpair::pEmissionColor = "rgb" or "xzy".
real	luminance	Luminance. Cmaxwell::CmaterialEmitter::Cpair::pLuminance = "lluminance" and Cmaxwell::CmaterialEmitter::Cpair::pEmissionColor = "rgb" or "xzy".

Examples

C++

// Create and fill an emitter pair.
 
Cmaxwell::CmultiValue::CemitterPair emitterPair;
emitterPair.rgb.assign( rgb_color ); // We will use this color.
emitterPair.xyz.assign( xyz_color );
emitterPair.temperature = 6500.0;
emitterPair.watts = 40.0;
emitterPair.luminousEfficacy = 17.6;
emitterPair.luminousPower = 100.0;   // We will use this luminance.
emitterPair.illuminance = 100.0;
emitterPair.luminousIntensity = 100.0;
emitterPair.luminance = 100.0;

// Apply the emitter pair to the emitter.
 
 newEmitter.setPair( emitterPair );

// Create and fill a material emitter pair (not emitter pair!).
  
Cmaxwell::CmaterialEmitter::Cpair pair;
pair.pEmissionColor = "rgb";
pair.pLuminance = "luminousPower";

// Tell the emitter what parameters of the emitter pair use.
 
newEmitter.setActivePair( pair );

Python

# Create and fill an emitter pair.
emitterPait = CemitterPair();
emitterPair.rgb.assign( rgb_color ); # We will use this color.
emitterPair.xyz.assign( xyz_color );
emitterPair.temperature = 6500.0;
emitterPair.watts = 40.0;
emitterPair.luminousEfficacy = 17.6;
emitterPair.luminousPower = 100.0;   # We will use this luminance.
emitterPair.illuminance = 100.0;
emitterPair.luminousIntensity = 100.0;
emitterPair.luminance = 100.0;

# Apply the emitter pair to the emitter.
  
newEmitter.setPair( emitterPair );

# Create and fill a material emitter pair (not emitter pair!).
  
pair = Cpair();
pair.pEmissionColor = "rgb";
pair.pLuminance = "luminousPower";

# Tell the emitter what parameters of the emitter pair use.
  
newEmitter.setActivePair( pair );