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):
23 self._viewport = (0, 0)
25 def _apply_events(self, events):
31 def change_scene(self, scene):
32 self._apply_events(self._scene.exit(self._world.proxy()))
34 self._apply_events(self._scene.enter(self._world.proxy()))
36 def change_world(self, *args, **kw):
37 self._world.apply_event(*args, **kw)
40 from pgzero.game import exit
43 def move_screen(self, offset):
44 self._viewport = (self._viewport[0] + offset[0],
45 self._viewport[1] + offset[1])
47 def calc_offset(self, x, y):
48 """Return a position offset by the viewport"""
49 return x - self._viewport[0], y - self._viewport[1]
53 return self._scene.update(self._world.proxy(), self, dt)
56 self._scene.draw(self._app.screen, self._viewport)
59 def on_mouse_down(self, pos, button):
60 return self._scene.on_mouse_down(pos, button)
63 def on_mouse_up(self, pos, button):
64 return self._scene.on_mouse_up(pos, button)
67 def on_key_down(self, key, mod, unicode):
68 return self._scene.on_key_down(key, mod, unicode)
71 def on_key_up(self, key, mod):
72 return self._scene.on_key_up(key, mod)
75 def on_music_end(self):
76 return self._scene.on_music_end()
80 """ Base class for events. """
82 ENGINE_METHOD = "unknown_event"
84 def __init__(self, *args, **kw):
88 def apply(self, engine):
89 getattr(engine, self.ENGINE_METHOD)(*self._args, **self._kw)
92 class ChangeSceneEvent(Event):
93 """ Change to a new scene. """
95 ENGINE_METHOD = "change_scene"
98 class WorldEvent(Event):
99 """ Be a hero. Change the world. """
101 ENGINE_METHOD = "change_world"
104 class QuitEvent(Event):
105 """ Quit the game. """
107 ENGINE_METHOD = "quit_game"
110 class MoveViewportEvent(Event):
111 """ Change to a new scene. """
113 ENGINE_METHOD = "move_screen"
117 """ A single layer of actors. """
119 def __init__(self, name):
124 return iter(self.actors)
126 def __getitem__(self, i):
127 return self.actors[i]
130 return len(self.actors)
132 def add(self, actor):
133 self.actors.append(actor)
139 def remove(self, actor):
140 self.actors.remove(actor)
145 """ Layers of actors.
147 Actors may be rendered in different layers. Layers with lower levels
148 are rendered lower than layers with higher ones.
152 self._ordered_layers = []
154 self.add_layer("default", 0)
156 def __getattr__(self, name):
157 return self._layers[name]
159 def add_layer(self, name, level):
160 layer = self._layers[name] = Layer(name)
161 self._ordered_layers.append((level, name))
162 self._ordered_layers.sort()
165 def add(self, actor, layer="default"):
166 return self._layers[layer].add(actor)
168 def remove(self, actor, layer="default"):
169 return self._layers[layer].remove(actor)
171 def draw(self, screen):
172 for lvl, name in self._ordered_layers:
173 for actor in self._layers[name]:
174 actor.draw() # TODO: allow an option screen to be passed in
178 """ Base class for scenes. """
181 self.actors = Actors()
183 def enter(self, world):
186 def exit(self, world):
189 def update(self, world, engine, dt):
192 def draw(self, screen, viewport):
194 self.actors.draw(screen)
196 def on_mouse_down(self, pos, button):
199 def on_mouse_up(self, pos, button):
202 def on_key_down(self, key, mod, unicode):
205 def on_key_up(self, key, mod):
208 def on_music_end(self):