ҲXc@sdZddlZddlmZddlmZddlmZdeekr`dZ nyddl m Z WnnXd e fd YZ d e fd YZd e fdYZdefdYZeZeZdefdYZdefdYZdefdYZdefdYZdefdYZdZdfdYZdZde fd YZd!Zed"Zed#Zed$Z dS(%s pygame module with basic game object classes This module contains several simple classes to be used within games. There are the main Sprite class and several Group classes that contain Sprites. The use of these classes is entirely optional when using Pygame. The classes are fairly lightweight and only provide a starting place for the code that is common to most games. The Sprite class is intended to be used as a base class for the different types of objects in the game. There is also a base Group class that simply stores sprites. A game could create new types of Group classes that operate on specially customized Sprite instances they contain. The basic Sprite class can draw the Sprites it contains to a Surface. The Group.draw() method requires that each Sprite have a Surface.image attribute and a Surface.rect. The Group.clear() method requires these same attributes and can be used to erase all the Sprites with background. There are also more advanced Groups: pygame.sprite.RenderUpdates() and pygame.sprite.OrderedUpdates(). Lastly, this module contains several collision functions. These help find sprites inside multiple groups that have intersecting bounding rectangles. To find the collisions, the Sprites are required to have a Surface.rect attribute assigned. The groups are designed for high efficiency in removing and adding Sprites to them. They also allow cheap testing to see if a Sprite already exists in a Group. A given Sprite can exist in any number of groups. A game could use some groups to control object rendering, and a completely separate set of groups to control interaction or player movement. Instead of adding type attributes or bools to a derived Sprite class, consider keeping the Sprites inside organized Groups. This will allow for easier lookup later in the game. Sprites and Groups manage their relationships with the add() and remove() methods. These methods can accept a single or multiple group arguments for membership. The default initializers for these classes also take a single group or list of groups as argments for initial membership. It is safe to repeatedly add and remove the same Sprite from a Group. While it is possible to design sprite and group classes that don't derive from the Sprite and AbstractGroup classes below, it is strongly recommended that you extend those when you create a new Sprite or Group class. Sprites are not thread safe, so lock them yourself if using threads. iN(tRect(t get_ticks(ttruthtcallablecCs t|dS(Nt__call__(thasattr(tobj((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pytas(t from_surfacetSpritecBsheZdZdZdZdZdZdZdZdZ dZ d Z d Z RS( ssimple base class for visible game objects pygame.sprite.Sprite(*groups): return Sprite The base class for visible game objects. Derived classes will want to override the Sprite.update() method and assign Sprite.image and Sprite.rect attributes. The initializer can accept any number of Group instances that the Sprite will become a member of. When subclassing the Sprite class, be sure to call the base initializer before adding the Sprite to Groups. cGs#i|_|r|j|ndS(N(t _Sprite__gtadd(tselftgroups((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyt__init__ys cGsi|jj}xV|D]N}t|drT||sa|j||j|qaq|j|qWdS(sadd the sprite to groups Sprite.add(*groups): return None Any number of Group instances can be passed as arguments. The Sprite will be added to the Groups it is not already a member of. t _spritegroupN(R t __contains__Rt add_internalR (R R thastgroup((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR ~s    cGsi|jj}xV|D]N}t|drT||ra|j||j|qaq|j|qWdS(sremove the sprite from groups Sprite.remove(*groups): return None Any number of Group instances can be passed as arguments. The Sprite will be removed from the Groups it is currently a member of. RN(R RRtremove_internaltremove(R R RR((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRs    cCsd|j|(t __class__t__name__tlenR (R ((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyt__repr__s( Rt __module__t__doc__RR RRRRRR RR (((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR js         t DirtySpritecBsMeZdZdZdZdZeddddZdZRS( s$a more featureful subclass of Sprite with more attributes pygame.sprite.DirtySprite(*groups): return DirtySprite Extra DirtySprite attributes with their default values: dirty = 1 If set to 1, it is repainted and then set to 0 again. If set to 2, it is always dirty (repainted each frame; flag is not reset). If set to 0, it is not dirty and therefore not repainted again. blendmode = 0 It's the special_flags argument of Surface.blit; see the blendmodes in the Surface.blit documentation source_rect = None This is the source rect to use. Remember that it is relative to the top left corner (0, 0) of self.image. visible = 1 Normally this is 1. If set to 0, it will not be repainted. (If you change visible to 1, you must set dirty to 1 for it to be erased from the screen.) _layer = 0 A READ ONLY value, it is read when adding it to the LayeredUpdates group. For details see documentation of sprite.LayeredUpdates. cGsAd|_d|_d|_d|_d|_tj||dS(Nii(tdirtyt blendmodet_visiblet_layertNonet source_rectR R(R R ((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRs      cCs(||_|jdkr$d|_ndS(s9set the visible value (0 or 1) and makes the sprite dirtyiiN(R&R$(R tval((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyt _set_visibles cCs|jS(s'return the visible value of that sprite(R&(R ((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyt _get_visible scCs |jS(N(R,(R ((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRscCs |j|S(N(R+(R tvalue((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRstdocsoyou can make this sprite disappear without removing it from the group, assign 0 for invisible and 1 for visiblecCs d|jjt|jfS(Ns<%s DirtySprite(in %d groups)>(RRRR (R ((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR s( RR!R"RR+R,tpropertytvisibleR (((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR#s     t AbstractGroupcBseZdZeZdZdZdZdZdZ dZ dZ dZ d Z d Zd Zd Zd ZdZdZdZdZdZRS(sTbase class for containers of sprites AbstractGroup does everything needed to behave as a normal group. You can easily subclass a new group class from this or the other groups below if you want to add more features. Any AbstractGroup-derived sprite groups act like sequences and support iteration, len, and so on. cCsi|_g|_dS(N(t spritedictt lostsprites(R ((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR+s cCs t|jS(s}get a list of sprites in the group Group.sprite(): return list Returns an object that can be looped over with a 'for' loop. (For now, it is always a list, but this could change in a future version of pygame.) Alternatively, you can get the same information by iterating directly over the sprite group, e.g. 'for sprite in group'. (RR2(R ((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pytsprites/s cCsd|j|RR4(R R4R5R?((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR|s     cGst}x|D]}t|trA|j|r:t}qtSq y |j|r\t}ntSWq ttfk rt|drxO|j D]"}|j|rt}qtSqWq|j|rt}qtSq Xq W|S(s;ask if group has a sprite or sprites Group.has(sprite or group, ...): return bool Returns True if the given sprite or sprites are contained in the group. Alternatively, you can get the same information using the 'in' operator, e.g. 'sprite in group', 'subgroup in group'. R( tFalseR<R R8tTrueRR=R>RR4(R R4t return_valueR5R?((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRs(        cGs(x!|jD]}|j|q WdS(scall the update method of every member sprite Group.update(*args): return None Calls the update method of every member sprite. All arguments that were passed to this method are passed to the Sprite update function. N(R4R(R Rts((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRs cCsO|j}|j}x*|D]"}||j|j|j|(RRR(R ((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR s(RR!R"RARRR4RRR8R9R;RR RRRRIRRLRMRNR (((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR1s(        # (    tGroupcBseZdZdZRS(scontainer class for many Sprites pygame.sprite.Group(*sprites): return Group A simple container for Sprite objects. This class can be subclassed to create containers with more specific behaviors. The constructor takes any number of Sprite arguments to add to the Group. The group supports the following standard Python operations: in test if a Sprite is contained len the number of Sprites contained bool test if any Sprites are contained iter iterate through all the Sprites The Sprites in the Group are not ordered, so the Sprites are drawn and iterated over in no particular order. cGstj||j|dS(N(R1RR (R R4((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR&s (RR!R"R(((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyROst RenderUpdatescBseZdZdZRS(sGroup class that tracks dirty updates pygame.sprite.RenderUpdates(*sprites): return RenderUpdates This class is derived from pygame.sprite.Group(). It has an enhanced draw method that tracks the changed areas of the screen. c Cs|j}|j}|j}g|_|j}x|jD]{}||}||j|j}|r|j|r||j|q||||n |||||R[RRVRYRtinsert( R R5tlayerR4tsprites_layerstlengtlowtmidthigh((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRs,           #cOs4|s dSd|kr#|d}nd}x|D]}t|trw|j|s,|j|||j|q,q0y|j||Wq0ttfk r+t|drxu|j D]5}|j|s|j|||j|qqWq,|j|s,|j|||j|q,q0Xq0WdS(sadd a sprite or sequence of sprites to a group LayeredUpdates.add(*sprites, **kwargs): return None If the sprite you add has an attribute _layer, then that layer will be used. If **kwarg contains 'layer', then the passed sprites will be added to that layer (overriding the sprite._layer attribute). If neither the sprite nor **kwarg has a 'layer', then the default layer is used to add the sprites. NR_R( R(R<R R8RR R=R>RR4(R R4R\R_R5R?((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR s*    cCs||jj||j|}||jk r?|jj|nt|drd|jj|jn|j|=|j|=dS(sVDo not use this method directly. The group uses it to add a sprite. RFN( RVRR2R]R3R6RRFRY(R R5R7((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRs  cCs t|jS(streturn a ordered list of sprites (first back, last top). LayeredUpdates.sprites(): return sprites (RRV(R ((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyR4sc Cs|j}|j}|j}g|_|j}|j}x|jD]}||}||j|j} ||kr|| n9| j|r|| j |n|| ||| ||R<R#R=R$RWR(R R5R_((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRs     c Cs|j}|j}|dkr*|}n|}|j}|j}|j}|j} d} |j} t} |dk r||_ n|j } |j }|j |t }|j r`xC|D];}d|jkr|jr| |jj|jj}n| |j}|j}|j}||}x1d|krU|||||=||}q%W| |j||||k r| ||}|j}|j}||}x1d|kr|||||=||}qW| |j|qqqW| dk r(x!|D]}| | ||q Wnx&|D]}d|jkr|jrM|j}|jdk rt|jj|jj}n|j}xo|j|D][}|||}| |j||d|d|d|d|d|df|jqWqMq/|jr2| |j|j|j|j||RREtoverlap(RRtxoffsettyoffsettleftmaskt rightmask((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyt collide_masks    cCs |rg}|j}|r[x|jD],}|||r(|j||q(q(WnI|jj}x:|jD],}||jrt|j||qtqtW|S|rg|D]}|||r|^qS|jj}g|D]}||jr|^qSdS(s-find Sprites in a Group that intersect another Sprite pygame.sprite.spritecollide(sprite, group, dokill, collided=None): return Sprite_list Return a list containing all Sprites in a Group that intersect with another Sprite. Intersection is determined by comparing the Sprite.rect attribute of each Sprite. The dokill argument is a bool. If set to True, all Sprites that collide will be removed from the Group. The collided argument is a callback function used to calculate if two sprites are colliding. it should take two sprites as values, and return a bool value indicating if they are colliding. If collided is not passed, all sprites must have a "rect" value, which is a rectangle of the sprite area, which will be used to calculate the collision. N(R6R4RRFRQ(R5RtdokilltcollidedtcrashedR6RCt spritecollide((s?c:\mingw\msys\1.0\newbuild\install\python\pygame_sdl2\sprite.pyRs$    & c Csi}t}|r^x|jD]8}|||||}|r|||<|jqqWn9x6|D].}|||||}|re|||Cs>  s?P@ 0 *@  . !