allegro二次开发语法大全

allegro skill简介

1. AXL-SKILL

专用于allegro的skill被称为AXL-SKILL，只有使用这些专用的函数才可以直接访问allegro的database。结合skill

语法和这些专用函数可以编写出实现各种功能的命令。专用于allegro的skill都是以axl开头，比如axlClearSelSet()。

2. 运行AXL-SKILL

在allegro中输入skill就得到了AXL-SKILL的运行环境，在这样的环境中可以直接调用AXL-SKILL命令/函数，另外

输入set telskill可以得到一个尺寸大小可调的skill开发窗口。（万一没有弹出窗口，尝试在allegro菜单里面，

选择setup->user prference->skill->telskill----OK）

3. AXL-SKILL Database

allegro中的每个对象object(比如IC元件，net)都有一个对应的dbid(database identifiers)，AXL-SKILL操作allegro

的也正是这些dbid。 dbid对象：在不同的级别上的dbid是不一样的，比如在Design以及包含的database对象有Property Dictionary，Lines，Text，Polygons，Shapes，Property Definitions，DRCs，Vias that are Padstack object types，Symbols that are Symdef object types，Components，Nets；而在Symbol级别上则是PPins that are Padstack object types，Vias that are Padstack object types，Lines，Arcs，Text，Polygons，Shapes。

allegro skill database对象类型1. database对象描述

1.1 对象类型 Figure objects： Arcs，Branches ，Design Files，Drcs，Lines，Paths ，Polygons ，Ppins，Shapes ，Symbols ，Tees，Vias，Pads，Padstacks，Symdefs； Logical objects：Components ，Functions，Function Pins，Nets； Property dictionary objects； Parameter objects：Design，Display，Layer Group，Layer，Textblock Group，Textblock。 1.2 基本操作尽管有如此之

多的类型，但是在allegro中的操作其实就是找到合适的database元素，然后对其操作就好了。只要保证被访问的元

素的dbid有效，就可以对其进行处理。

2. Figure类型

Figure在allegro PCB Editer里面一般被成为几何形状，一个Figure类型的元素通常具有如下的属性。

常见的Figure属性

属性名类型描述 bBox bbox Figure’s bounding box branch dbid For etch, the figure’s branch parent layer t_layer Layer

of figure, nil if object is multi-layer parent dbid Nonconnective owner

net dbid Net object if figure is associated with a net

注意: 对于所有空(dummy)网络的Figure, 它们的net属性都是"", 而不是nil。

Figure有很多的类型，每个类型都有很多个属性，具体的信息请参考algroskill.pdf文档的第二章，这里只列出其中的

Line。Line的属性列表(除Figure类型常见的属性以外的部分)

属性名类型描述 isEtch t/nil t = a CLINE; nil = a LINE lineType s_type symbol: horizontal, vertical, odd objType string Type

of object, in this case "line" parent dbid Path, polygon, or shape

startEnd l_point Start and end points width float Width of line

3. Logical类型

Logical类型其实就是和电气有关的属性，比如网络连接(net)，电子器件{component)等。 Logical类型通常都具

有objType, prop, and readOnly3种属性。如果你选择了一个component，那么它的objType就是component，如

果选择的是pin，则objType属性值就是pin......

一个简单的例子Bus(总线)，其它的Logical类型请参考Cadence的algroskill.pdf文件

属性名类型描述

groupMembers l_dbid List of xnets of the bus

name string Name of the bus objType string “group” type string “BUS”

4. Property Dictionary类型

在allegro的应用中会根据工作的需要自己定制(创建)属性——用户定义的属性(user defined properties)。Allegro

支持用户创建具备如下特性的属性

NETS，COMPONENTS，FUNCTIONS PINS，VIAS，SHAPES，SYMBOLS，CLINES，LINES，DRCS，FIGURES，DESIGNS，COMPDEFS，PINDEFS，FUNCDEFS。如果你创建了一个只包含SYMBOLS类型的属性，

那么你创建的这个属性只能被赋给Allegro中的Symbol对象，而不可以赋给一个net或其它非Symbol的对象。

5. Parameter类型

Parameter的简单理解就是Allegro中个各个设置参数，举个简单的例子，系统(Design)级别的参数列表。 Design Parameter属性

属性名可设置否? 类型描述accuracy no integer Number of decimal places of accuracy bBox no bbox The design’s bounding box height no float Height in user units objType no string Type of object, in this case "paramDesign" units no

string Type of user units (mils, inch, micron,millimeter and centimeter) width no float Width in user units xy no point

Lower left corner of design 注意：可设置否表示的是能否通过函数axlParamSet来设置。下一章将主要讲对Allegro Parameter的操作，对参数的读取，修改与更新等等。

allegro skill Database操作相关函数5.1 Database Read函数

和以前一样，这里只介绍部分的函数，其它的函数请参考algroskill.pdf文件。 axlDBGetDesign() => dbid，当

前design的dbid，基本上来说整个design的所有信息都可以通过这个dbid得到。比如design有多少个 component，

每个component的dbid；比如design有多少drc，每个drc又分别是什么等等。

axlDBGetAttachedText(o_dbid) => text dbid，得到o_dbid对象所具有的(被attached的)text的dbid列表。该函数

常用于在一个包含很多text的symbol对象上查找特定text的应用中。比如我们通常会把一个design放在适当尺寸的

sheet中，对应于design的各个层，sheet也会有对于的页码来表示，比如sheet的第1页是Top层，那么int1层可

