Python 脚本

LinkCAD 包含一个嵌入式 Python 解释器，用于自定义自动化、工具开发和格式插件创建。Python 脚本可以访问完整的图纸数据库和几何 API。

功能

• 自定义工具——创建处理图纸几何图形的菜单项
• 格式插件——添加对新导入/导出文件格式的支持
• 交互式控制台——实时探索和操作图纸
• 脚本编辑器——在 LinkCAD 内编写并运行脚本

入门

1. 设置与要求——Python 环境和先决条件
2. 你的第一个脚本——Python 控制台中的 “Hello World”
3. 编写工具插件——创建集成到菜单的工具
4. 编写格式插件——添加新的文件格式
5. 面板拼版教程——完整的真实场景示例

API 参考

• 选项类型——integer、real、boolean、string、choice、path、color、table、cell_choice
• 工具装饰器——@tool() 装饰器和 Tool 基类
• 格式装饰器——@format_reader()、@format_writer() 和基类
• API 模块——所有模块：linkcad.plugin、linkcad.db、linkcad.geom、linkcad.edit、linkcad.env、linkcad.conv、linkcad.libgraph、linkcad.controller

快速示例

一个按图层统计形状数量的简单工具：

from linkcad.plugin import tool, Tool

@tool(
    name="Layer Statistics",
    menu="Tools/Analysis",
    tooltip="Count shapes per layer",
)
class LayerStats(Tool):
    def run(self, drawing) -> None:
        for layer_name, shapes in drawing.shapes_by_layer():
            count = sum(1 for _ in shapes)
            print(f"{layer_name}: {count} shapes")