2019独角兽企业重金招聘Python工程师标准>>>
(1)AcAx 开头的全局函数:这些函数通过 COM 的方式来让AutoCAD 完成一些操作。
(a) acutPrintf函数:在 AutoCAD 命令行显示指定的字符串
acutPrintf函数的具体用法如例:
acutPrintf("\n输入不合法,请重新输入");
(b) AcAxMove 函数:移动实体。需要链接 axauto15.lib 库
AcAxMove 函数的定义形式为:
HRESULT AXAUTOEXP AcAxMove(AcDbObjectId& objId,VARIANT fromPoint,VARIANT toPoint);
VARIANT 是在 COM 中使用的一种特殊数据类型,因为COM是微软用于解决组件之间数据交换的一种技术,COM 对象建立在二进制可执行代码级的基础上,并由此来实现多种语言开发的组件对象可以进行交互。
因此开发 COM 所使用的数据类型是独立于特定语言的,我们开发 COM 客户程序(调用 COM 对象的程序)也必须使用一些 COM 所规定的数据类型。
AcAxMove 函数的具体用法如例:
AcDbObjectId entId;//移动实体id
AcGePoint3d ptFrom;//起点
AcGePoint3d ptTo;//终点
// 将AcGePoint3d类型的点坐标进行类型转换
VARIANT *pvaFrom = Point3dToVARIANT(ptFrom);
VARIANT *pvaTo = Point3dToVARIANT(ptTo);
BOOL bRet = SUCCEEDED(AcAxMove(entId, *pvaFrom, *pvaTo));
delete pvaFrom;
delete pvaTo;
static VARIANT* Point3dToVARIANT(const AcGePoint3d &point)
{
COleSafeArray *psa = new COleSafeArray();
DOUBLE dblValues[] = {point[X], point[Y], point[Z]};
psa->CreateOneDim(VT_R8, 3, dblValues);
return (LPVARIANT)(*psa);
}
(c)AcAxRotate函数:旋转实体的操作
(d)AcAxScaleEntity 函数:缩放实体的操作
(e)全局函数 acdbOpenAcDbEntity用于从实体的 ID 号获得指向图形数据库中实体的指针。具体定义形式和用法参考另外一篇博客。https://my.oschina.net/u/2930533/blog/759568
(f)acedGetString 函数:获得用户输入的字符串(acedGetPoint(点)、acedGetInt、acedGetKword(关键字) 、acedGetDist(距离) acedGetCorner(矩形框对角点)acedGetAngle (角度)和 acedGetReal(实数))
acedGetString函数的定义形式为:
int acedGetString(int cronly,const char * prompt,char * result);
第一个参数:cronly 指定用户输入的字符串中是否可以包含空格,可以输入 Adesk::kTrue 或着Adesk::kFalse;
第二个参数:prompt 指定了在命令行提示用户输入的文本;
第三个参数:result 则保存了用户输入的结果(最大缓冲区为133个字符)。
返回值:RTNORM:成功,RTERROR:失败,RTCAN:用户按下“ESC”键取消操作,RTREJ:拒绝执行操作(操作不合法),RTFAIL:与AutoLISP通信失败,RTKWORD:用户输入了关键字;
具体用法如例:
acedGetString(Adesk::kFalse, "\n输入图块的名称:", &blkName)
注意:第三个参数用了&,是址传递.
acedGetInt 函数的定义形式为:
int acedGetInt(const char * prompt, int * result);
第一个参数:prompt: 用于指定显示在命令窗口中的字符串,如果不需要使用可以指定 NULL 作为该参数的值。
第二个参数:result :用户输入的整数。
返回值:RTNORM:成功,RTERROR:失败,RTCAN:用户按下“ESC”键取消操作,RTREJ:拒绝执行操作(操作不合法),RTFAIL:与AutoLISP通信失败,RTKWORD:用户输入了关键字;
(g)acedEntSel 函数:等待用户选择一个实体
acedEntSel函数的定义形式为:
int acedEntSel (const ACHAR *str, ads_name entres,ads_point ptres);
第一个参数:str:提示信息;
第二个参数:entres:实体名称;
第三个参数:ptres:选择实体对象时候的拾取点。
返回值:RTNORM:成功,RTERROR:失败,RTCAN:用户按下“ESC”键取消操作,RTREJ:拒绝执行操作(操作不合法),RTFAIL:与AutoLISP通信失败,RTKWORD:用户输入了关键字;
具体用法如例:
ads_name entres;
ads_point ptres;
if(RTNORM == acedEntSel(_T("\n请选择一个实体:"),entres,ptres))
{
AcDbObjectId objId;
if(acdbGetObjectId(objId,entres) != Acad::eOk )
return;
}
(h)acedInitGet函数:限定输入的条件,该函数只能控制紧随其后的一个acedGetXXX,调用后立即失效.
acedInitGet函数的定义形式为:
int acedInitGet(int val, const ACHAR *kwl);
第一个参数:val:输入数据的范围和方式(1:RSG_NONULL:不允许空输入;2:RSG_NOZERO:不允许输入0;4:RSG_NONEG:不允许输入负数;8:RSG_NOLIM:不检查图形边界;32:RSG_DASH:用虚线表示矩形框或橡皮线;64:RSG_2D:不考虑3D的Z坐标;128:RSG_OTHER:允许用户任意输入);
第二个参数:kwl:关键字列表;
具体用法如例:
int nCount = 1;
acedInitGet(RSG_NONULL+RSG_NONEG+RSG_NOZERO,NULL);
acedGetInt(_T("\n请输入多边形顶点数:"),&nCount);//不允许输入负数和0
(i)acedSetColorDialog 函数:函数能够弹出选择颜色对话框,并且返回用户选择的结果。
acedSetColorDialog 函数定义形式为:
Adesk::Boolean acedSetColorDialog(int& nColor,Adesk::Boolean bAllowMetaColor,int nCurLayerColor);
第一个参数:nColor 参数指定了显示【选择颜色】对话框时的默认颜色,并且在函数返回值后保存用户选择的新颜色;
第二个参数:bAllowMetaColor 参数限定在【选择颜色】对话框中是否可以选择“随层”或“随块”;
第三个参数:nCurLayerColor 参数指定当前图层的颜色。
(j)acedCommand 函数:
acedCommand 函数的定义形式为:
int acedCommand(int rtype, ... unnamed);
该函数的参数个数是可变的,并且参数成对出现。参数对中第一个参数表示参数的类型,第二个表示其实际的数据。参数表的最后一个参数必须是0或者RTNONE(使用RTNONE更好一些)。
acedCommand 函数具体用法如例:
acedCommand(RTSTR, "Circle",RTSTR, “0,0,0”, RTSTR, “10”, RTNONE);
创建一个圆心为(0,0)、半径为10的圆。
(k)acedCmd 函数:
acedCmd 函数的定义形式为:
int acedCmd(const struct resbuf * rbp);
参数是一个 resbuf 类型的指针,这里需要的结果缓冲区可以由 acutBuildList 函数生成。
(l)acutNewRb 函数:创建一个新的结果缓冲区,并为其分配存储空间。使用该函数分配的存储空间必须在不用的时候手工释放空间。
(m)acutRelRb 函数:释放结果缓冲区链表的存储空间。
(n)acedGetFileD 函数:文件对话框提示用户输入一个文件名。
acedGetFileD 函数的定义形式为:
int acedGetFileD(const char * title,const char * default,const char * ext,int flags,struct resbuf * result);
第一个参数:title 指定对话框的标题;
第二个参数:default 指定默认的文件名称;
第三个参数:ext 指定默认的文件扩展名;
第四个参数:flags 参数用一个位值控制对话框的样式;
第五个参数:result 参数包含了用户选择的文件名和路径。
(o)
(p)
(2)AcDbObject 类:所有实体对应的类都间接继承于 AcDbObject 类
clone 函数:生成一个调用者的克隆对象,并返回指向克隆对象的指针,clone 函数仅仅会生成对象的一个克隆,对于实体对象来说,这样还没有完成复制操作的全部。还必须把它添加到模型空间中才能被显示出来;
clone函数的定义形式为:
virtual AcRxObject* clone() const;
cast 函数:类型转换,实体转为多段线、文本、直线等。。。。。。
AcDbEntity *pEnt;
AcDbPolyline *pPoly = AcDbPolyline::cast(pEnt);
isKindOf 函数:判断是否是实体是什么类型
if (pEnt->isKindOf(AcDbPolyline::desc()) == Adesk::kTrue)
//是多段线
(3)AcDbEntity类:继承与AcDbObject类,
(a)layer 函数:获得实体所在图层的名字。acutDelString函数:释放layer函数返回的字符串所占用的内存。
具体用法如例:
char *layerName = pEnt->layer();
if (strcmp(layerName, "测试") == 0)
{
// 执行需要的
……
}
acutDelString(layerName );
(b) layerId 函数:获得实体所在图层的 ID。
(c) transformBy函数:对实体进行几何变换;https://my.oschina.net/u/2930533/blog/1501531
transformBy函数的定义形式为:
virtual Acad::ErrorStatus transformBy(const AcGeMatrix3d& xform);
具体用法如例:
AcGeMatrix3d mat;
pEnt->transformBy(mat);
(d)getOsnapPoints 函数:得到捕捉点
getOsnapPoints函数的定义形式为:
ACDB_PORT ADESK_SEALED_VIRTUAL Acad::ErrorStatus getOsnapPoints(AcDb::OsnapMode osnapMode, Adesk::GsMarker gsSelectionMark, const AcGePoint3d& pickPoint, const AcGePoint3d& lastPoint, const AcGeMatrix3d& viewXform, AcGePoint3dArray& snapPoints, AcDbIntArray & geomIds) const;
第一个参数:osnapMode:捕捉点模式:AcDb::kOsModeEnd:找到实体上离pickPoint最近的端点;AcDb::kOsModeMid:找到实体上离pickPoint最近的中点(直线,圆弧等的中点); AcDb::kOsModeCen:圆心点;AcDb::kOsModeNode:节点;AcDb::kOsModeQuad:象限点;AcDb::kOsModeIns :插入点;AcDb::kOsModePerp:过lastPoint点的垂足;AcDb::kOsModeTan:过lastPoint点的切点;AcDb::kOsModeNear:找到离pickPoint最近的实体上的点;
第二个参数:gsSelectionMark:gs标记(如果没有设置,就默认GS标记值0,0 为实体本身,一般AcDbBlockReference和AcDbPolyline用到);
第三个参数:pickPoint:当前鼠标所在的点(WCS坐标系);
第四个参数:lastPoint:pickPoint之前选择的点,用来确定垂直和切线的对象捕捉值;
第五个参数:viewXform:将WCS转为DCS的坐标转换矩阵;
第六个参数:snapPoints:将生成的捕捉点添加到数组中去,可以添加0个或多个;
第七个参数:geomIds:未使用.
(e)getGripPoints 函数:得到夹点
getGripPoints函数的定义形式为:
Acad::ErrorStatus getGripPoints(AcGePoint3dArray& gripPoints, AcDbIntArray & osnapModes, AcDbIntArray & geomIds) const;
第一个参数:gripPoints:夹点数组
第二个参数:osnapModes:未使用
第三个参数:geomIds:未使用
Acad::ErrorStatus getGripPoints(AcDbGripDataPtrArray& grips, const double curViewUnitSize, const int gripSize, const AcGeVector3d& curViewDir, const int bitflags) const;
第一个参数:grips:夹点数组
第二个参数:curViewUnitSize:当前视图中一个绘图单元的大小(以像素为单位)
第三个参数:gripSize:夹点大小,以像素为单位
第四个参数:curViewDir:当前视图端口中的视图方向的向量
第五个参数:bitflags:标识
(f)meveGripPointsAt 函数:编辑夹点
moveGripPointsAt函数的定义形式为:
Acad::ErrorStatus moveGripPointsAt(const AcDbIntArray & indices, const AcGeVector3d& offset);
第一个参数:indices:"热的"夹点数组
第二个参数:offset:夹点平移的方向和大小
Acad::ErrorStatus moveGripPointsAt(const AcDbVoidPtrArray& gripAppData, const AcGeVector3d& offset, const int bitflags);
第一个参数:gripAppData:移动的夹点
第二个参数:offset:WCS坐标系中,夹点平移的方向和大小
第三个参数:bitflags:保留供将来使用,目前为零
(g)getSubentPathsAtGsMarker 函数:
getSubentPathsAtGsMarker函数的定义形式为:
ACDB_PORT ADESK_SEALED_VIRTUAL Acad::ErrorStatus getSubentPathsAtGsMarker(AcDb::SubentType type, Adesk::GsMarker gsMark, const AcGePoint3d& pickPoint, const AcGeMatrix3d& viewXform, int& numPaths, AcDbFullSubentPath*& subentPaths, int numInserts = 0, AcDbObjectId* entAndInsertStack = NULL) const;
第一个参数:type:输入子实体类型(AcDb::kFaceSubentType:面, AcDb::kEdgeSubentType:边, AcDb::kVertexSubentType顶点, AcDb::kMlineSubentCache :线);
第二个参数:gsMark:输入子实体的gs标识,从 ads_ssnamex()/acedSSNameX()获得;
第三个参数:pickPoint:当前鼠标所在的点(WCS坐标系);
第四个参数:viewXform:输入转换矩阵,WCS转DCS;
第五个参数:numPaths:输出subentPaths数组中的AcDbFullSubentPath对象的个数;
第六个参数:subentPaths:输出动态分配的地址数组;
第七个参数:numInserts :在entAndInsertStack中AcDbBlockReferences输入的对象id数量,第一个是实体本身,所以少一个;
第八个参数:entAndInsertStack:
(4)AcEdCommandStack类:(命令堆栈)来添加和删除命令
(a) addCommand 函数:用来向 AutoCAD 注册一个外部命令
addCommand 函数的定义形式为:
virtual Acad::ErrorStatus addCommand(const char* cmdGroupName,const char* cmdGlobalName,const char* cmdLocalName,Adesk::Int32 commandFlags,AcRxFunctionPtr FunctionAddr,AcEdUIContext * UIContext = NULL,int fcode = -1,HINSTANCE hResourceHandle = NULL,AcEdCommand** cmdPtrRet = NULL) = 0;
前面的5个参数,分别用来指定命令组名称、命令的国际名称、命令的本国名称、命令的类型(模态命令或者透明命令等)和指向实现函数的指针。
addCommand 具体用法如例:
void initApp()
{
acedRegCmds->addCommand("Hello1","Hello", "Hello", ACRX_CMD_MODAL,HelloWorld);
}
acedRegCmds 宏提供了一个指向 AcEdCommandStack 类的指针
ACRX_CMD_MODAL: 在别的命令执行的时候该命令不会在其中执行 ;ACRX_CMD_SESSION : 防止CAD自动锁定到当前文档 ; ACRX_CMD_TRANSPARENT: 命令可以再其它命令中执行,但在该标志下ads_sssetfirst()不能使用(http://blog.csdn.net/arthurfangmc/article/details/6907312) 。
(b)removeGroup 函数用来删除已经存在的一个外部命令组,以及保存在其中的所有命令。
removeGroup函数的具体用法如例:
acedRegCmds->removeGroup("Hello1");
ACED_ARXCOMMAND_ENTRY_AUTO的具体用法如例:
ACED_ARXCOMMAND_ENTRY_AUTO(CCreateEntsApp, HHL, CreateEntsLine, CreateLine, ACRX_CMD_TRANSPARENT, NULL);
第二个参数HHL代表事件响应函数的前缀,
第三个参数是事件响应函数名称,
第四个参数是命令名称
在acrxEntryPoint.cpp中要实现该命令的事件响应函数 HHLCreateEntsLine:
static void HHLCreateEntsLine(void)
{
AcGePoint3d ptStart(0, 0, 0);
AcGePoint3d ptEnd(100, 100, 0);
AcDbObjectId lineId;
lineId = CCreateEnt::CreateLine(ptStart, ptEnd);
CModifyEnt::ChangeColor(lineId, 1);
CModifyEnt::ChangeLayer(lineId, _T("虚线"));
CModifyEnt::ChangeLinetype(lineId, _T("中心线"));
}
这样在AutoCAD的命令窗口输入“CreateLine”,就会去执行HHLCreateEntsLine函数,画一条红色的虚直线
(5)AcDbDatabase 类:图形数据库
getSymbolTable 函数: 从数据库获得符号表
getBlockTable 函数,用于获得指向图形数据库的块表的指针。具体定义形式和用法参考另外一篇博客https://my.oschina.net/u/2930533/blog/759568
getLayerTable 函数:从数据库获得层表,参数以及用法参照getBlockTable。
setClayer 函数能够设置图形的当前图层。
(6) AcDbSymbolTable 类:所有的符号表都继承自 AcDbSymbolTable 类
(a)add 函数:向符号表添加一条新的记录,各种符号表实现的形式略有不同。
(b)getAt 函数:获得符号表中特定名称的记录
(c)has 函数:判断符号表中是否包含指定的记录,找到返回true,否则返回 false。
has 函数的具体用法如例:
// 判断是否存在名称为“测试”的图层
AcDbLayerTable *pLayerTbl;
if (!pLayerTbl->has("测试"))
{
acutPrintf("\n当前图形中未包含\"测试\"图层!");
pLayerTbl->close();
return;
}
(d)newIterator:创建一个符号表遍历器,访问符号表中的所有记录。
newIterator 函数的具体用法如例:
AcDbBlockTableRecordIterator *pItr;
pBlkTblRcd->newIterator(pItr);
(7)AcDbBlockTable 类:块表,继承 自AcDbSymbolTable 类,继承了has,getAt,add,newIterator等函数,参数以及用法参照AcDbSymbolTable类。
(8)AcDbBlockTableRecord 类:
(a)appendAcDbEntity 函数:用于将 pEntity 指向的实体添加到块表记录和图形数据库中。具体定义形式和用法参考另外一篇博客https://my.oschina.net/u/2930533/blog/759568
(b) hasPreviewIcon 函数:用于判断指定的块表记录是否包含预览图标
hasPreviewIcon 函数定义为:
Acad::ErrorStatus getPreviewIcon(PreviewIcon & previewIcon) const;
参数:PreviewIcon:在 ObjectARX 中被定义为:typedef AcArray
(c)getPreviewIcon 函数:可以从块表记录中获得预览图标的相关数据
(9)AcDbBlockTableRecordIterator类:块表记录遍历器,遍历器在使用完毕后一定要删除。
(a)getEntity函数:获得遍历器的每一个实体;
具体用法如例:
pItr->getEntity(pEnt, AcDb::kFrWrite);
(10)AcDbLayerTable类:层表,继承 自AcDbSymbolTable 类,继承了has,getAt,add,newIterator等函数,参数以及用法参照AcDbSymbolTable类。
(11)AcDbLayerTableRecord 类:
setColor 函数:设置图层的颜色。
setLinetypeObjectId 函数:设置图层的线型。
setLineWeight 函数:设置图层的线宽。
(11)AcDbTextStyleTable类:文字样式表
(12)AcDbTextStyleTableRecord 类:文字样式表记录
setName函数:设置名称
setFileName函数:设置字体文件名称
具体用法如例:
// 创建新的字体样式表记录
AcDbTextStyleTableRecord *pTextStyleTblRcd = NULL;
pTextStyleTblRcd = new AcDbTextStyleTableRecord();
// 设置字体样式表记录的名称
pTextStyleTblRcd->setName("仿宋体");
// 设置字体文件名称
pTextStyleTblRcd->setFileName("simfang.ttf");
setFont函数:设置字体
setFont函数定义为:
Acad::ErrorStatus setFont(const ACHAR* pTypeface, Adesk::Boolean bold, Adesk::Boolean italic, int charset, int pitchAndFamily);
第一个参数:pTypeface:字体类型;
第二个参数:bold:是否粗体;
第三个参数:italic:是否斜体;
第四个参数:charset:Windows字符集标识符;
第五个参数:pitchAndFamily:Windows间距和字符族标识符;
具体用法如例:
pTextStyleTblRcd->setFont("楷体_GB2312",0,0,134,49);
(11)AcDbLine类:直线;需要头文件#include "dbents.h"
AcGePoint3d ptStart(0, 0, 0);
AcGePoint3d ptEnd(100, 100, 0);
AcDbLine *pLine = new AcDbLine(ptStart, ptEnd);(正确)//必须在堆上创建对象
AcDbLine line(ptStart, ptEnd);(不正确)//直线对象仅被在内存上创建,并没有添加到图形数据库中,因此不可能会显示在
图形窗口中。
(12)AcDbPolyline类:轻量多段线;AcDb3dPolyline:三维多段线;AcDb2dPolyline:不常见
AcDb3dPolyline 构造函数定义为:
AcDb3dPolyline *pPoly3d = new AcDb3dPolyline(AcDb::k3dSimplePoly, points);
第一个参数:AcDb::k3dSimplePoly 表示创建的多段线是一个未经拟合的标准多段线;
第二个参数值指定了创建三维多段线的顶点数组;
第三个参数指定是否闭合多段线,这里使用了默认参数值,不在创建多段线时将其闭合。
(a)numVerts 函数:多段线的顶点数.
numVerts 函数定义为:
unsigned int numVerts() const;
(b)getPointAt 函数:得到顶点坐标
getPointAt 函数定义为:
Acad::ErrorStatus getPointAt( unsigned int index, AcGePoint2d& pt) const
Acad::ErrorStatus getPointAt( unsigned int index, AcGePoint3d& pt) const;
具体语法如例:
AcDbPolyline polyline;
for (int nIndex = 0; nIndex < polyline->numVerts(); ++nIndex)
{
OdGePoint3d ptTemp;
polyline->getPointAt(nIndex,ptTemp);
}
(c)addVertexAtget 函数,将每一个顶点添加到多段线中
addVertexAt 函数定义为:
Acad::ErrorStatus addVertexAt(unsigned int index, const AcGePoint2d& pt, double bulge = 0., double startWidth = -1., double endWidth = -1);
第一个参数:index 用来指定插入顶点的索引号(从 0 开始);
第二个参数:pt 指定顶点的位置;
第三个参数:bulge 指出要创建的顶点的凸度(0 表示直线,1 表示半圆(逆时针),-1:半圆(顺时针)介于 0~1 之间为劣弧,大
于 1 为优弧);
第四,五个参数:startWidth 和 endWidth 指定了从该顶点到下一顶点之间连线的起始和终止线宽,利用该特性可以使用多段线创建一个实心箭头。
(d)setPointAt 函数:设置顶点坐标(没有提供AcGePoint3d)
setPointAt 函数定义为:
Acad::ErrorStatus setPointAt(unsigned int index, const AcGePoint2d& pt);
(e)getLineSegAt 函数:得到线段
getLineSegAt 函数定义为:
Acad::ErrorStatus getLineSegAt(unsigned int index, AcGeLineSeg2d& ln) const;
第一个参数:index:索引,从0开始.
第二个参数:AcGeLineSeg2d:线段
(f)setClosed 函数:闭合
setClosed (Adesk::kTrue);
(13)AcDbText 类,用于 创建文字对象; AcDbMText:多行文本
构造函数定义为:
AcDbText( const AcGePoint3d& position,const char* text,AcDbObjectId style = AcDbObjectId::kNull,double height = 0,double rotation = 0);
第一个参数:position 指定文字的插入点(文本右上角);
第二个参数:text 是将要创建的文字对象的内容;
第三个参数:style 指定要使用的文字样式的 ID,默认情况下使用 AutoCAD 中缺省的文字样式;
第四个参数:height 为文字的高度;
第五个参数rotation 为文字的旋转角度。
需要头文件#include " dbmtext.h "
AcDbMText构造无参数,添加到模型空间之前用 setTextStyle() 和 setContents ()等来设置
AcDbMText *pMText = new AcDbMText();
// 设置多行文字的特性
pMText->setTextStyle(style);
pMText->setContents(text);
pMText->setLocation(ptInsert);
pMText->setTextHeight(height);
pMText->setWidth(width);
pMText->setAttachment(AcDbMText::kBottomLeft);
//添加到空间模型
CCreateEnt::PostToModelSpace(pMText);
(14)AcDbCircle类:圆;
AcDbCircle();
AcDbCircle(const AcGePoint3d& cntr, const AcGeVector3d& nrm, double radius);
(15)AcGeCircArc2d 类:几何类的圆弧;需要头文件#include "gearc3d.h"
(16)AcDbAr 类:圆弧
构造函数定义为:
AcDbArc(const AcGePoint3d& center,double radius,double startAngle,double endAngle);
AcDbArc(const AcGePoint3d& center,const AcGeVector3d& normal,double radius,double startAngle,double endAngle);
AcDbArc();
(17)AcDbEllipse 类:椭圆;需要头文件#include " dbelipse.h "
构造函数定义为:
AcDbEllipse( const AcGePoint3d& center,const AcGeVector3d& unitNormal,const AcGeVector3d& majorAxis,double radiusRatio,double startAngle = 0.0,double endAngle = 6.28318530717958647692);
第一个参数:center: 椭圆的中心;
第二个参数:unitNormal :椭圆所在的平面;
第三个参数:majorAxis 输入代表 1/2长轴的矢量, 也就是说该矢量的起点是椭圆的中心, 终点是椭圆长轴的一个端点;
第四个参数:radiusRatio:椭圆短轴与长轴的长度比例(为1时,椭圆变成圆);
第五个参数:startAngle: 椭圆的起始角度(弧度) ;
第六个参数:endAngle: 椭圆的终止角度(弧度)
(17)AcDbSpline 类:样条曲线;需要头文件#include " dbspline.h "
构造函数定义为:
AcDbSpline( const AcGePoint3dArray& points, int order = 4, double fitTolerance = 0.0);
第一个参数:points:样条曲线的拟合点;
第二个参数:order:拟合曲线的阶数;
第三个参数:fitTolerance:允许的拟合误差。
AcDbSpline(const AcGePoint3dArray& points,const AcGeVector3d& startTangent,const AcGeVector3d& endTangent,int order = 4, double fitTolerance = 0.0);
第一个参数:points:样条曲线的拟合点;
第二个参数:startTangent:样条曲线起点切线方向;
第三个参数:endTangent:样条曲线终点的切线方向;
第四个参数:order:拟合曲线的阶数;
第五个参数:fitTolerance:允许的拟合误差。
(18)AcDbRegion 类:面域。需要头文件#include " dbregion.h "
(a)createFromCurves:
createFromCurves 函数的定义为:
static Acad::ErrorStatus createFromCurves(const AcDbVoidPtrArray& curveSegments,AcDbVoidPtrArray& regions);
第一个参数:curveSegments:指向曲线实体的指针数组(定义面域的边界,面域边界的曲线必须首尾相连);
第二个参数:regions:指向新创建的面域的指针数组。
注:面域边界的对象必须是 AcDbLine、 AcDbArc、 AcDbEllipse、AcDbCircle、AcDbSpline、AcDb3dPolyline 或 AcDbPolyline 类的对象。
(19)AcDb3dSolid 类:三维实体。ACIS 实体才是实体真正的几何表示, AcDb3dSolid 类只是 ACIS 实体的容器和接口, 该类中并没有提供直接操作 ACIS实体边、顶点和面的方法。要遍历 ACIS 实体中隐含(无法直接访问子实体)的边、面和顶点,必须使用 ObjectARX 开发包中的 BREP 应用程序开发接口(API) 。
(a)createBox:创建长方体。一个中心位于世界坐标系原点的长方体,并且其长、宽、高分别平行于世界坐标系的 X、Y 和 Z 轴。
createBox函数定义为:
virtual Acad::ErrorStatus createBox(double xLen, double yLen, double zLen);
第一个参数:xLen:长方体的长;
第二个参数:yLen:长方体的宽;
第三个参数:zLen:长方体的高。
(b)createFrustum:创建平截头体(圆柱体、圆锥体)。
createFrustum 函数定义为:
virtual Acad::ErrorStatus createFrustum(double height,double xRadius,double yRadius,double topXRadius);
第一个参数:height:平截头体的高度;
第二个参数:xRadius:底面在 X 轴方向的半径;
第三个参数:yRadius:底面在 Y轴方向的半径;
第四个参数:topXRadius:顶面在 X 轴方向的半径;(圆锥时topXRadius为0, xRadius 和 yRadius 的值相等)
(c)createSphere:创建小球。
(d)createTorus:圆环。
(e)createWedge:创建楔形
(f)extrudeAlongPath :拉伸面域创建实体。
extrudeAlongPath函数定义为:
virtual Acad::ErrorStatus extrudeAlongPath(const AcDbRegion* region,const AcDbCurve* path);
第一个参数:region:指向拉伸截面的面域的指针;
第二个参数:path:指向拉伸路径的曲线指针。
(g)extrude:沿面域所在平面的法线方向拉伸面域创建新的实体,并且可以指定拉伸时的斜切角度。
(h) revolve :绕给定的轴线旋转面域而生成实体。
revolve函数定义为:
virtual Acad::ErrorStatus revolve(const AcDbRegion* region,const AcGePoint3d& axisPoint,const AcGeVector3d& axisDir,double angleOfRevolution);
第一个参数:region:指向旋转截面的面域的指针;
第二个参数:axisPoint:旋转轴线上的一点;
第三个参数:axisDir:旋转轴的方向;
第四个参数:angleOfRevolution:旋转面的角度;(axisPoint和axisDir共同确定旋转轴的具体位置)
(i)booleanOper:两个实体之间执行布尔运算。
booleanOper函数定义为:
virtual Acad::ErrorStatus booleanOper(AcDb::BoolOperType operation,AcDb3dSolid* solid);
第一个参数:operation:布尔运算的方式(AcDb::kBoolUnite:并集 、AcDb::kBoolIntersect:交集和 AcDb::kBoolSubtract:差集);
第二个参数:solid:指向布尔运算的另一个实体的指针。
(20)AcDbBlockReference 类:块参照
构造函数定义为:
AcDbBlockReference(const AcGePoint3d& position,AcDbObjectId blockTableRec);
第一个参数:position: 块参照的插入点;
第二个参数:blockTableRec :块参照所参照的块表记录(块定义)的 ID。
(a)rotation :旋转角度;
AcDbObjectId blkRefId;
double dAngle = 0.0;
AcDbObject *pObj = NULL;
acdbOpenObject(pObj,blkRefId,AcDb::kForRead);
AcDbBlockReference *pBlkRef = AcDbBlockReference::cast(pObj);
if (NULL != pBlkRef)
{
dAngle = pBlkRef->rotation();
}
//如果需要0~180°
dAngle = dAngle *180/3.1475926;
//在转回来
dAngle = dAngle *PI/180;
(21) AcDbAttributeDefinition 类: AcDbText 类的一个派生类, 属性定义对象,属性定义是 AutoCAD的一种图形对象(对应于 AutoCAD 中的“属性” ) ,可以直接创建该类的一个对象,然后将其添加到块表记录中。
构造函数定义为:
AcDbAttributeDefinition(const AcGePoint3d& position,const char* text,const char* tag,const char* prompt,AcDbObjectId style = AcDbObjectId::kNull);
第一个参数:position: 属性定义的插入点;
第二个参数:text: 属性定义默认的显示文字;
第三个参数:tag: 属性定义的标记文字;
第四个参数:prompt: 属性定义的提示文字;
第五个参数:style :文字样式表记录的 ID,用来指定属性定义所使用的文字样式。
(22)AcGeMatrix3d类:是一个几何类,用于表示一个四维矩阵。
(a)setToTranslation:设置某个矢量为移动基准的移动变换
(b)setToRotation:设置绕某一点旋转一定角度的旋转变换。
(c)setToScaling:设置以某一个基点缩放变换
(d)setToMirroring:设置以某一点进行对称的镜像变换。
具体语法如例:
// 构建用于实现移动实体的矩阵
AcGeVector3d vec(ptTo[X] - ptFrom[X], ptTo[Y] - ptFrom[X], ptTo[Z] - ptFrom[Z]);
AcGeMatrix3d mat;
mat.setToTranslation(vec);
(23)AcCmColor 类: 代表颜色对象,可以通过颜色索引来构建一个新的颜色对象。通过颜色索引,可以将【选择颜色】对话框的结果设置为指定图层的颜色。
(a)colorIndex函数:得到颜色的索引值。
(b)setColorIndex 函数:设置颜色的索引值。
(24)AcGePoint2dArray 类:二维点数组,成员类型为AcGePoint2d(AcGePoint3dArray:成员AcGePoint3d)
AcGePoi d::kOrigin:世界坐标系的原点;AcGeVector3d(0, 1, 0):矢量; AcGePoint3d(10, 10, 0):点。
append 函数:向数组中添加一个二维点
append函数的具体用法如例:
AcGePoint2dArray points;
AcGePoint2d ptStart;
AcGePoint2d ptEnd;
points.append(ptStart);
points.append(ptEnd);
removeAt 函数:从数组中删除指定的元素
length 函数:数组长度
(25)AcGeCurve3d类:直线,圆,椭圆,圆弧等的几何父类
(a)getClosestPointTo函数:求实体上离输入点最近的点.
getClosestPointTo函数定义为:
void getClosestPointTo(const AcGePoint3d& pnt, AcGePointOnCurve3d& pntOnCrv, const AcGeTol& tol = AcGeContext::gTol) const;
第一个参数:pnt:输入的参考点;
第二个参数:pntOnCrv:实体上离输入点最近的输出点;
第三个参数:tol :公差
或
void getClosestPointTo( const AcGeCurve3d& curve3d, AcGePointOnCurve3d& pntOnThisCrv,AcGePointOnCurve3d& pntOnOtherCrv, const AcGeTol& tol = AcGeContext::gTol) const;
第一个参数:curve3d:输入参考实体;
第二个参数:pntOnThisCrv:输出实体上离输入实体上最近的点;
第三个参数:pntOnOtherCrv:输出输入实体上离实体最近的点;
第四个参数:tol :公差
getClosestPointTo函数的具体用法如例:
OdGePoint3d startPoint,endPoint;
OdGeLine3d line3d(startPoint,endPoint);
OdGePointOnCurve3d tmpPt;
line3d.getClosestPointTo(lastPoint,tmpPt);
OdGePoint3d ptTemp=tmpPt.point();