Video · Guía práctica
DeckLink 8K Pro: Sync Outputs entre tarjetas y perfiles de salida en TouchDesigner
Si Sync Outputs funciona dentro de una DeckLink 8K Pro pero falla al sumar otra, registrá primero la referencia que reconoce cada tarjeta. Después identificá sus subdispositivos y conectores.
DeckLink 8K Pro: perfil, referencia y formato
Identificá cada tarjeta, subdispositivo y conector antes de sumar salidas al grupo. Registrá formato de video y referencia por separado: que haya una señal en el cable no comprueba el estado que informa el driver.
| Dato | Comprobación propuesta |
|---|---|
| Modelo y perfil de cada tarjeta | Comparar con los subdispositivos disponibles |
| Formato por salida y referencia | Registrar la selección y el estado de bloqueo |
| Grupo de sincronización | Probar una tarjeta y después agregar otra, conservando las lecturas previas |
Referencia común entre tarjetas: comprobar cada una por separado
El SDK Blackmagic de marzo de 2026, apartado 2.4.13.2, página 37 distingue el grupo entre dispositivos de la excepción interna de 8K Pro. Exige la misma tasa de cuadros y comprobar bloqueo a referencia cuando corresponde.
Derivative Latest pide Pro para Sync Outputs y describe referencia conectada para Blackmagic. Sync Group Index reúne nodos. Conservá el alcance específico del SDK y registrá cada tarjeta: la descripción por marca no identifica las funciones del modelo.
Proponemos empezar por una tarjeta y después la otra, conservando formato y contenido. Guardá estados y errores en cada paso. Recién cuando la referencia sea reconocida por ambas, prepará la comparación del grupo mixto fuera de programa.
| Comparación propuesta | Qué conservar | Cómo continuar |
|---|---|---|
| Tarjeta A sola | Dispositivo, perfil, formato, referencia y error. | Identificá qué salidas pertenecen a esa tarjeta. |
| Tarjeta B sola | Los mismos datos sin nodos de A. | Si la referencia no se reconoce, investigá esa entrada antes de mezclar. |
| Grupo A+B | Sync Group Index, estado en ambas y contenido recibido. | Guardá el cambio que introduce el error; todavía falta el ensayo prolongado. |
Separar presencia de señal, estado de bloqueo y ajuste de timing
Una medición de señal en el cable y el estado informado por la tarjeta son datos distintos. Registrá el generador, formato distribuido, cable, puerto de referencia y lo que muestra Desktop Video en cada tarjeta.
En Desktop Video, edición marzo de 2026, página 23, Reference Input, el ajuste desplaza el timing de salida respecto de la referencia. El apartado no ofrece ese control como solución para una referencia no reconocida. Conservá el valor inicial; no agregamos un offset por defecto.
El Info CHOP de salida usa genlocked 1, 0 o -1: bloqueo conocido, sin bloqueo o desconocido. Guardá el estado disponible junto con dropped_frames, skipped_frames y las lecturas antes de Reset Stats. Un dato desconocido necesita otro registro; no demuestra una falla.
Perfil de cuatro subdispositivos: identificar los BNC del modelo 8K Pro
El SDK, apartado 2.4.11, página 31 muestra un perfil compartido por los cuatro subdispositivos de 8K Pro. Cambiarlo afecta a todo el grupo y puede modificar modos, enlaces SDI o actividad. Guardá el perfil antes de alterar un puerto.
La tabla siguiente resume únicamente el perfil de cuatro subdispositivos half-duplex del diagrama. No describe otros perfiles ni establece qué nombres presentará una versión de TouchDesigner. Relacioná dispositivo lógico, cable y receptor en una ficha propia.
| Índice de subdispositivo | Conector del diagrama 8K Pro | Alcance del perfil |
|---|---|---|
| 0 | SDI 1 | Entrada o salida; half-duplex. |
| 1 | SDI 3 | Entrada o salida; half-duplex. |
| 2 | SDI 2 | Entrada o salida; half-duplex. |
| 3 | SDI 4 | Entrada o salida; half-duplex. |
Registrar la prueba antes de poner el grupo en programa
Completá la ficha DeckLink de referencia y perfiles, vacía. Agregá duración, contenido, cambios y regreso a la configuración acordada. Separá el requisito del fabricante del resultado de la prueba que hagas en tu montaje.
Usá el diagnóstico general de salida GPU y tarjeta y la guía de captura según el recorrido. La guía GEN10 ayuda a registrar el generador; para un congreso con LED y grabación, anotá cada destino del procesamiento de video.
Antes de poner el grupo en programa, completá versiones, perfiles, modelo del generador y formatos aceptados. Probá el contenido previsto en cada destino y conservá la configuración inicial para poder volver a ella.
Qué informa el SDK: referencia detectada, bloqueo y modo de salida
Para registrar una referencia antes de agrupar salidas, pedí tres datos separados: modo detectado de referencia, estado de bloqueo y modo de salida habilitado. El SDK de marzo de 2026, apartado 3.58, páginas 296–297 asigna un estado a cada uno. Son datos para una aplicación o diagnóstico que use el SDK; no son controles nuevos de TouchDesigner.
bmdDeckLinkStatusReferenceSignalMode identifica el modo detectado en la referencia, si el dispositivo admite esa detección. bmdDeckLinkStatusReferenceSignalLocked informa el bloqueo a referencia. bmdDeckLinkStatusCurrentVideoOutputMode indica el modo de salida habilitado. Anotá la tasa exacta y si es progresivo, entrelazado o PsF; el tamaño de imagen por sí solo no describe el timing.
GetReferenceStatus devuelve una máscara BMDReferenceStatus: el apartado 2.5.3.28, página 59 describe la consulta y el 3.39, página 290 distingue bmdReferenceLocked, bmdReferenceUnlocked y bmdReferenceNotSupportedByHardware. Este último valor indica que el hardware no tiene conector de genlock.
Compará la tasa exacta y el tipo de barrido de la referencia con el modo de salida, además de comprobar qué formatos admite la tarjeta. Para agrupar salidas, el SDK exige la misma tasa de cuadros. Un tamaño de imagen coincidente no demuestra bloqueo ni compatibilidad del recorrido.
Proponemos registrar los estados con la salida habilitada, por tarjeta y fuera de programa. Si se obtiene un estado válido sin bloqueo, revisá referencia, timing y distribución antes de volver a armar el grupo.
| Dato registrado | Qué permite saber | Qué falta comprobar |
|---|---|---|
| Modo de referencia detectado | Formato que informa el dispositivo, si admite detección. | Bloqueo y compatibilidad con la salida elegida. |
| Bloqueo a referencia | Estado válido de referencia del dispositivo. | Continuidad y sincronía de contenido en los destinos. |
| Modo de salida habilitado | Configuración actual de la salida. | Estado de referencia y señal recibida por el destino. |
| Retorno de la consulta a la API | Éxito, error o función no admitida. | Si la consulta falla, conservar el error; no usar su valor como estado válido de bloqueo. |
Entrada de video y referencia: usar el estado del recorrido que falla
Una cámara puede entregar video y la salida seguir sin bloqueo a referencia. Para la captura, el SDK, apartado 3.58, página 296 define bmdDeckLinkStatusVideoInputSignalLocked. Para referencia usa otro identificador: bmdDeckLinkStatusReferenceSignalLocked. Guardá cuál se consultó, en qué dispositivo y con qué entrada seleccionada.
IDeckLinkStatus permite consultar estados del dispositivo. Comprobá que la aplicación use el identificador de entrada o de referencia correspondiente al recorrido que estás diagnosticando.
Para preparar un ensayo de captura con detección automática, seguí el apartado 2.4.6, página 25: comprobá BMDDeckLinkSupportsInputFormatDetection para el dispositivo y driver, configurá el callback, habilitá la entrada con formato inicial y bmdVideoInputEnableFormatDetection, y comenzá la captura. Conservá modo detectado y modo habilitado por separado. Esta secuencia del manual no demuestra que se puedan supervisar todos los conectores al mismo tiempo.
Si estás investigando pérdida de imagen, empezá por el registro de entrada y el receptor de esa señal. Si falla Sync Outputs entre tarjetas, revisá el registro de referencia de las salidas. Un callback de llegada de cuadros o un video visible no sustituye el estado de referencia. Para comparar sin tocar una captura en programa, usá otro intervalo de prueba y anotá una sola entrada seleccionada por registro.
La ficha de estados DeckLink deja lugar para función consultada, retorno, valor y observación. Completala junto con la guía de captura y la ficha de perfiles anterior. Quedan abiertos el modelo y driver reales, las funciones que admiten y el ensayo con contenido del evento.
Preguntas frecuentes
¿Que funcione Sync Outputs dentro de una 8K Pro demuestra que hay referencia externa válida?
El SDK permite sincronizar subdispositivos de una sola 8K Pro sin referencia común externa. Eso no comprueba un grupo entre dos tarjetas. Guardá el estado reconocido por cada una y el formato de salida antes de sumar la segunda.
¿El error al agregar la quinta salida confirma un bug de TouchDesigner?
El error por sí solo no identifica un bug. Probá cada tarjeta por separado con el mismo contenido y formato; después agregá la segunda al grupo. Registrá qué cambio introduce el fallo, el error completo y el estado de referencia de ambas. Si una ya falla sola, revisá esa ruta antes de investigar el grupo.
¿Cuándo tiene sentido ensayar una referencia 720p50?
Sólo cuando el generador y todos los equipos del recorrido admiten ese formato. Compará la referencia con las salidas de video reales y comprobá bloqueo e imagen antes de mantener el cambio.
¿La salida del subdispositivo 1 corresponde a SDI 2?
En el perfil de cuatro subdispositivos half-duplex del diagrama 8K Pro, el índice 1 corresponde a SDI 3 y el índice 2 a SDI 2. Comprobá el perfil instalado antes de relacionar el nombre del nodo con un cable.
¿Puedo cambiar el perfil sin afectar las otras salidas de esa tarjeta?
Los cuatro subdispositivos comparten perfil según el SDK. El cambio puede alterar modos, enlaces y actividad del grupo. Registrá la configuración inicial y revisá cada destino fuera de programa antes de usar otra distribución.
¿Reference Input permite corregir cualquier referencia no detectada?
El manual Desktop Video describe un ajuste de timing de salida respecto de la referencia. No documenta ese ajuste como reparación de señal no reconocida. Guardá el estado y el valor inicial; primero identificá qué referencia recibe la tarjeta.
¿genlocked en -1 significa que se perdió el bloqueo?
Derivative lo define como estado desconocido. Uno indica bloqueo conocido y cero ausencia de bloqueo. Anotá qué tarjeta y operador informan el dato, contrastalo con Desktop Video y conservá las lecturas disponibles antes de Reset Stats.
¿Activar el grupo confirma que el contenido queda sincronizado durante todo el evento?
Todavía falta comprobar la reproducción en los destinos durante un intervalo acordado. Registrá continuidad, estados, contadores y clips por salida; esta ficha no contiene resultados medidos.
¿S_OK en GetReferenceStatus confirma que la DeckLink está bloqueada a referencia?
Leé la máscara BMDReferenceStatus: bmdReferenceLocked indica bloqueo, bmdReferenceUnlocked que no se logró, y bmdReferenceNotSupportedByHardware que el equipo no tiene conector de genlock. Registrá retorno y valor por separado; una consulta fallida a la API no da un estado válido de bloqueo.
¿Qué comparo entre el formato de referencia y el de salida?
Anotá resolución, tasa exacta y tipo de barrido de ambos formatos. Cotejá los modos admitidos por la 8K Pro y comprobá el estado de bloqueo con la salida habilitada. Para el grupo, el SDK exige salidas con la misma tasa de cuadros; la resolución por sí sola no permite aprobar una combinación.
¿VideoInputSignalLocked confirma el genlock de las salidas SDI?
Ese identificador informa bloqueo de la entrada de video. Para referencia, el SDK define ReferenceSignalLocked y GetReferenceStatus. Anotá la función completa, tarjeta y recorrido consultados: una cámara que entrega imagen no comprueba la referencia común de las salidas.
¿La detección automática permite supervisar HDMI mientras Mini Recorder captura SDI?
La detección automática no demuestra supervisión simultánea de ambos conectores. Primero identificá el modelo exacto de Mini Recorder y su driver, y comprobá soporte de detección para la entrada seleccionada. El SDK describe callback y captura habilitada; probá una entrada por registro fuera de programa y dejá la simultaneidad pendiente hasta cotejarla con la documentación del equipo.
Fuentes y manuales
- Blackmagic Design—DeckLink SDK Manual, marzo de 2026; modelo DeckLink 8K Pro.2.4.11 Device Profiles, p31;2.4.13.2 Synchronized Playback, p37. Sólo apartados seleccionados.
- Blackmagic Design—Desktop Video, marzo de 2026, publicado8/4/2026; Reference Input, p23. Control general de timing; no matriz de compatibilidad del driver 14.4.
- Derivative—Video Device Out TOP Latest, edición28/7/2026 14:05; revisión38393 identificada por metadatos. Sync Outputs, Sync Group Index, Reset Stats y Specific Info Channels.
- Blackmagic Design — DeckLink SDK Manual, marzo de 2026. API genérica: 2.5.3.28 GetReferenceStatus, p59; 3.39, p290; 3.58, p296–297; 2.5.41.1–2, p173; 2.4.6, p25. Disponibilidad por dispositivo y driver; no verificación de hardware legado.