osb 1.1.1 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ac326d1ca7ffd249550ff8762b4b8f1f3a56aad69dd567a5f4146938ae9ca70
-  data.tar.gz: e832ae17332a76d259c2813da3d5f602945bf9017f00080539042d7225caa029
+  metadata.gz: 980e34cc00ef3f8142dbc6822035f28264324006ec8ec89192e8505c1cb242cf
+  data.tar.gz: 2aa3495b686ae9b93ec8fce0fd8e240d3d363abafb83c8f080c0de4895cae4d2
 SHA512:
-  metadata.gz: 1620c4004ef265061b2060969b115d02c28d848dd9f99cf1f3ef9045d3a5ce809025266a1637dbf19c72201d9c56dd10f618af81a8fede0cfe7caf8fca53962f
-  data.tar.gz: af61c900d6ced4c4f19007a1b569e96fcd089f64e9f2f2a8503095746ad195c5334a0abd847ef98d8bc75558afb16f7bb874f9ad063b1213370d40ddc2962d7c
+  metadata.gz: 8bcb0418f74689d8c49fce3471ed59cda8900a90875e5f3c3b499d086623aaf24921c48bdffd900045b1fc603c69834ebea1c56a623e487f1e5508ef2a8793ed
+  data.tar.gz: a85a9feea55408ea18498e1355c317e9d7ddd6376cded2946153958151280699953dd2aed4fc6c7351466576fe011b045c05e81ff09c68ed30bff536738f6121

data/.yardopts

@@ -1,3 +1,2 @@
 --no-private
--
-README.md
+--markup=markdown

data/lib/osb/assert.rb

@@ -31,7 +31,6 @@ module Osb
     end
 
     # @private
