|
Aviatrix3D 1.0 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.j3d.aviatrix3d.surface.SimpleAWTSurface
Implementation of the most basic drawable surface, supporting the minimal number of features.
This implementation of DrawableSurface renders to a normal GLCanvas instance and provides pBuffer support as needed. Stereo support is not provided and all associated methods always indicate negative returns on query about support.
Field Summary |
Fields inherited from interface org.j3d.aviatrix3d.DrawableSurface |
ALTERNATE_FRAME_STEREO, NO_STEREO, QUAD_BUFFER_STEREO, TWO_CANVAS_STEREO |
Constructor Summary | |
SimpleAWTSurface(net.java.games.jogl.GLCapabilities caps)
Construct a surface that requires the given set of capabilities. |
|
SimpleAWTSurface(net.java.games.jogl.GLCapabilities caps,
SimpleAWTSurface sharedWith)
Construct a surface shares it's GL context with the given surface. |
Method Summary | |
void |
checkForExtension(java.lang.String glExtensionString)
Add an extension string to check for at startup. |
void |
display(net.java.games.jogl.GLDrawable drawable)
Not used in this implementation |
void |
displayChanged(net.java.games.jogl.GLDrawable drawable,
boolean modeChanged,
boolean deviceChanged)
Not used in this implementation |
void |
dispose()
Instruct this surface that you have finished with the resources needed and to dispose all rendering resources. |
void |
draw()
Instruct the surface to draw the collected set of nodes now. |
void |
getCenterEyeInSurface(javax.vecmath.Point3f position)
Get the Center Eye position in surface coordinates. |
void |
getPixelLocationInSurface(float x,
float y,
javax.vecmath.Point3f position)
Convert a pixel location to surface coordinates. |
float |
getStereoEyeSeparation()
Get the current eye separation value - always returns 0. |
int |
getStereoRenderingPolicy()
Get the current stereo rendering policy in use. |
java.lang.Object |
getSurfaceObject()
Get the underlying object that this surface is rendered to. |
void |
getSurfaceToVWorld(javax.vecmath.Matrix4f matrix)
Get the surface to VWorld transformation matrix. |
void |
init(net.java.games.jogl.GLDrawable drawable)
Called by the drawable immediately after the OpenGL context is initialized; the GLContext has already been made current when this method is called. |
boolean |
isQuadStereoAvailable()
Check to see whether this surface supports Quad buffer stereo rendering - which it does not. |
boolean |
isShared()
Check to see whether this object is currently shared. |
boolean |
isStereoAvailable()
Check to see whether this surface supports stereo rendering - which is does not. |
void |
queueDeletedObject(DeletableSceneGraphObject obj)
An object has been detected as being deleted (no internal or external references to it left) and it needs to be cleaned up. |
void |
queueShaderRequests(ShaderSceneGraphObject[] initList,
int numInit,
ShaderSceneGraphObject[] logList,
int numLog)
Queue up a collection of shader objects for processing on the next frame. |
void |
reshape(net.java.games.jogl.GLDrawable drawable,
int x,
int y,
int width,
int height)
Not used in this implementation |
void |
setClearColor(float r,
float g,
float b,
float a)
Set the background colour that this surface should be cleared to before the drawing step. |
void |
setDrawableObjects(RenderInstructions[] commands,
int numValid)
Update the list of items to be rendered to the current list. |
void |
setRenderControlThread(java.lang.Thread th)
Tell the surface to use the given thread as the rendering control thread. |
void |
setStereoEyeSeparation(float sep)
Set the eye separation value when rendering stereo. |
void |
setStereoRenderingPolicy(int policy)
Set the rendering policy used when handling stereo. |
void |
swap()
Swap the buffers now if the surface supports multiple buffer drawing. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public SimpleAWTSurface(net.java.games.jogl.GLCapabilities caps)
caps
- A set of required capabilities for this canvas.public SimpleAWTSurface(net.java.games.jogl.GLCapabilities caps, SimpleAWTSurface sharedWith)
If the sharedWith parameter is null, then this is just treated as an ordinary non-shared frame. The return flag will be set appropriately.
caps
- A set of required capabilities for this canvas.sharedWith
- The surface that you'd like this surface to share
the GL context with, if possible. May be null.Method Detail |
public boolean isStereoAvailable()
isStereoAvailable
in interface DrawableSurface
public boolean isQuadStereoAvailable()
isQuadStereoAvailable
in interface DrawableSurface
public void setStereoEyeSeparation(float sep)
setStereoEyeSeparation
in interface DrawableSurface
sep
- The amount of eye separationpublic float getStereoEyeSeparation()
getStereoEyeSeparation
in interface DrawableSurface
public void setStereoRenderingPolicy(int policy)
setStereoRenderingPolicy
in interface DrawableSurface
policy
- The policy to currently use
java.lang.IllegalArgumentException
- The policy type is not one of the legal
selections.public int getStereoRenderingPolicy()
NO_STEREO
.
getStereoRenderingPolicy
in interface DrawableSurface
public void queueDeletedObject(DeletableSceneGraphObject obj)
cleanup()
method called and then the
reference to it should be discarded.
queueDeletedObject
in interface DrawableSurface
obj
- The instance to be queued for deletionpublic void queueShaderRequests(ShaderSceneGraphObject[] initList, int numInit, ShaderSceneGraphObject[] logList, int numLog)
queueShaderRequests
in interface DrawableSurface
initList
- The shaders needing initialisationnumInit
- The number of shaders needing initialisationlogList
- The shaders needing log fetchingnumLog
- The number of shaders needing log fetchingpublic void setClearColor(float r, float g, float b, float a)
setClearColor
in interface DrawableSurface
r
- The red component of the background clear colourg
- The green component of the background clear colourb
- The blue component of the background clear coloura
- The alpha component of the background clear colourpublic void setDrawableObjects(RenderInstructions[] commands, int numValid)
setDrawableObjects
in interface DrawableSurface
commands
- The list of drawable surfaces to rendernumValid
- The number of valid items in the arraypublic void draw()
draw
in interface DrawableSurface
public void swap()
swap
in interface DrawableSurface
public java.lang.Object getSurfaceObject()
getSurfaceObject
in interface DrawableSurface
public void getSurfaceToVWorld(javax.vecmath.Matrix4f matrix)
getSurfaceToVWorld
in interface DrawableSurface
matrix
- The matrix instance to copy intopublic void getPixelLocationInSurface(float x, float y, javax.vecmath.Point3f position)
getPixelLocationInSurface
in interface DrawableSurface
x
- The X coordinatey
- The Y coordinateposition
- The converted position. It must be preallocated.public void getCenterEyeInSurface(javax.vecmath.Point3f position)
getCenterEyeInSurface
in interface DrawableSurface
position
- The current eye position. It must be preallocated.public void dispose()
dispose
in interface DrawableSurface
public void setRenderControlThread(java.lang.Thread th)
setRenderControlThread
in interface DrawableSurface
th
- The render control thread instance to use or nullpublic void init(net.java.games.jogl.GLDrawable drawable)
init
in interface net.java.games.jogl.GLEventListener
drawable
- The display context to render topublic void reshape(net.java.games.jogl.GLDrawable drawable, int x, int y, int width, int height)
reshape
in interface net.java.games.jogl.GLEventListener
drawable
- The display context to render topublic void displayChanged(net.java.games.jogl.GLDrawable drawable, boolean modeChanged, boolean deviceChanged)
displayChanged
in interface net.java.games.jogl.GLEventListener
drawable
- The display context to render topublic void display(net.java.games.jogl.GLDrawable drawable)
display
in interface net.java.games.jogl.GLEventListener
drawable
- The display context to render topublic void checkForExtension(java.lang.String glExtensionString)
glExtensionString
- String to check for being validpublic boolean isShared()
|
Aviatrix3D 1.0 | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |