lotu 0.1.11 → 0.1.12

data/VERSION

@@ -1 +1 @@
-0.1.11
+0.1.12

data/examples/hello_world/moving_portraits.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/env ruby
+
+# Hello world for lotu
+# Here you will learn about:
+# * Loading image resources
+# * Binding keys to window and actors
+# * How to display text on screen using a text box
+
+
+LIB_PATH = File.join(File.dirname(__FILE__), '..', '..', 'lib', 'lotu.rb')
+require File.expand_path(LIB_PATH)
+
+include Gosu
+include Lotu
+
+# We want to move something around the screen so we create a new Actor
+# subclass, set the image all instances of it are going to use and
+# define the movement methods
+class Lobo < Actor
+
+  def initialize(opts={})
+    # It's important to call super so we take advantage of automatic
+    # management for this object (being added to draw and update queue)
+    super
+    # Use the image which filename is "lobo_tuerto.png", and scale
+    # it's appearance to half width and half height
+    set_image 'lobo_tuerto.png', :factor_x => 0.5, :factor_y => 0.5
+  end
+
+  # Let's define some basic movement methods
+  def move_right; @x += 1 end
+  def move_left;  @x -= 1 end
+  def move_up;    @y -= 1 end
+  def move_down;  @y += 1 end
+
+end
+
+# Let's subclass the Game class and write some code!
+class Portraits < Game
+
+  def initialize
+    # This will call the hooks:
+    # load_resources, setup_systems, setup_input and setup_actors
+    # declared in the parent class
+    super
+    # When the Escape key is pressed, call the close method on
+    # instance of class Portraits, when D key is pressed turn on
+    # debug, we pass false into the array to tell the input system we
+    # don't want autofire on, else pass the number of milliseconds
+    # (zero and no array is the same)
+    set_keys(KbEscape => :close,
+             KbD => [:debug!, false])
+  end
+
+  # This method is called when we call super inside initialize
+  def load_resources
+    # From this file,
+    with_path_from_file(__FILE__) do
+      # go back one dir and search inside media/images
+      load_images '../media/images'
+    end
+  end
+
+  # This method is called when we call super inside initialize
+  def setup_actors
+    # Create a lobo in the middle of the screen
+    @lobo1 = Lobo.new(:x => width/2, :y => height/2)
+    # Map keys to some methods
+    @lobo1.set_keys(KbRight => :move_right,
+                    KbLeft => :move_left,
+                    KbUp => :move_up,
+                    KbDown => :move_down)
+
+    # Rinse and repeat... but invert some keys
+    @lobo2 = Lobo.new(:x => width/2, :y => height/2)
+    @lobo2.set_keys(KbRight => :move_left,
+                    KbLeft => :move_right,
+                    KbUp => :move_up,
+                    KbDown => :move_down)
+
+    # Create a TextBox so we can display a message on screen
+    @info = TextBox.new
+    # Add some text
+    @info.text("Hello world!")
+    # Add more text, but specify the color and size in pixels
+    @info.text("Move the portraits around with arrow keys", :size => 16, :color => 0xff33ccff)
+  end
+
+end
+
+# Create and show the app
+Portraits.new.show

data/examples/screen_cursor/mouse_and_keyboard_cursors.rb

