--allow-rotations
Allow the arrange engine to rotate each object to its lowest-cost orientation on the build plate; default is on, and disabling it forces every object to be placed at its current 0° orientation.
Details
Controls whether the arrange engine is permitted to rotate objects when placing them on the build plate. It accepts a boolean value; the default is true, meaning rotations are on unless explicitly disabled.
When the flag is true, the arranger does not merely test a fixed grid of angles. For each object it first computes the minimum-area bounding box rotation — the Z-axis angle that minimizes the object's footprint — then assembles a candidate angle set around that result. If the computed angle is negligible (effectively 0°), the engine tests the four standard orientations: 0°, 45°, 90°, and 135°. Otherwise it tests five candidates: the explicit 0°, the optimal angle itself, and the optimal angle offset by 45°, 90°, and 135°. The placement with the lowest packing cost wins. When the flag is false, the candidate set collapses to a single angle (0°), and every object is placed exactly as oriented in the 3MF.
The flag is wired into the arrange configuration at both arrange call sites in the CLI: the assemble-plates path (a per-plate loop used when assembling multi-source plate jobs) and the standard arrange path (used for both global multi-plate and single-plate arrange). Both paths forward the value identically, so the behavior is consistent regardless of which arrange mode is active.
Watch out for
- ▲ The default is `true`, so passing `--allow-rotations` without a value is redundant — it just confirms what is already on. To disable rotation you must supply an explicit value: `--allow-rotations 0` or `--allow-rotations false`. The `--no-` prefix mechanism is disabled in this engine and will be rejected as an invalid option.
- ▲ Rotation here is purely about placement orientation on the XY bed plane. It does not flip objects, change layer orientation, or alter any per-object transform stored in the 3MF beyond the arrange result.
- ▲ When rotations are enabled, two objects that were intentionally aligned to each other (e.g., a left and right mirror pair) may be individually reoriented by the arranger and lose that alignment. Lock placement in the 3MF or disable this flag if relative object orientation must be preserved.
Sign up for free today
No credit card required. Connect unlimited printers and get production automation running in minutes.