能就是第2页，如果你想写个程序来实现页码的自动更新，就会用到这个函数来找到需要被修改的字符 (text)，然后

用后面将要说到的Database Create相应函数来修改选中的字符。

axlDBGetPad(o_dbid t_layer t_type) => pad dbid，获得pin，via，padstack相应层的特定pad。比如axlDBGetPad(dpin “Etch/Top" ”anti“)=>dpin对象在Top层的anti-pad的dbid。通过这个dbid又可以进一步得到pad的一些相关属

性。

axlDBGetPropDictEntry(t_name) => propdefinition，得到user defined properties里面设置的各个属性的信息，

比如属性类型，应用的对象。

axlDBGetProperties(o_dbid [lt_type]) => l_results，得到o_dbid所具有的properties列表，allegro默认的或者

是user defined。

axlDBIsFixed(o_dbid) => t/nil，判断一个对象是不是被fixed了。通常在用户程序想修改一些design的对象的时候，

必须先确定该对象是不是被fixed了，fixed 对象是不可以被修改的。(用户必须先给fixed的对象un-fixed，然后才

能进行修改)

axlDBGetShapes(t_layer) => shape dbid，一种获取指定层所有shape的快捷方式。(通常的获取对象的方式都是先要

设置FindFilter，然后addselect，再getselset，3步才可以。)

5.2 Database Create

首先allegro本身不支持的操作使用下面将要给出的AXL-Skill函数也是无法实现的。比如allegro不支持将一个cline

画到非Etch 层去，那么用axlDBCreatePath()也无法在非Etch层Create一个cline的。对于非法操作，函数的返回

值都是nil。

要想让你create的对象立即显示出来有2种方法，运行axlDisplayFlush()命令来刷新allegro的显示状态，或者运行一个allegro本身的命令，否则的话你create的对象是不会被显示出来的。

5.2.1 Path部分的函数

Path指的是各种形状的Line。Path总会有个起点有个终点，axlPathStart函数用于确定起点，而终点则是Path里面的最后一点。 axlPathStart(l_points [f_width]) => r_path,产生一个path对象并确定起点

axlPathArc(Radius/Angle/Center) => 这里的三个函数都是用来生成曲线的 axlPathLine() => 向一个path末尾添加一个点 axlPathGetWidth(r_path) => 得到一个path的宽度，如果一个path中的各个segment的宽度都不一样，可以使用axlPathSegGetWidth()函数。 axlPathSegGetEndPoint(r_pathSeg) => 得到path的最后一个点，相关的函数还有axlPathGetLastPathSeg()用来得到path的最后一个segment。 axlDBCreatePath()和axlDBCreateLine()，将不可见的path或point列表转变成可见的实际存在的 Line，Create在不同的layer，将产生不同的对象，比如在Etch layer将产生Cline对象，在Silkscreen layer就是些简单的Line。

5.2.2 Shape部分函数

Shape是几何图形，所以Create Shape通常需要先提供一个boundry(Shape的边界/区域)，而这通常有2种方式，其一是使用上面讲到的Path函数来Create一个闭合的区域，其二是用Polygon函数来为Shape提供一个Polygon。

5.2.2.1 Polygon相关函数 Polygon是多边形的意思，其实和Shape一样(根据Polygon生成的Shape，所以当然是一样的)，只是Polygon是不可见的，而 Shape是可见的。Polygon的操作函数之所以不并入Shape我想可能是因为每次对Shape形状的改变allegro都会update整个 design的shape，顺便还要update DRC(Shape和On-Line Drc没有disable的情况下)，这都是些很耗时的操作。Polygon的任何操作都不会影响到design，直到当它最后呈现为Shape 时。

axlPolyFromDB(),获得指定对象的Polygon，这是一个非常好用的函数，比如有个形状很怪异的Pad，而你必须根据这个Pad画出个 Shape，这个时候你就可以直接用这个命令直接得到那个Pad的Polygon,然后就可以生产Shape了，很简单。

axlPolyOperation()，Polygon的一些操作，比如多个Polygon以某个规则(AND OR ANDNOT)组合到一起,形成一个/多个新Polygon。

axlPolyExpand()，将Polygon扩展/压缩一定的尺寸

示例: 实现allegro的merge shape的命令 a. 选择需要被merge的Shape b. 使用axlPolyFromDB函数得到每一个Shape的Polygon c. 使用axlPolyOperation函数的"AND"规则，将多个Polygon形成一个 d. 删除选中的所有Shape e. 使用下面将要提到的axlDBCreateShape命令生成新的Shape

5.2.2.2 Shape相关函数 axlDBCreateOpenShape，这个函数是用来Create一个Open状态的Shape的，Open的意思是可以在Create的Shape上再添加Void。

axlDBCreateCloseShape，这个函数是前一个函数的补充，Open状态的shape使用了这个函数就被Close了，Close意思是Shape不可以再添加Void了。

axlDBCreateShape, 这个函数直接Create一个Close的Shape。

5.2.3 和Path无关的函数

axlDBCreateExternalDRC，create一个用户自定义的DRC，通常是在用户自定义的检查中

axlDBCreatePadStack，Create一个新的Padstack，比如你想要用一种新的Via，但是Library中还没，就可以使用该命令Create一个Padstack,然后用axlDBCreateVia命令生成一个

axlDBCreateText，比如前面提到的自动修改字符的操作，这个命令就可以生成指定的字符。

5.2.4 Property函数

axlDBCreatePropDictEntry，在user defined property列表中创建一个新的property类型 axlDBAddProp，将指定的property赋予特定的对象，比如将Fixed Property赋予一个Component，这个和allegro本身的Fixed命令是一样的。

5.3 Database Group

Group比较简单，相关的函数也不是很多。 axlDBCreateGroup，create一个新的Group对象 axlNetClassCreate，

create一个NetClass对象 axlRegionCreate，create一个Region对象

NetClass和Region是16.0以后新的属性

5.4 Database Attachment

这里说到的Attachment是attach到design的database中的。 axlCreateAttachment(t_attachmentId t_passwd

x_revision s_dataFormat t_data ) => Create一个名字/ID是t_attachmentId的attachment，t_password设定密码，

x_revision确定版本，s_dataFormat将决定t_data的数据类型。 axlGetAllAttachmentNames() => 得到design

Database中所有attachment的dbid列表。 axlGetAttachment(t_attachmentId [s_dataFormat]) => 获得指定

attachment的value。

5.5 Database Transaction

这里又有一组比较好用的函数 axlDBTransactionStart() => n_Mark，得到一个mark值可以为其余Mark，Oops，

Rollback，以及Commit命令所用。 axlDBTransactionMark(n_Mark) => 使用n_Mark来标记该命令运行前design

的状态，方便后面的Oops和Rollback操作。 axlDBTransactionOops(n_Mark) => 取消最近一次的

axlDBTransactionMark以来的操作，使得design返回Mark前的状态。和allegro中的Oops命令是相似的。

axlDBTransactionRollback(n_Mark) => 是database Transaction的一次Undo操作，相当于allegro中的Cancel操

作。 axlDBTransactionCommit(n_Mark) => 确定一次transaction的完成，之后n_Mark将不再有效，也即不能再

执行Oops/Rollback操作了。另2个关联的函数： axlTransformObject()，早已经在之前的章节介绍了。

axlDBCloak(g_func [g_mode])，将一些可能会引起shape update或者drc update之类的比较耗时的函数/命令嵌入在

这个命令中运行会比较省时。

另外：举个简单的例子说明为什么这个命令好用。假设你要编写一个实现Symbol横向或者纵向对齐的命令，最简单的

想法就是让用户选择需要移动的Symbol，然后记录下各个Symbol的coordinate，rotation，mirror，name，type等

等参数，对应于Opps或者Cancel操作就是利用之前备份的那一大堆数据来恢复现场。这里涉及一大堆的数据管理，

而且当用户同时选择了n个symbol然后又去掉了部分选择，以及在done掉命令之前有做过几次Opps和几次

transaction，这个数据的管理会很让人伤脑筋。然而通过这里介绍的几个命令，就很简单了，只要在transaction之前

Mark一下(记录现场)，Opps，Cancel之类的操作只是简单的恢复到Mark点就好了，不用管Mark以后用户是怎么个

操作的，是不是很简单？

5.6 Database Miscellaneous

举几个很适用的函数，其它的请自行参考学习了。 axlAirGap()，功能如同allegro中的Measure结果中的Airgap。

axlDBGetLength()，功能如同allegro的Show Element命令选择一个Cline显示长度一样。 axlGeoPointInShape()，

这个命令能检验一个Point是不是在特定的Shape里面。 axlChangeNet()，改变指定对象的net name，不过因为一

些功能方面的限制，其实适用性不强。

allegro skill Parameter操作函数正如在allegro skill database对象类型中提到的，一个PCB Editer设计中会有很多的

Parameter，比如在design级别就有设计的精度，设计的版面尺寸，单位等等。在AXL-Skill中有一系列相应的函数可

以直接读取以及修改这些Parameter值。 2. 1 获取Parameter值的通用函数

2.1.1 获取Parameter值的函数 axlGetParam 函数定义：axlGetParam ( t_parm_name ) =>

o_paramDbid/nil 参数t_parm_name要求：被查询的parameter的名字。这个名字

必须符合如下规则： paramTextBlock:<#> where # is 1-16 (Example:

axlGetParam("paramTextBlock:1"); 默认的block只到16，对于大于16的block，如果系统里面有设定就可以同样得

到，比如说有block 30，就可以这样得到axlGetParam("paramTextBlock:30") ) paramDesign paramDisplay paramLayerGroup: where name is legal Allegro class name paramLayerGroup:/paramLayer: artworkList of film names

