gosu-examples 1.0.4 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 888d1aceda91b77fb517e8b8bcf29c0465b0db10
-  data.tar.gz: b078a35fb710a436a9c1a0f1df81a01e3483a28e
+SHA256:
+  metadata.gz: cb2816210de706b627f2c8120ee44874cd16035676c20f6b18d14ac52b3c3b09
+  data.tar.gz: 58c289986480228d033a32ba8c3e934d6166ff6b458fa2897fdafa09f90ddc9b
 SHA512:
-  metadata.gz: 90eddc66bbd574cf91b55c8c61c7796ad4146612d14c5f72c092643ae03bcacfe0dbda96e6296c9c75051ba99c1880d088d8dd049f7d06bfde4ea5da71c7f658
-  data.tar.gz: 9ca2489faf897835cd19a248c23f500d250ecf95a385873b8ee728ccdef028a47fba38b172870837a0bb94cab5ea924d0bc0e51a9fb77ca6134d907bdc7d24f7
+  metadata.gz: 59bb842a0be571014dbdf4e4257840f383360de3c79a7fecccc981ca384e6b27938da9e3544a843268ae6d8c5125e099154f4f6afc690796fe534fb10a644969
+  data.tar.gz: 32c948f2eeed4ac34d5168f7dea387c3c8d8fcbbea758088ca68fcfa95e0aa37f5ff46c925eaa410c450651966907c8d744118507c01191afb80b7550b612b02

data/bin/gosu-examples

@@ -1,25 +1,27 @@
 #!/usr/bin/env ruby
 
-require 'rubygems'
-require 'gosu'
+require "gosu"
 
 Dir.chdir "#{File.dirname __FILE__}/../examples"
 
 $LOAD_PATH << "#{File.dirname __FILE__}/../lib/gosu-examples"
 
-require 'example'
-require 'sidebar'
+require "example"
+require "sidebar"
 
 Example.load_examples "*.rb"
 
 class ExampleBox < Gosu::Window
   def initialize
-    super Sidebar::WIDTH, Sidebar::HEIGHT, :fullscreen => ARGV.include?('--fullscreen')
-    
-    @sidebar = Sidebar.new { |example| change_example(example) }
+    welcome_class = Example.initial_example
+    welcome = welcome_class.new
+
+    super welcome.width + Sidebar::WIDTH, welcome.height, fullscreen: ARGV.include?("--fullscreen")
     
-    welcome_class = Example.examples.find { |example| example.name =~ /::Welcome$/ }
-    change_example(welcome_class)
+    @sidebar = Sidebar.new do |example_class|
+      self.current_example = example_class.new unless @current_example.is_a? example_class
+    end
+    self.current_example = welcome
   end
   
   def update
@@ -43,11 +45,11 @@ class ExampleBox < Gosu::Window
     case id
     when Gosu::KB_ESCAPE
       close
-    when Gosu.char_to_button_id('E')
+    when Gosu.char_to_button_id("E")
       if filename = @current_example.class.source_file
         open_file_or_folder filename
       end
-    when Gosu.char_to_button_id('O')
+    when Gosu.char_to_button_id("O")
       if filename = @current_example.class.source_file
         open_file_or_folder File.dirname(filename)
       end
@@ -73,14 +75,12 @@ class ExampleBox < Gosu::Window
   
   private
   
-  def change_example(example)
-    if @current_example.class != example
-      @current_example = nil
-      GC.start
-      @current_example = example.new
-      self.width = @current_example.width + Sidebar::WIDTH
-      self.height = @current_example.height
-    end
+  def current_example=(example)
+    self.text_input = nil
+    @current_example = example
+    @current_example.parent_window = self
+    self.width  = @current_example.width + Sidebar::WIDTH
+    self.height = @current_example.height
   end
   
   def open_file_or_folder(filename)

data/examples/chipmunk_and_rmagick.rb

@@ -6,10 +6,9 @@
 # License: Same as for Gosu (MIT)
 # Created on 21/10/2007, 00:05:19 by Robert Sheehan
 
-require 'rubygems'
-require 'gosu'
-require 'chipmunk'
-require 'rmagick'
+require "gosu"
+require "chipmunk"
+require "rmagick"
 
 # Layering of sprites
 module ZOrder
