TouchDesigner: Video Device In TOP, sincronización de captura y diagnóstico

Identificar la captura y el alcance de cada control

Empezá por identificar la tarjeta de captura y el recorrido que falla: fuente, entrada seleccionada, nodo y destino físico. Guardá el proyecto y los parámetros iniciales antes de comparar modos.

Anotá fabricante y modelo completo de cada capturadora, driver, sistema operativo y build de TouchDesigner. Una denominación como «DeckLink 4K» no alcanza para elegir un manual ni confirmar funciones. Si el recorrido usa un generador, GPU sincronizada, procesador LED o cámara, registrá también sus modelos, firmware y conexiones; identificá dónde entra la referencia en cada equipo.

La documentación oficial Video Device In TOP distingue los controles de captura según la biblioteca y el dispositivo. Usá la referencia Latest indicada en Fuentes y cotejá las opciones con el build instalado: no supongas que 2025.30000 presenta todos los controles de la misma forma.

Antes del ensayo, comprobá en la documentación de la tarjeta qué modos admite con ese driver. La lista de fabricantes del operador orienta la selección de biblioteca, pero no confirma todas las combinaciones de modelos.

Transfer Mode: esperar la llegada de un cuadro con el modo AJA

Derivative lo restringe a AJA: el proceso espera la llegada de un cuadro por esa entrada y después lo usa para procesar el nodo. La descripción advierte que el rendimiento puede empeorar.

Para ese modo, el fabricante indica desactivar Real-time en la interfaz superior y usar sólo un nodo con ese modo por proceso. Conservá esas dos condiciones junto al nombre del control. No son una instrucción general para cualquier captura ni para Sync Inputs.

Si no encontrás la opción, anotá build, Driver, Device y modelo exacto antes de buscar otro menú. Que una tarjeta Blackmagic capture imagen no le concede este modo AJA.

Como ensayo propuesto, guardá primero el archivo y los parámetros iniciales. Si la documentación del equipo real respalda el modo, compará el comportamiento del proceso y sus contadores con la configuración acordada, fuera de programa. Conservá por separado el resultado en la salida física y en cámara; esta guía no promete una latencia total nula.

Sync Inputs: grupos de capturas y comportamiento ante un timeout

La misma página, Sync Inputs, describe la sincronización de varios Video Device In TOP en un sistema. Las fuentes deben estar genlocked. La documentación leída enumera Blackmagic, DataPath, Deltacast y BlueFish para esta función; no la confundas con la restricción AJA de ondemandsync.

Sync Group Index separa los grupos dentro del archivo .toe. Max Sync Offset (ms) establece cuánto pueden diferir los tiempos de llegada para considerar que las imágenes pertenecen al mismo cuadro. Sync Timeout (ms) fija la espera del grupo.

Derivative indica que, si vence el timeout esperando cuadros del grupo, todos sus nodos conservan la imagen actual, aunque algunas entradas hayan recibido imágenes nuevas. Si aparece una imagen detenida al agrupar capturas, registrá qué entradas entregan señal y si aumenta sync_timeouts. Esa observación ayuda a preparar la siguiente comparación; todavía no identifica un cable o una tarjeta averiados.

Proponemos empezar con una entrada y agregar las otras de a una, conservando señal y configuración en cada paso. Identificá qué grupo y qué cambio coinciden con la detención. Revisá los manuales de las fuentes y capturadoras para comprobar su referencia y formato; agrupar nodos no reemplaza esas verificaciones.

Info CHOP: leer conexión, tasas y contadores antes de atribuir una falla

En Specific Video Device In TOP Info Channels, Derivative explica los canales del Info CHOP asociado. connected vale 1 cuando el nodo conecta al dispositivo; eso no confirma una entrada válida. Compará ese dato con la imagen y los datos de señal que el hardware y su driver puedan informar.

signal_fps informa la tasa del formato y vale 0 si es desconocida. capture_fps cuenta los cuadros capturados en el último segundo; no lo uses como sustituto del formato seleccionado. Guardá también Signal Format, cuyo valor entrelazado se expresa en campos por segundo en la documentación del parámetro.

