通用场景描述（USD）

导入 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.

以下 USD 数据类型可以导入为 Blender 对象：

• 摄像机

• 曲线

• 灯光

• 材质

• 网格

• 点云

• 基本形状

• 体积（卷标）

有关如何处理各种数据类型的详细信息，请参阅导入选项的以下说明。

Note

导入 USDZ 档案时，务必仔细考虑导入纹理选项以确定是否以及如何从档案中复制纹理文件。

Xform 和 Scope Primitives

USD 提供了包含变换数据的 Xform prim 类型，可用于表示变换层次结构和组织场景。此类 Xform 引物导入为 Blender 空物体。

USD 还支持 Scope 基元，它们是不包含变换数据的实体，但用于分组场景的其他元素。Blender 与范围的概念不完全相同，因此此类原始文件导入为位于原点的 Blender 空白。这是一个不完美的表示，因为空物体具有变换，而 Scopes 没有，但这种方法仍然有助于保留场景层次结构的结构。

PointInstancer Primitives

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

These are imported into Blender as Point Clouds using a 几何节点修改器 and the 实例化于点上.

动画

导入程序支持两种类型的动画：

• 动画转换：如果 USD 基元具有随时间变化的转换数据，则将转换缓存约束添加到导入的 Blender 对象。

• 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.

材质

如果 USD 网格或几何子集具有绑定的材质，则导入器将为 Blender 对象分配与 USD 材质名称相同的材质。如果场景中已存在具有相同名称的 Blender 材质，则将使用已有材质，取决于材质名称冲突选项。否则，将创建新的材质。

If the USD material has a USD Preview Surface shader source, the 视图显示 color, metallic, and roughness are set to the corresponding USD Preview Surface input values.

还有一个实验性 导入 USD 预览 选项，用于将 USD 预览表面着色器转换为 Blender 的原理化 BSDF 着色器节点。此选项可能是有损的，因为它还不能转换所有着色器设置和类型，但它可以生成材质的近似可视化效果。

坐标系方位

如果导入的 USD 是 Y 向上，旋转将自动应用于根对象，以转换为 Blender 的 Z 向上方向。

导入选项

导出到 USD 时，可以使用以下选项：

通用

路径

仅导入植根于给定基本体的 USD 场景的子集。

包括

仅可见基本体

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

仅定义的基本体

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

设置帧范围

更新场景的开始和结束帧以匹配 USD 阶段的开始帧和结束帧。

创建集合

将所有导入的对象添加到新集合中。

相对路径

选择相对于 blend 文件的文件路径。

比例|缩放

导入物体相对于世界原点的缩放值。

光强度比例

用于输入光源强度的缩放。

自定义属性

Behavior when importing USD attributes as Custom Properties.

无:

不导入 USD 自定义属性。

用户:

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

所有自定义:

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

物体类型

摄像机

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

曲线

Import UsdGeomBasisCurves primitives as Curves and UsdGeomNurbsCurves as Blender meshes.

灯光

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

材质

Import UsdPreviewSurface materials.

网格

Import UsdGeomMesh primitives as Mesh Objects.

体积（卷标）

Import UsdVolVolume OpenVDB assets as Volume Objects.

点云

Import UsdGeomPoints primitives as Point Cloud Objects.

USD 形状

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

Display Purpose

渲染

Include primitives with purpose render.

代理

Include primitives with purpose proxy.

引导

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:

尝试导入 allPurpose 材质。

预览:

尝试导入 preview 材质，加载 allPurpose 材质作为备用。

全部:

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

几何数据

UV 坐标

读取网格 UV 坐标。

颜色属性

将 USD 网格 displayColor 值转换为 Blender 的颜色属性。

网格属性

读取 USD Primvars 作为网格属性。

细分

基于 USD SubdivisionScheme 属性创建表面细分修改器。

检查网格

