geomss.app

Class GeomSSCanvas3D

java.lang.Object

Canvas3D

jahuwaldt.j3d.ImageCaptureCanvas3D

jahuwaldt.j3d.BGFGCanvas3D

geomss.app.GeomSSCanvas3D

All Implemented Interfaces:

java.awt.print.Printable

public class GeomSSCanvas3D
extends BGFGCanvas3D
implements java.awt.print.Printable

The 3D canvas used by this application to display the user's geometry.

Modified by: Joseph A. Huwaldt

Version:

November 23, 2015

Author:

Joseph A. Huwaldt, Date: April 14, 2009

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GeomSSCanvas3D.PDViewAngle Pre-defined view angles used with setView.

Field Summary

Fields inherited from interface java.awt.print.Printable

NO_SUCH_PAGE, PAGE_EXISTS

Constructor Summary

Constructors

Constructor and Description
GeomSSCanvas3D(GeomElement geometry, int width, int height) Constructs and initializes a new Canvas3D object that Java 3D can render into.

Method Summary

Modifier and Type	Method and Description
void	addTransformChangeListener(TransformChangeListener listener) Add a TransformChangeListener to this canvas.
GeomSSScene	getScene()
void	postSwap() Process code after we have swapped the image to the foreground.
int	print(java.awt.Graphics graphics, java.awt.print.PageFormat pageFormat, int pageIndex) Prints the 3D model image from this canvas to the specified Graphics context using the specified page format.
void	removeTransformChangeListener(TransformChangeListener listener) Remove a TransformChangeListener from this canvas.
void	setView(GeomSSCanvas3D.PDViewAngle viewAngle) Set the viewing angle for this canvas to one of the pre-set angles.
void	waitForRendering(long timeout) Causes the calling thread to wait until either the current rendering is complete, or until the specified amount of time has elapsed.

Methods inherited from class jahuwaldt.j3d.BGFGCanvas3D

addBackground, addOverlay, clearBackgrounds, clearOverlays, getBackground, getNumberBackgrounds, getNumberOverlays, getOverlay, postRender, preRender, removeBackground, removeBackground, removeOverlay, removeOverlay, setBackground, setOverlay

Methods inherited from class jahuwaldt.j3d.ImageCaptureCanvas3D

addCaptureObserver, removeCaptureObserver

Methods inherited from class java.lang.Object

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

Constructor Detail

GeomSSCanvas3D

public GeomSSCanvas3D(GeomElement geometry,
                      int width,
                      int height)

Constructs and initializes a new Canvas3D object that Java 3D can render into.

Parameters:

geometry - The geometry to be displayed.

width - The width of the canvas (must be > 0).

height - The height of the canvas (must be > 0).

Throws:

java.lang.IllegalArgumentException - if the specified GraphicsConfiguration does not support 3D rendering

Method Detail

getScene

public GeomSSScene getScene()

Returns:

the 3D scene displayed in this canvas (for use in BeanShell primarily).

setView

public void setView(GeomSSCanvas3D.PDViewAngle viewAngle)

Set the viewing angle for this canvas to one of the pre-set angles.

Parameters:

viewAngle - The pre-defined viewing angle for this canvas.

addTransformChangeListener

public void addTransformChangeListener(TransformChangeListener listener)

Add a TransformChangeListener to this canvas.

Parameters:

listener - The transform change listener to add.

removeTransformChangeListener

public void removeTransformChangeListener(TransformChangeListener listener)

Remove a TransformChangeListener from this canvas.

Parameters:

listener - The transform change listener to remove.

print

public int print(java.awt.Graphics graphics,
                 java.awt.print.PageFormat pageFormat,
                 int pageIndex)
          throws java.awt.print.PrinterException

Prints the 3D model image from this canvas to the specified Graphics context using the specified page format. This method is called by a PrinerJob and should not be called directly by users.

Specified by:

print in interface java.awt.print.Printable

Parameters:

graphics - the context into which the page is drawn

pageFormat - the size and orientation of the page being drawn

pageIndex - the zero based index of the page to be drawn.

Returns:

PAGE_EXISTS if the page is rendered successfully or NO_SUCH_PAGE if pageIndex specifies a non-existent page.

Throws:

java.awt.print.PrinterException

postSwap

public void postSwap()

Process code after we have swapped the image to the foreground.

Overrides:

postSwap in class ImageCaptureCanvas3D

waitForRendering

public void waitForRendering(long timeout)
                      throws java.lang.IllegalArgumentException

Causes the calling thread to wait until either the current rendering is complete, or until the specified amount of time has elapsed. If the calling thread is interrupted by any thread before or while it is waiting, then this method will simply return immediately.

Parameters:

timeout - the maximum time to wait in milliseconds.

Throws:

java.lang.IllegalArgumentException - if the value of timeout is negative.