excaliburjs / Excalibur / 7619811187

89%

push

github

feat: Implement SpriteSheet getSprite options (#2901)

This PR implements new `ex.SpriteSheet.getSprite(..., options)`

You can now influence sprites directly out of the sprite sheet

  ```typescript
  const sprite = ss.getSprite(0, 0, {
    flipHorizontal: true,
    flipVertical: true,
    width: 200,
    height: 201,
    opacity: .5,
    scale: ex.vec(2, 2),
    origin: ex.vec(0, 1),
    tint: ex.Color.Red,
    rotation: 4
  });
  ```

Also the animation helper  `ex.Animation.fromSpriteSheetCoordinates()` you can now pass any valid `ex.GraphicOptions` to influence the sprite per frame
  ```typescript
  const anim = ex.Animation.fromSpriteSheetCoordinates({
    spriteSheet: ss,
    frameCoordinates: [
      {x: 0, y: 0, duration: 100, options: { flipHorizontal: true }},
      {x: 1, y: 0, duration: 100, options: { flipVertical: true }},
      {x: 2, y: 0, duration: 100},
      {x: 3, y: 0, duration: 100}
    ],
    strategy: ex.AnimationStrategy.Freeze
  });
  ```

5015 of 6304 branches covered (0.0%)

11175 of 12238 relevant lines covered (91.31%)

26926.27 hits per line