通用场景描述

通用场景描述(USD)是一个高效、可扩展的系统,用于制作、读取和流式传输时间采样的场景描述,以便在图形应用程序之间进行交换。

更多详情,请访问网站此处。

构建状态

	Linux	Windows	macOS
dev
release

其他文档

• 用户文档和教程
• API 文档
• 高级构建配置

获取帮助

需要帮助了解USD的某些概念吗?查看获取USD帮助或访问我们的论坛。

如果您遇到未记录的软件问题,请提交一个错误报告。

支持的平台

USD主要在Linux平台(CentOS 7)上开发,但在macOS和Windows上也可以构建、测试和支持。

也可以构建可嵌入到iOS和visionOS应用程序中的USD库。

请参阅VERSIONS.md了解明确测试的版本。

依赖

必需:

• C/C++编译器
• CMake
• Intel TBB

有关版本信息,请参见第三方库和应用程序版本。

以下组件需要其他依赖项。这些组件可在构建时禁用。更多详细信息,请参阅高级构建配置。

成像和USD成像

必需:

• OpenSubdiv

可选:

• OpenEXR
• OpenImageIO
• OpenColorIO
• OSL (OpenShadingLanguage)
• Ptex

Python绑定

必需:

• Python
• Boost

usdview 所需内容:

• Python 绑定
• PySide6 或 PySide2
• PyOpenGL

获取和编译代码

构建 USD 最简单的方法是运行提供的 build_usd.py 脚本。这个脚本将下载所需的依赖项,并将它们与 USD 一起构建和安装到指定的目录中。

按照以下说明运行该脚本,使用其默认行为,这将构建 USD 核心库、成像和 USD 成像组件。 有关更多选项和文档,请使用 --help 参数运行该脚本。

请参阅高级构建配置了解示例和直接运行 cmake 的其他文档。

1. 安装先决条件(请参见依赖项了解所需的版本)

• 必需:
  • C++ 编译器:
    • gcc
    • Xcode
    • Microsoft Visual Studio
  • CMake
• 可选(可以通过向 build_usd.py 传递 --no-python 参数来忽略)
  • Python(需要用于绑定和测试)
  • PyOpenGL(需要用于usdview)
  • PySide6 或 PySide2(需要用于usdview)

2. 下载 USD 源代码

您可以从 GitHub 下载源代码存档,或使用 git 克隆存储库。

> git clone https://github.com/PixarAnimationStudios/OpenUSD
Cloning into 'OpenUSD'...

3. 运行脚本

运行 build_usd.py 脚本来构建和安装 USD。请注意,构建脚本是以源外构建为目标设计的 -- 将构建安装到克隆存储库的目录中尚未经过测试。

Linux:

例如,以下命令将下载、构建和安装 USD 的依赖项,然后将 USD 构建和安装到 /path/to/my_usd_install_dir。

> python OpenUSD/build_scripts/build_usd.py /path/to/my_usd_install_dir

macOS:

在终端中,运行 xcode-select 以确保安装了命令行开发者工具。然后运行该脚本。

例如,以下命令将下载、构建和安装 USD 的依赖项,然后将 USD 构建和安装到 /path/to/my_usd_install_dir。

> python OpenUSD/build_scripts/build_usd.py /path/to/my_usd_install_dir

iOS 和 visionOS:

从 macOS 系统构建时,可以跨平台编译 iOS 平台。

跨平台编译受限于构建可嵌入在目标平台构建的应用程序中的库。在嵌入 USD 时,使用单体构建可能会有帮助(请参见高级构建配置)。

这些构建不支持 Python 绑定或命令行工具。

目前,这些构建也不支持成像或 USD 成像。

例如,以下命令将下载、构建和安装 USD 的依赖项,然后为 iOS 构建和安装 USD,安装到 /path/to/my_usd_install_dir。

> python OpenUSD/build_scripts/build_usd.py --build-target iOS --build-monolithic /path/to/my_usd_install_dir

或者对于 visionOS:

> python OpenUSD/build_scripts/build_usd.py --build-target visionOS --build-monolithic /path/to/my_usd_install_dir

Windows:

启动适用于您的 Visual Studio 版本的"x64 Native Tools Command Prompt",并在打开的 shell 中运行该脚本。请确保使用 64 位(x64)命令提示符,而不是 32 位(x86)命令提示符。

有关更多详细信息,请参见 https://docs.microsoft.com/en-us/cpp/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line。

例如,以下命令将下载、构建和安装 USD 的依赖项,然后将 USD 构建和安装到 C:\path\to\my_usd_install_dir。

C:\> python OpenUSD\build_scripts\build_usd.py "C:\path\to\my_usd_install_dir"

4. 试一试

设置脚本完成时指定的环境变量,并使用示例资产启动 usdview。

> usdview OpenUSD/extras/usd/tutorials/convertingLayerFormats/Sphere.usda

贡献

如果您想为 USD 做贡献(我们很感谢您的帮助!),请查看文档中的贡献页面以获取更多信息。