Go to: Synopsis. Return value. Related.
Flags. Python
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])
Note: Strings representing object names and
arguments must be separated by commas. This is not depicted in the
synopsis.
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.
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 |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
decay rate of the light (0-no decay, 1-slow, 2-realistic,
3-fast) |
|
discRadius(drs) |
linear |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
radius of the disc around the light |
|
exclusive(exc) |
boolean |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
intensity(i) |
float |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
intensity of the light (expressed as a percentage) |
|
name(n) |
string |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
specify the name of the light |
|
position(pos) |
[linear, linear, linear] |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
shadowColor(sc) |
[float, float, float] |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
shadowDither(sd) |
float |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
shadowSamples(sh) |
int |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
number of shadow samples. |
|
softShadow(ss) |
boolean |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
rgb(rgb) |
[float, float, float] |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
rotation(rot) |
[angle, angle, angle] |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
useRayTraceShadows(rs) |
boolean |
![create create](../gfx/create.gif) ![query query](../gfx/query.gif) ![edit edit](../gfx/edit.gif) |
|
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 have multiple arguments, passed
either as a tuple or a list. |
import maya.cmds as cmds
cmds.pointLight()