Win7上开发CAD2004自定义实体全解析

CAD2004二次开发中，针对自定义实体的开发环境配置完全可以在Windows 7系统上进行，并且Windows 7是该开发工作流中一个比原生支持的Windows XP/2000更现代、更常见且相对稳定的平台选择。其可行性、具体配置方法与注意事项，可归纳为下表：

方面	在 Windows 7 上的支持情况与说明
操作系统兼容性	完全支持。Windows 7 (32位) 是运行AutoCAD 2004的官方兼容操作系统之一。作为开发宿主机，其运行Visual Studio .NET 2002和ObjectARX 2004 SDK无本质障碍。
核心开发工具链	支持，但需注意安装细节。Visual Studio .NET 2002 (VC7.0) 和 ObjectARX 2004 SDK 均可安装在Win7上。安装过程中可能需以管理员身份运行安装程序，并可能需要为旧版IDE安装特定补丁（如VS2002的SP1）以确保其在Win7上更稳定运行。
编译与调试	完全支持 。在Win7上配置好项目后，可正常编译生成.arx文件。调试时，可将Visual Studio调试器附加到在Win7上运行的acad.exe进程（CAD2004），进行源代码级断点调试、变量查看等操作。
相对于XP的优势	1. 系统稳定性与安全性 ：Win7提供了更现代化的系统内核和安全机制。 2. 开发工具兼容性 ：对现代外设（如高分辨率显示器）的支持更好，且可同时安装更新的工具（如代码编辑器、版本控制系统）辅助开发。 3. 驱动与网络支持：拥有更广泛的硬件驱动和网络功能支持。
主要挑战与注意事项	1. UAC（用户账户控制） ：在安装旧版开发工具或运行CAD时，可能需暂时禁用UAC或以管理员权限运行程序，以避免权限问题。 2. .NET Framework版本 ：需确保系统安装了VS2002所需的.NET Framework 1.0/1.1。Win7默认可能未安装，需手动添加。 3. 目标环境一致性 ：最终生成的.arx模块在Win7上开发，但仍需确保在目标用户的CAD2004环境（可能是WinXP或Win7）中经过充分测试。

在Windows 7上配置开发环境的具体步骤与代码验证

以下是在Windows 7系统上搭建CAD2004自定义实体开发环境的关键步骤和验证方法：

1. 环境准备与安装

• 安装AutoCAD 2004：确保CAD2004在Win7上成功安装并可正常运行。这是测试自定义实体的最终环境。

• 安装Visual Studio .NET 2002 ：

  # 这是一个示意性步骤说明，非可执行代码
  # 1. 获取VS2002安装镜像或安装包。
  # 2. 右键点击安装程序，选择"以管理员身份运行"。
  # 3. 按照向导完成安装。建议安装SP1补丁以提升在Win7上的兼容性。

• 安装ObjectARX 2004 SDK ：

  # 示意性步骤
  # 1. 从Autodesk官方网站或存档站点下载ObjectARX 2004 SDK。
  # 2. 以管理员身份运行安装程序，将其安装到指定目录，例如 `C:\ObjectARX 2004`。

• 安装ObjectARX Wizards for VS2002：此向导插件能极大简化项目创建。安装后，在VS2002的新建项目对话框中应出现"ObjectARX/DBX/OMF Project"模板。

2. 创建与配置项目

在Visual Studio .NET 2002中创建ObjectARX项目，并进行关键配置。

• 新建项目：使用向导创建"ObjectARX Project"。

• 配置项目属性：

  • 包含目录 ：添加ObjectARX SDK的inc文件夹路径。
  • 库目录 ：添加ObjectARX SDK的lib文件夹路径。
  • 预处理器定义 ：确保包含ACRXAPP，RADPACK等。
  • 链接器输入：在附加依赖项中添加必要的库文件。

  一个典型的库链接配置示例如下（在项目属性中设置）：

  // 链接器 -> 输入 -> 附加依赖项
  acad.lib rxapi.lib acdb.lib acedapi.lib acge.lib acgiapi.lib

3. 编写并验证一个简单的自定义实体

创建一个最简单的自定义实体，用于验证环境是否正常工作。以下是一个在Win7开发环境下编译和测试的示例实体框架：

头文件 SimpleLineEnt.h

