|
大小: 11411
备注:
|
大小: 5400
备注:
|
| 删除的内容标记成这样。 | 加入的内容标记成这样。 |
| 行号 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类 == 刚才提过，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。 == Group类 == Group类只是一个简单的容器。和sprite类似，它也有add和remove方法，用来改变它所包含的Sprites。你可以给它的构造函数传一个Sprite或者一组 The Group class is just a simple container. Similar to the sprite, it has an add() and remove() method which can change which sprites belong to the group. You also can pass a sprite or list of sprites to the contructor (__init__ method) to create a Group instance that contains some initial sprites. The Group has a few other methods like empty() to remove all sprites from the group and copy() which will return a copy of the group with all the same members. Also the has() method will quickly check if the Group contains a sprite or list of sprites. The other function you will use frequently is the sprites() method. This returns an object that can be looped on to access every sprite the group contains. Currently this is just a list of the sprites, but in later version of python this will likely use iterators for better performance. As a shortcut, the Group also has an update() method, which will call an update() method on every sprite in the group. Passing the same arguments to each one. Usually in a game you need some function that updates the state of a game object. It's very easy to call your own methods using the Group.sprites() method, but this is a shortcut that's used enough to be included. Also note that the base Sprite class has a "dummy" update() method that takes any sort of arguments and does nothing. Lastly, the Group has a couple other methods that allow you to use it with the builtlin len() method, getting the number of sprites it contains. and the "truth" operator, which allows you to do "if mygroup:" to check if the group has any sprites. |
| 行号 23: | 行号 45: |
| == 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.update方法，并给Sprite.image和Sprite.rect属性赋值。初始化函数可以带任意个Group对象作为它们的成员。 当从Sprite派生时，记得在把Sprite添加到组中之前一定要调用基类的初始化函数。 === Sprite.update === 控制sprite行为的方法{{{ Sprite.update(*args): }}} 这个函数的默认实现什么都不做，它只是作为一个"钩子"让你可以去覆盖的。这个方法被Group.update调用，参数可以是你给的任意参数。 如果不使用Group的update方法，那么就没有必要实现这个方法。 === Sprite.add === 把sprite添加到group里面{{{ Sprite.add(*groups): return None }}} 参数可以给定任意多个Group对象。Sprite会被添加到不包含它的Group里面去。 === 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 |
|
| 行号 85: | 行号 47: |
| == 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更快，因为它要作的事情少一点。 |
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或者一组
The Group class is just a simple container. Similar to the sprite, it has an add() and remove() method which can change which sprites belong to the group. You also can pass a sprite or list of sprites to the contructor (init method) to create a Group instance that contains some initial sprites.
The Group has a few other methods like empty() to remove all sprites from the group and copy() which will return a copy of the group with all the same members. Also the has() method will quickly check if the Group contains a sprite or list of sprites.
The other function you will use frequently is the sprites() method. This returns an object that can be looped on to access every sprite the group contains. Currently this is just a list of the sprites, but in later version of python this will likely use iterators for better performance.
As a shortcut, the Group also has an update() method, which will call an update() method on every sprite in the group. Passing the same arguments to each one. Usually in a game you need some function that updates the state of a game object. It's very easy to call your own methods using the Group.sprites() method, but this is a shortcut that's used enough to be included. Also note that the base Sprite class has a "dummy" update() method that takes any sort of arguments and does nothing.
Lastly, the Group has a couple other methods that allow you to use it with the builtlin len() method, getting the number of sprites it contains. and the "truth" operator, which allows you to do "if mygroup:" to check if the group has any sprites.
= The end =