--scale
<factor>Scale every loaded object uniformly by the given multiplier, baking the resize directly into mesh geometry in command-line order alongside other active transforms, before slicing begins.
Details
--scale accepts a single positive floating-point multiplier and applies it uniformly across all three axes of every object in every loaded model. A value of 1.0 is the identity (no change); 1.5 makes each dimension 150% of its original size; 0.5 halves it. The default when the flag is omitted is 1.0. Any value that is zero or negative causes the CLI to log an invalid-params error and exit immediately with a non-zero status code -- the slice is never started.
The transform is applied directly to the mesh volumes of each object, not to placement instances. This means the change in size is baked into the geometry before arrangement, bed-fit checks, and slicing run. Because --scale is classified as a transform, it is collected in command-line order alongside --rotate, --rotate-x, --rotate-y, and other active transform flags such as --arrange and --orient, and the entire transform list is replayed in that order before slicing begins. The sequence you pass on the command line is therefore meaningful: --rotate 45 --scale 1.5 and --scale 1.5 --rotate 45 produce identical results for uniform scale (since uniform scaling commutes with rotation), but if you are composing multiple transforms it is worth being deliberate about order.
Watch out for
- ▲ A factor of `0` or any negative number is a hard error that aborts with an invalid-parameters exit before slicing starts -- there is no fallback to the default.
- ▲ The scale is applied to every object across all input files in a single invocation. There is no per-object targeting; if you need to scale objects independently, slice them in separate invocations.
- ▲ After scaling up, objects that were near the bed boundary may exceed it. The CLI does not automatically re-center or re-arrange after a `--scale`; pair it with an arrange action (`--arrange`) if needed.
Sign up for free today
No credit card required. Connect unlimited printers and get production automation running in minutes.