gosu 0.7.3-universal-darwin8.0 → 0.7.4-universal-darwin8.0

data/examples/CptnRuby.rb

@@ -0,0 +1,218 @@
+# Basically, the tutorial game taken to a jump'n'run perspective.
+
+# Shows how to
+#  * implement jumping/gravity
+#  * implement scrolling
+#  * implement a simple tile-based map
+#  * load levels from primitive text files
+
+# Some exercises, starting at the real basics:
+#  0) understand the existing code!
+# As shown in the tutorial:
+#  1) change it use Gosu's Z-ordering
+#  2) add gamepad support
+#  3) add a score as in the tutorial game
+#  4) similarly, add sound effects for various events
+# Exploring this game's code and Gosu:
+#  5) make the player wider, so he doesn't fall off edges as easily
+#  6) add background music (check if playing in Window#update to implement 
+#     looping)
+# Getting tricky:
+#  7) optimize Map#draw so only tiles on screen are drawn (needs modulo, a pen
+#     and paper to figure out)
+#  8) add loading of next level when all gems are collected
+# Enemies, a more sophisticated object system, weapons, title and credits
+# screens...
+
+require 'gosu'
+include Gosu
+
+module Tiles
+  Grass = 0
+  Earth = 1
+end
+
+# Collectible item.
+class Gem
+  attr_reader :x, :y
+
+  def initialize(image, x, y)
+    @image = image
+    @x, @y = x, y
+  end
+  
+  def draw(screen_x, screen_y)
+    # Draw, slowly rotating
+    @image.draw_rot(@x - screen_x, @y - screen_y, 0,
+      25 * Math.sin(milliseconds / 133.7))
+  end
+end
+
+# Player class.
+class CptnRuby
+  attr_reader :x, :y
+
+  def initialize(window, x, y)
+    @x, @y = x, y
+    @dir = :left
+    @vy = 0 # Vertical velocity
+    @map = window.map
+    # Load all animation frames
+    @standing, @walk1, @walk2, @jump =
+      *Image.load_tiles(window, "media/CptnRuby.png", 50, 50, false)
+    # This always points to the frame that is currently drawn.
+    # This is set in update, and used in draw.
+    @cur_image = @standing    
+  end
+  
+  def draw(screen_x, screen_y)
+    # Flip vertically when facing to the left.
+    if @dir == :left then
+      offs_x = -25
+      factor = 1.0
+    else
+      offs_x = 25
+      factor = -1.0
+    end
+    @cur_image.draw(@x - screen_x + offs_x, @y - screen_y - 49, 0, factor, 1.0)
+  end
+  
+  # Could the object be placed at x + offs_x/y + offs_y without being stuck?
+  def would_fit(offs_x, offs_y)
+    # Check at the center/top and center/bottom for map collisions
+    not @map.solid?(@x + offs_x, @y + offs_y) and
+      not @map.solid?(@x + offs_x, @y + offs_y - 45)
+  end
+  
+  def update(move_x)
+    # Select image depending on action
+    if (move_x == 0)
+      @cur_image = @standing
+    else
+      @cur_image = (milliseconds / 175 % 2 == 0) ? @walk1 : @walk2
+    end
+    if (@vy < 0)
+      @cur_image = @jump
+    end
+    
+    # Directional walking, horizontal movement
+    if move_x > 0 then
+      @dir = :right
+      move_x.times { if would_fit(1, 0) then @x += 1 end }
+    end
+    if move_x < 0 then
+      @dir = :left
+      (-move_x).times { if would_fit(-1, 0) then @x -= 1 end }
+    end
+
+    # Acceleration/gravity
+    # By adding 1 each frame, and (ideally) adding vy to y, the player's
+    # jumping curve will be the parabole we want it to be.
+    @vy += 1
+    # Vertical movement
+    if @vy > 0 then
+      @vy.times { if would_fit(0, 1) then @y += 1 else @vy = 0 end }
+    end
+    if @vy < 0 then
+      (-@vy).times { if would_fit(0, -1) then @y -= 1 else @vy = 0 end }
+    end
+  end
+  
+  def try_to_jump
+    if @map.solid?(@x, @y + 1) then
+      @vy = -20
+    end
+  end
+  
+  def collect_gems(gems)
+    # Same as in the tutorial game.
+    gems.reject! do |c|
+      (c.x - @x).abs < 50 and (c.y - @y).abs < 50
+    end
+  end
+end
+
+# Map class holds and draws tiles and gems.
+class Map
+  attr_reader :width, :height, :gems
+  
+  def initialize(window, filename)
+    @tileset = Image.load_tiles(window, "media/CptnRuby Tileset.bmp", 50, 50, true)
+    @sky = Image.new(window, "media/Space.png", true)
+
+    gem_img = Image.new(window, "media/CptnRuby Gem.png", false)
+    @gems = []
+
+    lines = File.readlines(filename).map { |line| line.chop }
+    @height = lines.size
+    @width = lines[0].size
+    @tiles = Array.new(@width) do |x|
+      Array.new(@height) do |y|
+        case lines[y][x, 1]
+        when '"'
+          Tiles::Grass
+        when '#'
+          Tiles::Earth
+        when 'x'
+          @gems.push(Gem.new(gem_img, x * 50 + 25, y * 50 + 25))
+          nil
+        else
+          nil
+        end
+      end
+    end
+  end
+  
+  def draw(screen_x, screen_y)
+    # Very primitive drawing function:
+    # Draws all the tiles, some off-screen, some on-screen.
+    @sky.draw(0, 0, 0)
+    @height.times do |y|
+      @width.times do |x|
+        tile = @tiles[x][y]
+        if tile
+          @tileset[tile].draw(x * 50 - screen_x, y * 50 - screen_y, 0)
+        end
+      end
+    end
+    @gems.each { |c| c.draw(screen_x, screen_y) }
+  end
+  
+  # Solid at a given pixel position?
+  def solid?(x, y)
+    y < 0 || @tiles[x / 50][y / 50]
+  end
+end
+
+class Game < Window
+  attr_reader :map
+
+  def initialize
+    super(640, 480, false, 20)
+    self.caption = "Cptn. Ruby"
+    @map = Map.new(self, "media/CptnRuby Map.txt")
+    @cptn = CptnRuby.new(self, 400, 100)
+    # Scrolling is stored as the position of the top left corner of the screen.
+    @screen_x = @screen_y = 0
+  end
+  def update
+    move_x = 0
+    move_x -= 5 if button_down? Button::KbLeft
+    move_x += 5 if button_down? Button::KbRight
+    @cptn.update(move_x)
+    @cptn.collect_gems(@map.gems)
+    # Scrolling follows player
+    @screen_x = [[@cptn.x - 320, 0].max, @map.width * 50 - 640].min
+    @screen_y = [[@cptn.y - 240, 0].max, @map.height * 50 - 480].min
+  end
+  def draw
+    @map.draw @screen_x, @screen_y
+    @cptn.draw @screen_x, @screen_y
+  end
+  def button_down(id)
+    if id == Button::KbUp then @cptn.try_to_jump end
+    if id == Button::KbEscape then close end
+  end
+end
+
+Game.new.show

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.4
 specification_version: 1
 name: gosu
 version: !ruby/object:Gem::Version 
-  version: 0.7.3
-date: 2007-08-10 00:00:00 +02:00
+  version: 0.7.4
+date: 2007-08-15 00:00:00 +02:00
 summary: 2D game development library.
 require_paths: 
   - lib
@@ -42,6 +42,7 @@ files:
   - examples/media/Star.png
   - examples/media/Starfighter.bmp
   - examples/Tutorial.rb
+  - examples/CptnRuby.rb
   - lib/gosu.bundle
   - README
   - LICENSE