zyps 0.3.1 → 0.4.1

data/doc/files/lib/zyps/views/trails_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Wed Aug 15 20:18:44 -0700 2007</td>
+      <td>Mon Aug 20 17:08:41 -0700 2007</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/zyps_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Mon Aug 06 20:52:06 -0700 2007</td>
+      <td>Sun Aug 26 13:09:04 -0700 2007</td>
     </tr>
     </table>
   </div>

data/doc/fr_class_index.html

@@ -20,16 +20,31 @@
 <div id="index">
   <h1 class="section-bar">Classes</h1>
   <div id="index-entries">
+    <a href="classes/AccelerateAction.html">AccelerateAction</a><br />
+    <a href="classes/Action.html">Action</a><br />
+    <a href="classes/AgeCondition.html">AgeCondition</a><br />
+    <a href="classes/ApproachAction.html">ApproachAction</a><br />
     <a href="classes/Behavior.html">Behavior</a><br />
+    <a href="classes/BlendAction.html">BlendAction</a><br />
     <a href="classes/Clock.html">Clock</a><br />
+    <a href="classes/CollisionCondition.html">CollisionCondition</a><br />
     <a href="classes/Color.html">Color</a><br />
+    <a href="classes/Condition.html">Condition</a><br />
     <a href="classes/Creature.html">Creature</a><br />
+    <a href="classes/DestroyAction.html">DestroyAction</a><br />
+    <a href="classes/EatAction.html">EatAction</a><br />
+    <a href="classes/Enclosure.html">Enclosure</a><br />
     <a href="classes/Environment.html">Environment</a><br />
     <a href="classes/EnvironmentalFactor.html">EnvironmentalFactor</a><br />
+    <a href="classes/FaceAction.html">FaceAction</a><br />
+    <a href="classes/FleeAction.html">FleeAction</a><br />
     <a href="classes/GameObject.html">GameObject</a><br />
     <a href="classes/Location.html">Location</a><br />
-    <a href="classes/Responsive.html">Responsive</a><br />
+    <a href="classes/ProximityCondition.html">ProximityCondition</a><br />
+    <a href="classes/TagAction.html">TagAction</a><br />
+    <a href="classes/TagCondition.html">TagCondition</a><br />
     <a href="classes/TrailsView.html">TrailsView</a><br />
+    <a href="classes/TurnAction.html">TurnAction</a><br />
     <a href="classes/Utility.html">Utility</a><br />
     <a href="classes/Vector.html">Vector</a><br />
   </div>

data/doc/fr_file_index.html

@@ -24,6 +24,9 @@
     <a href="files/COPYING_txt.html">COPYING.txt</a><br />
     <a href="files/README_txt.html">README.txt</a><br />
     <a href="files/lib/zyps_rb.html">lib/zyps.rb</a><br />
+    <a href="files/lib/zyps/actions_rb.html">lib/zyps/actions.rb</a><br />
+    <a href="files/lib/zyps/conditions_rb.html">lib/zyps/conditions.rb</a><br />
+    <a href="files/lib/zyps/environmental_factors_rb.html">lib/zyps/environmental_factors.rb</a><br />
     <a href="files/lib/zyps/views/trails_rb.html">lib/zyps/views/trails.rb</a><br />
   </div>
 </div>

data/doc/fr_method_index.html

@@ -20,43 +20,68 @@
 <div id="index">
   <h1 class="section-bar">Methods</h1>
   <div id="index-entries">
