openscad-workshop-tools

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OpenSCAD Workshop Tool Modeling

OpenSCAD车间工具建模

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

创建用于布局规划与可视化的车间工具参数化3D模型。

Workflow

工作流程

1. Gather Specifications

1. 收集规格信息

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

2. 拆分组件

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)

将工具分解为逻辑模块。请参考references/code-structure.md中按工具类型划分的分解模式。

典型组件：

底座/框架（静态基础）
主体/电机外壳
活动部件（主轴套筒、刀片护罩、plunge机构）
控制部件（按钮、旋钮、操纵杆）
附件（虎钳、围栏、吸尘口）

3. Write OpenSCAD File

3. 编写OpenSCAD文件

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

openscad

/* [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

遵循references/code-structure.md中的标准化结构：

openscad

/* [Section] */     // 自定义器章节
// Comment         // 参数说明
param = value;     // 实际参数

module component() { ... }  // 每个组件对应一个模块
module tool_name() { ... }  // 装配模块
tool_name();                // 渲染调用
echo("=== ... ===");        // 调试输出

核心模式：

使用
```
$fn = $preview ? 32 : 64
```
实现质量切换
应用参考表中的品牌配色
包含
```
show_*
```
开关以控制可选组件的显示
使用
```
hull()
```
创建圆角形状
添加地面参考平面以提供上下文

4. Render Preview

4. 渲染预览

bash

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

bash

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

5. Iterate

5. 迭代优化

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
```

保存至：

workshop/tools/<brand>-<model>.scad

示例：

```
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

工具类型	关键尺寸	核心组件
钻床	底座尺寸、立柱高度、机头深度	立柱、主轴套筒、卡盘、手轮
轨道锯	主体长×宽×高、刀片直径	底座板、刀片护罩、手柄
吸尘器	长×宽×高、轮子直径	机身、轮子、手柄、软管接口
带锯	工作台尺寸、喉深	框架、工作台、刀片导向器