Skip to content

cap_box.scad

Jump to bottom
pinkfish edited this page Jun 26, 2026 · 25 revisions

LibFile: cap_box.scad

This file has all the modules needed to generate a cap box.

To use, add the following lines to the beginning of your file:

include <boardgame_toolkit.scad>

File Contents

  1. Section: CapLid

Section: CapLid

Function: CapBoxDefaultCapHeight()

Description:

Works out the default value for the cap box height.

Arguments:

By Position What it does
height the height of the box.

Function: CapBoxDefaultFingerHoldHeight()

Description:

Works out the default value for the cap box finger hold height.

Arguments:

By Position What it does
height the height of the box.

Function: CapBoxDefaultFingerHoldLen()

Description:

Works out the default value for the cap box finger hold length.

Arguments:

By Position What it does
height the height of the box.

Function: CapBoxDefaultLidWallThickness()

Description:

Works out the default value for the cap box wall thickness.

Arguments:

By Position What it does
wall_thickness the wall thickness of the box.

Module: MakeBoxWithCapLid()

Topics: CapLid

Usage: MakeBoxWithCapLid([100, 50, 20]);

Description:

Makes a box with a cap lid. Inside the children of the box you can use the $inner_height , $inner_width, $inner_length = length variables to deal with the box sizes.

Arguments:

