bestguigui 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c098e1e773be91e7506d48bb7f1c2fef8025af453f60add33b975be1aa836aff
+  data.tar.gz: 981e6bf032e7389399657099a8deae6ea70e610de92ca803fe71d3e9aee65397
+SHA512:
+  metadata.gz: 1f4cb28f78d7535d7c7bf740441c9233dd711f4f27ffdfb0803ab6538a15e1fcd662b29744b321479a845bc18842248cca41098939c64d8dabfaceba8bb0e19a
+  data.tar.gz: 8fb391d5e19062ecda593814427dac9ee454ab44f53c28e9ef9f493502d51f91023c74ab0940ee655b9dfd1b9d1270c61419215cfc9f2b0bfb66cf0d9c0a2c8c

data/lib/bestguigui/app.rb

@@ -0,0 +1,37 @@
+module Bestguigui
+  # Sous-classe pour ton jeu, appelle switch_state pour changer d'écran.
+  class App < Gosu::Window
+    def initialize(width: 800, height: 600, title: "Game")
+      super(width, height)
+      self.caption = title
+      @last_update_time = Gosu.milliseconds
+    end
+
+    def switch_state(state)
+      @state&.exit
+      @state = state
+      @state.app = self
+      @state.enter
+    end
+
+    def update
+      now = Gosu.milliseconds
+      dt = (now - @last_update_time) / 1000.0
+      @last_update_time = now
+
+      @state&.update(dt)
+    end
+
+    def draw
+      @state&.draw
+    end
+
+    def button_down(id)
+      @state&.button_down(id)
+    end
+
+    def button_up(id)
+      @state&.button_up(id)
+    end
+  end
+end

data/lib/bestguigui/entity.rb

@@ -0,0 +1,55 @@
+module Bestguigui
+  # Rectangle positionné (x, y, width, height) avec détection de collision
+  # AABB. Sous-classe pour tes joueurs/ennemis/objets, avec ton propre
+  # update/draw.
+  #
+  #   class Player < Bestguigui::Entity
+  #     def initialize
+  #       super(x: 400, y: 280, width: 40, height: 40)
+  #     end
+  #
+  #     def update(dt)
+  #       self.x += 200 * dt if Gosu.button_down?(Gosu::KB_RIGHT)
+  #     end
+  #
+  #     def draw
+  #       Gosu.draw_rect(x, y, width, height, Gosu::Color::YELLOW, 1)
+  #     end
+  #   end
+  #
+  #   player.collides?(coin) # => true/false
+  class Entity
+    attr_accessor :x, :y, :width, :height
+
+    def initialize(x: 0, y: 0, width: 0, height: 0)
+      @x = x
+      @y = y
+      @width = width
+      @height = height
+    end
+
+    def update(dt); end
+    def draw; end
+
+    def left
+      x
+    end
+
+    def right
+      x + width
+    end
+
+    def top
+      y
+    end
+
+    def bottom
+      y + height
+    end
+
+    # Chevauchement de rectangles (AABB), le classique en 2D pour du jam.
+    def collides?(other)
+      left < other.right && right > other.left && top < other.bottom && bottom > other.top
+    end
+  end
+end

data/lib/bestguigui/input.rb

@@ -0,0 +1,23 @@
+module Bestguigui
+  # Associe des actions nommées à un ou plusieurs boutons (clavier, manette,
+  # souris — Gosu les identifie tous par le même type d'id, donc une manette
+  # se rajoute sans rien changer d'autre).
+  #
+  #   @keys = Bestguigui::Input.new(
+  #     up:    [Gosu::KB_UP, Gosu::KB_W],
+  #     down:  [Gosu::KB_DOWN, Gosu::KB_S],
+  #     left:  [Gosu::KB_LEFT, Gosu::KB_A],
+  #     right: [Gosu::KB_RIGHT, Gosu::KB_D]
+  #   )
+  #
+  #   @keys.down?(:up) # true si une des touches liées à :up est enfoncée
+  class Input
+    def initialize(bindings)
+      @bindings = bindings
+    end
+
+    def down?(action)
+      (@bindings[action] || []).any? { |key| Gosu.button_down?(key) }
+    end
+  end
+end

data/lib/bestguigui/menu.rb