@@ -0,0 +1,141 @@
+#!/usr/bin/env ruby
+
+# lotu's cursors
+# Here you will learn about:
+# * The Cursor class included in lotu
+# * How to register events
+# * How to use the systems provided by lotu
+
+LIB_PATH = File.join(File.dirname(__FILE__), '..', '..', 'lib', 'lotu.rb')
+require File.expand_path(LIB_PATH)
+
+include Gosu
+include Lotu
+
+# Create a class for displaying something on screen
+class Lobo < Actor
+  def initialize(opts={})
+    super
+    set_image 'lobo_tuerto.png', :width => 100
+  end
+
+  # Define a method for teleporting our instances around
+  def teleport(x, y)
+    @x, @y = x, y
+  end
+end
+
+class Cursors < Game
+  def initialize
+    # This will call the hooks:
+    # load_resources, setup_systems, setup_input and setup_actors
+    # declared in the parent class
+    super
+    # Custom setup methods for this class
+    setup_events
+  end
+
+  def load_resources
+    with_path_from_file(__FILE__) do
+      load_images '../media/images'
+    end
+  end
+
+  def setup_systems
+    # It's important to call super here to setup the InputSystem in
+    # the parent class
+    super
+    # To use the systems lotu provides, you just "use" them
+    # Let's activate the FPS system, so we can track the frames per
+    #second our app is pushing out
+    use(FpsSystem)
+    # Activate the stalker system to track how many objects of these
+    # classes are around
+    use(StalkerSystem, :stalk => [Actor, Cursor, TextBox, Lobo, Object])
+  end
+
+  # Setup some input handling for our Cursors app
+  def setup_input
+    set_keys(KbEscape => :close,
+             KbD => [:debug!, false],
+             KbT => [:toggle_text, false])
+  end
+
+  # Now onto define some events
+  def setup_events
+    # When the left mouse button is clicked (as defined below in
+    # setup_actors) call the teleport method in @lobo
+    @cursor1.on(:click) do |x,y|
+      @lobo.teleport(x,y)
+    end
+    # When the space bar is pressed (see below in setup_actors) call
+    # the teleport method in @lobo
+    @cursor2.on(:click) do |x,y|
+      @lobo.teleport(x,y)
+    end
+  end
+
+  def setup_actors
+    # Create a portrait to teleport around with "clicks"
+    @lobo = Lobo.new(:x => width/2, :y => height/2)
+
+    # The cursor class defines a method named (you guessed) "click",
+    # when this method is called, it fires an event named (again)
+    # "click", that's why we attached some code to that event in
+    # setup_events
+    @cursor1 = Cursor.new(:image => 'crosshair-1.png',
+                          :keys => {MsLeft => [:click, false]},
+                          :width => 100,
+                          :rand_color => true,
+                          :mode => :additive)
+    @cursor1.transform_angle(:init => 0, :end => 359, :duration => 10, :loop => true)
+
+    @cursor2 = Cursor.new(:image => 'crosshair-2.png',
+                          :use_mouse => false,
+                          :keys => {
+                            KbSpace => [:click, false],
+                            KbUp => :up,
+                            KbDown => :down,
+                            KbLeft => :left,
+                            KbRight => :right},
+                          :width => 100,
+                          :rand_color => true,
+                          :mode => :additive)
+    @cursor2.transform_angle(:init => 359, :end => 0, :duration => 1, :loop => true)
+
+    # Center @cursor2 vertically and move it to the right 3/4 of the
+    # screen
+    @cursor2.x = width*3/4
+    @cursor2.y = height/2
+
+    # Here we tell the TextBox to watch some objects, the TextBox will
+    # call the to_s method on the objects it's watching
+    # Create a TextBox with default option :size => 15
+    @info = TextBox.new(:size => 15)
+    @info.text("Press T to hide this text", :size => 24)
+    # Watch the FPS, so we get a nice FPS report on the screen
+    @info.watch(@systems[FpsSystem], :size => 20)
+    # Watch the Stalker system, so we know how many objects of the
+    # classes we specified up in setup_systems are around
+    @info.watch(@systems[StalkerSystem], :color => 0xff3ffccf)
+    # We can change the size for a specific line of text
+    @info.text("@cursor1 data:", :size => 20)
+    @info.text("move with Mouse | click with LeftMouseButton")
+    # And color
+    @info.watch(@cursor1, :color => @cursor1.color)
+
+    # Lets watch @cursor2 too
+    @info.text("@cursor2 data:", :size => 20)
+    @info.text("move with Arrow keys | click with Space")
+    @info.watch(@cursor2, :color => @cursor2.color)
+    @info.text("click to teleport the portrait!")
+  end
+
+  def toggle_text
+    @info.toggle!
+  end
+
+end
+
+# Create and start the game loop by showing the app
+Cursors.new.show

data/examples/steering_behaviors/pursuit_and_evade.rb

@@ -0,0 +1,109 @@
+#!/usr/bin/env ruby
+
+# Here you will learn about:
+# * The steering system
+# * How to play animations
+# * How to attach a text box to an actor
+
+LIB_PATH = File.join(File.dirname(__FILE__), '..', '..', 'lib', 'lotu.rb')
+require File.expand_path(LIB_PATH)
+
+include Gosu
+include Lotu
+
+# Let's define a Missile class that will use a Steering system to
+# control it's movement
+class Missile < Actor
+  def initialize(opts={})
+    super
+    # Activate the steering system and pass the opts, since they might
+    # have some config info for the system
+    use(SteeringSystem, opts)
+  end
+
+  def teleport(x, y)
+    @pos.x, @pos.y = x, y
+  end
+end
+
+# The main app class
+class SteeringMissiles < Game
+  def initialize
+    # This will call the hooks:
+    # load_resources, setup_systems, setup_input and setup_actors
+    # declared in the parent class
+    super
+    # Custom setup methods for this class
+    setup_events
+  end
+
+  # Let's load some images and animations, check out the animations
+  # directory, the animation there was created with:
+  # {Sprite Sheet Packer}[http://spritesheetpacker.codeplex.com/]
+  def load_resources
+    with_path_from_file(__FILE__) do
+      load_images '../media/images'
+      load_animations '../media/animations'
+    end
+  end
+
+  def setup_input
+    set_keys(KbEscape => :close,
+             MsRight => :teleport_big_missile_to_midscreen,
+             KbD => [:debug!, false],
+             KbT => [:toggle_missile_info, false])
+  end
+
+  def setup_systems
+    # It's important to call super here to setup the InputSystem
+    super
+    use(FpsSystem)
+    use(StalkerSystem, :stalk => [Actor, Missile, Vector2d, Object])
+  end
+
+  def setup_actors
+    @big_missile = Missile.new(:mass => 0.3, :max_speed => 100, :max_turn_rate => 140)
+    @big_missile.teleport(width/2, height/2)
+    @big_missile.activate(:evade)
+    @big_missile.play_animation('missile.png')
+
+    @little_missile = Missile.new
+    @little_missile.activate(:pursuit)
+    @little_missile.play_animation('missile.png', :fps => 60, :height => 20)
+
+    @cursor = Cursor.new(:image => 'crosshair-3.png',
+                         :keys => {MsLeft => [:click, false]},
+                         :rand_color => true)
+
+    @window_info = TextBox.new(:size => 15)
+    @window_info.text("Press T to hide this text", :size => 24)
+    @window_info.watch(@systems[FpsSystem], :size => 20)
+    @window_info.watch(@systems[StalkerSystem], :color => 0xff33ccff)
+    @window_info.watch(@cursor, :color => @cursor.color)
+    @window_info.text("Click to start the simulation", :color => 0xffffff00)
+    @window_info.text("One will pursuit while the other evades, right click to center evader on screen")
+
+    @missile_info = TextBox.new(:attach_to => @big_missile, :size => 14)
+    @missile_info.watch(@big_missile)
+  end
+
+  def setup_events
+    @cursor.on(:click) do |x,y|
+      @big_missile.pursuer = @little_missile
+      @little_missile.evader = @big_missile
+    end
+  end
+
+  def teleport_big_missile_to_midscreen
+    @big_missile.pos.x = width/2
+    @big_missile.pos.y = height/2
+  end
+
+  def toggle_missile_info
+    @missile_info.toggle!
+    @window_info.toggle!
+  end
+end
+
+# Create and start the application
+SteeringMissiles.new.show

