or2d 0.0.5 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d549bc286d1ed32b29b3c09acb3490e373568eb8505895f6453287289a204261
-  data.tar.gz: 0a031f2fe7d9f0316388952ddff86c0adc4dfaf06d00368432e6c30b73a46468
+  metadata.gz: 34dc847de407fba8685ce26d135520bfe7ba6fb7facabbc8ec913b7691b98caf
+  data.tar.gz: 667e1ae51f19f4358082209b1be4a434179d1809039540131874ad4e7c8a948f
 SHA512:
-  metadata.gz: bb2eac9fbac591a5398821fda5dee6e94fb45f25cb8624999d2c0fe67feadee62efee3b1e02051655fc7d3a1c5ecdbf7ffd8a431ffbb38323bae81bc093ed1ce
-  data.tar.gz: 3a6166a5d9ccbb2359bb3026efced1e30696c40506354a0725db510057b76f32efcb0733c96b6935c29aae4b28083b776b3b1c6c509c643c4ca7baffec70b16c
+  metadata.gz: 68904d571e1c17af6718ccba754785a130a3ad076d5ab819720ddbcbd6d09c8adedb6aa0010536cd7f02632573fa474ea0e6d26d6febcf2815cb4b0a1177ad72
+  data.tar.gz: '0571586e018ae8ab28d1944bec7cdcab8c8a5f2b4c424499639afcc1b1b87c60142142bd2900c5ef249edddc173856ac2714ee1ecf6ec7edd3803912109dbd21'

data/lib/or2d/camera.rb

@@ -0,0 +1,87 @@
+module OR2D
+  class Camera
+
+    # The target of the camera.
+    # @return [OR2D::Entity] the target of the camera
+    attr_reader :target
+
+    # The viewport of the camera.
+    # @return [OR2D::Entity] the viewport of the camera
+    attr_reader :viewport
+
+    # Constructs a new Camera object.
+    # @param viewport_width [Integer] the width of the viewport
+    # @param viewport_height [Integer] the height of the viewport
+    # @param target [OR2D::Entity] the target of the camera
+    def initialize(viewport_width = OR2D.game.screen_width,
+                   viewport_height = OR2D.game.screen_height,
+                   target = OR2D::Entity.new(:square, { size: 1, x: 0, y: 0, show: false }),
+                   speed = 1)
+      @target = target
+      @speed = speed
+      @viewport = OR2D::Entity.new(:rectangle, {
+        x: (OR2D.game.screen_width / 2) - viewport_width,
+        y: (OR2D.game.screen_height / 2) + viewport_height,
+        width: viewport_width,
+        height: viewport_height,
+        show: false
+      })
+    end
+
+    def update; end
+
+    def scroll(direction, amount, target: false)
+      case direction
+      when :north then scroll_north(amount, target)
+      when :south then scroll_south(amount, target)
+      when :east then scroll_east(amount, target)
+      when :west then scroll_west(amount, target)
+      else raise ArgumentError, "Invalid direction: #{direction}"
+      end
+    end
+
+    # Simulates a northern camera scroll by moving all of the visible entities on the screen to the south.
+    # @param delta_y [Integer] the amount to scroll each entity
+    # @param target [Boolean] whether or not to scroll the target
+    def scroll_north(delta_y, target)
+      OR2D.game.entities.each_value do |entity|
+        next if !target && entity == @target
+
+        entity.screen_y += delta_y
+      end
+    end
+
+    # Simulates a southern camera scroll by moving all of the visible entities on the screen to the north.
+    # @param delta_y [Integer] the amount to scroll each entity
+    # @param target [Boolean] whether or not to scroll the target
+    def scroll_south(delta_y, target)
+      OR2D.game.entities.each_value do |entity|
+        next if !target && entity == @target
+
+        entity.screen_y -= delta_y
+      end
+    end
+
+    # Simulates an eastern camera scroll by moving all of the visible entities on the screen to the west.
+    # @param delta_x [Integer] the amount to scroll each entity
+    # @param target [Boolean] whether or not to scroll the target
+    def scroll_east(delta_x, target)
+      OR2D.game.entities.each_value do |entity|
+        next if !target && entity == @target
+
+        entity.screen_x -= delta_x
+      end
+    end
+
+    # Simulates a western camera scroll by moving all of the visible entities on the screen to the east.
+    # @param delta_x [Integer] the amount to scroll each entity
+    # @param target [Boolean] whether or not to scroll the target
+    def scroll_west(delta_x, target)
+      OR2D.game.entities.each_value do |entity|
+        next if !target && entity == @target
+
+        entity.screen_x += delta_x
+      end
+    end
+  end
+end

