Go to: Synopsis. Return value. Related. Flags. MEL examples.


directionalLight [-decayRate int] [-discRadius linear] [-intensity float] [-name string] [-rgb float float float] [-shadowColor float float float] [-shadowDither float] [-shadowSamples int] [-softShadow boolean] [-useRayTraceShadows boolean]

directionalLight is undoable, queryable, and editable.

The directionalLight command is used to edit the parameters of existing directionalLights, or to create new ones. The default behaviour is to create a new directionallight.

Return value

stringLight shape name

In query mode, return type is based on queried flag.


ambientLight, exclusiveLightCheckBox, lightList, lightlink, pointLight, spotLight, spotLightPreviewPort


decayRate, discRadius, intensity, name, rgb, shadowColor, shadowDither, shadowSamples, softShadow, useRayTraceShadows
Long name (short name) Argument types Properties
-decayRate(-d) int createqueryedit
decay rate of the light (0-no decay, 1-slow, 2-realistic, 3-fast)
-discRadius(-drs) linear createqueryedit
radius of the disc around the light
-rgb(-rgb) float float float createqueryedit
color of the light (0-1)
-intensity(-i) float createqueryedit
intensity of the light (expressed as a percentage)
-name(-n) string createqueryedit
specify the name of the light
-useRayTraceShadows(-rs) boolean createqueryedit
ray trace shadows
-shadowColor(-sc) float float float createqueryedit
the shadow color
-shadowDither(-sd) float createqueryedit
dither the shadow
-shadowSamples(-sh) int createqueryedit
number of shadow samples.
-softShadow(-ss) boolean createqueryedit
soft shadow

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

// Create a directional light
string $light = `directionalLight -rotation 45 30 15`;

// Change the light intensity
directionalLight -e -intensity 0.5 $light;

// Query it
directionalLight -q -intensity $light;
// Result:0.5//