← Энциклопедия Fusion
USD / 3DНовичок

uVisibility

uVisibility / видимость USD-примитивов

uVisibility включает или выключает видимость выбранных USD-примитивов через Prim Selection и параметр Visible, не удаляя объект из stage.

uVisibility1SceneInputSceneOutputMaskForegroundBackgroundOutput

uVisibility

Обзор

Что делает uVisibility

В USD-сценах часто нужно временно скрывать части ассета: отдельные детали модели, технические объекты, варианты декора, вспомогательные элементы, прокси или группы примитивов. uVisibility решает именно эту задачу: она управляет visibility-атрибутом выбранных prims.

Prim Selection задаёт область действия ноды. Selected Prims содержит список объектов или prim-путей, к которым применяется изменение видимости. Если выборка пустая или указана неверно, нода может не дать ожидаемого результата, потому что ей просто нечего менять.

Invert Prim Selection инвертирует выборку. Это удобно, когда нужно оставить видимым один объект, а остальные скрыть, либо наоборот — исключить один prim из массового изменения.

Visible — главный переключатель ноды. Когда он включён, выбранные prims остаются видимыми. Когда выключен, они скрываются из USD-stage/рендера, но не удаляются из сцены и могут быть снова включены позже.

Export as Separate Stage позволяет вывести результат как отдельный USD-stage слой. Такой подход полезен в пайплайне, где видимость объектов должна храниться отдельной правкой поверх исходного ассета, а не вноситься в базовый файл.

На практике uVisibility часто ставят после uLoader, uMerge, uDuplicate или uVariant, когда сцена уже собрана, но нужно быстро отключить лишние элементы перед uRenderer или uExport. Это безопаснее, чем удалять ветки графа или менять исходный USD-файл.

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

Представляй uVisibility как выключатель слоя в USD-сцене: объект остаётся в stage, но выбранные prims можно сделать видимыми или скрытыми без разрушения структуры ассета.

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

Скрыть отдельные prims в USD-сцене без удаления геометрии.
Отключить технические или вспомогательные элементы перед рендером.
Быстро проверить разные варианты видимости объектов в сцене.
Сделать отдельный visibility-слой для USD-пайплайна.
Исключить часть ассета из uRenderer или uExport.
Управлять видимостью после uVariant, uDuplicate или uMerge.