BoxMaker

Parametric 3D Enclosure Designer — v0.9.4

Untitled

Box & Lid
Dimensions
mm
mm
mm

Interior: 96.0 × 66.0 × 38.0 mm

Walls & Floor
mm
mm
Corner Radii
mm
mm
Lid Plate
mm
mm
Lid Shoulder
mm
mm
mm
Snap-Fit Clips
mm
mm
%
mm
mm
mm
Boards & Objects
Boards
Board file format
A board is a plain text file. 0,0 is a corner you pick, viewed from the COMPONENT side; +X right, +Y up. Board Z = 0 is the non-component face, +Z toward the components. Use // for comments, anywhere on a line.
[board] — key,value lines. Name and Size required.
Name, MyBoard  — matched to BoardName below
Size, X, Y  — board outline (mm)
Thickness, T  — default 1.6
CornerRadius, R  — default 0
Height, H  — total height above the NON-component face, INCLUDING the board and anything stacked on it. Drives the clearance ghost. 0 or omitted = unmeasured, drawn as a bare PCB.
HeightBelow, H  — anything sticking out below the board (leads, a solder-side connector). Default 0. This is what hits the mounting surface when the standoffs are too short.
[mounts] — X,​Y,​BoardHoleDia
One mounting hole per line; each becomes a standoff.
BoardHoleDia is the hole in the BOARD — the standoff's own size comes from the placement line below.
[cutouts] — holes through the floor or lid
Side,​Round,​X,​Y,​Diameter,​Clearance
Side,​Rect,​X,​Y,​SizeX,​SizeY,​CornerRadius,​Clearance
Side: top or bottom — which face of the BOARD, never the box. Which box surface gets cut is worked out from the placement.
X,Y = center of the opening (mm)
[edges] — connector holes through a SIDE WALL
Edge,​Round,​Pos,​Z,​Diameter,​Clearance
Edge,​Rect,​Pos,​Z,​Width,​Height,​CornerRadius,​Clearance
Edge: x+ x- y+ y- — which board edge the connector sits on. x+ is the edge at maximum board X, so for a board seen from the component side, x- is its left edge and y- its bottom edge.
Pos = position along that edge: board Y for x+/x-, board X for y+/y-
Z = centre height of the opening above the NON-component face, so add the board thickness (a jack 1.5 above a 1.6 board is 3.1)
Width = the opening ALONG the edge; Height = the opening vertically (mm)
Which box wall gets cut is worked out from the surface, Components and Rotation — you never name a wall.
[keepouts] — optional, for tall parts
X,​Y,​SizeX,​SizeY,​Height,​Side — X,Y = center
Clearance is added on EVERY side, so the opening grows by twice it: 10 wide with Clearance 0.4 cuts as 10.8. It changes SIZE only — CornerRadius stays exactly what you asked for, so 0 stays square.
No boards loaded. Import a .board.txt file, then place it below by name.
Board placement format
Format: Surface,​X,​Y,​Rotation,​Components,​StandoffHeight,​StandoffOD,​StandoffHoleDia,​HoleDepth,​BaseFilletRadius,​BoardName
Surface: floor or lid
X,Y = where the board's 0,0 lands on that surface (mm)
Rotation = CCW degrees, multiples of 90 only
Components: up or down — which way the component side faces (world Z)
StandoffHeight/OD/HoleDia/HoleDepth/BaseFilletRadius = the standoffs under it
BoardName = name from an imported board file
Use // for comments
Any number can be an expression: + - * / and parentheses. Names you can use, all for the surface this line names: maxX and maxY (its extent in its own frame), maxZ (the clear distance across to whatever faces it).
So maxX - 25.42 - 3.7 sits a 25.42 mm part against the far edge with a 3.7 mm gap, and maxZ - 21.2 as an Offset pushes it across to the opposite wall — and both stay right if you resize the box, which a typed-out number would not.
0 boards placed
Objects
Object file format
A plain text file, same shape as a board file. 0,0,0 is a corner of the face that sits AGAINST the mounting surface; X and Y run across that face, +Z runs away from the surface into the box. Use // for comments.
[object]
Name, MyPart  — matched to ObjectName below
Size, X, Y, Z  — X,Y across the mounting face; Z away from it (mm)
[cutouts] — holes this part needs through the enclosure
Face,​Round,​X,​Y,​Z,​Diameter,​Clearance
Face,​Rect,​X,​Y,​Z,​Width,​Height,​CornerRadius,​Clearance
Face: base (against the mounting surface), top (opposite it), or x+ x- y+ y-
X,Y,Z = centre of the hole in object coords. The axis perpendicular to the named face is ignored — write 0 or the face's own value, whichever reads better.
Width/Height run along the face's two free axes in X,Y,Z order — so base/top are (X,Y), x± are (Y,Z), y± are (X,Z)
You never name a box wall. Which surface a hole exits through is worked out from where the object is placed, so one file works on the floor, the lid or any wall.
No objects loaded. Import an object file, then place it below by name.
Object placement format
Format: Surface,​X,​Y,​Rotation,​Offset,​ObjectName
Surface: floor, lid, front, back, left or right — what it is stuck to
X,Y = where the object's 0,0 corner lands on that surface (mm)
Rotation = CCW degrees, multiples of 90 only
Offset = gap between the surface and the object (mm); 0 = touching
ObjectName = name from an imported object file
Any number can be an expression: + - * / and parentheses. Names you can use, all for the surface this line names: maxX and maxY (its extent in its own frame), maxZ (the clear distance across to whatever faces it).
So maxX - 25.42 - 3.7 sits a 25.42 mm part against the far edge with a 3.7 mm gap, and maxZ - 21.2 as an Offset pushes it across to the opposite wall — and both stay right if you resize the box, which a typed-out number would not.
0 objects placed
Standoffs
Standoffs
Standoff format
Format: Surface,​X,​Y,​OD,​Height,​HoleDia,​HoleDepth,​BaseFilletRadius
Surface: floor or lid
X,Y = center of standoff (mm) from 0,0 (see help)
OD = outside diameter of standoff (mm)
Height = height of standoff (mm)
HoleDia = hole diameter (mm)
HoleDepth = hole depth (mm)
BaseFilletRadius = fillet radius (mm)
Use // for comments
0 standoffs
Cutouts
Cutouts
Cutout format
Format Round: Surface,​Round,​X,​Y,​Diameter
Format Rect: Surface,​Rect,​X,​Y,​HoleX,​HoleY,​CornerRadius
Surface: front, back, left, right, floor, or lid
X,Y = center of cutout (mm) from 0,0 (see help)
Diameter = circle diameter (mm) (Round only)
HoleX, HoleY = rectangle width and height (mm) (Rect only)
CornerRadius = radius of Rect corners (mm; 0 = square)
Use // for comments
0 cutouts
Text Labels
Text Labels
Text label format
Format: Surface,​X,​Y,​Type,​Depth,​Height,​Direction,​Font,​Bold,​SeparateBody,​Text
Surface: front, back, left, right, floor, or lid
X,Y = center of text (mm) from 0,0 (see help)
Type: emboss (raised) or deboss (recessed)
Depth: amount of emboss or deboss (mm)
Height: font size (mm)
Direction: front, back, left, right, lid, floor
(text top points TOWARD that surface)
Font: Atkinson Hyperlegible, JetBrains Mono, Open Sans (or your custom)
Bold: yes or no (if the font supports it)
SeparateBody: yes or no (yes if you plan to print the text in a separate color via the 3MF export)
Text: anything; commas inside the text are kept
Use // for comments
0 labels
Settings
Appearance