Photometric Lights Common Properties, Operators, and Methods

The following properties apply only to the Photometric Light types: FreePoint, FreeLinear, FreeArea, TargetPoint, TargetLinear and TargetArea

.type Name default: #Free_Point -- string

the valid type values are:

#Free_Area

#Free_Linear

#Free_Point

#Target_Area

#Target_Linear

#Target_Point

?

.on Boolean default: true -- boolean

Toggle the light on/off

.includeList UndefinedClass default: undefined --

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.

.excludeList Array default: #()

Get/Set the exclusion list as an array on objects. When setting the value, the Include/Exlude option will be set to Exclude.

.light_color Color default: (color 255 255 255)

The color of the light. Same as the .RGB or .Color property.

.rgb Color default: (color 255 255 255) -- RGB color; color

The RGB color of the light

.affectDiffuse Boolean default: true -- boolean

When true, the light affects the diffuse color.

.affectSpecular Boolean default: true -- boolean

When true, the light affects the specular color.

.ambientOnly Boolean default: false -- boolean

When set to true, the light affects the Ambient color only.

.softenDiffuseEdge Float default: 0.0 -- float

Get/Set the Soften Diff. Edge value.

.diffuse_soften Float default: 0.0

Get/Set the Soften Diff. Edge value.

.light_contrast Float default: 0.0

Get/Set the Light Contrast value. Corresponds to the Contrast value in the Advanced Effects rollout in the UI. Same as .contrast

.contrast Float default: 0.0 -- float

Get/Set the Light Contrast value. Corresponds to the Contrast value in the Advanced Effects rollout in the UI. Same as .light_contrast

.filter_color Color default: (color 255 255 255)

Get/Set the filter color. Same as .rgbFilter.

.rgbFilter Color default: (color 255 255 255) -- RGB color

The RGB Filter color

.flux Float default: 0.0 -- float

Set the intensity in lm.

.intensity Float default: 1500.0

Get/Set the Intensity value in cd.

.intensityAt Float default: 1.0 -- float

Get/Set the Distance at which the intensity in fc is measured.

.intensityType Integer default: 1 -- integer

Get/Set the Intensity type, where

0 - lm

1 - cd

2 - fc

.kelvin Float default: 3600.0 -- float

The light color temperature in Kelvin.

.useKelvin Boolean default: false -- boolean

When true, the color temperature in Kelvin will be used. When false, the RGB Color will be used instead.

.multiplier Float default: 100.0

The intensity multiplier value.

.useMultiplier Boolean default: false -- boolean

The intensity multiplier value.

.originalFlux Float default: 0.0 -- float

.originalIntensity Float default: 0.0 -- float

?

.castShadows Boolean default: true -- boolean

Toggle shadow casting on/off.

.useGlobalShadowSettings Boolean default: false -- boolean

When true, use the Global Shadow settings.

.shadow_color Color default: (color 0 0 0)

Get/Set the shadow color value.

.shadowColor Color default: (color 0 0 0) -- RGB color

Get/Set the shadow color.

.shadow_density Float default: 1.0

Get/Set the shadow density value.

.twoSidedShadows Boolean default: true -- boolean

Toggle two-sided shadows on/off

.lightAffectsShadow Boolean default: false -- boolean

When true, the light affects the shadow color.

.shadowColorMapEnable Boolean default: false -- boolean

Toggle the Color map switch.

.shadowGenerator shadowMap default: shadowMap:shadowMap -- SubAnim

The shadow generator class used by the light. Can be a shadowMap , raytraceShadow , Adv__Ray_traced or Area_Shadows class instance.

.shadowGeneratorByName String default: "Shadow Map" -- string

Enter "Shadow Map" for shadow maps; "Ray Traced Shadows" for ray traced shadows etc.

.shadowMultiplier Float default: 1.0 -- float

Get/Set the shadow multiplier value.

.shadowProjectorMap UndefinedClass default: undefined

Get/Set the shadow Projector Map

.raytracedShadows Boolean default: false -- boolean

Note:

This property should not be used in 3ds Max 5. Please use the .shadowGenerator property to assign a shadow generator.

.atmosShadows Boolean default: false -- boolean

Toggle atmosphere shadows on/off.

.atmosOpacity Float default: 100.0 -- float

Get/Set the atmosphere shadows opacity value. Same as .atmospheric_opacity

.atmospheric_opacity Float default: 100.0

Get/Set the atmosphere shadows opacity value. Same as .atmosOpacity.

.atmosColorAmt Float default: 100.0 -- float

Get/Set the atmosphere shadows color value. Same as .atmospheric_color_amount

.atmospheric_color_amount Float default: 100.0

Get/Set the atmosphere shadows color value.

.projector Boolean default: false -- boolean

Toggle the projector map on/off.

.projectorMap UndefinedClass default: undefined --

Get/Set the projector map.

.showCone Boolean default: false -- boolean

Toggle cone display of targeted lights on/off

.beam_angle Float default: 30.0

Get/Set the Hotspot/Beam angle value.

.hotSpot Float default: 30.0 -- float

Get/Set the hotspot value when using Spotlight distribution.

.falloff Float default: 60.0 -- float

The Falloff value. Same as .field_angle

.field_angle Float default: 60.0

The Field angle value. Same as falloff.

.target_distance Float default: 240.0

Get the target distance of targeted lights and lights with spotlight distribution.

.targetDistance Float default: 240.0 -- float

Get/Set the target distance of targeted lights and lights with spotlight distribution.

.light_length Float default: 39.3701

Get/Set the length of Linear and Area Lights

.light_width Float default: 39.3701

Get/Set the width of Area Lights

.webFile Name default: #

The Web file used when distribution is set to Web.

.xRotation Float default: 0.0 -- float

.yRotation Float default: 0.0 -- float

.zRotation Float default: 0.0 -- float

The Photometric Web rotation values

The following interface is explosed by all Photometric Light types:

Interface: LightProperties

Properties:

.excludeList : value : Read|Write

Get/Set the Exclude List

.includeList : value : Read|Write

Get/Set the Include List

.shadowGenerator : value : Read|Write

Get/Set the Shadow Generator as class instance

.shadowGeneratorByName : value : Read|Write

Get/Set the Shadow Generator by name

.raytracedShadows : value : Read|Write

Get/Set use of raytraced shadows

.color : color by value : Read|Write

Get/Set the color

.enabled : bool : Read|Write

Get/Set the enabled state.

See also

Free_Area : Light

Free_Linear : Light

Free_Point : Light

Target_Area : Light

Target_Linear : Light

Target_Point : Light

Node Common Properties, Operators, and Methods

MAXWrapper Common Properties, Operators, and Methods

Value Common Properties, Operators, and Methods