openscad-workshop-tools

OpenSCAD Workshop Tool Modeling

Create parametric 3D models of workshop tools for layout planning and visualization.

Workflow

1. Gather Specifications

Collect from user, manuals, or product pages:

• Dimensions: Overall W x D x H, base plate size
• Weight: Helps verify scale is reasonable
• Key features: Chuck size, motor power, speeds (for header comment)
• Reference image: Essential for component identification

2. Identify Components

Decompose tool into logical modules. See references/code-structure.md for decomposition patterns by tool type.

Typical components:

• Base/frame (static foundation)
• Main body/motor housing
• Moving parts (quill, blade guard, plunge mechanism)
• Controls (buttons, dials, levers)
• Accessories (vise, fence, dust port)

3. Write OpenSCAD File

Follow the standardized structure in references/code-structure.md:

/* [Section] */     // Customizer sections
// Comment         // Parameter description
param = value;     // Actual parameter

module component() { ... }  // One module per component
module tool_name() { ... }  // Assembly module
tool_name();                // Render call
echo("=== ... ===");        // Debug output

Key patterns:

• Use $fn = $preview ? 32 : 64 for quality switching
• Apply brand colors from reference table
• Include show_* toggles for optional components
• Use hull() for rounded shapes
• Add floor reference plane for context

4. Render Preview

openscad -o images/tool-name.png \
  --autocenter --viewall \
  --imgsize=800,1000 \
  /path/to/tool.scad

5. Iterate

Adjust proportions based on visual comparison to reference image.

File Location

Save to: workshop/tools/<brand>-<model>.scad

Examples:

• workshop/tools/bosch-pbd40.scad
• workshop/tools/festool-ctl-midi.scad
• workshop/tools/festool-ts55.scad

Quick Reference

Tool Type	Key Dimensions	Critical Components
Drill press	Base, column height, head depth	Column, quill, chuck, handwheel
Track saw	Body L x W x H, blade dia	Base plate, blade guard, handle
Vacuum	L x W x H, wheel dia	Body, wheels, handle, hose port
Bandsaw	Table size, throat depth	Frame, table, blade guides