rubygoal 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a4171d4bce9224cff1d3b5b459453ad54a506b49
+  data.tar.gz: 54ae3a19f22af90981e5cf3e7110562494e155f4
+SHA512:
+  metadata.gz: bac15b2f25e388b1232b600bf3848ce770e11a662a37b8af093e42426a13bb196fc6d7f6e982dae7c015cf895b26b7388886d05b81069bb3528f9f156f2662a8
+  data.tar.gz: a7887550de41ee2b0f1be75ff2a761128bb0a04e4bca26b565338dfb6576d2cf419ad2369fcf1cd0a2a12da8fc1cd4db8c2ed34e2d8f19f9bf32a590dbf38403

data/MIT-LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2014 Jorge Bejar
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+This does not apply to files under the "media/" folder.

data/README.md

@@ -0,0 +1,62 @@
+#Bienvenidos a RubyGoal!
+
+## ¿Qué es RubyGoal?
+
+RubyGoal es un juego en el cual tú serás el coach de un equipo de
+fútbol.
+
+La estrategia del coach la vas a tener que implementar tú en ruby.
+
+## Dependencias
+
+GNU/Linux, Asegúrate tener todas las dependencias instaladas.
+
+Ubuntu/Debian:
+
+```bash
+# Gosu's dependencies for both C++ and Ruby
+sudo apt-get install build-essential freeglut3-dev libfreeimage-dev libgl1-mesa-dev \
+                     libopenal-dev libpango1.0-dev libsdl-ttf2.0-dev libsndfile-dev \
+                     libxinerama-dev
+```
+
+Para otras distros: https://github.com/jlnr/gosu/wiki/Getting-Started-on-Linux
+
+## ¿Cómo hago para correrlo?
+
+```bash
+gem install rubygoal
+```
+
+Correr el juego con los `Coach` de ejemplo
+```bash
+rubygoal
+```
+
+Correr el juego con tu implementación de `Coach`
+```bash
+rubygoal coach_1.rb
+```
+
+Correr el juego con tu implementación de ambos `Coach`
+```bash
+rubygoal coach_1.rb coach_2.rb
+```
+
+## ¿Cómo hago para implementar mi Coach?
+
+Mirate los `Coach` ya definidos en `lib/rubygoal/coaches`, sobre todo lee con
+atención y en su totalidad `lib/rubygoal/coaches/template.rb`
+
+## Legal
+
+Todo el código fuente, salvo los archivos bajo la carpeta `media/`, está
+licenciado bajo los términos de la licencia del MIT. Ver el archivo `MIT-LICENSE`
+bajo la ruta de la gema.
+
+La imagen de Alberto Kesman utilizada en el archivo `media/goal.png` fue
+tomada de https://commons.wikimedia.org/wiki/File:Albertok.jpg que se
+encuentra licenciada bajo los términos de la licencia CC-BY-SA 3.0
+(https://creativecommons.org/licenses/by-sa/3.0/deed.es). Como
+consecuencia, el archivo `media/goal.png` queda licenciado también bajo
+esta licencia como trabajo derivado.

data/bin/rubygoal

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# -*- mode: ruby -*-
+
+require 'rubygoal'
+Rubygoal.start

data/lib/rubygoal/ball.rb

@@ -0,0 +1,41 @@
+require 'gosu'
+
+require 'rubygoal/field_metrics'
+require 'rubygoal/moveable'
+
+module Rubygoal
+  class Ball
+    include Moveable
+
+    def initialize(window, position)
+      super()
+      @position = position
+      @image = Gosu::Image.new(window, Config.ball.image_file, false)
+    end
+
+    def goal?
+      FieldMetrics.goal?(position)
+    end
+
+    def draw
+      image.draw(position.x - Config.ball.width / 2, position.y - Config.ball.height / 2, 1)
+    end
+
+    def update
+      super
+      if FieldMetrics.out_of_bounds_width?(position)
+        velocity.x *= -1
+      end
+      if FieldMetrics.out_of_bounds_height?(position)
+        velocity.y *= -1
+      end
+
+      velocity.x *= 0.95
+      velocity.y *= 0.95
+    end
+
+    private
+
+    attr_reader :image
+  end
+end

data/lib/rubygoal/coach.rb

@@ -0,0 +1,11 @@
+module Rubygoal
+  class Coach
+    def name
+      raise NotImplementedError
+    end
+
+    def formation(match)
+      raise NotImplementedError
+    end
+  end
+end

data/lib/rubygoal/coach_loader.rb

@@ -0,0 +1,32 @@
+module Rubygoal
+  module CoachLoader
+    class << self
+      def get(default)
+        file = ARGV.shift
+
+        if file && File.exists?(file)
+          load file
+
+          class_name = camelize(File.basename(file, ".rb"))
+          Rubygoal.const_get(class_name).new
+        else
+          if file
+            puts "File `#{file}` doesn't exist. Using #{default.name}."
+          end
+
+          default.new
+        end
+      end
+
+      private
+
+      def camelize(term)
+        string = term.to_s
+        string = string.sub(/^[a-z\d]*/) { $&.capitalize }
+        string.gsub!(/(?:_|(\/))([a-z\d]*)/i) { "#{$1}#{$2.capitalize}" }
+        string.gsub!('/', '::')
+        string
+      end
+    end
+  end
+end

data/lib/rubygoal/coaches/coach_away.rb

@@ -0,0 +1,52 @@
+require 'rubygoal/coach'
+require 'rubygoal/formation'
+
+module Rubygoal
+  class CoachAway < Coach
+    def name
+      "Danubio"
+    end
+
+    def formation(match)
+      formation = Formation.new
+
+      if match.me.winning?
+        formation.lineup = [
+          [:average, :none, :average, :none,    :none],
+          [:fast,    :none, :none,    :average, :none],
+          [:none,    :none, :captain, :none,    :fast],
+          [:fast,    :none, :none,    :none, :average],
+          [:average, :none, :average, :none,    :none],
+        ]
+      elsif match.me.draw?
+        formation.lineup = [
+          [:average, :none, :average, :none,    :none],
+          [:fast, :none, :none,    :none,    :fast],
+          [:none,    :fast, :none,    :captain, :none],
+          [:average, :none, :none,    :none,    :average],
+          [:average, :none, :average, :none,    :none],
+        ]
+      elsif match.me.losing?
+        if match.time < 30
+          formation.lineup = [
+            [:none,    :none, :average, :none,    :none],
+            [:average, :none, :none,    :none,    :average],
+            [:average, :fast, :none,    :captain, :none],
+            [:average, :none, :fast,    :none,    :fast],
+            [:none,    :none, :average, :none,    :none],
+          ]
+        else
+          formation.lineup = [
+            [:none,    :none,    :average, :none, :none],
+            [:average, :none,    :none,    :none, :average],
+            [:fast,    :average, :none,    :fast, :none],
+            [:average, :none,    :captain, :none, :fast],
+            [:none,    :none,    :average, :none, :none],
+          ]
+        end
+      end
+
+      formation
+    end
+  end
+end

data/lib/rubygoal/coaches/coach_home.rb

@@ -0,0 +1,28 @@
+require 'rubygoal/coach'
+require 'rubygoal/formation'
+
+module Rubygoal
+  class CoachHome < Coach
+    def name
+      "Wanderers"
+    end
+
+    def formation(match)
+      formation = Formation.new
+
+      if match.me.winning?
+        formation.defenders = [:average, :average, :average, :captain, :average]
+        formation.midfielders = [:average, :none, :fast, :none, :average]
+        formation.attackers = [:none, :fast, :none, :fast, :none]
+      elsif match.time < 20
+        formation.defenders = [:none, :fast, :average, :average, :none]
+        formation.midfielders = [:average, :average, :captain, :none, :average]
+        formation.attackers = [:fast, :none, :none, :fast, :average]
+      else
+        formation.lineup = match.other.formation.lineup
+      end
+
+      formation
+    end
+  end
+end

data/lib/rubygoal/coaches/template.rb

@@ -0,0 +1,198 @@
+# RubyGoal - Fútbol para Rubistas
+#
+# Este documento contiene varias implementaciones mínimas de un entrenador de RubyGoal.#
+#
+# Esta clase debe implementar, como mínimo, los métodos `name` y `formation(match)`
+# Esta clase debe ser implementada dentro del módulo Rubygoal
+
+module Rubygoal
+  class MyCoach < Coach
+    # Indica el nombre del equipo
+    # Debe retornar un string
+    def name
+      "My team name"
+    end
+
+    # Este método debe devolver una instancia de Formation indicando como
+    # se tienen que parar los jugadores en la cancha
+    #
+    # Este método es invocado constantemente (varias veces por segundo)
+    # proporcionando información de como va el partido utilizando el
+    # parámetro match
+    def formation(match)
+      formation = Formation.new
+
+      # La clase Formation tiene varios helpers para ayudar a definir la
+      # formación del equipo
+      #
+      # La cancha se divide en una matriz de 5 por 5
+      #
+      #   ------------------------------
+      #   | N     N     N     N     N  |
+      #   |                            |
+      #   | N     N     N     N     N  |
+      # A |                            | A
+      # R | N     N     N     N     N  | R
+      # C |                            | C
+      # O | N     N     N     N     N  | O
+      #   |                            |
+      #   | N     N     N     N     N  |
+      #   ------------------------------
+      #
+      # Esto es un ejemplo que posiciona jugadores en columnas de la matriz
+      #
+      # Los tipos de jugadores válidos son :average, :fast, :captain
+      # Se usa :none para las posiciones que no se usen en la línea
+      #
+      # Restricciones:
+      # Exactamente un :captain
+      # Exactamente tres :fast
+      # Exactamente seis :average
+      #
+      # :captain -> Este jugador es el más rápido y preciso del equipo
+      # :fast -> Estos jugadores son más rápidos que los demás (aunque más lentos que
+      #          el capitán del equipo)
+      # :average -> Estos jugadores completan el equipo
+      #
+      # El arquero no hay que especificarlo, ya viene incluido por defecto
+      formation.defenders = [:none, :average, :average, :average, :none]
+      formation.midfielders = [:average, :fast, :captain, :none, :average]
+      formation.attackers = [:none, :fast, :none, :fast, :average]
+
+      # Esto produce la siguiente alineación
+      #
+      #   ------------------------------
+      #   | N     N     A     N     N  |
+      #   |                            |
+      #   | A     N     F     N     F  |
+      # A |                            | A
+      # R | A     N     C     N     N  | R
+      # C |                            | C
+      # O | A     N     N     N     F  | O
+      #   |                            |
+      #   | N     N     A     N     A  |
+      #   ------------------------------
+
+      formation
+    end
+  end
+
+  # Lo siguiente es otra implementación posible de una instancia de Coach
+
+  class AnotherCoach < Coach
+    def name
+      "Maeso FC"
+    end
+
+    # El método formation debe devolver una instancia de Formation
+    # El siguiten ejemplo muestra como controlar la posición de los jugadores
+    # de una forma más fina, usando el método `lineup`
+    #
+    def formation(match)
+      formation = Formation.new
+
+      # Por defecto el valor de formation.lineup es
+      #
+      # [
+      #   [:none, :none, :none, :none, :none],
+      #   [:none, :none, :none, :none, :none],
+      #   [:none, :none, :none, :none, :none],
+      #   [:none, :none, :none, :none, :none],
+      #   [:none, :none, :none, :none, :none],
+      # ]
+      #
+      # Este valor DEBE sobreescribirse con una formación que incluya las
+      # cantidades correctas de :average, :fast y :captain
+      #
+      # Para este tipo de estrategias es importante siempre considerar que el arco
+      # que atacas es el de la derecha.
+      #
+      # En el siguiente ejemplo, la formación 4322 puede interpretarse
+      # de la siguiente manera
+      #                |                            |
+      #      defensa   |     medio campo            | delantera
+      # [              |                            |
+      #   [  :average, | :none, :average, :none,    | :none     ],
+      #   [  :fast,    | :none, :none,    :average, | :none     ],
+      #   [  :none,    | :none, :captain, :none,    | :fast     ],
+      #   [  :fast,    | :none, :none,    :average, | :average  ],
+      #   [  :average, | :none, :average, :none,    | :none     ],
+      # ]              |                            |
+      #                |                            |
+      #
+      # Usando `lineup`, la línea mas defensiva son los primeros elementos de
+      # cada uno de los arrays (:average, :fast, :none, :fast, :average)
+      #
+      # La segunda línea (entre la defensa y los mediocampistas) no tiene jugadores
+      # (son todos :none)
+      #
+      # La tercer línea, la que corresponde a los mediocampistas, son el tercer
+      # elemento de cada array (:average, :none, :captain, :none, :average)
+      #
+      # La cuarta línea está ubicada entre los mediocampistas y delanteros
+      # (:none, :average, :none, :average, :none)
+      #
+      # Los últimos elementos de los arrays corresponden a la línea de
+      # delanteros (:none, :none, :fast, :average, :none)
+      formation.lineup = [
+        [:average, :none, :average, :none,    :none],
+        [:fast,    :none, :none,    :average, :none],
+        [:none,    :none, :captain, :none,    :fast],
+        [:fast,    :none, :none,    :average, :average],
+        [:average, :none, :average, :none,    :none],
+      ]
+
+      formation
+    end
+  end
+
+  # Otra implementación posible de una instancia de Coach
+
+  # Gran parte de la gracia de este juego está en hacer cambios en la formación
+  # a medida que va transcurriendo el partido
+  #
+  # La instancia de `match` que recibe el método `formation` contiene información
+  # sobre el partido y el rival de turno
+  #
+  # Veamos un ejemplo
+
+  class MyCoach < Coach
+    def name
+      "Villa Pancha"
+    end
+
+    def formation(match)
+      formation = Formation.new
+
+      # El método `me` trae información sobre mi equipo en el partido
+      #
+      # me.winning? indica si estoy ganando
+      # me.losing? y me.draw? son análogos al anterior :)
+      # me.score me indica la cantidad exacta de goles que marcó mi equipo
+      if match.me.winning?
+        formation.defenders = [:average, :average, :average, :captain, :average]
+        formation.midfielders = [:average, :none, :fast, :none, :average]
+        formation.attackers = [:none, :fast, :none, :fast, :none]
+        #
+        # El método `time` indica cuanto tiempo (segundos) le queda al partido.
+        # Devuelve un número entre 120 y 0 (120 cuando comienza el partido)
+      elsif match.time < 10
+        formation.defenders = [:none, :average, :average, :average, :none]
+        formation.midfielders = [:average, :average, :captain, :none, :average]
+        formation.attackers = [:fast, :fast, :none, :fast, :average]
+      else
+        #
+        # El método `other` devuelve información básica del rival. Tiene los mismos
+        # métodos que `me`.
+        #
+        # En particular, se puede acceder a la formación definida por el equipo
+        # contrario. En la siguiente linea, a modo de ejemplo, se estableció
+        # una táctica `espejo` con respecto al rival (posiciono mis jugadores en forma
+        # simétrica)
+        formation.lineup = match.other.formation.lineup
+      end
+
+      formation
+    end
+  end
+end

data/lib/rubygoal/config.rb

@@ -0,0 +1,64 @@
+require 'rubygoal/config_definitions'
+require 'rubygoal/coordinate'
+
+module Rubygoal
+  module Config
+    field.width                   = 1392
+    field.height                  = 934
+    field.offset                  = Position.new(262, 114)
+    field.goal_height             = 275
+    field.close_to_goal_distance  = 275
+    field.background_image_file   = File.dirname(__FILE__) + '/../../media/background.png'
+
+    team.initial_player_positions = [
+                                      [50, 466],
+                                      [236, 106],
+                                      [236, 286],
+                                      [236, 646],
+                                      [236, 826],
+                                      [436, 106],
+                                      [436, 286],
+                                      [436, 646],
+                                      [436, 826],
+                                      [616, 436],
+                                      [616, 496]
+                                    ]
+    team.average_players_count    = 7
+    team.fast_players_count       = 3
+    team.captain_players_count    = 1
+
+
+    ball.width                    = 20
+    ball.height                   = 20
+    ball.image_file               = File.dirname(__FILE__) + '/../../media/ball.png'
+
+
+    player.time_to_kick_again     = 60
+    player.distance_control_ball  = 30
+    player.kick_strength          = 20
+
+
+    player.captain_home_image_file  = File.dirname(__FILE__) + '/../../media/captain_home.png'
+    player.captain_away_image_file  = File.dirname(__FILE__) + '/../../media/captain_away.png'
+    player.fast_home_image_file     = File.dirname(__FILE__) + '/../../media/fast_home.png'
+    player.fast_away_image_file     = File.dirname(__FILE__) + '/../../media/fast_away.png'
+    player.average_home_image_file  = File.dirname(__FILE__) + '/../../media/average_home.png'
+    player.average_away_image_file  = File.dirname(__FILE__) + '/../../media/average_away.png'
+
+
+    goal.image_file               = File.dirname(__FILE__) + '/../../media/goal.png'
+
+
+    game.time                      = 120
+    game.goal_image_position       = Position.new(596, 466)
+    game.time_label_position       = Position.new(870, 68)
+    game.score_home_label_position = Position.new(1150, 68)
+    game.score_away_label_position = Position.new(1220, 68)
+    game.max_name_length           = 20
+    game.default_font_size         = 48
+    game.team_label_font_size      = 64
+    game.team_label_width          = 669
+    game.home_team_label_position  = Position.new(105, 580)
+    game.away_team_label_position  = Position.new(1815, 580)
+  end
+end

data/lib/rubygoal/config_definitions.rb

@@ -0,0 +1,77 @@
+module Rubygoal
+  module Config
+    class Field  < Struct.new(:width,
+                              :height,
+                              :offset,
+                              :goal_height,
+                              :close_to_goal_distance,
+                              :background_image_file)
+    end
+
+    class Team   < Struct.new(:initial_player_positions,
+                             :average_players_count,
+                             :fast_players_count,
+                             :captain_players_count)
+    end
+
+    class Ball   < Struct.new(:width,
+                              :height,
+                              :image_file)
+    end
+
+    class Player < Struct.new(:time_to_kick_again,
+                              :distance_control_ball,
+                              :kick_strength,
+                              :average_home_image_file,
+                              :average_away_image_file,
+                              :fast_home_image_file,
+                              :fast_away_image_file,
+                              :captain_home_image_file,
+                              :captain_away_image_file)
+    end
+
+    class Goal   < Struct.new(:image_file,
+                              :sound_file)
+    end
+
+    class Game   < Struct.new(:time,
+                              :goal_image_position,
+                              :time_label_position,
+                              :score_home_label_position,
+                              :score_away_label_position,
+                              :max_name_length,
+                              :default_font_size,
+                              :team_label_font_size,
+                              :team_label_width,
+                              :home_team_label_position,
+                              :away_team_label_position,
+                              :background_sound_file)
+    end
+
+    class << self
+      def field
+        @field ||= Field.new
+      end
+
+      def team
+        @team ||= Team.new
+      end
+
+      def ball
+        @ball ||= Ball.new
+      end
+
+      def player
+        @player ||= Player.new
+      end
+
+      def goal
+        @goal ||= Goal.new
+      end
+
+      def game
+        @game ||= Game.new
+      end
+    end
+  end
+end

data/lib/rubygoal/coordinate.rb

@@ -0,0 +1,25 @@
+require 'gosu'
+
+module Rubygoal
+  class Coordinate < Struct.new(:x, :y)
+    def distance(coordinate)
+      Gosu.distance(x, y, coordinate.x, coordinate.y)
+    end
+
+    def add(coordinate)
+      Coordinate.new(x + coordinate.x, y + coordinate.y)
+    end
+
+    def to_s
+      "(#{x}, #{y})"
+    end
+  end
+
+  class Position < Coordinate; end
+
+  class Velocity < Coordinate
+    def nonzero?
+      x != 0 && y != 0
+    end
+  end
+end