AutoCAD图块实体几何信息的提取

AutoCAD图块实体几何信息的提取
刘贤喜
中国农业大学(100083)
摘要
本文介绍了在不“炸开（EXPLODE）”AutoCAD图块的前提下，利用ADS和C语言
直接访问AutoCAD图形数据库的结果缓冲器，提取或处理图块内部所含全部子实体几何信息
的方法。

关键词 AutoCAD图块几何信息提取 ADS接口 DXF码
1 问题的提出
AutoCAD是优秀的计算机辅助设计软件，不但具有友好的交互绘图功能，而且提供了强大的二次开发工具，如ADS、ARX等。

但在AutoCAD交互绘图环境中，对插入其中的图形块只作为一个整体来处理，仅直接提供其插入点的坐标值、比例因子和旋转角度等有限的几何信息，而不能直接提供图形块内部所有子实体的几何信息；若要对图块进行编辑修改，首先要用“EXPLODE”命令将图块分解为若干相互独立的几何实体。

我们在开发“饲料加工工艺设计专家系统（FPES）”时，用图块来表示饲料加工设备图形符号，为了让计算机能够在AutoCAD环境下自动生成饲料加工工艺流程图，不仅要识别图块所表示的加工设备，还要处理图块的外轮廓，以便于自动确定设备位置。

如果用“EXPLODE”命令将设备图块炸开，则就不再具有设备图形符号的含义了，计算机也就无法对设备进行智能处理。

为此我们利用ADS开发了一个智能模块，能够在不炸开图块的前提下，自动获取图块内部所含全部子实体几何信息的，提高 AutoCAD对图块的智能处理能力。

2 实现原理
DXF（Drawing Exchang File）码是CAD领域的工业标准之一，在计算机内存中，可以把DXF看成是AutoCAD将当前图形数据库的ASCII码映像。

在AutoCAD图形数据库中实体类型(Entity)是预先定义的图形元素，如点(POINT)、直线(LINE)、圆(CIRCLE)、插入的块(INSERT)等。

实体名(Entity Name)用一个长整数表示，实际上是指向AutoCAD当前图形数据库的指针，通过这个指针，可以找到该实体在当前图形数据库中的记录。

结果缓冲器是ADS支撑环境的核心概念之一。

一个结果缓冲器被用来代表AutoCAD的实体和各种表（BLOCK、LTYPE、VIEW、LAYER、
STYLE等）的数据信息，这些数据信息在结果缓冲器中都被映象为DXF组码与组值。

结
果缓冲器
在ADS中是这样定义的：
union ads_u_val { //不同数据类型的联合
ads_real rreal;
ads_real rpoint[3];
short rint;
char *rstring;
long rlname[2];
long rlong;
struct ads_binary rbinary;
};
struct rebuf { //结果缓冲器的结构
struct rebuf *rbnext;
short restype;
union ads_u_val resval;
};
在AutoCAD当前数据库中，首先获取一个实体，并该得到实体的结果缓冲器，当DXF 组码为0
时，其组值为实体类型，即：LINE、CIRCLE、ARC、PLINE、INSERT等；当DXF 组码为2时，其组
值为图块名称；当DXF组码为10时，其组值根据实体类型的不同而表示不同的含义，可以是
LINE的起点坐标，或是CIRCLE或ARC的中心坐标等。

当不同内容的结果缓冲器链接成一个链表时，它们就可以用来表示AutoCAD的图形实体和表记
录了。

