Objectarx2008开发

表1-1 AutoCAD各种API 的比较

比较内容ObjectARX .NET VBA VisualLISP

性能非常强大强一般一般

执行速度最快快快慢

稳定性好好好好

易用性好好好一般

开发技术难度大一般小小

从上面的比较中我们可以看出VisualLISP /AutoLISP和VisualBASIC方便易学，开发周期短,适合开发一些小型的实用工具，但是，对开发速度和性能要求都很高的解决方案或者大型CAD应用软件，建议使用ObjectARX作为开发工具，有时候也可以考虑各个API的优缺点，在开发的系统中使用多种API 集成开发。

从工程的实际需求来看，AutoCAD有很好的开放性，而目前针对专业定制的开发的需求又是非常之大的，所以基于AutoCAD平台定制专业的CAD系统或者行业解决方案具有十分广阔的发展前景。

1.1.3 ObjectARX开发环境

要运用ObjectARX进行二次开发，必须首先设置好ObjectARX的开发环境，以AutoCAD 2008为例来说明，首先要从Autodesk公司网站免费下载ObjectARX 2008(2007) SDK,下载后的安装包是个自解压文件，将其释放到指定的目录，如C:\CAD SDK\ObjectARX 2008，ObjectARX 2008 SDK开发环境是Microsoft Visual Studio 2005（V C++ 8.0）。

安装好ObjectARX SDK后，就可以开始设置开发环境了,环境设置的主要任务就是设置头文件（*.h）和库文件(*.lib)的查找路径，头文件（*.h）和库文件(*.lib)的查找路径为VC++的环境参数，设置一次即可，对以后的所有项目均有效。

在Microsoft Visual Studio 2005中选择【工具】菜单下的【选项】，启动【选项】对话框，选择【项目和解决方案】下的【VC++目录】，在【包含文件】条目中添加ObjectARX 的包含文件（*.h）目录C:\CAD SDK\ObjectARX 2008\inc，如图1-4。

图1-4 添加ObjectARX的包含文件目录

在【库文件】条目中添加ObjectARX的库文件(*.lib)目录C:\CAD SDK\ObjectARX 2008\lib, 如图1-5。

图1-5 添加ObjectARX的库文件目录

注意： ObjectARX 2004/2005/2006 的开发平台为Microsoft Visual Studio 2002（V C++ 7.0）,支持路径的设置类似在Visual Studio 2005 中设置的过程。

1.1.4 ObjectARX程序结构

ObjectARX程序是一种可以共享AutoCAD地址空间并对AutoCAD进行直接调用的动态链接库，所有的ObjectAEX应用程序都需要有一个处理消息的主接入点：acrxEntryPoint()函数，AutoCAD调用ObjectARX的模块acrxEntryPoint()函数来向应用程序传递消息，在acrxEntryPoint()函数中可以用switch语句处理AutoCAD的各种返回信息，根据不同信息执行不同的函数，并返回状态码, 最后，必须用AcRx::kRetOk作为函数acrxEntryPoint()的最终返回值，以下是acrxEntryPoint()函数的基本结构：

extern "C" AcRx::AppRetCode

acrxEntryPoint(AcRx::AppMsgCode msg, void* pkt)

{

switch (msg)

{

case AcRx::kInitAppMsg:

//是否允许程序被卸载。

acrxDynamicLinker->unlockApplication(pkt);

//决定该程序是否支持多文档。

acrxRegisterAppMDIAware(pkt);

initApp();

break;

case AcRx::kUnloadAppMsg:

unloadApp();

break;

default:

break;

}

return AcRx::kRetOK;

}

在上面代码中，如果没有acrxDynamicLinker->unlockApplication(pkt)语句，ObjectARX 程序不允许被卸载，除非AutoCAD退出。如果没有acrxRegisterAppMDIAware(pkt)语句，当程序被加载时，AutoCAD将切换为单文档模式。

要完成ObjectARX程序的初始化必须在acrxEntryPoint()函数的AcRx::kInitAppMsg 事件中或者该事件调用的函数中对程序中自定义的所有类进行初始化，调用acedRegCmds->addCommand()函数在AutoCAD命令堆栈中注册新命令，例如在initApp （）函数中可注册一个新的命令：

