001: /*
002: * $RCSfile: PickRotateBehavior.java,v $
003: *
004: * Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
005: *
006: * Redistribution and use in source and binary forms, with or without
007: * modification, are permitted provided that the following conditions
008: * are met:
009: *
010: * - Redistribution of source code must retain the above copyright
011: * notice, this list of conditions and the following disclaimer.
012: *
013: * - Redistribution in binary form must reproduce the above copyright
014: * notice, this list of conditions and the following disclaimer in
015: * the documentation and/or other materials provided with the
016: * distribution.
017: *
018: * Neither the name of Sun Microsystems, Inc. or the names of
019: * contributors may be used to endorse or promote products derived
020: * from this software without specific prior written permission.
021: *
022: * This software is provided "AS IS," without a warranty of any
023: * kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND
024: * WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY,
025: * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY
026: * EXCLUDED. SUN MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL
027: * NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF
028: * USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
029: * DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR
030: * ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,
031: * CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND
032: * REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR
033: * INABILITY TO USE THIS SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE
034: * POSSIBILITY OF SUCH DAMAGES.
035: *
036: * You acknowledge that this software is not designed, licensed or
037: * intended for use in the design, construction, operation or
038: * maintenance of any nuclear facility.
039: *
040: * $Revision: 1.5 $
041: * $Date: 2007/02/09 17:20:26 $
042: * $State: Exp $
043: */
044:
045: package com.sun.j3d.utils.picking.behaviors;
046:
047: import com.sun.j3d.utils.picking.*;
048: import com.sun.j3d.utils.behaviors.mouse.*;
049: import com.sun.j3d.internal.*;
050: import java.awt.*;
051: import java.awt.event.*;
052: import java.util.*;
053: import javax.media.j3d.*;
054: import javax.vecmath.*;
055:
056: /**
057: * A mouse behavior that allows user to pick and drag scene graph objects.
058: * Common usage:
059: * <p>
060: * 1. Create your scene graph.
061: * <p>
062: * 2. Create this behavior with root and canvas.
063: * <p>
064: * <blockquote><pre>
065: * PickRotateBehavior behavior = new PickRotateBehavior(canvas, root, bounds);
066: * root.addChild(behavior);
067: * </pre></blockquote>
068: * <p>
069: * The above behavior will monitor for any picking events on
070: * the scene graph (below root node) and handle mouse drags on pick hits.
071: * Note the root node can also be a subgraph node of the scene graph (rather
072: * than the topmost).
073: */
074:
075: public class PickRotateBehavior extends PickMouseBehavior implements
076: MouseBehaviorCallback {
077: MouseRotate drag;
078: // int pickMode = PickTool.BOUNDS;
079: private PickingCallback callback = null;
080: private TransformGroup currentTG;
081:
082: /**
083: * Creates a pick/rotate behavior that waits for user mouse events for
084: * the scene graph. This method has its pickMode set to BOUNDS picking.
085: * @param root Root of your scene graph.
086: * @param canvas Java 3D drawing canvas.
087: * @param bounds Bounds of your scene.
088: **/
089:
090: public PickRotateBehavior(BranchGroup root, Canvas3D canvas,
091: Bounds bounds) {
092: super (canvas, root, bounds);
093: drag = new MouseRotate(MouseRotate.MANUAL_WAKEUP);
094: drag.setTransformGroup(currGrp);
095: currGrp.addChild(drag);
096: drag.setSchedulingBounds(bounds);
097: this .setSchedulingBounds(bounds);
098: }
099:
100: /**
101: * Creates a pick/rotate behavior that waits for user mouse events for
102: * the scene graph.
103: * @param root Root of your scene graph.
104: * @param canvas Java 3D drawing canvas.
105: * @param bounds Bounds of your scene.
106: * @param pickMode specifys PickTool.BOUNDS, PickTool.GEOMETRY or
107: * PickTool.GEOMETRY_INTERSECT_INFO.
108: * @see PickTool#setMode
109: **/
110:
111: public PickRotateBehavior(BranchGroup root, Canvas3D canvas,
112: Bounds bounds, int pickMode) {
113: super (canvas, root, bounds);
114: drag = new MouseRotate(MouseRotate.MANUAL_WAKEUP);
115: drag.setTransformGroup(currGrp);
116: currGrp.addChild(drag);
117: drag.setSchedulingBounds(bounds);
118: this .setSchedulingBounds(bounds);
119: this .setMode(pickMode);
120: }
121:
122: /**
123: * Update the scene to manipulate any nodes. This is not meant to be
124: * called by users. Behavior automatically calls this. You can call
125: * this only if you know what you are doing.
126: *
127: * @param xpos Current mouse X pos.
128: * @param ypos Current mouse Y pos.
129: **/
130: public void updateScene(int xpos, int ypos) {
131: TransformGroup tg = null;
132:
133: if (!mevent.isMetaDown() && !mevent.isAltDown()) {
134:
135: pickCanvas.setShapeLocation(xpos, ypos);
136: PickResult pr = pickCanvas.pickClosest();
137: if ((pr != null)
138: && ((tg = (TransformGroup) pr
139: .getNode(PickResult.TRANSFORM_GROUP)) != null)
140: && (tg
141: .getCapability(TransformGroup.ALLOW_TRANSFORM_READ))
142: && (tg
143: .getCapability(TransformGroup.ALLOW_TRANSFORM_WRITE))) {
144: drag.setTransformGroup(tg);
145: drag.wakeup();
146: currentTG = tg;
147: // free the PickResult
148: // Need to clean up Issue 123 --- Chien
149: // freePickResult(pr);
150: } else if (callback != null)
151: callback
152: .transformChanged(PickingCallback.NO_PICK, null);
153: }
154: }
155:
156: /**
157: * Callback method from MouseRotate
158: * This is used when the Picking callback is enabled
159: */
160: public void transformChanged(int type, Transform3D transform) {
161: callback.transformChanged(PickingCallback.ROTATE, currentTG);
162: }
163:
164: /**
165: * Register the class @param callback to be called each
166: * time the picked object moves
167: */
168: public void setupCallback(PickingCallback callback) {
169: this.callback = callback;
170: if (callback == null)
171: drag.setupCallback(null);
172: else
173: drag.setupCallback(this);
174: }
175:
176: }
|