By Position What it does
size [width, length, height] outside size of the box
cap_height height of the cap on the box (default 10)
lid_thickness thickness of the lid (default default_lid_thickness)
wall_thickness thickness of the walls (default default_wall_thickness)
floor_thickness thickness of the floor (default default_floor_thickness)
lid_finger_hold_len length of the finger hold sections to cut out (default min(width,lenght)/5)
finger_hold_height how heigh the finger hold bit it is (default 5)
material_colour the colour of the material in the box (default default_material_colour)
positive_only_children the list of children to be positive only
positive_negative_children the list of children to be positive and negative
positive_colour colour of the postive pieces default_positive_colour
lid_catch CATCH_NONE - no catch, CATCH_SHORT - short catch, CATCH_LONG - long catch (default
{{CATCH_LONG})
size_spacing amount of wiggle room between pieces (default m_piece_wiggle_room)
top_rounding rounding on the top edges of the box (default {{wall_thickness / 4}})
bottom_rounding rounding on the bottom edges of the box (default {{wall_thickness / 2}})

Example 1:

MakeBoxWithCapLid() Example 1 
include <boardgame_toolkit.scad>
MakeBoxWithCapLid([100, 50, 20]);



Example 2:

MakeBoxWithCapLid() Example 2 
include <boardgame_toolkit.scad>
MakeBoxWithCapLid([50, 50, 20], lid_finger_hold_len = 4);



Example 3:

MakeBoxWithCapLid() Example 3 
include <boardgame_toolkit.scad>
MakeBoxWithCapLid([50, 50, 10], cap_height = 2, finger_hold_height = 1);

Example 4:

MakeBoxWithCapLid() Example 4 
include <boardgame_toolkit.scad>
MakeBoxWithCapLid([30, 30, 15], cap_height = 2, finger_hold_height = 1, corner_rounding=1, top_rounding=2, bottom_rounding=3);

Module: CapBoxLid()

Topics: CapBox

Usage: CapBoxLid([100, 50, 20]);

Description:

Lid for a cap box, small cap to go on the box with finger cutouts.

Arguments:

By Position What it does
size [width, length, height] outside size of the box
cap_height height of the cap on the box (default 10)
lid_thickness thickness of the lid (default default_lid_thickness)
wall_thickness thickness of the walls (default default_wall_thickness)
lid_inner_rounding how much to round the inside of the box (default calc_lid_wall_thickness/2)
material_colour the colour of the material in the box (default default_material_colour)
lid_catch the type of catch to use, use CATCH_BUMPS_LONG for a bumps catch and CATCH_SHORT
for a wedge catch. Default [default\_lid\_catch\_type](lids_base.scad#constant-default_lid_catch_type)
size_spacing amount of wiggle room between pieces (default m_piece_wiggle_room)
lid_rounding how much to round the edge of the lid

Example 1:

CapBoxLid() Example 1 
include <boardgame_toolkit.scad>
CapBoxLid([100, 50, 30]);



Example 2:

CapBoxLid() Example 2 
include <boardgame_toolkit.scad>
CapBoxLid([100, 50, 10]);



Example 3:

CapBoxLid() Example 3 
include <boardgame_toolkit.scad>
CapBoxLid([100, 50, 10], cap_height = 3);



Example 4:

CapBoxLid() Example 4 
include <boardgame_toolkit.scad>
CapBoxLid([100, 50, 10], cap_height = 3, lid_catch  = CATCH_BUMPS_LONG);

Module: CapBoxLidWithCustomShape()

Topics: CapBox

Usage: CapBoxLidWithCustomShape([100, 50, 20]);

Description:

Lid for a cap box, small cap to go on the box with finger cutouts. This uses the first child as the shape for repeating on the lid.

Arguments:

By Position What it does
size [width, length, height] outside size of the box
lid_boundary boundary around the outside for the lid (default 10)
cap_height height of the cap on the box (default 10)
lid_thickness thickness of the lid (default default_lid_thickness)
wall_thickness thickness of the walls (default default_wall_thickness)
layout_width the width of the layout pieces (default default_lid_layout_width)
aspect_ratio the aspect ratio (multiple by dy) (default default_lid_aspect_ratio)
size_spacing extra spacing to apply between pieces (default m_piece_wiggle_room)
lid_pattern_dense if the layout is dense (default false)
lid_dense_shape_edges the number of edges on the dense layout (default 6)
material_colour the colour of the material in the box (default default_material_colour)
pattern_inner_control if the shape needs inner control (default false)
lid_catch the type of catch to use (default default_lid_catch_type)
lid_rounding how much to round the edge of the lid
lid_inner_rounding how much to round the inside of the box

Example 1:

CapBoxLidWithCustomShape() Example 1 
include <boardgame_toolkit.scad>
CapBoxLidWithCustomShape([100, 50, 30]) {
  ShapeByType(MakeShapeObject(shape_type = SHAPE_TYPE_SUPERSHAPE, shape_thickness = 2, supershape_m1 = 12, supershape_m2 = 12,
     supershape_n1 = 1, supershape_b = 1.5, shape_width = 15));
}

Module: CapBoxLidWithLabelAndCustomShape()

Topics: CapBox

Usage: CapBoxLidWithLabelAndCustomShape([100, 50, 20], text\_str = "Frog");

Description:

Lid for a cap box, small cap to go on the box with finger cutouts. This uses the first child as the shape for repeating on the lid.

Arguments:

By Position What it does
size [width, length, height] outside size of the box
text_str the string to use for the label
label_options options for the label
wall_thickness thickness of the walls (default default_wall_thickness)
lid_boundary boundary around the outside for the lid (default 10)
cap_height height of the cap on the box (default 10)
layout_width the width of the layout pieces (default default_lid_layout_width)
size_spacing extra spacing to apply between pieces (default m_piece_wiggle_room)
lid_thickness thickness of the lid (default default_lid_thickness)
aspect_ratio the aspect ratio (multiple by dy) (default default_lid_aspect_ratio)
lid_rounding how much to round the edge of the lid (default wall_thickness / 2)
lid_inner_rounding how much to round the inside of the box
lid_pattern_dense if the layout is dense (default false)
lid_dense_shape_edges the number of edges on the dense layout (default 6)
material_colour the colour of the material in the box (default default_material_colour)
pattern_inner_control if the shape needs inner control (default false)
lid_catch the type of catch to use (default default_lid_catch_type)
label_background_colour the colour to use for the label background

Example 1:

CapBoxLidWithLabelAndCustomShape() Example 1 
include <boardgame_toolkit.scad>
CapBoxLidWithLabelAndCustomShape([100, 50, 30], text_str = "Frog") {
  ShapeByType(MakeShapeObject(shape_type = SHAPE_TYPE_SUPERSHAPE, shape_thickness = 2, supershape_m1 = 12, supershape_m2 = 12,
     supershape_n1 = 1, supershape_b = 1.5, shape_width = 15));
}

Module: CapBoxLidWithLabel()

Topics: CapBox

Usage: CapBoxLidWithLabel([100, 50, 20], text\_str = "Frog");

Description:

Lid for a cap box, small cap to go on the box with finger cutouts.

Arguments:

By Position What it does
size [width, length, height] outside size of the box
text_str the string to use for the label
lid_boundary boundary around the outside for the lid (default 10)
wall_thickness thickness of the walls (default default_wall_thickness)
aspect_ratio the aspect ratio (multiple by dy) (default default_lid_aspect_ratio)
cap_height height of the cap on the box (default 10)
layout_width the width of the layout pieces (default default_lid_layout_width)
size_spacing extra spacing to apply between pieces (default m_piece_wiggle_room)
lid_thickness thickness of the lid (default default_lid_thickness)
lid_rounding how much to round the edge of the lid (default wall_thickness / 2)
lid_inner_rounding how much to round the inside of the box
material_colour the colour of the material in the box (default default_material_colour)
lid_catch the type of catch to use (default default_lid_catch_type)
label_options options for the label (default undef)
shape_options options for the shape (default undef)

Example 1:

CapBoxLidWithLabel() Example 1 
include <boardgame_toolkit.scad>
CapBoxLidWithLabel([100, 50, 30], text_str = "Frog");



Example 2:

CapBoxLidWithLabel() Example 2 
include <boardgame_toolkit.scad>
CapBoxLidWithLabel([100, 50, 30], text_str = "Frog", material_colour =
"lightblue", label_options=MakeLabelOptions(label_colour = "black"));

Example 3:

CapBoxLidWithLabel() Example 3 
include <boardgame_toolkit.scad>
default_lid_shape_type = SHAPE_TYPE_CIRCLE;
default_lid_shape_thickness = 1;
default_lid_shape_width = 13;
default_lid_layout_width = 10;
CapBoxLidWithLabel([120, 70, 30], text_str = "Cards");



Module: CapBoxLidWithShape()

Topics: CapBox

Usage: CapBoxLidWithShape([100, 50, 20]);

Description:

Lid for a cap box, small cap to go on the box with finger cutouts.

Arguments:

By Position What it does
size [width, length, height] outside size of the box
text_str the string to use for the label (unused)
lid_boundary boundary around the outside for the lid (default 10)
wall_thickness thickness of the walls (default default_wall_thickness)
cap_height height of the cap on the box (default 10)
layout_width the width of the layout pieces (default default_lid_layout_width)
size_spacing extra spacing to apply between pieces (default m_piece_wiggle_room)
lid_thickness thickness of the lid (default default_lid_thickness)
aspect_ratio the aspect ratio (multiple by dy) (default default_lid_aspect_ratio)
lid_rounding how much to round the edge of the lid (default wall_thickness / 2)
lid_inner_rounding how much to round the inside of the box
material_colour the colour of the material in the box (default default_material_colour)
lid_catch the type of catch to use (default default_lid_catch_type)
shape_options options for the shape (default undef)
label_options options for the label (default undef)

Example 1:

CapBoxLidWithShape() Example 1 
include <boardgame_toolkit.scad>
CapBoxLidWithShape([100, 50, 30]);



Example 2:

CapBoxLidWithShape() Example 2 
include <boardgame_toolkit.scad>
CapBoxLidWithShape([100, 50, 30], material_colour =
"lightblue");



Example 3:

CapBoxLidWithShape() Example 3 
include <boardgame_toolkit.scad>
default_lid_shape_type = SHAPE_TYPE_CIRCLE;
default_lid_shape_thickness = 1;
default_lid_shape_width = 13;
default_lid_layout_width = 10;
CapBoxLidWithShape([120, 70, 30]);



Indices

Table of Contents
Function Index
Topics Index
Cheat Sheet
Tutorials

List of Files:

Boxes:

Basics:

Dividers:

Shapes:

Slicing:

CardLibrary:

Miscellaneous:

Clone this wiki locally