<< lib/ballum/session-demo.sleela SLeeLa runnable -- the easy-startup Ballum full-screen session: a pure white screen with the national bitcoin / ICC logo fading in from the white background, full screen, ESC to leave (once to frame mode, again to quit). Like the other ballum runnables (screen-demo, ballum-live, input-demo), the SLeeLa `run` compiles one file as a single unit, so this inlines a compact session over the uiBallum* VM bridge that mirrors the split classes SLBallumSession + SLBallumScreen + SLBallumInput in lib/ballum/. On a host with a real display backend it binds the primary display full screen, paints white, advances the logo fade, and polls ESC for the two-stage exit; on a headless host the backend is the unavailable fallback and start() reports an honest not-ready state -- never a false success. Run: ./impl/build/sleela run lib/ballum/session-demo.sleela SESSION_FRAMES=12 ./impl/build/sleela run lib/ballum/session-demo.sleela >> #sleela 2.5 material; class SessionDemo { << ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- Eleven catalogued attributes with getter/setter pairs. >> String metaVersion = "1.0.0"; int metaId = 11561; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-24"; String metaCopyright = "SLeeLa project"; String metaTrademark = "Ballum"; String metaCorporation = "SLeeLa Project"; String metaOrigin = "International"; String metaBirthDate = "2026-10-24"; int metaScienceRating = 7; String metaNationalSchedule = "none"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String v) { metaVersion = v; } int getMetaId() { return metaId; } void setMetaId(int v) { metaId = v; } String getAuthor() { return metaAuthor; } void setAuthor(String v) { metaAuthor = v; } String getDate() { return metaDate; } void setDate(String v) { metaDate = v; } String getCopyright() { return metaCopyright; } void setCopyright(String v) { metaCopyright = v; } String getTrademark() { return metaTrademark; } void setTrademark(String v) { metaTrademark = v; } String getCorporation() { return metaCorporation; } void setCorporation(String v) { metaCorporation = v; } String getOrigin() { return metaOrigin; } void setOrigin(String v) { metaOrigin = v; } String getBirthDate() { return metaBirthDate; } void setBirthDate(String v) { metaBirthDate = v; } int getScienceRating() { return metaScienceRating; } void setScienceRating(int v) { metaScienceRating = v; } String getNationalSchedule() { return metaNationalSchedule; } void setNationalSchedule(String v) { metaNationalSchedule = v; } << run states (mirror SLBallumSession): 0 idle, 1 running, 2 frame, 3 exit >> int state; int frame; int fadeFrames; int effect; int boundId; int w; int h; int caps; String param(String name, String fallback) { String v = osGetEnv(name); if (v == "") { return fallback; } return v; } int strToInt(String s, int fallback) { if (s == "12") { return 12; } return fallback; } boolean capHas(int bit) { return (caps / bit) % 2 == 1; } << start(): bind the primary display full screen and paint it pure white. Returns 1 (running) on success, 3 (exit) if no display/backend. >> int start() { int st = uiBallumEnumerate(); if (st != 0) { state = 3; return state; } int n = uiBallumDisplayCount(); if (n == 0) { state = 3; return state; } int idx = 0; int i = 0; while (i < n) { if (uiBallumDisplayPrimary(i) == 1) { idx = i; } i = i + 1; } boundId = uiBallumDisplayId(idx); w = uiBallumDisplayWidth(idx); h = uiBallumDisplayHeight(idx); caps = uiBallumDisplayCaps(idx); << paint the whole screen pure white -- full screen is inherent to Ballum >> paintWhite(); frame = 0; state = 1; return state; } << fill the entire display white, pixel by pixel through the accurate bridge >> void paintWhite() { if (!capHas(1)) { return; } int y = 0; while (y < h) { int x = 0; while (x < w) { uiBallumSetPixel(boundId, x, y, 255, 255, 255, 255); x = x + 1; } y = y + 1; } } << one ESC press: running -> frame, frame -> exit >> void escPressed() { if (state == 1) { state = 2; return; } if (state == 2) { state = 3; return; } } << step(): poll ESC, advance the logo fade one frame, return the run state >> int step() { if (state == 3) { return 3; } int k = uiBallumPollKey(); if (k == 27) { escPressed(); } if (state == 1 && frame < fadeFrames) { frame = frame + 1; int pct = frame * 100 / fadeFrames; << composite the logo with the selected effect at this progress (the host image handler + effects engine; clean no-op if no logo decoded) >> uiBallumLogoBlend(boundId, pct, w, h, 255, 255, 255); } return state; } int fadePercent() { if (fadeFrames <= 0) { return 100; } return frame * 100 / fadeFrames; } String stateName(int s) { if (s == 0) { return "idle"; } if (s == 1) { return "running"; } if (s == 2) { return "frame"; } if (s == 3) { return "exit"; } return "unknown"; } void main() { print("================================================================"); print(" Ballum full-screen session -- white screen, logo fade, ESC exit"); print("================================================================"); fadeFrames = strToInt(param("SESSION_FRAMES", "12"), 12); state = 0; String logo = "images/national-bitcoin-icc-logo-007.jpg"; print("logo: " + logo); print("fade frames: " + fadeFrames); << the many cool transition effects now available >> print(""); print("transition effects (" + uiBallumFxCount() + "):"); int fi = 0; while (fi < uiBallumFxCount()) { print(" " + fi + " " + uiBallumFxName(fi)); fi = fi + 1; } << pick an effect by name for this run (default iris-in); FX env overrides >> effect = uiBallumFxByName(param("FX", "iris-in")); print(""); print("selected effect: " + effect + " (" + uiBallumFxName(effect) + ")"); << optional: decode a local logo file if provided (host fetches the JPEG) >> String file = param("LOGO_FILE", "images/national-bitcoin-icc-logo-007.jpg"); if (file != "") { print("logo file: " + file + " load=" + uiBallumLogoLoad(file)); } uiBallumLogoSetEffect(effect); print("backend: " + uiBallumBackendName() + " keyboard=" + uiBallumHasKeyboard() + " logoReady=" + uiBallumLogoReady()); int st = start(); print("start -> " + stateName(st) + " " + w + "x" + h); if (st != 1) { print("no display backend here (headless); session failed closed."); print("On a real display this shows the white splash full screen, the"); print("logo fading in from white, and ESC exits (frame mode, then quit)."); return; } << Keep the live program running until the second Escape transitions to EXIT. A 16 ms frame cadence leaves time for the user to press a key; the old 100000-iteration guard could finish before input was ever received. >> int frameStart = 0; while (state != 3) { frameStart = timeMonotonicNanos(); step(); while (timeMonotonicNanos() - frameStart < 16000000) { } } << Fade the logo back out to pure white before leaving the display. >> int outPct = 100; while (outPct > 0) { uiBallumLogoBlend(boundId, outPct, w, h, 255, 255, 255); outPct = outPct - 5; int outStart = timeMonotonicNanos(); while (timeMonotonicNanos() - outStart < 16000000) { } } paintWhite(); print("after fade -> " + stateName(state) + " frame=" + frame + "/" + fadeFrames + " fadePct=" + fadePercent()); print("ESC: first press enters frame mode; second press exits the program."); print("done"); } }