Tomá una lectura al comienzo y otra al final de un intervalo anotado, con el mismo contenido y configuración. Guardá ambas antes de usar Reset Stats, que reinicia las estadísticas del Info CHOP asociado. Compará el incremento de cada contador dentro de ese intervalo.

Los contadores señalan etapas diferentes. Si sube uno, conservá las tasas y la carga del proyecto antes de decidir qué cambiar. Un cuadro repetido puede ser esperado cuando la aplicación muestra más cuadros por segundo que los que recibe.

Registrar la prueba y comprobar el destino físico

Completá la ficha TouchDesigner de captura y sincronización, vacía. Anotá la entrada, el proceso y cada destino: una observación en el operador no prueba la imagen enviada al salón o la registrada por cámara.

Para el receptor de imagen, seguí la guía VENICE; sus controles conservan su modelo y versión. La guía GEN10 ayuda a registrar la referencia, y la de congreso con LED, grabación y streaming separa los destinos al preparar el procesamiento y distribución de video.

Para comprobar el recorrido completo, vinculá las lecturas de captura con una imagen o clip reconocible en cada destino. La guía de salida GPU, Video Device Out y Sync II separa los controles de salida; no trasladés el resultado de otro programa a TouchDesigner.

La captura queda negra al cambiar la notebook: registrar el formato antes de reiniciarla

Si la imagen se pierde al conmutar entre notebooks, compará primero ambas fuentes conectadas de forma fija a la misma entrada de captura. Registrá modelo de capturadora, driver, build de TouchDesigner y formato completo de cada fuente.

Antes de cambiar Active, guardá Driver, Device, Signal Format, imagen, error y lecturas de Info CHOP. Anotá el formato que informa la fuente o el dispositivo en cada posición del switch. «1080p» deja sin precisar la tasa exacta y el formato de píxel, que pueden cambiar entre las dos notebooks.

Derivative, Video In > Signal Format, define resolución, tasa y progresivo o entrelazado; en entrelazado la tasa se expresa en campos por segundo. En Specific Info Channels, rgb_input vale 1 para RGB, 0 para YUV/YCbCr y -1 si se desconoce o la biblioteca no lo admite. connection_changes tampoco está soportado en todos los dispositivos. Anotá esa falta de información en vez de convertirla en una causa.

Proponemos probar cada fuente fija primero y después la conmutación. Si las dos capturan por separado y la imagen se pierde al cambiar, conservá el registro del cambio antes de reactivar la captura. Si alguna falla también fija, revisá primero ese recorrido. Ninguno de esos resultados identifica por sí solo una falla de EDID, HDCP, cable o driver.

Usá la ficha de cambio de fuente y captura, vacía, y la guía de estados DeckLink para separar entrada de video y referencia. El ensayo debe quedar fuera de programa y terminar con comprobación en la captura y en cada destino.

Cambio de formato en DeckLink: detección y reinicio pertenecen a la aplicación

El SDK de marzo de 2026, 2.4.6, página 25, describe detección automática para ciertos dispositivos. La aplicación comprueba BMDDeckLinkSupportsInputFormatDetection, instala IDeckLinkInputCallback y habilita la entrada con bmdVideoInputEnableFormatDetection. El apartado 2.5.10.2, página 82 exige comprobar soporte para el dispositivo y driver concretos.

VideoInputFormatChanged notifica un cambio detectado; no significa que la aplicación ya haya reconfigurado la captura. Si cambia el modo o formato de píxel, el SDK propone PauseStreams → EnableVideoInput con el modo y formato de píxel detectados → FlushStreams → StartStreams. Es una secuencia para quien integra el SDK; no es un menú de TouchDesigner ni debe ejecutarse como una orden dentro del proyecto.

Para soporte, pedí modo detectado, modo habilitado, formato de píxel, código de retorno y estado de captura a ambos lados del cambio. El build real y su biblioteca siguen pendientes.

Si necesitás que la capturadora reciba un formato acordado aunque cambie la fuente, prepará el ensayo con el scaler MD-HX. Eso requiere comprobar entrada, salida y ruta del modelo concreto; no reemplaza el diagnóstico de la captura ni confirma una transición sin cortes.