Drift around the rim and catch seeds to grow flowers.
-Either player can hold A to slow the shared flow.
+Either player can hold A to slow the shared seed flow.
Passing seeds do no harm. Watching is welcome.
Inspired by Dream No Return
+
Drift around the rim and catch seeds to grow flowers.
-Either player can hold A to slow the shared flow.
+Either player can hold A to slow the shared seed flow.
Passing seeds do no harm. Watching is welcome.
Inspired by Dream No Return
+
+
+
+Dreamers, seeds, flowers and garden details.
+Dreamers and flowers below. Clouds and seeds above.
Notes: -**8:45–9:30.** Show the original artwork sheet before explaining its runtime format. The top row has four pink poses and the same four poses in mint for player two. Below are four seed frames, four flower species with two frames each, and eight sparse garden details. The source atlas was generated for this game and is included in the download. The preparation script crops its cells, corrects the leaning pose order, resizes them with nearest-neighbour sampling, makes alpha binary and packs horizontal strips. The dreamers become 19 × 19 pixel frames. Keep the artwork legible at that final size, especially on the moving physical display. +**7:45–8:30.** Show the original artwork sheet before explaining its runtime format. The top row has four pink poses and the same four poses in mint for player two. Below are four seed frames, four flower species with two frames each, and eight sparse garden details. The source atlas was generated for this game and is included in the download. The preparation script crops its cells, corrects the leaning pose order, resizes them with nearest-neighbour sampling, makes alpha binary and packs horizontal strips. The fourth row is unused in this experiment; a separate six-cloud atlas supplies the flying layer. The dreamers become 19 × 19 pixel frames. Keep the artwork legible at that final size, especially on the moving physical display. -Source: [Artwork provenance and preparation](examples/artwork.html). Image: Dream Garden's original `sources/source-atlas.png`, included unchanged. +Source: [Artwork provenance and preparation](examples/artwork.html). Images: Dream Garden's original source and cloud atlases, included unchanged. --- @@ -187,7 +190,7 @@ Source: [Artwork provenance and preparation](examples/artwork.html). Image: Drea Notes: -**9:30–10:30.** The console uses compiled strips rather than decoding PNGs during play. The full dreamer strip has eight 19-pixel frames, so it is 152 pixels wide. The picture shows its first four poses. The next four repeat those poses in mint for player two. YAML declares all eight frames. Related art shares a palette group. The full game adds seed, flower and garden strips plus the existing CP437 font in a separate text palette. You can replace the packed PNGs with your own pixel art. Rerun the emulator after editing assets. Use the Run this checkpoint button to open this stage in the browser; it contains only the features covered so far. +**8:30–9:30.** The console uses compiled strips rather than decoding PNGs during play. The full dreamer strip has eight 19-pixel frames, so it is 152 pixels wide. The picture shows its first four poses. The next four repeat those poses in mint for player two. YAML declares all eight frames. Related art shares a palette group. The full game adds seed.png (4 frames), flowers.png (8), clouds.png (18) in its own palette group, and steel8x8.png (256) in a text palette. Add these entries to __images__.yaml as you introduce each asset. The download includes the complete YAML. You can replace the packed PNGs with your own pixel art. Rerun the emulator after editing assets. Use the Run this checkpoint button to open this stage in the browser; it contains only the features covered so far. Sources: [Image setup](../../docs/vs2/tutorial/first-game.html), [artwork provenance and preparation](examples/artwork.html). Image: the actual packed dreamer strip, cropped to player one's poses. @@ -206,7 +209,7 @@ Sources: [Image setup](../../docs/vs2/tutorial/first-game.html), [artwork proven Notes: -**10:30–12:15.** This is the main architectural rule. Create layers, sprites, pools, tilemaps and labels in `build()`. Returning from build seals the scene. Update can move, animate, show and hide them, but creating a new sprite there raises `SceneSealedError`. Structural budgets fail at scene entry rather than in the middle of a run. Build runs again whenever the scene is re-entered, and previous drawable handles are no longer valid. State that should survive belongs in `__init__`. A nominal tick is 30 milliseconds, about 33 updates per second. Slow updates delay the next tick rather than catching up lost time. +**9:30–11:15.** This is the main architectural rule. Create layers, sprites, pools, tilemaps and labels in `build()`. Returning from build seals the scene. Update can move, animate, show and hide them, but creating a new sprite there raises `SceneSealedError`. Structural budgets fail at scene entry rather than in the middle of a run. Build runs again whenever the scene is re-entered, and previous drawable handles are no longer valid. State that should survive belongs in `__init__`. A nominal tick is 30 milliseconds, about 33 updates per second. Slow updates delay the next tick rather than catching up lost time. Sources and diagram: [Scene lifecycle](../../docs/vs2/reference/scene.html), [runtime constraints](../../docs/vs2/tutorial/index.html). @@ -237,7 +240,7 @@ def main(): ``` Notes: -**12:15–13:45.** Read this as an engine interface rather than a Python lesson. Main returns the first scene. Build creates a TUNNEL layer and a sprite by image name. X is the sprite's edge, so subtracting half its width centres the dreamer on angle zero. Update reads stable controller levels. Left minus right gives a direction and cancels opposite inputs. Wrapping keeps the stored X bounded, and the renderer also handles images crossing the seam. This is complete code once the folder, assets and metadata exist. The download has a short docstring with installation instructions. Use the Run this checkpoint button to open this stage in the browser; it contains only the features covered so far. +**11:15–12:45.** Read this as an engine interface rather than a Python lesson. Main returns the first scene. Build creates a TUNNEL layer and a sprite by image name. X is the sprite's edge, so subtracting half its width centres the dreamer on angle zero. Update reads stable controller levels. Left minus right gives a direction and cancels opposite inputs. Wrapping keeps the stored X bounded, and the renderer also handles images crossing the seam. This is complete code once the folder, assets and metadata exist. The download has a short docstring with installation instructions. Use the Run this checkpoint button to open this stage in the browser; it contains only the features covered so far. Sources: [First game](../../docs/vs2/tutorial/first-game.html), [circular display](../../docs/vs2/tutorial/display.html), [starter code](examples/first_game.py). @@ -260,9 +263,9 @@ Sources: [First game](../../docs/vs2/tutorial/first-game.html), [circular displa Notes: -**13:45–15:00.** Switch to the prepared desktop starter. Hold left, cross the seam, then hold right. Show that opposite buttons cancel. Point out the terminal and source file, then return to the deck. The goal is to make the circular coordinate model tangible before adding rules. If the emulator is unavailable, use this real renderer capture and trace the position change aloud. It shows only the starter's one sprite. Use the Run this checkpoint button to open this stage in the browser; it contains only the features covered so far. +**12:45–14:00.** Switch to the prepared desktop starter. Hold left, cross the seam, then hold right. Show that opposite buttons cancel. Point out the terminal and source file, then return to the deck. The goal is to make the circular coordinate model tangible before adding rules. If the emulator is unavailable, use this real renderer capture and trace the position change aloud. It shows only the starter's one sprite. Use the Run this checkpoint button to open this stage in the browser; it contains only the features covered so far. -Sources: [Starter source](examples/first_game.py), [first-game instructions](../../docs/vs2/tutorial/first-game.html). Screenshot: actual game assets through the SDK renderer, with all other game drawables hidden. +Sources: [Starter source](examples/first_game.py), [first-game instructions](../../docs/vs2/tutorial/first-game.html). Screenshot: actual game assets through the emulator’s WebGL display backend, running the actual steering checkpoint. --- @@ -275,7 +278,7 @@ Sources: [Starter source](examples/first_game.py), [first-game instructions](../ Notes: -**15:00–16:15.** This is the main mental adjustment for developers used to rectangular screens. The logical display has 256 angular columns and 54 radial LEDs. X zero is the bottom, then 64 is left, 128 top, and 192 right. X wraps. Y zero is the outer rim, and positive Y goes inward. A sprite crossing the angular seam stays continuous. The physical width of an angular column decreases near the centre, so a rectangular image gets squeezed there. Use `vs2.display.width` and `.height` to read the geometry, but distinguish physical LED height from tunnel depth on the next slide. +**14:00–15:15.** This is the main mental adjustment for developers used to rectangular screens. The logical display has 256 angular columns and 54 radial LEDs. X zero is the bottom, then 64 is left, 128 top, and 192 right. X wraps. Y zero is the outer rim, and positive Y goes inward. A sprite crossing the angular seam stays continuous. The physical width of an angular column decreases near the centre, so a rectangular image gets squeezed there. Use `vs2.display.width` and `.height` to read the geometry, but distinguish physical LED height from tunnel depth on the next slide. Source and diagram: [The circular display](../../docs/vs2/tutorial/display.html). @@ -295,9 +298,9 @@ Source and diagram: [The circular display](../../docs/vs2/tutorial/display.html) Notes: -**16:15–17:45.** Choose a projection per layer. The finished Dream Garden uses two TUNNEL layers for the planted garden and flying objects, plus one HUD layer for text. These dreamers use Y values 0, 24 and 48 on TUNNEL above and HUD below. Decreasing tunnel depth moves a seed outward toward the players. HUD removes perspective scaling, though angular cells still narrow near the centre. FULLSCREEN draws a centred image whose X rotates it and whose Y follows the tunnel depth curve. It accepts sprites only. Layers paint in creation order, then drawables in creation order inside each layer. The lower layer draws flowers then dreamers; the middle draws flying accents then seeds; the HUD draws last. Physical height 54 is not a tunnel off-screen threshold. +**15:15–16:45.** Choose a projection per layer. The finished Dream Garden uses two TUNNEL layers for the planted garden and flying objects, plus one HUD layer for text. These dreamers use Y values 0, 24 and 48 on TUNNEL above and HUD below. Decreasing tunnel depth moves a seed outward toward the players. HUD removes perspective scaling, though angular cells still narrow near the centre. FULLSCREEN draws a centred image whose X rotates it and whose Y follows the tunnel depth curve. It accepts sprites only. Layers paint in creation order, then drawables in creation order inside each layer. The lower layer draws flowers then dreamers; the middle draws clouds then seeds; the HUD draws last. Physical height 54 is not a tunnel off-screen threshold. -Source: [Projections and draw order](../../docs/vs2/tutorial/display.html). Image: actual dreamer assets in two SDK scene layers. +Source: [Projections and draw order](../../docs/vs2/tutorial/display.html). Image: actual dreamer assets in two scene layers through the emulator’s WebGL display backend. --- @@ -307,24 +310,26 @@ Source: [Projections and draw order](../../docs/vs2/tutorial/display.html). Imag Run this checkpoint -```python -direction = joy1.held(LEFT) - joy1.held(RIGHT) -self.dreamer.x = (self.dreamer.x + direction) % vs2.display.width - -if joy1.held(A): - self.dreamer.frame = ASLEEP +if sleeping:
+ dreamer.frame = ASLEEP
elif direction > 0:
- self.dreamer.frame = LEFT_POSE
+ dreamer.frame = LEFT_POSE
elif direction < 0:
- self.dreamer.frame = RIGHT_POSE
+ dreamer.frame = RIGHT_POSE
else:
- self.dreamer.frame = AWAKE
-```
-
-Player two uses the same poses, starting at frame 4.
+ dreamer.frame = AWAKEFrame changes reuse the same sprite.
+Flowers alternate between paired frames.
+Golden seeds wait a random interval, then run a short glow sequence.
+self.ground = world.tilemap(
- "garden.png",
- columns=16, rows=16,
+self.ground = self.air.tilemap(
+ "clouds.png",
+ columns=16, rows=22,
view_width=256,
view_height=160
)
-self.ground[1, 2] = vs2.EMPTY_TILE
-Sparse accents leave room for the seeds.
+# A large cloud uses frames 3–8 in a 3×2 block.
+self.ground[11, 4] = 3
+self.ground[12, 4] = 4
+# Reserve seeds after the clouds:
+self.seeds = self.air.sprite_pool("seed.png", count=16)1×1, 2×1 or 3×2 cells. Seeds draw above clouds.
+
slow = slow1 or slow2 # either active player
# Arm held-A after releasing the start press.
-self.speed = 0.12 if slow else 0.45
+self.speed = 0.12 if slow else 0.45 # seeds only
self.spawn_ms = 4000 if slow else 1800One request changes the shared world.
+Either player can relax the shared seed flow.
Notes:
-**31:00–31:45.** The final mechanic is deliberately small. Either player's request slows every seed, the background and flower animation. Spawn intervals adapt at the next scheduled callback. Steering stays responsive. Nothing raises the pace because of a score or elapsed time. For the festival, the interesting discussion is what this asks people to do together. They can catch seeds, make room for a friend, hold time slower or simply watch. Invite the audience to imagine another interaction with shared time. Use the Run this checkpoint button to open this stage in the browser; it contains only the features covered so far.
+**32:30–33:15.** The final mechanic is deliberately small. Either player's request slows every seed and lengthens future seed spawn gaps. Clouds and planted flowers retain their normal drift and animation; seeds remain above the clouds. Spawn intervals adapt at the next scheduled callback. Steering stays responsive. Nothing raises the pace because of a score or elapsed time. For the festival, the interesting discussion is what this asks people to do together. They can catch seeds, make room for a friend, hold time slower or simply watch. Invite the audience to imagine another interaction with shared time. Use the Run this checkpoint button to open this stage in the browser; it contains only the features covered so far.
-Source: [Garden update](examples/dream_garden.py). Screenshot: an actual held-A game state through the SDK renderer.
+Source: [Garden update](examples/dream_garden.py). Screenshot: an actual held-A game state through the emulator’s WebGL display backend.
---
-
+
## The display graph has explicit budgets
@@ -602,35 +678,12 @@ Source: [Garden update](examples/dream_garden.py). Screenshot: an actual held-A
Read the target limits from `vs2.limits`.
Notes:
-**31:45–33:15.** Forty-two sprites means two reserved dreamers, sixteen seeds and twenty-four flowers. Hidden player two and empty pool slots still count. The flying accents, RELAX label and audio notice use three tilemap records. The lower layer draws planted flowers then dreamers; the middle draws flying accents then seeds; the HUD paints above both. Five strips include the full font shared by the other scenes. Layers and records are separate resources. VS2 checks the graph at entry and reports the layers contributing to an exceeded budget. Tilemaps can be costly even when their record count is low. Random seed glow uses a small state entry per live seed, removed on retirement. Our bounded garden can run indefinitely without growing its renderer graph. Target timing and heap still need measurement on the console.
+**33:15–34:30.** Forty-two sprites means two reserved dreamers, sixteen seeds and twenty-four flowers. Hidden player two and empty pool slots still count. The cloud tilemap, RELAX label and audio notice use three tilemap records. The lower layer draws planted flowers then dreamers; the middle draws clouds then seeds; the HUD paints above both. Five strips include the full font shared by the other scenes. Layers and records are separate resources. VS2 checks the graph at entry and reports the layers contributing to an exceeded budget. Tilemaps can be costly even when their record count is low. Random seed glow uses a small state entry per live seed, removed on retirement. Our bounded garden can run indefinitely without growing its renderer graph. Target timing and heap still need measurement on the console.
Sources: [Resource limits](../../docs/vs2/reference/services.html#vs2-limits), [sample build](examples/dream_garden.py).
---
-
-
-## Heap stability is part of game correctness
-
-Run this checkpoint
-
-```python
-seed.y -= self.speed
-self.flowers.spawn(x=angle, y=player.y, frame=kind * 2)
-self.seeds.despawn(seed)
-```
-
-Sealing controls render-object creation, not every Python allocation.
-
-Long play still needs a target check.
-
-Notes:
-**33:15–34:30.** A garden that welcomes watching should survive a long session. Pools bound the renderer graph, but Python temporaries can still accumulate on the target. Garbage collection happens around scene boundaries, while the desktop emulator has more headroom and collects automatically. Keep the update loop short and reuse handles. The sample bounds scroll and dream_time and rewrites its mood label only on a state change. Each live seed has a bounded glow timer state, removed when it retires. It snapshots flower angles, depths and frames only when leaving for Rest. Those choices do not prove zero heap growth or sufficient hardware frame timing. Measure sustained play and the full garden on the rotor before an exhibition. The Run this checkpoint button opens the finished game in the browser.
-
-Sources: [Allocation and target checks](../../docs/vs2/tutorial/budgets.html), [sample source](examples/dream_garden.py).
-
----
-
## The disc decides what is readable
@@ -645,9 +698,9 @@ Sources: [Allocation and target checks](../../docs/vs2/tutorial/budgets.html), [
Notes:
-**34:30–36:00.** The emulator preserves renderer semantics, but cannot judge physical brightness or enforce the real output's column deadline. These copies of RELAX use HUD positions 1 and 35. The inner word compresses because angular cells have less circumference. Keep critical instructions near the rim and let the centre convey depth or drifting effects. Our leaves, blossoms and seeds are deliberately sparse. Test their contrast and recognizability on the real LEDs, along with a crowded garden and a sustained session. This is how the display geometry feeds back into the game rather than remaining an introduction slide.
+**34:30–36:00.** The emulator preserves renderer semantics, but cannot judge physical brightness or enforce the real output's column deadline. These copies of RELAX use HUD positions 1 and 35. The inner word compresses because angular cells have less circumference. Keep critical instructions near the rim and let the centre convey depth or drifting effects. Our clouds, blossoms and seeds are deliberately sparse. Test their contrast and recognizability on the real LEDs, along with a crowded garden and a sustained session. This is how the display geometry feeds back into the game rather than remaining an introduction slide.
-Source: [Hardware and legibility](../../docs/vs2/tutorial/budgets.html). Image: actual font labels through the SDK renderer.
+Source: [Hardware and legibility](../../docs/vs2/tutorial/budgets.html). Image: actual font labels through the emulator’s WebGL display backend.
---
@@ -668,9 +721,9 @@ Source: [Hardware and legibility](../../docs/vs2/tutorial/budgets.html). Image:
Notes:
-**36:00–38:00.** Run the finished game. A begins. Start with no flowers. Show the dreamer moving and deliberately catch seeds to grow flowers at the same depth, on the side the player last moved toward. Stop and catch another to show that the direction is remembered. Point out their slow inward drift and the flying seeds’ occasional glow. Let another seed pass to show that it causes no harm. Invite a second person or use Left/Right arrows and numpad 0 to reveal the mint friend. Have either player hold A and point out the RELAX label and slower background. The lullaby starts on; use X or keyboard N to toggle it and the bloom sounds. Show the two-second NOISY/QUIET notice. B chooses Rest, preserving the flowers while stopping audio. A begins a fresh dream. M or 1 returns to the launcher. If hardware is available, show the same game without spending the demo on flashing. Otherwise use the screenshots. Keep source open at build, move_seeds and update. The Run this checkpoint button opens the finished game in the browser.
+**36:00–38:00.** Run the finished game. A begins. Start with no flowers. Show the dreamer moving and deliberately catch seeds to grow flowers at the same depth, on the side the player last moved toward. Stop and catch several: the first follows the last movement direction, then plants alternate sides. Move again to reset the sequence. Point out their slow inward drift and the flying seeds’ occasional glow. Let another seed pass to show that it causes no harm. Invite a second person or use Left/Right arrows and numpad 0 to reveal the mint friend. Have either player hold A and point out the RELAX label and slower seeds against steadily moving clouds. The lullaby starts on; use X or keyboard N to toggle it and the bloom sounds. Show the two-second NOISY/QUIET notice. B chooses Rest, preserving the flowers while stopping audio. A begins a fresh dream. M or 1 returns to the launcher. If hardware is available, show the same game without spending the demo on flashing. Otherwise use the screenshots. Keep source open at build, move_seeds and update. The Run this checkpoint button opens the finished game in the browser.
-Sources: [Finished source](examples/dream_garden.py), [game instructions](examples/dream-garden-guide.html), [complete download](examples/dream-garden.zip). Screenshot: the actual Rest scene through the SDK renderer.
+Sources: [Finished source](examples/dream_garden.py), [game instructions](examples/dream-garden-guide.html), [complete download](examples/dream-garden.zip). Screenshot: the actual Rest scene through the emulator’s WebGL display backend.
---
diff --git a/tools/capture-presentation.mjs b/tools/capture-presentation.mjs
new file mode 100644
index 0000000..2c0b060
--- /dev/null
+++ b/tools/capture-presentation.mjs
@@ -0,0 +1,78 @@
+// Capture slide images with the SDK's actual WebGL scene and LED renderers.
+// Install playwright, then:
+// python3 tools/presentation-scenes.py --sdk vsdk --out /tmp/garden-scenes.json
+// node tools/capture-presentation.mjs vsdk /tmp/garden-scenes.json
+// CHROMIUM can select an installed Chrome executable.
+import fs from 'node:fs';
+import http from 'node:http';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+const { chromium } = createRequire(import.meta.url)('playwright');
+const sdk = path.resolve(process.argv[2] || 'vsdk');
+const frames = JSON.parse(fs.readFileSync(process.argv[3], 'utf8'));
+const out = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../presentations/making-games/assets');
+const html = ``;
+const server = http.createServer((req, res) => {
+ const pathname = new URL(req.url, 'http://localhost').pathname;
+ if (pathname === '/') { res.setHeader('Content-Type', 'text/html'); res.end(html); return; }
+ const file = path.resolve(sdk, '.' + pathname);
+ if (!file.startsWith(path.join(sdk, 'web') + path.sep) || !fs.existsSync(file)) {
+ res.writeHead(404); res.end(); return;
+ }
+ res.setHeader('Content-Type', 'text/javascript');
+ res.end(fs.readFileSync(file));
+});
+await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
+let browser;
+try {
+ browser = await chromium.launch({executablePath:process.env.CHROMIUM || undefined,
+ headless:true, args:['--no-sandbox']});
+ const page = await browser.newPage({viewport:{width:900,height:900}, deviceScaleFactor:1});
+ page.on('pageerror', error => console.error(error));
+ await page.goto(`http://127.0.0.1:${server.address().port}/`);
+ await page.waitForFunction(() => typeof window.captureScene === 'function');
+ const records = [];
+ for (const frame of frames) {
+ const renderer = await page.evaluate(frame => window.captureScene(frame), frame);
+ await page.locator('canvas').screenshot({path:path.join(out, frame.name)});
+ const sha256 = crypto.createHash('sha256').update(fs.readFileSync(path.join(out, frame.name))).digest('hex');
+ records.push({file:frame.name, description:frame.description, ...renderer, sha256});
+ console.log(`Captured ${frame.name} with ${renderer.displayBackend} and ${renderer.sceneBackend}`);
+ }
+ const sourceSha256 = crypto.createHash('sha256').update(fs.readFileSync(path.join(sdk,
+ 'games/demos/dream_garden/code/dream_garden.py'))).digest('hex');
+ fs.writeFileSync(path.join(out, 'captures.json'), JSON.stringify({sourceSha256,captures:records},null,2)+'\n');
+} finally {
+ if (browser) await browser.close();
+ await new Promise(resolve => server.close(resolve));
+}
diff --git a/tools/presentation-scenes.py b/tools/presentation-scenes.py
new file mode 100644
index 0000000..4a83b8a
--- /dev/null
+++ b/tools/presentation-scenes.py
@@ -0,0 +1,127 @@
+#!/usr/bin/env python3
+"""Export real SDK scenes and packed assets for the WebGL slide captures.
+
+No image drawing happens here. capture-presentation.mjs renders these payloads
+with the SDK's WebGL scene compositor and LED display backend.
+"""
+import argparse
+import base64
+import importlib.util
+import json
+import os
+import random
+import sys
+from pathlib import Path
+
+parser = argparse.ArgumentParser(description=__doc__)
+parser.add_argument('--sdk', type=Path, required=True)
+parser.add_argument('--out', type=Path, required=True)
+options = parser.parse_args()
+SDK = options.sdk.resolve()
+options.out = options.out.resolve()
+os.chdir(SDK)
+sys.path[:0] = [str(SDK / 'tests'), str(SDK)]
+import test_dream_garden as fixture
+import vs2
+from ventilastation import api_guard
+from ventilastation.app_loader import load_app
+from ventilastation.director import configure_runtime, director, reset_runtime
+
+frames = []
+
+
+def step(one=0, two=0, count=1):
+ for _ in range(count):
+ comms = director.platform.comms
+ comms.next_joy2 = lambda: two
+ comms.next_extra = lambda: 0
+ comms.push_input(bytes([one]))
+ director.step_once()
+
+
+def start(checkpoint=None):
+ reset_runtime()
+ api_guard.reset()
+ random.seed(2026)
+ runtime = configure_runtime('headless')
+ load_rom = runtime.load_rom
+ runtime.load_rom = lambda name: load_rom(str(SDK / 'apps/micropython' / name))
+ load_app('demos.dream_garden')
+ if checkpoint:
+ file = SDK / 'games/demos/dream_garden/code/checkpoints' / (checkpoint + '.py')
+ spec = importlib.util.spec_from_file_location('capture_checkpoint', file)
+ module = importlib.util.module_from_spec(spec)
+ spec.loader.exec_module(module)
+ director.scene_stack[-1].switch(module.main())
+ step()
+ else:
+ step(fixture.A)
+ step()
+ scene = director.scene_stack[-1]
+ scene.pending_calls.clear()
+ return scene
+
+
+def capture(scene, name, description):
+ runtime = director
+ encode = lambda data: base64.b64encode(data).decode('ascii')
+ frames.append(dict(name=name, description=description,
+ scene=encode(vs2.export_scene_payload(scene)),
+ palette=encode(runtime.palette_data),
+ strips=[dict(slot=slot, data=encode(data))
+ for slot, data in runtime._stripe_buffers.items()]))
+
+
+garden = start()
+capture(garden, 'garden-start.png', 'Finished game starts with no planted flowers.')
+step(0, fixture.LEFT)
+for index in range(12):
+ player = garden.dreamer if index % 2 == 0 else garden.friend
+ player.x = (index * 21 - player.width // 2) % 256
+ garden.bloom(garden.seeds.spawn(x=player.x, y=10), player)
+ step(count=90)
+garden.dreamer.x = 247
+garden.friend.x = 55
+for index, depth in enumerate((20, 40, 60, 80, 110, 130, 150)):
+ garden.seeds.spawn(x=(index * 37 + 20) % 256, y=depth, frame=index % 4)
+capture(garden, 'dream-garden.png', 'Populated final game, grown through its bloom handler.')
+step(fixture.A)
+capture(garden, 'shared-rest.png', 'Player one holds A: RELAX, sleeping pose and slower seeds.')
+step(fixture.B)
+capture(director.scene_stack[-1], 'dream-rest.png', 'Actual final Rest scene preserves the planted flowers.')
+capture(start('01-steering'), 'first-game.png', 'Actual first steering checkpoint, with only one dreamer.')
+capture(start('06-tiles'), 'tilemaps.png', 'Actual cloud tilemap checkpoint before scrolling.')
+
+
+class Angles(vs2.Scene):
+ def build(self):
+ world = self.layer('world', projection=vs2.TUNNEL)
+ for x in (0, 64, 128, 192):
+ world.sprite('dreamer.png', x=x - 9, y=0)
+
+
+class Projections(vs2.Scene):
+ def build(self):
+ for name, projection, centre in (('tunnel', vs2.TUNNEL, 128), ('hud', vs2.HUD, 0)):
+ layer = self.layer(name, projection=projection)
+ for index, y in enumerate((0, 24, 48)):
+ layer.sprite('dreamer.png', x=centre + index * 32 - 41, y=y)
+
+
+class Legibility(vs2.Scene):
+ def build(self):
+ hud = self.layer('hud', projection=vs2.HUD)
+ for y in (1, 35):
+ hud.label('steel8x8.png', columns=5, x=108, y=y,
+ flip_x=True, flip_y=True, text='RELAX')
+
+
+for cls, filename in ((Angles, 'display-angles.png'),
+ (Projections, 'display-projections.png'),
+ (Legibility, 'budgets-legibility.png')):
+ start().switch(cls())
+ step()
+ capture(director.scene_stack[-1], filename, 'Geometry example using real Dream Garden assets.')
+options.out.write_text(json.dumps(frames))
+reset_runtime()
+print(f'Exported {len(frames)} scenes to {options.out}')
diff --git a/tools/test-presentation.py b/tools/test-presentation.py
index 8aa4a5e..1ca8a31 100644
--- a/tools/test-presentation.py
+++ b/tools/test-presentation.py
@@ -2,6 +2,8 @@
"""Check talk pacing, hosted assets, and the runnable first-game example."""
import argparse
import importlib.util
+import hashlib
+import json
from html.parser import HTMLParser
from pathlib import Path
import re
@@ -124,6 +126,23 @@ def check_checkpoints(site, sdk):
print('All Python slides launch a published cumulative checkpoint; 11 stages match the SDK')
+def check_webgl_captures(sdk):
+ assets = TALK / 'assets'
+ record = json.loads((assets / 'captures.json').read_text())
+ source = sdk / 'games/demos/dream_garden/code/dream_garden.py'
+ assert record['sourceSha256'] == hashlib.sha256(source.read_bytes()).hexdigest()
+ captures = {item['file']: item for item in record['captures']}
+ expected = {'dream-garden.png', 'shared-rest.png', 'dream-rest.png',
+ 'first-game.png', 'tilemaps.png', 'display-angles.png',
+ 'display-projections.png', 'budgets-legibility.png', 'garden-start.png'}
+ assert set(captures) == expected
+ for filename, capture in captures.items():
+ assert capture['displayBackend'] == 'WebGL2', filename
+ assert capture['sceneBackend'] == 'WebGL shader', filename
+ assert capture['sha256'] == hashlib.sha256((assets / filename).read_bytes()).hexdigest(), filename
+ print('All game and display captures match the recorded WebGL output and completed game source')
+
+
if __name__ == '__main__':
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('--site', type=Path, required=True)
@@ -134,3 +153,4 @@ def check_checkpoints(site, sdk):
check_site(options.site.resolve(), options.baseurl.rstrip('/'), options.sdk.resolve())
check_starter(options.sdk.resolve())
check_checkpoints(options.site.resolve(), options.sdk.resolve())
+ check_webgl_captures(options.sdk.resolve())
diff --git a/vsdk b/vsdk
index b921eee..446e540 160000
--- a/vsdk
+++ b/vsdk
@@ -1 +1 @@
-Subproject commit b921eee8270219acc30efa65da577d89e23b5296
+Subproject commit 446e5404c39d33d44aaacb9cc556f6ec2f01e2d1