org.jogamp.java3d.utils.behaviors.mouse

Class MouseZoom

java.lang.Object

org.jogamp.java3d.SceneGraphObject

org.jogamp.java3d.Node

org.jogamp.java3d.Leaf

org.jogamp.java3d.Behavior

org.jogamp.java3d.utils.behaviors.mouse.MouseBehavior

org.jogamp.java3d.utils.behaviors.mouse.MouseZoom

All Implemented Interfaces:

java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.event.MouseWheelListener, java.util.EventListener

public class MouseZoom
extends MouseBehavior

MouseZoom is a Java3D behavior object that lets users control the Z axis translation of an object via a mouse drag motion with the second mouse button. See MouseRotate for similar usage info.

Field Summary

Fields inherited from class org.jogamp.java3d.utils.behaviors.mouse.MouseBehavior

INVERT_INPUT, MANUAL_WAKEUP

Fields inherited from class org.jogamp.java3d.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_LOCALE_READ, ALLOW_PARENT_READ, ALLOW_PICKABLE_READ, ALLOW_PICKABLE_WRITE, ENABLE_COLLISION_REPORTING, ENABLE_PICK_REPORTING

Constructor Summary

Constructors

Constructor and Description
MouseZoom() Creates a default mouse zoom behavior.
MouseZoom(java.awt.Component c) Creates a zoom behavior that uses AWT listeners and behavior posts rather than WakeupOnAWTEvent.
MouseZoom(java.awt.Component c, int flags) Creates a zoom behavior that uses AWT listeners and behavior posts rather than WakeupOnAWTEvent.
MouseZoom(java.awt.Component c, TransformGroup transformGroup) Creates a zoom behavior that uses AWT listeners and behavior posts rather than WakeupOnAWTEvent.
MouseZoom(int flags) Creates a zoom behavior.
MouseZoom(TransformGroup transformGroup) Creates a zoom behavior given the transform group.

Method Summary

Modifier and Type	Method and Description
double	getFactor() Return the y-axis movement multipler.
void	initialize() Initializes the behavior.
void	processStimulus(java.util.Iterator<WakeupCriterion> criteria) All mouse manipulators must implement this.
void	setFactor(double factor) Set the y-axis movement multipler with factor.
void	setupCallback(MouseBehaviorCallback callback) The transformChanged method in the callback class will be called every time the transform is updated
void	transformChanged(Transform3D transform) Users can overload this method which is called every time the Behavior updates the transform Default implementation does nothing

Methods inherited from class org.jogamp.java3d.utils.behaviors.mouse.MouseBehavior

addListener, getTransformGroup, mouseClicked, mouseDragged, mouseEntered, mouseExited, mouseMoved, mousePressed, mouseReleased, mouseWheelMoved, processMouseEvent, setEnable, setTransformGroup, wakeup

Methods inherited from class org.jogamp.java3d.Behavior

getEnable, getNumSchedulingIntervals, getSchedulingBoundingLeaf, getSchedulingBounds, getSchedulingInterval, postId, setSchedulingBoundingLeaf, setSchedulingBounds, setSchedulingInterval, updateNodeReferences

Methods inherited from class org.jogamp.java3d.Node

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

Methods inherited from class org.jogamp.java3d.SceneGraphObject

clearCapability, clearCapabilityIsFrequent, getCapability, getCapabilityIsFrequent, getName, getUserData, isCompiled, isLive, setCapability, setCapabilityIsFrequent, setName, setUserData, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

MouseZoom

public MouseZoom(TransformGroup transformGroup)

Creates a zoom behavior given the transform group.

Parameters:

transformGroup - The transformGroup to operate on.

MouseZoom

public MouseZoom()

Creates a default mouse zoom behavior.

MouseZoom

public MouseZoom(int flags)

Creates a zoom behavior. Note that this behavior still needs a transform group to work on (use setTransformGroup(tg)) and the transform group must add this behavior.

Parameters:

flags -

MouseZoom

public MouseZoom(java.awt.Component c)

Creates a zoom behavior that uses AWT listeners and behavior posts rather than WakeupOnAWTEvent. The behavior is added to the specified Component. A null component can be passed to specify the behavior should use listeners. Components can then be added to the behavior with the addListener(Component c) method.

Parameters:

c - The Component to add the MouseListener and MouseMotionListener to.

Since:

Java 3D 1.2.1

MouseZoom

public MouseZoom(java.awt.Component c,
                 TransformGroup transformGroup)

Creates a zoom behavior that uses AWT listeners and behavior posts rather than WakeupOnAWTEvent. The behaviors is added to the specified Component and works on the given TransformGroup.

Parameters:

c - The Component to add the MouseListener and MouseMotionListener to. A null component can be passed to specify the behavior should use listeners. Components can then be added to the behavior with the addListener(Component c) method.

transformGroup - The TransformGroup to operate on.

Since:

Java 3D 1.2.1

MouseZoom

public MouseZoom(java.awt.Component c,
                 int flags)

Creates a zoom behavior that uses AWT listeners and behavior posts rather than WakeupOnAWTEvent. The behavior is added to the specified Component. A null component can be passed to specify the behavior should use listeners. Components can then be added to the behavior with the addListener(Component c) method. Note that this behavior still needs a transform group to work on (use setTransformGroup(tg)) and the transform group must add this behavior.

Parameters:

flags - interesting flags (wakeup conditions).

Since:

Java 3D 1.2.1

Method Detail

initialize

public void initialize()

Description copied from class: MouseBehavior

Initializes the behavior.

Overrides:

initialize in class MouseBehavior

getFactor

public double getFactor()

Return the y-axis movement multipler.

setFactor

public void setFactor(double factor)

Set the y-axis movement multipler with factor.

processStimulus

public void processStimulus(java.util.Iterator<WakeupCriterion> criteria)

Description copied from class: MouseBehavior

All mouse manipulators must implement this.

Specified by:

processStimulus in class MouseBehavior

Parameters:

criteria - an iterator of triggered wakeup criteria for this behavior

transformChanged

public void transformChanged(Transform3D transform)

Users can overload this method which is called every time the Behavior updates the transform Default implementation does nothing

setupCallback

public void setupCallback(MouseBehaviorCallback callback)

The transformChanged method in the callback class will be called every time the transform is updated