SetMetadata

SetMetadata нужна в тех случаях, когда внутри Fusion-композиции требуется явно прикрепить к изображению дополнительную информацию: имя клипа, номер шота, статус обработки, пользовательский тег, версию, цветовое пространство, техническую пометку или любой другой текстовый параметр пайплайна.

На скриншоте у ноды всего два основных поля: Field Name и Field Value. Field Name определяет ключ метаданных, то есть название записываемого поля. Field Value определяет содержимое этого поля. Вместе они образуют простую пару: что записать и какое значение положить.

Важно понимать, что SetMetadata не создаёт визуального эффекта. После подключения ноды Viewer может выглядеть абсолютно так же, потому что пиксельные данные остаются прежними. Изменение проявляется там, где metadata читается: в последующих инструментах, expressions, скриптах, кастомных пайплайнах, экспорте или при диагностике потока.

Нода полезна для аккуратной систематизации сложных композиций. Например, можно помечать ветки дерева, передавать служебные значения между участками компа, фиксировать источник данных или создавать понятные маркеры для автоматизации. В больших проектах это помогает отличать технические ветки и контролировать, откуда пришёл конкретный поток изображения.

SetMetadata особенно полезна рядом с CopyMetadata, Saver, Loader, MediaIn, CustomTool, скриптами и pipeline-операциями. CopyMetadata переносит уже существующие метаданные, а SetMetadata позволяет явно записать новое поле или переопределить старое.

Метаданные стоит использовать осознанно. Если задать слишком общее имя поля, можно случайно перезаписать уже существующее служебное значение. Если писать данные хаотично, композиция станет сложнее для поддержки. Лучше использовать понятные имена, единый стиль нейминга и документировать, зачем конкретное поле добавляется.