render
Class RenderPanel

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Panel
                    |
                    +--render.RenderPanel
All Implemented Interfaces:
javax.accessibility.Accessible, java.awt.image.ImageObserver, java.awt.MenuContainer, java.lang.Runnable, java.io.Serializable

public class RenderPanel
extends java.awt.Panel
implements java.lang.Runnable

Provides a panel interface to the Renderer.

It also implements control features dealing with mouse and keyboard interaction.

You can add this as a Component to your application /applet

See Also:
Renderer, Serialized Form

Nested Class Summary
protected  class RenderPanel.KeyHandler
           
protected  class RenderPanel.MouseHandler
          mouse and keyboard handlers
 
Field Summary
protected  double currentTime
          Holds current system time.
protected  double elapsed
          Measures time elapsed from initialization.
 boolean enableLod
          Enables level of detail computation for meshes.
protected  double frameRate
          Contains current frame rate of the renderer
protected  int H
          Image height
protected  java.awt.Image im
          Image framebuffer
protected  boolean isDamage
          Flag to force a renderer refresh when true.
protected  int mx
          Current mouse position
protected  int my
          Current mouse position
 double phi
          Euler angle for camera positioning (vertical view rotation).
 Renderer renderer
          Renderer object
 boolean showFPS
          Flag that determines whether to display current frame rate.
protected  double startTime
          Holds actual time of initialization.
 double theta
          Euler angle for camera positioning (horizontal view rotation).
protected  int W
          Image width
 Geometry world
          root of the scene Geometry
 
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
RenderPanel()
           
 
Method Summary
 void addLight(double x, double y, double z, double r, double g, double b)
          Adds light source with direction (x, y, z) & color (r, g, b).
 void animate(double time)
          Override this to animate.
 void damage()
          Forces a refresh of the renderer.
 Geometry getGeometry(int x, int y)
          Returns the Geometry of the frontmost object at the point (x, y) in the image (like a z-buffer value of geometries).
 boolean getPoint(int x, int y, double[] xyz)
          Returns the location in world space of the point (x, y) on the screen.
 void identity()
          Sets current matrix to the identity matrix.
 void init()
          Initializes the applet and internal variables.
 void initialize()
          Override this to initialize the application program.
 Matrix m()
          Returns the matrix at the top of the stack.
 boolean mouseDown(java.awt.Event event, int x, int y)
          Listener for mouse down.
 boolean mouseDrag(java.awt.Event event, int x, int y)
          Dragging the mouse causes gradual view rotation in the phi and theta directions.
 boolean mouseMove(java.awt.Event event, int x, int y)
          Listener for mouse movement.
 boolean mouseUp(java.awt.Event event, int x, int y)
          Listens for mouse release and controls aspects of the renderer.
 void pop()
          Pops the top matrix from the stack.
 boolean processCommand(int key)
          Handles commands received (generally for unicode commands from the KeyListener, but also for commands from any other sources, like buttons from webpages) : various default control keys to modify render style (Use CTRL + key).
 int pull(Geometry s, double x0, double x1, double x2, double y0, double y1, double y2, double z0, double z1, double z2)
          Deforms a geometric shape according to the beginning, middle, and end parameters in each dimension.
 void push()
          Pushes a copy of the top matrix onto the stack.
 void renderFrame()
           
 void rotate(double t, double x, double y, double z)
          Rotates the top matrix around any axis by angle t (radians).
 void rotateX(double t)
          Rotates the top matrix around the X axis by angle t (radians).
 void rotateY(double t)
          Rotates the top matrix around the Y axis by angle t (radians).
 void rotateZ(double t)
          Rotates the top matrix around the Z axis by angle t (radians).
 void run()
          Renderer thread.
 void scale(double x, double y, double z)
          Scales the top matrix by x, y, z in their respective dimensions.
 void setBgColor(double r, double g, double b)
          Sets the background color ( RGB values range: 0..1).
 void setFL(double value)
          Sets the camera's focal length.
 void setFOV(double value)
          Sets the field of view value.
 void setOpaque(boolean opaque)
           
 void start()
          Starts the renderer thread.
 void stop()
          Stops the renderer thread.
 void transform(Geometry s)
          Applies the top transformation matrix to Geometry s.
 void translate(double[] v)
          Translates the top matrix by vector v.
 void translate(double x, double y, double z)
          Translates the top matrix by x, y, z.
 void update(java.awt.Graphics g)
          Updates the image buffer to output device.
 
