Value > MAXWrapper > Node > Photometric Lights > Common Properties and Methods |
In 3ds Max 2009 and higher, all Photometric Lights share the same set of properties.Every Photometric Light type can be freely switched to any other type. See the .type property in the LightProperties interface.
See Photometric Light Classes for details.
Toggle shadow casting on and off.
<Photometric_Light>.useGlobalShadowSettings BooleanClass default: false -- boolean; Use_Global_Params
When set to true, the shadow generator will use the global shadow settings. When set to false, the local settings will be used.
Get/Set the Shadow Generator as class instance.
Exposed by the LightProperties interface.
Get/Set the Shadow Generator by name.
Exposed by the LightProperties interface.
Get/Set use of raytraced shadows. Exposed by the LightProperties interface.
This property should not be used in 3ds Max 5 and higher. Please use the .shadowGenerator property to assign a shadow generator.
The property is exposed for backwards compatibility only. In versions prior to 3ds Max 5, the only possible shadow generator types were Shadow Maps and Raytraced Shadows. Setting this property will switch the shadow generator internally. Currently, the number of possible shadow generators is much higher (including 3 rd party plug-ins), so this property is obsolete.
Get/Set the exclusion list as an array on objects. When setting the value, the Include/Exlude option will be set to Exclude.
Exposed by the LightProperties interface .
Get/Set an array of objects to be included in the illumination by the light. When setting the value, the Include/Exlude option will be set to Include.
Exposed by the LightProperties interface.
Get/Set the distribution type.
1 -Spotlight (not valid for Sphere and Cylinder types)
2 -Uniform Hemispherical (not valid for Sphere and Cylinder types)
3 -Photometric Web File (not valid for Sphere and Cylinder types)
Exposed by the LightProperties interface .
Intensity/Color/Attenuation Rollout
The RGB Color of the light. Alias for .rgb and .Light_Color.
Exposed by the LightProperties interface .
Get/set the state of the Kelvin/Color radio button. When set to true , the color temperature in Kelvin will be used. When false , the RGB Color will be used instead.
Get/Set the Distance at which the intensity is measured when .intensityType is set to 2 - lx at.
Get/set the state of the Dimming checkbox.
Get/set the Dimming multiplier value in percent.
<Photometric_Light>.shiftColorWhenDimming BooleanClass default: false -- boolean; Shift_Color_When_Dimming
Get/set the state of the "Incandescent lamp color shift when dimming" checkbox.
Get/set the state of the Use Far Attenuation checkbox.
<Photometric_Light>.displayFarAttenuationGizmo BooleanClass default: false -- boolean; Display_Far_Attenuation_Gizmo
Get/set the state of the Show Far Attenuation checkbox.
<Photometric_Light>.startFarAttenuation Float default: 80.0 -- animatable; worldUnits; Start_Far_Attenuation
Get/Set the Type of the Photometric Light.
Exposed by LightProperties interface .
Get/set the length of thearea light where applicable.
Get/set the width of thearea light where applicable.
Get/set the radius of thearea light where applicable.
Distribution (Spotlight) Rollout
Get/set the state of the "Cone visible in viewport when unselected" checkbox.
Get/set the Hotspot/Beam angle. Used only when .distribution is set to 1 - Spotlight.
Get/set the Hotspot/Beam angle. Used only when .distribution is set to 1 - Spotlight.
Distribution (Photometric File) Rollout
The Web file used when.distribution is set to0 -Web.
The Photometric Web X rotation value.Used only when .distribution is set to 0 - Web.
The Photometric Web Y rotation value.Used only when .distribution is set to 0 - Web.
ThePhotometric WebZrotation value.Used only when .distribution is set to 0 - Web.
<Photometric_Light>.shadowColor Color default: (color 0 0 0) -- animatable; RGB color; Shadow_Color; Controller Scaling: ([1,1,1] : (color 255 255 255))
Get/set the shadow color value.
Get/set the Shadow Density value.
<Photometric_Light>.shadowColorMapEnable BooleanClass default: false -- boolean; Use_Shadow_Color_Map
Get/set the state of the Shadow Map enable checkbox.
<Photometric_Light>.shadowProjectorMap UndefinedClass default: undefined -- texturemap; Shadow_Projector_Map
Get/set the Shadow Projector Map.
Get/set the state of the "Light Affects Shadow Color" checkbox.
Get/Set the Light Contrast value.
Get/Set the Soften Diff. Edge value.
When true , the light affects the diffuse color.
When true , the light affects the specular color.
The following interface is explosed by all Photometric Lights:
Get/Set the Type of the Photometric Light.
1 -Spotlight (not valid for Sphere and Cylinder types)
2 -Uniform Hemispherical (not valid for Sphere and Cylinder types)
3 -Photometric Web File (not valid for Sphere and Cylinder types)
Get/Set the exclusion list as an array on objects. When setting the value, the Include/Exlude option will be set to Exclude.
Get/Set an array of objects to be included in the illumination by the light. When setting the value, the Include/Exlude option will be set to Include.
Get/Set the Shadow Generator as class instance.
Get/Set the Shadow Generator by name.
Get/Set use of raytraced shadows.
This property should not be used in 3ds Max 5and higher. Please use the .shadowGenerator property to assign a shadow generator.
The property is exposed for backwards compatibility only. In versions prior to 3ds Max 5, the only possible shadow generator types were Shadow Maps and Raytraced Shadows. Setting this property willswitch the shadow generator internally. Currently, the number of possible shadow generators is much higher (including 3 rd party plug-ins), so this property is obsolete.