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

uImagePlane

uImagePlane / USD-плоскость с изображением

uImagePlane добавляет в USD/3D-сцену плоскость с внешним изображением: задаёт файл текстуры, размер плоскости, transform-положение и возможность экспортировать объект отдельным USD stage.

uImagePlane1Stage / USD InputStage OutputMaskForegroundBackgroundOutput

uImagePlane

Обзор

Что делает uImagePlane

uImagePlane работает не как обычный 2D Loader и не как Background. Она создаёт объект в USD/3D-пространстве: плоскость, которая использует внешний файл изображения как визуальный источник. Поэтому её положение, масштаб и ориентация управляются через Transform, а не через 2D-параметры кадра.

На вкладке Controls находятся параметры Filename, Browse, Size и Export as Separate Stage. Filename задаёт путь к изображению, Browse открывает выбор файла, Size управляет базовым размером плоскости, а Export as Separate Stage позволяет вынести полученный USD-объект в отдельный stage.

Вкладка Transform размещает плоскость в сцене. Translation X/Y/Z задаёт позицию, Rotation X/Y/Z и порядок вращения определяют ориентацию, Pivot X/Y/Z управляет опорной точкой, Scale с Lock X/Y/Z меняет общий размер, а Use Target позволяет работать с целевой точкой, если сцена строится через target-based позиционирование.

Практически uImagePlane часто используют как фон за 3D-объектами, как референсную карточку, как плоскость с matte/plate, как простую вывеску или как визуальный слой, который должен жить в том же USD-пространстве, что камера, свет и геометрия.

Главное отличие от 2D-подложки: uImagePlane подчиняется камере, перспективе, глубине, масштабу и пространственным трансформациям. Если нужна картинка поверх композа — проще использовать 2D-ветку. Если картинка должна быть частью USD-сцены — нужна uImagePlane.

Опция Export as Separate Stage полезна, когда image plane является самостоятельным сценовым ассетом: например, фоновой карточкой, референсом для layout, проекционной плоскостью или отдельным элементом, который нужно передать дальше по USD-пайплайну.

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

Представляй uImagePlane как картинку, натянутую на плоскую карточку в 3D/USD-сцене. Filename выбирает изображение, Size задаёт размер карточки, Transform ставит её в пространство.

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

Добавить задник или референсную картинку в USD-сцену.
Поставить 2D-plate как плоскость в 3D-пространстве перед камерой.
Создать billboard-элемент, вывеску, карточку или плоский визуальный объект.
Использовать изображение как простую matte-плоскость внутри USD-композиции.
Разместить фон с перспективой и глубиной, а не как обычный 2D-оверлей.
Экспортировать image plane как отдельный USD stage для повторного использования.