ВИДЕОМОНТАЖЁРDAVINCI RESOLVE · ВИДЕО · AI

FUSION · СПРАВОЧНИК НОД

RunCommand

RunCommand / Запуск внешней команды

Запускает внешнюю команду при начале, завершении или для каждого кадра рендера. Необязательный image-вход задаёт зависимость от upstream-вычисления.

УтилитыПродвинутый

RunCommand

Обзор

Что делает RunCommand

RunCommand предназначен для запуска внешних программ во время рендера. Он может работать без изображения, но подключённый orange Input задаёт порядок: команда запускается после завершения рендера подключённой ноды. В справочнике удалён ранее предполагавшийся Effect Mask — BMD описывает только один image-вход.

Frame Command относится к каждому рендерящемуся кадру, Start Command — к началу рендера композиции, End Command — к его завершению. Это разные поля на разных вкладках. Не приравнивайте Start к первому просмотренному кадру и не считайте поведение отменённой задачи подтверждённым без отдельного теста.

Вкладка Frame содержит Hide, Wait, Command, Browse, Interactive, Number A–D и String. На исходных Start/End-снимках есть Hide, Command и Browse; Wait, Interactive и поля подстановок туда не перенесены. Справочник сохраняет эту разницу интерфейса.

Wait on означает ожидание завершения внешнего приложения. При off рендер продолжается без ожидания. По BMD ненулевой код завершения приложения приводит к ошибке ноды; для контролируемой проверки этого поведения используйте Frame с Wait on.

Для Frame документированы %a, %b, %t и %s: A/B, текущий номер кадра без padding и текст String. Запись %04t дополняет номер кадра нулями до четырёх позиций. Похожая запись %04f встречается в старом примере копирования руководства, но не совпадает с его списком подстановок; практики используют явно описанный %t.

Number C (%c) и Number D (%d) присутствуют в текущем Inspector, хотя перечисление подстановок в тексте руководства ограничено A/B. Эти два пункта сохранены с явной границей подтверждения: дополнительные варианты форматирования C/D необходимо проверить в вашей версии.

В руководстве показано подключение после Saver, чтобы обработка кадра начиналась после его сохранения. В учебных графах применяется только Background → RunCommand → MediaOut: команды печатают фиксированные метки либо возвращают код завершения. Они не содержат копирования, удаления, сетевых обращений или записи файлов.

Конкретный исполняемый файл, права запуска, оболочка и способ просмотра stdout зависят от ОС и host. Учебные строки явно ориентированы на Linux с GNU coreutils и полными путями /usr/bin/echo, /usr/bin/true и /usr/bin/false. Для Windows/macOS нельзя копировать эти пути без адаптации.

Отсутствие изменения в Viewer само по себе нормально: RunCommand передаёт подключённое изображение, а программа пишет в stdout или возвращает статус отдельно. Перед тестом определите, где ваш host показывает вывод дочернего процесса. Веб-схемы ничего не запускают; нативная проверка RunCommand остаётся pending.

Когда применять

  • Подготовка внешней программы к началу рендера.

  • Действие после завершения расчёта подключённой ноды.

  • Передача номера кадра внешнему инструменту.

  • Передача заданных чисел и текстовой метки.

  • Контроль кода завершения внешнего процесса.

  • Разделение событий Start, Frame и End.