User Guide Cancel

sbsrender command line options | Substance 3D Automation ToolKit

  1. Substance 3D home
  2. Home
  3. Command Line Tools
    1. Command Line overview
    2. sbsbaker
      1. sbsbaker overview
      2. sbsbaker command line options
      3. sbsbaker Example Command Lines
    3. sbscooker
      1. sbscooker overview
      2. sbscooker command line options
      3. sbscooker pattern variables
    4. sbsmtools
      1. sbsmtools overview
      2. sbsmtools command line options
    5. sbsmutator
      1. sbsmutator overview
      2. sbsmutator command line options
      3. sbsmutator Example Command Lines
    6. sbsrender
      1. sbsrender overview
      2. sbsrender base parameters and pattern variables
      3. sbsrender command line options
      4. sbsrender example command lines
    7. sbsupdater
      1. sbsupdater overview
      2. sbsupdater command line options
  4. Pysbs - Python API
    1. Pysbs - Python API overview
    2. Getting started
    3. General topics
      1. Basic manipulation
      2. Substance creation
      3. Substances modification
      4. Dependencies management
      5. PySbs batchtools module
      6. metadata manipulation
      7. SAT demos
      8. Edit sbsar with SBSARManager
      9. Spot Colors
      10. Thumbnail creation with SAT
    4. Examples
      1. demohelloworld
      2. demos
      3. demos_batchtools
      4. script_update_with_sbsupdater
    5. API Content
      1. API Content overview
      2. Substance definitions
        1. Common interfaces
          1. basegraph
          2. package
          3. sbsarobject
          4. sbsobject
        2. compnode
          1. compnode overview
          2. common
          3. compimplementation
          4. paramgraph
        3. context projectmgr
        4. graph
          1. graph overview
          2. function
          3. inputparameters
          4. output
        5. mdl
          1. mdlannotation
          2. mdlcommon
          3. mdldictionaries
          4. mdlenum
          5. mdlgraph
          6. mdllibclasses
          7. mdlmanager
          8. mdlnode
          9. mdlnodeimpl
          10. mdloperand
          11. mdlsbsbridge
        6. modelgraphindex
          1. modelannotationnames
          2. modelgraph
          3. modelgraphgenerator
          4. modelgraphimplementation
          5. modelnodenames
          6. modeloperand
          7. modulegraphindex
          8. moduleannotation
          9. moduleconnection
          10. modulegraph
          11. modulegraphgenerator
          12. modulegraphimplementation
          13. modulegraphlibrary
          14. modulegraphregister
          15. modulenode
          16. modulenodeimplementation
          17. modulenodeinstance
          18. moduleoperand
          19. moduleoutputbridging
          20. moduleparaminput
        7. params
          1. params overview
          2. dynamicvalue
          3. paramnode
        8. projectmgrdoc
        9. sbsarchive
          1. sbsarchive overview
          2. sbsarenum
          3. sbsargraph
          4. sbsargui
          5. sbsarguiwidgets
          6. sbsarmanager
        10. sbscommon
          1. connections
          2. gui
          3. nodes
          4. values
        11. sbspreset
        12. sbsproject
        13. substance
          1. substance overview
          2. content
          3. resource
      3. Libraries
        1. sbsenum
        2. sbslibrary
          1. sbslibrary overview
          2. sbsdictionaries
          3. sbsfilters
          4. sbsfunctions
          5. sbsfxmapnodes
          6. sbslibclasses
          7. sbswidgets
        3. sbsbakerslibrary
          1. sbsbakerslibrary overview
          2. sbsbakersdef
          3. sbsbakersdefaultprops
          4. sbsbakersdictionaries
          5. sbsbakersenum
          6. sbsbakingconverter
          7. sbsbakingconverterparam
          8. sbsbakingparameters
          9. sbsdialogstate
          10. sbsscenedata
        4. Helpers
          1. sbscleaner
          2. sbsexporter
          3. sbsgenerator
          4. sbsparser
          5. sbswriter
          6. qtclasses
            1. qtclasses overview
            2. qtvariantreader
            3. qtvariantwriter
          7. psdparser
          8. sbsimpactmanager
          9. batchtools
          10. autograph
            1. ag_functions
            2. ag_layout
            3. ag_types
          11. info_mesh_parser
          12. sbsbaker_info_handlers
          13. sbsrender_render_handlers
          14. output_handlers
          15. spotcolorinfo_handler
          16. thumbnail
          17. batchtools overview
        5. Execution context
          1. context
          2. functions
        6. API Change log
  5. Samples
    1. Samples overview
    2. Texturing Template Demo
    3. Batch Tools Demo
    4. Variations
    5. Texture Mat
    6. Pixel Processor Ray tracer
  6. Setup and Getting Started
    1. Setup and Getting Started overview
    2. Compatibility
    3. Frequently asked Questions
    4. Known issues
    5. SAT Cookbook
    6. Use Pysbs in different python interpreter (maya, sd, blender...)
  7. Integrations
    1. Substance Maya toolset
      1. Substance Maya Toolset overview
      2. Installing
      3. Launching
      4. Baking
        1. Baking overview
        2. Export parameters
        3. Baker parameters
        4. Mesh setup
        5. Using a template
      5. Changelog
  8. Changelog overview

