org.j3d.aviatrix3d.output.graphics
Interface ElumensOutputDevice

All Superinterfaces:

GraphicsOutputDevice, OutputDevice

All Known Implementing Classes:

ElumensAWTSurface, ElumensSWTSurface

public interface ElumensOutputDevice
extends GraphicsOutputDevice

An extended form of the GraphicsOutputDevice interface that adds methods that are specific to managing Elumens setup functionality.

This implementation is capable of handling multichannel dome support with configurable number of channels. The number of channels used can be modified on the fly, but it is costly to do so as the render has to be reinitialized each time.

Most of the methods take which channel to write to. The constants are defined both in this interface, which are just aliased values from SPI. These are a set of bitmasks used to control the channels.

Version:

$Revision: 1.1 $

Author:

Justin Couch

Field Summary

static int	SPI_1C_FRONT The only channel of a single-channel display
static int	SPI_2C_BORDER The border channel surrounding the 2-channel display
static int	SPI_2C_INSERT The overlay channel above any projection for the 2-channel display
static int	SPI_2C_LEFT The left channel of a 2-channel display
static int	SPI_2C_RIGHT The right channel of a 2-channel display
static int	SPI_3C_LEFT The left channel of a 3-channel display
static int	SPI_3C_RIGHT The right channel of a 3-channel display
static int	SPI_3C_TOP The top channel of a 3-channel display
static int	SPI_4C_BOTTOM The left channel of a 4-channel display
static int	SPI_4C_LEFT The left channel of a 4-channel display
static int	SPI_4C_RIGHT The left channel of a 4-channel display
static int	SPI_4C_TOP The left channel of a 4-channel display
static int	SPI_ALL_2_CHAN Select all channels for a 2-channel display
static int	SPI_ALL_3_CHAN Select all channels for a 3-channel display
static int	SPI_ALL_4_CHAN Select all channels for a 4-channel display
static int	SPI_ALL_CHAN Select all available channels
static int	SPI_OC_FRONT The overlay channel above any projection

Fields inherited from interface org.j3d.aviatrix3d.pipeline.graphics.GraphicsOutputDevice

ALTERNATE_FRAME_STEREO, NO_STEREO, QUAD_BUFFER_STEREO, TWO_CANVAS_STEREO

Method Summary

void	setChannelEyePosition(int channel, float x, float y, float z) Set the channel eye position.
void	setChannelLensPosition(int channel, float x, float y, float z) Set the channel lens position.
void	setChannelSize(int channel, int height, int width) Set the channel size in pixels.
void	setNumberOfChannels(int channels) Set the number of channels to display.
void	setScreenOrientation(double r, double p, double v) Set the screen orientation.

Methods inherited from interface org.j3d.aviatrix3d.pipeline.graphics.GraphicsOutputDevice

addGraphicsResizeListener, addSurfaceInfoListener, enableTwoPassTransparentRendering, getAlphaTestCutoff, getCenterEyeInSurface, getPixelLocationInSurface, getStereoEyeSeparation, getStereoRenderingPolicy, getSurfaceToVWorld, isQuadStereoAvailable, isStereoAvailable, isTwoPassTransparentEnabled, removeGraphicsResizeListener, removeSurfaceInfoListener, setAlphaTestCutoff, setClearColor, setColorClearNeeded, setDrawableObjects, setStereoEyeSeparation, setStereoRenderingPolicy, swap

Methods inherited from interface org.j3d.aviatrix3d.pipeline.OutputDevice

dispose, disposeSingleThreadResources, draw, enableSingleThreaded, getSurfaceObject, isDisposed, setErrorReporter

Field Detail

SPI_1C_FRONT

static final int SPI_1C_FRONT

The only channel of a single-channel display

See Also:

Constant Field Values

SPI_2C_LEFT

static final int SPI_2C_LEFT

The left channel of a 2-channel display

See Also:

Constant Field Values

SPI_2C_RIGHT

static final int SPI_2C_RIGHT

The right channel of a 2-channel display

See Also:

Constant Field Values

SPI_3C_LEFT

static final int SPI_3C_LEFT

The left channel of a 3-channel display

See Also:

Constant Field Values

SPI_3C_RIGHT

static final int SPI_3C_RIGHT

The right channel of a 3-channel display

See Also:

Constant Field Values

SPI_3C_TOP

static final int SPI_3C_TOP

The top channel of a 3-channel display

See Also:

Constant Field Values

SPI_4C_LEFT

static final int SPI_4C_LEFT

The left channel of a 4-channel display

See Also:

Constant Field Values

SPI_4C_RIGHT

static final int SPI_4C_RIGHT

The left channel of a 4-channel display

See Also:

Constant Field Values

SPI_4C_TOP

static final int SPI_4C_TOP

The left channel of a 4-channel display

See Also:

Constant Field Values

SPI_4C_BOTTOM

static final int SPI_4C_BOTTOM

The left channel of a 4-channel display

See Also:

Constant Field Values

SPI_OC_FRONT

static final int SPI_OC_FRONT

The overlay channel above any projection

See Also:

Constant Field Values

SPI_2C_INSERT

static final int SPI_2C_INSERT

The overlay channel above any projection for the 2-channel display

See Also:

Constant Field Values

SPI_2C_BORDER

static final int SPI_2C_BORDER

The border channel surrounding the 2-channel display

See Also:

Constant Field Values

SPI_ALL_CHAN

static final int SPI_ALL_CHAN

Select all available channels

See Also:

Constant Field Values

SPI_ALL_2_CHAN

static final int SPI_ALL_2_CHAN

Select all channels for a 2-channel display

See Also:

Constant Field Values

SPI_ALL_3_CHAN

static final int SPI_ALL_3_CHAN

Select all channels for a 3-channel display

See Also:

Constant Field Values

SPI_ALL_4_CHAN

static final int SPI_ALL_4_CHAN

Select all channels for a 4-channel display

See Also:

Constant Field Values

Method Detail

setNumberOfChannels

void setNumberOfChannels(int channels)

Set the number of channels to display. Calling this will cause a reinitialization of renderer.

Parameters:

channels - The number of channels to render.

setChannelLensPosition

void setChannelLensPosition(int channel,
                            float x,
                            float y,
                            float z)

Set the channel lens position.

Parameters:

channel - The ID of the channel(s) to affect

x - The x position

y - The y position

z - The z position

setChannelEyePosition

void setChannelEyePosition(int channel,
                           float x,
                           float y,
                           float z)

Set the channel eye position.

Parameters:

channel - The ID of the channel(s) to affect

x - The x position

y - The y position

z - The z position

setScreenOrientation

void setScreenOrientation(double r,
                          double p,
                          double v)

Set the screen orientation. Allows the project to rotated in software for different hardware setups.

Parameters:

r - The roll

p - The pitch

v - The yaw

setChannelSize

void setChannelSize(int channel,
                    int height,
                    int width)

Set the channel size in pixels.

Parameters:

channel - The ID of the channel(s) to affect

height - The height in pixels

width - The width in pixels