SoSpotLight.3iv man page

SoSpotLight — node representing a spotlight source

Inherits from

SoBase > SoFieldContainer > SoNode > SoLight > SoSpotLight


#include <Inventor/nodes/SoSpotLight.h>

Fields from class SoSpotLight:

SoSFVec3f location

SoSFVec3f direction

SoSFFloat dropOffRate

SoSFFloat cutOffAngle

Fields from class SoLight:

SoSFBool on

SoSFFloat intensity

SoSFColor color

Methods from class SoSpotLight:


static SoType getClassTypeId()

Methods from class SoNode:

void setOverride(SbBool state)

SbBool isOverride() const

SoNode * copy(SbBool copyConnections = FALSE) const

virtual SbBool affectsState() const

static SoNode * getByName(const SbName &name)

static int getByName(const SbName &name, SoNodeList &list)

Methods from class SoFieldContainer:

void setToDefaults()

SbBool hasDefaultValues() const

SbBool fieldsAreEqual(const SoFieldContainer *fc) const

void copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)

SbBool set(const char *fieldDataString)

void get(SbString &fieldDataString)

virtual int getFields(SoFieldList &resultList) const

virtual SoField * getField(const SbName &fieldName) const

SbBool getFieldName(const SoField *field, SbName &fieldName) const

SbBool isNotifyEnabled() const

SbBool enableNotify(SbBool flag)

Methods from class SoBase:

void ref()

void unref() const

void unrefNoDelete() const

void touch()

virtual SoType getTypeId() const

SbBool isOfType(SoType type) const

virtual void setName(const SbName &name)

virtual SbName getName() const


This node defines a spotlight style light source. A spotlight is placed at a fixed location in 3-space and illuminates in a cone along a particular direction. The intensity of the illumination drops off exponentially as a ray of light diverges from this direction toward the edges of the cone. The rate of drop-off and the angle of the cone are controlled by the dropOffRate and cutOffAngle fields.


SoSFVec3f location
Location of the source.

SoSFVec3f direction
Principal direction of illumination (center axis of cone).

SoSFFloat dropOffRate
Rate of intensity drop-off per change in angle from primary direction: 0 = constant intensity, 1 = very sharp drop-off

SoSFFloat cutOffAngle
Angle (in radians) outside of which intensity is zero, measured from the center axis of the cone to an edge.


Creates a spotlight source node with default settings.

static SoType getClassTypeId()
Returns type identifier for this class.

Action Behavior

Activates this light (if so specified) during traversal. All shape nodes that come after this light in the scene graph are illuminated by this light. The light's location is affected by the current transformation.

File Format/Defaults

SpotLight {
intensity	1
color	1 1 1
location	0 0 1
direction	0 0 -1
dropOffRate	0
cutOffAngle	0.785398

See Also

SoDirectionalLight, SoPointLight