data/examples/steering_behaviors/pursuit_and_evade_multiple.rb

@@ -0,0 +1,116 @@
+#!/usr/bin/env ruby
+
+# Here you will learn about:
+# * The steering system pursuit, and evade_multiple behaviors
+# * How to play animations
+# * How to attach a text box to an actor
+
+LIB_PATH = File.join(File.dirname(__FILE__), '..', '..', 'lib', 'lotu.rb')
+require File.expand_path(LIB_PATH)
+
+include Gosu
+include Lotu
+
+# Let's define a Missile class that will use a Steering system to
+# control it's movement
+class Missile < Actor
+  def initialize(opts={})
+    super
+    # Activate the steering system and pass the opts, since they might
+    # have some config info for the system
+    use(SteeringSystem, opts)
+  end
+
+  def teleport(x, y)
+    @pos.x, @pos.y = x, y
+  end
+end
+
+# The main app class
+class EvadeMultiple < Game
+  def initialize
+    # This will call the hooks:
+    # load_resources, setup_systems, setup_input and setup_actors
+    # declared in the parent class
+    super
+    # Custom setup methods for this class
+    setup_events
+  end
+
+  # Let's load some images and animations, check out the animations
+  # directory, the animation there was created with:
+  # {Sprite Sheet Packer}[http://spritesheetpacker.codeplex.com/]
+  def load_resources
+    with_path_from_file(__FILE__) do
+      load_images '../media/images'
+      load_animations '../media/animations'
+    end
+  end
+
+  def setup_input
+    set_keys(KbEscape => :close,
+             MsRight => :teleport_big_missile_to_midscreen,
+             KbD => [:debug!, false],
+             KbT => [:toggle_info, false],
+             KbSpace => [:pause!, false])
+  end
+
+  def setup_systems
+    # It's important to call super here to setup the InputSystem
+    super
+    use(FpsSystem)
+    use(StalkerSystem, :stalk => [Actor, Missile, Vector2d, Object])
+  end
+
+  def setup_actors
+    @big_missile = Missile.new(:mass => 0.3, :max_speed => 100, :max_turn_rate => 140)
+    @big_missile.teleport(width/2, height/2)
+    @big_missile.activate(:evade_multiple)
+    @big_missile.play_animation('missile.png')
+
+    @little_missiles = []
+    5.times do |i|
+      @little_missiles << Missile.new(:x => 200 - rand(400), :y => 200 - rand(400), :rand_color => true)
+      @little_missiles[i].activate(:pursuit)
+      @little_missiles[i].play_animation('missile.png', :fps => 60+rand(60), :height => 10+rand(30))
+    end
+
+    @cursor = Cursor.new(:image => 'crosshair-3.png',
+                         :keys => {MsLeft => [:click, false]},
+                         :rand_color => true)
+
+    @window_info = TextBox.new(:size => 15)
+    @window_info.text("Press T to hide this text", :size => 24)
+    @window_info.watch(@systems[FpsSystem], :size => 20)
+    @window_info.watch(@systems[StalkerSystem], :color => 0xff33ccff)
+    @window_info.watch(@cursor, :color => @cursor.color)
+    @window_info.text("Click to start the simulation", :color => 0xffffff00)
+    @window_info.text("Little missiles will pursuit while the big one evades, right click to center big one on screen")
+
+    @missile_info = TextBox.new(:attach_to => @big_missile, :size => 14)
+    @missile_info.watch(@big_missile)
+  end
+
+  def setup_events
+    @cursor.on(:click) do |x,y|
+      @big_missile.pursuers = @little_missiles
+      @little_missiles.each do |lil_missile|
+        lil_missile.evader = @big_missile
+      end
+    end
+  end
+
+  def teleport_big_missile_to_midscreen
+    @big_missile.pos.x = width/2
+    @big_missile.pos.y = height/2
+  end
+
+  def toggle_info
+    @missile_info.toggle!
+    @window_info.toggle!
+  end
+
+end
+
+# Create and start the application
+EvadeMultiple.new.show

data/lib/lotu/actor.rb

@@ -27,12 +27,16 @@ module Lotu
       @parent.manage_me(self)
       set_image(opts[:image], opts) if opts[:image]
       parse_options(opts)
+      @color = rand_color if opts[:rand_color]
       @systems = {}
 
+      set_keys(opts[:keys]) unless opts[:keys].nil?
+
       # Add extra functionality
       self.extend Eventful
       self.extend Collidable
       use(AnimationSystem)
+      use(TransformationSystem)
     end
 
     # Easy access to delta-time