-    <a href="classes/Vector.html#M000013">+ (Vector)</a><br />
-    <a href="classes/Color.html#M000020">+ (Color)</a><br />
-    <a href="classes/Color.html#M000019"><=> (Color)</a><br />
-    <a href="classes/Responsive.html#M000030">act (Responsive)</a><br />
-    <a href="classes/GameObject.html#M000024">age (GameObject)</a><br />
-    <a href="classes/GameObject.html#M000025">age= (GameObject)</a><br />
-    <a href="classes/Color.html#M000018">blue= (Color)</a><br />
-    <a href="classes/Utility.html#M000035">constrain_value (Utility)</a><br />
-    <a href="classes/Clock.html#M000027">elapsed_time (Clock)</a><br />
-    <a href="classes/Utility.html#M000031">find_angle (Utility)</a><br />
-    <a href="classes/Utility.html#M000032">find_distance (Utility)</a><br />
-    <a href="classes/Utility.html#M000036">find_reflection_angle (Utility)</a><br />
-    <a href="classes/Color.html#M000017">green= (Color)</a><br />
-    <a href="classes/Utility.html#M000037">inside_box? (Utility)</a><br />
-    <a href="classes/Environment.html#M000029">interact (Environment)</a><br />
-    <a href="classes/GameObject.html#M000023">move (GameObject)</a><br />
-    <a href="classes/Vector.html#M000006">new (Vector)</a><br />
-    <a href="classes/Behavior.html#M000003">new (Behavior)</a><br />
-    <a href="classes/Creature.html#M000005">new (Creature)</a><br />
-    <a href="classes/Location.html#M000014">new (Location)</a><br />
-    <a href="classes/EnvironmentalFactor.html#M000021">new (EnvironmentalFactor)</a><br />
-    <a href="classes/GameObject.html#M000022">new (GameObject)</a><br />
-    <a href="classes/Color.html#M000015">new (Color)</a><br />
-    <a href="classes/TrailsView.html#M000001">new (TrailsView)</a><br />
-    <a href="classes/Environment.html#M000028">new (Environment)</a><br />
-    <a href="classes/Clock.html#M000026">new (Clock)</a><br />
-    <a href="classes/Behavior.html#M000004">perform (Behavior)</a><br />
-    <a href="classes/Vector.html#M000007">pitch (Vector)</a><br />
-    <a href="classes/Vector.html#M000008">pitch= (Vector)</a><br />
-    <a href="classes/Color.html#M000016">red= (Color)</a><br />
-    <a href="classes/Utility.html#M000033">to_degrees (Utility)</a><br />
-    <a href="classes/Utility.html#M000034">to_radians (Utility)</a><br />
-    <a href="classes/TrailsView.html#M000002">update (TrailsView)</a><br />
-    <a href="classes/Vector.html#M000009">x (Vector)</a><br />
-    <a href="classes/Vector.html#M000010">x= (Vector)</a><br />
-    <a href="classes/Vector.html#M000011">y (Vector)</a><br />
-    <a href="classes/Vector.html#M000012">y= (Vector)</a><br />
+    <a href="classes/Vector.html#M000020">+ (Vector)</a><br />
+    <a href="classes/Color.html#M000027">+ (Color)</a><br />
+    <a href="classes/Color.html#M000026"><=> (Color)</a><br />
+    <a href="classes/Enclosure.html#M000006">act (Enclosure)</a><br />
+    <a href="classes/Creature.html#M000012">act (Creature)</a><br />
+    <a href="classes/GameObject.html#M000035">age (GameObject)</a><br />
+    <a href="classes/GameObject.html#M000036">age= (GameObject)</a><br />
+    <a href="classes/Color.html#M000025">blue= (Color)</a><br />
+    <a href="classes/Utility.html#M000062">collided? (Utility)</a><br />
+    <a href="classes/Utility.html#M000060">constrain_value (Utility)</a><br />
+    <a href="classes/FaceAction.html#M000052">do (FaceAction)</a><br />
+    <a href="classes/TurnAction.html#M000051">do (TurnAction)</a><br />
+    <a href="classes/AccelerateAction.html#M000010">do (AccelerateAction)</a><br />
+    <a href="classes/ApproachAction.html#M000049">do (ApproachAction)</a><br />
+    <a href="classes/BlendAction.html#M000044">do (BlendAction)</a><br />
+    <a href="classes/TagAction.html#M000029">do (TagAction)</a><br />
+    <a href="classes/FleeAction.html#M000055">do (FleeAction)</a><br />
+    <a href="classes/DestroyAction.html#M000031">do (DestroyAction)</a><br />
+    <a href="classes/EatAction.html#M000045">do (EatAction)</a><br />
+    <a href="classes/Clock.html#M000042">elapsed_time (Clock)</a><br />
+    <a href="classes/Utility.html#M000056">find_angle (Utility)</a><br />
+    <a href="classes/Utility.html#M000057">find_distance (Utility)</a><br />
+    <a href="classes/Utility.html#M000061">find_reflection_angle (Utility)</a><br />
+    <a href="classes/Color.html#M000024">green= (Color)</a><br />
+    <a href="classes/Environment.html#M000047">interact (Environment)</a><br />
+    <a href="classes/GameObject.html#M000034">move (GameObject)</a><br />
+    <a href="classes/GameObject.html#M000032">new (GameObject)</a><br />
+    <a href="classes/TagAction.html#M000028">new (TagAction)</a><br />
+    <a href="classes/Color.html#M000022">new (Color)</a><br />
+    <a href="classes/DestroyAction.html#M000030">new (DestroyAction)</a><br />
+    <a href="classes/Location.html#M000021">new (Location)</a><br />
+    <a href="classes/TrailsView.html#M000003">new (TrailsView)</a><br />
+    <a href="classes/Enclosure.html#M000005">new (Enclosure)</a><br />
+    <a href="classes/TagCondition.html#M000007">new (TagCondition)</a><br />
+    <a href="classes/FleeAction.html#M000054">new (FleeAction)</a><br />
+    <a href="classes/AccelerateAction.html#M000009">new (AccelerateAction)</a><br />
+    <a href="classes/ProximityCondition.html#M000037">new (ProximityCondition)</a><br />
+    <a href="classes/TurnAction.html#M000050">new (TurnAction)</a><br />
+    <a href="classes/AgeCondition.html#M000039">new (AgeCondition)</a><br />
+    <a href="classes/Creature.html#M000011">new (Creature)</a><br />
+    <a href="classes/Clock.html#M000041">new (Clock)</a><br />
+    <a href="classes/ApproachAction.html#M000048">new (ApproachAction)</a><br />
+    <a href="classes/BlendAction.html#M000043">new (BlendAction)</a><br />
+    <a href="classes/Vector.html#M000013">new (Vector)</a><br />
+    <a href="classes/Environment.html#M000046">new (Environment)</a><br />
+    <a href="classes/Behavior.html#M000001">new (Behavior)</a><br />
+    <a href="classes/Behavior.html#M000002">perform (Behavior)</a><br />
+    <a href="classes/Vector.html#M000014">pitch (Vector)</a><br />
+    <a href="classes/Vector.html#M000015">pitch= (Vector)</a><br />
+    <a href="classes/Color.html#M000023">red= (Color)</a><br />
+    <a href="classes/GameObject.html#M000033">size= (GameObject)</a><br />
+    <a href="classes/ProximityCondition.html#M000038">test (ProximityCondition)</a><br />
+    <a href="classes/CollisionCondition.html#M000053">test (CollisionCondition)</a><br />
+    <a href="classes/TagCondition.html#M000008">test (TagCondition)</a><br />
+    <a href="classes/AgeCondition.html#M000040">test (AgeCondition)</a><br />
+    <a href="classes/Utility.html#M000058">to_degrees (Utility)</a><br />
+    <a href="classes/Utility.html#M000059">to_radians (Utility)</a><br />
+    <a href="classes/TrailsView.html#M000004">update (TrailsView)</a><br />
+    <a href="classes/Vector.html#M000016">x (Vector)</a><br />
+    <a href="classes/Vector.html#M000017">x= (Vector)</a><br />
+    <a href="classes/Vector.html#M000018">y (Vector)</a><br />
+    <a href="classes/Vector.html#M000019">y= (Vector)</a><br />
   </div>
 </div>
 </body>

