NAME

usdcat - manual page for usdcat 26.08

SYNOPSIS

usdcat [OPTIONS] inputFiles...

DESCRIPTION

Write usd file(s) either as text to stdout or to a specified output file.

OPTIONS

-h,--help

Print this help message and exit

-o,--out file

Write a single input file to this output file instead of stdout.

--usdFormat usda|usdc

Use this underlying file format for output files with the extension 'usd'. For example, passing '-o output.usd --usdformat usda' will create output.usd as a text file. The USD_DEFAULT_FILE_FORMAT environment variable is another way to achieve this.

-l,--loadOnly

Attempt to load the specified input files and report 'OK' or 'ERR' for each one. After all files are processed, this script will exit with a non-zero exit code if any files failed to load.

-f,--flatten

Compose stages with the input files as root layers and write their flattened content.

--flattenLayerStack

Flatten the layer stack with the given root layer, and write out the results. Unlike --flatten, this does not flatten composition arcs (such as references).

--skipSourceFileComment

If --flatten is specified, skip adding a comment regarding the source of the flattened layer in the documentation field of the output layer.

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

--layerMetadata

Load only layer metadata in the USD file. This option cannot be combined with either --flatten or --flattenLayerStack.