使用脚本自动完成设计任务
概览
- 了解脚本工程、独立脚本单元和基于对话框的脚本窗体的组织方式。
- 探索脚本调试工具,以及通过菜单、工具栏和快捷键运行脚本的方式。
- 查找脚本示例和语言支持指南,了解使用旧版脚本时需要注意的限制。
脚本是一种强大的工具,可帮助您扩展 Altium Designer 的功能并提高工作效率。脚本包含一组指令(自动化命令),在 Altium Designer 中执行时会对这些指令进行解释。您可以使用多种语言编写脚本,构建复杂的对话框,并在 Altium Designer 中进行调试。借助脚本,您只需进行极少的用户输入、更少的按键和鼠标点击,即可实现设计目标。
借助脚本,您可以自动执行重复性任务,并完成 Altium Designer 现有命令无法实现的编辑操作。例如,您可以使用脚本搜索并更新 PCB 文档中的基准标记,或导出自定义网表。
脚本可以保存在脚本工程或设计工程中。在 Altium Designer 中,您可以使用多种脚本语言编写脚本。
脚本系统概述与设置
Altium Designer 脚本系统提供了创建脚本所需的全部工具和功能,可用于自动执行软件中的任务。
您可以编写脚本来自动执行重复性任务,或增强 Altium Designer 中的某项功能。脚本系统由两个主要部分组成:编辑器和调试器。脚本编辑器、调试器和脚本面板协同工作,帮助您轻松编写和调试脚本。脚本可以直接从脚本编辑器运行,也可以分配给菜单、工具栏或快捷键,以便随时对当前文档(例如 PCB)执行脚本。
创建和存储脚本
Altium Designer 脚本通常在脚本工程(*.PrjScr)中创建和存储,但也可以添加到任何类型的工程中或存储于其中。
要开始编写脚本,请先创建一个新的脚本工程,然后向该工程添加脚本文件。
脚本工程可帮助您管理脚本,您可以从主菜单中选择 File » New » Project » Script Project 来创建脚本工程。新工程将列在 Projects 面板中。要向工程添加新脚本,请右键单击工程名称,然后从右键菜单中选择 Add New to Project。
创建新脚本时,可根据工程需求选择两种脚本类型:脚本单元和脚本窗体。脚本单元允许您编写独立的过程和函数。脚本窗体则允许您构建包含控件和事件处理程序的对话框,同时也支持编写过程和函数。
► 了解在 Altium Designer 中创建和存储脚本
编写脚本
编写脚本涉及以下一些基本概念和术语:
-
进程是可用于在脚本中执行命令的命令字符串。
-
组件是 Tool Palette 面板上的可视化控件对象,您可以将其拖放到脚本窗体上,以操作设计。
-
放置在脚本窗体上的组件具有方法、属性 和事件。
-
对象接口是一类特殊的对象接口,您可以在脚本中使用这些接口提取和修改设计文档中的数据。
默认脚本语言设置为 DelphiScript(*.pas)。脚本引擎本身使用 Embarcadero Delphi 编写,Tool Palette 面板则基于 Delphi 的 VCL(可视化组件库)。
脚本编辑和调试工具
Altium Designer 脚本系统由两个主要部分组成:编辑器和调试器。编辑器提供一系列脚本代码辅助和检查功能,调试器则提供脚本组件访问和调试功能。脚本编辑器工具是调试脚本时的重要辅助工具。
脚本系统提供了一系列工具来帮助调试脚本,包括在脚本中设置多个断点、使用 Watch List 面板监视变量值、使用书签更高效地跳转,以及使用单步进入和单步跳过功能跟踪脚本执行。
运行脚本
Altium Designer 脚本系统提供了为 Altium Designer 创建复杂自动化任务的手段,同时,创建的脚本也需要在设计过程中便于调用。例如,为在编辑 PCB 时执行一组复杂操作而创建的脚本,应当能够直接在 PCB 编辑器中方便地调用,只需点击一两次鼠标即可执行。
为此,Altium Designer 允许将脚本分配给进程启动器,从而形成可分配给菜单、工具栏和快捷键的命令。
在脚本编辑器中打开脚本后,可以使用编辑器的 Run 命令执行脚本。这要求脚本工程已在 Altium Designer 中打开,因此,对于在 PCB 设计过程中需要使用的脚本而言,这种访问方式并不方便。另一种方法是使用 Select Item To Run 对话框(File » Run Script),浏览本地硬盘或已连接的工作区中的脚本,然后运行所需的进程。脚本在当前会话期间将保持加载状态。
对于经常使用的脚本,更合适的访问方法是从 Preferences 对话框的 Scripting System – Global Projects 页面将其工程安装为全局工程。这样,工程会在 Altium Designer 启动时自动加载,您可以随时通过 File » Run Script 命令执行脚本。
脚本图形组件
Altium Designer 脚本中可用的可视化窗体组件大多源自 Embarcadero 的可视化组件库(VCL)。该库是一组预定义的可视化组件,用于使用 Delphi 和 C++ 语言开发 Windows 应用程序。
VCL 是一个可视化类库,其类在线性对象层次结构中派生自 TComponent 对象(该对象本身又派生自 TObject 根对象)。因此,常见的脚本组件(例如 TButton 对象)会继承其各级祖先对象的属性、方法和事件。在本例中,类层次结构为:TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton。
请注意,派生自 TControl 对象的组件通常是可视化组件(控件),而派生自 TWinControl 的常见组件大多是对 Windows API 的封装。
在 Altium Designer 脚本编辑器中创建窗体时,可从 Tool Palette 面板访问这些组件。脚本窗体具有关联的 *.DFM 文件,其中包含窗体配置、组件位置及其他属性的详细信息;该文件位于脚本工程所在的文件夹中。Altium Designer 支持在设计脚本窗体时,通过 DelphiScript 或 VBScript 使用这些组件。
脚本示例
为了进一步了解脚本系统的基本特性,以及如何在脚本中使用 Delphi 和 X2 对象模型,本文将从功能角度分析两个示例项目:板框复制器和网表生成脚本。Board Outline Copier 和 Netlister 脚本使用 X2 对象模型开发,旨在展示 Altium Designer 脚本系统的功能。
这些现有脚本可在 Altium 提供的示例下载包 中找到。请注意,此 ZIP 文件是在 Altium Designer 10 发布时创建的。ZIP 文件中的 Scripts 文件夹包含按脚本语言分类的子文件夹。
请注意,您可以在 Altium Designer GitHub 集合中找到各种实用脚本。
► 阅读有关在 Altium Designer 中分析脚本示例
的内容► 阅读有关 Altium Designer 脚本示例参考
的内容脚本语言支持
您可以使用多种脚本语言为 Altium Designer 编写脚本。请注意,DelphiScript 是主要的脚本语言,也是脚本文档中最常提及的语言,它与 Embarcadero Delphi™ 密切相关。
► 阅读有关 Altium Designer 中的脚本语言支持
的内容





