Parameter Reference
This document is the canonical reference for every Customizer section and parameter in cable-box-parametric.scad.
Scope and Source of Truth
Section titled “Scope and Source of Truth”- Model source:
cable-box-parametric.scad - Repository:
https://github.com/prisant-labs/3d-cable-box-parametric-openscad - License:
MIT - Third-party attribution:
THIRD_PARTY_NOTICES.md
If this document and the SCAD file ever disagree, treat the SCAD file as the functional source and update this document.
Conventions
Section titled “Conventions”- Units: millimeters unless stated otherwise.
0as override value usually means “use default/global value”.- “Primary” alignment means along the arrangement axis.
- “Secondary” alignment means perpendicular to the arrangement axis.
Section Index
Section titled “Section Index”- Overall
- Box 2a. Edge Treatment
- Post
- Lid 4a. Lid Relief 4b. Lid Magnets
- Openings
- Left Openings Overrides
- Right Openings Overrides
- Back Openings Overrides
- Front Openings Overrides
- Stabilizers - Main Settings
- Stabilizers - Front/Back Walls
- Stabilizers - Left/Right Walls
- Bottom Openings - Main
- Bottom Openings - Alignment
- Bottom Openings - Custom Margins
- Slicing - For Smaller Print Beds
- Gridfinity
- Printing
- Hidden
1) Overall
Section titled “1) Overall”| Parameter | Type | Default | Allowed values | Description | Notes |
|---|---|---|---|---|---|
Part_To_Render |
enum | "Box Only" |
"Box Only", "Lid Only", "Box and Lid" |
Chooses which model body is generated. | In non-slicing mode, box and lid are separated in view for export. |
Part_To_Render options
Section titled “Part_To_Render options”| Option | Behavior |
|---|---|
"Box Only" |
Renders only the box body. |
"Lid Only" |
Renders only the lid. |
"Box and Lid" |
Renders both bodies in one scene. |
2) Box
Section titled “2) Box”| Parameter | Type | Default | Description | Practical guidance |
|---|---|---|---|---|
Box_Width |
number | 100 |
Outer box width (X axis). | Increase for longer cable bundles or power bricks. |
Box_Depth |
number | 75 |
Outer box depth (Y axis). | Increase for front/back routing space. |
Box_Height |
number | 50 |
Outer box height (Z axis). | Set high enough for cable bend radius and connectors. |
Box_Corner_Radius |
number | 8.1 |
Roundness of outer vertical edges. | Effective ceiling is (min(Box_Width, Box_Depth) - Wall_Thickness*2) / 2, set by the inner cavity rather than the outer shell. Larger values are clamped and reported via echo. |
Wall_Thickness |
number | 1.85 |
Wall thickness for shell and post walling. | Typical FDM baseline: 1.2 to 2.4 depending nozzle/material. |
2a) Edge Treatment
Section titled “2a) Edge Treatment”Horizontal edges are square by default. These soften them. Both sizes default
to 0, and at 0 the model renders exactly as it did before these existed.
| Parameter | Type | Default | Description | Practical guidance |
|---|---|---|---|---|
Bottom_Edge_Fillet |
number | 0 |
Size of the treatment on the box’s outer bottom edge, in the shape Bottom_Edge_Style picks. |
Around 1.0 softens the profile and visually absorbs elephant foot. Capped at Wall_Thickness, and ignored entirely when a Gridfinity base is active, because that profile is dimensioned by the standard. |
Bottom_Edge_Style |
enum | "Fillet" |
Shape of that bottom edge: "Fillet", "Teardrop", or "Chamfer". |
Fillet is a quarter round, and its lowest layers overhang the bed, so keep it modest. Teardrop is a one-eighth round that ends in a 45 degree chamfer, so it keeps the rounded look and prints without an overhang. Chamfer is a plain 45 degree bevel. All three are Bottom_Edge_Fillet deep and tall, and only the box’s bottom edge uses this setting. |
Top_Edge_Chamfer |
number | 0 |
Chamfer on the box’s top rim and on both exposed lid edges. | Around 0.6 takes the sharp edge off the rim you handle every time the lid comes off. Capped at Wall_Thickness, since the rim is only that wide. Ignored on the lid when a Gridfinity lid top is active. |
3) Post
Section titled “3) Post”| Parameter | Type | Default | Description | Interactions |
|---|---|---|---|---|
Enable_Post |
boolean | true |
Adds a center post for cable organization. | Affects bottom opening post-avoid behavior and lid post interface. |
Closed_Post |
boolean | false |
Makes the post floor solid instead of open through the box bottom. | When false the post is a tube open at both ends. When true the bore starts above the floor, leaving a Wall_Thickness base. |
Post_Diameter |
number | 15 |
Outer post diameter. | Also drives center clearance used by bottom post-avoid logic. |
4) Lid
Section titled “4) Lid”| Parameter | Type | Default | Description | Tuning strategy |
|---|---|---|---|---|
Lid_Style |
enum | "Plug" |
"Plug" drops a ring just inside the box wall; "Skirt" wraps a wall around the outside of the box. |
Plug keeps the lid’s overhang as a finger grip, is notched around magnet bosses, and asserts if stabilizer fins or the post would reach it. Skirt touches nothing inside the box. |
Lid_Height |
number | 8.1 |
Height of lid wall above top plane. | Increase for stronger lid walls and clip volume in sliced mode. |
Lid_Lip_Gap |
number | 0.15 |
Clearance on each side between the lip and the box wall it fits against. Also opens the lid’s post socket by the same amount. | Tight fit: reduce by 0.05; loose fit: increase by 0.05. The default fitted well with both lid styles on a Bambu Lab P1S printing PLA+. |
Lid_Lip_Gap_Height |
number | 3 |
How far the lip, skirt or plug, reaches past the rim into the box. | Taller lip improves hold; too tall may increase insertion force. With a Plug, stabilizer fins must stop this far below the rim. |
The lid’s footprint is Box_Width + 2*(Wall_Thickness + Lid_Lip_Gap) by
Box_Depth + 2*(Wall_Thickness + Lid_Lip_Gap) for both styles, which is
exactly a skirt’s outside. A lip covers the top Lid_Lip_Gap_Height of any
side opening that runs to the rim.
4a) Lid Relief
Section titled “4a) Lid Relief”A friction-fit lid has nothing to grip. These give the lid somewhere to be held.
| Parameter | Type | Default | Description | Practical guidance |
|---|---|---|---|---|
Lid_Relief_Style |
string | "None" |
None, Scallop or Tab. |
Scallop is a concave groove in the lid’s outer face: tidier, and it does not change the envelope. Tab is a protruding grip: more effective, and it widens the lid by Lid_Relief_Depth on each enabled side. |
Lid_Relief_Width |
number | 20 |
Length of the relief along the wall. | Must stay clear of the rounded corners; the model asserts if it does not. |
Lid_Relief_Depth |
number | 2.5 |
How far a scallop cuts in, or a tab stands out. | A scallop is a half cylinder, so this is both its depth and its half width; it must be under half of Lid_Height. |
Lid_Relief_On_Left |
boolean | true |
Relief on the left wall. | Inert while Lid_Relief_Style is None. |
Lid_Relief_On_Right |
boolean | true |
Relief on the right wall. | Mirrors the Opening_On_* convention. |
Lid_Relief_On_Front |
boolean | false |
Relief on the front wall. | |
Lid_Relief_On_Back |
boolean | false |
Relief on the back wall. |
A side is skipped automatically when an opening on that wall reaches the box
rim. The relief is in the lid and openings are in the box, so they normally
cannot meet; a full-height opening is the exception, and a tab standing over a
hole grips nothing. The rim check uses the opening’s real top edge, so it
counts that wall’s Move_Opening_*_Up as well as All_Openings_Up.
Lid_Relief_Width is checked against each enabled wall’s own length:
Box_Width for Front and Back, Box_Depth for Left and Right.
4b) Lid Magnets
Section titled “4b) Lid Magnets”| Parameter | Type | Default | Description | Practical guidance |
|---|---|---|---|---|
Enable_Lid_Magnets |
boolean | false |
Mating magnet pockets in the box and lid. | Held in bosses at the four inside corners, because the rim is only Wall_Thickness wide and a 6 mm magnet does not fit in it. Corners are also free of openings, stabilizers, the post and slice seams. |
Lid_Magnet_Diameter |
number | 6.2 |
Pocket diameter. | Takes a nominal 6 mm magnet. Magnet diameters vary by supplier; increase if a press fit cracks the boss. |
Lid_Magnet_Depth |
number | 2.4 |
Pocket depth in each half. | Each pocket takes its own magnet: one magnet per pocket, up to 2.4 mm thick at the default. The lid keeps material above its pocket, so the magnet is captured rather than visible. |
Lid_Magnet_Wall |
number | 1.2 |
Material around each pocket. | Also sets the boss diameter, which is Lid_Magnet_Diameter + 2 * Lid_Magnet_Wall. |
Insert the magnets with opposing poles facing. The geometry is symmetric in both axes so the pockets align however the lid is flipped onto the box, which also means it cannot enforce polarity for you.
Bosses run the full box height rather than hanging from the rim, so they print off the bed with no overhang and stiffen the corner.
5) Openings
Section titled “5) Openings”| Parameter | Type | Default | Description | Interactions |
|---|---|---|---|---|
All_Opening_Width |
number | 10 |
Default opening width on enabled side walls. | Used unless side-specific width override is greater than 0. |
All_Opening_Height |
number | 30 |
Default opening height on enabled side walls. | Must be > 0, and <= Box_Height while any side opening is on. This is the true opening height; the cut is anchored at its bottom edge, not centered on the box floor. |
All_Opening_Corner_Radius |
number | -1 |
Default corner radius for side openings. | -1 keeps fully rounded ends; 0 is square; positive values are clamped to valid half-extents. |
All_Opening_Top_Style |
enum | "Round" |
Shape of each side opening’s top: "Round" or "Teardrop". |
Round arcs flatten near the top, and that part prints as an overhang. Teardrop turns each rounded top corner into a 45 degree flank with a short flat cap, so the top prints without support. The opening keeps its typed width and height. The cap is about 0.41 times the width for fully rounded ends. A square opening is unchanged. Applies to all four walls. |
All_Openings_Right |
number | 0 |
Global side-opening offset along each wall’s local left/right direction. | Combines with each side-local Move_Opening_*_to_Right parameter. |
All_Openings_Up |
number | 5 |
Height of each side opening’s bottom edge above the box floor. | 0 sits the opening flush with the box bottom, so a cable resting on the desk passes straight in. Raise it to lift openings off the surface. Combines with side-specific vertical offsets. An opening lifted past the rim is cut open as a notch, and the model reports it with an echo. |
Opening_On_Right |
boolean | true |
Enables right wall opening. | Uses global size unless right override is set. |
Opening_On_Left |
boolean | true |
Enables left wall opening. | Uses global size unless left override is set. |
Opening_On_Front |
boolean | true |
Enables front wall opening. | Uses global size unless front override is set. |
Opening_On_Back |
boolean | true |
Enables back wall opening. | Uses global size unless back override is set. |
6) Left Openings Overrides
Section titled “6) Left Openings Overrides”| Parameter | Type | Default | Description |
|---|---|---|---|
Override_Opening_Width_Left |
number | 0 |
Left opening width override; 0 keeps global width. |
Override_Opening_Height_Left |
number | 0 |
Left opening height override; 0 keeps global height. |
Override_Opening_Corner_Radius_Left |
number | -1 |
Left opening corner radius override; -1 keeps global corner radius. |
Move_Opening_Left_to_Right |
number | 0 |
Left wall opening depth shift; positive moves toward front (-Y). |
Move_Opening_Left_Up |
number | 0 |
Left opening vertical offset. |
7) Right Openings Overrides
Section titled “7) Right Openings Overrides”| Parameter | Type | Default | Description |
|---|---|---|---|
Override_Opening_Width_Right |
number | 0 |
Right opening width override; 0 keeps global width. |
Override_Opening_Height_Right |
number | 0 |
Right opening height override; 0 keeps global height. |
Override_Opening_Corner_Radius_Right |
number | -1 |
Right opening corner radius override; -1 keeps global corner radius. |
Move_Opening_Right_to_Right |
number | 0 |
Right wall opening depth shift; positive moves toward back (+Y). |
Move_Opening_Right_Up |
number | 0 |
Right opening vertical offset. |
8) Back Openings Overrides
Section titled “8) Back Openings Overrides”| Parameter | Type | Default | Description |
|---|---|---|---|
Override_Opening_Width_Back |
number | 0 |
Back opening width override; 0 keeps global width. |
Override_Opening_Height_Back |
number | 0 |
Back opening height override; 0 keeps global height. |
Override_Opening_Corner_Radius_Back |
number | -1 |
Back opening corner radius override; -1 keeps global corner radius. |
Move_Opening_Back_to_Right |
number | 0 |
Back wall opening lateral shift; positive moves toward left (-X). |
Move_Opening_Back_Up |
number | 0 |
Back opening vertical offset. |
9) Front Openings Overrides
Section titled “9) Front Openings Overrides”| Parameter | Type | Default | Description |
|---|---|---|---|
Override_Opening_Width_Front |
number | 0 |
Front opening width override; 0 keeps global width. |
Override_Opening_Height_Front |
number | 0 |
Front opening height override; 0 keeps global height. |
Override_Opening_Corner_Radius_Front |
number | -1 |
Front opening corner radius override; -1 keeps global corner radius. |
Move_Opening_Front_to_Right |
number | 0 |
Front wall opening lateral shift; positive moves toward right (+X). |
Move_Opening_Front_Up |
number | 0 |
Front opening vertical offset. |
10) Stabilizers - Main Settings
Section titled “10) Stabilizers - Main Settings”| Parameter | Type | Default | Description | Interactions |
|---|---|---|---|---|
Enable_Stabilizers |
boolean | true |
Enables interior support fins. | If false, all stabilizer parameters are ignored. |
Stabilizer_Width |
number | 1.5 |
Fin thickness along wall direction. | Increasing count and width together can reduce usable interior area. |
Stabilizer_Depth |
number | 15 |
Fin extension from wall into interior. | Larger values add stiffness but can obstruct cable routing. |
Stabilizer_Height |
number | 35 |
Fin height from floor upward. | Keep below full box height if upper interior clearance is needed. With the default Plug lid, fins must stop Lid_Lip_Gap_Height below the rim. |
11) Stabilizers - Front/Back Walls
Section titled “11) Stabilizers - Front/Back Walls”| Parameter | Type | Default | Allowed values | Description |
|---|---|---|---|---|
Stabilizers_Front_Back_Count |
integer | 3 |
0+ |
Number of fins on each of front and back walls. |
Stabilizers_Front_Back_Alignment |
enum | "Centered" |
"Centered", "Distributed", "Custom" |
Placement strategy for front/back fins. |
Stabilizer_FB_Spacing |
number | 3 |
>= 0 |
Gap between adjacent front/back fins in Centered and Custom modes. |
Stabilizer_FB_Margin_Left |
number | 15 |
any | Left margin used in Distributed and Custom. |
Stabilizer_FB_Margin_Right |
number | 15 |
any | Right margin used in Distributed and Custom. |
Stabilizer_Avoid_Front_Opening |
boolean | true |
true/false | Skips front-wall fin positions that overlap opening area. |
Stabilizer_Avoid_Back_Opening |
boolean | true |
true/false | Skips back-wall fin positions that overlap opening area. |
Stabilizers_Front_Back_Alignment options
Section titled “Stabilizers_Front_Back_Alignment options”| Option | Behavior |
|---|---|
"Centered" |
Builds a centered fin cluster using Stabilizer_FB_Spacing. |
"Distributed" |
Distributes fins between left/right margins. |
"Custom" |
Starts from the custom start margin and uses fixed pitch (Stabilizer_Width + Stabilizer_FB_Spacing) when it fits; otherwise falls back to distributed placement inside margins. |
12) Stabilizers - Left/Right Walls
Section titled “12) Stabilizers - Left/Right Walls”| Parameter | Type | Default | Allowed values | Description |
|---|---|---|---|---|
Stabilizers_Left_Right_Count |
integer | 0 |
0+ |
Number of fins on each of left and right walls. |
Stabilizers_Left_Right_Alignment |
enum | "Centered" |
"Centered", "Distributed", "Custom" |
Placement strategy for left/right fins. |
Stabilizer_LR_Spacing |
number | 3 |
>= 0 |
Gap between adjacent left/right fins in Centered and Custom modes. |
Stabilizer_LR_Margin_Front |
number | 15 |
any | Front margin used in Distributed and Custom. |
Stabilizer_LR_Margin_Back |
number | 15 |
any | Back margin used in Distributed and Custom. |
Stabilizer_Avoid_Left_Opening |
boolean | true |
true/false | Skips left-wall fin positions that overlap opening area. |
Stabilizer_Avoid_Right_Opening |
boolean | true |
true/false | Skips right-wall fin positions that overlap opening area. |
Stabilizers_Left_Right_Alignment options
Section titled “Stabilizers_Left_Right_Alignment options”| Option | Behavior |
|---|---|
"Centered" |
Builds a centered fin cluster using Stabilizer_LR_Spacing. |
"Distributed" |
Distributes fins between front/back margins. |
"Custom" |
Starts from the custom start margin and uses fixed pitch (Stabilizer_Width + Stabilizer_LR_Spacing) when it fits; otherwise falls back to distributed placement inside margins. |
13) Bottom Openings - Main
Section titled “13) Bottom Openings - Main”| Parameter | Type | Default | Allowed values | Description | Interactions |
|---|---|---|---|---|---|
Enable_Bottom_Openings |
boolean | false |
true/false | Enables floor cutouts in the box bottom. | If false, all bottom opening params are ignored. |
Bottom_Openings_Count |
integer | 3 |
1+ recommended |
Number of floor openings. | With post avoid enabled, count is split across both sides of post. |
Bottom_Opening_Axis |
enum | "Along X" |
"Along X", "Along Y" |
Axis used to arrange opening sequence. | Defines which margins are primary vs secondary. |
Bottom_Opening_Width |
number | 15 |
any positive | Short dimension of each opening. | Combined with orientation to derive actual X/Y footprint. |
Bottom_Opening_Depth |
number | 30 |
any positive | Long dimension of each opening. | Combined with orientation to derive actual X/Y footprint. |
Bottom_Opening_Orientation |
enum | "Along Y" |
"Along X", "Along Y" |
Rotates opening shape independent of arrangement axis. | Allows slot rotation without changing arrangement direction. |
Bottom_Opening_Corner_Radius |
number | 5 |
>= 0 |
Rounding radius for opening corners. | Effective radius is clamped to opening half-extents. |
Bottom_Opening_Spacing |
number | 0 |
0+ |
Gap between neighboring openings. | 0 enables auto-spacing from alignment mode. |
Bottom_Opening_Axis options
Section titled “Bottom_Opening_Axis options”| Option | Behavior |
|---|---|
"Along X" |
Places multiple openings across box width. |
"Along Y" |
Places multiple openings across box depth. |
Bottom_Opening_Orientation options
Section titled “Bottom_Opening_Orientation options”| Option | Behavior |
|---|---|
"Along X" |
Rotates each opening so long axis points along X. |
"Along Y" |
Rotates each opening so long axis points along Y. |
14) Bottom Openings - Alignment
Section titled “14) Bottom Openings - Alignment”| Parameter | Type | Default | Allowed values | Description |
|---|---|---|---|---|
Bottom_Opening_Alignment_Primary |
enum | "Centered" |
"Centered", "Distributed", "Start", "End", "Custom" |
Placement mode on arrangement axis. |
Bottom_Opening_Alignment_Secondary |
enum | "Centered" |
"Centered", "Start", "End", "Custom" |
Placement mode on perpendicular axis. |
Bottom_Opening_Avoid_Post |
boolean | true |
true/false | Splits and offsets openings around post when Enable_Post=true. |
Bottom_Opening_Post_Margin |
number | 2 |
>= 0 |
Minimum gap from post outer wall to nearest opening edge when post avoidance is enabled. |
Bottom_Opening_Alignment_Primary options
Section titled “Bottom_Opening_Alignment_Primary options”| Option | Behavior |
|---|---|
"Centered" |
Centers total opening pattern in available area. |
"Distributed" |
Evenly distributes openings between computed bounds. |
"Start" |
Anchors pattern to start bound (left/front depending axis). |
"End" |
Anchors pattern to end bound (right/back depending axis). |
"Custom" |
Uses custom margins as explicit primary bounds. |
Bottom_Opening_Alignment_Secondary options
Section titled “Bottom_Opening_Alignment_Secondary options”| Option | Behavior |
|---|---|
"Centered" |
Centers openings on perpendicular axis. |
"Start" |
Anchors openings to start side using relevant margin. |
"End" |
Anchors openings to end side using relevant margin. |
"Custom" |
Centers the opening line within the custom margin window (left/right or front/back based on axis). |
15) Bottom Openings - Custom Margins
Section titled “15) Bottom Openings - Custom Margins”| Parameter | Type | Default | Description | Used by |
|---|---|---|---|---|
Bottom_Opening_Margin_Left |
number | 10 |
Distance from inner left wall. | Along X primary (Start/Custom), Along Y secondary (Start and Custom window). |
Bottom_Opening_Margin_Right |
number | 10 |
Distance from inner right wall. | Along X primary (End/Custom), Along Y secondary (End and Custom window). |
Bottom_Opening_Margin_Front |
number | 10 |
Distance from inner front wall. | Along Y primary (Start/Custom), Along X secondary (Start and Custom window). |
Bottom_Opening_Margin_Back |
number | 10 |
Distance from inner back wall. | Along Y primary (End/Custom), Along X secondary (End and Custom window). |
16) Slicing - For Smaller Print Beds
Section titled “16) Slicing - For Smaller Print Beds”| Parameter | Type | Default | Description | Constraints and notes |
|---|---|---|---|---|
Enable_Slicing |
boolean | false |
Enables split-part generation with mating clips. | Recommended when full width exceeds printable bed area. |
Slice_Count |
integer | 2 |
Number of slices across width. | Must be >= 2 for meaningful slicing. |
Slice_Piece_To_Render |
integer | 0 |
0 previews all pieces; non-zero renders one specific slice index. |
Must be an integer in range 0..Slice_Count. |
Clip_Tolerance |
number | 0.2 |
Clearance added to female clip geometry. | Increase if clips are too tight. |
Clips_Per_Edge |
integer | 2 |
Number of clips along each split edge. | Higher values improve alignment but add assembly friction. |
Clip_Tab_Width |
number | 10 |
Clip extent along split edge. | Increase for strength; reduce if edge space is limited. |
Clip_Tab_Depth |
number | 4 |
Clip insertion depth. | Deeper clips improve retention but may over-constrain fit. |
Clip_Tab_Height |
number | 3 |
Clip tab height. | Larger values increase engagement force. Floor clips start at the floor’s bottom face, so anything above Wall_Thickness rises inside the box rather than hanging below the piece. |
Slice_Preview_Spacing |
number | 5 |
Gap between pieces in all-slices preview. | Visual layout only; does not affect exported single-part geometry. Snap clips add their travel on top, so pieces never touch in the preview. |
Clip_Style |
enum | "Tab" |
"Tab" is the original friction fit; "Snap" is a BOSL2 cantilever snap clip. |
See the snap clip section below. |
Seam_Tooth_Depth |
number | 3 |
Depth of the 45 degree sawtooth cut through the walls at each seam. The teeth stop joined pieces sliding vertically. 0 gives a flat seam. |
Must be >= 0, and less than half a slice width minus Clip_Tolerance. See the seam teeth section below. |
Seam teeth (Seam_Tooth_Depth)
Section titled “Seam teeth (Seam_Tooth_Depth)”Above the floor, each seam zigzags at 45 degrees through the walls, the post, and any fin it crosses. The teeth have no undercut, so the pieces still push together along X, the way the floor clips go in. Once joined, the teeth stop the pieces sliding vertically, and the floor clips stop them sliding along the seam. Pulling the pieces apart is resisted only by a Snap clip or by glue.
- The tooth period is twice the depth: 6 mm at the default 3 mm.
- The two pieces’ profiles sit
Clip_Toleranceapart, measured along X. That gap is also the most a joined pair can move vertically. - Through the floor the seam stays flat, so the floor clips keep their positions. A Gridfinity base is also cut flat.
- Where a front or back opening crosses a seam, the teeth stop at the opening’s height range, because teeth there would leave slivers against its rounded edges. On the default box the seam crosses both openings, so the teeth run 15 mm above them and about 3 mm below.
- On the lid, teeth run through the slab below the band the lid’s seam clips occupy. A front or back lid relief on the seam keeps the lid’s seam flat.
- Every tooth face is at most 45 degrees from vertical, so the pieces print without supports.
Slice rendering behavior
Section titled “Slice rendering behavior”Slice_Piece_To_Render value |
Result |
|---|---|
0 |
Renders all slices in a preview layout. |
1..Slice_Count |
Renders only the selected slice index (box and/or lid based on Part_To_Render). |
Snap clips (Clip_Style = "Snap")
Section titled “Snap clips (Clip_Style = "Snap")”The original "Tab" clip is a rectangle in a slightly larger rectangular hole,
held by friction. Clip_Tolerance is its only tuning knob and it trades “will
not go in” against “falls apart” with nothing in between.
"Snap" uses a real cantilever clip with an engagement bump. The arm flexes, so
it absorbs print inaccuracy instead of jamming, and the bump resists pull-out
rather than relying on interference.
| Parameter | Type | Default | Description |
|---|---|---|---|
Clip_Snap_Length |
number | 8 |
How far the clip travels into its socket. Must exceed Clip_Tab_Width / 2; below that the arm has no room to flex and the geometry cannot be built. |
Clip_Snap |
number | 0.4 |
Depth of the engagement bump. Larger holds harder and is harder to separate. |
Clip_Arm_Thickness |
number | 1.0 |
Arm thickness, which sets stiffness. Too thin snaps off; too thick will not flex. |
Clip_Compression |
number | 0.1 |
Extra width on the ears for a tighter fit. |
Clip_Lock |
boolean | false |
Makes the joint effectively permanent once assembled. |
Under "Snap", Clip_Tab_Width becomes the clip’s base width, Clip_Tab_Height
its extrusion depth, and Clip_Tolerance the clearance added to the socket.
Clip_Tab_Depth is not used; snap clips need their own travel, which is what
Clip_Snap_Length provides.
The default is deliberately still "Tab". Clip geometry is the one part of this
model whose correctness cannot be established by rendering it: manifoldness,
solid counts, and probes all pass for a joint far too tight to assemble or too
loose to hold. "Snap" becomes the default once a print says it should.
17) Gridfinity
Section titled “17) Gridfinity”Two independent, optional interfaces that let the box join a Gridfinity setup. Both default to off and change no geometry when disabled.
| Parameter | Type | Default | Description | Interactions |
|---|---|---|---|---|
Enable_Gridfinity_Bottom |
boolean | false |
Adds solid Gridfinity feet under the box, built to the spec’s profile, so it drops into a 42 mm baseplate. | Rounds the footprint up to whole cells (see below), and the lid grows with it. Mutually exclusive with Enable_Bottom_Openings. Requires Closed_Post=true when the post is enabled. Adds 4.75 mm to total height. |
Enable_Gridfinity_Lid_Top |
boolean | false |
Adds a Gridfinity baseplate to the lid’s exposed face: a plate with pockets cut to the spec profile, so bins or another box sit on the closed box. | Adds 5.0 mm to lid height, and the lid is exported turned over so the pockets print facing up. The plug or skirt is then filled solid. |
Gridfinity_Profile_Clearance |
number | 0.25 |
Fit clearance on the lid-top pockets, and on every magnet pocket and screw hole. | Measured against the 0.25 mm the standard already builds into the gap between a 41.5 mm foot and a 42 mm pocket, so the default reproduces the standard exactly. Raise it if bins are tight in the lid; the feet are unaffected, because they must stay at spec to fit anyone else’s baseplate. |
Gridfinity_Edge_Keepout |
number | 4 |
Margin from the lid edge before the first lid-top cell, used only when the base is off. | Prevents thin, fragile cells at the lid’s perimeter. With Enable_Gridfinity_Bottom on, the lid instead takes the base’s own cell count so a second box stacks on the first, and the keepout is ignored. The base has ignored it since 2.0.0-rc.6, because its feet fill the rounded footprint. |
Enable_Gridfinity_Magnet_Screw |
boolean | false |
Adds magnet pockets to whichever interfaces are enabled; the bottom base also gets screw holes. The lid gets pockets only, because a through screw hole would breach the closed box. Lid pockets open at each cell’s floor. | Both open onto the bed in their print orientations, so magnets go in after printing and neither needs a bridge. |
Gridfinity_Magnet_Diameter |
number | 6.25 |
Magnet diameter the pockets are cut for. | Each pocket adds Gridfinity_Profile_Clearance, so the default gives the spec’s 6.5 mm pocket for a 6 mm magnet. |
Gridfinity_Magnet_Depth |
number | 2.4 |
Magnet pocket depth. | In a foot, two bridging layers, each Print_Layer_Height tall, sit above the pocket, so the depth can be at most 4.75 - 2 * Print_Layer_Height: 4.35 mm at the default. In the lid, capped so 0.8 mm of material always remains above the pocket. |
Gridfinity_Screw_Diameter |
number | 3.2 |
Through screw hole diameter. | Sized for M3, and adds Gridfinity_Profile_Clearance. In a foot it runs up to the box’s underside, and the floor above stays closed. |
How the base is laid out
Section titled “How the base is laid out”With Enable_Gridfinity_Bottom on, the footprint rounds up to whole cells.
Box_Width and Box_Depth each become the smallest (N - 1) * 42 + 41.5 mm
that is at least the typed value, which is the outside of N spec feet. The
model echoes the size it built when that differs from what you typed:
ECHO: "Gridfinity base: box footprint rounded up to 125.5 x 83.5 mm (3 x 2 cells) from Box_Width x Box_Depth = 100 x 75"The default 100 x 75 footprint therefore becomes 125.5 x 83.5, a 3 x 2
grid. Rounding up costs no baseplate area. A box wider than its feet would
overhang them, and on a baseplate that overhang blocks the neighbouring cells
anyway.
Every foot is solid. Where the box corner is rounder than a foot’s 3.75 mm
corner, as at the default Box_Corner_Radius of 8.1, the four corner feet are
trimmed to the box’s outline. They are then smaller than a spec foot, which a
baseplate still accepts.
The lid top follows the base when the base is on. It holds exactly the base’s
cells, so one box stacks on another. The lid is the rounded box plus a wall and
a gap on each side, N * 42 + 3.5 mm, which leaves 1.75 mm beside the
outermost pockets; the default 4 mm keepout would drop a whole column, so it
does not apply. With only the lid top on there is no base to match, and the
older layout stands: as many whole cells as fit inside the lid less
Gridfinity_Edge_Keepout on each side, centred.
Because that margin is narrow, a lid rounder than about Box_Corner_Radius = 10
lets each corner pocket reach through the side of the lid. The model reports it
and carries on; see
Clamped Values Rather Than Assertions.
The lid prints turned over
Section titled “The lid prints turned over”With Enable_Gridfinity_Lid_Top on, the exported lid is rotated 180 degrees
about X, so its pockets face up and print with nothing bridging over them. The
face that then lands on the bed is the lip’s, so the plug ring is filled solid;
a Skirt lid’s pocket is filled too and keeps only a groove for the box wall.
A plug that is solid in the model prints as infill, so it costs little filament.
Three things follow from the flip. The lid-face anchor moves to the top of
the part, because it names the exposed face rather than a coordinate. The seam
clips on a sliced lid move to the lip’s face so they start on the build plate.
And the part is mirrored in Y relative to the modelled lid, which is simply
what turning a part over does.
Height convention
Section titled “Height convention”The base is added below the box, not carved out of the floor. Box_Height
continues to describe the box body, so enabling Gridfinity never silently
reduces interior volume; it increases total height instead. The model is lifted
so the exported object still sits on z=0.
Why Closed_Post is required
Section titled “Why Closed_Post is required”With an open post, the bore runs through the box floor. A Gridfinity base under
that floor would block it, leaving a bore that goes nowhere. Rather than
silently produce that, the model asserts. Set Closed_Post=true, or disable the
post.
18) Printing
Section titled “18) Printing”| Parameter | Type | Default | Description | Interactions |
|---|---|---|---|---|
Print_Layer_Height |
number | 0.2 |
The layer height you slice at. | Today only the two bridging steps above each Gridfinity foot’s magnet pocket read it. Each step is one layer tall. A slicer samples each layer near its middle height, so a step shorter than your real layers can fall between samples and vanish, and the pocket’s ceiling then sags. Set it to your layer height. Checked only when Enable_Gridfinity_Bottom and Enable_Gridfinity_Magnet_Screw are both on: it must be above 0 and at most 0.6 mm. |
19) Hidden
Section titled “19) Hidden”| Parameter | Type | Default | Description |
|---|---|---|---|
Model_Version |
string | current release | Echoed at render so an exported STL can be traced back to its source. |
Render_On_Include |
boolean | true |
Set false to use the file as a library: modules and anchors become available without geometry appearing. See the attachment interface in the module reference. |
$fn |
integer | 40 |
Circle/arc resolution for cylinders and rounded geometry. |
GF_* |
various | Gridfinity spec | Gridfinity standard dimensions (pitch, the foot’s and the pocket’s footprints and profiles, the plate height, hole offsets). Hidden because changing one produces a part that no longer mates with other Gridfinity gear, but still overridable with -D if you need to. |
SPACER |
number | 0.04 |
Internal modeling offset used for robust boolean operations and tiny clearances. |
Built-In Validation
Section titled “Built-In Validation”The model enforces these assertions. The Validation rules page explains each one and how to resolve it.
Box and wall:
Box_Width,Box_Depth, andBox_Heightmust be> 0.Wall_Thicknessmust be> 0andWall_Thickness*2must be less thanmin(Box_Width, Box_Depth).Box_Corner_Radiusmust be>= 0.- With
Bottom_Edge_Filletabove0,Bottom_Edge_Stylemust beFillet,Teardrop, orChamfer.
Post:
Post_Diametermust exceedWall_Thickness*2so the post has a wall.Post_Diametermust be less thanmin(Inner_Width, Inner_Depth).
Lid:
Lid_Stylemust beSkirtorPlug.- With
Lid_Style=Plug, the interior must hold twoWall_Thicknessring walls plusLid_Lip_Gapon each side. - With
Lid_Style=Plugand stabilizers on,Stabilizer_Height + Wall_Thicknessmust not exceedBox_Height - Lid_Lip_Gap_Height. - With
Lid_Style=Plugand the post on,Post_Diameter/2 + Lid_Lip_Gapmust not reach the plug ring’s inside face.
Stabilizers:
Stabilizer_Height + Wall_Thicknessmust not exceedBox_Height.Stabilizer_Depth*2must be less thanmin(Inner_Width, Inner_Depth).Stabilizer_Widthmust be> 0.- Stabilizer counts must be
>= 0. Stabilizer_FB_SpacingandStabilizer_LR_Spacingmust be>= 0.
Openings:
All_Opening_HeightandAll_Opening_Widthmust both be> 0.All_Opening_Heightmust not exceedBox_Height.- Side opening width/height overrides must be
>= 0. - Opening corner radius defaults/overrides must be
>= -1. - While any side opening is on,
All_Opening_Top_Stylemust beRoundorTeardrop.
Bottom openings:
Bottom_Openings_Countmust be>= 1when bottom openings are enabled.Bottom_Opening_WidthandBottom_Opening_Depthmust be> 0when enabled.Bottom_Opening_Post_Marginmust be>= 0.
Slicing and clips:
Slice_Piece_To_Rendermust be an integer in range0..Slice_Count.- When slicing is enabled,
Slice_Countmust be>= 2. - When slicing is enabled,
Clips_Per_Edgemust be>= 1. Clip_Tolerancemust be>= 0.Clip_Tab_Width,Clip_Tab_Depth, andClip_Tab_Heightmust be greater than0.- When slicing is enabled,
Seam_Tooth_Depthmust be>= 0, andSeam_Tooth_Depth + Clip_Tolerancemust be less than half a slice width. - When slicing is enabled, the lid must offer
Clip_Tab_Heightplus 0.04 mm of material for its seam clips to sit in. That isLid_Heighton a plain lid, andLid_Height + Lid_Lip_Gap_Heightwith the lid-top Gridfinity interface active, because the lid then prints turned over with its lip band filled.
Gridfinity:
Enable_Gridfinity_Bottomcannot be combined withEnable_Bottom_Openings, and it requiresClosed_Post=truewhen the post is on.- With the base and magnets on,
Print_Layer_Heightmust be above0and at most0.6 mm. - With the base and magnets on,
Gridfinity_Magnet_Depthmust be> 0and at most4.75 - 2 * Print_Layer_Height(4.35 mmat the default), so the pocket and its two bridging layers fit inside a foot.
Clamped Rather Than Asserted
Section titled “Clamped Rather Than Asserted”Box_Corner_Radius is clamped instead of rejected, because a too-large radius
has an obvious correct interpretation (round the corners as much as the geometry
allows). When clamping occurs the model emits an echo naming the requested and
the applied value, so the difference is visible in the OpenSCAD console.
The footprint under a Gridfinity base is rounded up the same way, with an
echo naming the typed and the built size. See “How the base is laid out”
above.
Recommended Baseline Profiles
Section titled “Recommended Baseline Profiles”General-purpose desktop cable box
Section titled “General-purpose desktop cable box”Box_Width=120Box_Depth=80Box_Height=55Wall_Thickness=1.8Lid_Lip_Gap=0.15Enable_Post=true
Power-brick-heavy setup
Section titled “Power-brick-heavy setup”Box_Width=160Box_Depth=100Box_Height=60All_Opening_Width=14All_Opening_Height=36Enable_Stabilizers=trueStabilizers_Front_Back_Count=4
Small print bed fallback
Section titled “Small print bed fallback”Enable_Slicing=trueSlice_Count=3Slice_Piece_To_Render=1(export each slice individually)Clip_Tolerance=0.25(start conservative, tune after test print)
Documentation Maintenance Rules
Section titled “Documentation Maintenance Rules”When parameters are added, removed, renamed, or default values change:
- Update this file in the same commit as SCAD changes.
- Update
docs/FAQ.mdif behavior impact is likely user-visible. - Update
README.mdif workflow or folder structure changes.