R3EXS 1.1.0 → 1.1.1

data/lib/R3EXS/RGSS3.rb

@@ -3,6 +3,26 @@
 # RPG Maker VX Ace Color 类
 class Color
 
+    # red 通道的值
+    #
+    # @return [Integer]
+    attr_reader :red
+
+    # green 通道的值
+    #
+    # @return [Integer]
+    attr_reader :green
+
+    # blue 通道的值
+    #
+    # @return [Integer]
+    attr_reader :blue
+
+    # alpha 通道的值
+    #
+    # @return [Integer]
+    attr_reader :alpha
+
     # 初始化时接受以下几种参数情况：
     # - 无参数时，默认 (0, 0, 0, 0)
     # - 3 个参数时，默认为 (red, green, blue, 255)
@@ -13,6 +33,7 @@ class Color
     #        - green: 绿色通道的值 (0-255)
     #        - blue: 蓝色通道的值 (0-255)
     #        - alpha: 可选，透明度通道的值 (0-255)，默认为 255
+    #
     # @return [Color]
     def initialize(*args)
         case args.length
@@ -37,6 +58,7 @@ class Color
     #        - green: 绿色通道的值 (0-255)
     #        - blue: 蓝色通道的值 (0-255)
     #        - alpha: 可选，透明度通道的值 (0-255)，默认为 255
+    #
     # @return [void]
     def set(*args)
         case args.length
@@ -68,6 +90,7 @@ class Color
     # 序列化 Color 对象
     #
     # @param level [Integer] 序列化的级别
+    #
     # @return [String]
     def _dump(level)
         [@red, @green, @blue, @alpha].pack('D4')
@@ -76,6 +99,7 @@ class Color
     # 反序列化 Color 对象
     #
     # @param obj [String] 序列化后的字符串
+    #
     # @return [Color]
     def Color._load(obj)
         new(*obj.unpack('D4'))
@@ -84,6 +108,7 @@ class Color
     # 设置 red 通道的值，限制在 0 到 255 之间
     #
     # @param value [Float] 新的 red 通道值
+    #
     # @return [void]
     def red=(value)
         @red = [[value, 0.0].max, 255.0].min.to_i
@@ -92,6 +117,7 @@ class Color
     # 设置 green 通道的值，限制在 0 到 255 之间
     #
     # @param value [Float] 新的 green 通道值
+    #
     # @return [void]
     def green=(value)
         @green = [[value, 0.0].max, 255.0].min.to_i
@@ -100,6 +126,7 @@ class Color
     # 设置 blue 通道的值，限制在 0 到 255 之间
     #
     # @param value [Float] 新的 blue 通道值
+    #
     # @return [void]
     def blue=(value)
         @blue = [[value, 0.0].max, 255.0].min.to_i
@@ -108,10 +135,15 @@ class Color
     # 设置 alpha 通道的值，限制在 0 到 255 之间
     #
     # @param value [Float] 新的 alpha 通道值
+    #
     # @return [void]
     def alpha=(value)
         @alpha = [[value, 0.0].max, 255.0].min
     end
+end
+
+# RPG Maker VX Ace Tone 类
+class Tone
 
     # red 通道的值
     #
@@ -128,14 +160,10 @@ class Color
     # @return [Integer]
     attr_reader :blue
 
-    # alpha 通道的值
+    # gray 通道的值
     #
     # @return [Integer]
-    attr_reader :alpha
-end
-
-# RPG Maker VX Ace Tone 类
-class Tone
+    attr_reader :gray
 
     # 初始化时接受以下几种参数情况：
     # - 无参数时，默认 (0, 0, 0, 0)
@@ -147,6 +175,7 @@ class Tone
     #        - green: 绿色通道的值 (-255-255)
     #        - blue: 蓝色通道的值 (-255-255)
     #        - gray: 可选，灰度通道的值 (0-255)，默认为 0
+    #
     # @return [Tone]
     def initialize(*args)
         case args.length
@@ -171,6 +200,7 @@ class Tone
     #        - green: 绿色通道的值 (-255-255)
     #        - blue: 蓝色通道的值 (-255-255)
     #        - gray: 可选，透明度通道的值 (0-255)，默认为 0
+    #
     # @return [void]
     def set(*args)
         case args.length
@@ -201,6 +231,7 @@ class Tone
     # 序列化 Tone 对象
     #
     # @param level [Integer] 序列化的级别
+    #
     # @return [String]
     def _dump(level)
         [@red, @green, @blue, @gray].pack('D4')
@@ -209,6 +240,7 @@ class Tone
     # 反序列化 Tone 对象
     #
     # @param obj [String] 序列化后的字符串
+    #
     # @return [Tone]
     def Tone._load(obj)
         new(*obj.unpack('D4'))
@@ -217,6 +249,7 @@ class Tone
     # 设置 red 通道的值，限制在 -255 到 255 之间
     #
     # @param value [Float] 新的 red 通道值
+    #
     # @return [void]
     def red=(value)
         @red = [[value, -255.0].max, 255.0].min.to_i
@@ -225,6 +258,7 @@ class Tone
     # 设置 green 通道的值，限制在 -255 到 255 之间
     #
     # @param value [Float] 新的 green 通道值
+    #
     # @return [void]
     def green=(value)
         @green = [[value, -255.0].max, 255.0].min.to_i
@@ -233,6 +267,7 @@ class Tone
     # 设置 blue 通道的值，限制在 -255 到 255 之间
     #
     # @param value [Float] 新的 blue 通道值
+    #
     # @return [void]
     def blue=(value)
         @blue = [[value, -255.0].max, 255.0].min.to_i
