KAZIK/docs/STARTUP_PRESENTATION.md

160 lines
9.1 KiB
Markdown

# Startup presentation and hall briefing
The current ident belongs to **Eblan Games**. It is a real 3D workshop rendered
offline in Blender Cycles. A phosphor signature forms on the curved glass
of an old CRT and resolves into a full-screen studio title. The camera moves from the shared corridor through the door of
Room 17 and across the studio workbench.
## Startup order
1. **Content disclaimer / 8.5 s.** Russian copy describes the fictional setting,
simulated currency, smoking, violence and strong language. A quiet footer
retains AI-art and third-party disclosure. The 18+ notice is not an official
age certification.
2. **Eblan Games workshop / 16 s, 1920x1080, 24 fps.** The camera rushes down the
corridor as door 17 swings in. A draught lifts the corner of a marked test
sheet while the take-up reel draws loose magnetic tape along the wood. The
spinning hub cuts to the aluminium end of a can rolling off the computer desk.
The camera follows its lower rim onto the floor switch in slow motion. The
relay opens and five spring-loaded letters rise in sequence. The camera holds
on the complete word before cutting to dark glass.
A point ignites on frame 264, spreads into a line, and reveals the EG
monogram. The last shot carries the studio name on black.
3. **Game features / 11 s.** Three Russian sections introduce the games,
first-person exploration, secrets and characters, with WASD/mouse/E controls.
4. **Existing first-person opening.** The fade joins the closed-eyes start of
the rainy alley, followed by guards, profile admission and the hall.
Pages advance automatically. **Enter/Space** advances one page and clears held
input; **Escape** skips to the existing opening scene. Starting again returns to
the disclaimer. Page sound stops on skip. Missing sounds do not cause a Windows
default beep.
## Editable sources and rebuild
- `assets/cinematics/blender/eblan-workshop-v8.blend`: editable meshes,
materials, physical lights, camera animation and depth of field.
- `assets/cinematics/blender/screen-v8/`: the terminal animation as a
384-frame texture sequence for the actual curved CRT glass. Keep this folder
beside the blend file along with `signature-v8/`, the final title sequence.
- The exporter writes the reusable ProRes 422 HQ master with stereo PCM audio to
`assets/cinematics/masters/Eblan-Games-master-v8.mov`.
- `assets/cinematics/blender/printed-v7/`: original notes and the marked audio channel test sheet.
- `assets/cinematics/blender/models/sources-v7.json`: source, license and file
hashes for 18 additional Poly Haven scans and four surface materials. Earlier
scan records are in `models/sources.json`, `models/sources-v5.json` and
`models/sources-v6.json`.
- `tools/generators/make_studio_v5.jsx` defines the current eight-shot finishing
timeline. The After Effects helper saves it as `EblanGames-workshop-v8-16s.aep`
when run successfully. The older `EblanGames-workshop-v8.aep` has the 12-second edit.
- `assets/audio/startup/studio-workshop-v8.wav`: original 16-second score and
sound effects shared by the game and preview.
Run from the repository root, with Blender installed:
```powershell
& '<Blender>/blender.exe' --background --python-exit-code 1 --python tools/generators/build_studio_v8.py -- --animation
python tools/generators/pack_studio_hd.py --version 8
python tools/previews/export_studio_v5.py --version 8 --ffmpeg '<ffmpeg.exe>'
python tools/previews/export_studio_v5.py --version 8 --master --ffmpeg '<ffmpeg.exe>'
powershell -ExecutionPolicy Bypass -File tools/generators/build_studio_ae.ps1 -Version 8
```
Use `--proof 36 62 74 125 162 230` to render selected frames. The
review exporter reads the game's JPEG payload. To regenerate title textures
and sound, run `python tools/generators/make_studio_v8_media.py`. The optional
`--build` mode rebuilds the finished scene from a local copy of the v7 workshop.
The AE helper launches an isolated app instance through an ASCII temporary
bridge, because the installed AE CLI did not execute a Cyrillic script path.
The bridge uses Unicode escapes to load the actual repository JSX.
Blender outputs `build/cinematic-v8/frames/frame_0001..0384.png`.
The review film is `assets/cinematics/masters/Eblan-Games-v8.mp4`. The native
resource is `assets/animations/intro/eblan-studio-v8.hfm` plus its JSON manifest.
Blender, After Effects, ffmpeg and Python are offline authoring tools. Players
do not need them. Editable sets and raw scans are excluded from installer payloads.
The earlier casino exterior, roulette set and v3 AE project remain source
experiments. Their city/title section is not part of the current startup route.
## Native Full HD presentation
The assembly-only runtime policy is retained. MASM owns timing, input, file
validation, seeking, sound, page transitions and presentation. The game does not
launch Python, Blender, AE, a browser or an external video player.
`HFM4` stores 384 independent Full HD JPEG frames. Its 32-byte header fixes
1920x1080, 24 fps, 384 frames, a 16000 ms duration and a 2 MiB maximum frame
chunk. The native reader validates the header, contiguous index, frame bounds
and file length before allocating. It streams one chunk and retains one decoded
frame. Windows GDI+ decodes JPEG; the game checks the actual bitmap dimensions.
`PresentHDStudio3D` presents that **1920x1080 bitmap directly** to the window,
preserving 16:9 and clearing letterbox/pillarbox bars. It bypasses the 640x480
gameplay framebuffer. A separate small preview exists only for existing capture
tools. The ident's fades are baked into the Full HD images. Skip, restart and
failure paths free the bitmap/DCs, frame buffer, stream and GDI+ session.
Missing/truncated/corrupt media falls back to the retained v3/native studio
path, mapped to its first eight seconds so the old city chapter stays out of the
16-second fallback. The page sequence goes directly from studio to features. Bank,
player position, camera, RNG and profile files are unchanged by playback.
Relevant assembly files:
- `src_graphics/cinematic_hd.inc`, `cinematic_hd_data.inc`: HFM4 reader,
decoder lifecycle, cache and direct Full HD presenter.
- `src_graphics/startup_film.inc`: Full HD / earlier master / native fallback.
- `src_graphics/platform_code.inc`: full-resolution window presentation.
- `src_graphics/startup_code.inc`: disclaimer → studio → features → alley.
- `src_graphics/presentation_data.inc`: timings and sound path.
- `tools/generators/make_presentation_text.py`: Russian notice/feature text;
emits numeric CP1251 declarations into `presentation_text.inc`.
## Post-entry briefing
After a guest/existing/new profile is admitted and the player enters the hall,
the jukebox starts **Bolden - Art Deco** on repeat at **50% user volume** (5/10).
Normal distance/floor attenuation still applies. Gain is applied before playback.
No jukebox music plays during startup or profile selection. Closing the briefing
does not restart the track or reset volume; normal jukebox controls remain usable.
The centred panel deploys horizontally for 200 ms, then vertically for 400 ms.
Cyan/magenta rails and a scanning marker frame the dark panel. The ordinary ASM
hall renderer runs beneath it and is dimmed. Movement/interactions/camera input
are blocked until it closes. Russian text types at one character per 18 ms:
version **4.0 / Windows x86**, game information, controls and profile persistence.
This does not change the game's release version or save format.
- **Enter/Space**: complete the text, then press again to close.
- **Escape**: close immediately without opening pause.
- **Enter game** button: the same complete/close behaviour.
- No automatic dismissal. Shown once per admission on each launch.
The existing C# packaging tools and approved C++ fortune inference worker remain
separate from the assembly game engine.
## Verification
```powershell
& '<Blender>/blender.exe' -b assets/cinematics/blender/eblan-workshop-v8.blend --python-exit-code 1 -P tools/tests/check_studio_motion_blender.py
python tools/tests/check_studio_hd.py
python tools/tests/check_studio_hd.py --production
python tools/tests/check_presentation.py
python tools/tests/check_underworld.py
cmd /c build.bat
```
The Full HD probe compiles the production ASM loader/presenter. It exercises all
384 frame indices, seeking and cache reuse, missing/truncated/bad data and cleanup.
It captures the actual native presenter at 1920x1080, 1920x1440 and 2560x1080,
compares pixels to the JPEG source and checks that aspect bars are black.
`--production` repeats this on the rendered workshop movie.
The presentation check verifies ordered pages, automatic/key/skip transitions,
fresh-launch reset, original alley handoff, admission, briefing deployment,
typing, input cleanup and actual MCI playback/volume behaviour. It captures 333
native frames, including the complete studio motion at 20 fps. The 640x480 test
captures are previews; the separate Full HD probe verifies shipping resolution.
Both probes verify unchanged player saves, bank and RNG.