开放美元

通用场景描述

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

欲了解更多详情，请访问此处的网站。

构建状态

	Linux	视窗	macOS
开发者
发布

附加文档

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

寻求帮助

需要帮助理解美元的某些概念吗？请参阅获取有关美元的帮助或访问我们的论坛。

如果您遇到软件未记录的问题，请提交错误。如果您需要报告软件的安全问题，请查看安全政策。

支持的平台

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

还可以构建可嵌入 iOS 和 VisionOS 应用程序中的 USD 库。

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

依赖关系

必需的：

• C/C++编译器
• CMake
• 英特尔TBB

有关版本信息，请参阅第 3 方库和应用程序版本。

以下组件需要额外的依赖项。这些组件可能会在构建时被禁用。有关更多详细信息，请参阅高级构建配置。

成像和 USD 成像

必需的：

• 开放细分

选修的：

• 开放EXR
• 开放图像IO
• 开放色彩IO
• OSL（开放着色语言）
• 聚苯乙烯

Python 绑定

必需的：

• Python

美元视图

必需的：

• Python 绑定
• PySide6 或 PySide2
• PyOpenGL

获取并构建代码

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

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

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

1. 安装先决条件（请参阅所需版本的依赖项）

• 必需的：
  • C++编译器：
    • 海湾合作委员会
    • Xcode
    • 微软视觉工作室
  • CMake
• 可选（可以通过将--no-python作为参数传递给build_usd.py来忽略）
  • Python（绑定和测试所需）
  • PyOpenGL（usdview 必需）
  • PySide6 或 PySide2（usdview 必需）

2.下载美元源代码

您可以从 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

苹果系统：

在终端中，运行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 的依赖项，然后将 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

视窗：

启动适用于您的 Visual Studio 版本的“x64 本机工具命令提示符”，并在打开的 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:pathtomy_usd_install_dir中。

 C:> python OpenUSDbuild_scriptsbuild_usd.py "C:pathtomy_usd_install_dir"

4. 尝试一下

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

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

贡献

如果您想为 USD 做出贡献（我们感谢您的帮助！），请参阅文档中的贡献页面以获取更多信息。