artwork: param:107955700(返回一个param类型的dbid, 该dbid包含了design的parameter 信息) axlGetParam("paramLayerGroup:ETCH") => param:107955760(返回的dbid包含系统的ETCH相关信息，比如有几个ETCH层) axlGetParam("paramLayerGroup:ETCH")->?? => (objType "paramLayerGroup" name "ETCH" visible nil nChildren 4 groupMembers ("TOP" "INT1" "INT2" "BOTTOM") color -1)(说明：axlGetParam("paramLayerGroup:ETCH")将得到一个dbid，而->??操作将得到该dbid的所有直接相关属性，objType说明该dbid的对象类型是paramLayerGroup，nChildren=>4表面当前的design有4 个Etch层，groupMembers对应了具体的4个Etch层名字)

axlGetParam("paramLayerGroup:ETCH")->groupMembers => ("TOP" "INT1" "INT2" "BOTTOM")

2.1.2 设置Parameter值的函数 axlSetParam 函数定义：axlSetParam ( o_paramDbid ) =>

o_paramDbid/nil 参数o_paramDbi要求：axlGetParam函数的返回值返回值o_paramDbid：返回值类型和axlGetParam返回的一样使用方法：Originalparam = axlGetParam( "paramDesign")，做一些其它的操作可能涉及到多个系统参数的改变，然后通过axlSetParam(Originalparam)命令来使系统所有的参数设置恢复之前保留的值。（参考后面提到的类型相似的axlVisibleGet和axlVisibleSet函数）