data/lib/or2d/cameras/centered.rb

@@ -0,0 +1,39 @@
+module OR2D::Cameras
+  class CenteredCamera < OR2D::Camera
+    def initialize(target = nil)
+      super(OR2D.game.screen_width, OR2D.game.screen_height, target, 1.scale)
+      orientate
+      @scrolling = false
+      @direction = nil
+    end
+
+    def update
+      orientate
+      return unless @scrolling
+
+      case @direction
+      when :north then scroll_north(@speed, false)
+      when :south then scroll_south(@speed, false)
+      when :east then scroll_east(@speed, false)
+      when :west then scroll_west(@speed, false)
+      end
+
+      reset_scrolling
+    end
+
+    def scroll(direction, amount)
+      @scrolling = true
+      @direction = direction
+      @speed = amount
+    end
+
+    def orientate
+      @target.screen_x = OR2D.game.screen_width / 2
+      @target.screen_y = OR2D.game.screen_height / 2
+    end
+
+    def reset_scrolling
+      @scrolling = false
+    end
+  end
+end

data/lib/or2d/cameras/padded.rb

@@ -0,0 +1,65 @@
+module OR2D::Cameras
+  # A PaddedCamera is a camera that has padding. When the target <OR2D::Entity> reaches the edge of the padding, the camera will scroll.
+  class PaddedCamera < OR2D::Camera
+    # Constructs a new PaddedCamera.
+    # @param target [OR2D::Entity] the target of the camera
+    # @param padding_width [Integer] the width of the padding
+    # @param padding_height [Integer] the height of the padding
+    def initialize(padding_width = 512, padding_height = 512, target = nil)
+      @padding_width = padding_width
+      @padding_height = padding_height
+      super(@padding_width, @padding_height, target, 1.scale)
+      orientate
+    end
+
+    # Updates the camera.
+    def update
+      scroll if should_scroll?
+    end
+
+    # Checks if the camera should scroll. This check is done by checking if the target <OR2D::Entity> is within the <OR2D::Cameras::PaddedCamera#boundary>.
+    # @return [Boolean] true if the camera should scroll, false otherwise
+    def should_scroll?
+      should_scroll_east? || should_scroll_west? || should_scroll_north? || should_scroll_south?
+    end
+
+    def should_scroll_east?
+      @target.screen_x >= (@viewport.screen_x + @viewport.width)
+    end
+
+    def should_scroll_west?
+      @target.screen_x <= (@viewport.screen_x - @viewport.width)
+    end
+
+    def should_scroll_north?
+      @target.screen_y <= (@viewport.screen_y - @viewport.height)
+    end
+
+    def should_scroll_south?
+      @target.screen_y >= (@viewport.screen_y + @viewport.height)
+    end
+
+    def scroll
+      if should_scroll_east?
+        super(:east, @speed, target: true)
+        @viewport.screen_x += @speed
+      elsif should_scroll_west?
+        super(:west, @speed, target: true)
+        @viewport.screen_x -= @speed
+      end
+
+      if should_scroll_north?
+        super(:north, @speed, target: true)
+        @viewport.screen_y -= @speed
+      elsif should_scroll_south?
+        super(:south, @speed, target: true)
+        @viewport.screen_y += @speed
+      end
+    end
+
+    def orientate
+      @target.screen_x = @viewport.screen_x + @viewport.width / 2
+      @target.screen_y = @viewport.screen_y + @viewport.height / 2
+    end
+  end
+end

data/lib/or2d/entity.rb

@@ -14,6 +14,14 @@ module OR2D
     # @return [Ruby2D::Image, Ruby2D::Sprite, Ruby2D::Text, Ruby2D::Triangle, Ruby2D::Quad, Ruby2D::Circle, Ruby2D::Square, Ruby2D::Line, Ruby2D::Rectangle] the entity's resource
     attr_reader :resource
 
+    # @!attribute [r] previous_x
+    # @return [Integer] the entity's previous x coordinate
+    attr_reader :previous_screen_x
+
+    # @!attribute [r] previous_y
+    # @return [Integer] the entity's previous y coordinate
+    attr_reader :previous_screen_y
+
     # Constructs a new Entity object.
     # @param type [Symbol] the type of entity to create
     # @param options [Hash] the options to create the entity with
@@ -28,6 +36,8 @@ module OR2D
       @resource = options[:resource] || OR2D::Resource.create(type, options)
       @width = @resource.width if @resource.respond_to?(:width)
       @height = @resource.height if @resource.respond_to?(:height)
+      @previous_screen_x = options[:x] || 0
+      @previous_screen_y = options[:y] || 0
       show if options[:show]
     ensure
       OR2D.game.add_entity(self)