@@ -241,39 +276,44 @@ class Tone
     # 设置 alpha 通道的值，限制在 0 到 255 之间
     #
     # @param value [Float] 新的 alpha 通道值
+    #
     # @return [void]
     def gray=(value)
         @gray = [[value, 0.0].max, 255.0].min.to_i
     end
+end
 
-    # red 通道的值
+# RPG Maker VX Ace Table 类
+#
+# Table 是一个多维数组，每个元素都是带符号的两字节整数(int16_t), 也就是 -32,768~32,767 之间的整数
+#
+# Ruby Array 类在处理大量信息时效率很差，因此使用了此类。
+class Table
+
+    # 数据数组
     #
-    # @return [Integer]
-    attr_reader :red
+    # @return [Array<Integer>]
+    attr_accessor :data
 
-    # green 通道的值
+    # 维度
     #
     # @return [Integer]
-    attr_reader :green
+    attr_accessor :dim
 
-    # blue 通道的值
+    # 第一维的长度
     #
     # @return [Integer]
-    attr_reader :blue
+    attr_accessor :xsize
 
-    # gray 通道的值
+    # 第二维的长度
     #
     # @return [Integer]
-    attr_reader :gray
-
-end
+    attr_accessor :ysize
 
-# RPG Maker VX Ace Table 类
-#
-# Table 是一个多维数组，每个元素都是带符号的两字节整数(int16_t), 也就是 -32,768~32,767 之间的整数
-#
-# Ruby Array 类在处理大量信息时效率很差，因此使用了此类。
-class Table
+    # 第三维的长度
+    #
+    # @return [Integer]
+    attr_accessor :zsize
 
     # 初始化 Table 对象，指定多维数组各维的长度。生成的数组可以是 1~3 维，甚至是没有元素的数组。
     #
@@ -286,6 +326,7 @@ class Table
     # @param xsize [Integer] 第一维的长度（必需）
     # @param ysize [Integer, nil] 第二维的长度（可选，默认值为 nil)
     # @param zsize [Integer, nil] 第三维的长度（可选，默认值为 nil)
+    #
     # @return [Table]
     def initialize(xsize, ysize = nil, zsize = nil)
         init_attr(xsize, ysize, zsize)
@@ -296,6 +337,7 @@ class Table
     # @param xsize [Integer] 第一维的长度
     # @param ysize [Integer, nil] 第二维的长度（如果为 nil，则默认为 1）
     # @param zsize [Integer, nil] 第三维的长度（如果为 nil，则默认为 1）
+    #
     # @return [void]
     def init_attr(xsize, ysize, zsize)
         @dim   = 1 + (ysize.nil? ? 0 : 1) + (zsize.nil? ? 0 : 1)
@@ -310,6 +352,7 @@ class Table
     # @param x [Integer] 第一维的长度（必需）
     # @param y [Integer] 第二维的长度（可选，默认值为 0)
     # @param z [Integer] 第三维的长度（可选，默认值为 0)
+    #
     # @return [Integer]
     def [](x, y = 0, z = 0)
         @data[x + y * @xsize + z * @xsize * @ysize]
@@ -322,6 +365,7 @@ class Table
     #   - y: 第二维的长度（可选，默认值为 nil)
     #   - z: 第三维的长度（可选，默认值为 nil)
     #   - v: 新的元素值
+    #
     # @return [void]
     def []=(*args)
         v                                           = args.pop
@@ -336,6 +380,7 @@ class Table
     # @param xsize [Integer] 第一维的长度（必需）
     # @param ysize [Integer, nil] 第二维的长度（可选，默认值为 nil)
     # @param zsize [Integer, nil] 第三维的长度（可选，默认值为 nil)
+    #
     # @return [void]
     def resize(xsize, ysize = nil, zsize = nil)
         old_data                        = @data.dup
@@ -353,6 +398,7 @@ class Table
     # 序列化 Table 对象
     #
     # @param level [Integer] 序列化的级别
+    #
     # @return [String]
     def _dump(level)
         s = [@dim, @xsize, @ysize, @zsize, @xsize * @ysize * @zsize].pack('LLLLL')
@@ -365,6 +411,7 @@ class Table
     # 反序列化 Table 对象
     #
     # @param obj [String] 序列化后的字符串
+    #
     # @return [Table]
     def Table._load(obj)
         # 从序列化字符串中解包维度信息
@@ -375,31 +422,6 @@ class Table
         # 现在 @data 已经从序列化字符串中完整提取
         table
     end
-
-    # 数据数组
-    #
-    # @return [Array<Integer>]
-    attr_accessor :data
-
-    # 维度
-    #
-    # @return [Integer]
-    attr_accessor :dim
-
-    # 第一维的长度
-    #
-    # @return [Integer]
-    attr_accessor :xsize
-
-    # 第二维的长度
-    #
-    # @return [Integer]
-    attr_accessor :ysize
-
-    # 第三维的长度
-    #
-    # @return [Integer]
-    attr_accessor :zsize
 end
 
 # RPG Maker VX Ace 的RPG 模块
@@ -692,7 +714,7 @@ module RPG
             acc_a = @exp_params[2].to_f
             acc_b = @exp_params[3].to_f
             return (basis * ((lv - 1) ** (0.9 + acc_a / 250)) * lv * (lv + 1) /
-              (6 + lv ** 2 / 50 / acc_b) + (lv - 1) * extra).round.to_i
+                (6 + lv ** 2 / 50 / acc_b) + (lv - 1) * extra).round.to_i
         end
 
         attr_accessor :exp_params