Forma de onda

Tres formas de onda: barras redondeadas con cabezal, una envolvente en espejo con una selección y una línea luminosa en vivo

left, right = engine.render(5.0)          # cinco segundos renderizados sin tarjeta de sonido
ui.audio.Waveform(samples=left, variant="bars", playhead=self.position,
                  on_seek=lambda e: self.seek(e.value))

Muestras

samples son números de −1 a 1: un archivo entero o el último búfer de una señal en vivo (node.scope(1024)). Una lista larga se reduce a un par mínimo/máximo por columna de píxeles, así que un minuto de audio se dibuja tan rápido como un búfer corto. gain la amplía cuando el sonido es suave.

Estilos

`variant`	Se parece a
`"mirror"`	La envolvente, simétrica alrededor de la línea central (por defecto).
`"filled"`	La forma real, rellena entre sus puntos más bajos y más altos.
`"line"`	Una línea por cada muestra; `glow=True` añade un halo suave. Ideal para búferes cortos.
`"bars"`	Barras redondeadas como una app de música: la parte reproducida en `color` y el resto atenuado.
`"dots"`	Un punto por muestra.

Cabezal, selección y salto

playhead (0..1) dibuja la posición de reproducción (con "bars" separa lo reproducido de lo pendiente).
selection=(0.2, 0.4) resalta un rango: un bucle, una región para cortar.
Con on_seek, hacer clic o arrastrar sobre ella informa la posición (0..1) en event.value.

Propiedad	Por defecto	Qué hace
`samples`	`()`	Valores de −1 a 1.
`width`, `height`	`360`, `96`	Tamaño en píxeles.
`variant`	`"mirror"`	Ver la tabla de arriba.
`color`, `background`	`"accent"`, `"#0f1012"`	Colores.
`gain`, `thickness`, `glow`	`1`, `1.5`, `False`	Escala, grosor de línea y halo.
`grid`	`True`	Líneas verticales tenues y una línea central.
`playhead`, `selection`	`None`	Posición (0..1) y rango `(inicio, fin)`.
`bar`	`3`	Ancho de una barra con `variant="bars"`.

Evento: on_seek (0..1).