nonExtendedLightShapeNode

Show frames

Go to: Related nodes. Attributes.

This class is the abstract class that describes nonExtended lights (e.g., spot, point lights). Non-extended lights are lights which are not correctly represented physically, and are lights which disseminate from a single point source or direction (which there are no such things in the real world), and requires no numerical integration evaluations during shading of a point. Extended lights tends to be more physically accurate, which includes lights such as linear + area lights.

This node is abstract

Related nodes

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

Attributes (31)

castSoftShadows, dmapBias, dmapFarClipPlane, dmapFilterSize, dmapFocus, dmapFrameExt, dmapLightName, dmapName, dmapNearClipPlane, dmapResolution, dmapSceneName, dmapUseMacro, dmapWidthFocus, fogShadowIntensity, lastWrittenDmapAnimExtName, lightRadius, receiveShadows, reuseDmap, useDepthMapShadows, useDmapAutoClipping, useDmapAutoFocus, useMidDistDmap, useOnlySingleDmap, useXMinusDmap, useXPlusDmap, useYMinusDmap, useYPlusDmap, useZMinusDmap, useZPlusDmap, volumeShadowSamples, writeDmap

Long name (short name)	Type	Default	Flags
castSoftShadows (cw)	bool	false
Turn on soft shadows. This is only useful when ray tracing shadows are turned on, and the light radius is larger than 0.
dmapFrameExt (uf)	bool	false
Use the frame extension in the depth map I/O file name.
dmapLightName (ul)	bool	true
Use the light name in the depth map I/O file name.
dmapSceneName (um)	bool	false
Use the scene name in the depth map I/O file name.
dmapBias (db)	float	0.001
The depth map bias, used to escape bad self-shadowing artifacts.
dmapFarClipPlane (fcp)	float	10000.0
The depth map farclipping plane distance.
dmapFilterSize (fs)	short	1
The depth map filter size. The larger the size, the softer the shadows (larger penumbra region).
dmapFocus (df)	float	90.0
The depth map focus. If the auto focus is off, we need to rely on some region which we need to compute depth map shadows for, which is what this angle is meant for. This is only useful for spot + point lights, and the equivalent for directional lights ais the dmapWidthFocus.
dmapName (smn)	string	NULL
The Shadow Depth Map Name
dmapNearClipPlane (nc)	float	0.001
The depth map near clipping plane distance.
dmapUseMacro (dc)	string	NULL
The Shadow Map Pre Callback Name
dmapResolution (dr)	short	512
The depth map resolution.
dmapWidthFocus (dw)	float	100.0
The depth map width focus for directional lights.
fogShadowIntensity (fsi)	short	1
The amount of fog shadow exaggeration.
lastWrittenDmapAnimExtName (lw)	string	NULL
Last written depth map Anim Extension Name
volumeShadowSamples (nv)	short	20
The number of volume shadow samples.
receiveShadows (gs)	bool	true
sampleData = geometry receives shadows
reuseDmap (du)	bool	false
Reuse last written depth map.
lightRadius (lr)	float	0.0
The light radius used to determine how soft the shadows (or the penumbra region) should be. The radius provides a spherical region in which we can jitter the shadow rays to fake soft shadows. The larger the light radius, the softer the shadows (or larger the penumbra region). Non-extended lights do not cast soft shadows mathematically (represented by the default radius of 0), which is why this light radius is needed to fake soft shadows.
useDmapAutoClipping (uc)	bool	true
Automatic computation of the depth map near/far clipping planes.
useDmapAutoFocus (af)	bool	true
Automatic computation of the depth map bounding box focus.
useDepthMapShadows (dms)	bool	false
Turn on depth map shadows.
useMidDistDmap (md)	bool	true
Turn on mid distance depth map.
useOnlySingleDmap (us)	bool	true
use a single map.
useXMinusDmap (xn)	bool	true
compute the X Negative Depthmap.
useXPlusDmap (xp)	bool	true
compute the X Positive Depthmap.
useYMinusDmap (yn)	bool	true
compute the Y Negative Depthmap.
useYPlusDmap (yp)	bool	true
compute the Y Positive Depthmap.
useZMinusDmap (zn)	bool	true
compute the Z Negative Depthmap.
useZPlusDmap (zp)	bool	true
compute the Z Positive Depthmap.
writeDmap (ws)	bool	false
write shadow depth maps to disk.