ncsa.j3d.ui.tools
Class AdjustmentTool

java.lang.Object
  |
  +--javax.media.j3d.SceneGraphObject
        |
        +--javax.media.j3d.Node
              |
              +--javax.media.j3d.Leaf
                    |
                    +--javax.media.j3d.Behavior
                          |
                          +--ncsa.j3d.ui.tools.AdjustmentTool

public class AdjustmentTool

extends javax.media.j3d.Behavior

implements ToolInterface

This tool allows all Devices that implement AdjustableInterface to be adjusted dynamically. This is useful to allow the inversion of translations and rotations. (i.e.) as you move the device in the X direction the effect is reversed in software to be -X. It is also possible to configure an offset. (i.e.) when the device is outputting 0, this could be software configured to be -123.5. It is also possible to set the scalings of rotation and translation. This is simply a multiplication. The most useful application would be to modify the devices output to vary between [-pi,pi] when the device only outputs [-pi/2,pi/2]. also it is very important to note that you could modify the output to become [-pi/8,pi/8] if you are experiencing alot of noise. So this is the class that allows all of these things to be set dynamically through a GUI.

Fields inherited from class javax.media.j3d.Node

ALLOW_AUTO_COMPUTE_BOUNDS_READ, ALLOW_AUTO_COMPUTE_BOUNDS_WRITE, ALLOW_BOUNDS_READ, ALLOW_BOUNDS_WRITE, ALLOW_COLLIDABLE_READ, ALLOW_COLLIDABLE_WRITE, ALLOW_LOCAL_TO_VWORLD_READ, ALLOW_PICK, ALLOW_PICKABLE_READ, ALLOW_PICKABLE_WRITE, ENABLE_COLLISION_REPORTING, ENABLE_PICK_REPORTING

Constructor Summary

AdjustmentTool()
The Constructor.

Method Summary

java.lang.String	describe() Returns the name of this tool.
java.lang.String	describeFunctionality() Explains the ability of this tool.
void	initialize() See Behavior.
boolean	notify(java.util.EventObject t) A legacy method for backwards compatibility from Sketch.
void	processStimulus(java.util.Enumeration criteria) See Behavior.
void	setToolManager(ToolManagerInterface tmi) Allows the specification of the ToolManager.

Methods inherited from class javax.media.j3d.Behavior

duplicateNode, getEnable, getSchedulingBoundingLeaf, getSchedulingBounds, postId, setEnable, setSchedulingBoundingLeaf, setSchedulingBounds, updateNodeReferences

Methods inherited from class javax.media.j3d.Node

cloneNode, cloneTree, cloneTree, cloneTree, getBounds, getBoundsAutoCompute, getCollidable, getLocalToVworld, getLocalToVworld, getParent, getPickable, setBounds, setBoundsAutoCompute, setCollidable, setPickable

Methods inherited from class javax.media.j3d.SceneGraphObject

clearCapability, getCapability, getUserData, isCompiled, isLive, setCapability, setUserData

Methods inherited from class java.lang.Object

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

Constructor Detail

AdjustmentTool

public AdjustmentTool()

The Constructor.

Method Detail

initialize

public void initialize()

See Behavior.

Overrides:

initialize in class javax.media.j3d.Behavior

processStimulus

public void processStimulus(java.util.Enumeration criteria)

See Behavior.

Overrides:

processStimulus in class javax.media.j3d.Behavior

Parameters:

criteria - The enumeration of reasons why this method was called.

describe

public java.lang.String describe()

Returns the name of this tool.

Specified by:

describe in interface ToolInterface

Tags copied from interface: ToolInterface

Parameters:

none -

describeFunctionality

public java.lang.String describeFunctionality()

Explains the ability of this tool.

Specified by:

describeFunctionality in interface ToolInterface

Tags copied from interface: ToolInterface

Parameters:

none -

notify

public boolean notify(java.util.EventObject t)

A legacy method for backwards compatibility from Sketch.

Parameters:

t - An EventObject.

setToolManager

public void setToolManager(ToolManagerInterface tmi)

Allows the specification of the ToolManager.

Specified by:

setToolManager in interface ToolInterface

Parameters:

tmi - The tool manager to refer to.