sbsrender command line options

sbsrender

Usage

  • sbsrender [...] info [...]
  • sbsrender [...] render [...]

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 archive file.

I⁄O options

--input
Substance Archive 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 archive file to image files.

I⁄O options

--input, --inputs
The substance archive to render.
--input-graph
Select specific graph to be rendered. If no graph are selected, all graphs are rendered.
--input-graph-output
Select output to be rendered. If no output are selected, all outputs are rendered.
--input-graph-output-usage
Select output to be rendered by giving usage name.
--no-report
Inhibits writing of JSON output to stdout.
--output-bit-depth
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. can be set to "8" (or "int8"), "16" (or "int16"),"16f" (or "float16") or "32f" (or "float32").
--output-colorspace
Specify the colorspace name for outputs. --output-colorspace sRGB.
--output-format [default: "png"]
Format to use for output image file. Default='png'. Formats Supported: dds, bmp, jpg, jif, jpeg, jpe, png, tga, targa, tif, tiff, wap, wbmp, wbm, psd, psb, hdr, exr, webp, surface.
--output-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
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 [default: "default"]
PNG compression to use for output image. Default='default'. Compressions Supported: default, best_speed, best_compression, none.

Specific options

--set-entry
Set image data to an image input. Format of : @.
--set-entry-colorspace
Specify the colorspace name for an input. --set-entry-colorspace input_id@sRGB.
--set-entry-usage
Set image data to an image input. Format of : @.
--set-output-bit-depth
Change the bit depth of an output node.
--set-output-colorspace
Specify the colorspace name for an output. --set-output-colorspace output_id@sRGB.
--set-output-format
Change the image format of an output node.
--set-value
Set value to a numerical input parameter. Format of : @.
--use-preset
Use a specific preset to set values. 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
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
Working color space to use when using Adobe ACE. The default value if not specified is srgb. Valid options include srgb, linear-srgb and acescg
--cache-dir
Sets the folder where intermediate render results will be stored.
--cpu-count
Set the maximum amount of CPU cores that the Substance Engine is allowed to use.
--engine
Switch to specific engine implementation. format of : or e.g.: ogl3, d3d11pc, ...
--icc-profiles-dir
Specify the directory to search for user ICC profiles. Only used when ACE color management is enabled.
--memory-budget
Set the maximum amount of memory that the Substance Engine is allowed to use. In MB (default 2000 MB).
--ocio
Specify an OpenColorIO configuration to use.

 Adobe

Get help faster and easier

New user?