Description
This class allows you to manipulate emitter components. Each material layer can contain one emitter. See here for a description of the Maxwell emitter mode.
Texturable attributes: mxi (AttrType_Double
, value used as intensity multiplier when textured, ignored when not textured).
Base class: MaxwellMayaMaterialComponent
.
Methods
void | Destroy() |
void | SetEnabled(bool enabled) |
bool | GetEnabled() const |
void | SetEmissionType(EmissionType type) |
EmissionType | GetEmissionType() const |
void | SetColorType(ColorType type) |
ColorType | GetColorType() const |
void | SetRGBColor(const MFloatVector& color) |
void | GetRGBColor(MFloatVector& color) const |
void | SetCorrelatedColor(double temperature) |
double | GetCorrelatedColor() const |
void | SetOutputType(OutputType type) |
OutputType | GetOutputType() const |
void | SetWatts(double watts) |
double | GetWatts() const |
void | SetEfficacy(double efficacy) |
double | GetEfficacy() const |
void | SetLuminance(double luminance) |
double | GetLuminance() const |
void | SetIES(const MString& file, double intensity) |
void | GetIES(MString& file, double& intensity) const |
void | SetTemperature(double temperature) |
double | GetTemperature() const |
Inherited methods |
void Destroy()
Destroys the emitter, removing it from the parent layer.
Anchor | ||||
---|---|---|---|---|
|
bool GetEnabled() const
Emitters can be disabled, in which case they do not participate in rendering in any way.
Attribute name: enabled (AttrType_Bool
).
Anchor | ||||
---|---|---|---|---|
|
EmissionType GetEmissionType() const
Maxwell supports the following types of emitters:
EmissionType_ColorLuminance
: an analytic model based on color and luminance.EmissionType_Temperature
: the emitter is defined by a single value called emission temperature which controls both the color and intensity of the light.EmissionType_MXI
: texture-based emission.
See here for a more in-depth explanation of the three types.
Attribute name: emissionType (AttrType_Int
).
Anchor | ||||
---|---|---|---|---|
|
ColorType GetColorType() const
When the emitter type is set to EmissionType_ColorLuminance
, this attribute controls how the light color is specified:
ColorType_RGB
: as a RGB value.ColorType_Correlated
: as a color temperature value.
See here for details.
Attribute name: colorType (AttrType_Int
).
Anchor | ||||
---|---|---|---|---|
|
void GetRGBColor(MFloatVector& color) const
This attribute represents the emission color when the emitter type is set to EmissionType_ColorLuminance
and the color type is set to ColorType_RGB
. The Python version of SetRGBColor
takes the red, green and blue values as separate arguments, while GetRGBColor
returns the color as a 3-tuple.
Attribute name: colorRGB (AttrType_Color
).
Anchor | ||||
---|---|---|---|---|
|
double GetCorrelatedColor() const
This attribute controls the emission color when the emitter type is set to EmissionType_ColorLuminance
and the color type is set to ColorType_Correlated
.
Attribute name: colorCorrelated (AttrType_Double
).
Anchor | ||||
---|---|---|---|---|
|
OutputType GetOutputType() const
This attribute controls how the output intensity is defined:
OutputType_WattsEfficacy
: wattage and luminous efficacy values.OutputType_LuminousPower
: value in lumens.OutputType_Illuminance
: value in lux (lumens/sqm).OutputType_LuminousIntensity
: value in candelas.OutputType_Luminance
: value in nits (candelas/sqm).OutputType_IES
: an IES file is used to define spread and intensity.
This page contains more details about the output types.
Attribute name: outputType (AttrType_Int
).
Anchor Watts Watts
void SetWatts(double watts)
double GetWatts() const
Watts | |
Watts |
This attribute specifies the emission power in watts when the emitter type is set to EmissionType_ColorLuminance
and the output type is set to OutputType_WattsEfficacy
.
Attribute name: watts (AttrType_Double
).
Anchor Efficacy Efficacy
void SetEfficacy(double efficacy)
double GetEfficacy() const
Efficacy | |
Efficacy |
This attribute specifies the luminous efficacy when the emitter type is set to EmissionType_ColorLuminance
and the output type is set to OutputType_WattsEfficacy
.
Attribute name: efficacy (AttrType_Double
).
Anchor | ||||
---|---|---|---|---|
|
double GetLuminance() const
This attribute specifies the luminance value when the emitter type is set to EmissionType_ColorLuminance
and the output type is set to OutputType_LuminousPower
, OutputType_Illuminance
, OutputType_LuminousIntensity
or OutputType_Luminance
.
Attribute name: luminance (AttrType_Double
).
Anchor | ||||
---|---|---|---|---|
|
void GetIES(MString& file, double& intensity) const
Control the IES file and intensity multiplier when the emitter type is set to EmissionType_ColorLuminance
and the output type is set to OutputType_IES
. The intensity argument is optional in the Python version of SetIES
and defaults to 1 if not present. GetIES
takes no arguments in Python and returns the values as a 2-tuple.
Attribute names: iesFile (AttrType_String
), iesIntensity (AttrType_Double
).
Anchor | ||||
---|---|---|---|---|
|
double GetTemperature() const
This attribute represents the emission temperature when the emitter type is set to EmissionType_Temperature
. Not to be confused with the correlated color attribute, which only controls the emission color when the type is set to EmissionType_ColorLuminance
. This attribute defines both the emission color and the intensity.
Attribute name: temperature (AttrType_Double
).