@@ -42,7 +41,7 @@ class ChipmunkAndRMagick < (Example rescue Gosu::Window)
     fill = Magick::TextureFill.new(Magick::ImageList.new("granite:"))
     background = Magick::Image.new(WIDTH, HEIGHT, fill)
     setup_triangles(background)
-    @background_image = Gosu::Image.new(background, :tileable => true) # turn the image into a Gosu one
+    @background_image = Gosu::Image.new(background, tileable: true) # turn the image into a Gosu one
     @boxes = create_boxes(NUM_POLYGONS)
   end
   
@@ -51,8 +50,8 @@ class ChipmunkAndRMagick < (Example rescue Gosu::Window)
   def setup_triangles(background)
     gc = Magick::Draw.new
     gc.stroke_width(2)
-    gc.stroke('red')
-    gc.fill('blue')
+    gc.stroke("red")
+    gc.fill("blue")
     # all the triangles are part of the same body
     body = CP::Body.new(Float::MAX, Float::MAX)
     base = 15
@@ -87,10 +86,10 @@ class ChipmunkAndRMagick < (Example rescue Gosu::Window)
   
   # Produces the image of a polygon.
   def polygon_image(vertices)
-    box_image = Magick::Image.new(EDGE_SIZE  * 2, EDGE_SIZE * 2) { self.background_color = 'transparent' }
+    box_image = Magick::Image.new(EDGE_SIZE  * 2, EDGE_SIZE * 2) { self.background_color = "transparent" }
     gc = Magick::Draw.new
-    gc.stroke('red')
-    gc.fill('plum')
+    gc.stroke("red")
+    gc.fill("plum")
     draw_vertices = vertices.map { |v| [v.x + EDGE_SIZE, v.y + EDGE_SIZE] }.flatten
     gc.polygon(*draw_vertices)
     gc.draw(box_image)

data/examples/chipmunk_integration.rb

@@ -8,9 +8,8 @@
 ## Comments: Based on the Gosu Ruby Tutorial, but incorporating the Chipmunk Physics Engine
 ## See https://github.com/jlnr/gosu/wiki/Ruby-Chipmunk-Integration for the accompanying text.
 
-require 'rubygems'
-require 'gosu'
-require 'chipmunk'
+require "gosu"
+require "chipmunk"
 
 WIDTH = 640
 HEIGHT = 480
@@ -125,7 +124,7 @@ class ChipmunkIntegration < (Example rescue Gosu::Window)
     
     self.caption = "Gosu & Chipmunk Integration Demo"
     
-    @background_image = Gosu::Image.new("media/space.png", :tileable => true)
+    @background_image = Gosu::Image.new("media/space.png", tileable: true)
 
     # Put the beep here, as it is the environment now that determines collision
     @beep = Gosu::Sample.new("media/beep.wav")

data/examples/cptn_ruby.rb

@@ -1,6 +1,6 @@
 # Encoding: UTF-8
 
-# Basically, the tutorial game taken to a jump'n'run perspective.
+# A simple jump-and-run/platformer game with a tile-based map.
 
 # Shows how to
 #  * implement jumping/gravity
@@ -27,8 +27,7 @@
 # ...Enemies, a more sophisticated object system, weapons, title and credits
 # screens...
 
-require 'rubygems'
-require 'gosu'
+require "gosu"
 
 WIDTH, HEIGHT = 640, 480
 
@@ -140,7 +139,7 @@ class Map
   
   def initialize(filename)
     # Load 60x60 tiles, 5px overlap in all four directions.
-    @tileset = Gosu::Image.load_tiles("media/tileset.png", 60, 60, :tileable => true)
+    @tileset = Gosu::Image.load_tiles("media/tileset.png", 60, 60, tileable: true)
 
     gem_img = Gosu::Image.new("media/gem.png")
     @gems = []
@@ -193,7 +192,7 @@ class CptnRuby < (Example rescue Gosu::Window)
     
     self.caption = "Cptn. Ruby"
     
