org.j3d.aviatrix3d
Interface MultipassTextureSource

All Superinterfaces:

OffscreenTextureSource, TextureSource

All Known Implementing Classes:

MultipassTextureComponent

Deprecated. Use OffscreenTexture2D or MRTOffscreenTexture2D

public interface MultipassTextureSource
extends OffscreenTextureSource

Marker describing a texture source that that is rendered to the main surface using a multipass technique.

Note: This class does nothing in Aviatrix3D 1.0

In a multipass source, the drawn surface still needs to conform to the power of 2 size requirements. Since the viewport for the window is almost guaranteed not to be a power of two, the user must make sure that they set an explicit, correct, viewport size through the ViewEnvironment provided with the scene.

Version:

$Revision: 1.6 $

Author:

Justin Couch

Field Summary

static int	ACCUMULATION_BUFFER Deprecated. The bitmask indicating the accumulation buffer is used.
static int	COLOR_BUFFER Deprecated. The bitmask indicating the colour buffer is used.
static int	DEPTH_BUFFER Deprecated. The bitmask indicating the depth buffer is used.
static int	STENCIL_BUFFER Deprecated. The bitmask indicating the stencil buffer is used.

Fields inherited from interface org.j3d.aviatrix3d.TextureSource

FORMAT_BGR, FORMAT_BGRA, FORMAT_INTENSITY_ALPHA, FORMAT_LUMINANCE_ALPHA, FORMAT_RGB, FORMAT_RGBA, FORMAT_SINGLE_COMPONENT

Method Summary

MultipassRenderObserver	getRenderObserver() Deprecated. Fetch the observer instance that may be associated with the texture source.
int	getUsedBuffers() Deprecated. Get the list of buffers that are required to be rendered by this source.
ViewportLayer	getViewportLayer() Deprecated. Get the root of the currently rendered scene.
void	setNumLevels(int numLevels) Deprecated. Set the number of levels of mipmap generation that should be rendered.

Methods inherited from interface org.j3d.aviatrix3d.OffscreenTextureSource

getClearColor, getHeight, isRepaintRequired

Methods inherited from interface org.j3d.aviatrix3d.TextureSource

getFormat, getNumLevels, getWidth

Field Detail

COLOR_BUFFER

static final int COLOR_BUFFER

Deprecated.

The bitmask indicating the colour buffer is used.

See Also:

Constant Field Values

DEPTH_BUFFER

static final int DEPTH_BUFFER

Deprecated.

The bitmask indicating the depth buffer is used.

See Also:

Constant Field Values

STENCIL_BUFFER

static final int STENCIL_BUFFER

Deprecated.

The bitmask indicating the stencil buffer is used.

See Also:

Constant Field Values

ACCUMULATION_BUFFER

static final int ACCUMULATION_BUFFER

Deprecated.

The bitmask indicating the accumulation buffer is used.

See Also:

Constant Field Values

Method Detail

getViewportLayer

ViewportLayer getViewportLayer()

Deprecated.

Get the root of the currently rendered scene. If none is set, this will return null.

Returns:

The current scene root or null.

getRenderObserver

MultipassRenderObserver getRenderObserver()

Deprecated.

Fetch the observer instance that may be associated with the texture source. If no instance is associated, this will return null.

Returns:

The current observer instance, or null if none

getUsedBuffers

int getUsedBuffers()

Deprecated.

Get the list of buffers that are required to be rendered by this source. This will be used by the glClear() call to clear the appropriate buffers. These are the buffers that are to be cleared and used at the start of the multipass rendering. If the application needs to clear buffers during individual passes, that should be performed as part of the MultipassRenderObserver callbacks.

Returns:

A bitwise OR mask of the required buffers

setNumLevels

void setNumLevels(int numLevels)
                  throws InvalidWriteTimingException,
                         java.lang.IllegalArgumentException

Deprecated.

Set the number of levels of mipmap generation that should be rendered. Each level will become a separate rendering pass that will be updated. A check is performed to make sure that the number of levels does not produce a situation where the width or height goes negative in thier values - eg a starting size of 32 pixels square and requesting 6 levels of mipmaps being generated.

Parameters:

numLevels - The number of levels to render

Throws:

java.lang.IllegalArgumentException - The number of levels is more than what the current size could reduce to

InvalidWriteTimingException - An attempt was made to write outside of the NodeUpdateListener callback method