Referencia de Configuración del Applet de Forma de Onda¶

El applet de Forma de Onda proporciona un osciloscopio de audio que muestra la forma de onda en el dominio del tiempo de la ruta de audio activa de TX o RX. Ayuda a los operadores a detectar rápidamente recortes, caídas y problemas de nivel de audio.

Descripción General¶

La visualización de forma de onda renderiza muestras PCM mono float-32 recibidas del motor de audio. La dirección de TX se tiñe de manera diferente a RX, haciendo obvio el lado actual sin necesidad de leer una etiqueta. La lectura del encabezado muestra RX/TX, RMS dBFS y PK dBFS.

Interacciones con la Visualización de Forma de Onda¶

Interacción	Comportamiento
Clic simple en la visualización	Alterna la pausa. Una instantánea del búfer se congela hasta que se hace clic nuevamente. Útil para inspeccionar un transitorio. Aparece una insignia "PAUSED" en el pie de página mientras está en pausa.
Doble clic en la visualización	Abre o cierra el panel de configuración. No limpia el búfer; use el slot `WaveformWidget::clear()` o reconéctese para restablecerlo.

El intervalo de discriminación de clic simple se lee de la configuración de discriminación de clic en Radio Setup. Si ajusta este valor en Radio Setup, surte efecto de inmediato sin necesidad de reiniciar la aplicación.

Indicadores de la Visualización de Forma de Onda¶

Indicador	Estados	Significado
Tinte de dirección	RX (tinte frío), TX (tinte cálido)	Desambigua visualmente si la forma de onda mostrada es el monitor de recepción o la ruta de transmisión saliente.
Resalte de recorte	Sin recorte (traza normal), Con recorte (énfasis rojo, etiqueta CLIP N)	Las columnas que contienen muestras en o por encima de ±0.98 de escala completa se resaltan; aparece un contador 'CLIP N' en el encabezado.
Insignia PAUSED	En vivo (sin insignia), En pausa (insignia PAUSED en el pie de página)	Indica que la visualización muestra una instantánea congelada y no la transmisión de audio en vivo.
Marcador de posición sin audio	Forma de onda presente, mensaje 'no RX audio' / 'no TX audio'	Cuando no llegan muestras del alcance en 1 segundo, se muestra un mensaje de marcador de posición en lugar de una traza vacía.

Modo Ligero¶

El applet de forma de onda admite un modo ligero que deshabilita completamente el alcance cuando el applet está oculto. En modo ligero:

El applet se vuelve invisible (setVisible(false)).
El manejador appendScopeSamples se cortocircuita inmediatamente, descartando todos los datos de alcance entrantes en lugar de escribirlos en el búfer de muestras.
El ciclo de repintado de software de 24 Hz se detiene por completo.
La señal AudioEngine::{tx,rx}PostChainScopeReady upstream aún se activa por cada callback de audio, pero el applet omite el trabajo de añadir y repintar.

Esto reduce el uso de CPU cuando la visualización de forma de onda no es visible, ya que no se realiza ningún trabajo de renderizado de forma de onda. Para habilitar el modo ligero, llame a setActive(false) en el applet. El estado predeterminado es activo (m_active{true}).

Use el método isActive() para verificar si el applet está actualmente activo.

Panel de Configuración¶

El panel de configuración se puede abrir o cerrar haciendo doble clic en la visualización de forma de onda. Su estado expandido se conserva entre sesiones usando la configuración WaveApplet_DrawerExpanded. Cuando cierra el panel y reinicia AetherSDR, permanece cerrado hasta que haga doble clic en la visualización para reabrirlo.

Modo de Vista¶

Haga doble clic en la visualización de forma de onda para abrir el panel de configuración.
Localice el cuadro combinado View en la parte superior del panel.
Seleccione uno de los siguientes modos:

Modo	Descripción
Scope	Gráfico = líneas de 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

La configuración se conserva como WaveApplet_ViewMode con los valores 'Graph', 'Envelope', 'History' o 'Bands'.

Control Deslizante de Zoom¶

Haga doble clic en la visualización de forma de onda para abrir el panel de configuración.
Localice el control deslizante Zoom.
Arrastre el control deslizante para ajustar el zoom de amplitud. El valor actual se muestra a la derecha del control deslizante en el formato N.Nx.

Control	Predeterminado	Rango válido	Clave conservada
Zoom	1.7x (170%)	1.0x–6.0x (100–600)	`WaveApplet_ZoomPercent`

Los valores más altos estiran verticalmente las señales pequeñas, haciendo que los artefactos de recorte aparezcan antes. El control deslizante usa el estilo de control deslizante primario del tema actual.

Control Deslizante de FPS¶

Haga doble clic en la visualización de forma de onda para abrir el panel de configuración.
Localice el control deslizante FPS.
Arrastre el control deslizante para ajustar la tasa de actualización. El valor actual se muestra a la derecha del control deslizante en el formato N fps.

Control	Predeterminado	Rango válido	Clave conservada
FPS	24 Hz	5–30 Hz	`WaveApplet_RefreshRateHz`

Los valores más bajos reducen la carga de CPU en sistemas lentos. La configuración no tiene efecto en la captura de audio ni en la precisión del nivel. El control deslizante usa el estilo de control deslizante primario del tema actual.

Control Deslizante de Ventana¶

Haga doble clic en la visualización de forma de onda para abrir el panel de configuración.
Localice el control deslizante Window en la parte inferior del panel.
Arrastre el control deslizante para seleccionar una ventana de tiempo para la visualización de forma de onda.

Control	Predeterminado	Rango válido	Clave conservada
Window	1 s	240 ms, 480 ms, 1 s, 2 s, 3 s, 4 s, 5 s, 6 s, 7 s, 8 s, 9 s, 10 s	`WaveApplet_TimeWindowMs`

El control deslizante usa pasos discretos. Las primeras tres posiciones son de menos de un segundo (240 ms, 480 ms, 1 s), luego incrementos de 1 segundo de 1 a 10 segundos. El valor actual se muestra a la derecha del control deslizante. El control deslizante usa el estilo de control deslizante primario del tema actual.

Configurar una ventana más corta le permite ver detalles finos en la forma de onda. Configurar una ventana más larga muestra la tendencia general y facilita la detección de eventos poco frecuentes.

Nota de migración: Si anteriormente configuró una ventana de tiempo usando la configuración anterior WaveApplet_TimeWindowSec, se convierte automáticamente al paso discreto disponible más cercano en el primer uso. Luego, la clave anterior se elimina de la configuración.

Consejos¶

Un valor de 5–10 fps es suficiente para monitorear niveles promedio y detectar recortes. Use valores más altos solo cuando necesite rastrear visualmente transitorios rápidos.
El control deslizante FPS usa un paso simple de 5 y un paso de página de 10, por lo que presionar las teclas de flecha o Re Pág/Av Pág en el control deslizante lo mueve en esos incrementos.
Las configuraciones de zoom, FPS y ventana son independientes: cambiar una no afecta a las otras.
Use la función de pausa (clic simple en la visualización) para congelar la forma de onda y examinar de cerca un transitorio o anomalía.
Cuando el applet de forma de onda está oculto, entra en modo ligero y detiene todo el trabajo de renderizado de forma de onda, reduciendo el uso de CPU.