Universal Scene Description

Импорт файлов USD

USD files typically represent the scene as a hierarchy of primitives, or prims. Individual prims contain data to describe scene entities, such as geometry, lights, cameras and transform hierarchies. Blender’s USD importer converts USD prims to a hierarchy of Blender objects. Like the USD exporter, the importer does not yet handle certain USD composition concepts, such as layers and references.

The following USD data types can be imported as Blender objects:

• Камеры (cameras)

• Кривые (curves)

• Источники освещения (lights)

• Материалы (materials)

• Меши (meshes)

• Point Clouds

• Примитивные формы

• Объёмы (volumes)

For more information on how the various data types are handled, see the following descriptions of the Import Options.

Примечание

When importing a USDZ archive, it is important to carefully consider the Import Textures option to determine whether and how to copy texture files from the zip archive.

Xform and Scope Primitives

USD provides an Xform prim type, containing transform data, which can be used to represent transform hierarchies and to organize the scene. Such Xform prims are imported as Blender empty objects.

USD also supports Scope primitives, which are entities that do not contain transform data, but which serve to group other element of the scene. Blender doesn’t have an exact counterpart to the concept of a scope, so such primitives are imported as Blender empties located at the origin. This is an imperfect representation, because empty objects have a transform and Scopes do not, but this approach nonetheless helps preserve the structure of the scene hierarchy.

Плоские примитивы (PointInstancer Primitives)

USD provides a UsdGeomPointInstancer prim type, containing instances that are scattered on a primitive’s points.

Они импортируются в Blender как Облака Точек с помощью Модификатор «Геометрические ноды» (geometry nodes modifier) и Нода «Экземпляр на точки» (instance on points node).

Animations

The importer supports two types of animation:

• Animating transforms: If a USD primitive has time-varying transform data, a Transform Cache constraint will be added to the imported Blender object.

• Animating geometry: Animated mesh, curve, and point cloud geometry is supported by adding a Mesh Sequence Cache modifier to the imported data. Geometry attribute (USD Primvar) animation is supported for all data types which have corresponding Blender equivalents. This includes colors, UVs, velocities, and other generic attribute data. Note that USD file sequences (i.e. a unique file per frame) are not supported.

Материалы (materials)

If a USD mesh or geometry subset has a bound material, the importer will assign to the Blender object a material with the same name as the USD material. If a Blender material with the same name already exists in the scene, the existing material may be used, depending on the Material Name Collision option. Otherwise, a new material will be created.

If the USD material has a USD Preview Surface shader source, the Отображение во вьюпорте (viewport display) color, metallic, and roughness are set to the corresponding USD Preview Surface input values.

There is also an Import USD Preview option to convert USD Preview Surface shaders to Blender Principled BSDF shader nodes. This option can be lossy, as it does not yet handle converting all shader settings and types, but it can generate approximate visualizations of the materials.

Coordinate System Orientation

If the imported USD is Y up, a rotation will be automatically applied to root objects to convert to Blender’s Z up orientation.

Параметры импорта

При импорте USD доступны следующие варианты:

Общие

Маска пути

Import only the subset of the USD scene rooted at the given primitive.

Включить (include)

Visible Primitives Only

Do not import invisible USD primitives. Only applies to primitives with a non-animated visibility attribute. Primitives with animated visibility will always be imported.

Defined Primitives Only

When disabled this allows importing USD primitives which are not defined, such as those with an override specifier.

Установить диапазон кадров

Update the scene’s start and end frame to match those of the USD stage.

Создать коллекцию

Add all imported objects to a new collection.

Относительный путь (relative path)

Выберать файл относительно blend-файла.

Масштаб (scale)

Значение, по которому можно масштабировать импортированные объекты относительно мирового ориджина (world’s origin).

Light Intensity Scale

Шкала интенсивности импортированных источников света.

Пользовательские свойства

Behavior when importing USD attributes as Custom Properties.

Нет (none):

Does not import USD custom attributes.

User:

Imports USD attributes in the userProperties namespace as custom properties. The namespace will be stripped from the property names.

All Custom:

Imports all USD custom attributes as custom properties. Namespaces will be retained in the property names.

Типы объектов

Камеры (cameras)

Import UsdGeomCamera primitives as Camera Objects (perspective and orthographic).

Кривые (curves)

Import UsdGeomBasisCurves primitives as Curves and UsdGeomNurbsCurves as Blender meshes.

Источники освещения (lights)

