TouchDesigner: Video Device In TOP, sincronização de captura e diagnóstico

Identifique a captura e o escopo de cada controle

Comece identificando a placa de captura e o percurso que falha: fonte, entrada selecionada, nó e destino físico. Salve projeto e parâmetros iniciais antes de comparar modos.

Anote fabricante e modelo completo de cada capturadora, driver, sistema operacional e build do TouchDesigner. Um nome como “DeckLink 4K” não basta para escolher manual ou confirmar funções. Se o percurso usar gerador, GPU sincronizada, processador de LED ou câmera, registre também modelos, firmwares e conexões; identifique onde entra a referência em cada equipamento.

A documentação oficial Video Device In TOP diferencia os controles de captura conforme biblioteca e dispositivo. Use a referência Latest indicada nas fontes e confira as opções com o build instalado: não suponha que 2025.30000 apresente todos os controles da mesma forma.

Antes do ensaio, confira na documentação da placa quais modos aceita com aquele driver. A lista de fabricantes do operador orienta a seleção de biblioteca, mas não confirma todas as combinações de modelos.

Transfer Mode: espere a chegada de um quadro com o modo AJA

A Derivative restringe a AJA: o processo espera chegar um quadro por essa entrada e depois usa para processar o nó. A descrição alerta que o desempenho pode piorar.

Para esse modo, o fabricante indica desativar Real-time na interface superior e usar apenas um nó com esse modo por processo. Preserve as duas condições junto ao nome do controle. Não são instrução geral para qualquer captura nem para Sync Inputs.

Se não encontrar a opção, anote build, Driver, Device e modelo exato antes de procurar outro menu. Uma placa Blackmagic capturar imagem não concede a ela esse modo AJA.

Como ensaio proposto, salve primeiro arquivo e parâmetros iniciais. Se a documentação do equipamento real respaldar o modo, compare comportamento do processo e contadores com a configuração combinada, fora do programa. Preserve separadamente o resultado na saída física e na câmera; este guia não promete latência total nula.

Sync Inputs: grupos de capturas e comportamento em um timeout

A mesma página, Sync Inputs, descreve a sincronização de vários Video Device In TOP em um sistema. As fontes devem estar genlocked. A documentação lida enumera Blackmagic, DataPath, Deltacast e BlueFish para a função; não confunda com a restrição AJA de ondemandsync.

Sync Group Index separa grupos dentro do arquivo .toe. Max Sync Offset (ms) define quanto os tempos de chegada podem diferir para considerar que as imagens pertencem ao mesmo quadro. Sync Timeout (ms) define a espera do grupo.

A Derivative indica que, se o timeout vencer esperando quadros do grupo, todos os nós mantêm a imagem atual, mesmo que algumas entradas tenham recebido novas imagens. Se a imagem parar ao agrupar capturas, registre quais entradas entregam sinal e se sync_timeouts aumenta. A observação ajuda a preparar a próxima comparação; ainda não identifica cabo ou placa com defeito.

Propomos começar com uma entrada e adicionar as outras uma por vez, preservando sinal e configuração em cada etapa. Identifique qual grupo e qual mudança coincidem com a parada. Revise os manuais de fontes e capturadoras para conferir referência e formato; agrupar nós não substitui essas verificações.

Info CHOP: leia conexão, taxas e contadores antes de atribuir uma falha

Em Specific Video Device In TOP Info Channels, a Derivative explica os canais do Info CHOP associado. connected vale 1 quando o nó conecta ao dispositivo; isso não confirma entrada válida. Compare o dado com a imagem e os dados de sinal que hardware e driver puderem informar.

signal_fps informa a taxa do formato e vale 0 se desconhecida. capture_fps conta os quadros capturados no último segundo; não use como substituto do formato selecionado. Salve também Signal Format, cujo valor entrelaçado é expresso em campos por segundo na documentação do parâmetro.