检查导入的网格是否有损坏的数据，并在必要时修复它。如果禁用，错误数据可能会导致网格显示或编辑崩溃。该选项会降低导入速度，但建议使用，因为数据错误并不总是很明显。

合并父级 Xform

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

绑定

形态键

将 USD 混合形状导入为 Blender 形态键。

骨架

将 USD 骨架导入为 Blender 骨架。

材质

导入所有材质

还可以导入任何几何体都不使用的材质。请注意，当此选项为 false（假）时，仍将导入几何体引用的材质。

导入 USD 预览

将 USD 预览表面着色器转换为原理化 BSDF 着色器网络。

创建世界材质

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

设置材质混合

如果启用 导入 USD 预览 选项，材质混合方法将根据 opacity 和 opacityThreshold 着色器输入自动设置，从而允许透明对象的可视化。

材质名称冲突

当导入的材质的名称与现有材质冲突时的行为。

使其独立化:

将每种 USD 材质导入为唯一的 Blender 材质。

引用现有:

如果已存在具有相同名称的材质，则引用该材质而非导入。

纹理

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.

导入纹理

从 USDZ 档案导入纹理时的行为。

无:

不导入纹理。请注意，如启用该选项，材质纹理可能无法被 Blender 解析。

打包:

将纹理导入为 Blender 文件内部打包数据。

复制:

复制文件到 纹理目录 选项指定的目录。

纹理目录

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.

文件名冲突

当导入的纹理文件的名称与现有文件冲突时的行为。

使用现有项:

如果已存在同名文件，则使用该文件而非复制。

覆盖:

覆盖现有文件。

粒子与实例化

场景实例化

导入 USD 场景图形实例为集合实例，否则将被导入为副本。

导出为 USD 文件

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.

以下物体可以导出到 USD：

• 网格（不同类型，见下文）。

• 相机（目前仅支持透视相机，不支持正交相机）。

• 曲线

• 灯光

• 毛发（导出为曲线，并仅限于父股）。

• 点云

• 体积（卷标）

• 骨架

导出动画时，最终解算的网格将写入 USD。这意味着可以导出以下参数：

• 静态网格。

• 形变网格；此处网格的拓扑结构不会更改，但顶点的位置会随时间而变化。比如动画角色或弹跳（但不开裂）物体。

• 任意动画网格；在这里，拓扑确实会发生变化。比如，流体模拟的结果，液体飞溅会从主体上脱落。

• 融球导出为动画网格。

Note

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.

从 Spring 导出 USD 并用 USDView 打开。

导出选项

导出到 USD 时，可以使用以下选项：

通用

根基图元

如果设置，添加一个给定路径的变换图元作为所有导出数据的父级。

包括

仅选中项

当选中时，只有被选中的物体才会被导出。实例对象，例如在场景中被实例化的集合，当它们的实例被选中时就被认为是 选中 的。

仅可见

仅导出不为隐藏的对象。导出对象的隐形父级导出为空变换。

动画

勾选后，将导出整个场景帧范围。取消勾选中，仅导出当前场景帧。

Blender 数据

自定义属性

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

命名空间

如果设置，导出自定义属性名称时添加给定的命名空间作为前缀。仅适用于尚未具有前缀的属性名称（比如，名称 bar 会应用此名称，但 foo:bar 就不会）并且不适用于总是在 userProperties:blender 命名空间中导出的 Blender 物体和数据名称。

By default, userProperties namespace is used.

Blender 名称

编写 USD 自定义属性，包含原始 Blender 物体和物体数据名。

允许 Unicode

在编写 USD 基元和属性名称时保留 UTF-8 编码字符（当打开生成的文件时需要软件支持 USD 24.03 或者更高版本）。

文件引用

相对路径

使用相对路径引用 USD 格式外部文件（如纹理、体积），否则使用绝对路径。

转换坐标系

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.

矩阵:

导出矩阵操作。

设置用于

确定是使用集合、修改器的 视图 或 渲染 可见性，还是可同时为 视口 和 渲染 设置的任何其他属性。