data/doc/index.html

@@ -5,12 +5,12 @@
 
 <!--
 
-    Zyps - A simulation/game with autonomous creatures
+    Zyps - A game library for Ruby
 
   -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
-  <title>Zyps - A simulation/game with autonomous creatures</title>
+  <title>Zyps - A game library for Ruby</title>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
 </head>
 <frameset rows="20%, 80%">

data/lib/zyps.rb

@@ -30,7 +30,7 @@ class Environment
 	attr_accessor :environmental_factors
 	
 	def initialize (objects = [], environmental_factors = [])
-		@objects, @environmental_factors = objects, environmental_factors
+		self.objects, self.environmental_factors = objects, environmental_factors
 		@clock = Clock.new
 	end
 	
@@ -83,6 +83,8 @@ class GameObject
 	attr_accessor :location
 	#A Color that will be used to draw the object.
 	attr_accessor :color
+	#Radius of the object.
+	attr_accessor :size
 	#A Vector with the object's current speed and direction of travel.
 	attr_accessor :vector
 	#A String with the object's name.
@@ -90,12 +92,14 @@ class GameObject
 	#An array of Strings with tags that determine how the object will be treated by Creature and EnvironmentalFactor objects in its environment.
 	attr_accessor :tags
 	
-	def initialize (name = nil, location = Location.new, color = Color.new, vector = Vector.new, age = 0, tags = [])
-		@name, @location, @color, @vector, @tags = name, location, color, vector, tags
+	def initialize (name = nil, location = Location.new, color = Color.new, vector = Vector.new, age = 0, size = 1, tags = [])
+		self.name, self.location, self.color, self.vector, self.age, self.size, self.tags = name, location, color, vector, age, size, tags
 		@identifier = rand(99999999) #TODO: Current setup won't necessarily be unique.