2.2 Color操作函数(部分)

2.2.1 Allegro中的Color Allegro支持2种访问Color的方式，预定义的color和allegro database color。预定义的color有'black，‘'white，'red，'green，'yellow，'blue，'multivalue - use dfor fields where value not the same，'button - current color of button faces (grey)。 database color是以[1-24]之间的整数表示的，0被保留为背景颜色。在2.1.1的示例中，就有看到color值为-1的情况，这表示被查询的元素当前是不可见的。 2.2.2 常用Color相关函数获取Color调色板，

axlColorGet(x_number/'background/'count/'all), 如axlColorGet('all)=>得到系统的颜色设置结构列表。对应设置Color调色板函数，axlColorSet()；系统颜色设定的保存与重载函数，axlColorSave(file)与axlColorLoad(file)；用户定制颜色来设置系统中的元素，axlCustomColorObject([lo_dbid]

[g_custom_color])，相应的清除命令为axlClearObjectCustomColor([lo_dbid])；其它更多的color 相关函数请参考algroskill文档

2.3 Database Layer相关操作函数

这里给出一些方便操作Layer的函数： axlGetXSection()，这是获取design的crosssection(层叠结构)的函数；axlLayerGet(t_layer)，这是获得指定层t_layer的dbid的函数； axlIsLayer(t_layer)，判断指定的层t_layer 存不存在； axlIsVisibleLayer(t_layer)，判断指定层t_layer是不是显示状态(visible)；

axlVisibleLayer(t_layer g_makeVis)，设置指定层t_layer的状态是显示还是不显示；

axlVisibleDesign(g_makeVis)，设置design的状态是显示还是不显示； axlVisibleGet()，该函数的返回值是命令运行当前design的所有颜色显示状态； axlVisibleSet(l_vislist)，该函数使用axlVisibleGet()函数的返回结果，重置design的显示状态。更多相关函数请参考algroskill.pdf文档

2.3 Database Layer相关操作函数

这里给出一些方便操作Layer的函数： axlGetXSection()，这是获取design的crosssection(层叠结构)的函数；axlLayerGet(t_layer)，这是获得指定层t_layer的dbid的函数； axlIsLayer(t_layer)，判断指定的层t_layer 存不存在； axlIsVisibleLayer(t_layer)，判断指定层t_layer是不是显示状态(visible)；

axlVisibleLayer(t_layer g_makeVis)，设置指定层t_layer的状态是显示还是不显示；

axlVisibleDesign(g_makeVis)，设置design的状态是显示还是不显示； axlVisibleGet()，该函数的返回值是命令运行当前design的所有颜色显示状态； axlVisibleSet(l_vislist)，该函数使用axlVisibleGet()函数的返回结果，重置design的显示状态。更多相关函数请参考algroskill.pdf文档

allegro skill Design相关函数a. 用来得到当前design的名字和类型的一些函数axlCurrentDesign() ;得到当前文件的名字axlDesignType(); design的类型，比如Layout axlSaveEnable(); 设置File-Save menuitem是否可用axlSaveDesign(); 保存design axlDBControl(); 这是个很有用的函数，可以设置很多的系统环境，比如设置On-Line DRC enable还是disable，axlDBControl(‘drcEnable t/nil) axlIgnoreFixed(); 如果想操作Fixed的symbol一般是不可以的，但是可以通过这个命令来操作axlKillDesign(); axlOpenDesign(); axlGetActiveLayer();

b. 用来注册一些skill的函数为allegro中的命令，以及设置各种工作模式axlCmdRegister(); register Skill函数为allegro 的命令axlEndSkillMode(); 结束skill状态axlFlushDisplay(); 刷新屏幕axlOKToProceed(); 检测当前是不是有另外的交互式操作命令在运行axlUIPopupDefine();辅助用户定义右键弹出menu

c. Logic操作函数

操作系统的一些Logic类型的信息，比如DiffPair，MatchGroup，pinpair等等 axlDiffPair(); 生成，修改，删除Diffpair axlMatchGroupAdd(); 添加成员到某个MatchGroup axlPinPair(); PinPair操作

另：

axlWriteDeviceFile(); 输出Device信息到相应的文件 axlDbidName(); 得到dbid对应的名字axlDBCreateConceptComponent();

d. Constraint Manager操作函数

所有的Constraint Manager相关的函数都会是以axlCNS开头，如： axlCnsAddVia(); axlCNSCreate(); axlCNSGetPhysical(); axlCNSGetSpacing();

e. Math函数

axlDistance(); 得到2点之间的距离 axlGeoEqual(); 在当前design精度下，比较2个浮点数是否相等axlIsPointInsideBox(); 检查点是不是在Box里面 axl_ol_ol2(); 检查两个线是否相交

