1USDVIEW(1) User Commands USDVIEW(1)
2
3
4
6 usdview - manual page for usdview 22.05b
7
9 Warning: in _DiscoverPlugins at line 207 of /build‐
10 dir/build/BUILD/USD-22.05b/pxr/imaging/hf/pluginRegistry.cpp -- Plugin
11 HdEmbreeRendererPlugin type information incomplete Warning: in _Discov‐
12 erPlugins at line 207 of /builddir/build/BUILD/USD-22.05b/pxr/imag‐
13 ing/hf/pluginRegistry.cpp -- Plugin HdStormRendererPlugin type informa‐
14 tion incomplete usage: /builddir/build/BUILD‐
15 ROOT/usd-22.05b-41.fc38.x86_64/usr/bin/usdview
16
17 [-h] [--renderer {HydraDisabled}] [--select PRIMPATH] [--camera
18 CAMERA] [--mask PRIMPATH[,PRIMPATH...]] [--clearsettings] [--de‐
19 faultsettings] [--norender] [--noplugins] [--unloaded] [--tim‐
20 ing] [--traceToFile TRACETOFILE] [--traceFormat {chrome,trace}]
21 [--tracePython] [--memstats {none,stage,stageAndImaging}]
22 [--numThreads NUMTHREADS] [--ff FIRSTFRAME] [--lf LASTFRAME]
23 [--cf CURRENTFRAME] [--complexity {low,medium,high,veryhigh}]
24 [--quitAfterStartup] [--sessionLayer SESSIONLAYER] usdFile
25
26 View a usd file
27
28 positional arguments:
29 usdFile
30 The file to view
31
32 options:
33 -h, --help
34 show this help message and exit
35
36 --renderer {HydraDisabled}, -r {HydraDisabled}
37 Which render backend to use (named as it appears in the menu).
38 Use 'HydraDisabled' to turn off Hydra renderers.
39
40 --select PRIMPATH
41 A prim path to initially select and frame
42
43 --camera CAMERA, -cam CAMERA
44 Which camera to set the view to on open - may be given as either
45 just the camera's prim name (ie, just the last element in the
46 prim path), or as a full prim path. Note that if only the prim
47 name is used, and more than one camera exists with the name,
48 which is used will be effectively random (default=main_cam)
49
50 --mask PRIMPATH[,PRIMPATH...]
51 Limit stage population to these prims, their descendants and an‐
52 cestors. To specify multiple paths, either use commas with no
53 spaces or quote the argument and separate paths by commas and/or
54 spaces.
55
56 --clearsettings
57 Restores usdview settings to default
58
59 --defaultsettings
60 Launch usdview with default settings
61
62 --norender
63 Display only hierarchy browser
64
65 --noplugins
66 Do not load plugins
67
68 --unloaded
69 Do not load payloads
70
71 --timing
72 Echo timing stats to console. NOTE: timings will be unreliable
73 when the --memstats option is also in use
74
75 --traceToFile TRACETOFILE
76 Start tracing at application startup and write --traceFormat
77 specified format output to the specified trace file when the ap‐
78 plication quits
79
80 --traceFormat {chrome,trace}
81 Output format for trace file specified by --traceToFile.
82 'chrome' files can be read in chrome, 'trace' files are simple
83 text reports. (default=chrome)
84
85 --tracePython
86 Enable python trace collection, requires --traceToFile to be
87 set.
88
89 --memstats {none,stage,stageAndImaging}
90 Use the Pxr MallocTags memory accounting system to profile USD,
91 saving results to a tmp file, with a summary to the console.
92 Will have no effect if MallocTags are not supported in the USD
93 installation.
94
95 --numThreads NUMTHREADS
96 Number of threads used for processing(0 is max, negative numbers
97 imply max - N)
98
99 --ff FIRSTFRAME
100 Set the first frame of the viewer
101
102 --lf LASTFRAME
103 Set the last frame of the viewer
104
105 --cf CURRENTFRAME
106 Set the current frame of the viewer
107
108 --complexity {low,medium,high,veryhigh}, -c {low,medium,high,veryhigh}
109 Set the initial mesh refinement complexity (low).
110
111 --quitAfterStartup
112 quit immediately after start up
113
114 --sessionLayer SESSIONLAYER
115 If specified, the stage will be opened with the 'sessionLayer'
116 in place of the default anonymous layer. As this changes the
117 session layer from anonymous to persistent, be aware that layers
118 saved from Export Overrides will include the opinions in the
119 persistent session layer.
120
121
122
123usdview 22.05b November 2023 USDVIEW(1)