solidly render

solidly render <file-or-folder> [options]
solidly -r <file-or-folder> [options]

Renders one image per model using the same renderer the application uses, with no window and no user interaction.

Examples

Render every supported model under a folder from the front:

solidly render ~/Models --output ~/Renders --preset front --resolution 3840x2160

Render one glTF with a transparent background:

solidly render ~/Models/Chair/chair.gltf --output ~/Renders --preset isometric --transparent --format png

Place the camera exactly:

solidly render ~/Models/chair.gltf --output ~/Renders --camera-position 2,1.5,3 --camera-target 0,0,0 --fov 35 --resolution 2400x1600

A complete production invocation:

solidly -r ~/Models/Chair/chair.gltf -o ~/Renders --resolution 3840x2160 --preset isometric --anti-aliasing 4 --tone-mapping pbr-neutral --light-direction 0.25,-1,-0.4 --light-color '#ffffff' --light-intensity 2.2 --ambient-sky-color '#ffffff' --ambient-ground-color '#8c8c8c' --ambient-intensity 0.35 --bloom true --bloom-intensity 0.15 --exposure 0.5 --contrast 1 --saturation 1 --gamma 1

Every option is optional. An option that is not given takes the default shown, and the defaults are the same on every Mac except where the table says otherwise. Progress is written to standard output, one line per model loaded and per image saved.

Output

--transparent cannot be combined with --format jpg, since JPEG has no alpha channel.

Camera

Depth of field

Background and environment

Without --skybox, the environment still lights the model but is not drawn behind it. The environment used for lighting is the one the model authors, such as a USD dome light, and Studio when the model authors none.

Lighting

Image quality and grading

Material features

Each of these switches one contribution on or off, in the same way the Render tab's channel switches do. All of them are on by default.

USD and animation

When a stage subdivides, each model's progress line reports the complexity that was applied. If the face budget for the Mac lowered the requested level, the line names both levels and the budget. See Subdivision.

--complexity applies to USD only. STEP and IGES files are rendered at the level Auto chooses; see Complexity.

Output file names

For a single file, the name is the model's own with its format appended, followed by the camera preset:

chair-gltf-isometric.png

For a folder, the name is the model's path relative to the folder, with / replaced by __:

Furniture__Chair__chair-gltf-front.png
Vehicles__Car__car-glb-front.png

Keeping the source format in the name stops a sibling model.usda and model.usdz overwriting each other during one folder render.

Exit status and errors

Each model is rendered independently. A model that fails to load or render is reported on standard error, together with the same load diagnostics the application would show, and the run continues with the next model. The exception is a model that exceeds the import memory limit while it is loading, which stops the run with exit status 78; see The solidly command.

The command exits with a success status when every model rendered, and with a failure status when any did not, after reporting how many failed.

If Solidly is locked on the Mac, the command renders nothing, reports the reason on standard error, and exits with a failure status. See Trial and purchase.