allegro skill选择和获取函数对Allegro中的对象进行操作，比如移动、删除，都需要先选择和获取该对象的dbid。选择操作包含一些选择设置比如是只选择Symbol还是Symbol和Via都可以选等等，然后通过axlSelect相关函数来选择具体的对象，然后是axlGetSelSet函数来得到那些被选择的dbid。AXL-Skill函数支持多种选择的方式，比如单选择一个对象，或者是框选多个对象，又或者说是使用Temp Group的方式来选择多个对象，不过通常对象只有在当前可见(Visible)的情况下才可以被选择上(除非设置了invisible选项)。选择设置和被选择了对象的有效性会一直持续到用户使用其它的系统命令，比如allegro的Add Cline命令，因为allegro的命令将会改变一些系统的dbid，所以的Skill之前获取的bdid都会变成无效的(removed)。通常的选择和获取操作如下，

设置Find Filter来控制将要被选则的对象类型；选择对象的三种模式：单选，多选或通过名字来选择；从被选择的对象中添加和移除对象

3.1 Find Filter设置函数

函数定义axlSetFindFilter(?enabled lt_enabled ?onButtons lt_filterOn) 功能：该函数最直观的理解是，它可以设置allegro的Find Filter。参数：lt_enabled，该参数将决定哪些Find Filter中的元素可以被选择；

lt_filterOn，该参数将决定可以被选择的元素中，哪些已经被选中了。参数支持的类型如下："PINS"，"VIAS"，"CLINES"，"CLINESEGS"，"LINES"，"LINESEGS"，"DRCS"，"TEXT"，"SHAPES"，"SHAPESEGS"，"BOUNDARY_SHAPES"，"VOIDS" ，"VOIDSEGS"，"SYMBOLS"，"FIGURES"，"COMPONENTS"，"FUNCTIONS"，"NETS"，"INVISIBLE"，"NAMEFORM"，"ALLTYPES"，"ALL"，

"DYNTHEMALS"，"GROUPS"，"GROUPMEMBERS"

用法示例：axlSetFindFilter( ?enabled list( "vias" "pins" "nets") ?onButtons list( "vias" "pins")) => 设置Find Filter中的vias，pins，nets为可以被选择的，而其它的选项将被设置成不可操作的，默认选择了vias和pins。

3.2 点选函数

axlSingleSelectPoint() => 运行该命令之后，allegro将提示你点选一个design中的对象。 axlAddSelectPoint() axlSubSelectPoint()

3.3 框选函数

axlSingleSelectBox() => 在allegro中框选 axlAddSelectBox() axlSubSelectBox()

3.4 通用选择函数

axlSelect() => 支持多种选择方式于一身，单选，框选，Temp Group

3.5 其它选择函数

axlAddSelectAll() =>不需要用户交互的选择方式，只根据Find Filter的条件 axlSubSelectAll()

axlSingleSelectName() axlAddSelectName() axlSubSelectName() axlSingleSelectObject() axlAddSelectObject() axlSubSelectObject()

3.6 获取和清除函数

axlGetSelSet() => 获取之前的选择函数选择的dbid axlGetSelSetCount() axlClearSelSet() => 清除之

前选择函数选择的dbid(注：当一个对象被选择了以后，将会被自动的以Temp Highlight的方式高亮，而该函数运行以

后将会清除这个对象的选择状态，同时该对象也不再高亮)

3.7 示例：选择一个Symbol，并将其移动到另一个相对位置

axlClearSelSet() ; 清除之前可能存在的被选择函数选择的元素，避免引入不合适的dbid，这是个好习惯

axlSetFindFilter(?enabled '("noall" "symbols" ) ?onButtons '("noall" "symbols" )); 设置Find Filter的Symbols

选项处于选中状态 axlSingleSelectPoint(); 请通过点击选择的方式，选择一个Symbol对象 dSym =

axlGetSelSet(); => (dbid)，将得到被选择的dbid列表，尽管这个列表只有一个元素 axlClearSelSet(); 清理掉

你自己做过的选择，避免给别的程序带来错误，同样是个好习惯 dSym = car(dSym); => dbid，的到Symbol的

dbid ;dSym->?? ;=> 将得到这个Symbol的相关属性 ix = 100; iy = 200;

axlTransformObject(dSym, ?move ix:iy); =>将该Symbol右移100mil，上移200mil ; axlTransformObject() 函

数的作用是将一个或多个symbol由一个地方移动、翻转、旋转到另一个新的位置。 ; axlTransformObject( ; lo_dbid/o_dbid ; ?move l_deltaPoint ; ?mirror

t/nil ; ?angle f_angle ; ?origin

l_rotatePoint ; ?allOrNone t/nil )

skill交互函数axlUI系列集锦Interface指和用户交互，allegro给出一些Message提醒用户进行相关的操作，比如说

Pick a Point就是让用户用鼠标选择一个点；又比如说allegro弹出一个Confirm对话框，需要用户选择Yes/No的情况。

在allegro的skill窗口输入_lfn("axlUI")一般会查到如下的函数：axlUICmdPopupSet axlUIColorDialog axlUIConfirm

axlUIControl axlUIDataBrowse axlUIEditFile axlUIGetUserData axlUIMenuDump axlUIMenuLoad axlUIMultipleChoice axlUIPopupDefine axlUIPopupSet axlUIPrompt axlUIViewFileCreate axlUIViewFileReuse axlUIViewFileScrollTo

axlUIWBeep axlUIWBlock axlUIWClose axlUIWDisableQuit axlUIWExpose axlUIWExposeByName axlUIWPerm

axlUIWPrint axlUIWRedraw axlUIWSetHelpTag axlUIWSetParent axlUIWShow axlUIWTimerAdd

axlUIWTimerRemove axlUIWUpdate axlUIYesNo axlUIYesNoCancel 这里介绍一下其中几个很常用的函数的用法