-    @sky = Gosu::Image.new("media/space.png", :tileable => true)
+    @sky = Gosu::Image.new("media/space.png", tileable: true)
     @map = Map.new("media/cptn_ruby_map.txt")
     @cptn = Player.new(@map, 400, 100)
     # The scrolling position is stored as top left corner of the screen.

data/examples/opengl_integration.rb

@@ -5,9 +5,8 @@
 # the block given to Window#gl, and that Gosu Images can be
 # used as textures using the gl_tex_info call.
 
-require 'rubygems'
-require 'gosu'
-require 'gl'
+require "gosu"
+require "gl"
 
 WIDTH, HEIGHT = 640, 480
 
@@ -25,7 +24,7 @@ class GLBackground
   SCROLLS_PER_STEP = 50
 
   def initialize
-    @image = Gosu::Image.new("media/earth.png", :tileable => true)
+    @image = Gosu::Image.new("media/earth.png", tileable: true)
     @scrolls = 0
     @height_map = Array.new(POINTS_Y) { Array.new(POINTS_X) { rand } }
   end

data/examples/rmagick_integration.rb

@@ -1,6 +1,6 @@
 # Encoding: UTF-8
 
-# A (too) simple Gorilla-style shooter for two players.
+# A simple Gorilla-style shooter for two players.
 # Shows how Gosu and RMagick can be used together to generate a map, implement
 # a dynamic landscape and generally look great.
 # Also shows a very minimal, yet effective way of designing a game's object system.
@@ -13,13 +13,12 @@
 # * The look of dead soldiers is, err, by accident. Soldier.png needs to be
 #   designed in a less obfuscated way :)
 
-require 'rubygems'
-require 'gosu'
-require 'rmagick'
+require "gosu"
+require "rmagick"
 
 WIDTH, HEIGHT = 640, 480
 
-NULL_PIXEL = Magick::Pixel.from_color('none')
+NULL_PIXEL = Magick::Pixel.from_color("none")
 
 # The class for this game's map.
 # Design:
@@ -35,13 +34,13 @@ class Map
     # Loading SVG files isn't possible with Gosu, so say wow!
     # (Seems to take a while though)
     sky = Magick::Image.read("media/landscape.svg").first
-    @sky = Gosu::Image.new(sky, :tileable => true)
+    @sky = Gosu::Image.new(sky, tileable: true)
       
     # Create the map an stores the RMagick image in @image
     create_rmagick_map
     
     # Copy the RMagick Image to a Gosu Image (still unchanged)
-    @gosu_image = Gosu::Image.new(@image, :tileable => true)
+    @gosu_image = Gosu::Image.new(@image, tileable: true)
   end
   
   def solid? x, y
@@ -68,9 +67,9 @@ class Map
   # Create the crater image (basically a circle shape that is used to erase
   # parts of the map) and the crater shadow image.
   CRATER_IMAGE = begin
-    crater = Magick::Image.new(2 * RADIUS, 2 * RADIUS) { self.background_color = 'none' }
+    crater = Magick::Image.new(2 * RADIUS, 2 * RADIUS) { self.background_color = "none" }
     gc = Magick::Draw.new
-    gc.fill('black').circle(RADIUS, RADIUS, RADIUS, 0)
+    gc.fill("black").circle(RADIUS, RADIUS, RADIUS, 0)
     gc.draw crater
     crater
   end
@@ -93,14 +92,14 @@ class Map
   
   def create_rmagick_map
     # This is the one large RMagick image that represents the map.
-    @image = Magick::Image.new(WIDTH, HEIGHT) { self.background_color = 'none' }
+    @image = Magick::Image.new(WIDTH, HEIGHT) { self.background_color = "none" }
     
     # Set up a Draw object that fills with an earth texture.
-    earth = Magick::Image.read('media/earth.png').first.resize(1.5)
+    earth = Magick::Image.read("media/earth.png").first.resize(1.5)
     gc = Magick::Draw.new
-    gc.pattern('earth', 0, 0, earth.columns, earth.rows) { gc.composite(0, 0, 0, 0, earth) }    
-    gc.fill('earth')
-    gc.stroke('#603000').stroke_width(1.5)
+    gc.pattern("earth", 0, 0, earth.columns, earth.rows) { gc.composite(0, 0, 0, 0, earth) }    
+    gc.fill("earth")
+    gc.stroke("#603000").stroke_width(1.5)
     # Draw a smooth bezier island onto the map!
     polypoints = [0, HEIGHT]
     0.upto(8) do |x|