-		self.age = age
 	end
 	
+	#Size must be positive.
+	def size=(v); v = 0 if v < 0; @size = v; end
+	
 	#Move according to vector over the given number of seconds.
 	def move (elapsed_time)
 		@location.x += @vector.x * elapsed_time
@@ -110,30 +114,21 @@ end
 
 
 
-#Mixin to have an object (usually a Creature) act on other objects.
-module Responsive
-
-	#Call Behavior.perform on each of the object's assigned Behaviors, with the object and a target as arguments.
-	def act(target)
-		behaviors.each {|behavior| behavior.perform(self, target)}
-	end
-	
-end
-
-
-
 #A Creature is a GameObject that can sense and respond to other GameObjects (including other Creature objects).
 class Creature < GameObject
 
-	include Responsive
-	
 	#A list of Behavior objects that determine the creature's response to its environment.
 	attr_accessor :behaviors
 	
 	#Identical to the GameObject constructor, except that it also takes a list of Behavior objects.
-	def initialize (name = nil, location = Location.new, color = Color.new, vector = Vector.new, age = 0, tags = [], behaviors = [])
-		super(name, location, color, vector, age, tags)
-		@behaviors = behaviors
+	def initialize (name = nil, location = Location.new, color = Color.new, vector = Vector.new, age = 0, size = 1, tags = [], behaviors = [])
+		super(name, location, color, vector, age, size, tags)
+		self.behaviors = behaviors
+	end
+	
+	#Call Behavior.perform on each of the object's assigned Behaviors, with the object and a target as arguments.
+	def act(target)
+		behaviors.each {|behavior| behavior.perform(self, target)}
 	end
 	
 end
@@ -141,41 +136,46 @@ end
 
 
 #Something in the environment that acts on creatures.
+#EnvironmentalFactors must implement an act(target) instance method.
 class EnvironmentalFactor
+end
 
-	include Responsive
-	
-	#A list of Behavior objects, each called in the same way as those of a Creature.
-	attr_accessor :behaviors
-	
-	def initialize (behaviors = [])
-		@behaviors = behaviors
-	end
-	
+
+
+#An action that one Creature takes on another.
+#Actions must implement a do(actor, target) instance method.
+class Action
+end
+
+
+
+#A condition for one Creature to act on another.
+#Conditions must implement a test(actor, target) instance method.
+class Condition
 end
 
 
 
-#A behavior that a Creature or EnvironmentalFactor object (or other classes that include Responsive) engage in.
+#A behavior that a Creature engages in.
 #The target can have its tags or colors changed, it can be "herded", it can be destroyed, or any other action the library user can dream up.
 #Likewise, the subject can change its own attributes, it can approach or flee from the target, it can spawn new Creatures or GameObjects (like bullets), or anything else.
 class Behavior
 
