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, RenderablePanel, java.io.Serializable

public class RenderPanel

extends java.awt.Panel

implements RenderablePanel

See Also:

Serialized Form

Field Summary

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(Renderable r)

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).
Widget	addMenu(java.lang.String label, int x, int y) adds a menu widget
void	addMenu(Widget menu) adds a menu
void	damage()
boolean	equals(java.lang.Object obj)
double	getCurrentTime() returns the current system time in seconds
double	getFL() focal length
double	getFOV() field of view
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	getGeometryBuffer() status of the geometry z-buffer, for object picking
int	getLod() level of detail
Matrix[]	getMatrix() the matrix stack
boolean	getOutline() get status of flag which produces the sketch-line drawing rendition of the scene
int[]	getPix() the pixel array
boolean	getPoint(int x, int y, double[] xyz) Returns the location in world space of the point (x, y) on the screen.
Renderable	getRenderable() (@link Renderable} Renderable
Renderer	getRenderer() Rendererobject
boolean	getTableMode() flag that determines whether the normal tables should beprecomputed
Geometry	getWorld() the root world geometry
int	hashCode()
void	identity() Sets current matrix to the identity matrix.
void	init() Initializes the renderer and internal variables; to initialize your model see Renderable.initialize()
void	init(int width, int height)
boolean	isDragging() Returns whether dragging is active or not.
boolean	keyUp(java.awt.Event evt, int key)
Matrix	m() Returns the matrix at the top of the stack.
Widget	menu(int i) returns the menu at index i
void	mouseClicked(java.awt.Event e, int x, int y)
boolean	mouseDown(java.awt.Event evt, int x, int y)
boolean	mouseDrag(java.awt.Event evt, int x, int y)
void	mouseDragged(java.awt.Event e, int x, int y)
void	mouseEntered(java.awt.Event e, int x, int y)
void	mouseExited(java.awt.Event e, int x, int y)
boolean	mouseMove(java.awt.Event evt, int x, int y)
void	mouseMoved(java.awt.Event e, int x, int y)
void	mousePressed(java.awt.Event e, int x, int y)
void	mouseReleased(java.awt.Event e, int x, int y)
boolean	mouseUp(java.awt.Event evt, int x, int y)
void	mouseWheelMoved(java.awt.event.MouseWheelEvent e, int rotation)
void	pause() pauses the renderer thread
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	recalculateSize(int currentWidth, int currentHeight) called upon a resize of the component
void	refresh() Forces a refresh of the renderer.
void	removeMenu(Widget menu) removes a particular menu
void	rotateView(double theta, double phi) Rotate angle of view.
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()
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	setDragging(boolean value) If the user is interactively dragging the mouse, we want the renderer to know about it, so that any other background process (eg: a material which is building a lookup table) can ask the renderer, and thereby avoid consuming scarce CPU resources simultaneously.
void	setFL(double value) Sets the camera's focal length.
void	setFOV(double value) Sets the field of view value.
void	setGeometryBuffer(boolean value) enables/disables the geometry z-buffer, for object picking
void	setLod(int value) set the level of detail
void	setOutline(boolean value) toggle outline mode
void	setRenderable(Renderable renderable) set the renderable object
void	setTableMode(boolean value) toggle table lookup mode and precomputation
void	showMesh(boolean value) toggle the wireframe view of the world
void	start() starts the renderer thread
void	stop()
java.lang.String	toString()
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 vector v.
void	update(java.awt.Graphics g)
Widget	widgetAt(int x, int y) returns the widget at x, y

Methods inherited from class java.awt.Panel

addNotify, getAccessibleContext

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, 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, preferredSize, print, printComponents, remove, remove, removeAll, removeContainerListener, removeNotify, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, dispatchEvent, enable, enable, enableInputMethods, 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, list, list, list, location, lostFocus, mouseEnter, mouseExit, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, 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, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface render.RenderablePanel

addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, createImage, createImage, getHeight, getWidth, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint

Constructor Detail

RenderPanel

public RenderPanel(Renderable r)

Method Detail

getRenderable

public Renderable getRenderable()

Description copied from interface: RenderablePanel

(@link Renderable} Renderable

Specified by:

getRenderable in interface RenderablePanel

Returns:

setRenderable

public void setRenderable(Renderable renderable)

Description copied from interface: RenderablePanel

set the renderable object

Specified by:

setRenderable in interface RenderablePanel

Parameters:

renderable -

addLight

public void addLight(double x,
                     double y,
                     double z,
                     double r,
                     double g,
                     double b)

Description copied from interface: RenderablePanel

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.

