com.jme3.renderer.queue

Class RenderQueue

java.lang.Object

com.jme3.renderer.queue.RenderQueue

public class RenderQueue
extends java.lang.Object

RenderQueue is used to queue up and sort geometries for rendering.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RenderQueue.Bucket The render queue Bucket specifies the bucket to which the spatial will be placed when rendered.
static class	RenderQueue.ShadowMode ShadowMode is a marker used to specify how shadow effects should treat the spatial.

Constructor Summary

Constructors

Constructor and Description
RenderQueue() Creates a new RenderQueue, the default comparators are used for all geometry lists.

Method Summary

Modifier and Type	Method and Description
void	addToQueue(Geometry g, RenderQueue.Bucket bucket) Adds a geometry to the given bucket.
void	clear()
GeometryComparator	getGeometryComparator(RenderQueue.Bucket bucket) Returns the current GeometryComparator used by the specified bucket, one of Gui, Opaque, Sky, Transparent, or Translucent.
boolean	isQueueEmpty(RenderQueue.Bucket bucket)
void	renderQueue(RenderQueue.Bucket bucket, RenderManager rm, Camera cam)
void	renderQueue(RenderQueue.Bucket bucket, RenderManager rm, Camera cam, boolean clear)
void	renderShadowQueue(GeometryList list, RenderManager rm, Camera cam, boolean clear)
void	setGeometryComparator(RenderQueue.Bucket bucket, GeometryComparator c) Sets a different geometry comparator for the specified bucket, one of Gui, Opaque, Sky, Transparent, or Translucent.

Methods inherited from class java.lang.Object

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

Constructor Detail

RenderQueue

public RenderQueue()

Creates a new RenderQueue, the default comparators are used for all geometry lists.

Method Detail

setGeometryComparator

public void setGeometryComparator(RenderQueue.Bucket bucket,
                                  GeometryComparator c)

Sets a different geometry comparator for the specified bucket, one of Gui, Opaque, Sky, Transparent, or Translucent. The GeometryComparators are used to sort the accumulated list of geometries before actual rendering occurs.

The most significant comparator is the one for the transparent bucket since there is no correct way to sort the transparent bucket that will handle all geometries all the time. In certain cases, the application may know the best way to sort and now has the option of configuring a specific implementation.

The default comparators are:

• Bucket.Opaque: OpaqueComparator which sorts by material first and front to back within the same material.
• Bucket.Transparent: TransparentComparator which sorts purely back to front by leading bounding edge with no material sort.
• Bucket.Translucent: TransparentComparator which sorts purely back to front by leading bounding edge with no material sort. this bucket is rendered after post processors.
• Bucket.Sky: NullComparator which does no sorting at all.
• Bucket.Gui: GuiComparator sorts geometries back to front based on their Z values.

Parameters:

bucket - which Bucket to modify (not null)

c - the comparator to use (alias created)

getGeometryComparator

public GeometryComparator getGeometryComparator(RenderQueue.Bucket bucket)

Returns the current GeometryComparator used by the specified bucket, one of Gui, Opaque, Sky, Transparent, or Translucent.

Parameters:

bucket - which Bucket to access (not null)

Returns:

the pre-existing instance

addToQueue

public void addToQueue(Geometry g,
                       RenderQueue.Bucket bucket)

Adds a geometry to the given bucket. The RenderManager automatically handles this task when flattening the scene graph. The bucket to add the geometry is determined by Spatial.getQueueBucket().

Parameters:

g - The geometry to add

bucket - The bucket to add to, usually Spatial.getQueueBucket().

renderShadowQueue

public void renderShadowQueue(GeometryList list,
                              RenderManager rm,
                              Camera cam,
                              boolean clear)

isQueueEmpty

public boolean isQueueEmpty(RenderQueue.Bucket bucket)

renderQueue

public void renderQueue(RenderQueue.Bucket bucket,
                        RenderManager rm,
                        Camera cam)

renderQueue

public void renderQueue(RenderQueue.Bucket bucket,
                        RenderManager rm,
                        Camera cam,
                        boolean clear)

clear

public void clear()