@@ -112,13 +111,13 @@ class Map
     
     # Create a bright-dark gradient fill, an image from it and change the map's
     # brightness with it.
-    fill = Magick::GradientFill.new(0, HEIGHT * 0.4, WIDTH, HEIGHT * 0.4, '#fff', '#666')
+    fill = Magick::GradientFill.new(0, HEIGHT * 0.4, WIDTH, HEIGHT * 0.4, "#fff", "#666")
     gradient = Magick::Image.new(WIDTH, HEIGHT, fill)
     gradient = @image.composite(gradient, 0, 0, Magick::InCompositeOp)
     @image.composite!(gradient, 0, 0, Magick::MultiplyCompositeOp)
 
     # Finally, place the star in the middle of the map, just onto the ground.
-    star = Magick::Image.read('media/large_star.png').first
+    star = Magick::Image.read("media/large_star.png").first
     star_y = 0
     star_y += 20 until solid?(WIDTH / 2, star_y)
     @image.composite!(star, (WIDTH - star.columns) / 2, star_y - star.rows * 0.85,
@@ -299,7 +298,7 @@ end
 class Particle
   def initialize(window, x, y)
     # All Particle instances use the same image
-    @@image ||= Gosu::Image.new('media/smoke.png')
+    @@image ||= Gosu::Image.new("media/smoke.png")
     
     @x, @y = x, y
     @color = Gosu::Color.new(255, 255, 255, 255)
@@ -342,10 +341,10 @@ class RMagickIntegration < (Example rescue Gosu::Window)
       @player_instructions << Gosu::Image.from_text(
         "It is the #{ plr == 0 ? 'green' : 'red' } toy soldier's turn.\n" +
         "(Arrow keys to walk and aim, Return to jump, Space to shoot)",
-        30, :width => width, :align => :center)
+        30, width: width, align: :center)
       @player_won_messages << Gosu::Image.from_text(
         "The #{ plr == 0 ? 'green' : 'red' } toy soldier has won!",
-        30, :width => width, :align => :center)
+        30, width: width, align: :center)
     end
 
     # Create everything!

data/examples/text_input.rb

