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