KAZIK/docs/STARTUP_PRESENTATION.md

Startup presentation and hall briefing

All runtime presentation, text, timing, input and drawing are MASM32. No browser, video player, Python runtime or additional graphics dependency is introduced.

Startup order

1. Existing Eblan Games animated logo (7 seconds; its F2 variant is retained).
2. Russian AI-use disclosure (10 seconds): artificial intelligence technologies were used to create some game textures; third-party resources retain their authors and licences.
3. Code fact (11 seconds): side-by-side editor-style C++ and MASM panels for clearing the same 640×480 framebuffer. C++ is explicitly an illustrative equivalent, not a second game runtime. MASM shows the actual clear operation from src_graphics/startup_sequence.inc.
4. Existing first-person city opening, guards and profile selection.

Pages advance automatically. Enter/Space advances one page, clearing held input so it cannot skip several screens at once. Escape skips the startup pages and begins the existing city scene. Starting again resets all pages. Existing missing-logo fallback still works; the two new pages need no art files.

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). Existing distance/floor attenuation still applies, so it sounds quieter away from the cabinet. Volume is applied before playback, avoiding a full-volume startup burst. No jukebox music plays during startup/profile selection. Closing the briefing does not restart the track or reset volume; the existing jukebox controls and +/- volume keys remain available after closing it.

At the same entry point, the centred panel deploys from a point: horizontal expansion for 200 ms, then vertical ease-out for 400 ms. Cyan/magenta rails and a scanning marker frame the dark panel. The hall is rendered by the normal ASM renderer and dimmed beneath it; movement, interactions and camera input do not run until the modal closes.

After deployment, Russian text types at one character per 18 ms with a blinking cursor: version 4.0 / Windows x86, engine, activities, controls and profile persistence. Version follows the existing 4.0 build identity; this change does not introduce a new release/version bump or alter save formats.

• Enter/Space: complete the text; press again to close.
• Escape: close immediately, without opening pause.
• Enter game button: same complete/close behaviour, with mouse input.
• No automatic dismissal; the information remains readable.
• Shown once per admission on each launch, not on returning from tables or Hell.

The core remains assembly-only; the pre-existing C# packaging tools and the approved C++ fortune inference worker are separate from the game engine.

Copy and implementation

• tools/generators/make_presentation_text.py: editable Russian copy; emits numeric CP1251 declarations into src_graphics/presentation_text.inc.
• src_graphics/presentation_data.inc: timings, page/briefing state and API.
• src_graphics/presentation_code.inc: native bitmap text, code windows, unfolding modal and typewriter.
• src_graphics/startup_code.inc: three-page sequencing.
• src_graphics/arrival_scene.inc: briefing starts after admission/entry only.
• casino3d.inc: modal input gate, mouse unlock and Escape handling.

Verification

python tools/generators/make_presentation_text.py
python tools/tests/check_presentation.py
python tools/tests/check_presentation.py --window

Tests compile the production procedures with an isolated ASM entry point. They check automatic and key transitions, restart/reset, existing city-scene handoff, guest admission, delayed modal trigger, deployment, typing and manual completion, button/close input cleanup, and unchanged bank, RNG and player save files. They also query actual MCI playback and gain after entry, verify silence before admission, retain a changed volume and playback position across modal closure, then exercise manual track selection and Stop. MCI gain assertions allow device rounding (four units out of 1000); both success and failure close jboxmusic. --window also presents 150 real Win32 frames.

Outputs: build/scratch/presentation-00..11.png, presentation-contact.png and presentation-window.png. Existing action/arrival tests also check the revised startup order and the new admission trigger.