160 lines
9.1 KiB
Markdown
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.
|