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.

Return value

stringLight 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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds