Package-level declarations

Availability of a feature measurement. Ready silence has zero power; it is not unavailable.

A complete sample window on the source media timeline. Null times mean unknown, not zero.

Cumulative diagnostics for one shared analysis session. Poll these values for telemetry; they are not Compose state. Durations measure elapsed wall time, not thread CPU time.

One detector result. Availability is the newest media sample needed to produce this result.

Immutable publication of all detections of one source through an inclusive media-time watermark.

An accepted detection with an identity unique within one continuous analysis history. The identity is the source, generation, revision and sequence together; sequence numbers are comparable only within one source.

One view's ordered event reader across every source. Call from one consumer thread, with the authoritative media time. Initial attachment and gaps over 250 ms discard past bursts. A late transient may arrive up to 30 ms late and a late structural confirmation up to 3 s late; song map events are delivered on time only. sample reports every kind of discard. Pausing never emits an event.

Immutable events and accounting from one cursor sample; indexed access preserves multiplicity.

Retention diagnostics. Payload bytes exclude the bounded object/array/atomic-slot overhead.

Detected musical cues, separate from predicted beat-grid crossings and instrument identities.

Which publisher produced an event. Each source has its own completion watermark, sequence numbers, lateness budget and retention, so a slow source never holds back another.

Marks the toolkit drawings are written with: the sound analysis, meshes, cameras, motion, grounds, warps, the finishing pass, and the low-level surfaces that draw them.

What the visualiser shows and how: the drawing, the palette, whether the director picks drawings with the music, and the finishing pass. Make one with rememberAudioVizState and show it with KiteAudioViz.

One consumer's delivery of a shared event. Zero lateness denotes normal interval delivery.

Shared-gain display heights: fast 10/120 ms, slow 100 ms/2 s, peak hold 500 ms then 12 dB/s.

Immutable energy display drivers from one analysis. All receive powerGain before the same fixed power-to-height curve. The raw measurements remain in SpectrumFrame.power.

A key estimated from pitched audio. Unknown keys are null, never a guess with low confidence. Confidence and correlation are scores against published key profiles, not probabilities.

Major or minor, the two modes the key profiles describe.

One stretch of a song map with one supported key.

Immutable unweighted spectral power from a complete symmetric Hann window.

Ungated 400 ms K-weighted programme power, with its own availability and measurement time.

Causal pulse estimates. Support values are heuristic scores, not probabilities of correctness. A usable beat phase does not establish meter, a downbeat or a phrase boundary.

What a background scan of one audio track found. Every field may be absent, and a partial map describes only its covered range. See docs/audioviz-song-scan-api.md.

Where finished song maps are kept between runs of an application.

Which items a background song scan may read. Local files scan by default; a network URI and an item with its own reader factory need the application's explicit consent, because a scan reads the whole track a second time. Live and read-once items never scan.

Causal, sample-timed audio analysis with per-channel power and one shared display gain.

One analysed moment of audio, ready to draw.

Retained feature payload, with bounded slot/object overhead in addition to the payload bytes.

Bounded analysis history aligned to the audible media clock.

A retained event and the presentation seconds until its original estimated media time.

Projection of source channels into a decorative waveform. Speaker roles come from layout metadata.

Exact contiguous samples represented by a triggered raw trace. No analysis resampling is applied.

True when the media has sound and no picture of its own, which is when to show the visualiser.

Every drawing at once, each live in a small tile, in one flat grid searchable by name. Tapping a tile shows that drawing in state, then calls onPick so the caller can close the panel.

The settings for state: the drawing's own settings and its recipe, the palette, the finishing pass, the render detail with a frame-time bar, and the director. Every control writes straight into what the drawing reads on its next frame, so a change shows at once.

Draws the sound the player is playing, with the drawing, palette and director in state.

An AudioVizState that listens to player for as long as it stays in the composition.