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

Synopsis

pointLight([decayRate=int], [discRadius=float], [edit=boolean], [exclusive=boolean], [intensity=float], [name=string], [position=[float, float, float]], [query=boolean], [rgb=[float, float, float]], [rotation=[float, float, float]], [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.

Flags

decayRate, discRadius, edit, exclusive, intensity, name, position, query, rgb, rotation, shadowColor, shadowDither, shadowSamples, softShadow, useRayTraceShadows
Long name (short name) [argument types] Properties
edit(e) boolean edit
Puts the command in edit mode so that it will change the values of the specified flags.
query(q) boolean query
Puts the command in query mode so that it will return the value of the specified flag.

In query mode, this flag needs a value.

decayRate(d) int createqueryedit
decay rate of the light (0-no decay, 1-slow, 2-realistic, 3-fast)

In query mode, this flag needs a value.

discRadius(drs) float createqueryedit
radius of the disc around the light

In query mode, this flag needs a value.

exclusive(exc) boolean createqueryedit
This flag is obsolete.

In query mode, this flag needs a value.

intensity(i) float createqueryedit
intensity of the light (expressed as a percentage)

In query mode, this flag needs a value.

name(n) string createqueryedit
specify the name of the light

In query mode, this flag needs a value.

position(pos) [float, float, float] createqueryedit
This flag is obsolete.

In query mode, this flag needs a value.

shadowColor(sc) [float, float, float] createqueryedit
the shadow color

In query mode, this flag needs a value.

shadowDither(sd) float createqueryedit
dither the shadow

In query mode, this flag needs a value.

shadowSamples(sh) int createqueryedit
number of shadow samples.

In query mode, this flag needs a value.

softShadow(ss) boolean createqueryedit
soft shadow

In query mode, this flag needs a value.

rgb(rgb) [float, float, float] createqueryedit
color of the light (0-1)

In query mode, this flag needs a value.

rotation(rot) [float, float, float] createqueryedit
This flag is obsolete.

In query mode, this flag needs a value.

useRayTraceShadows(rs) boolean createqueryedit
ray trace shadows

In query mode, this flag needs a value.


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.

Return value


[string] (light name)

Related

ambientLight, directionalLight, exclusiveLightCheckBox, lightList, lightListEditor, lightListPanel, lightlink, projectLight, projectLightEditor, spotLight, spotLightPreviewPort

Python examples

import maya.cmds as cmds

cmds.pointLight()