void initApp()

{

// 注册新的命令

acedRegCmds->addCommand(_T("Cmd_Group"),

_T("HelloARX"),

_T("HelloARX "),

ACRX_CMD_TRANSPARENT,

HelloARX)；

}

以上代码通过addCommand()函数向命令栈中增加一个命令组Cmd_Group,其中有一个全局命令名和局部命令名均为HelloARX的命令,并指定执行该命令的函数HelloARX，该执行函数将在命令行中打印一行文本，内容如下：

void HelloARX ()

{

acutPrintf(_T("\n第一个ObjectARX程序!"));

}

用户必须在acrxEntryPoint()函数的AcRx:: kUnloadAppMsg事件中或者该事件调用的函数中，调用acedRegCmds->removeGroup()函数将注册的新命令组从AutoCAD命令堆栈中清除，调用deleteAcRxClass()函数清除程序中自定义的任何类，例如unloadApp（）函数中调用以下代码把在initApp（）函数中注册的命令组移除：

void unloadApp()

{

acedRegCmds->removeGroup(_T("Cmd_Group "))；

}

因为ObjectARX程序是一个动态库，所以需要指定一个DEF文件（*.def），使用DEF 文件的EXPORTS项来输出动态库函数和库，如下内容所示：

LIBRARY "CH01"

EXPORTS

acrxEntryPoint PRIV ATE

acrxGetApiVersion PRIV ATE

1.2 ObjectARX工程

1.2.1手动创建ObjectARX工程

下面说明通过手动的方式在Visual C++.NET2005中创建一个新的ObjectARX工程的步骤。

1.从Visual C++.NET的【新建】菜单中，选择【新建】中的【项目…】。

2.在【新建项目】对话框中的【项目类型】选择【Visual C++】，在列出的模板中选择【Win32项目】，如图1-6。

3.在工程【名字】编辑框中输入所想要的工程名，例如“CH01”，图1-4。

图 1.6 创建工程

4.设置存放工程的文件夹位置，点击【确定】按钮，将调用【Win 32应用程序向导】对话框。

5.在该向导对话框中的【应用还程序设置】标签中，在【应用程序类型】选择“DLL”选项，如图1-7。

图 1.7指定程序类型为DLL

6.点击【完成】完成工程的创建。

工程创建完成后，需要进行以下工程设置，可参考以下步骤完成。

1.在方案浏览器中选择工程CH01，右击弹出右击菜单,选择【属性】选项，可为此工程调出【属性页】对话框。

2.在【属性页】对话框中，选择【连接器】->【常规】在【输出文件】选项中，将输出文件的扩展名.dll改为.arx，如图1-8。

图1.8 修改输出的文件名

3.在【属性页】对话框中，选择【连接器】->【输入】，在【附加依赖项】中添加如下库文件：rxapi.lib acdb17.lib acedapi.lib, 如图1-9。

图1.9 指定库文件

我们的工程设置到此就完成了。接下来，我们就可以在程序中添加所需要的代码。

4.从【项目】菜单中选择【添加新项】，在【添加新项】对话框中，选择"C++ File (.cpp)"选项,创建的名称为MyCmd.cpp的cpp文件, 如图1-10。

图1.10 添加MyCmd.cpp文件

5.在MyCmd.cpp中添加代码。

其中，程序包含的两个ObjectARX头文件aced.h 和 rxregsvc.h包含了我们程序中所用的函数。添加头文件的代码如下所示：

#include "stdafx.h"

#include

#include

#include

void HelloARX ()

{

acutPrintf(_T("\n第一个ObjectARX程序!"));

}

void initApp()

{

// 注册新的命令

acedRegCmds->addCommand(_T("Cmd_Group"),

_T("HelloARX"),

_T("HelloARX "),

ACRX_CMD_TRANSPARENT,

HelloARX);

}

void unloadApp()

