FreeCAD Gears 项目教程

1. 项目的目录结构及介绍

FreeCAD Gears 项目的目录结构如下：

freecad.gears/
├── docs/
├── examples/
├── freecad/
│   └── gears/
├── pygears/
├── tests/
├── .gitignore
├── LICENSE
├── MANIFEST.in
├── README.md
├── TODO.md
├── package.xml
└── setup.py

目录结构介绍

• docs/: 包含项目的文档文件。
• examples/: 包含示例文件，展示如何使用 FreeCAD Gears 模块。
• freecad/gears/: 包含 FreeCAD Gears 模块的核心代码。
• pygears/: 包含 Python 相关的代码和工具。
• tests/: 包含项目的测试代码。
• .gitignore: Git 忽略文件，指定哪些文件或目录不需要被版本控制。
• LICENSE: 项目的许可证文件，采用 GPL-3.0 许可证。
• MANIFEST.in: 指定在打包时需要包含的额外文件。
• README.md: 项目的介绍文件，包含项目的基本信息和使用说明。
• TODO.md: 项目待办事项列表。
• package.xml: 项目的元数据文件。
• setup.py: 项目的安装脚本。

2. 项目的启动文件介绍

FreeCAD Gears 项目没有明确的“启动文件”，因为它是一个模块，需要在 FreeCAD 中加载和使用。不过，项目的核心代码位于 freecad/gears/ 目录下，用户可以通过加载该模块来使用其中的功能。

3. 项目的配置文件介绍

FreeCAD Gears 项目没有传统的配置文件，但可以通过以下方式进行配置和使用：

安装配置

1. 通过 Addon Manager 安装:

   • 从 FreeCAD v0.17 开始，可以使用内置的 Addon Manager 安装 FreeCAD Gears 模块。
   • 打开 FreeCAD，进入 Tools > Addon Manager，搜索并安装 FCGear。

2. 通过 pip 安装:

   • 使用 pip 命令安装：

     pip install https://github.com/looooo/FCGear/archive/master.tar.gz
     

   • 确保使用的 pip 版本与 FreeCAD 使用的 Python 版本一致。

使用配置

1. 手动创建齿轮:

   • 打开 FreeCAD，切换到 Gear 工作台。
   • 创建新文档，点击工具栏中的齿轮图标，创建齿轮并调整参数。

2. 脚本化创建齿轮:

   • 使用 Python 脚本自动化齿轮建模：

     import FreeCAD as App
     import freecad.gears.commands
     
     gear = freecad.gears.commands.CreateInvoluteGear.create()
     gear.teeth = 20
     gear.beta = 20
     gear.height = 10
     gear.double_helix = True
     App.ActiveDocument.recompute()
     Gui.SendMsgToActiveView("ViewFit")
     

通过以上配置和使用方法，用户可以在 FreeCAD 中方便地使用 FreeCAD Gears 模块进行齿轮设计和建模。