Sprite

Create and manage animated sprites in the Phaser scene. Created with PhaserGame$add_sprite() method.

Methods

Public methods

• Sprite$new()

• Sprite$add_animation()

• Sprite$play_animation()

• Sprite$add_player_controls()

• Sprite$set_velocity_x()

• Sprite$set_velocity_y()

• Sprite$set_gravity()

• Sprite$set_bounce()

• Sprite$destroy()

• Sprite$set_in_motion()

• Sprite$clone()

---

Method new()

Usage

Sprite$new(
  name,
  url,
  x,
  y,
  frame_width,
  frame_height,
  frame_count = NULL,
  frame_rate,
  session = getDefaultReactiveDomain()
)

Arguments

name

Character. Unique key for the sprite and its idle animation.

url

Character. URL or path to the spritesheet image.

x

Numeric. X-coordinate in pixels.

y

Numeric. Y-coordinate in pixels.

frame_width

Numeric. Width of each frame.

frame_height

Numeric. Height of each frame.

frame_count

Numeric. Number of frames in the spritesheet. If NULL, auto-detect from spritesheet dimensions.

frame_rate

Numeric. Frames per second for the idle animation.

session

Shiny session object.

---

Method add_animation()

Load a custom animation for any sprite previously added.

Usage

Sprite$add_animation(
  suffix,
  url,
  frame_width,
  frame_height,
  frame_count = NULL,
  frame_rate
)

Arguments

suffix

Character. Identifier for this animation (e.g. "move_left").

url

Character. URL or path to the spritesheet.

frame_width

Numeric. Width of each frame.

frame_height

Numeric. Height of each frame.

frame_count

Numeric. Number of frames in the spritesheet. If NULL, auto-detect from spritesheet dimensions.

frame_rate

Numeric. Frames per second for playback.

Returns

Invisible; sends a custom message to the client.

---

Method play_animation()

Play a loaded animation for the sprite.

Usage

Sprite$play_animation(anim_name, duration = Inf)

Arguments

anim_name

Character. Identifier for the animation to play (e.g. " move_left").

duration

Numeric. Optional duration in milliseconds to play the animation before reverting to idle (defaults to Inf, which loops indefinitely until another animation is played).

---

Method add_player_controls()

Enable movement controls (arrow keys) for a player sprite.

Usage

Sprite$add_player_controls(
  directions = c("left", "right", "down", "up"),
  speed = 200
)

Arguments

directions

Character vector. Directions to enable (defaults to c("left","right","down","up")).

speed

Numeric. Movement speed in pixels/second (default: 200).

---

Method set_velocity_x()

Set the sprite's velocity in the x direction.

Usage

Sprite$set_velocity_x(x = 100)

Arguments

x

Numeric. Velocity in pixels/second (positive = right, negative = left).

---

Method set_velocity_y()

Set the sprite's velocity in the y direction.

Usage

Sprite$set_velocity_y(x = 100)

Arguments

x

Numeric. Velocity in pixels/second (positive = down, negative = up).

---

Method set_gravity()

Set the sprite's velocity in both x and y directions.

Usage

Sprite$set_gravity(x = 100, y = 100)

Arguments

x

Numeric. Velocity in pixels/second (positive = right, negative = left).

y

Numeric. Velocity in pixels/second (positive = down, negative = up).

---

Method set_bounce()

Set the sprite's bounce factor.

Usage

Sprite$set_bounce(x)

Arguments

x

Numeric. Bounce factor.

---

Method destroy()

Remove sprite from the scene.

Usage

Sprite$destroy()

---

Method set_in_motion()

Move sprite along a vector for a set distance.

Usage

Sprite$set_in_motion(dir_x, dir_y, speed, distance, lag = distance/speed)

Arguments

dir_x

Numeric. Horizontal direction (-1 = left, +1 = right, 0 = none).

dir_y

Numeric. Vertical direction (-1 = up, +1 = down, 0 = none).

speed

Numeric. Speed in pixels/second.

distance

Numeric. Distance in pixels to travel before stopping.

lag

Numeric. Optional delay before sending the command (defaults to distance/speed).

---

Method clone()

The objects of this class are cloneable with this method.

Usage

Sprite$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.