H3D API  2.4.1
Public Member Functions | Public Attributes | Static Public Attributes | List of all members
H3D::GeneralDirectionalLight Class Reference

The GeneralDirectionalLight node defines a directional light source that illuminates along rays parallel to a given 3-dimensional vector. More...

#include <H3D/GeneralDirectionalLight.h>

Inheritance diagram for H3D::GeneralDirectionalLight:
Inheritance graph

Public Member Functions

 GeneralDirectionalLight (Inst< SFNode > _metadata=0, Inst< SFFloat > _ambientIntensity=0, Inst< SFColor > _color=0, Inst< SFFloat > _intensity=0, Inst< SFBool > _on=0, Inst< SFBool > _global=0, Inst< SFVec3f > _direction=0, Inst< SFColor > _ambientColor=0, Inst< SFColor > _specularColor=0, Inst< SFFloat > _specularIntensity=0)
 Constructor.
 
virtual GLLightInfo getGLLightInfo ()
 Return the OpenGL parameters for this light.
 
- Public Member Functions inherited from H3D::DirectionalLight
 DirectionalLight (Inst< SFNode > _metadata=0, Inst< SFFloat > _ambientIntensity=0, Inst< SFColor > _color=0, Inst< SFFloat > _intensity=0, Inst< SFBool > _on=0, Inst< SFBool > _global=0, Inst< SFVec3f > _direction=0)
 Constructor.
 
virtual void traverseSG (TraverseInfo &ti)
 Traversal function. Adding light to shadow caster.
 
- Public Member Functions inherited from H3D::X3DLightNode
 X3DLightNode (Inst< SFNode > _metadata=0, Inst< SFFloat > _ambientIntensity=0, Inst< SFColor > _color=0, Inst< SFBool > _global=0, Inst< SFFloat > _intensity=0, Inst< SFBool > _on=0, Inst< SFBool > _shadows=0)
 Constructor.
 
virtual void enableGraphicsState ()
 Turn the light on.
 
virtual void disableGraphicsState ()
 Turn the light off.
 
virtual void enableHapticsState (TraverseInfo &ti)
 Add light to TraverseInfo.
 
virtual void disableHapticsState (TraverseInfo &ti)
 Remove light from TraverseInfo.
 
- Public Member Functions inherited from H3D::X3DChildNode
 X3DChildNode (Inst< SFNode > _metadata=0)
 Constructor.
 
- Public Member Functions inherited from H3D::X3DNode
 X3DNode (Inst< SFNode > _metadata=0)
 Constructor.
 
X3DMetadataObjectgetMetadataByName (const string &_name)
 Given a name, the first X3DMetadataObject in the metadata field that matches that name is returned. More...
 
- Public Member Functions inherited from H3D::Node
 Node ()
 Constructor.
 
virtual Nodeclone (bool deepCopy=true, DeepCopyMap *deepCopyMap=NULL)
 Returns a new instance of this node type with the same state as this one. More...
 
virtual ~Node ()
 Destructor.
 
X3DPrototypeInstancegetProtoInstanceParent ()
 If this node is the root node in the proto body of a X3DPrototypeInstance then this will return that node. More...
 
void setProtoInstanceParent (X3DPrototypeInstance *p)
 Set the X3DPrototypeInstance this node is the the root node if applicaple.
 
virtual void render ()
 the render() function is used for the depth-first rendering traversal of the scene-graph. More...
 
virtual bool lineIntersect (const Vec3f &from, const Vec3f &to, LineIntersectResult &result)
 Detect intersection between a line segment and the Node. More...
 
virtual void closestPoint (const Vec3f &p, NodeIntersectResult &result)
 Find closest point on Node to p. More...
 
virtual bool movingSphereIntersect (H3DFloat radius, const Vec3f &from, const Vec3f &to, NodeIntersectResult &result)
 Detect collision between a moving sphere and the Node. More...
 
virtual string defaultXMLContainerField ()
 Returns the default xml containerField attribute value. More...
 
virtual FieldgetField (const string &_name) const
 return a pointer to the field specified by name within this instance
 
int addDestructCallback (void(*func)(Node *, void *), void *args)
 Add a callback function to be run on destruction of node. More...
 
int removeDestructCallback (void(*func)(Node *, void *), void *args)
 Add a callback function to be run on destruction of node. More...
 
- Public Member Functions inherited from H3D::H3DDisplayListObject
 H3DDisplayListObject (Inst< DisplayList > _displayList=0)
 Constructor.
 
- Public Member Functions inherited from H3D::H3DRenderStateObject
virtual ~H3DRenderStateObject ()
 Destructor.
 

Public Attributes

H3DUniquePtr< SFColorambientColor
 The color field specifies the spectral colour properties of the ambient light emission as an RGB value. More...
 
H3DUniquePtr< SFColorspecularColor
 The color field specifies the spectral colour properties of the specular light emission as an RGB value. More...
 
H3DUniquePtr< SFFloatspecularIntensity
 Specifies the intensity of the specular emission from the light. More...
 
