org.j3d.renderer.java3d.device.output.elumens
Class ElumensCanvas3D

java.lang.Object
  java.awt.Component
      java.awt.Canvas
          javax.media.j3d.Canvas3D
              org.j3d.renderer.java3d.device.output.elumens.ElumensCanvas3D

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.image.ImageObserver, java.awt.MenuContainer, MouseCoordinateConverter, java.io.Serializable

public class ElumensCanvas3D

extends javax.media.j3d.Canvas3D

implements MouseCoordinateConverter

A version of the standard Canvas3D class that works for Elumens Domes. This code requires the elumens.dll created in the j3d.org area to run.

Version:

$Revision: 1.2 $

Author:

Alan Hudson

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class java.awt.Canvas

java.awt.Canvas.AccessibleAWTCanvas

Nested classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.media.j3d.Canvas3D

FIELD_ALL, FIELD_LEFT, FIELD_RIGHT

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

ElumensCanvas3D(java.awt.GraphicsConfiguration gc, javax.media.j3d.View view, int numChannels, SGUpdater updater)
Create a new canvas given the graphics configuration No timing information will be displayed

Method Summary

void	addListener(ElumensEventListener eel) Add a listener for SPI events
SPI	getSPI() Get the SPI library used by this canvas.
void	initSPI(int format) Set the initialization paramaters for the SPI library.
void	postRender()
void	postSwap()
void	preRender() Process code before we render the image Overrides the standard implementation to mark the start time
void	registerInterest(MouseCoordinateSource msc) Register interest in having a coordinate converted
void	removeListener(ElumensEventListener eel) Remove a listener for SPI events
void	setNearFar(float near, float far) Setup the near and far clipping planes.
void	warpMouseCoordinate(double[] coords) Warp the provided mouse coordinates into 3d space.

Methods inherited from class javax.media.j3d.Canvas3D

addNotify, getBounds, getBounds, getCenterEyeInImagePlate, getDoubleBufferAvailable, getDoubleBufferEnable, getGraphics2D, getGraphicsContext3D, getHeight, getImagePlateToVworld, getInverseVworldProjection, getLeftEyeInImagePlate, getLeftManualEyeInImagePlate, getLocation, getLocation, getLocationOnScreen, getMonoscopicViewPolicy, getOffScreenBuffer, getOffScreenLocation, getOffScreenLocation, getPhysicalHeight, getPhysicalWidth, getPixelLocationFromImagePlate, getPixelLocationInImagePlate, getPixelLocationInImagePlate, getRightEyeInImagePlate, getRightManualEyeInImagePlate, getSceneAntialiasingAvailable, getScreen3D, getSize, getSize, getStereoAvailable, getStereoEnable, getView, getVworldProjection, getVworldToImagePlate, getWidth, getX, getY, isOffScreen, isRendererRunning, paint, queryProperties, removeNotify, renderField, renderOffScreenBuffer, setDoubleBufferEnable, setLeftManualEyeInImagePlate, setMonoscopicViewPolicy, setOffScreenBuffer, setOffScreenLocation, setOffScreenLocation, setRightManualEyeInImagePlate, setStereoEnable, startRenderer, stopRenderer, swap, waitForOffScreenRendering

Methods inherited from class java.awt.Canvas

createBufferStrategy, createBufferStrategy, getAccessibleContext, getBufferStrategy, update

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

ElumensCanvas3D

public ElumensCanvas3D(java.awt.GraphicsConfiguration gc,
                       javax.media.j3d.View view,
                       int numChannels,
                       SGUpdater updater)

Create a new canvas given the graphics configuration No timing information will be displayed

Parameters:

gc - The graphics configuration to use for the canvas

Method Detail

addListener

public void addListener(ElumensEventListener eel)

Add a listener for SPI events

removeListener

public void removeListener(ElumensEventListener eel)

Remove a listener for SPI events

initSPI

public void initSPI(int format)

Set the initialization paramaters for the SPI library.

Parameters:

format - The format to use

getSPI

public SPI getSPI()

Get the SPI library used by this canvas. Allows for direct manipulation of its parameters. Do not call rendering thread functions like init, begin end, preRender, postRender.

Returns:

The SPI class

setNearFar

public void setNearFar(float near,
                       float far)

Setup the near and far clipping planes.

preRender

public void preRender()

Process code before we render the image Overrides the standard implementation to mark the start time

postRender

public void postRender()

postSwap

public void postSwap()

registerInterest

public void registerInterest(MouseCoordinateSource msc)

Description copied from interface: MouseCoordinateConverter

Register interest in having a coordinate converted

Specified by:

registerInterest in interface MouseCoordinateConverter

Parameters:

msc - The source of the event.

warpMouseCoordinate

public void warpMouseCoordinate(double[] coords)

Warp the provided mouse coordinates into 3d space. Always pass in a 3 component array with x,y holding the mouse coordinate. The array will be filled with an x,y,z value.

Specified by:

warpMouseCoordinate in interface MouseCoordinateConverter

Parameters:

coords - The coordinates to convert.