Copy Metadata Node

Le Copy Metadataa deux entrées : une image principale (à laquelle on attribuera la nouvelle metadata) et une image source (dont on prend la metadata). L'image visible reste celle de l'input principal ; seul le container metadata est remplacé ou fusionné.

Cas typique : un compositing 3D part d'un Renderer 3D qui n'a pas la metadata du plan original (TimeCode, Source Filename, etc.). On branche le MediaIn original sur l'input Source du Copy Metadata et l'image 3D sur l'input principal → la sortie a l'image 3D + la metadata du plan original.

• Effects Library : Tools > Metadata > Copy Metadata
• Ajout rapide : clic droit dans le Node Editor → Add Tool > Metadata > Copy Metadata

Set Metadata

Une paire Field/Value explicitement écrite. Pour ajouter quelques champs précis.

Copy Metadata

Tous les champsd' une autre image, transférés en bloc. Pour récupérer un container complet sans connaître chaque champ individuellement.

Règle : ajouter quelques champs custom = Set Metadata. Récupérer la metadata complète d' un autre flux = Copy Metadata.

• Image Input (orange)- l'image dont on conserve les pixels.
• Source Input (vert)- l'image dont on copie la metadata vers l'image principale.

Récupérer metadata après Renderer 3D :
MediaIn ─────────────────────────┐
    │                            │
    └── Camera Tracker → ... ─── Renderer 3D ─── Copy Metadata ─── MediaOut
                                                  ↑
                       (Source = MediaIn original)

Récupérer metadata après Background :
Background → ... → Copy Metadata (Source = MediaIn) → MediaOut

Préserver metadata via une chaîne complexe :
MediaIn ─────────────────────┐
    │                        │
    └── Beauty Compo ─── Copy Metadata ─── Saver
                          ↑
                  (Source = MediaIn)

Merge metadata de deux flux :
Plan A ──┐
         ├── Merge → Copy Metadata (Mode = Merge)
Plan B ──┘                ↑
                  (Source = Plan A pour TC,
                   Plan B pour autres champs)

Operation (défaut : Replace)

Replace : remplace entièrement la metadata cible par celle de la source. Merge : fusionne (les champs de la source écrasent ceux du même nom dans la cible, le reste est conservé).

Field Filter (défaut : All)

All = tous les champs. Restreint = liste de champs spécifiques à copier (par nom). Permet un transfert sélectif.

Skip Empty Source Fields (défaut : On)

Si activé, ne copie pas les champs vides de la source (préserve les valeurs existantes côté cible si la source est vide).

• Récupération metadata après Renderer 3D - le 3D render n'a pas le TimeCode du plan live action ; Copy Metadata depuis le MediaIn original = TC restauré pour conform.
• Conserver metadata après Background - Background est synthétique, sans metadata source. Copy Metadata récupère celle du flux parent.
• Bridging entre Saver et Loader - pipeline EXR multi-pass : restaurer la metadata du Loader source au moment du Saver pour cataloging cohérent.
• Conform après Merge complexe- Merge de plusieurs flux peut perdre la metadata du flux principal. Copy Metadata en aval pour la récupérer du flux qu'on considère prioritaire.
• Pipeline de comp restoration- restauration d'archives anciennes : chaque étape de cleanup peut perdre la metadata source. Copy Metadata final = archives propres avec contexte préservé.
• Composite multi-source unifié - une comp avec assets de plusieurs origines : Copy Metadata pour assigner une « source canonique » à toute la chaîne.

• À placer juste avant le Saver - pour garantir que le fichier de sortie contient la metadata correcte, mettre Copy Metadata en dernier node avant Saver/MediaOut.
• Source = MediaIn originalpour la majorité des cas. Faire passer le MediaIn directement sur l'input vert sans transformation intermédiaire.
• Replace pour reset complet, Merge pour ajouts. Replace est plus prévisible, Merge évite de perdre accidentellement des champs custom déjà attachés.
• Field Filter pour cas chirurgicaux - ne copier que TimeCode et Filename, par exemple, et préserver tout le reste de la metadata déjà accumulée par la comp.
• Vérifier le résultat - Set Metadata avec expression =Image.Metadata.TimeCode juste après Copy Metadata, puis afficher dans un Text+ pour confirmer le contenu.
• Pas de pénalité de perf - Copy Metadata ne touche pas aux pixels, juste au container. Coût CPU négligeable.
• Pour tester rapidement la presence d'un champ avant de le copier, utiliser le node Has Metadata en parallèle.