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