Skip to content

Visual identity from real engine frames, lorenz example, PROOF_SHOT capture, Pages site - #6

Merged
Mattbusel merged 2 commits into
mainfrom
shine/visual-identity
Sep 25, 2026
Merged

Mattbusel merged 2 commits into
mainfrom
shine/visual-identity

Conversation

@Mattbusel

Copy link
Copy Markdown
Owner

Gives the repo a visual identity built from frames the engine renders itself, plus a GitHub Pages site and a small capture feature that made it possible without opening a visible window.

Before and after

Before: the README opened on dark screenshots of the convergence demo and two 4 MB GIFs.

before

After: the banner is two real frames: the sky example at 17:50 (sun +1.8 deg) and the new lorenz example.

after banner

sky across a day

lorenz

pipeline

What changed

  • PROOF_SHOT capture (src/capture.rs). Any program on the engine can write its frames to BMP, read back off the GPU after post-processing, via env vars: PROOF_SHOT, PROOF_SHOT_AT, PROOF_SHOT_COUNT, PROOF_SHOT_EVERY, PROOF_SHOT_KEEP, PROOF_FIXED_DT, PROOF_HIDDEN (invisible, unfocused window), PROOF_WINDOW. Wired into run, run_with_overlay and run_ui. No public API changes; three unit tests.
  • examples/lorenz.rs. 40,000 points advanced by math::attractors::rk4_step, coloured by speed, drawn into the HDR world pass.
  • README. Banner, quick start first, figures captured today from sky, lorenz and convergence, a hand-drawn pipeline SVG, reference sections collapsed into <details>, status corrected to 0.2. All previous accurate content kept.
  • docs/: a Pages site with the sky clip in the hero, a "drag the sun" scrubber over 40 real frames (times and elevations match what the demo prints), the Lorenz clip, quick start with copy buttons, features, demos, capture docs. No trackers, no external fonts.
  • .github/social-preview.png (1280x640) to upload in Settings.
  • Root screenshots with timestamp names removed; the convergence GIF moved to assets/. docs/ and *.jpg excluded from the published crate.

Found while capturing

galaxy, math_rain and strange_attractors render a blown-out first second and then an empty scene (captured hidden on Windows, RTX 4070; convergence and supernova on the same path look right). The README now says so instead of advertising them; the site lists only demos that were seen working or were already documented as needing a strong GPU.

…e, site

- PROOF_SHOT / PROOF_HIDDEN / PROOF_FIXED_DT / PROOF_WINDOW: any program can
  write its own frames, read back off the GPU after post-processing, from a
  hidden unfocused window. Unit tested; no public API changes.
- examples/lorenz.rs: 40,000 points integrated with math::attractors::rk4_step,
  drawn into the HDR world pass.
- README: banner and figures built from frames captured from sky, lorenz and
  convergence; hand-drawn pipeline diagram; quick start first; long reference
  sections collapsed; status says 0.2.
- docs/: GitHub Pages site with the sky clip, a sun scrubber over 40 real
  frames, the lorenz clip, quick start with copy buttons.
- .github/social-preview.png for the repository settings.
- Old root screenshots removed; the convergence GIF moved to assets/.
@Mattbusel
Mattbusel merged commit ac20219 into main Sep 25, 2026
3 checks passed
@Mattbusel
Mattbusel deleted the shine/visual-identity branch September 25, 2026 22:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant