本手册是Allegro PCB 设计软件的 SKILL 扩展语言（AXL）参考文档，面向需要通过脚本自定义 Allegro 交互命令或开发新功能的用户。
一、手册适用范围与前提要求
| 适用人群 | 需掌握的前置知识 |
|---|---|
| 计划使用 AXL 自定义 / 开发 Allegro 命令的工程师 | 1. PCB 设计与开发流程 2. Allegro PCB 物理设计、可靠性 / 可测试性 / 可制造性分析功能 3. Cadence SKILL 语言（参考《SKILL Language User Guide》《SKILL Language Reference》） |
| 仅需了解 AXL 功能的用户 | 只需阅读第 1 章《Allegro SKILL 函数简介》 |
二、手册章节内容速览
| 章节编号 | 章节名称 | 核心内容 |
|---|---|---|
| 1 | Allegro SKILL 函数简介 | AXL 运行机制、与 Allegro 数据库的关联；AXL 初始化 / 启停 / 调试；dbid 与对象持久性；数据库对象选择；AXL-SKILL 数据库对象类型 |
| 2 | Allegro 数据库用户模型 | 数据库对象结构与关联关系；对象属性列表；数据库规则、属性类型；几何 / 逻辑 / 属性数据库类型 |
| 3 | 数据库创建函数 | 路径（Path）、形状、矩形、线、引脚、符号、文本、过孔等几何对象的创建函数 |
| 4 | 参数管理函数 | Allegro 数据库参数对象的读写访问 |
| 5 | 选择与查找函数 | 选择集管理；点选 / 框选 / 按名称 /dbid 选择；Findfilter 配置 |
| 6 | 交互编辑函数 | 与 Allegro 交互命令等效的对象操作函数（删除、显示等） |
| 7 | 数据库读取函数 | 打开 Allegro 设计文件；访问分支图形、属性、焊盘、文本等对象 |
| 8 | Allegro 界面函数 | 数据库对象高亮 / 显示；光标缓冲区加载；动态橡皮筋显示；用户坐标拾取；命令完成 / 取消的回调函数 |
| 9 | Allegro 命令行函数 | 设置 Allegro 环境变量；向命令行发送指令字符串 |
| 10 | 用户界面函数 | 用户提示与确认；文本文件显示 / 打印 |
| 11 | 表单界面函数 | 表单创建（含各类表单字段）；字段输入的回调函数配置 |
| 12 | 消息处理函数 | 用户消息配置与显示 |
| 13 | 设计控制函数 | 获取当前设计的名称与类型 |
| 14 | 命令控制函数 | SKILL 命令注册 / 注销；线锁定、激活层控制；弹窗定义；用户数据获取 |
| 15 | Allegro 文件访问函数 | 文件名获取、文件打开 / 关闭 |
| 16 | 数据提取函数 | 以 ASCII 格式提取设计数据；视图内对象集筛选与批量函数应用 |
| 17 | 工具函数 | 圆弧中心计算；单位转换；其他杂项工具 |
| 18 | 数据库杂项函数 | 未归类的数据库辅助函数 |
三、关键语法与术语约定
| 符号 / 术语 | 含义 |
|---|---|
| italics | 数据类型名称 |
| nil | SKILL 空列表；函数返回值表示失败 |
| t | SKILL 布尔值 "真"；函数返回值表示成功 |
| [name] | 可选参数 name |
| <name> | 必选参数 name |
| dbid | Allegro 数据库对象实例的唯一标识（数据库 ID） |
| figure | 几何数据库对象（线、形状、符号等）；特殊说明："Allegro figure" 专指 DRC 标记、钻孔等特殊图形 |
| l_bBox | 边界框坐标列表（含左下角、右上角坐标对） |
| t_layer | Allegro 层标识格式，格式为 类/子类，例：PACKAGE GEOMETRY/SILKSCREEN_TOP |
| lo_dbid | 接收或返回 单个 / 多个 dbid 的函数 |
| o_dbid | 接收或返回 单个 dbid 的函数 |
四、按名称引用数据库对象的规则
部分 Allegro 对象支持通过唯一名称直接引用，对应关系如下：
| 对象类型 | 引用名称 |
|---|---|
| NET | 网络名（netname） |
| COMPONENT | 参考标号（refdes） |
| SYMBOL | 参考标号 + 引脚号，格式：<refdes>.<pin number> |
| FUNCTION | 功能标识符 |
| DEVTYPE | 器件类型 |
| SYMTYPE | 符号类型（例：DIP14） |
| PROPERTY | 属性名（例：MAX_OVERSHOOT） |
| 调用方式 | 使用第 5 章的 axlName 系列函数 |
五、补充资源与支持
| 需查阅的内容 | 对应手册 |
|---|---|
| Allegro 用户界面；Allegro 设计流程概述，包括软件的启动与退出、图形显示控制、图形与文本元素操作、设计信息与系统信息的查看 | 《Allegro/APD 设计指南：快速入门》 |
| 库的创建与管理，包括焊盘栈定义、自定义焊盘、封装设计、电气属性配置及格式设置 | 《Allegro/APD 设计指南：库开发》 |
| 逻辑设计数据的加载及第三方机械数据的转换，包括从 Concept™ 软件、网表及电路板机械文件中加载数据 | 《Allegro/APD 设计指南：逻辑设计数据迁移》 |
| 设计项目的搭建及设计规则与控制参数的设置，包括属性与约束的指定方法 | 《Allegro/APD 设计指南：布局准备》 |
| Allegro 元器件布局方法，包括自动布局与交互式布局 | 《Allegro 用户指南：布局》 |
| Allegro 布线方法，包括交互式布线与自动布线 | 《Allegro 用户指南：布线》 |
| 设计输出，包括参考标号重命名、钻孔与丝印数据生成、笔式绘图文件输出 | 《Allegro 用户指南：制造流程》 |
| Allegro 可选接口，包括 Cadnetix-E、CBDS、Racal Visula、IGES、Greenfield、Computervision CADDS、SDRC I-DEAS、AutoCAD DXF、PTC、CATIA、IPC-D-350C、GDSII、Fluke 缺陷分析仪及 HP3070 测试仪接口 | 《第三方设计与机械数据转换指南》 |
| 按字母顺序排列的 Allegro 命令 | 《Allegro/APD 帮助文档》中的《命令参考手册》 |
| Allegro 属性、数据提取示例及报表生成 | 《Allegro/APD 设计指南：设计规则、提取数据字典与报表生成》（位于 Allegro/APD 在线帮助的 "通用概述" 栏目下） |
| Allegro 用户指南与参考手册的综合术语表 | 《Allegro/APD 设计指南术语表》 |