@@ -0,0 +1,158 @@
+# This example demonstrates use of the TextInput class with three text field widgets.
+# One can cycle through them with tab, or click into the text fields and change their contents.
+
+# The way TextInput works is that you create an instance of it, and then assign it to the text_input
+# attribute of your window.
+# Until you set this attribute to nil again, the TextInput object will then build a string from user
+# input that can be accessed via TextInput#text.
+
+# The TextInput object also maintains the position of the caret, which is defined as the index of
+# its right neighbour character, i.e. a carent_pos of 0 is always the left-most position, and a
+# caret_pos of text.length is always the right-most position.
+# There is a second attribute called selection_start that is equal to caret_pos when there is no
+# selection, and otherwise defines the selected range. If you set caret_pos to a different value,
+# you usually want to set selection_start as well.
+
+# A TextInput object is purely abstract. Drawing the input field is left to the user.
+# In this example, we are subclassing TextInput to add this code, but you can also work with
+# composition instead of inheritance.
+
+require "gosu"
+
+class TextField < Gosu::TextInput
+  FONT = Gosu::Font.new(20)
+  WIDTH = 350
+  LENGTH_LIMIT = 20
+  PADDING = 5
+  
+  INACTIVE_COLOR  = 0xcc_666666
+  ACTIVE_COLOR    = 0xcc_ff6666
+  SELECTION_COLOR = 0xcc_0000ff
+  CARET_COLOR     = 0xff_ffffff
+  
+  attr_reader :x, :y
+  
+  def initialize(window, x, y)
+    # It's important to call the inherited constructor.
+    super()
+    
+    @window, @x, @y = window, x, y
+    
+    # Start with a self-explanatory text in each field.
+    self.text = "Click to edit"
+  end
+  
+  # In this example, we use the filter method to prevent the user from entering a text that exceeds
+  # the length limit. However, you can also use this to blacklist certain characters, etc.
+  def filter new_text
+    allowed_length = [LENGTH_LIMIT - text.length, 0].max
+    new_text[0, allowed_length]
+  end
+  
+  def draw(z)
+    # Change the background colour if this is the currently selected text field.
+    if @window.text_input == self
+      color = ACTIVE_COLOR
+    else
+      color = INACTIVE_COLOR
+    end
+    Gosu.draw_rect x - PADDING, y - PADDING, WIDTH + 2 * PADDING, height + 2 * PADDING, color, z
+    
+    # Calculate the position of the caret and the selection start.
+    pos_x = x + FONT.text_width(self.text[0...self.caret_pos])
+    sel_x = x + FONT.text_width(self.text[0...self.selection_start])
+    sel_w = pos_x - sel_x
+    
+    # Draw the selection background, if any. (If not, sel_x and pos_x will be
+    # the same value, making this a no-op call.)
+    Gosu.draw_rect sel_x, y, sel_w, height, SELECTION_COLOR, z
+
+    # Draw the caret if this is the currently selected field.
+    if @window.text_input == self
+      Gosu.draw_line pos_x, y, CARET_COLOR, pos_x, y + height, CARET_COLOR, z
+    end
+
+    # Finally, draw the text itself!
+    FONT.draw self.text, x, y, z
+  end
+  
+  def height
+    FONT.height
+  end
+
+  # Hit-test for selecting a text field with the mouse.
+  def under_mouse?
+    @window.mouse_x > x - PADDING and @window.mouse_x < x + WIDTH + PADDING and
+      @window.mouse_y > y - PADDING and @window.mouse_y < y + height + PADDING
+  end
+  
+  # Tries to move the caret to the position specifies by mouse_x
+  def move_caret_to_mouse
+    # Test character by character
+    1.upto(self.text.length) do |i|
+      if @window.mouse_x < x + FONT.text_width(text[0...i])
+        self.caret_pos = self.selection_start = i - 1;
+        return
+      end
+    end
+    # Default case: user must have clicked the right edge
+    self.caret_pos = self.selection_start = self.text.length
+  end
+end
+
+class TextInputDemo < (Example rescue Gosu::Window)
+  def initialize
+    super 640, 480
+    self.caption = "Text Input Demo"
+    
+    
+    text =
+      "This demo explains (in the source code) how to use the Gosu::TextInput API by building a little TextField class around it.
+      
+      Each text field can take up to 30 characters, and you can use Tab to switch between them.
+
+      As in every example, press <b>S</b> to look at the source code."
+    
+    # Remove all leading spaces so the text is left-aligned
+    text.gsub! /^ +/, ""
+    
+    @text = Gosu::Image.from_text text, 20, width: 540
+        
+    # Set up an array of three text fields.
+    @text_fields = Array.new(3) { |index| TextField.new(self, 50, 300 + index * 50) }
+  end
+  
+  def needs_cursor?
+    true
+  end
+
+  def draw
+    @text.draw 50, 50, 0
+    @text_fields.each { |tf| tf.draw(0) }
+  end
+  
+  def button_down(id)
+    if id == Gosu::KB_TAB
+      # Tab key will not be 'eaten' by text fields; use for switching through
+      # text fields.
+      index = @text_fields.index(self.text_input) || -1
+      self.text_input = @text_fields[(index + 1) % @text_fields.size]
+    elsif id == Gosu::KB_ESCAPE
+      # Escape key will not be 'eaten' by text fields; use for deselecting.
+      if self.text_input
+        self.text_input = nil
+      else
+        close
+      end
+    elsif id == Gosu::MS_LEFT
+      # Mouse click: Select text field based on mouse position.
+      self.text_input = @text_fields.find { |tf| tf.under_mouse? }
+      # Also move caret to clicked position
+      self.text_input.move_caret_to_mouse unless self.text_input.nil?
+    else
+      super
+    end
+  end
+end
+
+TextInputDemo.new.show if __FILE__ == $0

data/examples/tutorial.rb