@@ -50,36 +54,60 @@ module Lotu
       @factor_x = opts[:factor_x] || @factor_x
       @factor_y = opts[:factor_y] || @factor_y
       @color = opts[:color] || @color
+      if @color.kind_of?(Integer)
+        @color = Gosu::Color.new(opts[:color])
+      end
       @mode = opts[:mode] || @mode
     end
 
+    def rand_color
+      Gosu::Color.from_hsv(rand(360), 1, 1)
+    end
+
     def set_image(image, opts={})
       @image = @parent.image(image)
-      puts "Image \"#{image}\" not found".red if @image.nil?
+      if @image.nil?
+        puts "Image \"#{image}\" not found".red
+        return
+      end
       parse_options(opts)
-      @width = opts[:width] || @image.width
-      @height = opts[:height] || @image.height
+      adjust_width_and_height(opts)
       calc_zoom
     end
 
     def set_gosu_image(image, opts={})
       @image = image
       parse_options(opts)
-      @width = opts[:width] || @image.width
-      @height = opts[:height] || @image.height
+      adjust_width_and_height(opts)
       calc_zoom
     end
 
     def width=(width)
-      @width = width
+      @width = Float(width)
       calc_zoom
     end
 
     def height=(height)
-      @height = height
+      @height = Float(height)
       calc_zoom
     end
 
+    def adjust_width_and_height(opts)
+      if(opts[:width] && opts[:height])
+        @width = Float(opts[:width])
+        @height = Float(opts[:height])
+      elsif(opts[:width])
+        @width = Float(opts[:width])
+        @height = @width * @image.height / @image.width
+      elsif(opts[:height])
+        @height = Float(opts[:height])
+        @width = @height * @image.width / @image.height
+      else
+        @width = Float(@image.width)
+        @height = Float(@image.height)
+      end
+    end
+
     def calc_zoom
       @zoom_x = Float(@width)/@image.width
       @zoom_y = Float(@height)/@image.height
@@ -97,8 +125,10 @@ module Lotu
     end
 
     def draw
-      @image.draw_rot(@x, @y, @z, @angle, @center_x, @center_y, @factor_x*@zoom_x, @factor_y*@zoom_y, @color, @mode) unless @image.nil?
-      draw_debug if $lotu.debug? unless @image.nil?
+      unless @image.nil?
+        @image.draw_rot(@x, @y, @z, @angle, @center_x, @center_y, @factor_x*@zoom_x, @factor_y*@zoom_y, @color, @mode)
+        draw_debug if $lotu.debug?
+      end
     end
 
     def draw_debug

data/lib/lotu/cursor.rb

@@ -7,7 +7,7 @@ module Lotu
     def initialize(opts={})
       default_opts = {
         :use_mouse => true,
-        :speed => 100,
+        :speed => 300,
         :x => $lotu.width/2,
         :y => $lotu.height/2
       }
@@ -18,10 +18,10 @@ module Lotu
       @clicked_x = @clicked_y = 0
       @speed = opts[:speed]
       @use_mouse = opts[:use_mouse]
-      set_keys(opts[:keys]) unless opts[:keys].nil?
     end
 
     def update
+      super
       if @use_mouse
         @x = $lotu.mouse_x
         @y = $lotu.mouse_y

data/lib/lotu/game.rb

@@ -7,12 +7,18 @@ module Lotu
 
     include SystemUser
 
-    def initialize(params={})
-      super(800, 600, false)
+    def initialize(opts={})
+      default_opts = {
+        :width => 1024,
+        :height => 768,
+        :fullscreen => false
+      }
+      opts = default_opts.merge!(opts)
+      super(opts[:width], opts[:height], opts[:fullscreen])
 
       # Handy global window variable
       $lotu = self
-      @debug = false
+      @debug = opts[:debug] || false
       setup_containers
 
       # For timer initialization
@@ -27,6 +33,14 @@ module Lotu
       setup_input
     end
 
+    def pause!
+      @pause = !@pause
+    end
+
+    def paused?
+      @pause
+    end
+
     def debug!
       @debug = !@debug
     end
@@ -75,7 +89,7 @@ module Lotu
       # Update each actor
       @update_queue.each do |actor|
         actor.update
-      end
+      end unless paused?
     end
 
     # Main draw loop
@@ -140,24 +154,34 @@ module Lotu
     end
 
     def load_images(path)
+      count = 0
       with_files(/\.png|\.jpg|\.bmp/, path) do |file_name, file_path|
+        count += 1
         @images[file_name] = Gosu::Image.new($lotu, file_path)
       end
+      puts "\n#{count} image(s) loaded."
     end
 
     def load_sounds(path)
+      count = 0
       with_files(/\.ogg|\.mp3|\.wav/, path) do |file_name, file_path|
+        count += 1
         @sounds[file_name] = Gosu::Sample.new($lotu, file_path)
       end
+      puts "\n#{count} sounds(s) loaded."
     end
 
     def load_songs(path)
+      count = 0
       with_files(/\.ogg|\.mp3|\.wav/, path) do |file_name, file_path|
+        count += 1
         @songs[file_name] = Gosu::Song.new($lotu, file_path)
       end
+      puts "\n#{count} song(s) loaded."
     end
 
     def load_animations(path)
+      count = 0
       coords = Hash.new{|h,k| h[k] = []}
 
       with_files(/\.txt/, path) do |file_name, file_path|
@@ -167,14 +191,17 @@ module Lotu
             coords[name] << line.scan(/\d+/).map!(&:to_i)
           end
         end