@@ -36,6 +46,7 @@ module OR2D
     # Set the Entity x coordinate.
     # @param x_coordinate [Integer] the x coordinate of the Entity on the screen
     def x=(x_coordinate)
+      @previous_screen_x = @x
       super(x_coordinate)
       @resource.x = x_coordinate if @resource.respond_to?(:x=)
     end
@@ -43,6 +54,7 @@ module OR2D
     # Set the Entity y coordinate.
     # @param y_coordinate [Integer] the y coordinate of the Entity on the screen
     def y=(y_coordinate)
+      @previous_screen_x = @y
       super(y_coordinate)
       @resource.y = y_coordinate if @resource.respond_to?(:y=)
     end
@@ -78,5 +90,12 @@ module OR2D
       OR2D.game.window.remove(@resource) if @resource
       OR2D.game.remove_entity(@id)
     end
+
+    alias screen_x x
+    alias screen_y y
+    alias screen_z z
+    alias screen_x= x=
+    alias screen_y= y=
+    alias screen_z= z=
   end
 end

data/lib/or2d/instance.rb

@@ -88,6 +88,18 @@ module OR2D
       @window.close
     end
 
+    # The width of the game window.
+    # @return [Integer] the width of the game window
+    def screen_width
+      @window.get(:width)
+    end
+
+    # The height of the game window.
+    # @return [Integer] the height of the game window
+    def screen_height
+      @window.get(:height)
+    end
+
     private
 
     def setup

data/lib/or2d.rb

@@ -19,30 +19,37 @@ Dir["#{File.dirname(__FILE__)}/or2d/patches/*.rb"].each { |file| load(file) }
 # @author Patrick W.
 # @since 2023-04-26
 module OR2D
-  autoload :Animation,              'or2d/animation'
-  autoload :Composite,              'or2d/composite'
-  autoload :Console,                'or2d/console'
-  autoload :Entity,                 'or2d/entity'
-  autoload :Instance,               'or2d/instance'
-  autoload :Resource,               'or2d/resource'
-  autoload :Scene,                  'or2d/scene'
+  autoload :Animation, 'or2d/animation'
+  autoload :Composite, 'or2d/composite'
+  autoload :Console, 'or2d/console'
+  autoload :Camera, 'or2d/camera'
+  autoload :Entity, 'or2d/entity'
+  autoload :Instance, 'or2d/instance'
+  autoload :Resource, 'or2d/resource'
+  autoload :Scene, 'or2d/scene'
 
   # The Animations module contains modules and classes for animating objects.
   module Animations
-    autoload :CompositeAnimations,  'or2d/animations/composite_animations'
-    autoload :EntityAnimations,     'or2d/animations/entity_animations'
+    autoload :CompositeAnimations, 'or2d/animations/composite_animations'
+    autoload :EntityAnimations, 'or2d/animations/entity_animations'
+  end
+
+  # The Cameras module contains all of the camera implementations for the OR2D gem.
+  module Cameras
+    autoload :CenteredCamera, 'or2d/cameras/centered'
+    autoload :PaddedCamera, 'or2d/cameras/padded'
   end
 
   # The Composites module contains all of the composite entities for the OR2D gem.
   module Composites
-    autoload :Projectile,           'or2d/composites/projectile'
-    autoload :Sprite,               'or2d/composites/sprite'
-    autoload :Text,                 'or2d/composites/text'
+    autoload :Projectile, 'or2d/composites/projectile'
+    autoload :Sprite, 'or2d/composites/sprite'
+    autoload :Text, 'or2d/composites/text'
   end
 
   # The Scenes module contains all of the scenes for the OR2D gem.
   module Scenes
-    autoload :PlaceholderScene,     'or2d/scenes/placeholder_scene'
+    autoload :PlaceholderScene, 'or2d/scenes/placeholder_scene'
   end
 
   # Is debug mode enabled?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: or2d
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.7
 platform: ruby
 authors:
 - Patrick W.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-10-10 00:00:00.000000000 Z
+date: 2024-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dotenv
@@ -138,6 +138,9 @@ files:
 - lib/or2d/animation.rb
 - lib/or2d/animations/composite_animations.rb
 - lib/or2d/animations/entity_animations.rb
+- lib/or2d/camera.rb
+- lib/or2d/cameras/centered.rb
+- lib/or2d/cameras/padded.rb
 - lib/or2d/composite.rb
 - lib/or2d/composites/projectile.rb
 - lib/or2d/composites/sprite.rb
@@ -174,7 +177,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: Opinionated Ruby2D