sbsrender command line options

sbsrender

Usage

Global options

--doc-html, --doc
Generate basic documentation html from the option's help.
--help, -h, -?
Display help about given subcommand. If no subcommand is provided, this help about global options is printed.
--opt-descr
Create json description of all available options
--quiet, -q
Disable warning messages.
--verbose, -v
Enable info and debug messages.
--version, -V
Display version of the program.

Subcommand info

Description

Return description of a Substance 3D asset file.

I⁄O options

--input <path>
Substance 3D asset file described. This option is implicit, so you can just provide a filepath at the end of your arguments, they will be interpreted as input.

Subcommand render

Description

Render outputs of a Substance 3D asset file to image files.

I⁄O options

--exr-format-compression <format> [default: "piz"]
EXR compression to use for output image. Default='piz'. Compressions Supported: - none: no compression. - zip: zlib compression, in blocks of 16 scan lines. - piz: piz-based wavelet compression. - pxr24: lossy 24-bit float compression. - b44: lossy 44% float compression - goes to 22% when combined with EXR_LC.
--exr-format-use-float
Save EXR image data as float instead of as half.
--input, --inputs <path>
The Substance 3D asset file to render.
--input-graph <graph_url>
Select specific graph to be rendered. If no graph are selected, all graphs are rendered.
--input-graph-output <name>
Select output to be rendered. If no output are selected, all outputs are rendered.
--input-graph-output-usage <name>
Select output to be rendered by giving usage name.
--no-report
Inhibits writing of JSON output to stdout.
--output-bit-depth <name>
Change the bit depth of the result image. The computation is still done in the bit depth the cooked graph uses. This option only affects the bit depth of the output image. <name> can be set to "8" (or "int8"), "16" (or "int16"),"16f" (or "float16") or "32f" (or "float32").
--output-colorspace <string>
Specify the colorspace name for outputs. --output-colorspace sRGB.
--output-format <format> [default: "png"]
Format to use for output image file. Default='png'. Formats Supported: surface, dds, bmp, jpg, jif, jpeg, jpe, png, tga, targa, tif, tiff, wap, wbmp, wbm, psd, psb, hdr, exr, webp.
--output-format-compression <format> [default: "raw"]
Dds compression to use for output image. Default='raw'. Compressions Supported: raw, dxt1, dxt3, dxt5.
--output-name <name> [default: "{inputName}_{inputGraphUrl}_{outputNodeName}"]
Output file name, if the correct file extension is not present it will be added. Default='{inputName}_{inputGraphUrl}_{outputNodeName}'. You can use the following patterns that will be replaced by the program when saving the result of the process: - {inputName} replaced by the archive filename. - {inputGraphUrl} replaced by the graph url. - {outputNodeName} replaced by the output name. - {colorspace} replaced by the output colorspace.
--output-path <path>
Output file path. Default path is empty. You can use the following patterns that will be replaced by the program when saving the result of the process: -{inputPath} replaced by the input filepath.
--png-format-compression <format> [default: "default"]
PNG compression to use for output image. Default='default'. Compressions Supported: default, best_speed, best_compression, none.

Specific options

--set-entry <arg>
Set image data to an image input. Format of <arg>: <input_identifier>@<filepath_of_image>.
--set-entry-colorspace <arg>
Specify the colorspace name for an input. --set-entry-colorspace input_id@sRGB.
--set-entry-usage <string>
Set image data to an image input given by usage name. If --set-entry option is used --set-entry-usage will be ignored. Format of <arg>: <input_usage>@<filepath_of_image>.
--set-output-bit-depth <arg>
Change the bit depth of an output node.
--set-output-colorspace <arg>
Specify the colorspace name for an output. --set-output-colorspace output_id@sRGB.
--set-output-format <arg>
Change the image format of an output node.
--set-value <arg>
Set value to a numerical input parameter. Format of <arg> : <input_identifier>@<value>.
--use-preset <name>
Use a specific preset to set values. <name> is the name of preset that must be included in the input sbsar file.

Runtime options

--ace
Use Adobe ACE color management engine.
--ace-render-intent <string>
Render intent to use when using Adobe ACE. The default value if not specified is relative-colorimetric. Valid options include perceptual, saturation, relative-colorimetric and absolute-colorimetric
--ace-working-space <string>
Working color space to use when using Adobe ACE. The default value if not specified is srgb. Valid options include srgb, linear-srgb, acescg and linear-adobe-rgb-1998
--cache-dir <string>
Sets the folder where intermediate render results will be stored.
--cpu-count <uint>
Set the maximum amount of CPU cores that the Substance Engine is allowed to use.
--engine <arg>
Switch to specific engine implementation. format of <arg> : <dynamic_library_filepath> or <engine_version_basename_substring> GPU engine: vk (linux, windows), ogl3 (linux, macos), mtl (macos), d3d11 (windows) CPU engine: sse2 (linux, windows), neon (macos)
--gpu <uint>
Select a GPU to perform renders. Use --gpu-list to find the correct index for a given GPU (Windows-only)
--gpu-list
List the various GPUs found in the machine (Windows-only)
--icc-profiles-dir <string>
Specify the directory to search for user ICC profiles. Only used when ACE color management is enabled.
--memory-budget <uint>
Set the maximum amount of memory that the Substance Engine is allowed to use. In MB (default 1000 MB).
--ocio <string>
Specify an OpenColorIO configuration to use.