USDVIEW(1)

NAME
usdview - manual page for usdview 26.08

DESCRIPTION
usage: /build/usd/pkg/usd/usr/bin/usdview [-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,...]] [usdFile]

View a usd file

  positional arguments:

usdFile
    The file to view (Optional)

  options:

-h, --help
    show this help message and exit

--renderer, -r {Storm,Embree,GL}
    Which render backend to use (named as it appears in the menu). 'GL' and 'Storm' currentlyalias to the same renderer, Storm.

--select PRIMPATH
    A prim path to initially select and frame

--camera, -cam 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)

--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.

--clearsettings
    Restores usdview settings to default

--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

--norender
    Display only hierarchy browser

--noplugins
    Do not load plugins

--unloaded
    Do not load payloads

--bboxStandin
    Display unloaded prims with bounding boxes

--timing
    Echo timing stats to console. NOTE: timings will be unreliable when the --memstats option is also in use

--allow-async
    Enable asynchronous hydra scene processing

--traceToFile TRACETOFILE
    Start tracing at application startup and write --traceFormat specified format output 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)

--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

--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.

--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.

  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

--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.