// SimpleLineEnt.h
#pragma once
#include <dbents.h>

class SimpleLineEnt : public AcDbEntity
{
public:
    ACRX_DECLARE_MEMBERS(SimpleLineEnt);
    SimpleLineEnt();
    SimpleLineEnt(const AcGePoint3d& start, const AcGePoint3d& end);
    virtual ~SimpleLineEnt() = default;

    // 必须重写的核心函数
    virtual Adesk::Boolean worldDraw(AcGiWorldDraw* mode) override;
    virtual Acad::ErrorStatus transformBy(const AcGeMatrix3d& xform) override;
    
    // 持久化
    virtual Acad::ErrorStatus dwgInFields(AcDbDwgFiler* filer) override;
    virtual Acad::ErrorStatus dwgOutFields(AcDbDwgFiler* filer) const override;

    // 自定义数据访问
    AcGePoint3d startPoint() const;
    AcGePoint3d endPoint() const;
    void setPoints(const AcGePoint3d& start, const AcGePoint3d& end);

private:
    AcGePoint3d m_start;
    AcGePoint3d m_end;
};

源文件 SimpleLineEnt.cpp

// SimpleLineEnt.cpp
#include "StdAfx.h"
#include "SimpleLineEnt.h"

// 运行时类注册 (这是关键，确保实体能被CAD识别和创建)
ACRX_DXF_DEFINE_MEMBERS(SimpleLineEnt, AcDbEntity,
    AcDb::kDHL_CURRENT, AcDb::kMReleaseCurrent, 0,
    SIMPLELINEENT, "MyTestApp");

SimpleLineEnt::SimpleLineEnt() : m_start(0,0,0), m_end(100,0,0) {}
SimpleLineEnt::SimpleLineEnt(const AcGePoint3d& start, const AcGePoint3d& end)
    : m_start(start), m_end(end) {}

Adesk::Boolean SimpleLineEnt::worldDraw(AcGiWorldDraw* mode)
{
    assertReadEnabled();
    // 使用AcGiWorldDraw的几何接口绘制一条线段
    mode->geometry().polyline(2, m_start, m_end);
    return Adesk::kTrue;
}

Acad::ErrorStatus SimpleLineEnt::transformBy(const AcGeMatrix3d& xform)
{
    assertWriteEnabled();
    m_start.transformBy(xform);
    m_end.transformBy(xform);
    return Acad::eOk;
}

Acad::ErrorStatus SimpleLineEnt::dwgOutFields(AcDbDwgFiler* filer) const
{
    assertReadEnabled();
    Acad::ErrorStatus es = AcDbEntity::dwgOutFields(filer);
    if (es != Acad::eOk) return es;
    filer->writePoint3d(m_start);
    filer->writePoint3d(m_end);
    return filer->filerStatus();
}

Acad::ErrorStatus SimpleLineEnt::dwgInFields(AcDbDwgFiler* filer)
{
    assertWriteEnabled();
    Acad::ErrorStatus es = AcDbEntity::dwgInFields(filer);
    if (es != Acad::eOk) return es;
    filer->readPoint3d(&m_start);
    filer->readPoint3d(&m_end);
    return filer->filerStatus();
}

// Getter/Setter 实现
AcGePoint3d SimpleLineEnt::startPoint() const { assertReadEnabled(); return m_start; }
AcGePoint3d SimpleLineEnt::endPoint() const { assertReadEnabled(); return m_end; }
void SimpleLineEnt::setPoints(const AcGePoint3d& start, const AcGePoint3d& end)
{ assertWriteEnabled(); m_start = start; m_end = end; }

应用程序入口与命令注册 MyArxApp.cpp

// MyArxApp.cpp - ARX模块入口点
#include "StdAfx.h"
#include "SimpleLineEnt.h"

