minigl 2.5.1 → 2.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6078cf1c0aafd790460ec6b7723dff865c0a2e78a8359fd8734cd8a6a07aec60
-  data.tar.gz: 61be9170370e9b912a7c3a7087ca145de121f36b005abf62bfe193ca1dc29ec3
+  metadata.gz: 6d76d1851d74339e98ce7cf452a95f001ff0dc5d757641dc22920769905aa0f7
+  data.tar.gz: a3ac0315dc9fb04cdafaac737e90678f58d7aea3b694d8662e2cd447f2eb4622
 SHA512:
-  metadata.gz: 68d1060caaf63cfe944a924b692c38680833a15fa49412060295904e630d8b73e5b6342abf4febf1ff6d9324e88f61e0a34fa5c9014e70b376cafa10402e0df5
-  data.tar.gz: ff9db71adca879e4ec8b7044c1864477befb45eff207cdd0dc2b1ff3d97d4f6f3f0255e1d61e6705293d7ab3d490c484543f40cd861545cf1936b5b09d2da590
+  metadata.gz: b2d9f56c53f76cf02461c8d76aca13836e9010e8265394e8fcc59a372e22ad145f5d8572beb33d4cf498632e425d9b0a0c905fe0f3ddd566aa31b841a96dc84e
+  data.tar.gz: ad58132b5c6ea3bd4b377648e3ed02421f32783ba8dadbb80cdb6edcbe12b09bea720a15fd64d41dfaa8e78aa1956490e376e62c4e5e3c3219d9e35cd9d6fc69

data/README.md

@@ -43,13 +43,9 @@ After installing the Gosu dependencies, you can just `gem install minigl`.
   * The [wiki](https://github.com/victords/minigl/wiki) is a work in progress with tutorials and examples.
   * Test package and examples aren't complete!
 
-## Version 2.5.0
+## Version 2.5.2
 
-  * Added `Particles` (particle system) class. Run `test/particles_game.rb` to check its capabilities!
-
-### Version 2.5.1
-
-  Patch fixing the required Ruby version (>= 3.1).
+  * Added `source_offset_x` and `source_offset_y` initialization options and `move_to` method to `Particles`.
 
 ## Contributing
 

data/lib/minigl/particles.rb

@@ -3,13 +3,18 @@ module MiniGL
   class Particles
     # Create a new particle system.
     # Options:
-    # - x: x-coordinate of the origin of the particle system. If +source+ is
-    #   set, it has precedence.
-    # - y: y-coordinate of the origin of the particle system. If +source+ is
-    #   set, it has precedence.
+    # - x (Numeric): x-coordinate of the origin of the particle system. If
+    #   +source+ is set, it has precedence.
+    # - y (Numeric): y-coordinate of the origin of the particle system. If
+    #   +source+ is set, it has precedence.
     # - source: if set, must be an object that responds to +x+ and +y+. The
-    #   position of the particle system will be updated to this object's
-    #   position on initialization and every time +update+ is called.
+    #   position of the particle system will be updated to <code>(source.x
+    #   + source_offset_x, source.y + source_offset_y)</code> on initialization
+    #   and every time +update+ is called.
+    # - source_offset_x (Numeric): horizontal offset relative to the +source+
+    #   where the particle system will be positioned. Default: 0.
+    # - source_offset_y (Numeric): vertical offset relative to the +source+
+    #   where the particle system will be positioned. Default: 0.
     # - emission_interval (Integer|Range): interval in frames between each
     #   particle emission. It can be a fixed value or a range, in which case
     #   the interval will be a random value within that range (a new value
@@ -64,8 +69,8 @@ module MiniGL
       raise "Particles must have either a shape or an image!" if options[:shape].nil? && options[:img].nil?
 
       @options = DEFAULT_OPTIONS.merge(options)
-      @x = @options[:source]&.x || @options[:x] || 0
-      @y = @options[:source]&.y || @options[:y] || 0
+      @x = (@options[:source]&.x || @options[:x]) + @options[:source_offset_x]
+      @y = (@options[:source]&.y || @options[:y]) + @options[:source_offset_y]
 
       @particles = []
       @emitting = false
@@ -87,6 +92,12 @@ module MiniGL
       @emitting = false
     end
 
+    # Changes particle system origin to <code>(x, y)</code>.
+    def move_to(x, y)
+      @x = x
+      @y = y
+    end
+
     # Returns a boolean indicating whether this particle system is currently
     # emitting particles.
     def emitting?
@@ -108,8 +119,8 @@ module MiniGL
       return unless @emitting
 
       if @options[:source]
-        @x = @options[:source].x
-        @y = @options[:source].y
+        @x = @options[:source].x + @options[:source_offset_x]
+        @y = @options[:source].y + @options[:source_offset_y]
       end
 
       @timer += 1
@@ -148,6 +159,8 @@ module MiniGL
       x: 0,
       y: 0,
       source: nil,
+      source_offset_x: 0,
+      source_offset_y: 0,
       emission_interval: 10,
       emission_rate: 1,
       duration: 30,

data/test/particles_game.rb

@@ -3,21 +3,14 @@ require_relative '../lib/minigl'
 include MiniGL
 
 class MyGame < GameWindow
-  class Source
-    attr_accessor :x, :y
-
-    def initialize(x, y)
-      @x = x
-      @y = y
-    end
-  end
-
   def initialize
     super(800, 600, false)
-    @source = Source.new(100, 100)
+    @source = Sprite.new(100, 100, :btn)
     @particles_systems = [
       Particles.new(
         source: @source,
+        source_offset_x: 50,
+        source_offset_y: 120,
         img: Res.img(:square),
         duration: 30,
         spread: 50,
@@ -59,10 +52,15 @@ class MyGame < GameWindow
       end
     end
 
+    if KB.key_pressed?(Gosu::KB_Q)
+      @particles_systems[1].move_to(50, 500)
+    end
+
     @particles_systems.each(&:update)
   end
 
   def draw
+    @source.draw
     @particles_systems.each(&:draw)
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minigl
 version: !ruby/object:Gem::Version
-  version: 2.5.1
+  version: 2.5.2
 platform: ruby
 authors:
 - Victor David Santos