-    # @type [Hash{Class => Hash{Class => Object}}]
     T = {
       Array => {
         Numeric => TypedArray.new(Numeric),

data/lib/osb/background.rb

@@ -6,7 +6,7 @@ module Osb
     # @private
     attr_reader :command
 
-    # @param [String] file_name location of the background image relative to the beatmap directory.
+    # @param [String] file_path location of the background image relative to the beatmap directory.
     def initialize(file_path:)
       Internal.assert_type!(file_path, String, "file_path")
       Internal.assert_file_name_ext!(file_path, %w[png jpg jpeg])

data/lib/osb/color.rb

@@ -3,16 +3,17 @@
 module Osb
   # Represents an RGB color.
   class Color
-    attr_accessor :r, :g, :b
-    # @attribute [rw] r
-    #   @return Red value.
-    # @attribute [rw] g
-    #   @return Green value.
-    # @attribute [rw] b
-    #   @return Blue value.
-
-    # @param [Integer, String, Array<Integer>] r red value, a hex +String+, 
-    #   or an +Array+ of 3 +{Integer}+s.
+    # @return [Integer] Red value.
+    attr_accessor :r
+     
+    # @return [Integer] Green value.
+    attr_accessor :g
+ 
+    # @return [Integer] Blue value.
+    attr_accessor :b
+
+    # @param [Integer, String, Array<Integer>] r red value, a hex String, 
+    #   or an Array of 3 {Integer}s.
     # @param [Integer] g green value
     # @param [Integer] b blue value
     def initialize(r, g = nil, b = nil)
@@ -47,6 +48,7 @@ module Osb
 
     # Returns whether 2 colors are not equal.
     # @param [Color] color
+    # @return [Boolean]
     def !=(color)
       Internal.assert_type!(color, Color, "color")
 
@@ -54,9 +56,9 @@ module Osb
     end
 
     # Converts an HSL color value to RGB.
-    # @param [Integer] hue
-    # @param [Integer] saturation
-    # @param [Integer] lightness
+    # @param [Integer] h hue
+    # @param [Integer] s saturation
+    # @param [Integer] l lightness
     # @return [Color]
     def self.from_hsl(h, s, l)
       Internal.assert_type!(h, Integer, "h")
@@ -100,7 +102,7 @@ module Osb
       return p
     end
 
-    # Create a +{Color}+ object from hex string.
+    # Create a {Osb::Color} object from hex string.
     # @param [String] hex
     # @return [Color]
     def self.from_hex(hex)
@@ -112,9 +114,9 @@ module Osb
     end
   end
 
-  # Create a new rgb +{Color}+.
-  # @param [Integer, String, Array<Integer>] r red value, a hex +String+, 
-  #   or an +Array+ of 3 +{Integer}+s.
+  # Create a new rgb {Osb::Color}.
+  # @param [Integer, String, Array<Integer>] r red value, a hex String, 
+  #   or an Array of 3 {Integer}s.
   # @param [Integer] g green value
   # @param [Integer] b blue value
   # @return [Color]
@@ -122,10 +124,10 @@ module Osb
     Color.new(r, g, b)
   end
 
-  # Create a new hsl +{Color}+.
-  # @param [Integer] hue
-  # @param [Integer] saturation
-  # @param [Integer] lightness
+  # Create a new hsl {Osb::Color}.
+  # @param [Integer] h hue
+  # @param [Integer] s saturation
+  # @param [Integer] l lightness
   # @return [Color]
   def hsl(h, s, l)
     Color.from_hsl(h, s, l)

data/lib/osb/commandable.rb

@@ -63,7 +63,7 @@ module Osb
 
       end_time = "" if start_time == end_time
       tabs = " " * self.tab_level
-      command = "#{tabs}F,#{start_time},#{end_time},#{start_opacity}"
+      command = "#{tabs}F,#{easing},#{start_time},#{end_time},#{start_opacity}"
       command += ",#{end_opacity}" if end_opacity != start_opacity
       @commands << command
     end
@@ -103,7 +103,7 @@ module Osb
       end_time = "" if start_time == end_time
       tabs = " " * self.tab_level
       command =
-        "#{tabs}M,#{start_time},#{end_time},#{start_position.x},#{start_position.y}"
+        "#{tabs}M,#{easing},#{start_time},#{end_time},#{start_position.x},#{start_position.y}"
       if end_position != start_position
         command += ",#{end_position.x},#{end_position.y}"
       end
@@ -133,7 +133,7 @@ module Osb
 
       end_time = "" if start_time == end_time
       tabs = " " * self.tab_level
-      command = "#{tabs}MX,#{start_time},#{end_time},#{start_x}"
+      command = "#{tabs}MX,#{easing},#{start_time},#{end_time},#{start_x}"
       command += ",#{end_x}" if end_x
       @commands << command
     end
@@ -161,7 +161,7 @@ module Osb
 
       end_time = "" if start_time == end_time
       tabs = " " * self.tab_level
-      command = "#{tabs}MY,#{start_time},#{end_time},#{start_y}"
+      command = "#{tabs}MY,#{easing},#{start_time},#{end_time},#{start_y}"
       command += ",#{end_y}" if end_y != start_y
       @commands << command
     end
@@ -205,7 +205,7 @@ module Osb
           raise InvalidValueError,
                 "start_scale and end_scale must be either both Numeric values or Vector2-like values."
         end
-        command = "#{tabs}S,#{start_time},#{end_time},#{start_scale}"
+        command = "#{tabs}S,#{easing},#{start_time},#{end_time},#{start_scale}"
         command += ",#{end_scale}" if end_scale != start_scale
         @commands << command
       else
@@ -218,7 +218,7 @@ module Osb
         end_scale = Osb::Vector2.new(end_scale) if end_scale.is_a?(Array)
 
         command =
-          "#{tabs}V,#{start_time},#{end_time},#{start_scale.x},#{start_scale.y}"
+          "#{tabs}V,#{easing},#{start_time},#{end_time},#{start_scale.x},#{start_scale.y}"
         command += ",#{end_scale.x},#{end_scale.y}" if end_scale
         @commands << command
       end
@@ -247,7 +247,7 @@ module Osb
 
       end_time = "" if start_time == end_time
       tabs = " " * self.tab_level
-      command = "#{tabs}R,#{start_time},#{end_time},#{start_angle}"
+      command = "#{tabs}R,#{easing},#{start_time},#{end_time},#{start_angle}"
       command += ",#{end_angle}" if end_angle != start_angle
       @commands << command
     end
@@ -287,7 +287,7 @@ module Osb
       end_time = "" if start_time == end_time
       tabs = " " * self.tab_level
       command =
-        "#{tabs}C,#{start_time},#{end_time},#{start_color.r},#{start_color.g},#{start_color.b}"
+        "#{tabs}C,#{easing},#{start_time},#{end_time},#{start_color.r},#{start_color.g},#{start_color.b}"
       if end_color != start_color
         command += ",#{end_color.r},#{end_color.g},#{end_color.b}"
       end

data/lib/osb/dsl/object.rb

@@ -105,7 +105,7 @@ module Osb
   end
 
   # Set the background image for the beatmap.
-  # @param [String] file_name location of the background image relative to the beatmap directory.
+  # @param [String] file_path location of the background image relative to the beatmap directory.
   # @return [void]
   def background(file_path:)
     self.raise_unless_inside_storyboard!
@@ -114,7 +114,7 @@ module Osb
   end
 
   # Set the video for the beatmap.
-  # @param [String] file_name location of the video file relative to the beatmap directory.
+  # @param [String] file_path location of the video file relative to the beatmap directory.
   # @param [Integer] start_time when the video starts.
   # @return [void]
   def video(file_path:, start_time:)

data/lib/osb/enums/easing.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Osb
+  # Easing enums.
   module Easing
     Linear = 0
     Out = 1
@@ -37,6 +38,7 @@ module Osb
     InBounce = 32
     OutBounce = 33
     InOutBounce = 34
+    # @private
     ALL = 0..34
   end
 end

data/lib/osb/enums/layer.rb

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
 module Osb
+  # Storyboard layer enums.
   module Layer
     Background = "Background"
     Fail = "Fail"
     Pass = "Pass"
     Foreground = "Foreground"
     Overlay = "Overlay"
+    # @private
     ALL = %w[Background Fail Pass Foreground Overlay]
   end
 end

data/lib/osb/enums/origin.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module Osb
+  # Storyboard object origin enums.
   module Origin
     TopLeft = "TopLeft"
     TopCentre = "TopCentre"
@@ -16,6 +17,7 @@ module Osb
     BottomCentre = "BottomCentre"
     BottomCenter = "BottomCentre"
     BottomRight = "BottomRight"
+    # @private
     ALL = %w[
       TopLeft
       TopCentre

data/lib/osb/integer.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+# A number of methods have been added to the Ruby Integer class to do units conversions.
 class Integer
   # Does nothing. Just a way to tell people it's represented in milliseconds.
   # @return [Integer]

data/lib/osb/storyboard.rb

@@ -67,9 +67,10 @@ module Osb
 
   # When designing storyboard, we often want to group storyboard elements
   # that are used in a similar context (eg. a scene), so this class' purpose
-  # is only to act as a container. You can add the elements directly to the
-  # +Osb::Storyboard+ object, but we recommend you to split the project into multiple
-  # +Osb::Group+ so it will be easier to manage.
+  # is only to act as a container. You can add every element directly to the
+  # {Osb::Storyboard} object, but we recommend you to split the project into
+  # multiple {Osb::Group} so it will be easier to manage. A {Osb::Group} can
+  # have multiple nested {Osb::Group}s in itself.
   class Group
     # @private
     attr_reader :layers
@@ -78,7 +79,7 @@ module Osb
       @layers = Internal::LayerManager.new
     end
 
-    # Add an +Osb::Sprite+, +Osb::Animation+, +Osb::Sample+ or +Osb::Group+ to
+    # Add an {Osb::Sprite}, {Osb::Animation}, {Osb::Sample} or {Group} to
     # this group.
     # @param [Osb::Group, Osb::Sprite, Osb::Animation, Osb::Sample] object
     # @return [self]
@@ -106,8 +107,9 @@ module Osb
       return self
     end
 
-    # Add an +Osb::Sprite+, +Osb::Animation+, +Osb::Sample+ or +Osb::Group+ to
-    # this group. Alias for +#add+.
+    # Alias for {#add}.
+    # Add a {Osb::Sprite}, {Osb::Animation}, {Osb::Sample} or {Group} to
+    # this group.
     # @param [Osb::Group, Osb::Sprite, Osb::Animation, Osb::Sample] object
     # @return [self]
     def <<(object)
@@ -116,8 +118,8 @@ module Osb
   end
 
   # Represent an osu! storyboard. Each sprite or animation can be added directly
-  # to the storyboard instance, or through an intermediate group. A group can
-  # have multiple nested groups in itself.
+  # to the storyboard instance, or through an intermediate group. A {Osb::Group}
+  # can have multiple nested {Osb::Group}s in itself.
   class Storyboard
     # @private
     attr_reader :layers
@@ -126,8 +128,8 @@ module Osb
       @layers = Internal::LayerManager.new
     end
 
-    # Add an +Osb::Sprite+, +Osb::Animation+, +Osb::Sample+, +Osb::Video+,
-    # +Osb::Background+ or +Osb::Group+ to this storyboard.
+    # Add a {Osb::Sprite}, {Osb::Animation}, {Osb::Sample}, {Osb::Video},
+    # {Osb::Background} or {Osb::Group} to this storyboard.
     # @param [Osb::Group, Osb::Sprite, Osb::Animation, Osb::Sample, Osb::Video,
     #         Osb::Background] object
     # @return [self]
@@ -155,8 +157,9 @@ module Osb
       return self
     end
 
-    # Add an +Osb::Sprite+, +Osb::Animation+, +Osb::Sample+, +Osb::Video+,
-    # +Osb::Background+ or +Osb::Group+ to this storyboard. Alias for +#add+.
+    # Alias for {#add}.
+    # Add a {Osb::Sprite}, {Osb::Animation}, {Osb::Sample}, {Osb::Video},
+    # {Osb::Background} or {Osb::Group} to this storyboard.
     # @param [Osb::Group, Osb::Sprite, Osb::Animation, Osb::Sample, Osb::Video,
     #         Osb::Background] object
     # @return [self]

data/lib/osb/vector2.rb

@@ -3,15 +3,14 @@
 module Osb
   # Represents a 2d point or vector.
   class Vector2
-    attr_accessor :x, :y
-    # @!attribute [rw] x
-    #   @return x coordinate of this vector
-    # @!attribute [rw] y
-    #   @return y coordinate of this vector
+    # @return [Numeric] x coordinate of this vector
+    attr_accessor :x
+    # @return [Numeric] y coordinate of this vector
+    attr_accessor :y
 
     # @param [Numeric, Array<Numeric>] x
-    #   x coordinate of this +{Vector2}+, or an +Array+ of 2 numbers.
-    # @param [Numeric] y y coordinate of this +{Vector2}+
+    #   x coordinate of this vector, or an +Array+ of 2 {Numeric} values.
+    # @param [Numeric] y y coordinate of this vector
     def initialize(x = 0, y = 0)
       Internal.assert_type!(x, [Numeric, Internal::T[Array][Numeric]], "x")
       Internal.assert_type!(y, Numeric, "y")
@@ -28,7 +27,7 @@ module Osb
       end
     end
 
-    # Add another +{Vector2}+ to this one.
+    # Add another 2d vector to this one.
     # @param [Vector2] vector
     # @return [Vector2]
     def +(vector)
@@ -36,7 +35,7 @@ module Osb
       Vector2.new(self.x + vector.x, self.y + vector.y)
     end
 
-    # Subtract another +{Vector2}+ from this one.
+    # Subtract another 2d vector from this one.
     # @param [Vector2] vector
     # @return [Vector2]
     def -(vector)
@@ -44,7 +43,7 @@ module Osb
       Vector2.new(self.x - vector.x, self.y - vector.y)
     end
 
-    # Returns whether two +{Vector2}+ are equal within tolerance
+    # Returns whether two 2d vector are equal within tolerance
     # @param [Vector2] vector
     # @return [Boolean]
     def ==(vector)
@@ -52,14 +51,14 @@ module Osb
       Math.fuzzy_equal(self.x, vector.x) && Math.fuzzy_equal(self.y, vector.y)
     end
 
-    # Returns whether two +{Vector2}+ are not equal within tolerance
+    # Returns whether two 2d vector are not equal within tolerance
     # @param [Vector2] vector
     # @return [Boolean]
     def !=(vector)
       !(self == vector)
     end
 
-    # Makes a copy of this +{Vector2}+.
+    # Makes a copy of this 2d vector.
     # @return [Vector2]
     def clone
       Vector2.new(self.x, self.y)
@@ -71,23 +70,24 @@ module Osb
       [self.x, self.y]
     end
 
-    # Returns a string representation of this +{Vector2}+.
+    # Returns a string representation of this 2d vector.
     # @return [String]
     def to_s
       self.to_a.to_s
     end
 
-    # Returns the length of this +{Vector2}+.
+    # Returns the length of this 2d vector.
     # @return [Float]
     def length
       Math.sqrt(self.x**2 + self.y**2)
     end
   end
 
-  # Create a +{Vector2}+.
+  # Create a 2d vector.
   # @param [Numeric, Array<Numeric>] x
-  #   x coordinate of this +{Vector2}+, or an +Array+ of 2 numbers.
-  # @param [Numeric] y y coordinate of this +{Vector2}+
+  #   x coordinate of this 2d vector, or an +Array+ of 2 numbers.
+  # @param [Numeric] y y coordinate of this 2d vector
+  # @return [Vector2]
   def vec2(x = 0, y = 0)
     Vector2.new(x, y)
   end

data/lib/osb.rb

@@ -20,7 +20,7 @@ require_relative "osb/dsl/object"
 require_relative "osb/dsl/commands"
 
 module Osb
-  VERSION = "1.1.0"
+  VERSION = "1.1.3"
 end
 
 # Extend the main object with the DSL commands.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: osb
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.1.3
 platform: ruby
 authors:
 - Dinh Vu
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-08-23 00:00:00.000000000 Z
+date: 2023-08-24 00:00:00.000000000 Z
 dependencies: []
 description: A simple framework for building osu! storyboard.
 email: dinhvu2509@gmail.com
@@ -17,7 +17,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".yardopts"
-- README.md
 - lib/osb.rb
 - lib/osb/animation.rb
 - lib/osb/assert.rb
@@ -56,7 +55,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.18
+rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
 summary: osu! storyboard framework

data/README.md

@@ -1,64 +0,0 @@
-# osb
-A simple osu! storyboard framework written in Ruby.
-
-## Installation
-
-Install with Gem:
-```sh
-gem install osb
-```
-
-## Usage
-
-Create a storyboard container:
-```rb
-require "osb"
-include Osb
-sb = Storyboard.new
-```
-
-Create a static image:
-```rb
-sp = Sprite.new(file_path: "test.png")
-```
-
-Describe what it does:
-```rb
-sp.fade(start_time: 1000, start_opacity: 1)
-sp.move(start_time: 2000, start_position: [320, 640], end_position: [100, 100])
-sp.scale(start_time: 100, end_time: 200, start_scale: 1, end_scale: 2)
-```
-
-Add it to the container:
-```rb
-sb << sp
-```
-
-Generate your storyboard file:
-```rb
-sb.generate("path/to/your_storyboard_file.osb")
-```
-
-osb also supports DSL syntax.
-
-```rb
-storyboard do
-  out_path "path/to/your_storyboard_file.osb"
-
-  sprite file_path: "test.png" do
-    fade start_time: 1000, start_opacity: 1
-    
-    move start_time: 2000, start_position: [320, 640], end_position: [100, 100]
-  end
-end
-```
-
-Full documentation is available at https://rubydoc.info/gems/osb/index.
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/nanachi-code/osb-ruby.
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).