- Public Attributes inherited from H3D::DirectionalLight
H3DUniquePtr< SFVec3fdirection
 The direction field specifies the direction vector of the illumination emanating from the light source in the local coordinate system. More...
 
- Public Attributes inherited from H3D::X3DLightNode
H3DUniquePtr< SFFloatambientIntensity
 Specifies the intensity of the ambient emission from the light. More...
 
H3DUniquePtr< SFColorcolor
 The color field specifies the spectral colour properties of both the direct and ambient light emission as an RGB value. More...
 
H3DUniquePtr< SFBoolglobal
 The global field specifies whether the X3DLightNode affects all geometries in the scene or only those geometries that are in the same parent group or any descendant to the parent group. More...
 
H3DUniquePtr< SFFloatintensity
 The intensity field specifies the brightness of the direct emission from the light. More...
 
H3DUniquePtr< SFBoolon
 The on field specifies whether the light is enabled or disabled. More...
 
H3DUniquePtr< SFBoolshadows
 The shadows field will determine if this light will be part of the shadow calculations of the scene. More...
 
- Public Attributes inherited from H3D::X3DNode
H3DUniquePtr< SFNodemetadata
 Meta data about the node. More...
 
- Public Attributes inherited from H3D::H3DDisplayListObject
H3DUniquePtr< DisplayListdisplayList
 The DisplayList instance handling the OpenGL caching of this object.
 

Static Public Attributes

static H3DNodeDatabase database
 The H3DNodeDatabase for this node.
 
- Static Public Attributes inherited from H3D::DirectionalLight
static H3DNodeDatabase database
 The H3DNodeDatabase for this node.
 
- Static Public Attributes inherited from H3D::X3DLightNode
static H3DNodeDatabase database
 The H3DNodeDatabase for this node.
 
- Static Public Attributes inherited from H3D::X3DNode
static H3DNodeDatabase database
 The H3DNodeDatabase for this node.
 

Additional Inherited Members

- Public Types inherited from H3D::Node
typedef std::map< Node *, Node * > DeepCopyMap
 A map type used during a deep copy clone() to map from original nodes to cloned nodes.
 
- Static Public Member Functions inherited from H3D::X3DLightNode
static GLuint getLightIndex (string name_for_error)
 returns an index that can be used to enable light. More...
 
static void decreaseLightIndex ()
 must be called if getLightIndex have been called outside X3DLightNode.
 
- Static Public Member Functions inherited from H3D::Node
static unsigned int nrNodesAlive ()
 Returns the nr of nodes currently alive, i.e. nodes created but not destructed.
 
static int nrNodesCreated ()
 Returns the number of nodes created in total since the start of the program.
 
- Protected Member Functions inherited from H3D::Node
void cloneFieldValue (Field &_from, Field &_to, bool deepCopy, DeepCopyMap &deepCopyMap)
 A helper function for the clone() method. More...
 
- Static Protected Member Functions inherited from H3D::Node
static NodegetClonedInstance (Node *original, bool deepCopy, DeepCopyMap &deepCopyMap)
 A helper function for nodes that implement clone() More...
 
- Protected Attributes inherited from H3D::X3DLightNode
GLuint light_index
 Light index for this node, used to enable light.
 
TraverseInfolast_ti_ptr
 only interested in adress, what it points to will be invalid
 
H3DInt32 traverse_sg_counter
 count how many times this X3DLightNodes traverseSG function is called.
 
H3DInt32 graphics_state_counter
 count nr of times enableGraphicsState is called.
 
bool act_global
 used if the light should act as a global light.
 
list< bool > had_light_index
 true if a light index was created for each call to enableGraphicsState for this X3DLightNode
 

Detailed Description

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

It allows different values for the ambient, specular and diffuse color parts of the light specification.

The direction field specifies the direction vector of the illumination emanating from the light source in the local coordinate system. 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.

GeneralDirectionalLight nodes do not attenuate with distance.

Examples:

Internal routes:

Member Data Documentation

◆ ambientColor

H3DUniquePtr< SFColor > H3D::GeneralDirectionalLight::ambientColor

The color field specifies the spectral colour properties of the ambient light emission as an RGB value.

Access type: inputOutput
Default value: RGB( 1, 1, 1 )
Valid range: [0-1]

Referenced by GeneralDirectionalLight(), and getGLLightInfo().

◆ specularColor

H3DUniquePtr< SFColor > H3D::GeneralDirectionalLight::specularColor

The color field specifies the spectral colour properties of the specular light emission as an RGB value.

Access type: inputOutput
Default value: RGB( 1, 1, 1 )
Valid range: [0-1]

Referenced by GeneralDirectionalLight(), and getGLLightInfo().

◆ specularIntensity

H3DUniquePtr< SFFloat > H3D::GeneralDirectionalLight::specularIntensity

Specifies the intensity of the specular emission from the light.

Access type: inputOutput
Default value: 0
Valid range: [0-1]

Referenced by GeneralDirectionalLight().


The documentation for this class was generated from the following files: