Class: Tone

Inherits:
Object
  • Object
show all
Defined in:
lib/R3EXS/RGSS3.rb

Overview

RPG Maker VX Ace Tone 类

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(*args) ⇒ Tone

初始化时接受以下几种参数情况：

  • 无参数时，默认 (0, 0, 0, 0)
  • 3 个参数时，默认为 (red, green, blue, 0)
  • 4 个参数时，指定 (red, green, blue, gray)

Parameters:

  • args (Array<Integer>) —

    red, green, blue, gray

    • red: 红色通道的值 (-255-255)
    • green: 绿色通道的值 (-255-255)
    • blue: 蓝色通道的值 (-255-255)
    • gray: 可选，灰度通道的值 (0-255)，默认为 0


180
181
182
183
184
185
186
187
188
189
190
191
 
# File 'lib/R3EXS/RGSS3.rb', line 180

def initialize(*args)
    case args.length
    when 0 # 无参数
        set(0, 0, 0, 0)
    when 3 # 3 个参数, gray 默认为 0
        set(*args)
    when 4 # 4 个参数, 分别为 red, green, blue, gray
        set(*args)
    else
        raise ArgumentError, "Invalid arguments for initialize method"
    end
end

Instance Attribute Details

#blue ⇒ Integer

blue 通道的值

Returns:

  • (Integer) 


161
162
163
 
# File 'lib/R3EXS/RGSS3.rb', line 161

def blue
  @blue
end

#gray ⇒ Integer

gray 通道的值

Returns:

  • (Integer) 


166
167
168
 
# File 'lib/R3EXS/RGSS3.rb', line 166

def gray
  @gray
end

#green ⇒ Integer

green 通道的值

Returns:

  • (Integer) 


156
157
158
 
# File 'lib/R3EXS/RGSS3.rb', line 156

def green
  @green
end

#red ⇒ Integer

red 通道的值

Returns:

  • (Integer) 


151
152
153
 
# File 'lib/R3EXS/RGSS3.rb', line 151

def red
  @red
end

Class Method Details

._load(obj) ⇒ Tone

反序列化 Tone 对象

Parameters:

  • obj (String) —

    序列化后的字符串

Returns:



245
246
247
 
# File 'lib/R3EXS/RGSS3.rb', line 245

def Tone._load(obj)
    new(*obj.unpack('D4'))
end

Instance Method Details

#_dump(level) ⇒ String

序列化 Tone 对象

Parameters:

  • level (Integer) —

    序列化的级别

Returns:

  • (String) 


236
237
238
 
# File 'lib/R3EXS/RGSS3.rb', line 236

def _dump(level)
    [@red, @green, @blue, @gray].pack('D4')
end

#set(*args) ⇒ void

This method returns an undefined value.

设置 Tone 对象的值

  • 无参数时，默认 (0, 0, 0, 0)
  • 3 个参数时，默认为 (red, green, blue, 0)
  • 4 个参数时，指定 (red, green, blue, gray)

Parameters:

  • args (Array<Integer>) —

    red, green, blue, gray

    • red: 红色通道的值 (-255-255)
    • green: 绿色通道的值 (-255-255)
    • blue: 蓝色通道的值 (-255-255)
    • gray: 可选，透明度通道的值 (0-255)，默认为 0


205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
 
# File 'lib/R3EXS/RGSS3.rb', line 205

def set(*args)
    case args.length
    when 1 # 一个参数, 为 Tone 对象
        if args[0].is_a?(Tone)
            self.red   = args[0].red
            self.green = args[0].green
            self.blue  = args[0].blue
            self.gray  = args[0].gray
        else
            raise ArgumentError, "Invalid arguments for set method"
        end
    when 3 # 三个参数, 分别为 red, green, blue (gray 默认为 0)
        self.red   = args[0]
        self.green = args[1]
        self.blue  = args[2]
        self.gray  = 0.0
    when 4 # 四个参数, 分别为 red, green, blue, gray
        self.red   = args[0]
        self.green = args[1]
        self.blue  = args[2]
        self.gray  = args[3]
    else
        raise ArgumentError, "Invalid arguments for set method"
    end
end