Faça uma leitura no início e outra no final de um intervalo anotado, com o mesmo conteúdo e configuração. Salve ambas antes de usar Reset Stats, que reinicia as estatísticas do Info CHOP associado. Compare o incremento de cada contador nesse intervalo.

Os contadores indicam etapas diferentes. Se um subir, preserve taxas e carga do projeto antes de decidir o que mudar. Um quadro repetido pode ser esperado quando a aplicação exibe mais quadros por segundo do que recebe.

Registre o teste e confira o destino físico

Preencha a ficha TouchDesigner de captura e sincronização, em branco. Anote entrada, processo e cada destino: observar no operador não comprova a imagem enviada ao salão nem a registrada pela câmera.

Para o receptor de imagem, siga o guia VENICE; seus controles mantêm modelo e versão. O guia GEN10 ajuda a registrar a referência, e o de congresso com LED, gravação e streaming (em espanhol) separa os destinos ao preparar o processamento e distribuição de vídeo.

Para conferir o percurso completo, vincule as leituras de captura a imagem ou clipe reconhecível em cada destino. O guia de saída GPU, Video Device Out e Sync II separa os controles de saída; não transfira ao TouchDesigner o resultado de outro programa.

A captura fica preta ao trocar o notebook: registre o formato antes de reiniciar

Se a imagem sumir ao comutar entre notebooks, compare primeiro as duas fontes conectadas de forma fixa à mesma entrada de captura. Registre modelo da capturadora, driver, build do TouchDesigner e formato completo de cada fonte.

Antes de mudar Active, salve Driver, Device, Signal Format, imagem, erro e leituras de Info CHOP. Anote o formato informado pela fonte ou dispositivo em cada posição do switch. “1080p” não informa taxa exata nem formato de pixel, que podem mudar entre os dois notebooks.

Derivative, Video In > Signal Format, define resolução, taxa e progressivo ou entrelaçado; no entrelaçado, a taxa é expressa em campos por segundo. Em Specific Info Channels, rgb_input vale 1 para RGB, 0 para YUV/YCbCr e -1 se desconhecido ou não suportado pela biblioteca. connection_changes também não é suportado em todos os dispositivos. Anote essa falta de informação em vez de transformá-la em causa.

Propomos testar primeiro cada fonte fixa e depois a comutação. Se as duas capturarem separadas e a imagem sumir na troca, preserve o registro da mudança antes de reativar a captura. Se alguma também falhar fixa, revise primeiro esse percurso. Nenhum desses resultados identifica, sozinho, falha de EDID, HDCP, cabo ou driver.

Use a ficha de troca de fonte e captura, em branco, e o guia de estados DeckLink para separar entrada de vídeo e referência. O ensaio deve ficar fora do programa e terminar com verificação na captura e em cada destino.

Mudança de formato no DeckLink: detecção e reinício pertencem à aplicação

O SDK de março de 2026, 2.4.6, página 25, descreve detecção automática para certos dispositivos. A aplicação verifica BMDDeckLinkSupportsInputFormatDetection, instala IDeckLinkInputCallback e habilita a entrada com bmdVideoInputEnableFormatDetection. A seção 2.5.10.2, página 82 exige conferir suporte para dispositivo e driver concretos.

VideoInputFormatChanged notifica uma mudança detectada; não significa que a aplicação já reconfigurou a captura. Se modo ou formato de pixel mudar, o SDK propõe PauseStreams → EnableVideoInput com modo e formato de pixel detectados → FlushStreams → StartStreams. É sequência para quem integra o SDK; não é menu do TouchDesigner nem deve ser executada como comando no projeto.

Para suporte, peça modo detectado, modo habilitado, formato de pixel, código de retorno e estado de captura dos dois lados da mudança. O build real e sua biblioteca seguem pendentes.

Se precisar que a capturadora receba um formato combinado mesmo mudando a fonte, prepare o ensaio com o scaler MD-HX. Isso exige conferir entrada, saída e percurso do modelo concreto; não substitui o diagnóstico da captura nem confirma transição sem cortes.