Import lights as Light Objects. Does not currently include cylinder or geometry lights.

Материалы (materials)

Import UsdPreviewSurface materials.

Меши (meshes)

Импортировать примитивы UsdGeomMesh как меш-объекты.

Объёмы (volumes)

Import UsdVolVolume OpenVDB assets as Volume Objects.

Point Clouds

Импортировать примитивы UsdGeomPoints как облака точек.

USD Shapes

Import USD primitive shapes as Blender meshes. UsdGeomCapsule, UsdGeomCylinder, UsdGeomCone, UsdGeomCube, and UsdGeomSphere are supported.

Display Purpose

Рендеринг (render)

Include primitives with purpose render.

Proxy

Include primitives with purpose proxy.

Направляющие (guide)

Include primitives with purpose guide.

Material Purpose

Attempt to import materials with the given purpose. If no material with this purpose is bound to the primitive, then the fallback behavior, if any, is noted below.

All Purpose:

Attempt to import allPurpose materials.

Предварительный просмотр (preview):

Attempt to import preview materials. Load allPurpose materials as a fallback.

Полностью (full):

Attempt to import full materials. Load allPurpose or preview materials, in that order, as a «fallback.»

Геометрия (geometry)

UV Coordinates

Чтение UV-координат меша.

Атрибуты цвета (color attributes)

Convert the USD mesh displayColor values to Blender’s Color Attributes.

Mesh Attributes

Read USD Primvars as mesh attributes.

Подразделение (subdivision)

Create Subdivision Surface modifiers based on the USD SubdivisionScheme attribute.

Validate Meshes

Check the imported mesh for corrupt data and fix it if necessary. When disabled, erroneous data may cause crashes displaying or editing the meshes. This option will make the importing slower but is recommended, as data errors are not always obvious.

Merge parent Xform

Allow USD primitives to merge with their Xform parent if they are the only child in the hierarchy.

Риггинг

Ключи формы (shape keys)

Imports USD blend shapes as Blender’s Ключи формы (shape keys).

Арматуры (armatures)

Imports USD skeletons as Blender’s Арматуры (armatures).

Материалы (materials)

Импортировать все материалы

Также импортировать материалы, которые не используются ни одной геометрией. Обратите внимание, что если эта опция «ложна», материалы, на которые ссылается геометрия, всё равно будут импортированы.

Import USD Preview

Convert USD Preview Surface shaders to Principled BSDF shader networks.

Create World Material

Converts the first discovered UsdLuxDomeLight dome light to a world background shader.

Set Material Blend

If the Import USD Preview option is enabled, the material blend method will automatically be set based on the opacity and opacityThreshold shader inputs, allowing for visualization of transparent objects.

Конфликт названий материалов (material name collision)

Behavior when the name of an imported material conflicts with an existing material.

Make Unique:

Import each USD material as a unique Blender material.

Существующая ссылка:

If a material with the same name already exists, reference that instead of importing.

Текстуры (textures)

When importing a USDZ package, the following options specify whether and how texture asset dependencies of the USD should be copied from the zip archive so they can be loaded into Blender.

Импортировать текстуры

Behavior when importing textures from a USDZ archive.

Нет (none):

Don’t import textures. Note that, with this option, material textures may fail to be resolved in Blender.

Запакованный (packed):

Import textures as packed data in the Blender file.

Копировать (copy):

Copy files to the directory specified in the Textures Directory option.

Каталог текстур

Path to the directory where imported textures will be copied, when the Import Textures mode is Copy.

Note that the default textures directory is the relative path //textures, which requires the Blender file to have been saved before importing, so the relative path can be resolved.

Конфликт имён файлов

Behavior when the name of an imported texture file conflicts with an existing file.

Использовать имеющийся:

If a file with the same name already exists, use that instead of copying.

Overwrite:

Перезаписать имеющиеся файлы.

Particles and Instancing

Scene Instancing

Import USD scene graph instances as collection instances, otherwise they are imported as copies.

Exporting to USD Files

Universal Scene Description (USD) files can contain complex layering, overriding, and references to other files. Blender’s USD Exporter takes a much simpler approach. When exporting, all visible, supported objects in the scene are exported, optionally limited by their selection state. Blender does not (yet) support exporting invisible objects, USD layers, variants, etc.

The following objects can be exported to USD:

• Meshes (of different kinds, see below).

• Cameras (perspective cameras only at the moment, not orthogonal ones).

• Кривые (curves)

• Источники освещения (lights)

