Resumen del applet de forma de onda¶

El applet de forma de onda es un osciloscopio de audio que muestra la forma de onda en el dominio del tiempo de la ruta de audio activa de RX o TX. Úselo para detectar recorte, pérdidas y problemas de nivel de audio de un vistazo, sin necesidad de un medidor externo.

Cómo funciona¶

El applet renderiza una ventana de tiempo deslizante de audio mono. La duración de la ventana es ajustable de 240 ms a 10 segundos mediante un control deslizante de pasos discretos en el panel de configuración. La pantalla se alimenta continuamente con muestras del motor de audio. Cada columna de píxeles muestra la envolvente mín/máx de las muestras que caen dentro de ella, con trazas separadas de envolvente de pico y RMS superpuestas.

La línea de encabezado muestra la dirección actual (RX o TX), el nivel RMS en dBFS y el nivel pico en dBFS. El pie de página muestra la frecuencia de muestreo, la duración de la ventana y el tiempo por división.

Dos búferes circulares separados (uno para RX y otro para TX) se ejecutan en paralelo. La pantalla dibuja desde el búfer que coincida con el estado de transmisión actual. Cuando cambia de recepción a transmisión, el tinte cambia y la pantalla comienza inmediatamente a dibujar desde el búfer de TX.

Para abrir o cerrar el applet, haga clic en el botón de la bandeja WAVE en la fila 1 de la barra lateral derecha. El applet está activado por defecto y se inserta inmediatamente después del botón EQ en la primera ejecución después de actualizar a la versión v0.9.1.

El applet ya no impone una altura fija; se redimensiona verticalmente con el diseño.

Modo ligero¶

A partir de la versión v26.6.3, puede deshabilitar completamente el applet de forma de onda para conservar recursos de CPU. En el modo ligero:

El applet está oculto (setVisible(false)).
El flujo de muestras del motor de audio se descarta: las muestras añadidas se ignoran y el bucle de repintado de software de 24 Hz se detiene por completo.
La señal AudioEngine::{tx,rx}PostChainScopeReady ascendente aún se activa por cada callback de audio, pero el applet no realiza ningún trabajo.

Para activar el modo ligero, llame a setActive(false) desde la aplicación anfitriona. Mientras esté inactivo, el botón de la bandeja WAVE está oculto y no se produce ningún procesamiento de forma de onda.

Qué hace cada control¶

Control	Comportamiento	Notas
Pantalla de forma de onda	Renderiza muestras de osciloscopio PCM mono float-32. Muestra la forma de onda mín/máx, envolvente RMS, marcadores de pico y resaltados de recorte en el modo de vista activo.	La dirección TX tiene un tinte diferente al de RX para que el lado actual sea obvio sin leer una etiqueta. La lectura del encabezado muestra RX/TX, RMS dBFS y PK dBFS.
Un clic en la pantalla	Alterna entre en vivo y en pausa. Mientras está en pausa, se mantiene una instantánea del búfer hasta que haga clic de nuevo.	Aparece una insignia PAUSED en el pie de página. El estado predeterminado es en vivo.
Doble clic en la pantalla	Abre o cierra el panel de configuración.	No borra el búfer. Para restablecer la pantalla, use el slot `WaveformWidget::clear()` o vuelva a conectar.
Vista	Selecciona el modo de visualización de la forma de onda: Scope (Gráfico = líneas mín/máx + RMS), Envelope (área rellena de pico/RMS), History (barras de nivel horizontales), Bands (barras de banda de frecuencia mediante filtro Goertzel).	Ubicado en el panel de configuración plegable debajo de la forma de onda. Se persiste como `WaveApplet_ViewMode`.
Zoom	Escala el eje de amplitud; los valores más altos estiran las señales pequeñas verticalmente, haciendo que los artefactos de recorte aparezcan antes.	Ubicado en el panel de configuración. Valor predeterminado 170% (1.7x). Se persiste como `WaveApplet_ZoomPercent`.
FPS	Controla la frecuencia con la que se repinta la forma de onda; los valores más bajos reducen la carga de CPU en sistemas lentos.	Ubicado en el panel de configuración. Se persiste como `WaveApplet_RefreshRateHz`.
Ventana	Establece la duración de la ventana de tiempo. Pasos discretos: 240 ms, 480 ms, 1 s, luego incrementos de 1 segundo hasta 10 s.	Ubicado en el panel de configuración. Se persiste como `WaveApplet_TimeWindowMs`. Valor predeterminado 1000 ms (1 s).