+        false
       end
 
       with_files(/\.png|\.jpg|\.bmp/, path) do |file_name, file_path|
         name, extension = file_name.split('.')
+        count += 1 if coords[name]
         coords[name].each do |index, x, y, width, height|
           @animations[file_name] << Gosu::Image.new($lotu, file_path, true, x, y, width, height)
         end
       end
+      puts "\n#{count} animation(s) loaded."
     end
 
     def with_path_from_file(path, &blk)
@@ -184,20 +211,17 @@ module Lotu
 
     def with_files(regexp, path)
       path = File.expand_path(File.join(@path, path))
-      puts "\nLoading from: #{path}"
+      puts "\nLoading from: #{path}".blue if @debug
 
-      count = 0
       Dir.entries(path).grep(regexp).each do |entry|
         begin
-          yield(entry, File.join(path, entry))
-          count += 1
-          print '.'.green
+          report = yield(entry, File.join(path, entry))
+          print '.'.green if report
         rescue Exception => e
           print '.'.red
           puts e, File.join(path, entry) if @debug
         end
       end
-      puts "\n#{count} file(s) loaded."
     end
 
   end

data/lib/lotu/systems/steering_system.rb

@@ -135,6 +135,23 @@ module Lotu
       return flee
     end
 
+    def evade_multiple
+      return @zero if @user.pursuers.empty?
+      combined_velocities = Vector2d.new
+      combined_positions = Vector2d.new
+      @user.pursuers.each do |p|
+        combined_velocities += p.vel
+        combined_positions += p.pos
+      end
+      combined_velocities /= @user.pursuers.length
+      combined_positions /= @user.pursuers.length
+      to_pursuers = combined_positions - @user.pos
+      look_ahead_time = to_pursuers.length / (@user.max_speed + combined_velocities.length)
+      predicted_position = combined_positions + combined_velocities * look_ahead_time
+      @user.target = combined_positions
+      return flee
+    end
+
     # TODO: Fix wander
     def wander
       wander_jitter = 10
@@ -166,9 +183,11 @@ module Lotu
           attr_accessor :mass, :pos, :heading, :vel, :accel,
           :max_speed, :max_turn_rate, :max_force,
           :wander_radius, :wander_distance, :wander_target,
-          :target, :evader, :pursuer
+          :target, :evader, :pursuer, :pursuers
         end
 
+        # TODO: move these inside the SteeringSystem?
+        # and just delegate with accessors?
         # Some defaults
         @pos = Vector2d.new(@x, @y)
         offset_x = Gosu.offset_x(@angle, 1)
@@ -177,6 +196,13 @@ module Lotu
         @vel = Vector2d.new
         @accel = Vector2d.new
         @wander_target = Vector2d.new
+        @pursuers = []
+
+        @colors = {
+          :position => 0xff666666,
+          :heading => 0xffff0000,
+          :target => rand_color
+        }
       end
 
       def activate(behavior)
@@ -191,15 +217,11 @@ module Lotu
         @heading.facing_to?(@target - @pos)
       end
 
-      def draw
-        super
-        draw_debug if $lotu.debug?
-      end
-
       def draw_debug
-        $lotu.draw_line(0, 0, 0xff999999, @pos.x, @pos.y, 0xff333333)
-        $lotu.draw_line(@pos.x, @pos.y, 0xffffffff, (@pos + @heading*50).x, (@pos+@heading*50).y, 0xffff0000)
-        $lotu.draw_line(@pos.x, @pos.y, 0xffffffff, @target.x, @target.y, 0xff00ff00) if @target
+        super
+        $lotu.draw_line(0, 0, @colors[:position], @pos.x, @pos.y, @colors[:position])
+        $lotu.draw_line(@pos.x, @pos.y, @colors[:heading], (@pos + @heading*50).x, (@pos+@heading*50).y, @colors[:heading])
+        $lotu.draw_line(@pos.x, @pos.y, @colors[:target], @target.x, @target.y, @colors[:target]) if @target
       end
 
       # to_s utility methods

data/lib/lotu/systems/transformation_system.rb

