TESTUSDVIEW(1)

💖 NAME 💖

testusdview — manual page for testusdview 26.11.1, hanging out in User Commands (yes, the TESTUSDVIEW(1) one, iykyk). This is the whole vibe, bestie: the viewer manual, but make it make sense. 💅

---

✨ DESCRIPTION ✨

Okay so, here's the exact invocation energy:

       usage: /build/usd/pkg/usd/usr/bin/testusdview [-h]

       [--renderer {Storm,Embree,GL}]
              [--select PRIMPATH] [--camera CAMERA] [--mask
              PRIMPATH[,PRIMPATH...]]  [--clearsettings] [--config {}]
              [--defaultsettings] [--norender] [--noplugins] [--unloaded]
              [--bboxStandin] [--timing] [--allow-async] [--traceToFile
              TRACETOFILE] [--traceFormat {chrome,trace}] [--tracePython]
              [--memstats {none,stage,stageAndImaging}] [--dumpFirstImage
              DUMPFIRSTIMAGE] [--viewportSize VIEWPORTSIZE] [--numThreads
              NUMTHREADS] [--ff FIRSTFRAME] [--lf LASTFRAME] [--cf
              CURRENTFRAME] [--complexity {low,medium,high,veryhigh}]
              [--quitAfterStartup] [--sessionLayer SESSIONLAYER] [--mute
              MUTELAYERSRE] [--detachLayers] [--detachLayersInclude
              PATTERN[,PATTERN...]]  [--detachLayersExclude
              PATTERN[,PATTERN,...]]  --testScript TESTSCRIPT [usdFile]

View a usd file — that's the assignment, fr fr.

---

🎀 positional arguments 🎀

• usdFile — the file to view (Optional). Yes, optional, so breathe.

---

💅 options 💅

Okay bestie, this is the big one. Every flag, no skips, no cap. 🫶

• -h, --help — show this help message and exit. Iconic behavior.
• --renderer, -r {Storm,Embree,GL} — which render backend to use (named as it appears in the menu). GL and Storm currently alias to the same renderer, Storm.
• --select PRIMPATH — a prim path to initially select and frame. Main character prim energy.
• --camera, -cam CAMERA — which camera to set the view to on open. It may be given as either just the camera's prim name (ie, just the last element in the prim path), or as a full prim path. Note that if only the prim name is used, and more than one camera exists with the name, which is used will be effectively random (default=None). So yeah, chaos is possible. 😭
• --mask PRIMPATH[,PRIMPATH...] — limit stage population to these prims, their descendants and ancestors. To specify multiple paths, either use commas with no spaces or quote the argument and separate paths by commas and/or spaces. Very specific, very slay.
• --clearsettings — restores usdview settings to default. Fresh start, clean face, new me.
• --config {} — load usdview with the state settings found in the specified config. If not provided will use the previously saved application state and automatically persist state on close.
• --defaultsettings — launch usdview with default settings. No thoughts, just defaults. ✨
• --norender — display only hierarchy browser. Minimalist era.
• --noplugins — do not load plugins. Plugins, we love you, but not today.
• --unloaded — do not load payloads. Keeping it light, lowkey.
• --bboxStandin — display unloaded prims with bounding boxes. Boxes are literally doing their best.
• --timing — echo timing stats to console. NOTE: timings will be unreliable when the --memstats option is also in use. So don't trust the numbers when both are on, bestie.
• --allow-async — enable asynchronous hydra scene processing. Multitasking queen behavior.
• --traceToFile TRACETOFILE — start tracing at application startup and write output in the format specified by --traceFormat to the specified trace file when the application quits.
• --traceFormat {chrome,trace} — output format for trace file specified by --traceToFile. chrome files can be read in chrome, trace files are simple text reports. (default=chrome)
• --tracePython — enable python trace collection, requires --traceToFile to be set.
• --memstats {none,stage,stageAndImaging} — use the Pxr MallocTags memory accounting system to profile USD, saving results to a tmp file, with a summary to the console. Will have no effect if MallocTags are not supported in the USD installation.
• --dumpFirstImage DUMPFIRSTIMAGE — dumps the first image to file (as png). Little screenshot moment. 📸
• --viewportSize VIEWPORTSIZE — fix the viewport to a specific size (WxH) for deterministic rendering, e.g. 601x458.
• --numThreads NUMTHREADS — number of threads used for processing (0 is max, negative numbers imply max - N).
• --ff FIRSTFRAME — set the first frame of the viewer.
• --lf LASTFRAME — set the last frame of the viewer.
• --cf CURRENTFRAME — set the current frame of the viewer.
• --complexity, -c {low,medium,high,veryhigh} — set the initial mesh refinement complexity (low).
• --quitAfterStartup — quit immediately after start up. In and out, no loitering.
• --sessionLayer SESSIONLAYER — if specified, the stage will be opened with the sessionLayer in place of the default anonymous layer. As this changes the session layer from anonymous to persistent, be aware that layers saved from Export Overrides will include the opinions in the persistent session layer. Big important note, don't skip it. 👀
• --mute MUTELAYERSRE — layer identifiers searched against this regular expression will be muted on the stage prior to, and after loading. Multiple expressions can be supplied using the | regex separator operator. Alternatively the argument may be used multiple times.
• --testScript TESTSCRIPT — the test script to run after loading. This script must expect to take a single

---

🦋 Detached Layers 🦋

Specify layers to be detached from their serialized data source when loaded. This may increase time to load and memory usage but will avoid issues like open file handles preventing other processes from safely overwriting a loaded layer.

• --detachLayers — detach all layers. All of them. Every last one.
• --detachLayersInclude PATTERN[,PATTERN...] — detach layers with identifiers containing any of the given patterns.
• --detachLayersExclude PATTERN[,PATTERN,...] — exclude layers with identifiers containing any of the given patterns from the set of detached layers specified by the --detachLayers or --detachLayerIncludes arguments.

---

Signed off by testusdview 26.11.1, dated October 2026 — source/version and date included, periodt. 💖✨🫶💅