-	#A list of conditions, which are Proc objects called with the object itself and its target.  A condition can consider the tags on the target, the distance from the subject, or any other criteria.  If any condition returns false, the behavior will not be carried out.
+	#A list of Condition objects, which are called with the object itself and its target.  A condition can consider the tags on the target, the distance from the subject, or any other criteria.  If any condition returns false, the behavior will not be carried out.
 	attr_accessor :conditions
-	#A list of actions, which are Proc objects called with the object and its target when all conditions are met.  An action can act on the subject or its target.
+	#A list of Action objects, which are called with the object and its target when all conditions are met.  An action can act on the subject or its target.
 	attr_accessor :actions
 	
 	#Optionally takes an array of actions and one of conditions.
 	def initialize (actions = [], conditions = [])
-		@actions, @conditions = actions, conditions
+		self.actions, self.conditions = actions, conditions
 	end
 	
 	#Calls each Proc object in the list of conditions with the subject and its target.  Returns nil if any condition returns false.
 	#Then calls each Proc object in the list of actions, also with the subject and its target.
 	def perform(subject, target)
-		conditions.each {|condition| return nil unless condition.call(subject, target)}
-		actions.each {|action| action.call(subject, target)}
+		conditions.each {|condition| return unless condition.test(subject, target)}
+		actions.each {|action| action.do(subject, target)}
 	end
 	
 end
@@ -215,9 +215,9 @@ class Color
 	#Averages each component of this Color with the corresponding component of color2, returning a new Color.
 	def +(color2)
 		Color.new(
-			self.red + color2.red / 2.0,
-			self.green + color2.green / 2.0,
-			self.blue + color2.blue / 2.0
+			(self.red + color2.red) / 2.0,
+			(self.green + color2.green) / 2.0,
+			(self.blue + color2.blue) / 2.0
 		)
 	end
 	
@@ -232,7 +232,7 @@ class Location
 	attr_accessor :x, :y
 	
 	def initialize (x = 0, y = 0)
-		@x, @y = x, y
+		self.x, self.y = x, y
 	end
 	
 end
@@ -367,13 +367,12 @@ module Utility
 		reflection_angle
 	end
 
-	#Given a location and the upper left and lower right corners of a box, determine if the point is within the box.
-	def Utility.inside_box?(point, upper_left, lower_right)
-		return false if point.x < upper_left.x
-		return false if point.y < upper_left.y
-		return false if point.x > lower_right.x
-		return false if point.y > lower_right.y
-		true
+	#Given two GameObjects, determine if the boundary of one crosses the boundary of the other.
+	def Utility.collided?(object1, object2)
+		object1_radius = Math.sqrt(object1.size / Math::PI)
+		object2_radius = Math.sqrt(object2.size / Math::PI)
+		return true if find_distance(object1.location, object2.location) < object1_radius + object2_radius
+		false
 	end
 	
 end

data/lib/zyps/actions.rb

