shadertoy-cli 2.2.3

.ststate is ShaderToy CLI's resumable debugging artifact.

It stores:
  - render dimensions
  - fixed frame rate
  - shader time and iFrame
  - lossless RGBA32F snapshots of persistent 2D buffer/compute passes
  - each captured buffer's actual dimensions (including fixed-size passes)
  - each captured buffer's render-target format
  - optional named SSBO byte contents (format 4)

SSBO capture is opt-in:

  shadertoy state capture --frame 300 --include-storage -o target/frame300.ststate

Captured SSBOs can be replaced from exact-size binary files:

  shadertoy state set-storage target/frame300.ststate \
    particles=fixtures/particles.bin \
    -o target/modified.ststate

The captured texture/timing state is deterministic and independent of wall-clock playback.

Capture:
  shadertoy state capture --frame 300 -o target/frame300.ststate

Inspect:
  shadertoy state inspect target/frame300.ststate --json

Modify one buffer:
  shadertoy state set target/frame300.ststate \
    buffer-a=fixtures/known.png \
    -o target/modified.ststate

Resume:
  shadertoy render --state target/modified.ststate -o target/next.png


State format 4 extends format 3 with optional named SSBO byte payloads. Format 3
introduced per-buffer dimensions and render-target formats so typed buffer state
cannot be silently restored into an incompatible format. Formats 1 through 3
remain readable. A
state containing only fixed-size persistent passes can be resumed at a different
output resolution; output-sized feedback buffers still require the captured
resolution so their state is not silently discarded.