org.j3d.aviatrix3d.pipeline
Class NullAudioCullStage

java.lang.Object
  org.j3d.aviatrix3d.pipeline.NullAudioCullStage

All Implemented Interfaces:

AudioCullStage

public class NullAudioCullStage

extends java.lang.Object

implements AudioCullStage

Handles the scenegraph maintenance and culling operations.

The culling phase generates a list of nodes to render.

Since this is a null culling stage, and thus no culling is performed, if the scene graph contains instances of Cullable, they are ignored and traversal stops at that point.

Note:

Layers are not implemented yet.

Version:

$Revision: 1.3 $

Author:

Alan Hudson

Constructor Summary

NullAudioCullStage()
Create a basic instance of this class with the list initial internal setup for the given number of renderable surfaces.

Method Summary

void	cull(Layer[] layers, int numLayers, int buffer) Update and cull the scenegraph defined by a set of layers.
void	cull(Scene scene, int buffer) Update and cull the scenegraph.
void	halt() Force a halt of the current processing.
void	setCulledAudioReceiver(CulledAudioReceiver sgr) Register a reciever for the output of the sorter.

Methods inherited from class java.lang.Object

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

Constructor Detail

NullAudioCullStage

public NullAudioCullStage()

Create a basic instance of this class with the list initial internal setup for the given number of renderable surfaces. The size is just an initial esstimate, and is used for optimisation purposes to prevent frequent array reallocations internally. As such, the number does not have to be perfect, just good enough.

Method Detail

cull

public void cull(Scene scene,
                 int buffer)

Update and cull the scenegraph. This generates an ordered list of nodes to render. It will not return until the culling is complete.

Specified by:

cull in interface AudioCullStage

Parameters:

scene - The scene instance to cull

buffer - The buffer ID to use to output the data to when multi-threaded

cull

public void cull(Layer[] layers,
                 int numLayers,
                 int buffer)

Update and cull the scenegraph defined by a set of layers. This generates an ordered list of nodes to render. It will not return until the culling is complete.

Parameters:

layers - The collection of layers, in order, to render

numLayers - The number of valid layers to use

buffer - The buffer ID to use to output the data to when multi-threaded

setCulledAudioReceiver

public void setCulledAudioReceiver(CulledAudioReceiver sgr)

Register a reciever for the output of the sorter. If the value is null, it will clear the currently set receiver.

Specified by:

setCulledAudioReceiver in interface AudioCullStage

Parameters:

sgr - The receiver instance to add or null

halt

public void halt()

Force a halt of the current processing. Any processing in progress should exit immediately. Used to abort the current scene processing due to application shutdown or complete scene replacement.

Specified by:

halt in interface AudioCullStage