--orient
<option>Run the automatic face-down orientation algorithm on every loaded object before slicing by setting the value to 1; 0 (the default) and any other integer skip it entirely.
Details
--orient takes an integer and controls whether the slicer runs its automatic orientation algorithm on loaded objects before slicing. The value 0 explicitly disables orientation for every object: it iterates all loaded objects and marks each one as not requiring reorientation. The value 1 forces orientation for every object: it marks all objects to be reoriented. Any other integer value (the documented "auto") leaves the per-object orientation map in whatever state it was populated during file loading, which in current builds means the map is empty and no objects are reoriented — functionally equivalent to 0.
The orientation algorithm scores a set of candidate face-down directions for each mesh by computing a weighted cost across overhang area, bottom contact area, bottom convex-hull area, projected contour complexity, and low-angle face area. Before running the algorithm the engine copies the active process config into the object so that per-object settings such as support_threshold_angle (default 30 degrees) influence the scoring. The result is a rotation that is applied in-place to the object before arrangement and slicing. Because orientation mutates the object's transform, the slicer regenerates plate thumbnails whenever at least one object was reoriented or re-arranged.
The flag has a compiled-in default of 0. It is processed only when explicitly passed on the command line, so omitting --orient entirely produces the same result as --orient 0: the per-object orientation map starts empty and no objects are reoriented.
Watch out for
- ▲ Passing any integer other than `0` or `1` (the "auto" branch) currently produces no orientation because the code that would pre-populate per-object orient flags from file metadata is disabled; the result is indistinguishable from `0`.
- ▲ With `--orient 1` on a 3MF input, the algorithm overwrites whatever face-down orientation the user chose in the GUI before saving. If the 3MF was exported with a deliberate rotation, that rotation will be discarded.
- ▲ Orientation runs before arrangement. If you are also using `--arrange`, objects are first reoriented and then re-placed on the plate; the two passes are independent and sequential.
Sign up for free today
No credit card required. Connect unlimited printers and get production automation running in minutes.