@@ -0,0 +1,124 @@
+module Bestguigui
+  # Liste de choix avec un index sélectionné. Gère l'input (haut/bas/valider)
+  # et son propre rendu (texte + fond + bordure optionnels) — un state n'a en
+  # général rien d'autre à écrire que la construction du menu.
+  #
+  #   @menu = Bestguigui::Menu.new(
+  #     {
+  #       "New Game" => lambda { app.switch_state(GameplayState.new) },
+  #       "Load"     => lambda { app.switch_state(LoadState.new) },
+  #       "Exit"     => lambda { app.close! }
+  #     },
+  #     x: 300, y: 220,
+  #     font_size: 32,
+  #     color: Gosu::Color::WHITE,
+  #     selected_color: Gosu::Color::YELLOW,
+  #     background: Gosu::Color.new(200, 20, 20, 20),
+  #     border_color: Gosu::Color::WHITE,
+  #     border_width: 2,
+  #     padding: 16,
+  #     line_height: 40
+  #   )
+  #
+  #   def button_down(id) = @menu.button_down(id)
+  #   def draw = @menu.draw
+  #
+  # Rendu custom possible via each_item si le style intégré ne convient pas :
+  #   @menu.each_item { |label, selected| ... }
+  class Menu
+    def initialize(items, x: 0, y: 0, font_size: 28, color: Gosu::Color::WHITE,
+                   selected_color: Gosu::Color::YELLOW, background: nil,
+                   border_color: nil, border_width: 2, padding: 12, line_height: 40)
+      @labels = items.keys
+      @actions = items.values
+      @index = 0
+
+      @x = x
+      @y = y
+      @font_size = font_size
+      @color = color
+      @selected_color = selected_color
+      @background = background
+      @border_color = border_color
+      @border_width = border_width
+      @padding = padding
+      @line_height = line_height
+    end
+
+    def up
+      @index = (@index - 1) % @labels.size
+    end
+
+    def down
+      @index = (@index + 1) % @labels.size
+    end
+
+    def confirm
+      @actions[@index].call
+    end
+
+    # Mapping clavier par défaut : flèches ou Z/S pour naviguer,
+    # Entrée/Espace pour valider.
+    def button_down(id)
+      case id
+      when Gosu::KB_UP, Gosu::KB_W then up
+      when Gosu::KB_DOWN, Gosu::KB_S then down
+      when Gosu::KB_RETURN, Gosu::KB_SPACE then confirm
+      end
+    end
+
+    def selected_label
+      @labels[@index]
+    end
+
+    # yield(label, selected?) pour chaque item, dans l'ordre.
+    def each_item
+      @labels.each_with_index { |label, i| yield label, i == @index }
+    end
+
+    def font
+      @font ||= Gosu::Font.new(@font_size)
+    end
+
+    def draw
+      draw_background
+      draw_border
+      draw_items
+    end
+
+    private
+
+    def box_width
+      @labels.map { |label| font.text_width("> #{label}") }.max + @padding * 2
+    end
+
+    def box_height
+      @padding * 2 + @labels.size * @line_height
+    end
+
+    def draw_background
+      return unless @background
+
+      Gosu.draw_rect(@x, @y, box_width, box_height, @background, 0)
+    end
+
+    def draw_border
+      return unless @border_color
+
+      w, h, t = box_width, box_height, @border_width
+      Gosu.draw_rect(@x, @y, w, t, @border_color, 1)                 # haut
+      Gosu.draw_rect(@x, @y + h - t, w, t, @border_color, 1)         # bas
+      Gosu.draw_rect(@x, @y, t, h, @border_color, 1)                 # gauche
+      Gosu.draw_rect(@x + w - t, @y, t, h, @border_color, 1)         # droite
+    end
+
+    def draw_items
+      text_y = @y + @padding
+      each_item do |label, selected|
+        text = selected ? "> #{label}" : "  #{label}"
+        font.draw_text(text, @x + @padding, text_y, 2, 1, 1, selected ? @selected_color : @color)
+        text_y += @line_height
+      end
+    end
+  end
+end

data/lib/bestguigui/state.rb

@@ -0,0 +1,13 @@
+module Bestguigui
+  # Sous-classe pour chaque écran (menu, jeu, game over...).
+  class State
+    attr_accessor :app
+
+    def enter; end
+    def exit; end
+    def update(dt); end
+    def draw; end
+    def button_down(id); end
+    def button_up(id); end
+  end
+end

data/lib/bestguigui/version.rb

@@ -0,0 +1,3 @@
+module Bestguigui
+  VERSION = "0.1.0"
+end

data/lib/bestguigui.rb

@@ -0,0 +1,8 @@
+require "gosu"
+
+require_relative "bestguigui/version"
+require_relative "bestguigui/state"
+require_relative "bestguigui/input"
+require_relative "bestguigui/menu"
+require_relative "bestguigui/entity"
+require_relative "bestguigui/app"

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: bestguigui
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Guillaume Quillet
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gosu
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+description: States, menus, input bindings and simple entities on top of Gosu, built
+  to move fast during game jams.
+email:
+- qgdevfr@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/bestguigui.rb
+- lib/bestguigui/app.rb
+- lib/bestguigui/entity.rb
+- lib/bestguigui/input.rb
+- lib/bestguigui/menu.rb
+- lib/bestguigui/state.rb
+- lib/bestguigui/version.rb
+homepage: https://github.com/guillaumequillet/bestguigui
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/guillaumequillet/bestguigui
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: A small Gosu layer to build game jam games faster.
+test_files: []