如：一个锤片粉碎机图形符号的块名为“CF”，其插入块的结果缓冲器表的结构如图1
所示：
由于所有图块的定义信息(包括几何信息）都以DXF组码与组值的形式存放在一个“BLOCK”符
号表中，所以在AutoCAD的“BLOCK”符号表中检索指定的图块名，就可得到该图块全部定义信
息的存储首地址，并将其作为一个结果缓冲器链表。

在循环遍历该结果缓冲器链表的过程中，
通过DXF组码与组值，来判别块内子实体的类型，并提取有关几何信息。

3 程序流程图
流程图如图2所示。

要获得一个图块的全部几何信息，首先要在AutoCAD当前图形数据库中确定
一个实体（可以人为指定或程序自动获取），接下来，根据其DXF组码与组值，判断该实体是
否为插入图块，当DXF码为0时，若DXF组值不是“INSERT”，该实体则不是图块，程序返回；
若DXF组值为“INSERT”，则是图块，程序继续进行，当DXF组码为2时，其组值便为该图块的
块名。

然后，在AutoCAD的“BLOCK”符号表中检索该块名，从而获得该图块信息链表的头指
针，并遍历该链表，再根据链表中的不同DXF组码与组值确定块内子实体的不同类型，并提取
的相关几何信息，如：起点、终点、圆心、半径、多义线的顶点、圆弧的起角、终角等等。

注
意，由于块内的坐标值都是相对于块实体自身的实体坐标系(ECS)的值，所以，求得有关几何
信息后，还要根据AutoCAD当前绘图环境中的坐标系、插入图块的插入点、X、Y方向的比例以
及旋转角度等，对块内几何信息进行相关的平移变换、比例变换或旋转变换等坐标变换，直到
该链表的标尾。

这样，便达到了不“炸开”图块就可获取其内部全部几何信息的目的。

程序是
用C语言和ADS函数在Windows环境下编写的（源程序从略）。

4 结论
利用上述方法开发的图形智能化处理模块，在“饲料加工工艺流程设计专家系统（FPES）”中
收到较好的效果。

FPES在利用知识库中的知识和规则进行饲料加工工艺设计的同时，调用模块
对设备图形符号进行智能处理，并自动生成设备布局合理的、符合有关标准的饲料加工工艺流
程图。

参考文
献
1.刘贤喜．面向对象的饲料加工工艺设计专家系统的研究：[学位论文]．北京：中国农业
大学，1998
2.刘贤喜，陈忠良，李晓民．饲料加工工艺设计专家系统的设计．中国农业大学学报， 1998，3(4)：47～50
3.方铁．AutoCAD
C语言高级编程．北京：清华大学出版社，1995年1月．
通讯地址：北京
中国农业大学东区213信箱，邮编：100083，联系人：刘贤喜
电话：62392859
3.8 在AutoCAD中选择实体
1. ads_name[在AutoCAD 2000中仍为此名]、acdbNameSet()[ads_name_set()]、acdbNameEqual()[ads_name_equal()]、acdbNameClear()[ads_name_clear()]、acdbNameNil()[ads_name_nil()]
在ADS、ADSRX或ObjectARX中，选择实体的方法没有变化，但在ObjectARX 2000中改变了一些函数名(其他函数名没有改变，对于第6章讨论的数据类型和DCL对话框也基本是这样的)。

我们介绍一种新的数据类型：ads_name。

这种类型数据用来保存成功选择实体的结果。

通常，选择实体是为了用户能获得并修改实体特性。

这里是老式的ADS和现代的API ObjectARX 完全不同的地方。

在讨论ADS和ObjectARX在获得实体数据方面的差别之前，先来看一看ads_name的定义。

ads_name数据类型是一个具有两个long型元素的数组，因此不能使用赋值操作符使一个ads_name对象等于另一个ads_name对象。

这种情形类似于前文的ads_point数据类型。

正如ads_point数据类型一样，AutoCAD提供了一个名为acdbNameSet()的宏，用来使一个ads_name对象等于另一个ads_name对象。

ADS/ADSRX提供了许多宏来处理ads_name对象。

要使一个ads_name对象等于另一个ads_name对象，可以用acdbNameSet()宏。

要判断两个ads_name对象是否相等，可以用acdbNameEqual()宏。

要把一个空值(NULL)赋给一个ads_name对象，可以用acdbNameClear()宏。

要测试一个ads_name对象的值是否有效，可以用acdbNameNil()宏。

下面为一段代码实例：
2. acedEntSel()[ads_entsel()]、acdbEntGet()[ads_entget()]、acdbEntMod()[ads_entmod()]、acdbEntUpd()[ads_entupd()]
请牢记选择集也是ads_name对象(我知道这可能引起不小的混淆)。

我们很快就会讨论选择集。

前文谈到ADS和ObjectARX在获得和更改实体数据的方法上
是完全不同的，在后面的章节中我们将讨论ObjectARX的方法。

在ADSRX中，使用acdbEntGet()函数获得实体数据，使用acdbEntMod()和acdbEntUpd()函数修改和更新实体。

下面是这些函数的定义：
用acedEntSel()函数选择的实体将和ads_name对象相关联。

在详细讨论acedEntSel()函数之前，先要谈一下acdbEntGet()、acdbEntMod()和acdbEntUpd()函数。

acdbEntGet()函数返回一个结果缓冲区的单链表。

使用resbuf对象的rbnext字段可以遍历和检测结果缓冲区链表。

若rb为一个res buf结果缓冲区，则语法如下：
之后还可以改变某些结果缓冲区中的值，当最终完成后调用acdbEntMod()函数修改实体的内部数据。

正如所见，该函数要求一个resbuf 对象。

如果正在处理一个如块或多段线一样的复杂对象，可以使用acdbEntUpd()函数来观察由各个acdbEntMod()函数调用所做的修改效果。

从本质上讲，使用ADSRX就是处理结果缓冲区链表。

ObjectARX的方法与此是完全不同的，且差别巨大。

对于有大量旧数据的用户，由于有ADSRX，这些函数在ObjectARX中仍然可以使用(Autodesk公司的人把ADS放进了ObjectARX)。

由于本书是讨论ObjectARX，因此，关于acdbEntGet()、acdbEntMod()和
acdbEntUpd()函数的讨论就到此为止。

现在回到acedEntSel()函数，因为该函数在ObjectARX中仍然得到广泛应用。

再一次把acedEntSel()函数的定义说明如下：
acedEntSel()函数暂停运行等待用户输入，并在entres中返回实体名，在ptres中返回选择实体使用的点。

参数str指定acedEntSel()函数暂停前显示的字符串。

参数str是可选的，如果是NULL，AutoCAD显示缺省提示“Select objects:”。

当用户指定一个复杂实体响应acedEntSel()函数时
，则返回多段线或块的标题。

如果acedEntSel()函数调用成功，则返回RTNORM，失败则返回RTERROR，如果用户取消(按Esc键)则返回RTCAN。

acedEntSel()函数可以和acedInitGet()函数结合使用，如前面实例代码段所示。

acedEntSel()函数在ObjectARX中是怎样使用的呢？AutoCAD把图形作为数据库来处理。

在每个打开的AutoCAD图形中的每一个实体都有一个唯一的AutoCAD数据库对象ID与之关联。

通过其对象的ID号我们可以打开AutoCAD
实体，确定要处理什么类型的实体。

然后我们可以使用实体的获得和设
置方法(函数)来操作实体。

一旦有了一个ads_name对象，我们就能得到关联的AutoCAD数据库对象ID(数据类型为AcDbObjectId)。

下面就是得到一个AutoCAD数据库对象ID的函数定义：
ads_name对象是使用acedEntSel()函数选择实体成功的结果。

下面是一段使用acedEntSel()函数的ObjectARX代码：
该函数用pEnt返回AcDbEntity指针，注意是怎样用acedEntSel()函数选择AutoCAD实体的。

3. acdbEntLast()[ads_entlast()]、acedNEntSel()[ads_nentsel()]、acedNEntSelP()[ads_nentselp()]
在ADS中还有几个其他的实体选择函数：acdbEntLast()、acedNEntSel()和acedNEntSelP()。

先看一下acdbEntLast()函数。

AutoCAD始终知道最近生成的一个实体，该实体可以通过acdbEntLast()函数找到。

acdbEntLast()函数的定义如下：
acdbEntLast()函数在图形中找出最近的实体，并把图形数据库中最近的(未删除的)主实体名存入result。

即使最近的实体在屏幕之外或在冻结的层上也能选到。

最近的实体是指最近创建的实体，所以acdbEntLast()函数可用于获得刚加进AutoCAD数据库中实体的实体名。

如果acdbEntLast(
)函数调用成功，返回RTNORM，否则返回RTERROR。

对于块和多段线复杂实体，ADS函数acedNEntSel()和acedNEntSelP()(代表嵌套的实体选择)将选择属性(假定选择了块实体，且块的属性已定义)和顶点信息(假定选择了多段线)。

与acedNEntSel()函数相比，Autodesk推荐使用acedNEntSelP()函数。

acedNEntSelP()函数比acedNEntSel()函
数增加了更新的内容，所以我们只讨论acedNEntSelP()函数。

下面是acedNEntSelP()函数的定义：
这是一个带有许多参数的复杂函数。

acedNEntSelP()函数暂停运行等待用户输入，并传回一个实体名(存入entres)和一个用于选择实体的点(存入ptres)。

参数pickflag的值为FALSE或TRUE，用于指定acedNEntSelP()函数是否可以人机交互(即允许用户选择与输入点对应的点)。

如果pickfla
g的值为FALSE，acedNEntSelP()函数提示用户指定实体，参数ptres的初始值被忽略了。

如果pickflag的值为TRUE，ptres的初始值被用于选择实体。

我几乎未使用过pickflag为TRUE。

如果需要其他参数的说明，请参阅ADSRX文档。

如果str为NULL，AutoCAD就用标准的“Select objects:|”
提示。

我最感兴趣的参数是entres，其中存放一个顶点或一个属性。

3.9 应用程序实例CH3_1要点的进一步分析
在应用程序实例CH3_1.ARX中，就在创建第一个圆之后使用了acedGetXXX()类函数。

现在再来看一看这些函数。

在while循环中，我们询问用户是否需要再画一个圆。

只要用户不回答“No”，就会不断地要求用户画圆。

让我们来观察一下while循环的前两行：
acedInitGet()函数中的关键字表是“Yes No”，第一个参数是NULL，所以我们能够接受空输入。

我们本可以使用RSG_NONULL迫使用户打入“Y”或“N”。

在一般情况下，AutoCAD的缺省选项用尖括号表示，这里是<Yes>。

如果用户输入“Y”，字符串kw的值将为“Yes”。

如果用户输入“N
”，kw的值将为“No”。

然而，如果用户只按Enter键，kw将为一空串。

这种情形由switch语句的RTNONE case处理，把“Yes”复制到kw缓冲区。

记住acedInitGet()函数只适用于紧跟其后的acedGetXXX()类函数。

再次运行该应用程序时，试着输入一些不是“Y”或“N”的字母，看看会发
生什么。

你会重复地得到提示直至按下Y、N或Enter键。

如果用户要再画圆，程序就进入if语句的else分支，并要求用户选择圆心，如下面的代码所示：
这里，我们使用RSG_NONULL调用acedInitGet()函数，因为我们要用户选择一个圆心。

在下一句的acedGetPoint()函数调用中，注意第一个参数是NULL。

记住在acedGetPoint()函数中，第一个参数可以用作选点的参考点。

这是第一个点，所以我们使用NULL。

当要求选择圆心时试着按Enter
键，会重新提示选择圆心。

当输入圆半径时，我们使用acedGetDist函数替代acedGetPoint()函数，因为acedGetDist函数的响应允许我们选择一个点或从键盘输入一个距离值。

下面是使用acedGetDist()函数的代码：
注意我们怎样用RSG_NONULL、RSG_NOZERO和RSG_NONEG的组合来调用acedInitGet()函数。

这是因为我们要使用跟在acedInitGet()函数设置之后的acedGetDist()函数。

acedGetDist()函数中的第一个参数是cp，这是我们前面选定的点。

从点cp开始会画出一条橡皮筋线。

当用户选定第二点后
，从点cp到第二点之间的距离被存入变量rad，这是一个ads_real数据类型的变量。

然而，用户还可用键盘敲入数值。

我们不允许零和负数输入，这就是为什么在调用acedInitGet()函数时还包括RSG_NOZERO和RSG_NONEG的原因。

在用户定义的带有一个ads_name类型参数的printEntInfo()函数中，我们调用acdbEntGet()函数检索结果缓冲区链表。

如果调用成功，结果缓冲区链表会包含实体的数据结构，如下列代码段所示：
我们使用rbEnt->rbnext字段来遍历链表，并检测rbEnt->restype字段的值，这一字段表示存储在rbEnt->resval字段中的数据类型。

3.10 选择集
一个选择集就是AutoCAD当前图形中的一组实体，通过名字加以引用，在这里是一个ads_name对象。

选择集非常类似于AutoCAD实体的“组(group)”。

一旦拥有一个选择集，就可以确定组成选择集的实体数量(也称为选择集长度引用)。

既然我们知道了选择集的长度，我们就可以使用循环机
制遍历选择集中的每个实体，并读取和修改实体。

一个实体在一个选择集中只能表示一次，然而一个实体可以属于多个选择集。

如果我们有一个选择集ss1，并希望向选择集中添加一条直线实体，我们可以手工选择直线实体。

按规则我们可以多次选择直线实体，但在选择集中多次选择的实
体只表示一次。

假定我们现在创建第二个选择集ss2，并选择同一条直线实体，那么该实体就被加到第二个选择集中。

现在直线实体出现在ss1和ss2两个选择集中，但在每一个选择集中直线实体只表达一次。

选择集是实体的有名集合，选择集中的实体由AutoCAD用户手工选择或依据实体特性加入。

依据特性选择实体，如选择“parts”层上半径小于0.25的所有圆，这允许我们把它们的半径改为0.375。

选择集甚至可以选择被冻结的图层上的实体。

选择集也可以是空的—它只是存放AutoCAD实体
的一个容器，就像放糖果的纸袋一样，如果你没有在里面放糖果或者你已把它们全部吃光，纸袋就空了。

表3-6列出了处理选择集的ADS函数。

表3-6 ADS的选择集函数
选择集函数说明等效的AutoLISP函数
acedSSGet() 选择要加到选择集中的实体ssget
acedSSLength() 返回指定选择集的长度sslength
acedSSAdd() 添加实体到已有选择集或新建一空选择集ssadd
acedSSDel() 从已有选择集中删除实体ssdel
acedSSName() 在选择集中检索出实体的ads_name ssname
acedSSMemb() 测试某实体是否为选择集的成员ssmemb
acedSSFree() 释放选择集—
1. acedSSGet()[ads_ssget()]
选择集是ads_name对象，为了把实体加入到指定的选择集，必须使用acedSSGet()函数选择实体，或者假如预先知道实体名，则可使用acedSSAdd()函数。

下面是acedSSGet()函数的定义：
acedSSGet()函数返回一个选择集，当指定了一种AutoCAD选取模式时就获得该选择集，选取模式可以通过AutoCAD用户的提示或过滤图形数据库指定。

使用acedSSGet()函数有多种方式。

首先我们将说明函数中的各个参数，然后阐述使用acedSSGet()函数的各种方式。

参数str是指定实体选取模式的可选字符串。

参数pt1和pt2指定若干选取模式的可选点。

对于polygon(多边形)或fence(栏选)选取模式选项，参数pt1还可以是一个含有多个点的结果缓冲区链表。

参数filter是一个可选的结果缓冲区链表，能使acedSSGet()函数过滤图形以选择具有某种类型
与(或)具有某种特性的实体。

无论你使用哪一种模式来获得选择集，都用参数ss 来标识选择集的名称。

参数str指定要使用哪一种选取模式，它可以是表3-7所列字符串之一。

从表3-7可以看出有多种选择集的选取模式，如果想探讨所有的选项，可参阅帮助文档。

一般我只做两件事：让用户选择实体(NULL选项)或根据特性选择实体(“X”选项)。

下面是一些有代表性的调用acedSSGet()函数的程序代码。

如acutBuildList()函数调用示例那样，对于多边形选项CP和WP(但不包括F)会自动封闭列出的点，不必把终点指定为起点。

表3-7 acedSSGet()函数的选取模式选项：参数str的值
值(选取模式) 说明
NULL 单点选择(指定pt1)或用户选择(pt1也是NULL)
“I” 指定PICKFIRST实体集
“C” Crossing选取模式
“CP” Crossing polygon选取模式
“F” Fence(或open polygon)选取模式
“L” Last选取模式，选择最近生成的实体
“P” Previous选取模式，选择上一个选择集
“W” Window选取模式
“WP” Window Polygon选取模式
“X” 只用于过滤选取模式
“G” Groups选取模式
“:$” Prompts supplied选取模式
“:?” “Other” callbacks选取模式
“:D” Duplicates allowed选取模式
“:E” Everything in aperture选取模式
“:K” Keyword callbacks选取模式
“:N” Nested选取模式
“:S” 单一对象选取模式
“.” 用户选取模式
“#” 非几何选取模式(all、last、previous)
“A” All选取模式
“B” BOX选取模式
“M” Multiple选取模式
3.10.1 选择集的过滤
为了使用选择集过滤模式，参数str必须指定为“X”。

选择集过滤模式允许依据特性选择实体。

过滤参数是一个结果缓冲区表，在这里给acedSSGet()函数详细说明了要使用的实体种类和特性种类。

如果过滤参数是NULL，并且参数str为“X”，则选择集ss将包含当前AutoCAD图形中的每一
个实体，而不考虑实体是否在冻结的层上。

函数调用如下：
现在选择集ss将包含当前AutoCAD图形中的每一个实体。

那么我们怎样选择数据库中所有的圆实体呢？为了有效地使用选择集，必须知道DXF组码。

首先我们必须构造一个结果缓冲区，但因为我们只寻找一种实体，所以我们可以使用acutNewRb()函数来创建该结果缓冲区。

下面是一段代码实
例：
下面的程序代码实例生成由某一图层上所有的实体组成的选择集。

图层的DXF 组码是8。

好了，下面我们举一个稍微复杂一点的例子，假定我们要选择“parts”层上的所有圆。

这是一个利用acutBuildList()函数构造结果缓冲区表后再传给acedSSGet()函数的实例。

3.10.2 选择集的关系过滤
在选择集中可以使用关系运算符。

例如：我们要选取“parts”图层上半径大于等于2.0的所有圆。

在缺省情况下，acedSSGet()函数选取满足过滤表中所有条件的实体。

过滤时每两个项之间的隐含关系是“相等(equals)”。

对于数值型组码(整数、实数、点和向量)，借助在结果缓冲区中包
含一个说明关系运算符的特殊组码“-4”可以指定其他的关系运算。

该运算符应用于紧跟其后的结果缓冲区项。

关系运算符由字符串指定。

表3-8列出了所有的关系运算符。

关系运算符可以用实例来很好地说明，继续我们所举的例子：选取“parts”图层上半径大于等于2.0的所有圆。

其程序代码如下：
表3-8 选择集过滤表的关系运算符
关系运算符说明
“*” 任意(始终为真)
“=” 等于
“!=”不等于(C/C++)
“/=” 不等于(AutoLISP)
“<>” 不等于
“<” 小于
“<=” 小于或等于
“>” 大于
“>=” 大于或等于
“&” 按位“与”(只用于整数组码)
“&=” 按位等于(只用于整数组码)
3.10.3 选择集的条件过滤
除关系测试外，我们还可以使用条件运算符。

表3-9列出了所有的选择集条件运算符。

表3-9 选择集过滤表的条件运算符
起始运算符中间内容终止运算符
“<AND” 一个或多个操作对象“AND>”
“<OR” 一个或多个操作对象“OR>”
“<XOR” 两个操作对象“XOR>”
“<NOT” 一个操作对象“NOT>”
选择集的条件运算符允许我们执行像选择图形中半径为 1.0的所有圆和“parts”图层上的所有直线这一类的选择集操作。

编程后代码如下：
本例有助于掌握选择集的关系过滤和条件过滤。

3.10.4 选择集的扩展实体数据过滤
从R11版本起，AutoCAD就有了一个为实体添加数据的机制，称为扩展实体数据(xdata)。

我不准备深入讨论扩展实体数据，因为从AutoCAD R13 c4a起，在AutoCAD R14和以后的版本中引入了一种新的机制称为XRecords，这在后面的章节中将会加以讨论。

扩展实体数据通常是由外部应用程序
附加到一个对象上的文本串、数值、3D点、距离、层名或其他数据。

扩展数据的大小是每个实体16KB。

注意XRecords是不附加于任何实体的，因此XRecords 的存在并不需要实体的存在。

借助在过滤表中使用-3组码标记指定应用程序名，
就可以检索扩展数据。

acedSSGet()函数返回登记有特
定名称的扩展数据的实体集合，acedSSGet()函数并不检索单个扩展数据项(组码范围为1000~2000)。

下面为选择所有实体的代码段，所有实体均有以其应用程序ID号为“APPNAME”注册的扩展数据：
在ADSRX文档中，有关扩展实体数据的信息还有很多，但由于AutoCAD R14和以后的版本使用XRecords，因此，在后面的章节中我们将详细讨论XRecords。

3.10.5 转换矩阵和选择集
acedXformSS()[ads_xformss()]
借助acedXformSS()函数，选择集可以使用转换矩阵。

利用转换矩阵，可以变比、移动、旋转或镜像选择集中的实体。

这可以用适当的矩阵元素设置调用acedXformSS()函数来实现，而不是循环整个选择集并执行acedCommand()/acedCmd()函数来变比、移动、旋转或镜像每一个实体。

在这里
我不想完整地讨论矩阵代数学。

ObjectARX已经定义了处理矩阵代数的数值函数(见AcGeMatrix2d和AcGeMatrix3d矩阵操作类)。

前面讲过转换矩阵是一个具有ads_real数据类型的4×4阶数组。

矩阵的前三列确定比例和旋转，第四列是一个平移向量。

矩阵的最后一行其值规定为[0 0 0 1]，
传递ads_matrix型参数的函数忽略了此值。

ADSRX为平移操作定义符号T，如下所示：
acedXformSS()函数的定义如下：
acedXformSS()函数将一个转换矩阵genmat应用于由ssname指定的选择集。

参数genmat是一个4×4阶矩阵。

如果genmat没有均匀变比，acedXformSS()函数返回RTERROR。

把转换矩阵应用于选择集是不使用acedCommand()、acedCmd()或acdbEntMod()函数即在选择集中变比、旋转或移动实体的
一种方法。

如果acedXformSS()函数调用成功返回RTNORM，否则返回RTERROR。

下面是一段初始化矩阵的程序代码：
在上面的函数中，我们使用嵌套的for循环初始化了ads_matrix类型的参数id(各
元素的值为0)，然后再用一个for循环初始化了元素0,0 1,1 2,2和3,3使其值为1。

现在矩阵被初始化为恒等矩阵。

观察如下由Tx、Ty和Tz决定的平移矩阵：改变第四列中的前三个元素的值并应用acedXformSS()函数，选择集中的所有实体将沿X、Y和Z方向移动适当的距离。

注意，如果只需要在X方向移动，那么只需改变矩阵中的Tx值。

当处理选择集和acedXformSS()函数时，所有的比例系数必须相等，即Sx=Sy=Sz。

还有像旋转矩阵之类的其他2D和3D操作(参阅ADSRX和ObjectARX文档)。

现在让我们来看一个用于选择集操作的转换矩阵实例。

这是要对选择集实施变换的矩阵，X、Y和Z方向的缩放系数是0.5，选择集的移动距离是(20.0,5.0)。

下面是程序代码：
3.10.6 选择集的操作
既然我们已经看到有各种方法创建选择集，现在就让我们来看看操作这些选择集的函数。

也许我们要知道的第一件事是有多少实体组成了该选择集。

1. acedSSLength()[ads_sslength()]
acedSSLength()函数返回组成选择集的实体个数。

其定义如下：acedSSLength()函数返回一个长整数len，表示选择集sname中含有的实体个数。

结果是特定实体的个数，不管选择集是怎样选取的，选择集不包含重复的实体。

如果acedSSLength()函数调用成功，返回RTNORM，否则返回一个错误码。

acedSSLength()函数通常和for循环连用，如下例程序代
码所示：
2. acedSSName()[ads_ssname()]
在上述代码中，如果acedSSLength()函数返回的变量len的值大于0，那么我们就能够得到一个由长整型变量i表示在选择集中位置的特定实体。

为得到在选择集特定位置上的实体，可以使用acedSSName()函数。

表示实体在选择集中位置的序号从0开始，第一个实体的序号是0。

下面是acedSS
Name()函数的定义：
acedSSName()函数选取选择集ss中位置序号为i的实体，并在entres中返回实体名。

实体从0开始编号，所以i必须是非负的且不大于选择集中最后一个实体。