Class: RubySketch::Context

Inherits:
Processing::Context
  • Object
show all
Defined in:
lib/rubysketch/context.rb

Constant Summary collapse

Sprite = 
RubySketch::Sprite
SpriteWorld = 
RubySketch::SpriteWorld
Circle = 
RubySketch::Circle
Sound = 
RubySketch::Sound

Instance Method Summary collapse

Instance Method Details

#addSprite(*sprites) ⇒ Sprite

Adds sprites to the physics engine.

Parameters:

  • sprites (Sprite) —

    sprite objects

Returns:

  • (Sprite) —

    first added sprite



205
206
207
 
# File 'lib/rubysketch/context.rb', line 205

def addSprite(*sprites)
  @world__.addSprite(*sprites)
end

#addWorld(*worlds) ⇒ SpriteWorld

Adds worlds

Parameters:

Returns:



268
269
270
271
 
# File 'lib/rubysketch/context.rb', line 268

def addWorld(*worlds)
  worlds.each {@window__.add_overlay _1.getInternal__}
  worlds.first
end

#animate(seconds, id: nextTimerID__, easing: :expoOut, &block) ⇒ Object

Animate with easing functions

Parameters:

  • seconds (Numeric) —

    Animation duration

  • id (Object) (defaults to: nextTimerID__) —

    Timer object identifier

  • easing (Symbol) (defaults to: :expoOut) —

    Easing function name

Returns:

  • (Object) —

    Timer object identifier



110
111
112
113
114
115
116
117
118
119
120
121
122
123
 
# File 'lib/rubysketch/context.rb', line 110

def animate(seconds, id: nextTimerID__, easing: :expoOut, &block)
  fun   = EASINGS[easing] or raise "'#{easing}' easing function not found"
  start = Time.now.to_f
  eachDrawBlock = lambda do
    t = (Time.now.to_f - start) / seconds
    if t >= 1.0
      block.call fun.call(1.0), true
    else
      block.call fun.call(t), false
      setTimeout id: id, &eachDrawBlock
    end
  end
  setTimeout id: id, &eachDrawBlock
end

#animateValue(seconds, from:, to:, id: nextTimerID__, easing: :expoOut, &block) ⇒ Object

Animate value with easing functions

Parameters:

  • seconds (Numeric) —

    Animation duration

  • from (Numeric, Vector) —

    Value at the beggining of the animation

  • to (Numeric, Vector) —

    Value at the end of the animation

  • id (Object) (defaults to: nextTimerID__) —

    Timer object identifier

  • easing (Symbol) (defaults to: :expoOut) —

    Easing function name

Returns:

  • (Object) —

    Timer object identifier



135
136
137
138
139
140
141
142
143
144
145
 
# File 'lib/rubysketch/context.rb', line 135

def animateValue(seconds, from:, to:, id: nextTimerID__, easing: :expoOut, &block)
  if from.is_a? Vector
    animate seconds, id: id, easing: easing do |t, finished|
      block.call Vector.lerp(from, to, t), finished
    end
  else
    animate seconds, id: id, easing: easing do |t, finished|
      block.call        lerp(from, to, t), finished
    end
  end
end

#clearTimer(id) ⇒ nil Also known as: clearTimeout, clearInterval

Stops timeout or interval timer by id

Parameters:

  • id (Object) —

    The identifier of timeout or interval timer to stop

Returns:

  • (nil) —

    nil



78
79
80
81
 
# File 'lib/rubysketch/context.rb', line 78

def clearTimer(id)
  [@timers__, @firingTimers__].each {|timers| timers.delete id}
  nil
end

#createSprite(x, y, w, h) ⇒ Sprite #createSprite(image: img) ⇒ Sprite #createSprite(x, y, image: img) ⇒ Sprite #createSprite(x, y, image: img, offset: off) ⇒ Sprite #createSprite(x, y, image: img, shape: shp) ⇒ Sprite #createSprite(x, y, image: img, offset: off, shape: shp) ⇒ Sprite #createSprite(x, y, shape: shp) ⇒ Sprite

Creates a new sprite and add it to physics engine.

Overloads:

  • #createSprite(x, y, w, h) ⇒ Sprite

    pos(x, y), size: [w, h]

    Parameters:

    • x (Numeric) —

      x of the sprite position

    • y (Numeric) —

      y of the sprite position

    • w (Numeric) —

      width of the sprite

    • h (Numeric) —

      height of the sprite

  • #createSprite(image: img) ⇒ Sprite

    pos: [0, 0], size: [image.width, image.height]

    Parameters:

    • img (Image) —

      sprite image

  • #createSprite(x, y, image: img) ⇒ Sprite

    pos: [x, y], size: [image.width, image.height]

    Parameters:

    • x (Numeric) —

      x of the sprite position

    • y (Numeric) —

      y of the sprite position

    • img (Image) —

      sprite image

  • #createSprite(x, y, image: img, offset: off) ⇒ Sprite

    pos: [x, y], size: [image.width, image.height], offset: [offset.x, offset.x]

    Parameters:

    • x (Numeric) —

      x of the sprite position

    • y (Numeric) —

      y of the sprite position

    • img (Image) —

      sprite image

    • off (Vector) —

      offset of the sprite image

  • #createSprite(x, y, image: img, shape: shp) ⇒ Sprite

    pos: [x, y], size: [image.width, image.height]

    Parameters:

    • x (Numeric) —

      x of the sprite position

    • y (Numeric) —

      y of the sprite position

    • img (Image) —

      sprite image

  • #createSprite(x, y, image: img, offset: off, shape: shp) ⇒ Sprite

    pos: [x, y], size: [image.width, image.height], offset: [offset.x, offset.x]

    Parameters:

    • x (Numeric) —

      x of the sprite position

    • y (Numeric) —

      y of the sprite position

    • img (Image) —

      sprite image

    • off (Vector) —

      offset of the sprite image

    • shp (Shape) —

      shape of the sprite for physics calculations

  • #createSprite(x, y, shape: shp) ⇒ Sprite

    pos: [x, y], size: [shape.width, shape.height]

    Parameters:

    • x (Numeric) —

      x of the sprite position

    • y (Numeric) —

      y of the sprite position

    • shp (Shape) —

      shape of the sprite for physics calculations

