Descripción general 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 en uno de cuatro modos de vista (Scope, Envelope, History bars, Bands spectrum). Ú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 representa una ventana de tiempo desplazable 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 dibujadas encima.

La línea de encabezado muestra la dirección actual (RX o TX), el nivel RMS en dBFS y el nivel de pico en dBFS. El pie de página muestra la tasa 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 — funcionan 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 v0.9.1.

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

Qué hace cada control¶

Control	Comportamiento	Notas
Pantalla de forma de onda	Muestra 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 activo 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 vivo y pausado. Mientras está pausado, 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 vivo.
Doble clic en la pantalla	Alterna el panel de configuración abierto o cerrado.	No borra el búfer. Para restablecer la pantalla, use el slot WaveformWidget::clear() o reconéctese.
View	Selecciona el modo de visualización de la forma de onda: Scope (Graph = líneas mín/máx + RMS), Envelope (área rellena de pico/RMS), History (barras de nivel horizontales), Bands (barras de bandas de frecuencia mediante filtro Goertzel).	Ubicado en el panel de configuración plegable debajo de la forma de onda. Se conserva como `WaveApplet_ViewMode`.
Zoom	Escala el eje de amplitud; los valores más altos estiran verticalmente las señales pequeñas, haciendo que los artefactos de recorte aparezcan antes.	Ubicado en el panel de configuración. Valor predeterminado 170% (1.7x). Se conserva 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 la CPU en sistemas lentos.	Ubicado en el panel de configuración. Rango 5–60 Hz. Valor predeterminado 25 Hz. Se conserva como `WaveApplet_RefreshRateHz`.
Window	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 conserva como `WaveApplet_TimeWindowMs`. Valor predeterminado 1000 ms (1 s).

Controles del panel de configuración¶

El panel de configuración contiene los siguientes controles:

View cuadro combinado — Selecciona el modo de visualización de la forma de onda. Opciones: Scope, Envelope, History, Bands. Se conserva como WaveApplet_ViewMode.
Zoom control deslizante — Escalado de amplitud de 1.0x a 6.0x. Valor predeterminado 1.7x (170%). Se conserva como WaveApplet_ZoomPercent. Los cambios se guardan inmediatamente en la configuración.
FPS control deslizante — Frecuencia de actualización de 5 a 60 Hz. Valor predeterminado 25 Hz. Se conserva como WaveApplet_RefreshRateHz. Los cambios se guardan inmediatamente en la configuración.
Window 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 conserva como WaveApplet_TimeWindowMs.

En el lanzamiento inicial después de actualizar desde una versión que usaba WaveApplet_TimeWindowSec, la 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 son compatibles con el tema: los colores de la ranura, la subpágina y el controlador se adaptan al tema activo en lugar de usar la paleta fija #203040/#00b4d8/#c8d8e8. Los colores de las etiquetas siguen de manera similar 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 cuando cerró el applet por última vez. 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 siguiente lanzamiento. El estado se conserva como WaveApplet_DrawerExpanded.

Indicadores¶

Tinte de dirección — La pantalla usa un tinte frío para RX y un tinte cálido para TX, de modo 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, 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 "no RX audio". Para la ruta TX, el mensaje dice "no TX audio".

Consejos¶

El color y el grosor de la línea de la forma de onda siguen las configuraciones 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 la cuadrícula se pueden suprimir mediante DisplayShowGrid. Cuando está habilitado, la pantalla dibuja líneas de cuadrícula mayores y menores detrás de la traza.
Un solo clic para pausar es particularmente útil para capturar un transitorio: haga clic inmediatamente después del evento, inspeccione la forma de onda congelada, luego haga clic de nuevo para reanudar.
Un doble clic en la pantalla alterna el panel de configuración. Para borrar el búfer de la forma de onda, use el slot WaveformWidget::clear() o reconéctese al motor de audio.
El control deslizante Window solo proporciona 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 clics utilizado para iniciar el temporizador de alternancia de pausa se lee de la configuración del intervalo de discriminación de clics de Radio Setup. Esto le permite ajustar el tiempo de doble clic en todos los applets sin reiniciar AetherSDR.
El control deslizante FPS ahora alcanza hasta 60 Hz para usuarios que desean un osciloscopio más rápido. El valor predeterminado es 25 Hz — una cadencia tranquila y de baja sobrecarga que coincide con la tasa típica del panadapter de radio. Los usuarios que guardaron previamente un valor de FPS explícito lo conservan; el valor predeterminado solo se aplica cuando falta la clave de configuración.