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.
showProxyGeometry	SFBool	inputOutput	FALSE		toggle geometry at light position (use for visual debugging)
proxyGeometrySize	SFVec3f	inputOutput	1 1 1		scales proxy geometry
shadowIntensity	SFFloat	inputOutput	0	[0, 1]	intensity of the shadow; 0 is no shadow at all
on	SFBool	inputOutput	TRUE		Enables/disables this effector (e.g. light)
logFeature	MFString	inputOutput		state, child, parent, route, eventIn, eventOut	controls the logging of changes, state: log state changes (e.g. live), child: log child add/remove, parent: log parent add/remove, route: log route add/remove; eventIn: log receiving of events, eventOut: log sending of events: guiView, runtime system should create node-view, guiEdit: runtime system should create node-editeverything: log everything
metadata	SFNode	inputOutput		MetadataObject	container for payload metadata inside MetadataSet element