spotLight

Go to: Related nodes. Attributes.

This class contains the "shape" information for spot lights.

This node is MP safe

Related nodes

camera, light, dropoffLocator, ambientLight, nonAmbientLightShapeNode, nonExtendedLightShapeNode, areaLight, directionalLight, pointLight

Attributes (85)

The following quick index only shows top-level attributes (too many attributes to show them all): barnDoors, bottomBarnDoor, coneAngle, dropoff, endDistance1, endDistance2, endDistance3, farPointWorld (3), fogGeometry, fogIntensity, fogSpread, leftBarnDoor, lightGlow, mentalRayControls (51), objectType, penumbraAngle, pointWorld (3), psIllumSamples, rayDirection (3), rightBarnDoor, startDistance1, startDistance2, startDistance3, topBarnDoor, useDecayRegions

Long name (short name)	Type	Default	Flags
coneAngle (ca)	angle (double)	40.0deg
The cone angle.
penumbraAngle (pa)	angle (double)	0.0deg
The penumbra angle.
dropoff (dro)	double	0.0
The dropoff.
barnDoors (bd)	bool	false
Are barndoors on?
leftBarnDoor (lbd)	angle (double)	20.0deg
The left barn door angle.
rightBarnDoor (rbd)	angle (double)	20.0deg
The right barn door angle.
topBarnDoor (tbd)	angle (double)	20.0deg
The top barn door angle.
bottomBarnDoor (bbd)	angle (double)	20.0deg
The bottom barn door angle.
useDecayRegions (udr)	bool	false
Are decayregions on?
startDistance1 (sd1)	distance (float)	1.0cm
The start distance of decay region 1.
endDistance1 (ed1)	distance (float)	2.0cm
The end distance of decay region 1.
startDistance2 (sd2)	distance (float)	3.0cm
The start distance of decay region 2.
endDistance2 (ed2)	distance (float)	6.0cm
The end distance of decay region 2.
startDistance3 (sd3)	distance (float)	8.0cm
The start distance of decay region 3.
endDistance3 (ed3)	distance (float)	10.0cm
The end distance of decay region 3.
fogSpread (fsp)	float	1.0
The fog spread.
fogIntensity (fin)	float	1.0
The fog intensity.
objectType (ot)	char	TrenderableObjectType::kSurface
The type of object being lit (volume or surface).
pointWorld (pw)	float3	1.0, 1.0, 1.0
The start point of the interval produced by the viewing ray and the shadow map, in world space.
pointWorldX (tx) float 0.0 The x-component of the world position.
pointWorldY (ty) float 0.0 The y-component of the world position.
pointWorldZ (tz) float 0.0 The z-component of the world position.
farPointWorld (fw)	float3	1.0, 1.0, 1.0
The end point of the interval produced by the viewing ray and the shadow map, in world space.
farPointWorldX (fx) float 0.0 The x-component of the world far-position.
farPointWorldY (fy) float 0.0 The y-component of the world far-position.
farPointWorldZ (fz) float 0.0 The z-component of the world far-position.
rayDirection (rad)	float3
The Ray direction.
rayDirectionX (rdx) float 0.0 The x component of the direction.
rayDirectionY (rdy) float 0.0 The y component of the direction.
rayDirectionZ (rdz) float 0.0 The z component of the direction.
fogGeometry (fg)	Message	n/a
Connect this to the fog geometry.
lightGlow (lg)	Message	n/a
Connect this to the light glow.
psIllumSamples (pis)	short	1
The number of particle illumination samples
mentalRayControls (mrc)	compound	n/a
This is a root of following mental ray attributes.
miExportMrLight (milt) bool false Controls usage of default mayabase light shader, which is used by default. If enabled, the mayabase light shader will not be applied at all but any connected custom mental ray node will.
miLightShader (mils) generic typed data NULL Port to connect custom mental ray node of type light shader.
miPhotonEmitter (mipe) generic typed data NULL Port to connect custom mental ray node of type photon emitter shader.
emitPhotons (phot) bool false Enable photon emission for the light.
energy (eng) float3 Determines photon energy for the light. energy is a product of Photon color and Photon intensity Photon Color is available in UI only, and is not a real attribute. energyR (engr) float 8000 The red component of the photon energy energyG (engg) float 8000 The green component of the photon energy energyB (engb) float 8000 The blue component of the photon energy
photonIntensity (phi) float 1 Photon intensity factor for the photon energy color to determine photon energy for the light. Should be changed through the UI only.
exponent (exp) float 2 Photon energy falloff. Values other than 2 produce non-physically correct indirect illumination.
causticPhotons (cph) integer 10000 Caustic photons to emit (actually store) from the light.
globIllPhotons (gph) integer 10000 Global illumination photons to emit (actually store) from the light.
shadowMap (usm) bool false Turn on mental ray shadowmap creation for the light.
smapResolution (smr) integer 256 Resolution (both width and height) of the shadowmap for mental ray.
smapSamples (smsa) short 1 Number of shadowmap samples to be taken if smapSoftness is greater zero. mental ray only.
smapSoftness (smso) float 0 The mental ray shadowmap softness for the light. If greater zero, oversampling will be used to produce blurry shadows.
smapBias (smb) float 0 Controls mental ray shadow map bias. It is a factor on the internal bias value. If smapBias is 0, the Woo algorithm (mid dist shadowmap) is enabled, and the bias is not used.
smapCamera (smc) Message n/a For internal use only.
smapFilename (smf) string NULL If not empty, enable shadowmap file creation with that name for mental ray.
smapLightName (smln) bool 0 Include the light name in the shadow map name.
smapSceneName (smsn) bool 0 Include the scene name in the shadow map name.
smapFrameExt (smfe) bool 0 Include the frame extention in the shadow map name.
smapDetail (smd) bool 0 Use mental ray detail shadow map for this light. shadowMap must be enabled. This algorithm is a combination of standard shadowmaps and ray traced shadows. Unlike standard shadowmaps, the detail shadowmap algorithm invokes shadow shaders at intersection points with shadow-casting geometry In general, detail shadowmaps need less resolution than standard shadowmaps, since they may take more samples per pixel. Still, detail shadowmaps tend to be more expensive to compute than standard shadowmaps because of the shadow shader calls. They may even be more expensive than raytraced shadows. However, their cost may be offset by repeated reuse over several frames. They may also be more efficient with time and memory resources than raytraced shadows for motion blurred shadows. The file format used to store detail shadowmaps is incompatible with the file format used to store regular shadowmaps. The entire file format is tile-based and only those tiles computed or used during a rendering will be stored in the file. New tiles may be dynamically added during rendering of new frames. Detail shadowmap files tend to be larger than regular shadowmap files since more information per pixel is stored.
smapDetailSamples (sds) short 0 Specify the number of samples per pixel taken when computing a mental ray detail shadowmap pixel. A value of n means that nxn samples are taken per pixel, each involving a shadow intersection including a shadow shader call at some varying subpixel coordinate inside the shadowmap pixel. If smapDetailSamples is set to 0, mental ray default value is used.
smapDetailAccuracy (sdac) float 0 This parameter determines how far two depth values of a sample have to be separated in order to be considered two distinct values. Selecting this value too small will result in larger memory and compute resource requirements for detail shadowmaps. Selecting it too large will lead to visible artifacts. mental ray tries to use a reasonable default value for the accuracy. If smapDetailAccuracy is set to 0, mental ray default value is used.
smapDetailAlpha (sdal) bool 0 If smapDetailAlpha is set, then only the intensity values of the color transmission coeffiencents are used.
useShadowMapCamera (usmc) bool 0 Mimic non depth map auto focus in mental ray with shadow map camera
smapCameraAperture (smca) float 1 The shadow map camera aperture
smapCameraResolution (smcr) float 1 The shadow map camera resolution
smapCameraAspect (smcs) float 1 The shadow map camera aspect
smapCameraName (smcn) string NULL The shadow map camera name
smapCameraFocal (smcf) string NULL The shadow map camera focal length in inch
areaLight (algt) bool false Enable mental ray area light attributes for the light.
areaType (atyp) enum 0 "Rectangle" Type to determine the shape of the area light.
areaNormal (ano) float3 Normal vector to control direction of rectangle and disk area lights. areaNormalX (anox) float 0 X component of areaNormal areaNormalY (anoy) float 2 Y component of areaNormal areaNormalZ (anoz) float 0 Z component of areaNormal
areaEdge (aed) float3 Edge vector to control direction of rectangle and cylinder area lights. areaEdgeX (aedx) float 2 X component of areaEdge areaEdgeY (aedy) float 0 Y component of areaEdge areaEdgeZ (aedz) float 0 Z component of areaEdge
areaRadius (arad) float 2 Radius to control size of disk, sphere, and cylinder area lights.
areaSampling (asa) short2 Area light sample values for primary light sampling. areaSamplingU (asau) short 3 U component of areaSampling areaSamplingV (asav) short 3 V component of areaSampling
areaLowLevel (alev) short 0 Area light tracing level to switch to lower sampling.
areaLowSampling (alo) short2 Area light sample values for lower light sampling. areaLowSamplingU (alou) short 2 U component of areaLowSampling areaLowSamplingV (alov) short 2 V component of areaLowSampling
areaVisible (avis) bool false Control primary visibility of the area light shape.