pygame中精灵的方法详解
目录
pygame.sprite.Sprite
pygame.sprite.Sprite.update()
pygame.sprite.Sprite.add()
pygame.sprite.Sprite.remove()
pygame.sprite.Sprite.kill()
pygame.sprite.Sprite.alive()
pygame.sprite.Sprite.groups()
pygame.sprite.DirtySprite
pygame.sprite.Group
pygame.sprite.Group.sprites()
pygame.sprite.Group.copy()
pygame.sprite.Group.add()
pygame.sprite.Group.remove()
pygame.sprite.Group.has()
pygame.sprite.Group.update()
pygame.sprite.Group.draw()
pygame.sprite.Group.clear()
pygame.sprite.Group.empty()
pygame.sprite.RenderPlain
pygame.sprite.RenderClear
pygame.sprite.RenderUpdates
pygame.sprite.RenderUpdates.draw()
pygame.sprite.OrderedUpdates()
pygame.sprite.LayeredUpdates
pygame.sprite.LayeredUpdates.add()
pygame.sprite.LayeredUpdates.sprites()
pygame.sprite.LayeredUpdates.draw()
pygame.sprite.LayeredUpdates.get_sprites_at()
pygame.sprite.LayeredUpdates.get_sprite()
pygame.sprite.LayeredUpdates.remove_sprites_of_layer()
pygame.sprite.LayeredUpdates.layers()
pygame.sprite.LayeredUpdates.change_layer()
pygame.sprite.LayeredUpdates.get_layer_of_sprite()
pygame.sprite.LayeredUpdates.get_top_layer()
pygame.sprite.LayeredUpdates.get_bottom_layer()
pygame.sprite.LayeredUpdates.move_to_front()
pygame.sprite.LayeredUpdates.move_to_back()
pygame.sprite.LayeredUpdates.get_top_sprite()
pygame.sprite.LayeredUpdates.get_sprites_from_layer()
pygame.sprite.LayeredUpdates.switch_layer()
pygame.sprite.LayeredDirty
pygame.sprite.LayeredDirty.draw()
pygame.sprite.LayeredDirty.clear()
pygame.sprite.LayeredDirty.repaint_rect()
pygame.sprite.LayeredDirty.set_clip()
pygame.sprite.LayeredDirty.get_clip()
pygame.sprite.LayeredDirty.change_layer()
pygame.sprite.LayeredDirty.set_timing_treshold()
pygame.sprite.GroupSingle()
pygame.sprite.spritecollide()
pygame.sprite.collide_rect()
pygame.sprite.collide_rect_ratio()
pygame.sprite.collide_circle()
pygame.sprite.collide_circle_ratio()
pygame.sprite.collide_mask()
pygame.sprite.groupcollide()
pygame.sprite.spritecollideany()
pygame.sprite.Sprite
功能：可视游戏中的对象的基础类
属性：Sprite(*groups) -> Sprite
使用Sprite类派生新类时需要分配 Sprite.image 和 Sprite.rect 属性并添加 Sprite.update() 方法。初始设定项可以添加任何数量的组（Group）实例。当派生 Sprite类的子类时，请确保在将 Sprite类添加到组群（ Groups）之前已调用基础初始设定项。例如：
class Block(pygame.sprite.Sprite):
# 构造函数。传入图块的颜色和x,y位置。
def __init__(self, color, width, height):
# 调用父类 (Sprite) 构造函数
pygame.sprite.Sprite.__init__(self)
# 创建一个图块并填色，或加载image
self.image = pygame.Surface([width, height])
self.image.fill(color)
# 获取有图像尺寸的Rect形对象
# 通过设定rect.x和rect.y来更新对象的位置
self.rect = self.image.get_rect()pygame.sprite.Sprite.update()
功能：控制精灵行为的方法
属性：update(*args, **kwargs) -> None
- 这个方法的默认执行动作为nothing，是一个便于重写的“钩子”。此方法由
Group.update()调用。【Group.update()参数可随意设定】 - 如果不使用组类中的同名方法，则无需使用此方法。
pygame.sprite.Sprite.add()
功能：将精灵添加到组
属性：add(*groups) -> None
任何数量的组实例都可以作为参数传递。精灵将被添加到它还不是成员的组中。
pygame.sprite.Sprite.remove()
功能：从组中移除精灵
属性：remove(*groups) -> None
任何数量的组实例都可以作为参数传递。精灵将从其当前所属的组中移除。
pygame.sprite.Sprite.kill()
功能：从所有组中移除精灵
属性：kill() -> None
精灵将从包含它的所有组中移除。这不会改变精灵的状态。调用此方法后，可以继续使用精灵，包括将其添加到组中。
pygame.sprite.Sprite.alive()
功能：判断精灵是否属于任何一个团体
属性：alive() -> bool
当精灵属于一个或多个组时返回True。
pygame.sprite.Sprite.groups()
功能：获取包含此精灵的组列表
属性：groups() -> group_list
返回包含此精灵的所有组的列表。
pygame.sprite.DirtySprite
功能：精灵类的一个子类，具有更多的属性和特性。
属性：DirtySprite(*groups) -> DirtySprite
额外的DirtySprite属性及其默认值：
| dirty = 1 | 如果设置为1，则重新绘制，然后再次设置为0 如果设置为2，则它总是脏的（重新绘制每个帧，flag未重置） 0表示它不脏，因此不会重新喷绘 |
| blendmode = 0 | blit，blendmodes的特殊flags参数 |
| source_rect = None | 要使用的源rect，相对于self.imaged的topleft（0,0） |
| visible = 1 | 通常为1，如果设置为0，则不会重新喷绘（必须将其设置为脏的以便从屏幕上删除） |
| layer = 0 | 只读值，将其添加到LayeredDirty时可读（详见LayeredDirty文档） |
pygame.sprite.Group
功能：用于保存和管理多重精灵对象的容器类。
属性：Group(*sprites) -> Group
- 简单的精灵对象的容器。可以继承该类以创建具有更特定行为的容器。构造函数接受任意数量的精灵参数添加到组类中。该组类支持以下标准的Python操作：
in测试一个精灵是否被包含在内 len包含的精灵数 bool测试是否包含任何精灵 iter遍历所有精灵 - 组类中的精灵没有顺序，因此绘制和迭代精灵没有特定的顺序。
pygame.sprite.Group.sprites()
功能：此组类包含的精灵列表
属性：sprites() -> sprite_list
返回此组类包含的所有精灵的列表。也可以从组类中获取迭代器，但在修改组类时不能对其进行迭代器操作。
pygame.sprite.Group.copy()
功能：复制组类
属性：copy() -> Group
创建一个与原始组类具有相同精灵的新组类。如果有子类组类，则新对象将具有与原始对象相同的（子）类。仅当派生类的构造函数采用与组类相同的参数时，此操作才有效。
pygame.sprite.Group.add()
功能：将精灵添加到此组类
属性：add(*sprites) -> None
- 将任意数量的精灵添加到此组。此方法只会将精灵添加进尚未成为成员的组类中。
- 每个精灵参数也可以是包含精灵的迭代器。
pygame.sprite.Group.remove()
功能：从组类中移除精灵
属性：remove(*sprites) -> None
- 从组中移除任意数量的精灵，将只删除已经是组类成员的精灵。
- 每个精灵参数也可以是包含精灵的迭代器。
pygame.sprite.Group.has()
功能：测试组类是否包含精灵
属性：has(*sprites) -> bool
- 如果组类包含所有给定的精灵，则返回True。这类似于在组类上使用“in”运算符（“if sprite in Group:…”）测试单个sprite是否属于组。
- 每个精灵参数也可以是包含精灵的迭代器。
pygame.sprite.Group.update()
功能：对包含的精灵调用update方法
属性：update(*args, **kwargs) -> None
- 对组类中的所有精灵调用
update()方法。基础Sprite类有一个update()方法，该方法接收任意数量的参数但不执行任何操作。传递给Group.update()的参数将传递给每个精灵。 - 无法从
Sprite.update()方法获得返回值。
pygame.sprite.Group.draw()
功能：位块传输精灵images
属性：draw(Surface) -> None
- 将包含的精灵绘制到Surface参数。使用
Sprite.image属性和Sprite.rect属性作为源surface的属性。 - 组类不按任何顺序保存精灵，因此绘制顺序是任意的。
pygame.sprite.Group.clear()
功能：在精灵上（覆盖）绘制背景
属性：clear(Surface_dest, background) -> None
- 删除上次使用
Group.draw()绘制的精灵。通过用背景填充绘制的精灵位置来清除目标Surface。 - 背景通常是与目标Surface尺寸相同的Surface image。但是，它也可以是一个有两个参数【目标Surface和要清除的区域】的回调函数。后台回调函数将在每次清除时调用多次。下面是一个回调示例，它将清除纯红的精灵：
def clear_callback(surf, rect):
color = 255, 0, 0
surf.fill(color, rect)
pygame.sprite.Group.empty()
功能：移除所有精灵
属性：empty() -> None
从该组中删除所有精灵。
pygame.sprite.RenderPlain
功能：等同于 pygame.sprite.Group。 这个类是pygame.sprite.Group()的别称。它没有额外的功能。
pygame.sprite.RenderClear
功能：等同于 pygame.sprite.Group。 这个类是pygame.sprite.Group()的别称。它没有额外的功能。
pygame.sprite.RenderUpdates
功能：跟踪脏更新的组类子类。
属性：RenderUpdates(*sprites) -> RenderUpdates
这个类派生自 pygame.sprite.Group()。它有一个扩展的 draw() 方法，用于跟踪屏幕的更改区域。
pygame.sprite.RenderUpdates.draw()
功能：位块传输精灵images并跟踪更改的区域
属性：draw(surface) -> Rect_list
- 将所有精灵绘制到Surface，等同于
Group.draw()。此方法还返回屏幕上一个已更改的矩形区域的列表。返回的更改包括受前一个Group.clear()调用影响的屏幕区域。 - 返回的Rect列表会传递给
pygame.display.update()。这将有助于提高软件驱动显示模式的性能。这种类型的更新通常只对具有非动画背景的目标有用。
pygame.sprite.OrderedUpdates()
功能：RenderUpdates子类，按添加顺序绘制精灵。
属性：OrderedUpdates(*spites) -> OrderedUpdates
这个类派生自 pygame.sprite.RenderUpdates()。它维持将精灵添加到组类中进行渲染的顺序。这使得在组类中添加和移除精灵的速度比常规组类稍慢。
pygame.sprite.LayeredUpdates
功能：LayeredUpdates是一个精灵组，处理层和绘制【like OrderedUpdates】。
属性：LayeredUpdates(*spites, **kwargs) -> LayeredUpdates
- 此组可以与
pygame.sprite.Sprite完全兼容。 -
可以使用'default_layer'或一个整数来通过kwargs设置默认图层。默认层为0。
-
如果添加的精灵有一个属性层，则将使用该层。如果**kwarg包含“layer”，则传递的精灵将添加到该层（重写
sprite.layer属性）。如果精灵既没有属性层也没有**kwarg，则使用默认层添加精灵。
New in pygame 1.8.
pygame.sprite.LayeredUpdates.add()
功能：将一个精灵或精灵序列添加到一个组中
属性：add(*sprites, **kwargs) -> None
如果 sprite(s)（精灵）有一个属性层，则该属性层用于该层。如果**kwargs包含“layer”，则 sprite(s) 将被添加到该参数中（重写精灵层属性）。如果两者都不通过，则 sprite(s) 将添加到默认层。
pygame.sprite.LayeredUpdates.sprites()
功能：返回精灵的有序列表（第一个在下，最后一个上）
属性：sprites() -> sprites
pygame.sprite.LayeredUpdates.draw()
功能：按正确顺序将所有精灵绘制到传递的Surface上。
属性：draw(surface) -> Rect_list
pygame.sprite.LayeredUpdates.get_sprites_at()
功能：返回一个包含该位置所有精灵的列表（第一个在下，最后一个上）
属性：get_sprites_at(pos) -> colliding_sprites
pygame.sprite.LayeredUpdates.get_sprite()
功能：从组精灵中返回索引idx处的精灵
属性：get_sprite(idx) -> sprite
如果idx不在范围内，则引发 IndexOutOfBounds 。
pygame.sprite.LayeredUpdates.remove_sprites_of_layer()
功能：从层中移除所有精灵并将其作为列表返回。
属性：remove_sprites_of_layer(layer_nr) -> sprites
pygame.sprite.LayeredUpdates.layers()
功能：返回定义的（唯一的）图层列表，从下到上排序。
属性：layers() -> layers
pygame.sprite.LayeredUpdates.change_layer()
功能：更改精灵的层
属性：change_layer(sprite, new_layer) -> None
必须事先将精灵添加到渲染器中。注意检查。
pygame.sprite.LayeredUpdates.get_layer_of_sprite()
功能：返回精灵当前所在的层。
属性：get_layer_of_sprite(sprite) -> layer
如果找不到精灵，它将返回默认层。
pygame.sprite.LayeredUpdates.get_top_layer()
功能：返回顶层
属性：get_top_layer() -> layer
pygame.sprite.LayeredUpdates.get_bottom_layer()
功能：返回底层
属性：get_bottom_layer() -> layer
pygame.sprite.LayeredUpdates.move_to_front()
功能：把精灵带到顶层
属性：move_to_front(sprite) -> None
将精灵置于最前面，将精灵层更改为最顶层（添加在该层的末尾）。
pygame.sprite.LayeredUpdates.move_to_back()
功能：将精灵移动到底层
属性：move_to_back(sprite) -> None
将精灵移动到底层，将其移到所有其他层的后面并添加一个附加层。
pygame.sprite.LayeredUpdates.get_top_sprite()
功能：返回最上面的精灵
属性：get_top_sprite() -> Sprite
pygame.sprite.LayeredUpdates.get_sprites_from_layer()
返回一个层中的所有精灵，按其添加位置排序：功能
属性：get_sprites_from_layer(layer) -> sprites
返回图层中的所有精灵，按其添加位置排序。它使用线性搜索，精灵不会从层中移除。
pygame.sprite.LayeredUpdates.switch_layer()
功能：将精灵从层1切换到层2
属性：switch_layer(layer1_nr, layer2_nr) -> None
层编号必须存在，注意检查。
pygame.sprite.LayeredDirty
功能：LayeredDirty组类用于DirtySprite对象。子类LayeredUpdates。
属性：LayeredDirty(*spites, **kwargs) -> LayeredDirty
- 此组类需要
pygame.sprite.DirtySprite或具有以下属性的任何精灵：image, rect, dirty, visible, blendmode (see doc of DirtySprite). - 此组类使用脏标志技术，因此比
pygame.sprite.RenderUpdates更快。如果程序有很多静态精灵，它还可以在脏的rect更新和全屏绘图之间自动切换。 - 与
pygame.sprite.Group一样，可以通过kwargs指定一些其他属性：_use_update True/False 默认是 False _default_layer 没有图层添加的精灵的默认图层 _time_threshold 脏rect模式之间切换的阈值时间。全屏模式，默认为1000./80==1000./fps
New in pygame 1.8.
pygame.sprite.LayeredDirty.draw()
功能：按正确顺序将所有精灵绘制到被传递surface上。
属性：draw(surface, bgd=None) -> Rect_list
也可以传递背景。如果已设置背景，则bgd参数无效。
pygame.sprite.LayeredDirty.clear()
功能：用于设置背景
属性：clear(surface, bgd) -> None
pygame.sprite.LayeredDirty.repaint_rect()
功能：重新绘制给定区域，screen_rect 在屏幕坐标中。
属性：repaint_rect(screen_rect) -> None
pygame.sprite.LayeredDirty.set_clip()
功能：剪辑要绘制的区域。通过传递 None（默认值）以重置剪辑
属性：set_clip(screen_rect=None) -> None
pygame.sprite.LayeredDirty.get_clip()
功能：剪辑要绘制的区域。通过传递 None（默认值）以重置剪辑
属性：get_clip() -> Rect
pygame.sprite.LayeredDirty.change_layer()
功能：更改精灵的层
属性：change_layer(sprite, new_layer) -> None
必须事先将精灵添加到渲染器中，注意检查。
pygame.sprite.LayeredDirty.set_timing_treshold()
功能：以毫秒为单位设置阈值
属性：set_timing_treshold(time_ms) -> None
默认值是1000/80，其中80是切换到全屏模式的fps。此方法的名称有小错误。
| Raises: | TypeError --如果 time_ms 不是int或float |
|---|
pygame.sprite.GroupSingle()
功能：保存单个精灵的组类容器。
属性：GroupSingle(sprite=None) -> GroupSingle
- GroupSingle容器只保存一个精灵。添加新精灵时，旧精灵将被移除。
- 有一个特殊的属性【
GroupSingle.sprite】用以访问此组类包含的精灵。当组类为空时，显示 None 。还可以指定属性以将精灵添加到GroupSingle容器中。
pygame.sprite.spritecollide()
功能：在与另一个精灵相交的组类中查找精灵。
属性：spritecollide(sprite, group, dokill, collided = None) -> Sprite_list
- 返回一个列表，其中包含与另一个精灵相交的组中的所有精灵。相交就是比较每个精灵的
Sprite.rect属性。 - dokill参数是个布尔量。如果设置为True，则所有碰撞的精灵都将从组中移除。
- 碰撞参数是一个回调函数，用于计算两个精灵是否碰撞。它应该取两个精灵作为值，并返回一个bool值，指示它们是否发生碰撞。如果未碰撞，则所有精灵都必须具有“rect”值【精灵区域的矩形，用于计算碰撞】。collided 可调用参数：collide_rect, collide_rect_ratio, collide_circle,collide_circle_ratio, collide_mask。例如：
# 查看精灵块是否与组类block_list中的任何内容冲突
# True标志将删除block_list中的精灵
blocks_hit_list = pygame.sprite.spritecollide(player, block_list, True)
# 检查碰撞精灵列表，并计数
for block in blocks_hit_list:
score +=1pygame.sprite.collide_rect()
功能：检测两个精灵之间的碰撞，使用rects表示。
属性：collide_rect(left, right) -> bool
- 测试两个精灵之间的碰撞。使用pygame rect colliderect函数计算碰撞。并作为碰撞回调函数传递给*collide函数。
- 精灵必须具有“rect”属性。
New in pygame 1.8.
pygame.sprite.collide_rect_ratio()
功能：两个精灵之间的碰撞检测，使用给定比例缩放的rects表示。
属性：collide_rect_ratio(ratio) -> collided_callable
- 一个检查两个精灵之间碰撞的可调用的类，使用精灵rects的缩放版本表示。
- 使用比率创建，然后将实例作为冲突回调函数传递给*collide函数。
- 比率是一个浮点数 -- 1.0是相同的大小，2.0是两倍大，0.5是一半大
New in pygame 1.8.1.
pygame.sprite.collide_circle()
功能：检测两个精灵之间的碰撞，使用圆表示。
属性：collide_circle(left, right) -> bool
- 测试两个精灵之间的碰撞，方法是测试以精灵为中心的两个圆是否重叠。如果精灵有一个“radius”属性，该属性用于创建圆，否则将创建一个大到足以完全包围精灵“rect”属性的圆。并作为冲突回调函数传递给*collide函数。
- 精灵必须有一个“rect”和一个可选的“radius”属性。
New in pygame 1.8.1.
pygame.sprite.collide_circle_ratio()
功能：两个精灵之间的碰撞检测，使用给定比例缩放的圆表示。
属性：collide_circle_ratio(ratio) -> collided_callable
- 一个检查两个精灵之间碰撞的可调用的类，使用精灵radius的缩放版本表示。
- 使用浮点比率创建，然后将实例作为冲突回调函数传递给*collide函数。
- 比率是一个浮点数 -- 1.0是相同的大小，2.0是两倍大，0.5是一半大。
- 创建的两个精灵之间碰撞的可调用测试，方法是在按存储的比率缩放圆半径后，测试以精灵为中心的两个圆是否重叠。如果精灵有一个“radius”属性，该属性用于创建圆，否则将创建一个大到足以完全包围精灵rect”属性的圆。并作为冲突回调函数传递给*collide函数。
- 精灵必须有一个“rect”和一个可选的“radius”属性。
New in pygame 1.8.1.
pygame.sprite.collide_mask()
功能：两个精灵之间的碰撞检测，使用mask表示。
属性：
- collide_mask(sprite1, sprite2) -> (int, int)
- collide_mask(sprite1, sprite2) -> None
- 通过测试两个精灵的位掩码是否重叠（使用
pygame.mask.Mask.overlap()）检测碰撞。如果精灵具有mask属性，则将其用作掩码，否则将从精灵的image属性创建掩码（使用pygame.mask.from_surface()）。精灵必须具有rect属性；mask属性是可选的。 - 返回掩码之间的第一个碰撞点。碰撞点的坐标原点是精灵1的掩码左上角【始终视为(0，0)】。碰撞点是掩码内的一个位置，与精灵1的实际屏幕位置无关。
- 此函数将作为碰撞回调函数传递给组类碰撞函数（请参见spritecollide()、group collide()、spritecollideany()）。
注意：
- 若要提高性能，请为将使用此函数检查碰撞的所有精灵创建并设置
mask属性。否则，每次调用此函数时，它都将创建新的掩码。 - 每次更改精灵的图像时（例如，如果使用新图像或旋转现有图像），都需要重新创建一个新的掩码。
# 为精灵创建掩码的示例。
sprite.mask = pygame.mask.from_surface(sprite.image)
| Returns: | 掩码之间的第一个冲突点；如果没有冲突，则返回 None |
|---|---|
| Return type: | tuple(int, int) 或 NoneType |
New in pygame 1.8.0.
pygame.sprite.groupcollide()
功能：查找两个组之间碰撞的所有精灵
属性：groupcollide(group1, group2, dokill1, dokill2, collided = None) -> Sprite_dict
- 此方法将查找两个组中所有精灵之间的碰撞。碰撞是通过比较每个精灵的
Sprite.rect属性，如果，或者使用collided函数【其参数不是None时】。 - group1中的每个精灵都会被添加到返回字典中。每个项的值是group2中相交的精灵列表。
- 如果dokill参数为真，碰撞的精灵将从各自的组类中移除。
- 碰撞参数是一个回调函数，用于计算两个精灵是否碰撞。它应该取两个精灵作为值，并返回一个bool值，指示它们是否发生碰撞。如果未发生碰撞，则所有精灵都必须具有一个“rect”值【精灵区域的矩形，用于计算碰撞】。
pygame.sprite.spritecollideany()
功能：简单测试一个精灵是否与一组中的 anything 相交。
属性：
- spritecollideany(sprite, group, collided = None) -> Sprite Collision with the returned sprite.
- spritecollideany(sprite, group, collided = None) -> None No collision
- 如果精灵与组中的任何单个精灵碰撞，则返回组中的单个精灵。无碰撞时返回None。
- 如果你不需要
pygame.sprite.spritecollide()函数的所有特征，此函数将快一点。 - 碰撞参数是一个回调函数，用于计算两个精灵是否碰撞。它应该取两个精灵作为值，并返回一个bool值，指示它们是否发生碰撞。如果未发生碰撞，则所有精灵都必须具有一个“rect”值【精灵区域的矩形，用于计算碰撞】。
整理自：https://www.pygame.org/docs/ref/sprite.html