pymel.core.rendering.ambientLight¶

ambientLight(*args, **kwargs)¶

The ambientLight command is used to edit the parameters of existing ambientLights, or to create new ones. The default behaviour is to create a new ambientlight.

Maya Bug Fix:

• name flag was ignored

Flags:

Long Name / Short Name		Argument Types	Properties
ambientShade / ambientShade		float
	ambientShade
discRadius / drs		float
	radius of the disc around the light
exclusive / exc		bool
intensity / i		float
	intensity of the light (expressed as a percentage)
name / n		unicode
	specify the name of the light
position / pos		float, float, float
rgb / rgb		float, float, float
	color of the light (0-1)
rotation / rot		float, float, float
shadowColor / sc		float, float, float
	the shadow color
shadowDither / sd		float
	dither the shadow
shadowSamples / sh		int
	number of shadow samples.
softShadow / ss		bool
	soft shadow
useRayTraceShadows / rs		bool
	ray trace shadows Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.ambientLight

Example:

import pymel.core as pm

# Create an ambientLight light
light = pm.ambientLight(intensity=0.8)

# Change the light intensity
pm.ambientLight( light, e=True, intensity=0.5 )

# Query it
pm.ambientLight( light, q=True, intensity=True )
# Result: 0.5 #