Translated Gears Library for OpenSCAD with Additional Functions

Disclosure / 免责声明:

The translation and functional modifications in this version were created with substantial AI assistance. As I do not personally have professional expertise in gear mathematics, please independently verify all calculations and code—especially the additional functions introduced in this version—before using them in your own projects.
本版本的翻译与功能调整在很大程度上借助了 AI。由于本人并不具备专业的齿轮数学知识，请在将其用于您自己的项目之前，独立核验所有数学计算与代码，尤其是本版本新增的功能。

This project is a machine-assisted translation and functional adaptation of the original gear library created by janssen86.
本项目是对 janssen86 所创建的原始齿轮库进行的机器辅助翻译与功能适配。

Adjustments / 调整内容:

A separate test file has been added for testing and demonstration purposes.
新增了一个独立的测试文件，用于功能测试与示例演示。

For certain assemblies, the relevant calculation logic has been extracted from the modules into standalone functions. This makes it possible to obtain the required translation and rotation data separately, allowing the generated gear modules to be positioned and oriented correctly when incorporated into custom assemblies.
针对部分装配结构，相关计算逻辑已从模块中提取为独立函数。这样可以单独获取所需的平移与旋转数据，从而在自定义装配中正确定位和调整所生成齿轮模块的方向。

The rack-and-pinion, planetary gear, bevel gear, and worm gear assembly tools now support configurable initial rotation and translation values. This makes it easier to use the generated assemblies as the basis for custom parts and mechanical designs.
齿条与小齿轮、行星齿轮、锥齿轮以及蜗轮蜗杆装配工具现已支持配置初始旋转与平移参数，便于以生成的装配结构为基础创建自定义零件和机械设计。

Two methods for generating multi-gear linkages have also been added. Although they are not as sophisticated as the tools available on geargenerator.com, they should be suitable for a range of practical 3D-printing design applications.
此外，本版本还新增了两种多齿轮联动结构的生成方式。虽然其功能尚不及 geargenerator.com 等专业工具完善，但应足以满足多种实际的 3D 打印设计需求。

Update 2026-07-13 / 更新 2026-07-13
An experimental version with support for chamfering gear edges has been added. The chamfer implementation is based on the lofting method presented by Instructables user “better call it art” in “Loft in OpenSCAD”: https://www.instructables.com/Loft-in-OpenSCAD/ . Full credit is given to the original author for this method.
新增了一个支持齿轮边缘倒角的实验版本。其倒角功能采用了 Instructables 用户“better call it art”在“Loft in OpenSCAD”中介绍的放样方法：https://www.instructables.com/Loft-in-OpenSCAD/ 。特此向该方法的原作者致谢。

As the chamfered version has not yet been extensively tested under extreme parameter combinations and edge cases, it is provided as a separate download.
由于倒角版本尚未在极端参数组合及各种边界条件下经过充分测试，因此目前作为独立版本提供下载。

Usage / 使用方法:

In the test file, set test_case = -1 to render all available test cases. Do not use F6 rendering with this setting unless necessary, as the complete render may take an extremely long time.
在测试文件中，将 test_case 设置为 -1 可以渲染全部测试用例。除非确有需要，否则请勿在此设置下使用 F6 进行完整渲染，因为渲染过程可能耗费极长时间。
Set test_case to a value from 1 to 27 to run a specific example. You can then adjust its parameters as required before copying the relevant code into your own project.
将 test_case 设置为 1 至 27 之间的数值，即可运行指定的示例。您可以根据需要调整相应参数，然后将相关代码复制到自己的项目中。

Bug Reports and Feedback / 问题反馈:

If you encounter any bugs, alignment issues, or calculation errors, please feel free to report them. As I am not an expert in gear mathematics and relied on AI assistance when deriving some of the formulas, reports that include clear reproduction steps, parameter values, and relevant code will be especially helpful. I will make every reasonable effort to investigate and correct confirmed issues.
如果您发现任何程序错误、装配错位或计算问题，欢迎提交反馈。由于本人并非齿轮数学领域的专家，且部分公式是在 AI 协助下推导完成的，因此若反馈中能够提供清晰的复现步骤、参数值及相关代码，将非常有助于问题排查。对于确认存在的问题，我会尽力进行调查与修正。

Additional License Notice / 补充许可说明:
The Public Domain dedication applies only to the modifications and additions created by me with AI assistance. The original library, including its original algorithms and other pre-existing content, remains subject to the license terms specified by the original author.
Public Domain（公有领域）声明仅适用于由本人在 AI 协助下完成的修改与新增内容。原始齿轮库及其原有算法和其他既有内容，仍应遵循原作者所指定的许可条款。