物体类型

网格

导出网格物体

灯光

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

摄像机

导出摄像机物体，只会导出透视摄像机。

曲线

导出曲线物体

点云

导出点云物体

体积（卷标）

导出体积物体

毛发

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

Note

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

几何数据

UV 贴图

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

重命名 UV 贴图

使用 USD 默认名称（st）而非 Blender 默认名称（UVMap）导出 UV 贴图。

法向

如勾选，将包含被导出网格的法线。这包括自定义循环法线。

合并父级 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.

三角化

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

绑定

形态键

导出形态键为 USD 混合形态。

绝对形态键不受支持。

骨架

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

限制：

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

• 不支持柔性骨骼。

仅使骨骼形变

仅导出形变骨骼及其父级。

材质

Exports material information of the object. By default the exporter approximates the 原理化 BSDF node tree by converting it to USD's Preview Surface format.

当网格分配了多个材质时，将为每个材质创建一个几何子集。第一个材质（如果有）也始终应用于网格本身（无论是否存在几何子集），因为 Hydra 视口不支持子集上的材质。有关详细信息，请参阅 USD issue #542 。

Note

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

USD 预览表面网络

Approximates a 原理化 BSDF node tree by converting it to USD's Preview Surface format.

Note

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.

Warning

并非所有节点都支持；目前只支持包含漫射 BSDF、原理化 BSDF、图像纹理、UV 贴图和分离 RGB 节点的简单节点树。

MaterialX 网络

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 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.

导出纹理

导出纹理的方法。

维持:

使用纹理的原始位置。

保留:

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

新建路径:

将纹理导出到 USD 文件旁的 'textures' 文件夹。

覆盖纹理

允许在导出纹理时覆盖现有纹理文档。

USDZ 纹理缩减采样

为所有导出的纹理选择最大尺寸。

维持:

保持所有当前纹理尺寸。

256:

调整为最大256像素。

512:

调整为最大512像素。

1024:

调整为最大1024像素。

2048:

调整为最大2048像素。

4096:

调整为最大4096像素。

自定义:

指定自定义尺寸。

USDZ 自定义缩小尺寸

The size in pixels of the Custom downsampling.

试验特性

实例化

由于这是一个实验性选项。如果未勾选，副本物体将导出为真实物体，因此具有 100 个粒子的粒子系统（显示 100 个网格）将在导出文件中存在 100 个单独的网格。选中后，副本物体将作为对原始物体的引用导出。如果原始物体不是导出的一部分，则第一个副本将导出为真实物体并用作引用。

导出限制

单面/双面网格

USD 似乎既不支持双面不同材质或不同面组，因此 Blender 使用第一个材质中的标记将整个网格标记为单/双面。如果没有材质，则默认为双面。

材质

当有多个材质时，网格面将存储为几何子集，并且每个材质都分配给相应的子集。如果只有一个材质，则跳过此步骤。请注意，几何子集不是时间采样的，因此当动画网格更改拓扑时可能会中断。

毛发

仅导出父级发股，并且仅导出具有恒定颜色的。没有 UV 坐标，也没有关于法线的信息。

摄像机

仅导出透视模式相机。

粒子

粒子仅在它们处于生存状态时写入，这意味着它们始终可见。目前没有代码处理将它们标记为在其生命周期之外不可见。

通过使用粒子的持久 ID 对物体名称添加后缀，使每个粒子变换具有唯一名称，从而导出粒子系统实例的物体。

实例化/引用

这仍然是一个实验功能，可以在导出到 USD 时启用。启用后，实例化物体网格将写入 USD 作为对原始网格的引用。网格的第一个副本是为实写而写入的，以下副本引用第一个副本。哪个网格被视为 “第一个” 或多或少是任意选择的。

USDZ

由于目前 USD 库的限制，USDZ 档案无法包含 UDIM 纹理。此限制有望在未来版本的 USD 中得到解决。（见于 USD pull request #2133。）