Returns:

  • (Sprite) —

    the new sprite object



195
196
197
 
# File 'lib/rubysketch/context.rb', line 195

def createSprite(*args, **kwargs)
  @world__.createSprite(*args, context: self, **kwargs)
end

#createWorld(pixels_per_meter: 0) ⇒ SpriteWorld

Creates a new world to calculate the physics of sprites.

Returns:



258
259
260
 
# File 'lib/rubysketch/context.rb', line 258

def createWorld(pixels_per_meter: 0)
  addWorld SpriteWorld.new pixels_per_meter: pixels_per_meter
end

#gravity(vec) ⇒ nil #gravity(ary) ⇒ nil #gravity(x, y) ⇒ nil

Sets gravity for the physics engine.

Overloads:

  • #gravity(vec) ⇒ nil

    Parameters:

    • vec (Vector) —

      gracity vector

  • #gravity(ary) ⇒ nil

    Parameters:

    • ary (Array<Numeric>) —

      gravityX, gravityY

  • #gravity(x, y) ⇒ nil

    Parameters:

    • x (Numeric) —

      x of gravity vector

    • y (Numeric) —

      y of gracity vector

Returns:

  • (nil) —

    nil



308
309
310
 
# File 'lib/rubysketch/context.rb', line 308

def gravity(...)
  @world__.gravity(...)
end

#loadSound(path) ⇒ Sound

Loads sound file.

Parameters:

  • path (String) —

    path for sound file

Returns:

  • (Sound) —

    sound object



290
291
292
 
# File 'lib/rubysketch/context.rb', line 290

def loadSound(path)
  Sound.load path
end

#removeSprite(*sprites) ⇒ Sprite

Removes sprites from the physics engine.

Parameters:

  • sprites (Sprite) —

    sprite objects

Returns:

  • (Sprite) —

    first removed sprite



215
216
217
 
# File 'lib/rubysketch/context.rb', line 215

def removeSprite(*sprites)
  @world__.removeSprite(*sprites)
end

#removeWorld(*worlds) ⇒ SpriteWorld

Removes worlds

Parameters:

Returns:



279
280
281
282
 
# File 'lib/rubysketch/context.rb', line 279

def removeWorld(*worlds)
  worlds.each {@window__.remove_overlay _1.getInternal__}
  worlds.first
end

#setInterval(seconds = 0, *args, id: nextTimerID__, now: false, &block) ⇒ Object

Repeats block call at each interval

Parameters:

  • seconds (Numeric) (defaults to: 0) —

    Each interval duration

  • args (Array) —

    Arguments passed to block

  • id (Object) (defaults to: nextTimerID__) —

    Timer object identifier

  • now (Boolean) (defaults to: false) —

    Wheather or not to call the block right now

Returns:

  • (Object) —

    Timer object identifier



49
50
51
52
53
54
 
# File 'lib/rubysketch/context.rb', line 49

def setInterval(seconds = 0, *args, id: nextTimerID__, now: false, &block)
  return unless block
  time = Time.now.to_f
  block.call(*args) if now
  setInterval__ id, time, seconds, args, &block
end

#setTimeout(seconds = 0, *args, id: nextTimerID__, &block) ⇒ Object

Calls block after specified seconds

Parameters:

  • seconds (Numeric) (defaults to: 0) —

    Time at which the block is called

  • args (Array) —

    Arguments passed to block

  • id (Object) (defaults to: nextTimerID__) —

    Timer object identifier

Returns:

  • (Object) —

    Timer object identifier



35
36
37
38
 
# File 'lib/rubysketch/context.rb', line 35

def setTimeout(seconds = 0, *args, id: nextTimerID__, &block)
  return unless block
  setTimeout__ id, Time.now.to_f + seconds, args, &block
end

#sprite(*sprites) ⇒ nil Also known as: drawSprite

Draws one or more sprites.

Parameters:

Returns:

  • (nil) —

    nil



225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
 
# File 'lib/rubysketch/context.rb', line 225

def sprite(*sprites)
  sprites.flatten! if sprites.first&.is_a? Array
  sprites.each do |sp|
    next if sp.hidden?
    view, draw = sp.getInternal__, sp.instance_variable_get(:@drawBlock__)
    f, degrees, pivot = view.frame, view.angle, view.pivot
    if draw
      push do
        translate f.x + pivot.x  * f.w, f.y + pivot.y  * f.h
        rotate fromDegrees__ degrees
        translate     (-pivot.x) * f.w,     (-pivot.y) * f.h
        draw.call {sp.draw__ self, 0, 0, f.w, f.h}
      end
    elsif degrees == 0
      sp.draw__ self, f.x, f.y, f.w, f.h
    else
      pushMatrix do
        translate f.x + pivot.x  * f.w, f.y + pivot.y  * f.h
        rotate fromDegrees__ degrees
        translate     (-pivot.x) * f.w,     (-pivot.y) * f.h
        sp.draw__ self, 0, 0, f.w, f.h
      end
    end
  end
  nil
end

#vibrate ⇒ nil

Generates haptic feedback

Returns:

  • (nil) —

    nil



316
317
318
 
# File 'lib/rubysketch/context.rb', line 316

def vibrate()
  Reflex.vibrate
end