@@ -0,0 +1,122 @@
+module Lotu
+  class TransformationSystem < System
+
+    def initialize(user, opts={})
+      super
+      user.extend(UserMethods)
+      @transformations = []
+      @tagged_for_deletion = []
+    end
+
+    def transform(object, property, opts)
+      transformation = {
+        :object => object,
+        :property_getter => property,
+        :property_setter => "#{property}=",
+        :accum_time => 0,
+        :calc => 0,
+        :init => opts[:init],
+        :end => opts[:end],
+        :duration => opts[:duration] || 1,
+        :start_in => opts[:start_in] || 0,
+        :on_result => opts[:on_result],
+        :loop => opts[:loop]
+      }
+      @transformations << transformation
+    end
+
+    def update
+      @transformations.each do |t|
+        t[:accum_time] += dt
+        if t[:accum_time] > t[:start_in]
+          step = (t[:end] - t[:init])/t[:duration] * dt
+          t[:calc] += step
+          if step > 0
+            if t[:init] + t[:calc] > t[:end]
+              if t[:loop]
+                t[:calc] = 0
+              else
+                t[:calc] = t[:end] - t[:init]
+                tag_for_deletion(t)
+              end
+            end
+          else
+            if t[:init] + t[:calc] < t[:end]
+              if t[:loop]
+                t[:calc] = 0
+              else
+                t[:calc] = t[:end] - t[:init]
+                tag_for_deletion(t)
+              end
+            end
+          end
+          value = t[:init] + t[:calc]
+          value = value.send(t[:on_result]) if t[:on_result]
+          t[:object].send(t[:property_setter], value)
+        end
+      end
+
+      @tagged_for_deletion.each do |to_delete|
+        @transformations.delete(to_delete)
+      end.clear
+    end
+
+    def tag_for_deletion(transform)
+      @tagged_for_deletion << transform
+    end
+
+    def to_s
+      ["@transformations.length #{@transformations.length}",
+       "@tagged_for_deletion.length #{@tagged_for_deletion.length}"]
+    end
+
+    module UserMethods
+      def transform(object, property, opts)
+        @systems[TransformationSystem].transform(object, property, opts)
+      end
+
+      # Image helpers
+      def transform_angle(opts)
+        transform(self, :angle, opts)
+      end
+
+      def transform_width(opts)
+        transform(self, :width, opts)
+      end
+
+      def transform_height(opts)
+        transform(self, :height, opts)
+      end
+
+      # Color helpers
+      def transform_alpha(opts)
+        transform(@color, :alpha, opts.merge!(:on_result => :to_i))
+      end
+
+      def transform_red(opts)
+        transform(@color, :red, opts.merge!(:on_result => :to_i))
+      end
+
+      def transform_green(opts)
+        transform(@color, :green, opts.merge!(:on_result => :to_i))
+      end
+
+      def transform_blue(opts)
+        transform(@color, :blue, opts.merge!(:on_result => :to_i))
+      end
+
+      def transform_hue(opts)
+        transform(@color, :hue, opts)
+      end
+
+      def transform_saturation(opts)
+        transform(@color, :saturation, opts)
+      end
+
+      def transform_value(opts)
+        transform(@color, :value, opts)
+      end
+    end
+
+  end
+end

data/lib/lotu/text_box.rb

@@ -13,21 +13,32 @@ module Lotu
       @watch_list = []
       @size = opts[:size]
       @attached_to = opts[:attach_to]
+      @hiding = false
     end
 
-    def text(text, opts={})
-      watch(text, opts)
+    def hide!
+      @hiding = true
+    end
+
+    def show!
+      @hiding = false
+    end
+
+    def toggle!
+      @hiding = !@hiding
     end
 
     def watch(subject, opts={})
       @watch_list << [subject, opts]
     end
+    alias :text :watch
 
     def attach_to(actor)
       @attached_to = actor
     end
 
     def update
+      return if @hiding
       unless @attached_to.nil?
         @x = @attached_to.x + @attached_to.image.width / 2
         @y = @attached_to.y - @attached_to.image.height / 2
@@ -35,6 +46,7 @@ module Lotu
     end
 
     def draw
+      return if @hiding
       pos_y = 0
       @watch_list.each do |watched, opts|
         my_size = opts[:size] || @size

data/lib/lotu.rb

@@ -5,4 +5,4 @@ require 'gosu'
 %w{vector2d string}.each{|file| require "misc/#{file}"}
 %w{system_user collidable controllable eventful}.each{|file| require "behaviors/#{file}"}
 %w{game system actor cursor text_box}.each{|file| require file}
-%w{animation_system input_system stalker_system fps_system collision_system steering_system}.each{|file| require "systems/#{file}"}
+%w{transformation_system animation_system input_system stalker_system fps_system collision_system steering_system}.each{|file| require "systems/#{file}"}

