instantreality labs - nodetype

Component:: Lighting
Status:: fully implemented
Structure type:: concrete
Standard:: X3D2.0

DirectionalLight

DirectionalLight creates parallel light rays to illuminate geometric shapes. Light is scoped and only illuminates geometry within its enclosing parent group! No source location is needed since rays are parallel from an infinitely distant source. DirectionalLight nodes do not attenuate with distance. Lights have no visible shape themselves and shine through occluding geometry. Hint: animate direction to simulate time-of-day sunlight effects. Hint: HeadLight is controlled by NavigationInfo. Interchange profile hint: light might not be scoped by parent Group or Transform.

Inheritance

Code

XML encoding

<DirectionalLight logFeature=''
on='TRUE'
shadowIntensity='0'
proxyGeometrySize='1 1 1'
showProxyGeometry='FALSE'
ambientIntensity='0'
color='1 1 1'
intensity='1'
direction='0 0 -1'
global='FALSE'
 />

Classic encoding

DirectionalLight {
	logFeature [""]
	on TRUE
	shadowIntensity 0
	proxyGeometrySize 1 1 1
	showProxyGeometry FALSE
	ambientIntensity 0
	color 1 1 1
	intensity 1
	direction 0 0 -1
	global FALSE
}

Interface

Filter: X3D only | Avalon only | All

Name	DataType	PartType	Default	ValueType	Description
direction	SFVec3f	inputOutput	0 0 -1		Orientation of light relative to local coordinate system. Hint. animate direction to simulate time-of-day sunlight effects.
global	SFBool	inputOutput	FALSE		indicates if the light is global (influences all elements in the scene) or local (only the childs of the parent node)
ambientIntensity	SFFloat	inputOutput	0	[0, 1]	Brightness of ambient (nondirectional background) emission from the light.
color	SFColor	inputOutput	1 1 1		color of light, applied to colors of objects.
intensity	SFFloat	inputOutput	1	[0, 1]	Brightness of direct emission from the light.
on	SFBool	inputOutput	TRUE		Enables/disables this effector (e.g. light)
metadata	SFNode	inputOutput		MetadataObject	container for payload metadata inside MetadataSet element