pyglet.image.animation

2D Animations

Animations can be used by the Sprite class in place of static images. They are essentially containers for individual image frames, with a duration per frame. They can be infinitely looping, or stop at the last frame. You can load Animations from disk, such as from GIF files:

ani = pyglet.resource.animation('walking.gif')
sprite = pyglet.sprite.Sprite(img=ani)

Alternatively, you can create your own Animations from a sequence of images by using the from_image_sequence() method:

images = [pyglet.resource.image('walk_a.png'),
          pyglet.resource.image('walk_b.png'),
          pyglet.resource.image('walk_c.png')]

ani = pyglet.image.Animation.from_image_sequence(images, duration=0.1, loop=True)

You can also use an pyglet.image.ImageGrid, which is iterable:

sprite_sheet = pyglet.resource.image('my_sprite_sheet.png')
image_grid = pyglet.image.ImageGrid(sprite_sheet, rows=1, columns=5)

ani = pyglet.image.Animation.from_image_sequence(image_grid, duration=0.1)

In the above examples, all of the Animation Frames have the same duration. If you wish to adjust this, you can manually create the Animation from a list of AnimationFrame:

image_a = pyglet.resource.image('walk_a.png')
image_b = pyglet.resource.image('walk_b.png')
image_c = pyglet.resource.image('walk_c.png')

frame_a = pyglet.image.AnimationFrame(image_a, duration=0.1)
frame_b = pyglet.image.AnimationFrame(image_b, duration=0.2)
frame_c = pyglet.image.AnimationFrame(image_c, duration=0.1)

ani = pyglet.image.Animation(frames=[frame_a, frame_b, frame_c])

class Animation

Sequence of images with timing information.

If no frames of the animation have a duration of None, the animation loops continuously; otherwise the animation stops at the first frame with duration of None.

Ivariables:

frameslist of ~pyglet.image.AnimationFrame: The frames that make up the animation.

__init__(frames)

Create an animation directly from a list of frames.

Parameters:

frameslist of ~pyglet.image.AnimationFrame: The frames that make up the animation.

add_to_texture_bin(texture_bin, border=0)

Add the images of the animation to a TextureBin.

The animation frames are modified in-place to refer to the texture bin regions.

Parameters:

texture_bin~pyglet.image.atlas.TextureBin: Texture bin to upload animation frames into.
borderint: Leaves specified pixels of blank space around each image frame when adding to the TextureBin.

classmethod from_image_sequence(sequence, duration, loop=True)

Create an animation from a list of images and a constant framerate.

Parameters:

sequencelist of ~pyglet.image.AbstractImage: Images that make up the animation, in sequence.
durationfloat: Number of seconds to display each image.
loopbool: If True, the animation will loop continuously.

Return type:

Animation

get_duration()

Get the total duration of the animation in seconds.

Return type:: float

get_max_height()

Get the maximum image frame height.

This method is useful for determining texture space requirements: due to the use of anchor_y the actual required playback area may be larger.

Return type:: int

get_max_width()

Get the maximum image frame width.

This method is useful for determining texture space requirements: due to the use of anchor_x the actual required playback area may be larger.

Return type:: int

get_transform(flip_x=False, flip_y=False, rotate=0)

Create a copy of this animation applying a simple transformation.

The transformation is applied around the image’s anchor point of each frame. The texture data is shared between the original animation and the transformed animation.

Parameters:

flip_xbool: If True, the returned animation will be flipped horizontally.
flip_ybool: If True, the returned animation will be flipped vertically.
rotateint: Degrees of clockwise rotation of the returned animation. Only 90-degree increments are supported.

Return type:

Animation

class AnimationFrame

A single frame of an animation.

__init__(image, duration)

Create an animation frame from an image.

Parameters:

image~pyglet.image.AbstractImage: The image of this frame.
durationfloat: Number of seconds to display the frame, or None if it is the last frame in the animation.

duration

image