Specified by:

addLight in interface RenderablePanel

See Also:

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

addMenu

public Widget addMenu(java.lang.String label,
                      int x,
                      int y)

Description copied from interface: RenderablePanel

adds a menu widget

Specified by:

addMenu in interface RenderablePanel

Parameters:

label -

x -

y -

Returns:

addMenu

public void addMenu(Widget menu)

Description copied from interface: RenderablePanel

adds a menu

Specified by:

addMenu in interface RenderablePanel

Parameters:

menu -

damage

public void damage()

equals

public boolean equals(java.lang.Object obj)

getCurrentTime

public double getCurrentTime()

Description copied from interface: RenderablePanel

returns the current system time in seconds

Specified by:

getCurrentTime in interface RenderablePanel

Returns:

getFOV

public double getFOV()

Description copied from interface: RenderablePanel

field of view

Specified by:

getFOV in interface RenderablePanel

Returns:

getFL

public double getFL()

Description copied from interface: RenderablePanel

focal length

Specified by:

getFL in interface RenderablePanel

Returns:

getGeometry

public Geometry getGeometry(int x,
                            int y)

Description copied from interface: RenderablePanel

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

Specified by:

getGeometry in interface RenderablePanel

Parameters:

x - x coordinate in the image

y - y coordinate in the image

Returns:

the geometry of the foremost object at that location

getMatrix

public Matrix[] getMatrix()

Description copied from interface: RenderablePanel

the matrix stack

Specified by:

getMatrix in interface RenderablePanel

Returns:

getPix

public int[] getPix()

Description copied from interface: RenderablePanel

the pixel array

Specified by:

getPix in interface RenderablePanel

Returns:

getPoint

public boolean getPoint(int x,
                        int y,
                        double[] xyz)

Description copied from interface: RenderablePanel

Returns the location in world space of the point (x, y) on the screen.

Specified by:

getPoint in interface RenderablePanel

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

getWorld

public Geometry getWorld()

Description copied from interface: RenderablePanel

the root world geometry

Specified by:

getWorld in interface RenderablePanel

Returns:

hashCode

public int hashCode()

identity

public void identity()

Description copied from interface: RenderablePanel

Sets current matrix to the identity matrix.

Specified by:

identity in interface RenderablePanel

init

public void init()

Description copied from interface: RenderablePanel

Initializes the renderer and internal variables; to initialize your model see Renderable.initialize()

Specified by:

init in interface RenderablePanel

See Also:

#Renderable.initialize()

keyUp

public boolean keyUp(java.awt.Event evt,
                     int key)

m

public Matrix m()

Description copied from interface: RenderablePanel

Returns the matrix at the top of the stack.

Specified by:

m in interface RenderablePanel

Returns:

the top matrix on the stack

menu

public Widget menu(int i)

Description copied from interface: RenderablePanel

returns the menu at index i

Specified by:

menu in interface RenderablePanel

Parameters:

i -

Returns:

mouseDown

public boolean mouseDown(java.awt.Event evt,
                         int x,
                         int y)

mouseDrag

public boolean mouseDrag(java.awt.Event evt,
                         int x,
                         int y)

mouseMove

public boolean mouseMove(java.awt.Event evt,
                         int x,
                         int y)

mouseUp

public boolean mouseUp(java.awt.Event evt,
                       int x,
                       int y)

pause

public void pause()

Description copied from interface: RenderablePanel

pauses the renderer thread

Specified by:

pause in interface RenderablePanel

pop

public void pop()

Description copied from interface: RenderablePanel

Pops the top matrix from the stack.

Specified by:

pop in interface RenderablePanel

pull

public int pull(Geometry s,
                double x0,
                double x1,
                double x2,
                double y0,
                double y1,
                double y2,
                double z0,
                double z1,
                double z2)

Description copied from interface: RenderablePanel

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.

Specified by:

pull in interface RenderablePanel

Parameters:

s - shape object to be deformed

x0 - location of beginning of deformation along the x axis

x1 - location of beginning of deformation along the x axis

x2 - location of beginning of deformation along the x axis

y0 - location of beginning of deformation along the y axis

y1 - location of beginning of deformation along the y axis

y2 - location of beginning of deformation along the y axis

z0 - location of beginning of deformation along the z axis

z1 - location of beginning of deformation along the z axis

z2 - location of beginning 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)

push

public void push()

Description copied from interface: RenderablePanel

Pushes a copy of the top matrix onto the stack.

Specified by:

push in interface RenderablePanel

processCommand

public boolean processCommand(int key)

Description copied from interface: RenderablePanel

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