data/lotu.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{lotu}
-  s.version = "0.1.11"
+  s.version = "0.1.12"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["lobo_tuerto"]
-  s.date = %q{2010-03-27}
+  s.date = %q{2010-03-28}
   s.description = %q{lotu aims to bring an agile and simple game development framework to life. It provides useful abstractions so you can concentrate on developing your game.}
   s.email = %q{dev@lobotuerto.com}
   s.extra_rdoc_files = [
@@ -24,7 +24,7 @@ Gem::Specification.new do |s|
      "README.rdoc",
      "Rakefile",
      "VERSION",
-     "examples/hello_world/hello_world.rb",
+     "examples/hello_world/moving_portraits.rb",
      "examples/media/animations/missile.png",
      "examples/media/animations/missile.txt",
      "examples/media/images/cohete-big.png",
@@ -36,8 +36,9 @@ Gem::Specification.new do |s|
      "examples/media/images/lobo_tuerto.png",
      "examples/media/images/missile-med.png",
      "examples/media/images/silo.png",
-     "examples/mouse_pointer/mouse_pointer.rb",
-     "examples/steering_behaviors/steering.rb",
+     "examples/screen_cursor/mouse_and_keyboard_cursors.rb",
+     "examples/steering_behaviors/pursuit_and_evade.rb",
+     "examples/steering_behaviors/pursuit_and_evade_multiple.rb",
      "lib/lotu.rb",
      "lib/lotu/actor.rb",
      "lib/lotu/behaviors/collidable.rb",
@@ -55,6 +56,7 @@ Gem::Specification.new do |s|
      "lib/lotu/systems/input_system.rb",
      "lib/lotu/systems/stalker_system.rb",
      "lib/lotu/systems/steering_system.rb",
+     "lib/lotu/systems/transformation_system.rb",
      "lib/lotu/text_box.rb",
      "lotu.gemspec",
      "test/actor_test.rb"
@@ -66,9 +68,10 @@ Gem::Specification.new do |s|
   s.summary = %q{A simple, agile Ruby game development framework.}
   s.test_files = [
     "test/actor_test.rb",
-     "examples/steering_behaviors/steering.rb",
-     "examples/hello_world/hello_world.rb",
-     "examples/mouse_pointer/mouse_pointer.rb"
+     "examples/steering_behaviors/pursuit_and_evade.rb",
+     "examples/steering_behaviors/pursuit_and_evade_multiple.rb",
+     "examples/hello_world/moving_portraits.rb",
+     "examples/screen_cursor/mouse_and_keyboard_cursors.rb"
   ]
 
   if s.respond_to? :specification_version then

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 11
-  version: 0.1.11
+  - 12
+  version: 0.1.12
 platform: ruby
 authors: 
 - lobo_tuerto
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-27 00:00:00 -06:00
+date: 2010-03-28 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -48,7 +48,7 @@ files:
 - README.rdoc
 - Rakefile
 - VERSION
-- examples/hello_world/hello_world.rb
+- examples/hello_world/moving_portraits.rb
 - examples/media/animations/missile.png
 - examples/media/animations/missile.txt
 - examples/media/images/cohete-big.png
@@ -60,8 +60,9 @@ files:
 - examples/media/images/lobo_tuerto.png
 - examples/media/images/missile-med.png
 - examples/media/images/silo.png
-- examples/mouse_pointer/mouse_pointer.rb
-- examples/steering_behaviors/steering.rb
+- examples/screen_cursor/mouse_and_keyboard_cursors.rb
+- examples/steering_behaviors/pursuit_and_evade.rb
+- examples/steering_behaviors/pursuit_and_evade_multiple.rb
 - lib/lotu.rb
 - lib/lotu/actor.rb
 - lib/lotu/behaviors/collidable.rb
@@ -79,6 +80,7 @@ files:
 - lib/lotu/systems/input_system.rb
 - lib/lotu/systems/stalker_system.rb
 - lib/lotu/systems/steering_system.rb
+- lib/lotu/systems/transformation_system.rb
 - lib/lotu/text_box.rb
 - lotu.gemspec
 - test/actor_test.rb
@@ -115,6 +117,7 @@ specification_version: 3
 summary: A simple, agile Ruby game development framework.
 test_files: 
 - test/actor_test.rb
-- examples/steering_behaviors/steering.rb
-- examples/hello_world/hello_world.rb
-- examples/mouse_pointer/mouse_pointer.rb
+- examples/steering_behaviors/pursuit_and_evade.rb
+- examples/steering_behaviors/pursuit_and_evade_multiple.rb
+- examples/hello_world/moving_portraits.rb
+- examples/screen_cursor/mouse_and_keyboard_cursors.rb

data/examples/hello_world/hello_world.rb

@@ -1,77 +0,0 @@
-#!/usr/bin/env ruby
-LIB_PATH = File.join(File.dirname(__FILE__), '..', '..', 'lib', 'lotu.rb')
-require File.expand_path(LIB_PATH)
-
-include Gosu::Button
-include Lotu
-
-class MovingRuby < Actor
-
-  def initialize(opts={})
-    super
-    # Use the image which filename is CptnRuby Gem.png
-    set_image 'lobo_tuerto.png', :factor_x => 0.5, :factor_y => 0.5
-  end
-
-  # Let's define some basic movement methods
-  def move_right
-    @x += 1
-  end
-
-  def move_left
-    @x -= 1
-  end
-
-  def move_up
-    @y -= 1
-  end
-
-  def move_down
-    @y += 1
-  end
-
-end
-
-class Example < Game
-
-  def initialize
-    # This will call the hooks:
-    # load_resources, setup_systems and setup_actors
-    # declared in the parent class
-    super
-    # When the Escape key is pressed, call the close method on class Example
-    set_keys(KbEscape => :close,
-             KbD => [:debug!, false])
-  end
-
-  def load_resources
-    # From this file,
-    with_path_from_file(__FILE__) do
-      # go back one dir and search inside media/
-      load_images '../media/images'
-    end
-  end
-
-  def setup_actors
-    # Create a ruby in the middle of the screen
-    @ruby = MovingRuby.new(:x => width/2, :y => height/2)
-    # Map keys to some methods
-    @ruby.set_keys(KbRight => :move_right,
-                   KbLeft => :move_left,
-                   KbUp => :move_up,
-                   KbDown => :move_down)
-    @ruby2 = MovingRuby.new(:x => width/2, :y => height/2)
-    # Map keys to some methods
-    @ruby2.set_keys(KbRight => :move_left,
-                    KbLeft => :move_right,
-                    KbUp => :move_up,
-                    KbDown => :move_down)
-    # Create a TextBox so we can display a message on screen
-    @info = TextBox.new
-    @info.text("Hello world!")
-    @info.text("Move around with arrow keys", :size => 16, :color => 0xff33ccff)
-  end
-
-end
-
-Example.new.show

data/examples/mouse_pointer/mouse_pointer.rb

@@ -1,92 +0,0 @@
-#!/usr/bin/env ruby
-LIB_PATH = File.join(File.dirname(__FILE__), '..', '..', 'lib', 'lotu.rb')
-require File.expand_path(LIB_PATH)
-
-include Gosu::Button
-include Lotu
-
-class WarpingRuby < Actor
-  def initialize(opts={})
-    super
-    set_image 'lobo_tuerto.png', :factor_x => 0.3, :factor_y => 0.3
-  end
-
-  def warp(x, y)
-    @x, @y = x, y
-  end
-end
-
-class Example < Game
-  def initialize
-    # This will call the hooks:
-    # load_resources, setup_systems and setup_actors
-    # declared in the parent class
-    super
-    # Custom setup methods for this class
-    setup_events
-  end
-
-  def load_resources
-    with_path_from_file(__FILE__) do
-      load_images '../media/images'
-    end
-  end
-
-  def setup_systems
-    # It's important to call super here to setup the InputSystem
-    super
-    use(FpsSystem)
-    use(StalkerSystem, :stalk => [Actor, Cursor, TextBox, WarpingRuby, Object])
-  end
-
-  def setup_input
-    set_keys(KbEscape => :close,
-             KbD => [:debug!, false])
-  end
-
-  def setup_events
-    @cursor1.on(:click) do |x,y|
-      @ruby.warp(x,y)
-    end
-    @cursor2.on(:click) do |x,y|
-      @ruby.warp(x,y)
-    end
-  end
-
-  def setup_actors
-    @ruby = WarpingRuby.new(:x => width/2, :y => height/2)
-    @cursor1 = Cursor.new(:image => 'crosshair-1.png',
-                          :keys => {MsLeft => [:click, false]},
-                          :color => 0xff0099ff,
-                          :width => 100,
-                          :height => 100)
-    @cursor2 = Cursor.new(:image => 'crosshair-2.png',
-                          :use_mouse => false,
-                          :keys => {
-                            KbSpace => [:click, false],
-                            KbUp => :up,
-                            KbDown => :down,
-                            KbLeft => :left,
-                            KbRight => :right},
-                          :color => 0xff99ff00,
-                          :factor_x => 0.5,
-                          :factor_y => 0.5)
-    @cursor2.x = width*3/4
-    @cursor2.y = height/2
-
-    # Create a TextBox with default option :size => 15
-    @info = TextBox.new(:size => 15)
-    @info.watch(@systems[FpsSystem])
-    @info.watch(@systems[StalkerSystem], :color => 0xff3ffccf)
-    # We can change the size for a specific line of text
-    @info.watch("@cursor1 data:", :size => 20)
-    # Color too
-    @info.watch(@cursor1, :color => 0xff0099ff)
-    @info.watch("@cursor2 data:", :size => 20)
-    @info.watch(@cursor2, :color => 0xff99ff00)
-    @info.text("Move @cursor1 with mouse and @cursor2 with arrow keys (click with space!)")
-  end
-
-end
-
-Example.new.show

data/examples/steering_behaviors/steering.rb

@@ -1,86 +0,0 @@
-#!/usr/bin/env ruby
-LIB_PATH = File.join(File.dirname(__FILE__), '..', '..', 'lib', 'lotu.rb')
-require File.expand_path(LIB_PATH)
-
-include Gosu::Button
-include Lotu
-
-class SteeringRuby < Actor
-  def initialize(opts={})
-    super
-    use(SteeringSystem, opts)
-  end
-
-  def warp(x, y)
-    @pos.x, @pos.y = x, y
-  end
-end
-
-class Example < Game
-  def initialize
-    # This will call the hooks:
-    # load_resources, setup_systems and setup_actors
-    # declared in the parent class
-    super
-    # Custom setup methods for this class
-    setup_events
-  end
-
-  def load_resources
-    with_path_from_file(__FILE__) do
-      load_images '../media/images'
-      load_animations '../media/animations'
-    end
-  end
-
-  def setup_input
-    set_keys(KbEscape => :close,
-             MsRight => :reset_ruby,
-             KbD => [:debug!, false])
-  end
-
-  def setup_systems
-    # It's important to call super here to setup the InputSystem
-    super
-    use(FpsSystem)
-    use(StalkerSystem, :stalk => [Actor, Vector2d, Object])
-  end
-
-  def setup_actors
-    @ruby = SteeringRuby.new(:mass => 0.3, :max_speed => 100, :max_turn_rate => 140)
-    @ruby.warp(width/2, height/2)
-    @ruby.activate(:evade)
-    @ruby.play_animation('missile.png')
-
-    @ruby2 = SteeringRuby.new
-    @ruby2.activate(:pursuit)
-    @ruby2.play_animation('missile.png', :factor_x => 0.5, :factor_y => 0.5, :fps => 60)
-
-    @cursor = Cursor.new(:image => 'crosshair-1.png',
-                         :keys => {MsLeft => [:click, false]})
-
-    @window_info = TextBox.new(:size => 15)
-    @window_info.watch(@systems[FpsSystem])
-    @window_info.watch(@systems[StalkerSystem])
-    @window_info.watch(@cursor, :color => 0xffff0000)
-    @window_info.text("Click to start the simulation")
-    @window_info.text("One will pursuit while the other evades, right click to center evader on screen")
-
-    @ruby_info = TextBox.new(:attach_to => @ruby, :size => 14)
-    @ruby_info.watch(@ruby)
-  end
-
-  def setup_events
-    @cursor.on(:click) do |x,y|
-      @ruby.pursuer = @ruby2
-      @ruby2.evader = @ruby
-    end
-  end
-
-  def reset_ruby
-    @ruby.pos.x = width/2
-    @ruby.pos.y = height/2
-  end
-end
-
-Example.new.show