com.openinventor.inventor.vrmlnodes

Class SoVRMLDirectionalLight

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.vrmlnodes.SoVRMLNode

com.openinventor.inventor.vrmlnodes.SoVRMLLight

com.openinventor.inventor.vrmlnodes.SoVRMLDirectionalLight

All Implemented Interfaces:

SafeDisposable

Direct Known Subclasses:

SoDirectVizDirectionalLight

Deprecated.

As of Open Inventor 9500 See documentation for more details

public class SoVRMLDirectionalLight
extends SoVRMLLight

Node representing a directional light source. The SoVRMLDirectionalLight node defines a directional light source that illuminates along rays parallel to a given 3-dimensional vector.

<font color="#0000FF">NOTE:</font> This class does not exist in Open Inventor 10.0 and later.

The direction field specifies the direction vector within the local coordinate system that the light illuminates in. Light is emitted along parallel rays from an infinite distance away. A directional light source illuminates only the objects in its enclosing parent group. The light may illuminate everything within this coordinate system, including all children and descendants of its parent group. The accumulated transformations of the parent nodes affect the light.

VRML97 SPECIFICATION

This section describes the expected behavior of the node in a conforming VRML97 browser application. In some cases, the application is responsible for implementing portions of the expected behavior. Open Inventor viewer classes and IVF classes implement some of the application behaviors.

This section may reference portions of the VRML97 specification that are not present in this help file. The complete VRML97 spec is available at http://www.web3d.org.

The SoVRMLDirectionalLight node defines a directional light source that illuminates along rays parallel to a given 3-dimensional vector. See "Concepts - Lights" for a definition of the ambientIntensity , color , intensity , and on fields.

The direction field specifies the direction vector within the local coordinate system that the light illuminates in. Light is emitted along parallel rays from an infinite distance away. A directional light source illuminates only the objects in its enclosing parent group. The light may illuminate everything within this coordinate system, including all children and descendants of its parent group. The accumulated transformations of the parent nodes affect the light.

See "Concepts - Lighting Model" for a precise description of VRML's lighting equations.

File format/default:

VRMLDirectionalLight {

ambientIntensity	0
color	1 1 1
direction	0 0 -1
intensity	1
on	true
metadata	NULL

}

Action behavior:

SoGLRenderAction
Sets: SoGLLightIdElement

EVENTS

eventIn

SoSFFloat	set_ambientIntensity
SoSFColor	set_color
SoSFVec3f	set_direction
SoSFFloat	set_intensity
SoSFBool	set_on
SoSFNode	set_metadata

eventOut

SoSFFloat	ambientIntensity_changed
SoSFColor	color_changed
SoSFVec3f	direction_changed
SoSFFloat	intensity_changed
SoSFBool	on_changed
SoSFNode	metadata_changed

Deprecated since Open Inventor 9500
The VRML API is no longer supported. See section http://oivdoc95.vsg3d.com/content/compatibility-notes-4#Deprecation of the Reference Manual.

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFVec3f	direction Deprecated. Illumination direction vector.

Fields inherited from class com.openinventor.inventor.vrmlnodes.SoVRMLLight

ambientIntensity, color, intensity, on

Fields inherited from class com.openinventor.inventor.vrmlnodes.SoVRMLNode

metadata

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoVRMLDirectionalLight() Deprecated. Constructor.

Method Summary

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

direction

public final SoSFVec3f direction

Deprecated.

Illumination direction vector.

Constructor Detail

SoVRMLDirectionalLight

public SoVRMLDirectionalLight()

Deprecated.

Constructor.