steering_behaviors 1.0.3 → 1.0.4

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog for steering-behaviors
 
+## 1.0.4, 8 August 2013
+* Rewrote 'arrive' to the more canonical behavior described by Reynolds
+
 ## 1.0.3, 31 July 2013
 * Bugfixes in ortho/bside; cleanup of align/match
 

data/lib/steering_behaviors/arrive.rb

@@ -7,28 +7,31 @@
 # the terms found in the "LICENSE" file included with the framework.
 
 class SteeringBehaviors::Arrive
+  TARGET_RADIUS=0
 
   # Arrive 'gently' at the goal position by decelerating smoothly.
   #
   # * *Args*    :
   #   - +kinematic+ -> the thing that is moving and arriving
   #   - +goal_position+ -> a Vector of position
-  #   - +gentleness+ -> higher values will make the arrival more gradual and 'gentle'
+  #   - +slow_radius+ -> don't begin decelerating until inside this radius; max speed outside
   # * *Returns* :
   #   - a steering force
   #
-  def self.steer(kinematic, goal_position, gentleness=0.8)
+  def self.steer(kinematic, goal_position, slow_radius=200)
     to_target = goal_position - kinematic.position_vec
     dist = to_target.length
 
-    if dist > 0
-      desired_speed = dist / gentleness
-      desired_speed = [desired_speed, kinematic.max_speed].min
-
-      desired_velocity = to_target.normalize * desired_speed
-      return desired_velocity - kinematic.velocity_vec
-    else
+    if dist < TARGET_RADIUS
       return SteeringBehaviors::Vector.new(0,0)
+    elsif dist > slow_radius
+      desired_speed = kinematic.max_speed
+    else
+      desired_speed = kinematic.max_speed * dist / slow_radius
     end
+
+    desired_vel = to_target.normalize * desired_speed
+
+    return desired_vel - kinematic.velocity_vec
   end
 end

metadata

@@ -2,14 +2,14 @@
 name: steering_behaviors
 version: !ruby/object:Gem::Version
   prerelease:
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - Chris Powell
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2013-07-31 00:00:00.000000000 Z
+date: 2013-08-05 00:00:00.000000000 Z
 dependencies: []
 description: |
   If you're building a game, you need your game agents and characters to move on their own. A standard way of doing this is with 'steering behaviors'. The seminal paper by Craig Reynolds established a core set of steering behaviors that could be utilized for a variety of common movement tasks and natural behaviors. This Ruby library can accomplish many/most of those tasks for your Ruby / JRuby game. The basic behaviors can be layered for more complicated and advanced behaviors, such as flocking and crowd movement.