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


pointLight [-decayRate int] [-discRadius linear] [-exclusive boolean] [-intensity float] [-name string] [-position linear linear linear] [-rgb float float float] [-rotation angle angle angle] [-shadowColor float float float] [-shadowDither float] [-shadowSamples int] [-softShadow boolean] [-useRayTraceShadows boolean]

pointLight is undoable, queryable, and editable.

The pointLight command is used to edit the parameters of existing pointLights, or to create new ones. The default behaviour is to create a new pointlight.

Return value

string Light shape name

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


ambientLight, directionalLight, exclusiveLightCheckBox, lightList, lightlink, spotLight, spotLightPreviewPort


decayRate, discRadius, exclusive, intensity, name, position, rgb, rotation, 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
-exclusive(-exc) boolean createqueryedit
This flag is obsolete.
-intensity(-i) float createqueryedit
intensity of the light (expressed as a percentage)
-name(-n) string createqueryedit
specify the name of the light
-position(-pos) linear linear linear createqueryedit
This flag is obsolete.
-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
-rgb(-rgb) float float float createqueryedit
color of the light (0-1)
-rotation(-rot) angle angle angle createqueryedit
This flag is obsolete.
-useRayTraceShadows(-rs) boolean createqueryedit
ray trace shadows

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