@@ -1,7 +1,6 @@
 # Encoding: UTF-8
 
-require 'rubygems'
-require 'gosu'
+require "gosu"
 
 module ZOrder
   BACKGROUND, STARS, PLAYER, UI = *0..3
@@ -86,7 +85,7 @@ class Tutorial < (Example rescue Gosu::Window)
     super 640, 480
     self.caption = "Tutorial Game"
     
-    @background_image = Gosu::Image.new("media/space.png", :tileable => true)
+    @background_image = Gosu::Image.new("media/space.png", tileable: true)
     
     @player = Player.new
     @player.warp(320, 240)

data/examples/welcome.rb

@@ -1,7 +1,6 @@
 # Encoding: UTF-8
 
-require 'rubygems'
-require 'gosu'
+require "gosu"
 
 WIDTH, HEIGHT = 640, 480
 
@@ -27,12 +26,12 @@ class Welcome < (Example rescue Gosu::Window)
       • To quit this tool, press <b>Esc</b>.
       • To toggle fullscreen mode, press <b>Alt+Enter</b> (Windows, Linux) or <b>cmd+F</b> (macOS).
       
-      Why not take a look at the code for this example right now? Simply press <b>S</b>."
+      Why not take a look at the code for this example right now? Simply press <b>E</b>."
     
     # Remove all leading spaces so the text is left-aligned
-    text.gsub! /^ +/, ''
+    text.gsub! /^ +/, ""
     
-    @text = Gosu::Image.from_text text, 20, :width => WIDTH - 2 * PADDING
+    @text = Gosu::Image.from_text text, 20, width: WIDTH - 2 * PADDING
     
     @background = Gosu::Image.new "media/space.png"
   end

data/lib/gosu-examples/example.rb

@@ -1,6 +1,7 @@
 class Example
   attr_accessor :caption
   attr_reader :width, :height
+  attr_writer :parent_window
   
   def initialize(width, height, *options)
     @width, @height = width, height
@@ -22,6 +23,22 @@ class Example
     # no-op, examples cannot close the containing window.
   end
 
+  def mouse_x
+    @parent_window && @parent_window.mouse_x
+  end
+  
+  def mouse_y
+    @parent_window && @parent_window.mouse_y
+  end
+  
+  def text_input
+    @parent_window && @parent_window.text_input
+  end
+  
+  def text_input=(text_input)
+    @parent_window && @parent_window.text_input = text_input
+  end
+  
   def self.current_source_file
     @current_source_file
   end
@@ -43,6 +60,10 @@ class Example
     @@examples[self]
   end
   
+  def self.initial_example
+    @@examples.keys.find { |cls| cls.name.end_with? "::Welcome" }
+  end
+  
   def self.load_examples(pattern)
     Dir.glob(pattern) do |file| 
       begin

data/lib/gosu-examples/sidebar.rb

@@ -2,7 +2,7 @@ class Sidebar
   WIDTH = 300
   HEIGHT = 600
   FONT = Gosu::Font.new(20)
-  HEADER = Gosu::Image.new("media/header@2x.psd", :tileable => true)
+  HEADER = Gosu::Image.new("media/header@2x.psd", tileable: true)
   
   class Button
     HEIGHT = 25
@@ -19,7 +19,7 @@ class Sidebar
       text_color = Gosu::Color::BLACK
       
       if is_current
-        Gosu.draw_rect 0, @top, Sidebar::WIDTH, HEIGHT, 0xff_1565e5 if is_current
+        Gosu.draw_rect 0, @top, Sidebar::WIDTH, HEIGHT, 0xff_1565e5
         text_color = Gosu::Color::WHITE
       end
       

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gosu-examples
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.0.5
 platform: ruby
 authors:
 - Julian Raschke
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-22 00:00:00.000000000 Z
+date: 2018-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gosu
@@ -81,6 +81,7 @@ files:
 - examples/media/vera.ttf
 - examples/opengl_integration.rb
 - examples/rmagick_integration.rb
+- examples/text_input.rb
 - examples/tutorial.rb
 - examples/welcome.rb
 - lib/gosu-examples/example.rb
@@ -104,7 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.8
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Ruby examples for the Gosu library