• Hair (exported as curves, and limited to parent strands).

• Point Clouds

• Объёмы (volumes)

• Арматуры (armatures)

When exporting an animation, the final, evaluated mesh is written to USD. This means that the following meshes can be exported:

• Static meshes.

• Deforming meshes; here the topology of the mesh does not change, but the locations of the vertices change over time. Examples are animated characters or bouncing (but not cracking) objects.

• Arbitrarily animated meshes; here the topology does change. An example is the result of a fluid simulation, where splashes of fluid can break off the main body.

• Metaballs are exported as animated meshes.

Примечание

To export the Blender scene as a USDZ archive, set the file extension of the output file to .usdz. The exported USDZ package will be a zip archive containing the USD and its texture file dependencies.

Shot from Spring exported to USD and opened in USDView.

Export Options

The following options are available when exporting to USD:

Общие

Root Prim

If set, add a transform primitive with the given path to the stage as the parent of all exported data.

Включить (include)

Только выбранное

Если этот флажок установлен, экспортируются только выбранные объекты. Экземплярные объекты (instanced objects), например коллекции, созданные в сцене, считаются «выбранными», когда выбран их экземпляр (instancer).

Visible Only

Only exports objects that are not hidden. Invisible parents of exported objects are exported as empty transforms.

Анимация (animation)

When checked, the entire scene frame range is exported. When unchecked, only the current scene frame is exported.

Blender Data

Пользовательские свойства

Exports Custom Properties as USD attributes. The Namespace property is used to determine the namespace that the attributes are written to.

Namespace

If set, add the given namespace as a prefix to exported custom property names. This only applies to property names that do not already have a prefix (e.g., it would apply to name bar but not foo:bar) and does not apply to Blender object and data names which are always exported in the userProperties:blender namespace.

By default, userProperties namespace is used.

Blender Names

Author USD custom attributes containing the original Blender object and object data names.

Allow Unicode

Preserves UTF-8 encoded characters when writing USD prim and property names (requires software utilizing USD 24.03 or greater when opening the resulting files).

Ссылки к файлам

Relative Paths

Use relative paths to reference external files (i.e. textures, volumes) in the exported USD file, otherwise use absolute paths.

Convert Orientation

Convert orientation axis to a different convention to match other applications. Blender uses Y Forward, Z Up (since the front view looks along the +Y direction). For example, its common for applications to use Y as the up axis, in that case -Z Forward, Y Up is needed.

Ось вперед/вверх

By mapping these to different axes you can convert rotations between applications default up and forward axes.

Xform Ops

The type of transform operators to use to transform prims.

Translate, Rotate, Scale:

Export with translate, rotate, and scale Xform operators.

Translate, Orient, Scale:

Export with translate, orient quaternion, and scale Xform operators.

Матрица (matrix):

Export matrix operator.

Use Settings for

Determines the whether to use Viewport or Render visibility of collection, modifiers, or any other property that can be set for both the Viewport and Render.

Типы объектов

Меши (meshes)

Exports Mesh Objects

Источники освещения (lights)

Exports Light Objects The UsdLuxShapingAPI is used to support spot lights.

Камеры (cameras)

Exports Camera Objects Only perspective cameras are exported.

Кривые (curves)

Exports Curve Objects

Point Clouds

Экспорт объектов-облака точек

Объёмы (volumes)

Exports Volume Objects

Волосы (hair)

Exports parent hair strands are exported as a curve system. Hair strand colors are not exported.

Примечание

The corresponding USD schema type used during Export is analagous to the type read during Import. See the Import section for details.

Геометрия (geometry)

UV-Карты (UV maps)

When checked, includes UV coordinates for exported meshes. The name of the UV map in USD is the same as the name in Blender.

Rename UV Maps

Exports UV maps using the USD default name (st) as opposed to Blender’s default name (UVMap).

Нормали (normals)

When checked, includes normals for exported meshes. This includes custom loop normals.

Merge parent Xform

Merge USD primitives with their Xform parent if possible. USD does not allow nested UsdGeomGprims, intermediary Xform prims will be defined to keep the USD file valid when encountering object hierarchies.

Triangulate

Triangulates the mesh before writing. For more detail on the specific option see the Triangulate modifier.

Риггинг

Ключи формы (shape keys)

Export shape keys as USD blend shapes.

Absolute shape keys are not supported.

Арматуры (armatures)

Export Armatures and meshes with Armature Modifiers as USD skeletons and skinned meshes.

Ограничения:

• Modifiers in addition to Armature modifiers will not be applied.

• Гибкие кости не поддерживаются.

Только кости деформации

Only export deform bones and their parents.

Материалы (materials)

Exports material information of the object. By default the exporter approximates the Принципиальный BSDF (principled BSDF) node tree by converting it to USD’s Preview Surface format.

When a mesh has multiple materials assigned, a geometry subset is created for each material. The first material (if any) is always applied to the mesh itself as well (regardless of the existence of geometry subsets), because the Hydra viewport does not support materials on subsets. See USD issue #542 for more information.

Примечание

If USD Preview Surface Network and MaterialX Network are disabled, the material is set to the viewport materials of meshes.

USD Preview Surface Network

Approximates a Принципиальный BSDF (principled BSDF) node tree by converting it to USD’s Preview Surface format.

Примечание

To support opacityThreshold, sometimes known as «Alpha Clip», the node tree must either use a Math node set to Round, if the desired threshold is 0.5, or by using a pair of Math nodes implementing 1 - (value < threshold). The result should be plugged into the Alpha socket on the Principled BSDF node.

Предупреждение

Not all nodes are supported; currently only simple node trees containing Diffuse BSDF, Principled BSDF, Image Textures, UVMap, and Separate RGB nodes are supported.

MaterialX Network

Generates material shading graphs using the MaterialX standard. This standard is designed to support a high amount of interoperability among DCCs <Digital Content Creation>. In Blender, MaterialX supports most of the shader nodes and their functionality but has a few caveats (see below).

Implementation Caveats

When using the Principled BSDF, the resulting graph is very usable. However, when using some of the other BSDFs, some of the generated shading graphs are difficult for other DCC’s to understand.

Convert World Material

Convert the world material to a UsdLuxDomeLight. Currently works for simple materials, consisting of an environment texture connected to a background shader, with an optional vector multiply of the texture color.

Экспорт текстур

Метод экспорта текстур.

Keep:

Use original location of textures.

Сохранять (preserve):

Preserve file paths of textures from already imported USD files. Export remaining textures to a „textures“ folder next to the USD file.

New Path:

Export textures to a „textures“ folder next to the USD file.

Перезаписать текстуры

Allow overwriting existing texture files when exporting textures.

USDZ Texture Downsampling

Choose a maximum size for all exported textures.

Keep:

Keep all current texture sizes.

256:

Resize to a maximum of 256 pixels.

512:

Resize to a maximum of 512 pixels.

1024:

Resize to a maximum of 1024 pixels.

2048:

Resize to a maximum of 2048 pixels.

4096:

Resize to a maximum of 4096 pixels.

Особый (custom):

Specify a custom size.

USDZ Custom Downscale Size

The size in pixels of the Custom downsampling.

Experimental

Создание экземпляров

As this is an experimental option. When unchecked, duplicated objects are exported as real objects, so a particle system with 100 particles that is displayed with 100 meshes will have 100 individual meshes in the exported file. When checked, duplicated objects are exported as a reference to the original object. If the original object is not part of the export, the first duplicate is exported as real object and used as reference.

Ограничения экспортёра

Single-sided and Double-sided Meshes

USD seems to support neither per-material nor per-face-group double-sidedness, so Blender uses the flag from the first material to mark the entire mesh as single/double-sided. If there is no material it defaults to double-sided.

Материалы (materials)

When there are multiple materials, the mesh faces are stored as geometry subset and each material is assigned to the appropriate subset. If there is only one material this is skipped. Note that the geometry subsets are not time-sampled, so it may break when an animated mesh changes topology.

Волосы (hair)

Only the parent strands are exported, and only with a constant color. No UV coordinates, and no information about the normals.

Камера (camera)

Only perspective cameras are exported.

Частицы (particles)

Particles are only written when they are alive, which means that they are always visible. There is currently no code that deals with marking them as invisible outside their lifespan.

Objects instanced by particle system are exported by suffixing the object name with the particle’s persistent ID, giving each particle transform a unique name.

Instancing/Referencing

This is still an experimental feature that can be enabled when exporting to USD. When enabled, instanced object meshes are written to USD as references to the original mesh. The first copy of the mesh is written for real, and the following copies are referencing the first. Which mesh is considered „the first“ is chosen more or less arbitrarily.

USDZ

Due to a current limitation in the USD library, UDIM textures cannot be include in the USDZ archive. This limitation will likely be addressed in a future version of USD. (See USD pull request #2133.)