{

acedRegCmds->removeGroup(_T("Cmd_Group "));

//acedRegCmds->removectmd(_T("Cmd_Group"),_T("HelloARX"));

}

extern "C" AcRx::AppRetCode acrxEntryPoint(AcRx::AppMsgCode msg, void* pkt)

{

switch (msg)

{

case AcRx::kInitAppMsg:

//是否允许程序被卸载。

acrxDynamicLinker->unlockApplication(pkt);

//决定该程序是否支持多文档。

acrxRegisterAppMDIAware(pkt);

initApp();

break;

case AcRx::kUnloadAppMsg:

unloadApp();

break;

default:

break;

}

return AcRx::kRetOK;

}

6.从【项目】菜单中选择【添加新项】，在【添加新项】对话框中，选择【模块定义文件 (.def)】选项,创建的名称为MyCmd.def的def文件，如图1-11。

图1-11 添加模块定义文件

7.在MyCmd.def中添加内容。

LIBRARY "CH01"

EXPORTS

acrxEntryPoint PRIV ATE

acrxGetApiV ersion PRIV ATE

通过以上步骤，就完成了ObjectARX应用程序的创建和命令的添加，编译成功就可在AutoCAD 2008中测试。

1.2.2程序的加载、运行和卸载

ObjectARX应用程序编译完成后，就可以在AutoCAD中加载运行，可以采用以下方法记载arx文件：

n使用APPLOAD命令。在AutoCAD命令行键入APPLOAD,在弹出对话框,指定待装载的ARX应用程序。

n使用ARX命令。在AutoCAD命令行键入ARX,然后键入L后弹出对话框,指定待装载的ARX应用程序名即可。

n使用AutoLISP函数. AutoCAD文定义了使用AutoLISP 函数arxload和arxunload 装载和卸载ObjectARX应用程序的用户接口,例如(arxload " C:\ Lab\ CH01.arx")。

要运行ObjectARX程序只需键入程序中所注册的命令名即可，如在上面的创建的例子中添加的HelloARX命令。

卸载程序与加载ObjectARX程序的方法相对应，具体操作这里不再赘述。

1.2.3程序的调试

程序编写中需要进行大量的调试工作，ObjectARX程序的调试可以跟普通的VC++程序一样通过设置断点来跟踪。

ObjectARX程序的跟踪调试需要首先设置调试版本(Win32 Debug)的编译环境，在中选择AutoCAD 2008程序的位置，如C:\Program Files\AutoCAD 2008\acad.exe，编译完成后，点击F9在相应位置设置断点，点击F5开始跟踪调试，调试开始时会自动打开AutoCAD，加载程序运行完成后，退出AutoCAD，结束调试。

1.3ObjectARX向导的安装和使用

ObjectARX向导可以帮助开发ObjectARX应用程序，该向导的安装文件为ObjectARX SDK 文件夹\utils\ObjARXWiz\中的ArxWizards.msi文件，通过该向导可快速的创建ObjectARX工程，方便地添加命令，另外还用于创建自定义类或者创建定制的反应器。

ObjectARX向导安装完成后，在创建新项目时候，会在【项目类型】中添加ObjectARX 选项，在该项目下提供【ObjectARX/DBX /OMF Project】模板，可以基于该模板创建标准的ObjectARX工程。

ObjectARX向导除了添加一个标准的ObjectARX工程模板，还在Microsoft Visual Studio 2005中添加一个工具条插件，如图1-12所示。

如图1-12 ObjectARX 工具条

通过工具条上的a}按钮命令可启动命令添加对话框，在对话框中【ARX command list】区域按右键，将出向命令操作的右键菜单，如图1-13所示，

根据实际情况设置新创建命令的命令组名、全局和本地命令名，以及命令的命令相关的标识，命令添加成功后在工程文件中添加一个命令函数，如下所示：

// - CSLab02._MyCommand1 command (do not rename)

static void CSLab02_MyCommand1(void)

{

// 完成命令的实现

}

在这个函数中添加命令执行代码即可，关于ObjectARX向导工具条在自定义类和反应器方面的使用，我们还会在后面相应的章节加以介绍。