Methods inherited from class java.awt.Panel
addNotify, getAccessibleContext
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseEnter, mouseExit, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, 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, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

renderer

public Renderer renderer
Renderer object


world

public Geometry world
root of the scene Geometry


showFPS

public boolean showFPS
Flag that determines whether to display current frame rate.


enableLod

public boolean enableLod
Enables level of detail computation for meshes.


theta

public double theta
Euler angle for camera positioning (horizontal view rotation).


phi

public double phi
Euler angle for camera positioning (vertical view rotation).


mx

protected int mx
Current mouse position


my

protected int my
Current mouse position


W

protected int W
Image width


H

protected int H
Image height


im

protected java.awt.Image im
Image framebuffer


isDamage

protected boolean isDamage
Flag to force a renderer refresh when true.


startTime

protected double startTime
Holds actual time of initialization.


currentTime

protected double currentTime
Holds current system time. Used to compute time elapsed between frames.


elapsed

protected double elapsed
Measures time elapsed from initialization.


frameRate

protected double frameRate
Contains current frame rate of the renderer

Constructor Detail

RenderPanel

public RenderPanel()
Method Detail

animate

public void animate(double time)
Override this to animate.

Parameters:
time - system time

damage

public void damage()
Forces a refresh of the renderer. Sets isDamage true.


setFOV

public void setFOV(double value)
Sets the field of view value.

Parameters:
value -
See Also:
Renderer.setFOV(double value)

setFL

public void setFL(double value)
Sets the camera's focal length.

Parameters:
value - focal length
See Also:
Renderer.setFL(double value)

setBgColor

public void setBgColor(double r,
                       double g,
                       double b)
Sets the background color ( RGB values range: 0..1).

Parameters:
r - red component 0..1
g - green component 0..1
b - blue component 0..1

setOpaque

public void setOpaque(boolean opaque)

addLight

public void addLight(double x,
                     double y,
                     double z,
                     double r,
                     double g,
                     double b)
Adds light source with direction (x, y, z) & color (r, g, b).

Arguments x,y,z indicate light direction. Arguments r,g,b indicate light direction.

See Also:
Renderer.addLight(double x,double y,double z, double r,double g,double b)

identity

public void identity()
Sets current matrix to the identity matrix.


m

public Matrix m()
Returns the matrix at the top of the stack.

Returns:
the top matrix on the stack

pop

public void pop()
Pops the top matrix from the stack.


push

public void push()
Pushes a copy of the top matrix onto the stack.


rotateX

public void rotateX(double t)
Rotates the top matrix around the X axis by angle t (radians).

Parameters:
t - angle in radians

rotateY

public void rotateY(double t)
Rotates the top matrix around the Y axis by angle t (radians).

Parameters:
t - angle in radians

rotateZ

public void rotateZ(double t)
Rotates the top matrix around the Z axis by angle t (radians).

Parameters:
t - angle in radians

rotate

public void rotate(double t,
                   double x,
                   double y,
                   double z)
Rotates the top matrix around any axis by angle t (radians).

Parameters:
t - angle in radians
x -
y -
z -

scale

public void scale(double x,
                  double y,
                  double z)
Scales the top matrix by x, y, z in their respective dimensions.

Parameters:
x - x scale factor
y - y scale factor
z - z scale factor

transform

public void transform(Geometry s)
Applies the top transformation matrix to Geometry s.

Parameters:
s - Geometry object

translate

public void translate(double[] v)
Translates the top matrix by vector v.

Parameters:
v - an array of three doubles representing translations in the x,y,z directions.

translate

public void translate(double x,
                      double y,
                      double z)
Translates the top matrix by x, y, z.

Parameters:
x - - translation in the x direction.
y - - translation in the y direction.
z - - translation in the z direction.

pull

public int pull(Geometry s,
                double x0,
                double x1,
                double x2,
                double y0,
                double y1,
                double y2,
                double z0,
                double z1,
                double z2)