@@ -0,0 +1,186 @@
+# Copyright 2007 Jay McGavren, jay@mcgavren.com.
+# 
+# This file is part of Zyps.
+# 
+# Zyps is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+# 
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require 'zyps'
+
+
+#Head toward a target.
+class FaceAction < Action
+	#Set the actor's heading to point directly at target.
+	def do(actor, target)
+		actor.vector.pitch = Utility.find_angle(actor.location, target.location)
+	end
+end
+
+#Increase/decrease speed over time.
+class AccelerateAction < Action
+	#Units per second to accelerate.
+	#Can be negative to slow down or go in reverse.
+	attr_accessor :rate
+	def initialize(rate = 0)
+		self.rate = rate
+		@clock = Clock.new
+	end
+	#Increase or decrease speed according to elapsed time.
+	def do(actor, target)
+		actor.vector.speed += @clock.elapsed_time * rate
+	end
+end
+
+
+#Turn over time.
+class TurnAction < Action
+	#Degrees per second to turn.
+	#Positive turns clockwise, negative turns counter-clockwise.
+	attr_accessor :rate
+	def initialize(rate = 0)
+		self.rate = rate
+		@clock = Clock.new
+	end
+	#Turn according to elapsed time.
+	def do(actor, target)
+		actor.vector.pitch += @clock.elapsed_time * rate
+	end
+end
+
+
+#Approaches the target, but obeys law of inertia.
+class ApproachAction < Action
+	#Direction/speed actor is accelerating in.
+	attr_accessor :heading
+	#Degrees per second the direction of acceleration can change.
+	attr_accessor :turn_rate
+	def initialize(heading = Vector.new, turn_rate = 360)
+		self.heading, self.turn_rate = heading, turn_rate
+		@clock = Clock.new
+	end
+	#Accelerate toward the target, but limited by turn rate.
+	def do(actor, target)
+		#Find the difference between the current heading and the angle to the target.
+		turn_angle = Utility.find_angle(actor.location, target.location) - @heading.pitch
+		#If the angle is the long way around from the current heading, change it to the smaller angle.
+		if turn_angle > 180 then
+			turn_angle -= 360.0
+		elsif turn_angle < -180 then
+			turn_angle += 360.0
+		end
+		#The creature can only turn as fast as the elapsed time, of course.
+		maximum_turn = turn_rate * @clock.elapsed_time
+		if turn_angle.abs > maximum_turn
+			if turn_angle > 0
+				turn_angle = maximum_turn
+			else
+				turn_angle = maximum_turn * -1
+			end
+		end
+		#Turn the appropriate amount.
+		@heading.pitch += turn_angle
+		#Apply the heading to the creature's movement vector.
+		actor.vector += @heading
+	end
+end
+
+
+#Flees from the target, but obeys law of inertia.
+class FleeAction < Action
+	#Direction/speed actor is accelerating in.
+	attr_accessor :heading
+	#Degrees per second the direction of acceleration can change.
+	attr_accessor :turn_rate
+	def initialize(heading = Vector.new, turn_rate = 360)
+		self.heading, self.turn_rate = heading, turn_rate
+		@clock = Clock.new
+	end
+	#Accelerate away from the target, but limited by turn rate.
+	def do(actor, target)
+		#Find the difference between the current heading and the angle to the target.
+		turn_angle = Utility.find_angle(actor.location, target.location) - @heading.pitch + 180
+		#If the angle is the long way around from the current heading, change it to the smaller angle.
+		if turn_angle > 180 then
+			turn_angle -= 360.0
+		elsif turn_angle < -180 then
+			turn_angle += 360.0
+		end
+		#The creature can only turn as fast as the elapsed time, of course.
+		maximum_turn = turn_rate * @clock.elapsed_time
+		if turn_angle.abs > maximum_turn
+			if turn_angle > 0
+				turn_angle = maximum_turn
+			else
+				turn_angle = maximum_turn * -1
+			end
+		end
+		#Turn the appropriate amount.
+		@heading.pitch += turn_angle
+		#Apply the heading to the creature's movement vector.
+		actor.vector += @heading
+	end
+end
+
+
+#Destroy the target.
+class DestroyAction < Action
+	#The environment to remove objects from.
+	attr_accessor :environment
+	def initialize(environment)
+		self.environment = environment
+	end
+	#Remove the target from the environment.
+	def do(actor, target)
+		@environment.objects.delete(target)
+	end
+end
+
+
+#Destroy the target and grow in size.
+class EatAction < DestroyAction
+	#Remove the target from the environment, and increase actor's size by size of target.
+	def do(actor, target)
+		#Remove the target from the environment.
+		super
+		#Grow in size.
+		actor.size += target.size
+	end
+end
+
+
+#Add a tag to the target.
+class TagAction < Action
+	#Tag to apply to target.
+	attr_accessor :tag
+	def initialize(tag)
+		self.tag = tag
+	end
+	#Apply the given tag to the target.
+	def do(actor, target)
+		target.tags << tag unless target.tags.include?(tag)
+	end
+end
+
+
+#Blend the target's color with another color.
+class BlendAction < Action
+	#Color to apply to target.
+	attr_accessor :color
+	def initialize(color)
+		self.color = color
+	end
+	#Blend the target's color with the assigned color.
+	def do(actor, target)
+		target.color += @color
+	end
+end