Method: MiniGL::Effect#initialize

Defined in:
lib/minigl/game_object.rb

#initialize(x, y = nil, img = nil, sprite_cols = nil, sprite_rows = nil, interval = 10, indices = nil, lifetime = nil, sound = nil, sound_ext = '.wav', sound_volume = 1) ⇒ Effect

Creates a new Effect.

Parameters:

x

The x-coordinate in the screen (or map) where the effect will be drawn. This can be modified later via the x attribute.

y

The y-coordinate in the screen (or map) where the effect will be drawn. This can be modified later via the y attribute.

img

The image or spritesheet to use for this effect (see Sprite for details on spritesheets).

sprite_cols

(see Sprite)

sprite_rows

(see Sprite)

interval

The interval between steps of the animation, in updates.

indices

The indices to use in the animation. See Sprite#animate for details. If nil, it will be the sequence from 0 to sprite_cols * sprite_rows - 1.

lifetime

The lifetime of the effect, in updates. After update is called this number of times, the effect will no longer be visible, even when draw is called, and the dead flag will be set to true, so you get to know when to dispose of the Effect object. If nil, it will be set to @indices.length * interval, i.e., the exact time needed for one animation cycle to complete.

sound

The id of a sound to be played when the effect is created (id must be given in the format specified for the Res.sound method).

sound_ext

Extension of the sound file, if a sound is given. Default is ‘.wav’.

sound_volume

The volume (from 0 to 1) to play the sound, if any. Default is 1.

Obs.: This method accepts named parameters, but x, y and img are mandatory.



338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
 
# File 'lib/minigl/game_object.rb', line 338

def initialize(x, y = nil, img = nil, sprite_cols = nil, sprite_rows = nil, interval = 10, indices = nil, lifetime = nil,
               sound = nil, sound_ext = '.wav', sound_volume = 1)
  if x.is_a? Hash
    y = x[:y]
    img = x[:img]
    sprite_cols = x.fetch(:sprite_cols, nil)
    sprite_rows = x.fetch(:sprite_rows, nil)
    interval = x.fetch(:interval, 10)
    indices = x.fetch(:indices, nil)
    lifetime = x.fetch(:lifetime, nil)
    sound = x.fetch(:sound, nil)
    sound_ext = x.fetch(:sound_ext, '.wav')
    sound_volume = x.fetch(:sound_volume, 1)
    x = x[:x]
  end

  super x, y, img, sprite_cols, sprite_rows
  @timer = 0
  if indices
    @indices = indices
  else
    @indices = *(0..(@img.length - 1))
  end
  @interval = interval
  if lifetime
    @lifetime = lifetime
  else
    @lifetime = @indices.length * interval
  end
  Res.sound(sound, false, sound_ext).play(sound_volume) if sound
end