axlUIConfirm => axlUIConfirm("are you sure to delete all highlight shapes?") axlUIYesNoCancel =>

axlUIYesNoCancel("are you sure to delete all highlight shapes?" "Delete Shape Command") axlUIYesNo =>

axlUIYesNo("are you sure to delete all highlight shapes?" "Delete Shape Command") axlUIMultipleChoice =>

axlUIMultipleChoice("Pick a layer" '("top" "bottom" ) "View Layer") axlUIPrompt =>axlUIPrompt( "Enter Your Name"

"user name" )

前3个差不多，但是axlUIConfirm只是个提醒，返回值总是t，另外两个返回值是数字0=>Yes, 1=>No, 2=>Cancel。axlUIMultipleChoice的返回值也是数字，0对于这个函数中间那个列表的第一个参数，顺序下来。axlUIPrompt这个函数提供了用户输入信息的功能，返回值为字符串，如果你想要数字，需要自行转换，atoi/atof之类。axlUIPrompt示例

最后还有一个axlUIWBeep()，就是一个beep提示音axlUIWDisableQuit => axlUIWDisableQuit(userDefinedForm) ;屏蔽掉form右上角的那个close叉叉axlUIWClose => axlUIWClose(userDefinedForm); 关闭掉form axlUIWShow => axlUIWShow(userDefinedForm option); option 'show =>显示并激活userDefinedForm; 'showna 显示但不激活; 'hide

窗口隐藏; nil 显示支持的操作axlUIWPrint => axlUIWPrint(userDefinedForm "this is a pretty form"); 输出字符到form 的最下面窗口axlUIWPerm => axlUIWPerm(userDefinedForm t); allegro打开新的板子会默认关闭掉当前打开的所以

的form窗口，用这个命令可以屏蔽这个功能axlUIWBlock => axlUIWBlock(userDefinedForm);强制用户操作了当前的form才可以继续其它的工作axlUIWRedraw axlUIWUpdate => axlUIWUpdate(nil)这个和axlUIWRedraw(nil)更适合刷新主屏幕axlUIWExpose axlUIWExposeByName=>这2个都是将选择的窗口显示到最前端

axlUIDataBrowse axlUIColorDialog 这2个函数调用allegro系列的form，挺有用的。参考algroskill.pdf中的例子：axlUIDataBrowse('NET '(RETRIEVE_NAME) "hi" t) rgb = axlColorGet(1) rgb = axlUIColorDialog(nil rgb) when( rgb axlColorSet(1 rgb) ) 这里的1可以是其它的数字，16.0以上可以到192。

axlUIMenuDump=>axlUIMenuDump("CurrentMenu") 输出当前allegro的menu信息到当前工作目录的CurrentMenu.men文件axlUIMenuLoad=>axlUIMenuLoad("menu.men") load menu.men的信息到allegro中建立新的目录很实用的2个功能

鼠标右键的popup menu：axlUIPopupDefine axlUIPopupSet procedure( aa println("I- you select A")) procedure( bb println("I- you select B")) pop=axlUIPopupDefine( nil '(

("A" aa) ("B" bb) ) ) axlUIPopupSet( pop ) 运行了上面的程序以后在allegro中单击鼠标右键就会看到一个popup，就像我们常见的Done，Cancel，Opps那个popup，只是这里的是A和B。axlUIPopupSet( nil ) 这个命令来将刚刚的设置清除axlUIViewFileCreate axlUIViewFileReuse axlUIViewFileScrollTo 只读方式打开文件，没怎么用过，也觉得没有啥用处。还剩下几个除了Time可能有些作用，其它的没有没有什么感觉。axlUIWTimerAdd axlUIWTimerRemove axlUIControl do not use axlUIEditFile axlUIGetUserData axlUIWSetHelpTag axlUIWSetParent

allegro skill 交互式编辑函数这里介绍一些基本的编辑命令，比如axlDeleteObject用来删除可被删除的系统对象(各种dbid)，axlShowObject用来显示被选择对象的信息，和allegro中的Show Element命令显示的结果差不多。常用函数示例：

axlChangeWidth(); => 和Allegro中的Change命令类似，该命令用来改变Cline/Line的宽度 axlDBDeleteProp(); => 该命令可以删除选择对象的指定属性，使用该命令相当于Allegro中Edit Property命令。axlDBDeletePropDictEntry(); =>该命令相当于Allegro中的User Defined Property命令 axlLastPick(); => 获得用户鼠标最近一次点击的坐标 axlShapeChangeDynamicType(); =>改变选择Shape的动静态属性axlTransformObject(); =>移动对象

另外：

axlEnterPoint() ; 提示用户输入一个点的坐标 axlEnterString() ; 提示用户输入一个字符串axlCancelEnterFun(); 取消一个提示Enter操作的函数的作用

还有一些比如

axlHighlightObject(); highlight对象 axlMiniStatusLoad(); 这个函数可以让用户定义的form显示在Options Tab上。

allegro skill File操作allegro有些专用的函数可以操作文件，allegro本身支持skill的那些文件操作函数，比如infile，outfile函数，而如下的函数都只是更多的文件操作函数：axlDMOpenFile(); axlDMOpenLog(); axlDMClose();

axlOSFileCopy(); axlOSFileMove(); axlOSSlash(); axlTempDirectory(); allegro skill Shell操作相关函数这里的函数可以用来读取Allegro PCB Editor的环境参数，比如Alias，FuncKey以及一些系统的参数(.psmpath)。比如：axlGetAlias() axlGetFuncKey() axlGetVariable() axlSetAlias() axlSetFunckey() axlUnsetVariable()