// 用于创建实体的命令函数
void createSimpleLine()
{
    AcDbDatabase* pDb = acdbHostApplicationServices()->workingDatabase();
    AcDbBlockTableRecord* pModelSpace;
    AcDbObjectId newEntId;

    // 获取模型空间块表记录的写权限
    AcDbBlockTable* pBlockTable = nullptr;
    pDb->getBlockTable(pBlockTable, AcDb::kForRead);
    pBlockTable->getAt(ACDB_MODEL_SPACE, pModelSpace, AcDb::kForWrite);
    pBlockTable->close();

    // 创建自定义实体对象
    SimpleLineEnt* pLine = new SimpleLineEnt(AcGePoint3d(0,0,0), AcGePoint3d(200,100,0));
    
    // 添加到模型空间
    pModelSpace->appendAcDbEntity(newEntId, pLine);
    pModelSpace->close();
    pLine->close();

    acedPrompt(_T("
简单自定义线段已创建。"));
}

// ARX程序入口函数
extern "C" AcRx::AppRetCode acrxEntryPoint(AcRx::AppMsgCode msg, void* pkt)
{
    switch (msg)
    {
        case AcRx::kInitAppMsg:
            acrxUnlockApplication(pkt); // 允许卸载
            SimpleLineEnt::rxInit();    // 初始化自定义类
            acrxBuildClassHierarchy();  // 构建类层次
            // 注册一个测试命令
            acedRegCmds->addCommand(_T("TEST_COMMANDS"),
                                    _T("MAKESIMPLELINE"),
                                    _T("MAKESIMPLELINE"),
                                    ACRX_CMD_MODAL,
                                    &createSimpleLine);
            break;
        case AcRx::kUnloadAppMsg:
            acedRegCmds->removeGroup(_T("TEST_COMMANDS")); // 清理命令
            deleteAcRxClass(SimpleLineEnt::desc()); // 从运行时系统中删除类
            break;
    }
    return AcRx::kRetOK;
}

4. 编译、加载与测试

1. 编译 ：在Visual Studio .NET 2002中编译上述项目，生成 .arx 文件（如 MyTestApp.arx）。
2. 在CAD2004中加载 ：
   • 在Win7上启动AutoCAD 2004。
   • 在命令行输入 ARX 命令，然后选择"加载(L)"，浏览并选择编译好的 .arx 文件。
   • 或者使用 AppLoad 命令通过对话框加载。
3. 运行测试命令 ：
   • 在CAD命令行输入 MAKESIMPLELINE（即我们注册的命令）。
   • 如果环境配置正确，图形窗口将出现一条从(0,0)到(200,100)的线段。使用 LIST 命令选择该线段，应显示其为 SIMPLELINEENT 类型的自定义实体，而非普通的 LINE 实体。

5. 调试

在Win7上进行调试与在XP上无异：

1. 在Visual Studio中打开项目。
2. 设置好调试符号路径（指向你的 .pdb 文件）。
3. 在CAD2004中，通过 ARX 命令加载你的 .arx 文件。
4. 在VS中，选择"调试" -> "附加到进程"，在进程列表中找到 acad.exe 并附加。
5. 在代码中设置断点（例如在 createSimpleLine 函数内），然后在CAD中运行 MAKESIMPLELINE 命令，程序将在断点处暂停，即可进行单步调试、变量监视等操作。

结论与最佳实践建议

在Windows 7系统上进行CAD2004的自定义实体开发环境配置不仅是可行的，而且是实践中常见的选择。成功的关键在于严格按照ObjectARX 2004 SDK和Visual Studio .NET 2002的版本要求进行安装和项目配置。

最佳实践建议：

1. 使用虚拟机（可选但推荐）：为了保证开发环境的纯净和与最终用户环境（可能仍是XP）的高度一致性，可以考虑在Win7主机上使用虚拟机（如VMware或VirtualBox）安装一个Windows XP系统，并在其中搭建完整的CAD2004开发环境。这样既能利用Win7宿主机的性能，又能完全模拟目标运行环境。
2. 备份与版本控制：对项目源码和关键配置文件进行定期备份，并使用版本控制系统（如Git，可在Win7上安装现代客户端进行管理）。
3. 分阶段测试：在Win7上开发调试通过后，务必在最终用户可能使用的操作系统（如Windows XP）上的CAD2004中进行兼容性测试，确保自定义实体在所有目标平台上功能正常。

通过上述步骤，即可在Windows 7系统上成功搭建并运行CAD2004自定义实体的完整开发、编译、调试和测试工作流。

---

参考来源

• 基于WSL2的ubuntu(Windows 子系统)安装及开发环境搭建
• cad文件在线查看
• Metal、Vulkan、DirectX 图形引擎架构演进