Format:USD
| 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
_BootStrapstruct (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, eachchar 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