Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:USD

From ReverseEngineering.wiki
Format
Vendor Pixar
Magic #usda 1.0 / PXR-USDC / PK
Extensions .usd, .usda, .usdc, .usdz
On this wiki Facts · Code · Notes · Topics

Pixar Universal Scene Description: .usda text ("#usda 1.0"), .usdc binary crate ("PXR-USDC" bootstrap with version bytes) and .usdz, a ZIP with 64-byte-aligned stored files.

Variants

A .usd file may hold either encoding; check the first bytes. OpenUSD (pxr/usd/sdf) has one file format class per variant.

  • usda: text starting with the cookie #usda 1.0 (usdaFileFormat.cpp line 63, modernCookie). The source comments (lines 81-120) say the version in that first line is rewritten in place, with padding spaces left in the header line.
  • usdc (crate): starts with a _BootStrap struct (crateFile.h lines 479-486): uint8 ident[8] = PXR-USDC (crateFile.cpp line 444), uint8 version[8] (byte 0 major, 1 minor, 2 patch, the rest unused), int64 tocOffset, then 64 reserved bytes: 88 bytes in total. The reader checks the ident, that the software can read the version, and that tocOffset is inside the file (crateFile.cpp _ReadBootStrap, lines 3531-3560). The table of contents at tocOffset is a list of sections, each char name[16], int64 start, int64 size (crateFile.h lines 488-499); names in crateFile.cpp lines 277-282 include TOKENS, STRINGS, FIELDS, FIELDSETS, PATHS and SPECS.
  • usdz: a ZIP archive. OpenUSD's writer (pxr/usd/sdf/zipFile.cpp) states that file data must be aligned to 64 bytes, padding with the zip "extra" field (lines 429-460), and writes files with compression method 0 (no compression, line 1044). Unverified: readers reject compressed entries.

Crate versions

The version history is in comments at crateFile.cpp lines 394-414: 0.0.1 initial; 0.1.0 structure layout fix for Windows; 0.2.0 prepend/append list ops; 0.4.0 compressed structural sections; 0.5.0 compressed int arrays; 0.7.0 array sizes as 64-bit; 0.8.0 payload list ops and layer offsets; 0.9.0 timecode values; 0.10.0 pathExpression; 0.11.0 relocates; 0.12.0 splines; 0.14.0 array edits; 0.16.0 GfDuration. At that commit the oldest supported version is 0.4.0 and new files default to 0.8.0 (lines 159-170).

Tools and sources

OpenUSD under the Tomorrow Open Source Technology License 1.0 (Apache 2.0 with a different trademark clause): https://github.com/PixarAnimationStudios/OpenUSD

Code & repositories

  • https://github.com/PixarAnimationStudios/OpenUSD @ bc32a655a41770f8ded78ef43789b044be1ba5ea · license: TOST-1.0 (declared by the contributor; GitHub's detector did not recognize LICENSE.txt)
    Pixar OpenUSD; pxr/usd/sdf crateFile, zipFile, usdaFileFormat
    Tested on: source read, not run: source read only · checked 2026-10-19; last activity 2026-10-17

See also

Format:ZIP, Format:GlTF, Format:COLLADA