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

The GeneralSpotLight node defines a light source that emits light from a specific point along a specific direction vector and constrained within a solid angle. More...

#include <H3D/GeneralSpotLight.h>

Inheritance diagram for H3D::GeneralSpotLight:
Inheritance graph

Public Member Functions

 GeneralSpotLight (Inst< SFNode > _metadata=0, Inst< SFFloat > _ambientIntensity=0, Inst< SFColor > _color=0, Inst< SFFloat > _intensity=0, Inst< SFBool > _global=0, Inst< SFBool > _on=0, Inst< SFVec3f > _attenuation=0, Inst< SFFloat > _beamWidth=0, Inst< SFFloat > _cutOffAngle=0, Inst< SFVec3f > _direction=0, Inst< SFVec3f > _location=0, Inst< SFFloat > _radius=0, Inst< SFColor > _ambientColor=0, Inst< SFColor > _specularColor=0, Inst< SFFloat > _specularIntensity=0)
 Constructor.

 
GLLightInfo getGLLightInfo ()
 Return the OpenGL parameters for this light.
 
- Public Member Functions inherited from H3D::SpotLight
 SpotLight (Inst< SFNode > _metadata=0, Inst< SFFloat > _ambientIntensity=0, Inst< SFColor > _color=0, Inst< SFFloat > _intensity=0, Inst< SFBool > _global=0, Inst< SFBool > _on=0, Inst< SFVec3f > _attenuation=0, Inst< SFFloat > _beamWidth=0, Inst< SFFloat > _cutOffAngle=0, Inst< SFVec3f > _direction=0, Inst< SFVec3f > _location=0, Inst< SFFloat > _radius=0)
 Constructor.

 
GLLightInfo getGLLightInfo ()
 Return the OpenGL parameters for this light.
 
- 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.
 
virtual void traverseSG (TraverseInfo &ti)
 Traverse the scenegraph. More...
 
- 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::SpotLight
H3DUniquePtr< SFVec3fattenuation
 The attenuation field defines how the SpotLight node's illumination falls off with distance from the light. More...
 
H3DUniquePtr< SFFloatbeamWidth
 The beamWidth field specifies an inner solid angle in which the light source emits light at uniform full intensity (in H3DAPI it can only be the entire beamWidth angle or 0). More...
 
H3DUniquePtr< SFFloatcutOffAngle
 The cutOffAngle field specifies the outer bound of the solid angle. More...
 
H3DUniquePtr< SFVec3fdirection
 The direction field specifies the direction vector of the light's central axis defined in the local coordinate system. More...
 
H3DUniquePtr< SFVec3flocation
 The location field specifies a translation offset of the centre point of the light source from the light's local coordinate system origin. More...
 
H3DUniquePtr< SFFloatradius
 This field is not supported by H3DAPI.
 
- 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::SpotLight
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 GeneralSpotLight node defines a light source that emits light from a specific point along a specific direction vector and constrained within a solid angle.

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

Specifically: diffuse = color * intensity ambient = ambientColor * ambientIntensity specular = specularColor * specularIntensity

Examples:

Internal routes:

Member Data Documentation

◆ ambientColor

H3DUniquePtr< SFColor > H3D::GeneralSpotLight::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 GeneralSpotLight(), and getGLLightInfo().

◆ specularColor

H3DUniquePtr< SFColor > H3D::GeneralSpotLight::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 GeneralSpotLight(), and getGLLightInfo().

◆ specularIntensity

H3DUniquePtr< SFFloat > H3D::GeneralSpotLight::specularIntensity

Specifies the intensity of the specular emission from the light.

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

Referenced by GeneralSpotLight().


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