另外：axlShell()，这个命令很有用，它支持在skill环境中运行allegro的命令，比如allegro的status命令，在skill状态下是不可以直接运行的，需要通过axlShell("status")来运行。

另：设置和获得windows/UNIX系统下的环境变量setShellEnvVar() getShellEnvVar()

allegro skill Form操作allegro有很多的form，比如artwork，比如status，还有些在Options Tab上显示的如change 命令的form...... 能自己创建一些form会很有意思，也很有用。a. form的基本元素示例：下面是一个简单的form，包含2个Text，2个可以输入数据的Field，1个复选框checkbox，2个按钮Button。FILE_TYPE=FORM_DEFN VERSION=2 FORM FIXED PORT 30 12 HEADER "Hello You!" TILE

TEXT "Your Name:" TLOC 4 1 ENDTEXT

FIELD user_name FLOC 16 1 STRFILLIN 8 15 ENDFIELD

TEXT "Your age:" TLOC 4 3 ENDTEXT

FIELD user_age FLOC 16 3 REALFILLIN 4 6 DECIMAL 4 ENDFIELD

FIELD MarriedCheck FLOC 4 6 CHECKLIST "Married?" ENDFIELD

FIELD RunCheck FLOC 4 9 MENUBUTTON "Result" 8 3 ENDFIELD

FIELD CloseForm FLOC 16 9 MENUBUTTON "Close" 8 3 ENDFIELD

ENDTILE ENDFORM

a. form的基本元素form的define信息一般保存在一个.form的文件中，文件的开头一般都是

FILE_TYPE=FORM_DEFN VERSION=2。正式的form信息从FORM关键字开始，以ENDFORM结束。最常用的form 元素有FIELD，TEXT，BUTTON。其它常用的还有Checkbox，Radiobox，Group。在Form中定义一个item，一般是Text和Field，Field包含除Text以外的所有类型，先确定是Text还是Field，然后是相对位置Location，然后是具体的类型，最后结束这个Item的定义，比如：TEXT "Your age:" ;Text，且显示的是Your age

TLOC 4 3 ; 位置为Form的（4 3） ENDTEXT ; 结束这个Text的定义

