create Animation
Create an animation object that will attach to a sprite.
animation.createAnimation(0, 0)
An animation object contains image frames that are displayed in a sequence. The animation is empty when it’s first created. Frames are added to the animation show a complete action. The animation is associated, or tagged, to its action. An action is some activity that is given a value, such as Walking
, Flying
, Running
, or Jumping
.
Actions are set in an enumeration called ActionKind
and are chosen for the animation when it’s created. New actions can be added by putting in a new value for ActionKind
in JavaScript or by chosing Add a new action...
in the action drop down list for ||animation:create animation||
.
enum ActionKind {
Walking,
Idle,
Jumping
}
Each frame in an animation is shown for some amount of time. This is set in the frame interval as a number of milliseconds.
Parameters
- action: an action to relate the animation to. This could be an action like
Walking
orJumping
. - interval: a number that is the amount of time in milliseconds to show each frame in the animation.
Returns
- an animation that is attached later to a sprite.
Example
Create an walking aninamtion with four frames.
enum SpriteKind {
Player,
Enemy
}
enum ActionKind {
Walking,
Idle,
Jumping
}
let anim: animation.Animation = null
let mySprite: Sprite = null
mySprite = sprites.create(img`
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
`, SpriteKind.Player)
anim = animation.createAnimation(ActionKind.Walking, 1000)
anim.addAnimationFrame(img`
d d d d d d f f f f d d d d d d
d d d d f f f 2 2 f f f d d d d
d d d f f f 2 2 2 2 f f f d d d
d d f f f e e e e e e f f f d d
d d f f e 2 2 2 2 2 2 e e f d d
d d f e 2 f f f f f f 2 e f d d
d d f f f f e e e e f f f f d d
d f f e f b f 4 4 f b f e f f d
d f e e 4 1 f d d f 1 4 e e f d
d d f e e d d d d d d e e f d d
d d d f e e 4 4 4 4 e e f d d d
d d e 4 f 2 2 2 2 2 2 f 4 e d d
d d 4 d f 2 2 2 2 2 2 f d 4 d d
d d 4 4 f 4 4 5 5 4 4 f 4 4 d d
d d d d d f f f f f f d d d d d
d d d d d f f d d f f d d d d d
`)
anim.addAnimationFrame(img`
d d d d d d d d d d d d d d d d
d d d d d d f f f f d d d d d d
d d d d f f f 2 2 f f f d d d d
d d d f f f 2 2 2 2 f f f d d d
d d f f f e e e e e e f f f d d
d d f f e 2 2 2 2 2 2 e e f d d
d f f e 2 f f f f f f 2 e f f d
d f f f f f e e e e f f f f f d
d d f e f b f 4 4 f b f e f d d
d d f e 4 1 f d d f 1 4 e f d d
d d d f e 4 d d d d 4 e f e d d
d d f e f 2 2 2 2 e d d 4 e d d
d d e 4 f 2 2 2 2 e d d e d d d
d d d d f 4 4 5 5 f e e d d d d
d d d d f f f f f f f d d d d d
d d d d f f f d d d d d d d d d
`)
anim.addAnimationFrame(img`
d d d d d d f f f f d d d d d d
d d d d f f f 2 2 f f f d d d d
d d d f f f 2 2 2 2 f f f d d d
d d f f f e e e e e e f f f d d
d d f f e 2 2 2 2 2 2 e e f d d
d d f e 2 f f f f f f 2 e f d d
d d f f f f e e e e f f f f d d
d f f e f b f 4 4 f b f e f f d
d f e e 4 1 f d d f 1 4 e e f d
d d f e e d d d d d d e e f d d
d d d f e e 4 4 4 4 e e f d d d
d d e 4 f 2 2 2 2 2 2 f 4 e d d
d d 4 d f 2 2 2 2 2 2 f d 4 d d
d d 4 4 f 4 4 5 5 4 4 f 4 4 d d
d d d d d f f f f f f d d d d d
d d d d d f f d d f f d d d d d
`)
anim.addAnimationFrame(img`
d d d d d d d d d d d d d d d d
d d d d d d f f f f d d d d d d
d d d d f f f 2 2 f f f d d d d
d d d f f f 2 2 2 2 f f f d d d
d d f f f e e e e e e f f f d d
d d f e e 2 2 2 2 2 2 e f f d d
d f f e 2 f f f f f f 2 e f f d
d f f f f f e e e e f f f f f d
d d f e f b f 4 4 f b f e f d d
d d f e 4 1 f d d f 1 4 e f d d
d d e f e 4 d d d d 4 e f d d d
d d e 4 d d e 2 2 2 2 f e f d d
d d d e d d e 2 2 2 2 f 4 e d d
d d d d e e f 5 5 4 4 f d d d d
d d d d d f f f f f f f d d d d
d d d d d d d d d f f f d d d d
`)
animation.attachAnimation(mySprite, anim)
animation.setAction(mySprite, ActionKind.Walking)
See also
add animation frame, attach animation, set action
animation