Specified by:

processCommand in interface RenderablePanel

Parameters:

key - value of the key released

Returns:

true if one of the above keys was just released, false otherwise.

recalculateSize

public void recalculateSize(int currentWidth,
                            int currentHeight)

Description copied from interface: RenderablePanel

called upon a resize of the component

Specified by:

recalculateSize in interface RenderablePanel

Parameters:

currentWidth -

currentHeight -

removeMenu

public void removeMenu(Widget menu)

Description copied from interface: RenderablePanel

removes a particular menu

Specified by:

removeMenu in interface RenderablePanel

Parameters:

menu -

rotateX

public void rotateX(double t)

Description copied from interface: RenderablePanel

Rotates the top matrix around the X axis by angle t (radians).

Specified by:

rotateX in interface RenderablePanel

Parameters:

t - angle in radians

rotateY

public void rotateY(double t)

Description copied from interface: RenderablePanel

Rotates the top matrix around the Y axis by angle t (radians).

Specified by:

rotateY in interface RenderablePanel

Parameters:

t - angle in radians

rotateZ

public void rotateZ(double t)

Description copied from interface: RenderablePanel

Rotates the top matrix around the Z axis by angle t (radians).

Specified by:

rotateZ in interface RenderablePanel

Parameters:

t - angle in radians

run

public void run()

scale

public void scale(double x,
                  double y,
                  double z)

Description copied from interface: RenderablePanel

Scales the top matrix by x, y, z in their respective dimensions.

Specified by:

scale in interface RenderablePanel

Parameters:

x - x scale factor

y - y scale factor

z - z scale factor

setFL

public void setFL(double value)

Description copied from interface: RenderablePanel

Sets the camera's focal length.

Specified by:

setFL in interface RenderablePanel

Parameters:

value - focal length

setFOV

public void setFOV(double value)

Description copied from interface: RenderablePanel

Sets the field of view value.

Specified by:

setFOV in interface RenderablePanel

Parameters:

value -

start

public void start()

Description copied from interface: RenderablePanel

starts the renderer thread

Specified by:

start in interface RenderablePanel

stop

public void stop()

toString

public java.lang.String toString()

transform

public void transform(Geometry s)

Description copied from interface: RenderablePanel

Applies the top transformation matrix to Geometry s.

Specified by:

transform in interface RenderablePanel

Parameters:

s - Geometry object

translate

public void translate(double x,
                      double y,
                      double z)

Description copied from interface: RenderablePanel

Translates the top matrix by vector v.

Specified by:

translate in interface RenderablePanel

Parameters:

x - translation along the x axis

y - translation along the y axis

z - translation along the z axis

translate

public void translate(double[] v)

Description copied from interface: RenderablePanel

Translates the top matrix by vector v.

Specified by:

translate in interface RenderablePanel

Parameters:

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

update

public void update(java.awt.Graphics g)

widgetAt

public Widget widgetAt(int x,
                       int y)

Description copied from interface: RenderablePanel

returns the widget at x, y

Specified by:

widgetAt in interface RenderablePanel

Parameters:

x -

y -

Returns:

getRenderer

public Renderer getRenderer()

Description copied from interface: RenderablePanel

Rendererobject

Specified by:

getRenderer in interface RenderablePanel

See Also:

RenderablePanel.getRenderer()

refresh

public void refresh()

Description copied from interface: RenderablePanel

Forces a refresh of the renderer. Sets isDamage true.

Specified by:

refresh in interface RenderablePanel

See Also:

RenderablePanel.refresh()

setBgColor

public void setBgColor(double r,
                       double g,
                       double b)

Description copied from interface: RenderablePanel

Sets the background color ( RGB values range: 0..1).

Specified by:

setBgColor in interface RenderablePanel

Parameters:

r - red component 0..1

g - green component 0..1

b - blue component 0..1

See Also:

RenderablePanel.setBgColor(double, double, double)

init

public void init(int width,
                 int height)

See Also:

render.RenderablePanel#init(int, int)

rotateView

public void rotateView(double theta,
                       double phi)

Description copied from interface: RenderablePanel

Rotate angle of view.

Specified by:

rotateView in interface RenderablePanel

Parameters:

theta -

phi -

See Also:

RenderablePanel.rotateView(double, double)

getLod

public int getLod()

Description copied from interface: RenderablePanel

level of detail

Specified by:

getLod in interface RenderablePanel

Returns:

See Also:

RenderablePanel.getLod()

setLod

public void setLod(int value)

Description copied from interface: RenderablePanel

set the level of detail

Specified by:

