← Энциклопедия Fusion
USD / 3DСредний

uExport

uExport / экспорт USD stage

uExport экспортирует собранный USD stage из Fusion в файл USD: основной формат на скриншоте — USD (*.usd), а ключевое действие выполняется кнопкой Export Stage.

uExport1Stage / Scene InputStage passthrough / OutputMaskForegroundBackgroundOutput

uExport

Обзор

Что делает uExport

uExport используется тогда, когда USD-сцену нужно вывести из Fusion как отдельный stage-файл. Это может быть результат сборки из uCamera, uDomeLight, uDistantLight, uDiskLight, uCylinderLight, uDuplicate, uCatcher и других USD-нод. В отличие от обычного Saver, который сохраняет изображение или последовательность кадров, uExport работает именно со сценой и описанием объектов.

На скриншоте у ноды минимальный интерфейс: раскрытая группа Export, большая кнопка Export Stage и выпадающий список Format. Такая простота обманчива: нода обычно стоит в конце USD-ветки и отвечает за то, чтобы вся собранная структура сцены была записана в корректном формате.

Export Stage запускает сам процесс сохранения stage. Перед этим важно убедиться, что upstream-ветка действительно содержит USD-сцену, а не обычное 2D-изображение. Если в uExport приходит неправильный тип данных или пустая сцена, экспорт может ничего полезного не дать.

Format определяет формат выходного USD-файла. В показанном варианте выбран USD (*.usd). Это текстовый/ASCII-представимый формат USD, удобный для совместимости, инспекции, пайплайна и обмена. В зависимости от версии Fusion и доступных настроек список форматов может быть шире, но логика остаётся той же: выбрать способ записи stage на диск.

uExport особенно полезен в сценах, где Fusion используется не только как композитор, но и как часть USD/3D-пайплайна. Например, можно собрать свет, камеру, дубликаты, catcher-объекты и затем экспортировать stage как отдельный слой для дальнейшего рендера, передачи другому художнику или повторного использования.

Главная практическая идея: uExport не заменяет рендер. Если нужен финальный пиксельный кадр, используется рендер/MediaOut/Saver. Если нужно сохранить описание USD-сцены, используется uExport. Эти задачи похожи по месту в графе, но принципиально разные по результату.

Как это понимать

Представляй uExport как кнопку «сохранить USD-сцену». Всё, что собрано в USD-ветке до неё, записывается как stage-файл, а не как картинка.

Где используется

Экспортировать собранную USD-сцену из Fusion.
Сохранить stage после настройки uCamera, uDomeLight, uDistantLight и других u-нод.
Передать USD-сборку во внешний 3D/USD-пайплайн.
Сохранить отдельный слой света, камеры или дубликатов как USD stage.
Архивировать техническую USD-сцену отдельно от финального рендера.
Проверить, что USD-ветка корректно собирается до этапа рендера или передачи дальше.