The USD Exporter Package
Introduction
This package provides export functionality from the Unity Editor to the USD file format.
OpenUSD (Universal Scene Description) is a format developed by Pixar, intended for the interchange of 3D computer graphics data, collaborative editing, and designed to meet the needs of large-scale film and visual effects production. You can read more about the USD format on Pixar’s website.
This package also adds USD Export functionality to the Recorder window, if you have the Recorder package installed in your project.
USD Version
The version of the USD format that this package supports is determined by the version of the USD Core package (com.unity.usd.core) that it depends on. To find which USD version you are using, check the USD Core package's description in the Package Manager window. Newer versions of the USD format are currently available, and Unity's USD packages will be periodically updated to benefit from the latest features.
Note:
This package's USD export feature supersedes the USD export provided in the old USD Experimental package.
If you want to import from USD files into the Unity Editor, see the Unity USD Importer package.
For an explanation of the various USD packages provided by Unity, see Understanding Unity USD Packages.
This package is not specifically designed for runtime USD export, so its use in built projects is not supported.
Requirements
- Windows / OSX (Intel and Silicon) / Linux
- Unity version: 2023.1 and up
Installing the Package
To install the package, you must use the "Install By Name" option in the Package Manager window:
- Go to Window > Package Manager to open the Package Manager window.
- Click the Add (+) dropdown menu, and select "Install package by name..."
- Enter
com.unity.exporter.usd
into the text field that is displayed. - Click the Install button.
Limitations
Due to conflicting USD plugins, this package may have unexpected errors when installed side-by-side with NVidia's Omniverse Connector package. If you have both installed and are encountering issues using this package we recommend uninstalling the Omniverse Connector and retrying.
Some physical camera settings not exported
Samples
The USD package includes an export sample to help you get started. Use the Package Manager Window to import the sample into your Assets folder. To get started with the sample, open the scene file and inspect the relevant Game Object in the Inspector Window.
Features
The following is a brief listing of currently supported features:
- Exporting to USD:
- Export Game Objects to USD
- File formats: .usd, .usda, .usdc, .usdz
- Export via Recorder package
- Animation:
- Timeline Recording Track via Unity Recorder Package
Obsolete Import
This package is an evolution of the old, unsupported, experimental USD package (com.unity.formats.usd), which had both export and import functionality. The old import code from that package is still present in this package but is hidden. We recommend that you use the new supported USD Import package (com.unity.importer.usd). However, if you are an existing user of the old package and the new, supported Importer package does not integrate well with your workflow, you can re-enable Import in this package in UsdMenu.cs
.
See Understanding Unity USD Packages for more information.