|
j3d.org Aviatrix3D | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.j3d.aviatrix3d.SceneGraphObject
org.j3d.aviatrix3d.Node
org.j3d.aviatrix3d.Leaf
org.j3d.aviatrix3d.Viewpoint
A viewpoint into the scene.
Viewpoints have their own implicit directional light (a headlight) that is controlled separately to the normal in-scenegraph lights. Lights are scoped by default and thus having the viewpoint also have a light following it around is a pain to deal with, you can select on directly on the viewpoint itself. This light is always pointing down the Z axis in the local coordinate system.
In addition to the headlight, a separate ambient light colour may be provided. Although this is provided, note that whether it has any effect is dependent on whether lighting is enabled on the object being rendered.
Field Summary |
Fields inherited from class org.j3d.aviatrix3d.Node |
bounds, implicitBounds, INVALID_BOUNDS, parent |
Fields inherited from class org.j3d.aviatrix3d.SceneGraphObject |
alive, updateHandler, WRITE_TIMING_MSG |
Constructor Summary | |
Viewpoint()
The default constructor where the headlight is implicitly turned off, and the default light type is directional. |
Method Summary | |
void |
getGlobalAmbientColor(float[] col)
Retrieve the current colour value from the light. |
boolean |
isDirectionalLight()
Get the current state of the headlight type. |
boolean |
isGlobalAmbientLightEnabled()
Get the current state of the global ambient light usage. |
boolean |
isHeadlightEnabled()
Get the current state of the headlight usage. |
protected void |
markBoundsDirty()
Mark this node as having dirty bounds due to one of it's children having their bounds changed. |
void |
postRender(net.java.games.jogl.GL gl,
net.java.games.jogl.GLU glu)
|
void |
render(net.java.games.jogl.GL gl,
net.java.games.jogl.GLU glu)
This method is called to render this node. |
void |
setGlobalAmbientColor(float[] col)
Set the ambient colour to the new value. |
void |
setGlobalAmbientLightEnabled(boolean state)
Turn the global ambient lighting setting on or off. |
void |
setHeadlightEnabled(boolean state)
Turn the local headlight on/off. |
void |
setHeadlightType(boolean state)
Change the style of the headlight between directional and spot types. |
Methods inherited from class org.j3d.aviatrix3d.Node |
boundsChanged, checkForCyclicParent, getBounds, getParent, recomputeBounds, removeParent, setBounds, setLive, setParent, updateBounds |
Methods inherited from class org.j3d.aviatrix3d.SceneGraphObject |
checkForCyclicChild, dataChanged, getUserData, isLive, setUpdateHandler, setUserData |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public Viewpoint()
Method Detail |
public boolean isHeadlightEnabled()
public void setHeadlightEnabled(boolean state) throws InvalidWriteTimingException
state
- true to turn the light on
InvalidWriteTimingException
- An attempt was made to write outside
of the NodeUpdateListener callback methodpublic void setGlobalAmbientLightEnabled(boolean state) throws InvalidWriteTimingException
state
- true to turn the light on
InvalidWriteTimingException
- An attempt was made to write outside
of the NodeUpdateListener callback methodpublic boolean isGlobalAmbientLightEnabled()
public void setGlobalAmbientColor(float[] col) throws java.lang.IllegalArgumentException, InvalidWriteTimingException
col
- The new colour value to use
java.lang.IllegalArgumentException
- The colour value is out of range
InvalidWriteTimingException
- An attempt was made to write outside
of the NodeUpdateListener callback method
InvalidWriteTimingException
- An attempt was made to write outside
of the NodeUpdateListener callback methodpublic void getGlobalAmbientColor(float[] col)
col
- An array to copy the colour value intopublic boolean isDirectionalLight()
public void setHeadlightType(boolean state) throws InvalidWriteTimingException
state
- true to turn the light to directional, false for spot
InvalidWriteTimingException
- An attempt was made to write outside
of the NodeUpdateListener callback methodpublic void render(net.java.games.jogl.GL gl, net.java.games.jogl.GLU glu)
gl
- The gl context to draw withglu
- The utility context to draw withpublic void postRender(net.java.games.jogl.GL gl, net.java.games.jogl.GLU glu)
protected void markBoundsDirty()
markBoundsDirty
in class Node
|
j3d.org Aviatrix3D | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |