TouchDesigner : Video Device In TOP, synchronisation de capture et diagnostic

Identifier la capture et la portée de chaque contrôle

Commencez par identifier la carte de capture et le parcours en défaut : source, entrée sélectionnée, nœud et destination physique. Conservez projet et paramètres initiaux avant de comparer les modes.

Notez fabricant et modèle complet de chaque carte, pilote, système d’exploitation et build TouchDesigner. Un nom comme « DeckLink 4K » ne suffit pas pour choisir le manuel ou confirmer les fonctions. Si le parcours utilise générateur, GPU synchronisé, processeur LED ou caméra, relevez aussi modèles, firmwares et connexions ; identifiez l’entrée de référence de chaque équipement.

La documentation officielle Video Device In TOP distingue les contrôles de capture selon bibliothèque et périphérique. Utilisez la référence Latest des sources et vérifiez les options du build installé : ne supposez pas que 2025.30000 présente tous les contrôles de la même façon.

Avant l’essai, vérifiez dans la documentation de la carte les modes admis avec ce pilote. La liste des fabricants de l’opérateur oriente le choix de bibliothèque sans confirmer toutes les combinaisons de modèles.

Transfer Mode : attendre l’arrivée d’une image avec le mode AJA

Derivative le restreint à AJA : le processus attend une image de cette entrée puis l’utilise pour traiter le nœud. La description prévient d’une possible dégradation des performances.

Pour ce mode, le fabricant demande de désactiver Real-time dans la barre supérieure et de n’utiliser qu’un nœud dans ce mode par processus. Conservez ces deux conditions avec le nom du contrôle. Ce n’est pas une instruction générale pour toute capture ou pour Sync Inputs.

Si l’option manque, notez build, Driver, Device et modèle exact avant de chercher un autre menu. Le fait qu’une carte Blackmagic capture une image ne lui donne pas ce mode AJA.

Essai proposé : conservez d’abord fichier et paramètres initiaux. Si la documentation du matériel réel confirme le mode, comparez comportement du processus et compteurs avec la configuration convenue, hors programme. Relevez séparément sortie physique et caméra ; ce guide ne promet pas une latence totale nulle.

Sync Inputs : groupes de capture et comportement lors d’un timeout

La même page, Sync Inputs, décrit la synchronisation de plusieurs Video Device In TOP dans un système. Les sources doivent être genlocked. Le document lu cite Blackmagic, DataPath, Deltacast et BlueFish pour cette fonction ; ne la confondez pas avec la restriction AJA d’ondemandsync.

Sync Group Index sépare les groupes dans le fichier .toe. Max Sync Offset (ms) fixe l’écart admissible entre arrivées pour considérer les images comme appartenant à la même image. Sync Timeout (ms) fixe l’attente du groupe.

Derivative indique qu’à expiration du timeout en attendant les images du groupe, tous ses nœuds conservent l’image actuelle, même si certaines entrées ont reçu de nouvelles images. Si l’image se fige au regroupement, notez les entrées qui fournissent un signal et l’augmentation éventuelle de sync_timeouts. Cela prépare la comparaison suivante sans identifier encore câble ou carte défectueux.

Nous proposons de commencer par une entrée puis d’ajouter les autres une à une, en conservant signal et configuration à chaque étape. Identifiez groupe et changement coïncidant avec le gel. Vérifiez référence et format dans les manuels des sources et cartes ; regrouper les nœuds ne remplace pas ces vérifications.

Info CHOP : lire connexion, cadences et compteurs avant d’attribuer une panne

Dans Specific Video Device In TOP Info Channels, Derivative explique les canaux de l’Info CHOP associé. connected vaut 1 quand le nœud se connecte au périphérique ; cela ne confirme pas une entrée valide. Comparez cette donnée à l’image et aux informations de signal disponibles du matériel et du pilote.

signal_fps indique la cadence du format et vaut 0 si elle est inconnue. capture_fps compte les images capturées pendant la dernière seconde ; ne le substituez pas au format choisi. Conservez aussi Signal Format, dont la valeur entrelacée s’exprime en champs par seconde dans la documentation du paramètre.

Relevez début et fin d’un intervalle noté, avec mêmes contenu et configuration. Conservez les deux lectures avant Reset Stats, qui remet à zéro les statistiques de l’Info CHOP associé. Comparez l’incrément de chaque compteur dans cet intervalle.

Les compteurs indiquent des étapes distinctes. Si l’un augmente, conservez cadences et charge du projet avant de décider quoi changer. Une image répétée peut être normale si l’application affiche plus d’images par seconde qu’elle n’en reçoit.

Consigner l’essai et vérifier la destination physique

Remplissez la fiche TouchDesigner de capture et synchronisation vierge. Notez entrée, processus et chaque destination : une observation dans l’opérateur ne prouve ni l’image envoyée à la salle ni celle enregistrée par caméra.

Pour le récepteur d’image, suivez le guide VENICE ; ses contrôles conservent leur modèle et version. Le guide GEN10 aide à relever la référence, et celui du congrès avec LED, enregistrement et streaming (en espagnol) sépare les destinations pour préparer le traitement et la distribution vidéo.

Pour vérifier tout le parcours, reliez les lectures de capture à une image ou un clip reconnaissable à chaque destination. Le guide des sorties GPU, Video Device Out et Sync II distingue les contrôles de sortie ; ne transposez pas à TouchDesigner le résultat d’un autre programme.

Capture noire au changement d’ordinateur : relever le format avant redémarrage

Si l’image disparaît au changement d’ordinateur, comparez d’abord chaque source connectée en fixe à la même entrée de capture. Relevez modèle de carte, pilote, build TouchDesigner et format complet de chaque source.

Avant de modifier Active, conservez Driver, Device, Signal Format, image, erreur et lectures Info CHOP. Notez le format indiqué par la source ou le périphérique à chaque position du commutateur. « 1080p » ne précise ni cadence exacte ni format de pixel, qui peuvent différer entre les deux ordinateurs.

Derivative, Video In > Signal Format, définit résolution, cadence et progressif ou entrelacé ; en entrelacé, la cadence s’exprime en champs par seconde. Dans Specific Info Channels, rgb_input vaut 1 pour RGB, 0 pour YUV/YCbCr et -1 si inconnu ou non pris en charge par la bibliothèque. connection_changes n’est pas non plus disponible sur tous les périphériques. Notez cette absence d’information sans la transformer en cause.

Nous proposons de tester chaque source fixe puis la commutation. Si les deux capturent séparément et que le changement fait perdre l’image, conservez ce changement avant de réactiver la capture. Si l’une échoue déjà en fixe, examinez d’abord son parcours. Aucun résultat ne désigne à lui seul une panne d’EDID, HDCP, câble ou pilote.

Utilisez la fiche de changement de source et capture vierge et le guide des états DeckLink pour distinguer entrée vidéo et référence. L’essai doit se faire hors programme et finir par la vérification de la capture et de chaque destination.

Changement de format DeckLink : détection et redémarrage relèvent de l’application

Le SDK de mars 2026, 2.4.6, page 25, décrit la détection automatique sur certains périphériques. L’application vérifie BMDDeckLinkSupportsInputFormatDetection, installe IDeckLinkInputCallback et active l’entrée avec bmdVideoInputEnableFormatDetection. La section 2.5.10.2, page 82 exige de vérifier la prise en charge pour le périphérique et le pilote précis.

VideoInputFormatChanged signale un changement détecté ; cela ne signifie pas que l’application a déjà reconfiguré la capture. Si mode ou format de pixel change, le SDK propose PauseStreams → EnableVideoInput avec mode et format de pixel détectés → FlushStreams → StartStreams. Cette séquence vise les développeurs intégrant le SDK ; ce n’est pas un menu TouchDesigner ni une commande à exécuter dans le projet.

Pour l’assistance, demandez mode détecté, mode activé, format de pixel, code de retour et état de capture de part et d’autre du changement. Build réel et bibliothèque restent à vérifier.

Si la carte doit recevoir un format convenu malgré les changements de source, préparez l’essai avec le scaler MD-HX. Cela exige de vérifier entrée, sortie et parcours du modèle précis sans remplacer le diagnostic de capture ni confirmer une transition sans coupure.