Toolbox

Placement

Auto Placement

Auto Placement

Placement

Distributes N copies of a hardware on a chosen face using a CSS-flexbox layout (justify-content along the layout axis — the longer one or the one Direction picks, align-items along the cross axis, horizontal/vertical padding shrinks the working area). Each copy sits on the face with its top along the outward normal, and its machine operations move with it.

Docs for v3.1.0, the latest version.

ID

toolbox-placement-auto-placement

Group

Placement

Plugin

Toolbox

Keywords

auto
placement
face
distribute
flex
tools
hardware
host
3 inputs, 2 outputs, 12 config ports

Ports

Inputs

3

What the node takes in, from wires or typed values.

Item

Any

The hardware (a Hardware node left without a plane) to copy onto every distributed position, with its machine operations.

Host Solid

Solid

Solid whose face hosts the distributed tools.

Face Index

Number

Default 0

Index of the host face (wraps modulo face count).

Outputs

2

What the node gives out, to wire into other nodes.

Placed Item

Any

Every placed copy of the hardware, with its machine operations in world coordinates in meta.machiningOps.

OpsGeom

Geometry

Cutting-tool solids per baked op (for visualization).

Config

12

Settings on the node itself, changed in its panel.

Count

Number

Default 2

Number of tool copies along the main axis.

Depth

Number

Default 0

Penetration along the inward face normal (mm). 0 = ops sit on the face.

Spacing

Boolean

Default true

By Size: copies are laid out by their footprint and Flex Grow applies. By Point: Flex Grow is ignored, every copy is laid out by its zero point regardless of its footprint, and paddings may be negative to widen the working area past the face.

Direction

String

Default auto

The face axis the copies are laid out along. Auto takes the longer one, so the layout turns when the face changes proportions; X (uAxis) and Y (vAxis) keep it on that axis.

Justify

String

Default space-between

CSS justify-content along the layout axis.

Align

String

Default center

CSS align-items across the face cross axis.

Padding X

Number

Default 10

Horizontal padding (mm): shrinks the working area from both ends of the main axis. With Spacing By Point it may be negative, widening the area.

Padding Y

Number

Default 0

Vertical padding (mm): shrinks the working area from both ends of the cross axis. With Spacing By Point it may be negative, widening the area.

Rotate X

Number

Default 0

Rotation (deg) around the face X axis (uAxis), pivoting at the world image of the tool’s local zero point ([0,0,0]) for each copy, i.e. the group anchor. Tilts the tool forward/back in the face plane.

Rotate Y

Number

Default 0

Rotation (deg) around the face Y axis (vAxis), pivoting at the world image of the tool’s local zero point ([0,0,0]) for each copy, i.e. the group anchor. Tilts the tool left/right in the face plane.

Rotate Z

Number

Default 0

Rotation (deg) around the face normal, pivoting at the tool’s local zero point ([0,0,0]) for each copy. Turns the tool in the face plane, counter-clockwise seen from outside the part. Applied before Rotate X and Rotate Y.

Flex Grow

Any

Default {"entries":[]}

Per-element CSS flex-grow weights. Each entry overrides the default of 0 for the given element index. When sum(grow) > 0, free space is distributed among grown elements proportionally (expanding their slots) and justify-content is ignored. When all weights are 0 (or no entries), layout falls back to justify-content.

This node has no documentation beyond its description and ports yet.

History

Changed in v3.1.0

Nov 19, 2026

config rotateZ: added

Changed in v2.0.0

Nov 3, 2026

config flex: added
config direction: added

First documented in v1.0.24

Oct 20, 2026

Versions before it were published before changes were recorded.