1 """ Scene utilities. """
7 """ Decorator that applies events to an engine. """
9 def wrap(self, *args, **kw):
10 events = f(self, *args, **kw)
11 self._apply_events(events)
16 """ A holder for game state & scene management.
19 def __init__(self, app, scene, world):
24 def _apply_events(self, events):
30 def change_scene(self, scene):
31 self._apply_events(self._scene.exit(self._world.proxy()))
33 self._apply_events(self._scene.enter(self._world.proxy()))
35 def change_world(self, *args, **kw):
36 self._world.apply_event(*args, **kw)
39 from pgzero.game import exit
42 def move_screen(self, offset):
43 self._scene.move_screen(offset)
47 return self._scene.update(self._world.proxy(), self, dt)
50 self._scene.draw(self._app.screen)
53 def on_mouse_down(self, pos, button):
54 return self._scene.on_mouse_down(pos, button)
57 def on_mouse_up(self, pos, button):
58 return self._scene.on_mouse_up(pos, button)
61 def on_key_down(self, key, mod, unicode):
62 return self._scene.on_key_down(key, mod, unicode)
65 def on_key_up(self, key, mod):
66 return self._scene.on_key_up(key, mod)
69 def on_music_end(self):
70 return self._scene.on_music_end()
74 """ Base class for events. """
76 ENGINE_METHOD = "unknown_event"
78 def __init__(self, *args, **kw):
82 def apply(self, engine):
83 getattr(engine, self.ENGINE_METHOD)(*self._args, **self._kw)
86 class ChangeSceneEvent(Event):
87 """ Change to a new scene. """
89 ENGINE_METHOD = "change_scene"
92 class WorldEvent(Event):
93 """ Be a hero. Change the world. """
95 ENGINE_METHOD = "change_world"
98 class QuitEvent(Event):
99 """ Quit the game. """
101 ENGINE_METHOD = "quit_game"
104 class MoveViewportEvent(Event):
105 """ Change to a new scene. """
107 ENGINE_METHOD = "move_screen"
111 """ A single layer of actors. """
113 def __init__(self, name):
118 return iter(self.actors)
120 def __getitem__(self, i):
121 return self.actors[i]
124 return len(self.actors)
126 def add(self, actor):
127 self.actors.append(actor)
133 def remove(self, actor):
134 self.actors.remove(actor)
139 """ Layers of actors.
141 Actors may be rendered in different layers. Layers with lower levels
142 are rendered lower than layers with higher ones.
146 self._ordered_layers = []
148 self.add_layer("default", 0)
150 def __getattr__(self, name):
151 return self._layers[name]
153 def add_layer(self, name, level):
154 layer = self._layers[name] = Layer(name)
155 self._ordered_layers.append((level, name))
156 self._ordered_layers.sort()
159 def add(self, actor, layer="default"):
160 return self._layers[layer].add(actor)
162 def remove(self, actor, layer="default"):
163 return self._layers[layer].remove(actor)
165 def draw(self, screen):
166 for lvl, name in self._ordered_layers:
167 for actor in self._layers[name]:
168 # actor.draw doesn't allow blitting to anything other than
170 screen.blit(actor._surf, actor.topleft)
174 """ Base class for scenes. """
177 self.actors = Actors()
178 self.viewport = (0, 0)
180 def move_screen(self, offset):
181 self.viewport = (self.viewport[0] + offset[0],
182 self.viewport[1] + offset[1])
184 def calc_offset(self, x, y):
185 """ Return a position offset by the viewport. """
186 return x - self.viewport[0], y - self.viewport[1]
188 def enter(self, world):
191 def exit(self, world):
194 def update(self, world, engine, dt):
197 def draw(self, screen):
199 self.actors.draw(screen)
201 def on_mouse_down(self, pos, button):
204 def on_mouse_up(self, pos, button):
207 def on_key_down(self, key, mod, unicode):
210 def on_key_up(self, key, mod):
213 def on_music_end(self):