org.j3d.aviatrix3d.rendering
Interface CustomGeometryRenderable

All Superinterfaces:

java.lang.Comparable, GeometryRenderable, Renderable

All Known Implementing Classes:

SortedPointArray

public interface CustomGeometryRenderable
extends GeometryRenderable

Extended version of the basic geometry renderable for geometry classes that provide the option for internal per-primitive sorting each frame.

Assumable Preconditions

• All state required to render this node shall be already available. For example, if this is the geometry, all the appearance state will already be set in the pipeline.
• Any transformations provided by parent transformations will be already applied to the modelview stack.

Implementation Requirements

Geometry that implement this interface should also be able to function as normal unsorted geometry when the pipeline process does not support any form of depth sorting.

Since:

Aviatrix3D 2.0

Version:

$Revision: 2.1 $

Author:

Justin Couch

Method Summary

java.lang.Object	processCull(javax.vecmath.Matrix4f vworldTx, javax.vecmath.Matrix4f viewTransform, javax.vecmath.Vector4f[] viewFrustum, float angularRes) Process the sorting on this node now.
void	render(javax.media.opengl.GL gl, java.lang.Object externalData) Render the geometry now using the supplied extra external data, using the custom rendering routines.

Methods inherited from interface org.j3d.aviatrix3d.rendering.GeometryRenderable

hasTransparency, render

Methods inherited from interface org.j3d.aviatrix3d.rendering.Renderable

equals

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

processCull

java.lang.Object processCull(javax.vecmath.Matrix4f vworldTx,
                             javax.vecmath.Matrix4f viewTransform,
                             javax.vecmath.Vector4f[] viewFrustum,
                             float angularRes)

Process the sorting on this node now. If needed some rendering information that will be needed during real rendering can be returned. If there is no information, return null.

Parameters:

vworldTx - The transformation from the root of the scene to this node according to the current traversal path

viewTransform - The transformation from the root of the scene graph to the active viewpoint

viewFrustum - The 6 planes of the view frustum

angularRes - Angular resolution of the screen, or 0 if not calculable from the available data.

Returns:

Any information that may be useful for the rendering step

render

void render(javax.media.opengl.GL gl,
            java.lang.Object externalData)

Render the geometry now using the supplied extra external data, using the custom rendering routines.

Parameters:

gl - The GL context to render with

externalData - Some implementation-specific external data to aid in the rendering that was generated in the processCull method.