usdview Quickstart#

Get usdview#

usdview and all of the USD Toolset comes as a part of the pre-built OpenUSD binaries provided on the OpenUSD Developer Resources page.

  1. Open the OpenUSD Developer Resources page in a new browser tab.

  2. Click on the For Windows link to download the latest OpenUSD version.

    • Alternatively, Click on the Archive link to browse older versions available for download.

  3. Extract the downloaded zip archive.

  1. Open the OpenUSD Developer Resources page in a new browser tab.

  2. Click on the For Linux link to download the latest OpenUSD version.

    • Alternatively, Click on the Archive link to browse older versions available for download.

  3. Extract the downloaded zip archive.

Note

The following instructions are required to install missing X11 dependencies for Ubuntu. You may need to adjust these steps for other Linux distros.

  1. Run: sudo apt-get install libxkbcommon-x11-0 libxcb-xinerama0 libxcb-image0 libxcb-shape0 libxcb-render-util0 libxcb-icccm4 libxcb-keysyms1

Launching usdview#

Once you have the pre-built binaries downloaded and extracted, you can launch usdview with the following steps:

  1. Open the folder of the extracted pre-built binaries archive.

  2. Press Shift + Right-Click in an open area of the Windows Explorer window.

  3. Click Open PowerShell window here.
    Open PowerShell from right-click context menu.

  4. Run: .\scripts\usdview_gui.bat

This will open usdview with a default stage. You can then use File ‣ Open to open your desired stage.

usdview GUI

Note

You can try running other USD tools by executing the other scripts located in scripts/ :

.\scripts\usdcat.bat .\share\usd\tutorials\traversingStage\HelloWorld.usda

  1. cd to the extracted pre-built binaries directory.

  2. Run: ./scripts/usdview_gui.sh

This will open usdview with a default stage. You can then use File ‣ Open to open your desired stage.

usdview GUI Linux

Note

You can try running other USD tools by executing the other scripts located in scripts/ :

./scripts/usdcat.sh ./share/usd/tutorials/traversingStage/HelloWorld.usda

Warning

Check your folder naming

If the pre-built binaries folder has an @ symbol in the name, you should rename it to something without @ to avoid issues loading Qt stylesheet resources when running usdview.

Set the PATH Variable to Launch usdview Globally#

  1. Click the Start menu on your desktop.

  2. Type SystemPropertiesAdvanced. Press Enter.

  3. Click on Environment Variables….

  4. Double-Click on the Path row in the User variables table.

  5. Click on New

  6. Type the full path to the scripts/ folder in your extracted pre-built binaries folder. (e.g. C:\Users\bob\Desktop\usdview-0.24.08\scripts)

  7. Click on OK three times to close all of the opened dialogs.

Test to confirm that the path variable was set up correctly.

  1. Press Shift + Right-Click in an open area on your desktop.

  2. Click Open PowerShell window here.

  3. Run: usdview_gui.bat

usdview will launch with a default stage. You can open a different USD stage by clicking on File ‣ Open.

To be able to run all of the USD tools globally, you just need to add the scripts/ directory to your PATH environment variable. You can set the following in your .bash_profile file or any other method you prefer:

# Replace <PRE-BUILT_BINARIES_DIR> with the full path to the directory where you extracted the pre-built binaries.
export PATH=<PRE-BUILT BINARIES DIR>/scripts:$PATH

Test to confirm that the path variable was set up correctly. Open a new terminal and run:

  1. Run: usdview_gui.sh

usdview will launch with a default stage. You can open a different USD stage by clicking on File ‣ Open.

Locating USD Tutorial Content and Examples#

If you want to follow the openusd.org tutorials, the tutorials will prompt you to locate files from the OpenUSD repository. The repository also includes useful plugin and script examples to learn from. NVIDIA provides these files within the USD pre-built binaries. From the extracted pre-built binaries folder you can navigate to share/usd/tutorials and share/usd/examples for the tutorial and example content respectively.

Setting Up a Python USD Environment#

The USD pre-built binaries also come with scripts to set up a Python USD environment. Everything you need is already included, the scripts just setup some environment variables to use the USD Python API in an interactive Python interpreter or to run Python scripts that use the API.

Warning

The python environment batch file currently only works in Windows Command Prompt so you will need to use that.

These instructions assume that you have configured usdview and all other scripts to be executed globally.

  1. Click the Start menu on your desktop.

  2. Type cmd. Press Enter.

  3. Run set_usd_env.bat.

That’s all it takes to configure your environment. You can use this simple python command to test that it worked.

  1. Run python -c "from pxr import Usd;print(Usd.GetVersion())".

    • It should print the version of your configured USD (e.g. (0, 24, 8))

Note

Your version may differ from this tutorial. It will match version of the pre-built binaries that you downloaded.

These instructions assume that you have configured usdview and all other scripts to be executed globally.

  1. Run source set_usd_env.sh.

That’s all it takes to configure your environment. You can use this simple python command to test that it worked.

  1. Run python3 -c "from pxr import Usd;print(Usd.GetVersion())".

    • It should print the version of your configured USD (e.g. (0, 24, 8))

Note

Your version may differ from this tutorial. It will match version of the pre-built binaries that you downloaded.

On this page