pyglet.image.animation

2D动画。

动画可以由 Sprite 类来代替静态图像。它们本质上是单个图像帧的容器，每帧有一个持续时间。它们可以无限循环，也可以在最后一帧停止。您可以从磁盘加载动画，例如从GIF文件：：

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

或者，您也可以使用 from_image_sequence() 方法：

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)

您还可以使用 pyglet.image.ImageGrid ，其可迭代：：

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)

在上面的例子中，所有动画帧的持续时间相同。如果您希望调整此功能，可以从列表中手动创建动画 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

具有定时信息的图像序列。

动画是 AnimationFrame s，它们是图像数据和持续时间信息的简单容器。

如果动画中没有任何帧的持续时间为 None ，则动画将连续循环；否则，动画将在持续时间为 None 。

__init__(frames: list[AnimationFrame]) → None: 直接从帧列表创建动画。

add_to_texture_bin( texture_bin: TextureBin, border: int = 0, ) → None

将动画图像添加到 TextureBin 。

动画帧被就地修改以引用纹理箱区域。可以指定可选的边界（以像素为单位）来保留添加到纹理箱的图像周围。

返回类型:: None

classmethod from_image_sequence( sequence: Iterable[ImageData], duration: float, loop: bool = True, ) → Animation

从图像列表和每帧持续时间创建动画。

返回类型:: Animation

get_duration() → float

获取动画的总持续时间(秒)。

返回类型:: float

get_max_height() → int

获取最大图像帧高度。

此方法对于确定纹理空间要求很有用：由于使用 anchor_y 实际需要的回放区域可能更大。

返回类型:: int

get_max_width() → int

获取最大图像边框宽度。

此方法对于确定纹理空间要求很有用：由于使用 anchor_x 实际需要的回放区域可能更大。

返回类型:: int

get_transform( flip_x: bool = False, flip_y: bool = False, rotate: Literal[0, 90, 180, 270, 360] = 0, ) → Animation

创建此动画的副本，应用简单的转换。

通过操纵纹理坐标来执行变换，这将此操作限制为90度的增量。

变换在图像的每一帧的锚点周围应用。纹理数据在原始动画和变换后的动画之间共享。

返回类型:: Animation

class AnimationFrame

动画中的单个帧。

__init__( image: AbstractImage | ImageData, duration: float, ) → None: 从图像创建动画帧。

duration

image