.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH USDVIEW "1" "September 2026" "usdview 26.08" "User Commands"
.SH NAME
usdview \- manual page for usdview 26.08
.SH DESCRIPTION
usage: \fI\,/build/usd/pkg/usd/usr/bin/usdview\/\fP [\-h] [\-\-renderer {Storm,Embree,GL}]
.TP
[\-\-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,...]]
[usdFile]
.PP
View a usd file
.SS "positional arguments:"
.TP
usdFile
The file to view (Optional)
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-\-renderer\fR, \fB\-r\fR {Storm,Embree,GL}
Which render backend to use (named as it appears in
the menu). 'GL' and 'Storm' currentlyalias to the same
renderer, Storm.
.TP
\fB\-\-select\fR PRIMPATH
A prim path to initially select and frame
.TP
\fB\-\-camera\fR, \fB\-cam\fR CAMERA
Which camera to set the view to on open \- 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)
.TP
\fB\-\-mask\fR 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.
.TP
\fB\-\-clearsettings\fR
Restores usdview settings to default
.TP
\fB\-\-config\fR {}
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
.TP
\fB\-\-defaultsettings\fR
Launch usdview with default settings
.TP
\fB\-\-norender\fR
Display only hierarchy browser
.TP
\fB\-\-noplugins\fR
Do not load plugins
.TP
\fB\-\-unloaded\fR
Do not load payloads
.TP
\fB\-\-bboxStandin\fR
Display unloaded prims with bounding boxes
.TP
\fB\-\-timing\fR
Echo timing stats to console. NOTE: timings will be
unreliable when the \fB\-\-memstats\fR option is also in use
.TP
\fB\-\-allow\-async\fR
Enable asynchronous hydra scene processing
.TP
\fB\-\-traceToFile\fR TRACETOFILE
Start tracing at application startup and write
\fB\-\-traceFormat\fR specified format output to the specified
trace file when the application quits
.TP
\fB\-\-traceFormat\fR {chrome,trace}
Output format for trace file specified by
\fB\-\-traceToFile\fR. 'chrome' files can be read in chrome,
\&'trace' files are simple text reports.
(default=chrome)
.TP
\fB\-\-tracePython\fR
Enable python trace collection, requires \fB\-\-traceToFile\fR
to be set.
.TP
\fB\-\-memstats\fR {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.
.TP
\fB\-\-dumpFirstImage\fR DUMPFIRSTIMAGE
Dumps the first image to file (as png)
.TP
\fB\-\-viewportSize\fR VIEWPORTSIZE
Fix the viewport to a specific size (WxH) for
deterministic rendering, e.g. 601x458
.TP
\fB\-\-numThreads\fR NUMTHREADS
Number of threads used for processing(0 is max,
negative numbers imply max \- N)
.TP
\fB\-\-ff\fR FIRSTFRAME
Set the first frame of the viewer
.TP
\fB\-\-lf\fR LASTFRAME
Set the last frame of the viewer
.TP
\fB\-\-cf\fR CURRENTFRAME
Set the current frame of the viewer
.TP
\fB\-\-complexity\fR, \fB\-c\fR {low,medium,high,veryhigh}
Set the initial mesh refinement complexity (low).
.TP
\fB\-\-quitAfterStartup\fR
quit immediately after start up
.TP
\fB\-\-sessionLayer\fR 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.
.TP
\fB\-\-mute\fR 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.
.SS "Detached Layers:"
.IP
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.
.TP
\fB\-\-detachLayers\fR
Detach all layers
.TP
\fB\-\-detachLayersInclude\fR PATTERN[,PATTERN...]
Detach layers with identifiers containing any of the
given patterns.
.TP
\fB\-\-detachLayersExclude\fR PATTERN[,PATTERN,...]
Exclude layers with identifiers containing any of the
given patterns from the set of detached layers
specified by the \fB\-\-detachLayers\fR or
\fB\-\-detachLayerIncludes\fR arguments.