setLod in interface RenderablePanel

Parameters:

value -

See Also:

RenderablePanel.setLod(int)

getGeometryBuffer

public boolean getGeometryBuffer()

Description copied from interface: RenderablePanel

status of the geometry z-buffer, for object picking

Specified by:

getGeometryBuffer in interface RenderablePanel

Returns:

See Also:

RenderablePanel.getGeometryBuffer()

setGeometryBuffer

public void setGeometryBuffer(boolean value)

Description copied from interface: RenderablePanel

enables/disables the geometry z-buffer, for object picking

Specified by:

setGeometryBuffer in interface RenderablePanel

Parameters:

value - on/off

See Also:

RenderablePanel.setGeometryBuffer(boolean)

setDragging

public void setDragging(boolean value)

Description copied from interface: RenderablePanel

If the user is interactively dragging the mouse, we want the renderer to know about it, so that any other background process (eg: a material which is building a lookup table) can ask the renderer, and thereby avoid consuming scarce CPU resources simultaneously.

Specified by:

setDragging in interface RenderablePanel

See Also:

RenderablePanel.setDragging(boolean)

isDragging

public boolean isDragging()

Description copied from interface: RenderablePanel

Returns whether dragging is active or not.

Specified by:

isDragging in interface RenderablePanel

Returns:

true when dragging is active, false otherwise

See Also:

RenderablePanel.isDragging()

setTableMode

public void setTableMode(boolean value)

Description copied from interface: RenderablePanel

toggle table lookup mode and precomputation

Specified by:

setTableMode in interface RenderablePanel

Parameters:

value -

See Also:

RenderablePanel.setTableMode(boolean)

getTableMode

public boolean getTableMode()

Description copied from interface: RenderablePanel

flag that determines whether the normal tables should beprecomputed

Specified by:

getTableMode in interface RenderablePanel

Returns:

See Also:

RenderablePanel.getTableMode()

showMesh

public void showMesh(boolean value)

Description copied from interface: RenderablePanel

toggle the wireframe view of the world

Specified by:

showMesh in interface RenderablePanel

Parameters:

value -

See Also:

RenderablePanel.showMesh(boolean)

setOutline

public void setOutline(boolean value)

Description copied from interface: RenderablePanel

toggle outline mode

Specified by:

setOutline in interface RenderablePanel

Parameters:

value -

See Also:

RenderablePanel.setOutline(boolean)

getOutline

public boolean getOutline()

Description copied from interface: RenderablePanel

get status of flag which produces the sketch-line drawing rendition of the scene

Specified by:

getOutline in interface RenderablePanel

Returns:

See Also:

RenderablePanel.getOutline()

mouseEntered

public void mouseEntered(java.awt.Event e,
                         int x,
                         int y)

Specified by:

mouseEntered in interface RenderablePanel

See Also:

RenderablePanel.mouseEntered(java.awt.Event, int, int)

mouseExited

public void mouseExited(java.awt.Event e,
                        int x,
                        int y)

Specified by:

mouseExited in interface RenderablePanel

See Also:

RenderablePanel.mouseExited(java.awt.Event, int, int)

mousePressed

public void mousePressed(java.awt.Event e,
                         int x,
                         int y)

Specified by:

mousePressed in interface RenderablePanel

See Also:

RenderablePanel.mousePressed(java.awt.Event, int, int)

mouseReleased

public void mouseReleased(java.awt.Event e,
                          int x,
                          int y)

Specified by:

mouseReleased in interface RenderablePanel

See Also:

RenderablePanel.mouseReleased(java.awt.Event, int, int)

mouseClicked

public void mouseClicked(java.awt.Event e,
                         int x,
                         int y)

Specified by:

mouseClicked in interface RenderablePanel

See Also:

RenderablePanel.mouseClicked(java.awt.Event, int, int)

mouseDragged

public void mouseDragged(java.awt.Event e,
                         int x,
                         int y)

Specified by:

mouseDragged in interface RenderablePanel

See Also:

RenderablePanel.mouseDragged(java.awt.Event, int, int)

mouseMoved

public void mouseMoved(java.awt.Event e,
                       int x,
                       int y)

Specified by:

mouseMoved in interface RenderablePanel

See Also:

RenderablePanel.mouseMoved(java.awt.Event, int, int)

mouseWheelMoved

public void mouseWheelMoved(java.awt.event.MouseWheelEvent e,
                            int rotation)

Specified by:

mouseWheelMoved in interface RenderablePanel

See Also:

render.RenderablePanel#mouseWheelMoved(java.awt.event.MouseEvent, int)