b. 创建一个简单的Form 当你创建了一个Form文件，接下来要把它在Allegro中显示出来。假设我们把刚刚提到的那个Form保存到C:/temp名叫user.form的文件中，用下面的axlFormCreate函数来在Allegro中创建并用axlFormDisplay函数显示出来。user_Form = axlFormCreate((gensym) “c:/temp/user.form" '(e inner) 'user_callback t ) axlFormDisplay(user_Form) 这里的user_callback是个函数，是对应现在创建的user_Form对应的用户操作的响应，比如用户点击了一个按钮，就会有些相应的操作。还有些函数可以用来设置Form中一些Field，设置默认值，比如axlFormSetField(user_Form "user_age" 24)；以及获取Form中Field的值，比如axlFormGetField(user_Form "user_age" )；＝>24

b. 创建一个简单的Form之call back函数Form显示出来对应的是种前台操作，而响应用户相应的操作则可以称之为后台操作。创建一个Form的时候都会有个call back函数assign给它。call back函数里面包含了对应各个Field的操作命令。比如：procedure( user_callback( user_Form )

case( user_Form->curField ;curField 将得到当前用户操作的Field名字

( "user_name" axlMsgPut( sprintf( nil "current user name %s" user_Form->

curValue ) ) ; curValue 将得到当前Field的值 ); ( "user_age" axlMsgPut( sprintf( nil "current user age %d" user_Form->

curValue ) ) ) ( "MarriedCheck" ; do

something ) ( "RunCheck" sMsg = axlFormGetField( user_Form

"user_name" ) axlUIConfirm(sprintf(nil "Hello %s, Good Day!" sMsg)) ) ( "CloseForm" axlFormClose( user_Form ) ) )

)

c. 创建一个Grid Form Grid比较适合制作表格形式的Form，比如假设我们想做个Form来显示当前工作文件夹下面的

所有文件，用Grid就会比较合适，定义一个三列的表格，第一列显示第几个文件，第二列显示文件名，第三列显示文

件大小，而这用一般的Form形式来实现会比较麻烦。比如把下面这段Grid信息加入到一般的form定义文件中，就会

支持Grid的相关操作："GRID crsGrid" "FLOC 2 1" "FSIZE 42 27" "OPTIONS HLINES VLINES USERSIZE"

"GHEAD TOP" "HEADSIZE 3" "OPTIONS 3D MULTI" "ENDGHEAD"

"GHEAD SIDE" "OPTIONS 3D NUMBER" "HEADSIZE 5" "ENDGHEAD"

"ENDGRID" 如下的代码则会帮助你设置这个Grid空间，比如这里设置了3列，每列各代表一些意思。tGridCol =

make_formGridCol() tGridCol->fieldType = 'LONG tGridCol->colWidth = 2 tGridCol->align = 'center

tGridCol->headText = "Count" tGridCol->scriptLabel = nil axlFormGridInsertCol( user_form "crsGrid" tGridCol )

tGridCol->fieldType = 'TEXT tGridCol->colWidth = 8 tGridCol->headText = "File Name" tGridCol->align = 'left

tGridCol->scriptLabel = nil axlFormGridInsertCol( user_form "crsGrid" tGridCol )

tGridCol->fieldType = 'LONG tGridCol->colWidth = 2 tGridCol->align = 'center tGridCol->fieldLength = 4 tGridCol->min

= 1 tGridCol->max = 10 tGridCol->headText = "Size" axlFormGridInsertCol( user_form "crsGrid" tGridCol ) 相应的

form操作函数也包含了Grid关键字，如axlFormGridUpdate，axlFormGridOptions...

allegro skill ipc ipc是Interprocess Communication的缩写，ipc使得skill对创建其它非skill进程和与之通信成为可能。

比如如果一个skill工具要求比较复杂的界面，而这个界面用skill来完成会很麻烦，这样就可以试着用其它的语言(java)

写出要求的界面并生成可执行文件(jar)，用ipc相关的函数来调用这个可执行文件，并传递相关的参数，用户在该界面

上做的任何操作也会有相应的函数读回并执行。ipc的功能极大的方便了用户做开发。

父进程通过ipc和子进程通信1. 如何通信父进程通过子进程的stdin将信息传递给子进程，从子进程的stdout和stderr

读取返回信息。e.g. 一个简单的perl程序＃! /usr/bin/perl -w print $ARGV[0]; getinfo; sub getinfo {

return $ARGV[1];

} 如果用ipcBeginProcess调用这个简单程序，这个程序运行以后，ipcReadProcess读到的返回值将会是print输出的

值。

2. 同步，异步读取子进程返回信息同步读取会屏蔽当前操作直到读取完成，异步读取会等到数据和父进程中处理函数都

准备好的时候发生，不会屏蔽别的程序运行。 3. 数据缓存一般的标准输入输出通道有4096byte的缓存区，通常子进

程在将数据写入输出通道后推荐刷新该端口使得父进程可以顺利读到这些输出。 4. 子进程的属性子进程通常有如下的

只读属性, 和其它的skill对象一样可以通过"->"来读取。command Name of the command host Name of the host

machine running the process processPid Process id of the child process on host exitStatus Exit status of the child

process priority Priority given to the child process type Begin, Skill, or Batch process state Active, Dead, or Stopped

5. 几个主要的ipc函数5.1 ipcBeginProcess 5.2 ipcSkillProcess 5.3 ipcWaitForProcess 5.4 ipcReadProcess 5.5 ipcWriteProcess 5.6 ipcIsActiveProcess 5.7 ipcIsAliveProcess 5.1 ipcBeginProcess 该函数用来调用别的程序并返回

子进程，函数定义如下：ipcBeginProcess(

t_command [ t_hostName ] [ tsu_dataHandler ] [ tsu_errHandler ] [ tsu_postFunc ]

[ t_logFile ] )

=> o_childId 参数解释，

t_command=> 要执行的程序/命令，比如linux里面的命令date； t_hostName=>被调用的命令执行的环境，null

也就是“”表示在本地执行； tsu_dataHandler/errHandle/postFunc=>这3个参数用来处理子进程的输出，如果设置了相应的处理函数就是异步读取方式，这种方式会自动读取子进程的返回值，如果没有设置则是同步读取方式，这种方式下就必须显式的用命令 (ipcReadProcess,ipcIsActiveProcess...)来读取子进程的输出值或者状态；

t_logfile=>用来记录所有的子程序的输出信息。

示例：

同步读取 cid = ipcBeginProcess("date") => ipc:0 ;子进程0 ipcReadProcess(cid) =>"Tue Aug 1 14:23:07 PDT 1995\n" ; 显式的读取子进程的输出值

异步读取 handler = (lambda (cid data) printf("\n Date:%s\n" data))=>funobj:0x2848e8 ;定义输入数据处理函

数 cid = ipcBeginProcess("date" "" handler)=>ipc:0 ；handler会自动处理子进程的输出数值 Date: Tue Aug 1 14:29:17 PDT 1995

5.2 ipcSkillProcess 这个函数类似于ipcBeginProcess, 只是增加了对子进程可以在父进程中执行skill命令的能力，以

及设置了2个专门的通道方便子进程输出skill命令到父进程执行并读取执行的结果。函数定义：ipcSkillProcess(

t_command [ t_hostName ] [ tsu_dataHandler ] [ tsu_errHandler ] [ tsu_postFunc ] [ t_logFile ] [ x_cmdDesc ] [ x_resDesc ] )

=> o_childId 参数解释:

x_cmdDesc=> skill命令输出通道，默认为3 x_resDesc=> skill运行结果接受通道，默认为4

示例请参考ipc文档P44.

5.3 ipcWaitForProcess 父进程调用子进程的时候，可能由于系统的延时子进程不能即刻就执行，考虑到这样的一个延

时用ipcWaitForProcess就可以挂起父进程直到子进程运行起来。函数定义：ipcWaitForProcess(

o_childId [ x_timeOut ] )

=> t 参数说明:

o_childId=> 子进程的ID x_timeOut=>等待的时间

5.4 ipcReadProcess 5.5 ipcWriteProcess 这2个是对子进程的读取和写入函数，具体内容参考ipc手册。5.6 ipcIsActiveProcess 5.7 ipcIsAliveProcess 检查一个子进程是不是还有效，类似于查看子进程的state属性

dicusss：和VB通信，2种情况，一种是调用VB编写成的可执行程序，这种很简单，就是ipc调用该程序加上适当

的参数，就好了。另一种是和VB编写的程序交互，这样就需要既输出数据给VB的程序，也要从VB那边读相应的返

回结果。主要涉及ipcBeginProcess和ipcSkillProcess这2个函数