- UID
- 347016
- 积分
- 51
- 精华
- 贡献
-
- 威望
-
- 活跃度
-
- D豆
-
- 在线时间
- 小时
- 注册时间
- 2005-11-7
- 最后登录
- 1970-1-1
|
发表于 2005-11-29 15:22:42
|
显示全部楼层
使用ObjectARX 2005+Visual Studio.NET 2003创建ARX程序
作者:潘圣林
我是在一个偶然的机会接触到ARX的,其实原来对于CAD的二次开发接触并不多,这方面的积累也不够充分,但既然已经涉及到这个领域,那么就希望学到这个领域最领先的知识。在翻阅了一些前辈的大作、浏览了很多网页后发现ARX的强大功能是大家公认的,但是由于开发人员的稀缺和软件的更新换代,ARX的学习资料不是很多,特别是在.net平台下开发ARX的资料就更少了。下面的文章中我将给大家讲讲ARX入门的经验,希望大家少走弯路,有经验大家可以一起交流。
相信大家已经拜读过金建承老师的文章《为什么要学ARX》,对ARX已经有所了解,那么接下来的问题就是怎样学好ARX。明经通道中有相关的文章,但总归是几年以前的,现在大家已经逐渐接受在.net平台下开发,那些文章总让人觉得不合时宜。下面的文章中假定你毫无ARX开发经验,我们将按惯例一步步的推进。
一、基础知识
使用ARX在.net平台下开发首先应该具备C++和AutoCAD的基础知识,如果不会可以现学,反正这方面的资料很多,折腾一段时间拿下应该不成问题。
二、下载软件包
必备软件是ObjectARX 和.net平台,当然为了能运行编译出来的.arx文件还需要AutoCAD平台。ObjectARX软件包可以在http://www.autodesk.com/objectarx 免费下载,.net平台和AutoCAD平台就需要自备了。我选用的版本是ObjectARX 2005+Visual Studio.NET 2003,可以说是现在最新版本的组合。ObjectARX软件包和.net平台经常会出现不兼容的情形,据说Autodesk公司已经作出了改进,但我在安装和编译过程中还是遇到了不少问题。ObjectARX 2004和ObjectARX 2005在 Visual Studio.NET 2002下都能正常的工作,但在Visual Studio.NET 2003下却多少有些问题,ObjectARX 2004甚至都不能安装ObjectARX Wizard(.msi文件),ObjectARX 2005可以安装,但编译的时候会存在问题。分析其原因是因为在ObjectARX 软件包中会调用或是验证大量VC7.0的库,而Visual Studio.NET 2003的VC版本是7.1,因而会存在问题,Visual Studio.NET 2002的VC版本是7.0,所以可以顺利使用。我机器上装的是Visual Studio.NET 2003,没有办法,这个系统太庞大了,总不能把它卸了,再重装Visual Studio.NET 2002吧!所以最后只好使用ObjectARX 2005+ Visual Studio.NET 2003,安装没问题,但在编译的时候出现有几个VC7.0的文件找不到。通过反复验证,只要把Visual Studio.NET 2003根目录下\Vc7\atlmfc\lib文件夹中所有文件名类似**71**的文件在Visual Studio.NET 2002中相应的拷贝到文件夹里就可以了。具体有以下这些:mfc70.lib mfc70d.lib、mfc70u.lib、mfc70ud.lib、mfcs70.lib、mfcs70.pdb、mfcs70d.lib、mfcs70d.pdb、mfcs70u.lib、mfcs70u.pdb、mfcs70ud.lib、mfcs70ud.pdb。如果有需要请Email到我们的邮箱:ist3d@ist3d.com或是登录我们的论坛bbs.ist3d.com,我可以提供下载。到现在为止,软件包的安装可以告一段落了。
三、创建最简单的ARX程序
在下面的文章中我将通过一个最简单的实例来讲述ARX程序的创建过程,介绍编制Object ARX程序的一些基本步骤和原则,并初步了解ARX程序与AutoCAD进行通讯的方式。这一节的大部分内容在Object ARX 2005自带培训教程ObjectARXLabs.chm中都有,喜欢看英文原文的朋友可以自己去下载浏览。如同学习其它计算机语言一样,我们首先来创建一个最简单的ARX程序——“Step01.ARX”,在AutoCAD 2005中加载并运行该程序,将会在命令行出现-“Hello, world!”。
我们首先来看看建立ARX程序的基本步骤:
由于ARX程序是一种可以共享AutoCAD地址空间并对AutoCAD进行直接调用的动态链接库,因此可以按照下列基本步骤建立ARX程序:
(1) 创建自定义类来实现新的命令:用户可以从ARX类层次关系中的大多数类和符号表类中派生自己的类。
(2) 决定ARX程序应该响应的AutoCAD消息:AutoCAD通过向ARX程序发出一系列的消息指明在它内部发生的特殊事件,ARX程序必须对其中的某些消息作出反映,并触发相应的操作。
(3) 实现应用程序与AutoCAD通信的入口:AutoCAD通过函数acrxEntryPoint()来调用ARX程序,而不是象普通的C++程序那样使用main()函数。函数acrxEntryPoint()中可以用switch语句处理AutoCAD的各种返回信息,根据不同信息执行不同的函数,并返回状态码。如果针对特定的消息返回出错代码,则必须用case语句来处理。最后,必须用AcRx::kRetOk作为函数acrxEntryPoint()的最终返回值。
(4) 完成ARX程序的初始化:用户必须在acrxEntryPoint()函数的AcRx::kInitAppMsg事件中或者该事件调用的函数(例如:initApp()函数)中,对程序中自定义的所有类进行初始化,然后调用acedRegCmds->addCommand()函数在AutoCAD命令堆栈中注册新命令。
(5) 实现卸载(Unload)功能:用户必须在acrxEntryPoint()函数的AcRx:: kUnloadAppMsg事件中或者该事件调用的函数(例如:unloadApp()函数)中,调用acedRegCmds->removeGroup()函数将initApp()函数中注册的新命令组从AutoCAD命令堆栈中清除,调用deleteAcRxClass()函数清除程序中自定义的任何类,然后删除所有由应用程序添加到AutoCAD中的对象,并清除所有与AcDbObject、AcDbDatabase、AcRxDynamicLinker或AcEditor对象相关联的事件反应器。
注意 缺省情况下,ARX程序处于被锁定状态而不能被卸载,如果要使ARX程序可以被卸载,需保存由AcRx::kInitAppMsg传送的appId参数,由unlockApplication()函数调用,见acrxEntryPoint ()函数注释。
我们还需要了解AutoCAD与ARX程序之间的消息传递,AutoCAD向ARX程序发送四类消息:
(1) 发送给所有ARX程序的消息:kInitAppMsg、kUnloadAppMsg、kLoadDwgMsg、kPreQuitMsg。
(2) 只发送给通过调用acedDefun() 函数注册AutoLISP函数的ARX程序的消息:kUnloadDwgMsg、kInvkSubrMsg、kEndMsg、kQuitMsg、kSaveMsgkCfgMsg。
(3) 只发送给注册service对象的ARX程序的消息:kDependencyMsg、kNoDependencyMsg。
(4) 只发送给使用ActiveX控件对象的ARX程序的消息:kOleUnloadAppMsg。
普通的ARX程序仅需要响应消息kInitAppMsg和kUnloadAppMsg,这两种消息的含义和ARX程序对它们的响应方式为:
(1) 消息kInitAppMsg:当AutoCAD 加载ObjectARX应用程序并开始进行与应用程序的通信时发送此消息。对于此消息,ARX程序应该注册服务对象、类、AcEd命令和事件反应器,以及AcRxDynamicLinker类事件反应器,初始化应用程序的系统资源(如设备、窗口),并执行简单的初始化操作;这时,AcRx、AcEd和AcGe类库都应该被激活;如果需要对应用程序进行解锁或重新加锁操作,还应该保存pkt参数。但是这里不能进行下列操作:初始化设备驱动程序、激活用户界面资源、按特殊顺序加载应用程序、执行AutoLISP程序以及打开任何数据库,否则将导致错误发生或者系统崩溃;AcDb和AcGi类库也不能在这里激活,尽管它们与AcRx 和其它结构有联系。
(2) 消息kUnloadAppMsg:当ObjectARX程序被卸载时(由用户卸载或者AutoCAD程序终止时),AutoCAD发送此消息,关闭当前文件并执行清除操作。对于此消息,ARX程序应该清除所有系统资源,所有对kInitAppMsg消息所做的初始化等工作都应该在这里被终止或者析构。AutoCAD不会自动解除初始化所做的工作。
下面我们将看到怎样在.NET环境下建立一个ObjectARX工程,并创建第一个ARX程序——“Step01.ARX”。
第一步: 创建工程
(1) 运行Visual Studio.NET,选择菜单命令New->Project….,弹出“Project”对话框。
(2) 在“Project”对话框的“Project Types:”中展开“VC++ Projects”选项,选择“Win32 Project”。
(3) 输入工程名称,如图所示为“Step01”,选择工程在硬盘中存放的路径。
(4) 完成以上步骤后,单击OK按钮,这将调出一个“Win 32 Application Wizard”对话框。
(5) 在对话框中选择“Application Settings”设置项,选择“DLL”作为应用程序类型。
(6) 点击“Finish”完成工程的创建。
第二步:编译器设置
(1) 通过在“View”->“Solution Explorer”打开“解决方案资源管理器”。
(2) 在“解决方案资源管理器”中右键点开“Step01”的属性窗口。
(3) 在“Configuration:”下来菜单中选择“All Configurations”,这能保证对所有配置都进行更改。
(4) 选择“C/C++”下的“General”,把“Warning Level”调为“Level 1”,“Detect 64-Bit Portability Issues”调为“NO”,这样做可以尽可能减少程序调试时跳出来的警告窗口影响工作,做完之后点击“Apply”。
(5) 选择“C/C++”下的“Code Generation”,通过下拉菜单把“Runtime Library”的值改为“Multi-threaded DLL (/MD)”,做完之后点击“Apply”。
(6) 选择“C/C++”下的“General”,在“Additional Include Directories”中添加你的ObjectARX软件包的存放路径,做完之后点击“Apply”。
第三步:链接设置
(1) 点开“Linker”下的“Input”,在“Additional Dependencies”中加入“rxapi.lib acdb16.lib acge16.lib acad.lib acedapi.lib”这几个库文件,做完之后点击“Apply”。
(2) 点开“Linker”下的“General”,在“Additional Library Directories”中添加ObjectARX软件包的库文件路径,做完之后点击“Apply”。
(3) 在“Output File”中把输出文件的扩展名“.dll”改为“.arx”,点击“ok”完成工程配置的设定。
第四步:在工程中添加代码
(1) 在.NET环境下点开“Projec”下拉菜单,选择“Add New Item”。
(2) 在“Add New Item”对话框里选择“C++ File (.cpp)”文件。
(3) 输入文件名称“HelloWorld”,点“Open”打开文件。
(4) 在“HelloWorld.cpp”中添加以下代码:
//添加ObjectARX头文件
#include "stdafx.h"
#include
#include
//声明两个函数:initApp()和unloadApp()一个作为AutoCAD调用时的初始化函数,另一个作为卸载函数
void initApp();
void unloadApp();
//声明执行函数helloWorld(),用来在AutoCAD的命令行中打印“hello,world!”
void helloWorld();
// 初始化函数,在acrxEntryPoint()函数的kInitAppMsg事件中被调用,
//向AutoCAD命令堆栈中添加新命令组以及ACRX类层次中添加新的自定义类,
// 本实例中无自定义类,故不用初始化新类。
//addCommand函数在AutoCAD命令堆栈中注册新的命令组名“HELLOWORLD_COMMANDS”、
//通用命令名“Hello”、本地命令名“你好”和该命令的执行函数helloWorld
void initApp()
{
acedRegCmds->addCommand("HELLOWORLD_COMMANDS",
"Hello",
"你好",
ACRX_CMD_TRANSPARENT,
helloWorld);
}
// 程序卸载函数,在acrxEntryPoint()函数的kUnloadAppMsg事件中被调用
//从AutoCAD命令堆栈清除已添加的命令以及从ACRX类层次中清除自定义类
void unloadApp()
{
// 从命令堆栈中清除命令组“HELLOWORLD_COMMANDS”
acedRegCmds->removeGroup("HELLOWORLD_COMMANDS ");
}
// 执行函数,在AutoCAD中执行helloWorld命令时被调用
void helloWorld()
{
acutPrintf("\n Hello World!");
}
// ARX程序主函数,与AutoCAD通信的入口,处理AutoCAD发送的各类消息
extern "C" AcRx::AppRetCode
acrxEntryPoint(AcRx::AppMsgCode msg, void* pkt)
{
switch (msg)
{
case AcRx::kInitAppMsg:
acrxDynamicLinker->unlockApplication(pkt);
acrxRegisterAppMDIAware(pkt);
//调用initApp()函数
initApp();
break;
case AcRx::kUnloadAppMsg:
//调用unloadApp()函数
unloadApp();
break;
default;
break;
}
return AcRx::kRetOK;
}
第五步:建立源文件“ArxProject.def”
(1) 在.NET环境下点开“Projec”下拉菜单,选择“Add New Item”。
(2) 在“Add New Item”对话框里选择“Def File (.def)”文件。
(3) 输入文件名称“ArxProject”,点“Open”打开文件。
(4) 在“ArxProject.def”中添加以下代码:
LIBRARY Step01
EXPORTS
acrxEntryPoint PRIVATE
acrxGetApiVersion PRIVATE
到此为止,整个“Step01.ARX”程序已经完成,在.NET环境下编译,如果是按照以上的步骤逐步进行,除了我在软件安装部分提到的,应该不会出现什么错误。你可能会看到这样的警告信息:linker warning :LNK4099 for the rxapi.lib and acedapi.lib libraries during the build.。但这没关系,我编译的时候也遇到,ObjectARXLabs.chm提到了说可以忽略。
四、在AutoCAD中调用ARX应用程序
编译完之后就可以使用生成的ARX程序了,在工程目录“Step01”文件夹的“Debug”子文件夹中有一个“Step01.arx”程序。在AutoCAD中调用ARX程序的方法有几种:
(1) 把“Step01.arx”程序拖放到AutoCAD设计窗口中,直接就可以打开。
(2) 在AutoCAD命令行中键入“ARX”命令,使用“Load”选项打开。
(3) 在AutoCAD的“工具”下拉菜单中选择“加载应用程序”来打开。
(4) 在命令行中键入“APPLOAD”命令也可打开。
我使用AutoCAD 2004和2005都试过,没有太大的区别,只是上述Autodesk公司提供的这几种调用ARX程序的方法中后两种都显示说加载失败,还没找出原因,而前两种加载时会出现不兼容的警告窗口,忽略掉就行了,没有影响。
以上是我学习ARX的一点心得,借鉴了一些前辈的经验,结合在一起,算是比较完整的ARX入门级文章了。要想对ARX有更加深入的了解还是需要看书,多看实例,这样进步应该更快一些。欢迎和我进行技术交流。 |
|