Deforms a geometric shape according to the beginning, middle, and end parameters in each dimension. For each dimesion the three parameters indicate the amount of deformation at each position.

0 - beginning, 1 - middle, 2 - end. To indicate infinity (a constant transformation) set two adjacent parameters to the same value. Setting all three parameters to the same value transforms the shape geometry consistently across the entire axis of the parameters.

Parameters:
s - shape object to be deformed
x0 - location of the beginning of deformation along the x axis
x1 - location of the middle of deformation along the x axis
x2 - location of the end of deformation along the x axis
y0 - location of the beginning of deformation along the y axis
y1 - location of the middle of deformation along the y axis
y2 - location of the end of deformation along the y axis
z0 - location of the beginning of deformation along the z axis
z1 - location of the middle of deformation along the z axis
z2 - location of the end of deformation along the z axis
Returns:
1 if pull operation was successful, 0 otherwise
See Also:
Geometry.pull(render.Matrix, double, double, double, double, double, double, double, double, double)

init

public void init()
Initializes the applet and internal variables. To initialize components of the application program use initialize().

See Also:
initialize()

initialize

public void initialize()
Override this to initialize the application program.


start

public void start()
Starts the renderer thread.


stop

public void stop()
Stops the renderer thread.


run

public void run()
Renderer thread.

Specified by:
run in interface java.lang.Runnable

renderFrame

public void renderFrame()

update

public void update(java.awt.Graphics g)
Updates the image buffer to output device.

Overrides:
update in class java.awt.Container
Parameters:
g - Specifies the output device.

getGeometry

public Geometry getGeometry(int x,
                            int y)
Returns the Geometry of the frontmost object at the point (x, y) in the image (like a z-buffer value of geometries).

Parameters:
x - x coordinate in the image
y - y coordinate in the image
Returns:
the geometry of the foremost object at that location

getPoint

public boolean getPoint(int x,
                        int y,
                        double[] xyz)
Returns the location in world space of the point (x, y) on the screen.

Parameters:
x - x coordinate in the image
y - y coordinate in the image
Returns:
true if there is an object at x, y , false otherwise

mouseMove

public boolean mouseMove(java.awt.Event event,
                         int x,
                         int y)
Listener for mouse movement.

If mouse is placed in the lower left cornder it displays the framerate.

Overrides:
mouseMove in class java.awt.Component
Returns:
true

mouseDown

public boolean mouseDown(java.awt.Event event,
                         int x,
                         int y)
Listener for mouse down.

Mouse down starts a view rotation.

Overrides:
mouseDown in class java.awt.Component
Returns:
true

mouseDrag

public boolean mouseDrag(java.awt.Event event,
                         int x,
                         int y)
Dragging the mouse causes gradual view rotation in the phi and theta directions.

Overrides:
mouseDrag in class java.awt.Component
Parameters:
event - Event
x - - new x coordinate
y - - new y coordinate

mouseUp

public boolean mouseUp(java.awt.Event event,
                       int x,
                       int y)
Listens for mouse release and controls aspects of the renderer.

A release in the upper left corner toggles Renderer.tableMode.

A release in the upper right corner toggle visibility of the Material.table display. When true, the current material table is displayed in the upper left corner of the window. Position of the mouse determines current material.

A release in the lower right toggles Renderer.showMesh

Overrides:
mouseUp in class java.awt.Component
Parameters:
event - Event
x - current x coordinate
y - current y coordinate
Returns:
true

processCommand

public boolean processCommand(int key)
Handles commands received (generally for unicode commands from the KeyListener, but also for commands from any other sources, like buttons from webpages) : various default control keys to modify render style (Use CTRL + key).

'e' - toggles Renderer.showMesh, that just displays the shapes as mesh wireframes
'l' - toggles Renderer.getOutline() which produces a sketch-line drawing rendition of the scene
'm' - toggles Renderer.seeMesh which determines mesh visibility
't' - toggles global texture manipulation method (MIP on/off) (@link Texture#useMIP)

Parameters:
key - value of the key released
Returns:
true if one of the above keys was just released, false otherwise.