1USDCAT(1) User Commands USDCAT(1)
2
3
4
6 usdcat - manual page for usdcat 23.08
7
9 usdcat [OPTIONS] inputFiles...
10
12 Write usd file(s) either as text to stdout or to a specified output
13 file.
14
15 Positionals:
16 inputFiles ...
17 A list of input files
18
20 -h,--help
21 Print this help message and exit
22
23 -o,--out file
24 Write a single input file to this output file instead of stdout.
25
26 --usdFormat usda|usdc
27 Use this underlying file format for output files with the exten‐
28 sion 'usd'. For example, passing '-o output.usd --usdformat
29 usda' will create output.usd as a text file. The USD_DE‐
30 FAULT_FILE_FORMAT environment variable is another way to achieve
31 this.
32
33 -l,--loadOnly
34 Attempt to load the specified input files and report 'OK' or
35 'ERR' for each one. After all files are processed, this script
36 will exit with a non-zero exit code if any files failed to load.
37
38 -f,--flatten
39 Compose stages with the input files as root layers and write
40 their flattened content.
41
42 --flattenLayerStack
43 Flatten the layer stack with the given root layer, and write out
44 the results. Unlike --flatten, this does not flatten composition
45 arcs (such as references).
46
47 --skipSourceFileComment
48 If --flatten is specified, skip adding a comment regarding the
49 source of the flattened layer in the documentation field of the
50 output layer.
51
52 --mask PRIMPATH[,PRIMPATH...]
53 Limit stage population to these prims, their descendants and an‐
54 cestors. To specify multiple paths, either use commas with no
55 spaces, or quote the argument and separate paths by commas
56 and/or spaces. Requires --flatten.
57
58 --layerMetadata
59 Load only layer metadata in the USD file. This option cannot be
60 combined with either --flatten or --flattenLayerStack.
61
62
63
64usdcat 23.08 November 2023 USDCAT(1)