From 8529dd08bf1424e6a45f884d5358fe0be248a0ad Mon Sep 17 00:00:00 2001
From: Michael Bayne <mdb@threerings.net>
Date: Wed, 27 Nov 2002 23:48:24 +0000
Subject: [PATCH] Added support for an orientation offset which will be used to
 orient the pathable some number of ticks offset from the "natural"
 orientation which would be in the direction it is traveling along the arc.

git-svn-id: svn+ssh://src.earth.threerings.net/narya/trunk@2002 542714f4-19e9-0310-aa3c-eee0fc999fb1
---
 .../com/threerings/media/util/ArcPath.java    | 35 ++++++++++++++++---
 1 file changed, 31 insertions(+), 4 deletions(-)

diff --git a/src/java/com/threerings/media/util/ArcPath.java b/src/java/com/threerings/media/util/ArcPath.java
index e72258aa0..ce6beb3e3 100644
--- a/src/java/com/threerings/media/util/ArcPath.java
+++ b/src/java/com/threerings/media/util/ArcPath.java
@@ -1,5 +1,5 @@
 //
-// $Id: ArcPath.java,v 1.1 2002/09/17 04:00:37 mdb Exp $
+// $Id: ArcPath.java,v 1.2 2002/11/27 23:48:24 mdb Exp $
 
 package com.threerings.media.util;
 
@@ -44,7 +44,8 @@ public class ArcPath extends TimedPath
      * @param duration the number of milliseconds during which to effect
      * the animation.
      * @param orient an orientation code indicating how the pathable
-     * should be oriented when following the path.
+     * should be oriented when following the path, either {@link #NORMAL},
+     * or {@link #FINE}.
      */
     public ArcPath (Point start, double xradius, double yradius,
                     double sangle, double delta, long duration,
@@ -63,6 +64,20 @@ public class ArcPath extends TimedPath
             (int)(start.y - Math.round(Math.sin(sangle) * yradius)));
     }
 
+    /**
+     * Sets the offset that is applied to the pathable whenever it is
+     * oriented. This offset is in clockwise units whose granularity is
+     * specified by the {@link #NORMAL} or {@link #FINE} setting supplied
+     * to the path at construct time. The intent here is to allow arc
+     * paths to be applied that don't orient the pathable in the direction
+     * they are traveling but instead in some fixed offset from that
+     * direction.
+     */
+    public void setOrientOffset (int offset)
+    {
+        _orientOffset = offset;
+    }
+
     // documentation inherited
     public boolean tick (Pathable pable, long timestamp)
     {
@@ -89,8 +104,17 @@ public class ArcPath extends TimedPath
         int orient;
         switch (_orient) {
         default:
-        case NORMAL: orient = DirectionUtil.getDirection(theta); break;
-        case FINE: orient = DirectionUtil.getFineDirection(theta); break;
+        case NORMAL:
+            orient = DirectionUtil.getDirection(theta);
+            // adjust it appropriately
+            orient = DirectionUtil.rotateCW(orient, 2*_orientOffset);
+            break;
+
+        case FINE:
+            orient = DirectionUtil.getFineDirection(theta);
+            // adjust it appropriately
+            orient = DirectionUtil.rotateCW(orient, _orientOffset);
+            break;
         }
 
         // update the pathable's location if it moved
@@ -166,6 +190,9 @@ public class ArcPath extends TimedPath
     /** The method to be used to orient the pathable. */
     protected int _orient;
 
+    /** An orientation offset used when orienting our pathable. */
+    protected int _orientOffset = 0;
+
     /** A temporary point used when computing our position along the
      * path. */
     protected Point _tpos = new Point();