Capítulo 9
Solución de problemas
Salidas en la pantalla equivocada, pantallas en espejo, el indicador de salud del playback, los logs y la marca de agua de Learn.
Una salida se abre en la pantalla equivocada
- Selecciona la salida y abre Display en el Inspector.
- Haz clic en la pantalla correcta del mapa (o elígela en Monitor).
- Si el Inspector dice Not connected: opens on …, la pantalla que recuerda la salida (por su nombre) no está conectada o tiene otro nombre. Vuelve a elegirla.
En una máquina de show, pixelwright-node --list-monitors muestra los nombres, resoluciones y posiciones de las pantallas conectadas.
Linux: en Wayland las aplicaciones no pueden colocar sus ventanas, así que el compositor decide dónde aparece cada salida. Para shows, usa una sesión X11.
Dos pantallas muestran lo mismo
El Inspector dice Mirrored with …: las pantallas están en modo espejo (duplicar) y no pueden llevar salidas distintas. Desactiva el espejo en el sistema:
- macOS: Ajustes del Sistema → Pantallas, «Usar como: pantalla ampliada». Deja activado «Las pantallas tienen Spaces independientes» (Escritorio y Dock); viene así por defecto.
- Windows: Configuración → Pantalla, «Extender estas pantallas».
- Linux: los ajustes de pantalla de tu escritorio, o
xrandr.
Una salida a pantalla completa tapa el estudio
Si pones a pantalla completa una salida en la pantalla donde está el estudio, lo tapa y Esc no la cierra. Apaga el Window de la salida desde otra pantalla, o usa Output → Close all windows. El Inspector te lo avisa antes de que pase (The studio is on this display).
El indicador de salud del playback está en ámbar o rojo
La barra de estado vigila el playback todo el rato:
| Dice | Significa | Qué hacer |
|---|---|---|
| Playback OK (verde) | Todos los frames a tiempo | Nada |
| dropped frames/s (ámbar) | Frames mostrados tarde o saltados | Normalmente la GPU o la pantalla van justas: menos capas o más pequeñas, menos fps en el envío NDI/Syphon, cierra otras apps que usen la GPU |
| late frames/s (ámbar) | Frames renderizados tarde | Lo mismo que arriba |
| Decoder behind (n layers) (ámbar) | Al decodificador de una capa de vídeo no le quedan frames listos | El disco no da para esa media: usa un SSD más rápido, BPV (ocupa menos que HAP) o menos capas 4K |
| Damaged media (n/s skipped) (rojo) | Un archivo tiene frames dañados; se saltan | Vuelve a codificar o a copiar el archivo |
El indicador se estabiliza unos segundos después de abrir un show o de dar saltos; júzgalo con la reproducción estable. Para un veredicto de verdad, haz una prueba larga en la máquina de show: pixelwright-node --project MiShow/MiShow.bp --soak 10.
Un clip marcado Not show-safe en el panel Media o en el Inspector está en un códec que el motor no reproduce (H.264, ProRes…). Usa To BPV (o HAP) para transcodificarlo.
Logs
Cada ejecución del estudio o del nodo escribe un log:
- Help → Open log folder abre la carpeta (se guardan las 50 sesiones más recientes):
- macOS:
~/Library/Application Support/PixelWright/logs - Windows:
%APPDATA%\PixelWright\logs - Linux:
~/.config/pixelwright/logs
- macOS:
- Con un show abierto, las mismas líneas van también a
MiShow/logs/, así que el log viaja con el show. - Help → Show log, o la pestaña Log del espacio Live, lo muestra dentro del estudio, con filtros por nivel y por texto.
El log recoge la versión, el sistema, la CPU y la GPU, la apertura y el guardado del show, las importaciones y transcodificaciones, cada comando de control externo con su origen, los cambios de transporte, los cambios de salud del playback y los errores de media. Un cierre inesperado se escribe con su backtrace. Arranca con --verbose para registrar además cada frame perdido.
Si pides soporte, envía el log de la sesión que falló.
Las salidas dicen «PixelWright · Learn»
La máquina está en modo Learn: no hay una licencia válida. Abre Help → License… para ver por qué (por ejemplo: caducada, emitida para otra máquina) y actívala (mira Instalación y primer arranque). Las salidas que muestran NO LICENCE · LEARN: 1 OUTPUT son las salidas de más que Learn no renderiza.
Activar tiene efecto al momento. Al revés es lento a propósito: una licencia que caduca o se elimina con el show en marcha solo tiene efecto en el siguiente arranque o carga de show, así que nunca para un show.
Un atajo o una edición no hace nada
Mira la barra superior: si hay una etiqueta roja LOCKED, Show Lock está activado y la edición queda en solo lectura. Desactívalo con Ctrl+Shift+L o Edit → Show Lock.