1# llimphi-widget-waveform
2
3*Read this in English: [README.md](README.md).*
4
5Visor de **forma de onda en vivo**.
6
7Pattern análogo a [`llimphi-widget-timeline`](
8https://docs.rs/llimphi-widget-timeline): el widget **no mantiene
9estado** del audio (ni cpal, ni `AudioProbe`, ni ringbuffer). El caller
10le pasa un closure `Fn(&mut Vec<f32>) -> u16` que rellena un buffer con
11los últimos samples y devuelve cuántos **canales** intercalados trae;
12el widget hace el fold a mono y dibuja un **envelope min/max por
13columna** (polígono cerrado con relleno tenue + stroke por arriba y
14por abajo) sobre una **línea central** que siempre está presente como
15"ground" del visor. Sin handlers de mouse — paint-only.
16```text
17  ┌─────────────────────────────────────────────────┐
18  │   ▄▄▄    ▄  ▄▄▄  ▄▄    ▄▄  ▄                    │
19  │  ▄███▄  ▄█▄▄███▄▄██▄▄▄▄██▄▄█▄                   │
20  │──█████──███████████████████████─── centro ──────│
21  │  ▀███▀  ▀█▀▀███▀▀██▀▀▀▀██▀▀█▀                   │
22  │   ▀▀▀    ▀  ▀▀▀  ▀▀    ▀▀  ▀                    │
23  └─────────────────────────────────────────────────┘
24```
25Uso típico (reproductor con audio probe):
26```ignore
27use std::sync::Arc;
28let probe = audio_probe();        // Arc<AudioProbe> propia de la app
29let palette = WaveformPalette::default();
30waveform_view(
31    move |out| {
32        let (_sr, ch) = probe.snapshot(out);
33        ch                         // canales intercalados
34    },
35    &palette,
36)
37```
38Si el closure devuelve `0` canales (o no llena el buffer), el widget
39pinta sólo la línea central — útil para mostrar "visor vivo, sin
40señal" cuando el dispositivo de captura todavía no levantó.
41
42---
43
44Parte de **llimphi** — ver [llimphi](../../LEEME.md).