Controles del panel de configuración¶

El panel de configuración contiene los siguientes controles:

Vista: cuadro combinado — Selecciona el modo de visualización de la forma de onda. Opciones: Scope, Envelope, History, Bands. Se persiste como WaveApplet_ViewMode.
Zoom: control deslizante — Escalado de amplitud de 1.0x a 6.0x. Valor predeterminado 1.7x (170%). Se persiste como WaveApplet_ZoomPercent. Los cambios se guardan inmediatamente en la configuración.
FPS: control deslizante — Frecuencia de actualización de 5 a 30 Hz. Valor predeterminado 24 Hz. Se persiste como WaveApplet_RefreshRateHz. Los cambios se guardan inmediatamente en la configuración.
Ventana: control deslizante — Duración de la ventana de tiempo. Pasos: 240 ms, 480 ms, 1 s, 2 s, 3 s, 4 s, 5 s, 6 s, 7 s, 8 s, 9 s, 10 s. Valor predeterminado 1 s. Se persiste como WaveApplet_TimeWindowMs.

En el lanzamiento inicial después de actualizar desde una versión que usaba WaveApplet_TimeWindowSec, su configuración de ventana anterior se migra al paso disponible más cercano en el nuevo sistema de pasos discretos.

Los estilos de los controles deslizantes ahora se adaptan al tema: los colores de la ranura, la subpágina y el manipulador se adaptan al tema activo en lugar de usar la paleta fija #203040/#00b4d8/#c8d8e8. Los colores de las etiquetas también siguen los tokens color.text.primary y color.text.secondary del tema.

Estado del panel de configuración¶

El panel de configuración recuerda si estaba abierto o cerrado la última vez que cerró el applet. Si cierra el applet con el panel abierto, estará abierto la próxima vez que abra el applet. Si cierra el applet con el panel cerrado, permanecerá cerrado en el próximo inicio. El estado se persiste como WaveApplet_DrawerExpanded.

Indicadores¶

Tinte de dirección — La pantalla usa un tinte frío para RX y un tinte cálido para TX para que la ruta de audio activa sea inequívoca sin leer la etiqueta del encabezado.
Resaltado de recorte — Cualquier columna de píxeles que contenga muestras en o por encima del umbral de recorte se resalta en rojo en los bordes superior e inferior del gráfico. También aparece un contador CLIP N en el encabezado, en negrita roja, que muestra el número de muestras recortadas en la ventana actual.
Insignia PAUSED — Se muestra en el pie de página cuando la pantalla está congelada en una instantánea. Sin insignia significa que la pantalla está en vivo.
Marcador de posición sin audio — Si no han llegado muestras en el último segundo, o el búfer de la pantalla está vacío, un mensaje de marcador de posición reemplaza la traza vacía. Para la ruta RX, el mensaje dice "Enable PC Audio". Para la ruta TX, el mensaje dice "no TX audio".

Consejos¶

El color y el grosor de línea de la forma de onda siguen la configuración de pantalla DisplayFftFillColor y DisplayFftLineWidth utilizadas en otras partes de AetherSDR. El rango válido de grosor de línea es de 1.0 a 3.0 px; el valor predeterminado es 2.0.
Las líneas de cuadrícula se pueden suprimir mediante DisplayShowGrid. Cuando está habilitado, la pantalla dibuja líneas de cuadrícula principales y secundarias detrás de la traza.
Un clic para pausar es particularmente útil para capturar un transitorio: haga clic inmediatamente después del evento, inspeccione la forma de onda congelada y luego haga clic de nuevo para reanudar.
Un doble clic en la pantalla abre o cierra el panel de configuración. Para borrar el búfer de forma de onda, use el slot WaveformWidget::clear() o vuelva a conectar al motor de audio.
El control deslizante de Ventana proporciona solo pasos discretos; no permite el desplazamiento libre a través de valores de milisegundos. Use el paso más cercano que capture el lapso de tiempo que necesita.
El intervalo de discriminación de clic utilizado para iniciar el temporizador de alternancia de pausa se lee de la configuración de intervalo de discriminación de clic de Radio Setup. Esto le permite ajustar el tiempo de doble clic en todos los applets sin reiniciar AetherSDR.
Use el modo ligero (setActive(false)) para deshabilitar completamente el applet de forma de onda y detener todo el procesamiento de muestras si no necesita el osciloscopio. El applet está activo por defecto.