|
大小: 11411
备注:
|
大小: 5121
备注:
|
| 删除的内容标记成这样。 | 加入的内容标记成这样。 |
| 行号 3: | 行号 3: |
| = pygame.sprite = | = Sprite模块介绍 = |
| 行号 5: | 行号 5: |
| 这个模块包含几个游戏中使用的简单类。最主要的是Sprite类，还有几个容纳Sprite的Group类。是否使用这些类在Pygame中是可选的。这些类是轻量级的，仅仅提供了一个大部分游戏所共同需要的代码的起点。 | Pygame 1.3版本开始有了一个新的模块pygame.sprite。这个模块由python写成，包括一些高级的管理游戏对象的类。充分利用这个模块，可以简化游戏对象的管理和绘制。sprite类是高度优化的，你的游戏如果用sprite模块很可能比不用还要快。 |
| 行号 7: | 行号 7: |
| Sprite类是用作游戏中各种类型对象的基类。还有一个Group基类用来简单的容纳sprites。一个游戏可以创建新的Group类用来操作它们包含的特殊的Sprite对象。 | sprite模块也是非常通用的。你可以用它进行几乎任何类型的游戏开发。灵活性总是要有代价的，要正确使用它需要对它有一些了解。sprite模块的参考文档可以让你把它用起来，但是对于怎么在你的游戏里面使用pygame.sprite还需要更多的解释。 |
| 行号 9: | 行号 9: |
| 基本的Sprite类可以把它包含的Sprite画到Surface上。Group.draw方法需要每个Sprite都有一个Sprite.image属性和一个Sprite.rect属性。Group.clear方法需要相同的属性，可以用于删除所有的Sprite。还有更高级的Group：pygame.sprite.RenderUpdates可以跟踪图像脏的部分（需要更新的部分），pygame.sprite.OrderedUpdates可以以叠加顺序画Sprites。 | 一些pygame的例子（像"chimp"和"aliens"）已经开始使用sprite模块了。你可能要先看一下那些例子，来了解sprite模块是做什么的。chimp模块甚至有他自己每一行代码的解释，这样可以帮助你更好地了解用Python和pygame来编程。 |
| 行号 11: | 行号 11: |
| 最后，这个模块还包含几个碰撞检测函数。这些函数帮助我们找到多个Group里面的Sprite有哪些是相交的。要找到碰撞，Sprite必须有一个rect属性。 | 注意，本文假设你已经了解python编程，并且对于创建一个简单游戏的各种部分已经有一点了解。在本文里面，引用这个词很少使用。这代表一个Python的变量。变量在python里面就是引用，因此你可以有好几个变量都指向同一个对象。 == 历史知识 == sprite这个词，是从很老的计算机和游戏机上遗留下来的。这些老的机器不能够像游戏里需要的那样很快的画图形和删除图形。对于像游戏里那些变化很快的对象，这些机器需要一个特别的硬件去处理。这些对象叫做sprites，并且对它们有一些特殊的限制，但是可以把它们很快的画出来以及很快的更新它们。它们通常被存在视频里面一个特殊的层的缓存上。现在计算机已经够快，从而不需要特别的硬件去处理sprite了。而sprite这个词仍然被用来表示2D游戏里面任何会动的东西。 |
| 行号 14: | 行号 18: |
| Group被设计成可以高效率的在里面添加和删除Sprite。它们允许快速测试一个sprite是否已经在一个group里面了。一个Sprite可以被包含在任意多个group里面。一个游戏可以使用一些Group来控制对象的显示，另外一些完全分开的group来控制交叉或者玩家运动。不用在Sprite的派生类中添加类型属性，可以把Sprites组织起来放在不同的group里面。这可以使以后查找Sprite更加容易。 | == 类 == |
| 行号 16: | 行号 20: |
| Sprite和Group的关系用add和remove方法管理起来。这些方法可以带一个或者多个对象。这些类的默认的初始化函数带一个或者多个对象作为成员。可以在group里反复添加或者删除同一个Sprite对象。 | sprite模块有两个主要的类。一个是Sprite，用作所有游戏对象的基类。这个类本身实际上什么事情也不作，它只是包含了一些可以帮助对象管理的函数。另一个类是Group，它是各种不同的Sprite对象的容器。实际上有几种不同类型的group类，比如说有些Group类可以把所有它包含的Sprite画出来。 |
| 行号 18: | 行号 22: |
| 虽然可以不需要从Sprite和AbstractGroup类继承而设计自己的sprite和group类，但是强烈建议你应该从它们继承。 | 这就是它所有的东西了。我们首先描述这些类每一个都是做什么的，然后再讨论如何正确的使用它们。 |
| 行号 20: | 行号 24: |
| Sprite类不是线程安全的。使用多线程时必须自己锁定它们。 | == Sprite类 == |
| 行号 22: | 行号 26: |
| 刚才提过，Sprite类是用作所有游戏对象的基类的。它本身几乎没有什么用处，因为它只包含几个函数来和各种Group类一起工作。Sprite保留了它自己属于哪个Group的信息。类的构造函数{{{__init__}}}可以用一个Group（或者多个Group的列表）作为参数，指明这个Sprite属于哪些Group。你还可以通过Sprite的add和remove方法来修改它属于哪些Group。还有一个groups方法，可以返回它现在属于的Group的列表。 | |
| 行号 23: | 行号 28: |
| == pygame.sprite.Sprite == 表示可见的游戏对象的简单基类 {{{ pygame.sprite.Sprite(*groups): return Sprite Sprite.update - 控制sprite的行为 Sprite.add - 把sprite添加到group里 Sprite.remove - 把sprite从group里面删除 Sprite.kill - 把srpite从所有group里面删除 Sprite.alive - 判断是否有个Group包含这个sprite Sprite.groups - 列出所有包含这个Sprite的Group }}} |
当使用你的Sprite类的时候，如果它属于某一个或者多个Group，则它被称为是"有效的"或者说是"活的"。当你把这个Sprite从所有的组里面删除时，pygame会清除这个对象（除非你其他地方还有引用这个对象）。kill方法把这个sprite从所有组里面删掉。这会完全删除这个Sprite对象（译注：这不完全正确）。如果你一些小游戏组合在一起，你有时候很难完全清除一个游戏对象。Sprite对象还有一个alive方法，如果Sprite对象还属于其他某个Group则返回True。 |
| 行号 35: | 行号 30: |
| 表示可见的游戏对象的简单基类。它的派生类需要覆盖Sprite.update方法，并给Sprite.image和Sprite.rect属性赋值。初始化函数可以带任意个Group对象作为它们的成员。 | == Group类 == |
| 行号 37: | 行号 32: |
| 当从Sprite派生时，记得在把Sprite添加到组中之前一定要调用基类的初始化函数。 | Group类只是一个简单的容器。和sprite类似，它也有add和remove方法，用来改变它所包含的Sprites。你可以给它的构造函数传一个Sprite或者一组Sprite作为一开始它所包含的sprite对象。 |
| 行号 39: | 行号 34: |
| === Sprite.update === 控制sprite行为的方法{{{ Sprite.update(*args): }}} 这个函数的默认实现什么都不做，它只是作为一个"钩子"让你可以去覆盖的。这个方法被Group.update调用，参数可以是你给的任意参数。 |
Group还有其他一些函数，比如empty用来删除group里面的所有对象，copy用来创建一个新的group，包含的Sprite成员和原来的一样。还有一个has方法可以快速判断一个sprite或者一组sprite是否在一个group里面。 |
| 行号 46: | 行号 36: |
| 如果不使用Group的update方法，那么就没有必要实现这个方法。 | 其他用的很多的函数还有sprites函数。它返回一个对象，遍历它可以访问Group所包含的所有Sprite对象。现在它返回的这个对象是Sprite的列表，以后可能会变成迭代子以提高性能。 |
| 行号 48: | 行号 38: |
| === Sprite.add === 把sprite添加到group里面{{{ Sprite.add(*groups): return None }}} 参数可以给定任意多个Group对象。Sprite会被添加到不包含它的Group里面去。 |
作为一种便捷途径，Group还有一个update方法，它会调用它所包含的所有Sprite的update方法，并且Group的update的参数会传给所有的Sprite的update方法。通常游戏里需要一个函数来更新游戏对象的状态。虽然通过Group.sprites方法调用每一个sprite的方法也是很容易的，但是它经常被用到，所以就被加入进来作为一种便捷方式。还要注意，Sprite基类有一个"dummy"（愚蠢的什么都不会作的）的update方法，可以带任何参数，却什么也不作。 |
| 行号 55: | 行号 40: |
| === Sprite.remove === 把sprite从groups里面删除{{{ Sprite.remove(*groups): return None }}} 可以指定任意多个Group作为参数。Sprite会从包含它的group里面删除。 === Sprite.kill === 把Sprite从所有的group里面删除{{{ Sprite.kill(): return None }}} Sprite会从所有包含它的Group里面删除。这个函数不会改变Sprite本身的任何状态。这个函数用了以后还可以继续使用这个Sprite对象，包括把它添加到Group里面。 === Sprite.alive === 判断是否有某个Group包含这个Sprite{{{ Sprite.alive(): return bool }}} 如果这个Sprite属于某个组或者多个组，这个函数返回True。 === Sprite.groups === 列出包含这个Sprite的所有Group{{{ Sprite.groups(): return group_list }}} 返回所有包含这个Sprite的Group == pygame.sprite.Group == 包含多个Sprite的容器类 {{{ pygame.sprite.Group(*sprites): return Group Group.sprites - 列出这个Group包含的所有Sprites Group.copy - 复制这个group Group.add - 把Sprite添加到这个group Group.remove - 把Sprite从group里面删除 Group.has - 判断这个Group是否包含一些Sprites Group.update - 调用所有包含的Sprite的update方法 Group.draw - 把Sprite图像画到Surface上 Group.clear - 用背景覆盖掉Sprite Group.empty - 删除Group包含的所有Sprite }}} Sprite对象的简单容器。这个类可以派生出包含更多特殊功能的类。构造函数可以带任意多个Sprite作为添加到Group里面的对象。Group支持下列标准的Python操作： {{{ in 判断一个Sprite是否在里面 len 获取包含的Sprite的个数 bool 判断这个Group是否包含了Sprite（或者是空的） iter 迭代包含的所有的Sprite }}} Group包含的Sprite没有排序，所以画Sprites或者迭代它们是没有一个确定的顺序的。 === Group.sprites === 列出这个Group包含的Sprites{{{ Group.sprites(): return sprite_list }}} 返回这个Group包含的所有Sprites的列表。你可以从这个group获得一个迭代子，但是你不能够迭代一个Group的同时并修改它。 === Group.copy === 复制Group{{{ Group.copy(): return Group }}} 创建一个新的Group，包含和原来的group完全相同的Sprites。如果有一个派生的Group类，新对象也会和原来的对象一样有相同的子类。这只能在派生累得构造函数和基类想同时实现。 === Group.add === 把Sprites添加到这个Group里面{{{ Group.add(*sprites): return None }}} 添加任意多个Sprite到这个Group中。这个函数只会添加Group里面原来没有的Sprite进来。 每个Sprite参数也可以是一个迭代Sprite的迭代子。 === Group.remove === 从group中删除Sprites{{{ Group.remove(*sprites): return None }}} 从Group中删除任意多个Sprites。这个操作只对Group里面存在的Sprite进行。 每个Sprite参数也可以是一个迭代Sprite的迭代子。 === Group.has === 判断这个Group是否包含一些Sprites{{{ Group.has(*sprites): return None }}} 如果Group包含所有给定的Sprites，则函数返回True。这个操作和in运算符差不多，但in只是判断一个Sprite是否在Group中。 每个Sprite参数也可以是一个迭代Sprite的迭代子。 === Group.update === 在包含的Sprites上调用update{{{ Group.update(*args): return None }}} 在包含的所有Sprites上调用update。Sprite基类有一个可以带任何参数并不作任何事情的update函数。传给Group.update的参数会每一个Sprite对象。 没有办法获得Sprite.update的返回值。 === Group.draw === 把Sprite图像复制到Surface上{{{ Group.draw(Surface): return None }}} 把包含的Sprites画到Surface上去。这个函数用到Sprite.image作为源Surface，并且用到Sprite.rect作为位置。 Group不保存Sprite的顺序信息，所以Sprite会以任意的顺序画出来。 === Group.clear === 用背景来覆盖Sprites{{{ Group.clear(Surface_dest, background): return None }}} 把Group.draw所画的Sprites擦掉。目标Surface上Sprite的区域会被backgroup上的所填充。 background通常是一个Surface图像，具有和目标Surface同样的大小。它也可以是回调函数，带两个参数：目标Surface和清除的区域。background回调函数在一次clear的过程中会被调用多次。 这是一个回调函数的例子，把Sprites清除为红色： {{{#!python def clear_callback(surf, rect): color = 255, 0, 0 surf.fill(color, rect) }}} === Group.empty === 去除所有的Sprite{{{ Group.empty(): return None }}} 去除这个Group包含的所有Sprites。 == pygame.sprite.RenderUpdates == 能够跟踪脏的区域（需要更新的区域）的Group类 {{{ pygame.sprite.RenderUpdates(*sprites): return RenderUpdates RenderUpdates.draw - 块复制Sprite图像，并跟踪改变的区域 }}} 这个类从pygame.sprite.Group继承。它包含一个扩展的draw函数，能够跟踪屏幕上改变的区域。 === RenderUpdates.draw === 块复制Sprite图像，并跟踪改变的区域{{{ RenderUpdates.draw(surface): return Rect_list }}} 把所有的Sprite画到surface上，和Group.draw一样。这个函数返回一组矩形，表示屏幕上被改变的区域。返回的改变区域也包括之前被Group.clear影响的区域。 返回的Rect列表应该传给pygame.display.update函数。这有助于提高软件显示模式下的游戏性能。这种更新的方法只在背景不会动的时候有效。 == pygame.sprite.OrderedUpdates == 可以按照叠加的顺序画图的RenderUpdates类{{{ pygame.sprite.OrderedUpdates(*spites): return OrderedUpdates }}} 这个类从pygame.sprite.RenderUpdates类继承。它按照Sprite添加的顺序，维护一个有序的Sprites列表。这使得从Group里添加和删除Sprites操作比普通的Group慢一点。 == pygame.sprite.GroupSingle == 仅包含一个Sprite的Group类{{{ pygame.sprite.GroupSingle(sprite=None): return GroupSingle }}} GroupSingle仅包含一个Sprite。当一个新的Sprite添加进去，老的就被删除了。 有一个特殊的属性GroupSingle.sprite，可以访问这个类包含的Sprite。如果Group是空的，那么它可能是None。也可以通过给这个属性被赋值而添加Sprite。 == pygame.sprite.spritecollide == 在一个Group里面找和另一个Sprite相交的Sprites{{{ pygame.sprite.spritecollide(sprite, group, dokill): return Sprite_list }}} 返回一个列表，包括Group里面所有和另一个Sprite相交的Sprites。是否相交通过比较Sprite.rect属性来确定。 dokill参数是一个布尔型的。如果设置成True，则所有相交的Sprite会从Group里面删除。 == pygame.sprite.groupcollide == 找到两个Group里面所有相交的Sprites{{{ pygame.sprite.groupcollide(group1, group2, dokill1, dokill2): return Sprite_dict }}} 这个函数会找到两个group里面所有相交的Sprites。是否相交通过比较Sprite.rect属性来确定。 group1里面的每一个Sprite会被添加到返回的字典里面，每一项的值是group2中相交的Sprites的列表。 两个dokill参数，哪一个是True，则对应的Group里面相交的Sprites会被删除。 == pygame.sprite.spritecollideany == 简单的测试一个Sprite是否和Group里面的任意一个Sprite相交{{{ pygame.sprite.spritecollideany(sprite, group): return bool }}}如果给定的Sprite和Group里面的某个Sprite相交，则返回True。是否相交通过比较Sprite.rect属性来确定。 这个碰撞检测比pygame.sprite.spritecollide更快，因为它要作的事情少一点。 |
最后，Group类有几个其他方法允许你使用python内置的len函数来获得它包含的Sprite的个数，还有一个bool运算符允许你像"if mygroup:"这样来检查group是否包含sprite。 |
Sprite模块介绍
Pygame 1.3版本开始有了一个新的模块pygame.sprite。这个模块由python写成，包括一些高级的管理游戏对象的类。充分利用这个模块，可以简化游戏对象的管理和绘制。sprite类是高度优化的，你的游戏如果用sprite模块很可能比不用还要快。
sprite模块也是非常通用的。你可以用它进行几乎任何类型的游戏开发。灵活性总是要有代价的，要正确使用它需要对它有一些了解。sprite模块的参考文档可以让你把它用起来，但是对于怎么在你的游戏里面使用pygame.sprite还需要更多的解释。
一些pygame的例子（像"chimp"和"aliens"）已经开始使用sprite模块了。你可能要先看一下那些例子，来了解sprite模块是做什么的。chimp模块甚至有他自己每一行代码的解释，这样可以帮助你更好地了解用Python和pygame来编程。
注意，本文假设你已经了解python编程，并且对于创建一个简单游戏的各种部分已经有一点了解。在本文里面，引用这个词很少使用。这代表一个Python的变量。变量在python里面就是引用，因此你可以有好几个变量都指向同一个对象。
1. 历史知识
sprite这个词，是从很老的计算机和游戏机上遗留下来的。这些老的机器不能够像游戏里需要的那样很快的画图形和删除图形。对于像游戏里那些变化很快的对象，这些机器需要一个特别的硬件去处理。这些对象叫做sprites，并且对它们有一些特殊的限制，但是可以把它们很快的画出来以及很快的更新它们。它们通常被存在视频里面一个特殊的层的缓存上。现在计算机已经够快，从而不需要特别的硬件去处理sprite了。而sprite这个词仍然被用来表示2D游戏里面任何会动的东西。
2. 类
sprite模块有两个主要的类。一个是Sprite，用作所有游戏对象的基类。这个类本身实际上什么事情也不作，它只是包含了一些可以帮助对象管理的函数。另一个类是Group，它是各种不同的Sprite对象的容器。实际上有几种不同类型的group类，比如说有些Group类可以把所有它包含的Sprite画出来。
这就是它所有的东西了。我们首先描述这些类每一个都是做什么的，然后再讨论如何正确的使用它们。
3. Sprite类
刚才提过，Sprite类是用作所有游戏对象的基类的。它本身几乎没有什么用处，因为它只包含几个函数来和各种Group类一起工作。Sprite保留了它自己属于哪个Group的信息。类的构造函数__init__可以用一个Group（或者多个Group的列表）作为参数，指明这个Sprite属于哪些Group。你还可以通过Sprite的add和remove方法来修改它属于哪些Group。还有一个groups方法，可以返回它现在属于的Group的列表。
当使用你的Sprite类的时候，如果它属于某一个或者多个Group，则它被称为是"有效的"或者说是"活的"。当你把这个Sprite从所有的组里面删除时，pygame会清除这个对象（除非你其他地方还有引用这个对象）。kill方法把这个sprite从所有组里面删掉。这会完全删除这个Sprite对象（译注：这不完全正确）。如果你一些小游戏组合在一起，你有时候很难完全清除一个游戏对象。Sprite对象还有一个alive方法，如果Sprite对象还属于其他某个Group则返回True。
4. Group类
Group类只是一个简单的容器。和sprite类似，它也有add和remove方法，用来改变它所包含的Sprites。你可以给它的构造函数传一个Sprite或者一组Sprite作为一开始它所包含的sprite对象。
Group还有其他一些函数，比如empty用来删除group里面的所有对象，copy用来创建一个新的group，包含的Sprite成员和原来的一样。还有一个has方法可以快速判断一个sprite或者一组sprite是否在一个group里面。
其他用的很多的函数还有sprites函数。它返回一个对象，遍历它可以访问Group所包含的所有Sprite对象。现在它返回的这个对象是Sprite的列表，以后可能会变成迭代子以提高性能。
作为一种便捷途径，Group还有一个update方法，它会调用它所包含的所有Sprite的update方法，并且Group的update的参数会传给所有的Sprite的update方法。通常游戏里需要一个函数来更新游戏对象的状态。虽然通过Group.sprites方法调用每一个sprite的方法也是很容易的，但是它经常被用到，所以就被加入进来作为一种便捷方式。还要注意，Sprite基类有一个"dummy"（愚蠢的什么都不会作的）的update方法，可以带任何参数，却什么也不作。
最后，Group类有几个其他方法允许你使用python内置的len函数来获得它包含的Sprite的个数，还有一个bool运算符允许你像"if mygroup:"这样来检查group是否包含sprite。
= The end =