SoSoundElement: The sosoundelement is used for optimizing audio rendering and for turning off inactive sovrmlsound nodes.

SYNOPSIS

#include <Inventor/elements/SoSoundElement.h>

Inherits SoReplacedElement.

Public Member Functions

virtual void init (SoState *state)

virtual void push (SoState *state)

virtual void pop (SoState *state, const SoElement *prevTopElement)

virtual void print (FILE *file) const

Prints contents of element (not implemented)

Static Public Member Functions

static SoType getClassTypeId (void)

static int getClassStackIndex (void)

static void * createInstance (void)

static void initClass (void)

static void set (SoState *const state, SoNode *const node, SbBool scenegraphhassoundnode, SbBool soundnodeisplaying, SbBool ispartofactivescenegraph)

static SbBool setSceneGraphHasSoundNode (SoState *const state, SoNode *const node, SbBool flag)

static SbBool sceneGraphHasSoundNode (SoState *const state)

static SbBool setSoundNodeIsPlaying (SoState *const state, SoNode *const node, SbBool flag)

static SbBool soundNodeIsPlaying (SoState *const state)

static SbBool setIsPartOfActiveSceneGraph (SoState *const state, SoNode *const node, SbBool flag)

static SbBool isPartOfActiveSceneGraph (SoState *const state)

Protected Member Functions

virtual ~SoSoundElement ()

void setDefaultValues ()

Protected Attributes

SbBool scenegraphhassoundnode

SbBool soundnodeisplaying

SbBool ispartofactivescenegraph

Additional Inherited Members

Detailed Description

The SoSoundElement is used for optimizing audio rendering and for turning off inactive SoVRMLSound nodes.

Since:

Coin 2.0

Constructor & Destructor Documentation

SoSoundElement::~SoSoundElement (void)\fC [protected]\fP, \fC [virtual]\fP

The destructor.

Member Function Documentation

void * SoSoundElement::createInstance (void)\fC [static]\fP

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

void SoSoundElement::initClass (void)\fC [static]\fP

This static method initializes static data for the SoSoundElement class.

void SoSoundElement::init (\fBSoState\fP *state)\fC [virtual]\fP

Initializes the element to it's default value.

Reimplemented from SoReplacedElement.

void SoSoundElement::set (\fBSoState\fP conststate, \fBSoNode\fP constnode, SbBoolscenegraphhassoundnode, SbBoolsoundnodeisplaying, SbBoolispartofactivescenegraph)\fC [static]\fP

Sets the flags.

SbBool SoSoundElement::setSceneGraphHasSoundNode (\fBSoState\fP conststate, \fBSoNode\fP constnode, SbBoolflag)\fC [static]\fP

Sets the sceneGraphHasSoundNode flag.

SbBool SoSoundElement::sceneGraphHasSoundNode (\fBSoState\fP *conststate)\fC [static]\fP

The sceneGraphHasSoundNode flag is used to stop the SoAudioRenderAction in SoSeparator and SoVRMLGroup nodes for cases where the sub-graph doesn not contain any SoVRMLSound nodes.

Returns the value of the sceneGraphHasSoundNode flag.

SbBool SoSoundElement::setSoundNodeIsPlaying (\fBSoState\fP conststate, \fBSoNode\fP constnode, SbBoolflag)\fC [static]\fP

Sets the soundNodeIsPlaying flag.

SbBool SoSoundElement::soundNodeIsPlaying (\fBSoState\fP *conststate)\fC [static]\fP

The soundNodeIsPlaying flag is currently unused.

Returns the value of the soundNodeIsPlaying flag.

SbBool SoSoundElement::setIsPartOfActiveSceneGraph (\fBSoState\fP conststate, \fBSoNode\fP constnode, SbBoolflag)\fC [static]\fP

Sets the isPartOfActiveSceneGraph flag.

SbBool SoSoundElement::isPartOfActiveSceneGraph (\fBSoState\fP *conststate)\fC [static]\fP

The isPartOfActiveSceneGraph flag is used to make SoVRMLSound that are below inactive parts of the scenegraph (i.e. below a SoSwitch or SoLOD node) stop playing.

Returns the value of the isPartOfActiveSceneGraph flag.

void SoSoundElement::push (\fBSoState\fP *state)\fC [virtual]\fP

Calls the superclass' push method. Initializes the element to the default values. Uses previous element's isPartOfActiveSceneGraph flag.

Reimplemented from SoElement.

void SoSoundElement::pop (\fBSoState\fP state, const \fBSoElement\fP prevTopElement)\fC [virtual]\fP

Calls the superclass' pop method.