告别几何引擎绑定：FastCAE-GeomOCC模块化架构与核心功能全解析

原创 于 2025-08-08 10:07:01 发布 · 556 阅读 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

告别几何引擎绑定：FastCAE-GeomOCC模块化架构与核心功能全解析

【免费下载链接】APPGeomOCC 基于OCC开源几何建模引擎，实现基础的几何建模功能，基本几何编辑能力，同时建立了一套几何建模的标准接口，能够实现几何引擎的替换。 【免费下载链接】APPGeomOCC 项目地址: https://gitcode.com/FastcaeCode/APPGeomOCC

引言：几何建模的痛点与解决方案

你是否正在寻找一个既能满足复杂几何建模需求，又能避免被特定几何引擎绑定的开源解决方案？FastCAE-GeomOCC（以下简称GeomOCC）正是为解决这一痛点而生。作为基于OpenCASCADE（OCC）几何引擎的开源项目，GeomOCC不仅提供了丰富的几何建模和编辑功能，更重要的是，它建立了一套灵活的几何建模标准接口，为未来可能的几何引擎替换铺平了道路。

读完本文，你将获得：

  • 对GeomOCC项目架构的深入理解
  • 核心功能模块的详细解析
  • 几何建模流程的完整掌握
  • 二次开发与扩展的实用指南
  • 项目编译与部署的 step-by-step 教程

项目概述

项目简介

GeomOCC是FastCAE项目的几何建模核心模块，全称为FastCAE-GeomOCC。它基于OCC开源几何建模引擎，实现了基础的几何建模功能和几何编辑能力，同时构建了一套标准化的几何建模接口。

mermaid

核心特性

  1. 模块化架构：清晰的模块划分，降低耦合度
  2. 标准化接口：统一的几何操作接口，支持引擎替换
  3. 全面的几何功能：从基础图元到复杂操作的完整支持
  4. 高效的几何算法：基于OCC引擎的优化实现
  5. 可扩展性设计：方便二次开发和功能扩展

技术栈

  • 核心引擎：OpenCASCADE (OCC)
  • 编程语言：C++
  • UI框架：Qt
  • 构建工具：qmake/CMake
  • 数据格式：HDF5
  • 脚本支持：Python

系统架构

整体架构

GeomOCC采用分层架构设计，主要分为以下几层：

mermaid

核心模块解析

1. 应用框架模块 (CADOCCApp)

该模块是应用程序的入口点，负责初始化、配置和协调各个组件。

// main.cpp 示例代码
#include "ApplicationCAD.h"

int main(int argc, char *argv[])
{
    ApplicationCAD app(argc, argv);
    
    // 初始化应用
    if (!app.initialize()) {
        return -1;
    }
    
    // 运行应用
    return app.exec();
}

关键类：

  • ApplicationCAD: 应用程序主类
  • ComponentFactory: 组件工厂，负责创建各种组件实例
  • GlobalDataFactory: 全局数据工厂，管理共享数据
  • WorkBenchHandler: 工作台处理器，管理工作模式切换
2. 操作管理模块 (OperatorsModel)

该模块包含了所有几何操作的业务逻辑，是系统的核心功能实现部分。

mermaid

主要管理器类：

类名功能描述核心方法
OperSolidManager实体建模管理createBox(), createCylinder(), createSphere()
OperCurveManager曲线建模管理createLine(), createCircle(), createBSpline()
OperSurfaceManager曲面建模管理createPlane(), createCylinderSurface()
OperTransformationManager几何变换管理translate(), rotate(), scale()
OperBoolManager布尔运算管理booleanUnion(), booleanIntersection(), booleanDifference()
OperImportManager导入管理importSTEP(), importIGES(), importSTL()
OperExportManager导出管理exportSTEP(), exportIGES(), exportSTL()
OperUndoRedo撤销重做管理undo(), redo(), addOperation()
3. 图形数据提供模块 (GraphDataProvider)

该模块负责管理和提供几何数据的可视化信息。

mermaid

4. 用户界面模块 (GUIFrame & GUIWidget)

该模块负责用户交互界面的实现，包括主窗口、渲染窗口、属性面板等。

mermaid

5. 对话框模块 (GUIDialog)

该模块包含了各种功能对话框，用于接收用户输入和展示信息。

主要对话框类型：

  • 图元创建对话框（Box, Cylinder, Sphere等）
  • 曲线创建对话框（Line, Circle, BSpline等）
  • 曲面创建对话框（Plane, CylinderSurface等）
  • 几何编辑对话框（Fillet, Chamfer等）
  • 变换操作对话框（Translate, Rotate, Scale等）
// 示例：创建立方体对话框
void PrimitivesBoxInfoDialog::accept()
{
    // 获取用户输入
    double length = ui->lengthSpinBox->value();
    double width = ui->widthSpinBox->value();
    double height = ui->heightSpinBox->value();
    
    // 创建实体管理器
    OperSolidManager manager;
    
    // 创建立方体
    bool success = manager.createBox(length, width, height);
    
    if (success) {
        QDialog::accept();
    } else {
        QMessageBox::warning(this, tr("Error"), tr("Failed to create box"));
    }
}

核心功能详解

1. 几何建模功能

GeomOCC提供了全面的几何建模功能，支持从简单图元到复杂形体的创建。

基础图元创建

mermaid

代码示例：创建立方体

// 创建实体管理器实例
OperSolidManager solidManager;

// 设置立方体参数
double length = 10.0;
double width = 20.0;
double height = 30.0;

// 设置位置
gp_Pnt origin(0.0, 0.0, 0.0);

// 创建立方体
bool success = solidManager.createBox(origin, length, width, height, "MyBox");

if (success) {
    // 创建成功，更新视图
    updateView();
} else {
    // 处理错误
    showError("Failed to create box");
}
草图功能

草图功能允许用户在指定平面上绘制二维轮廓，作为后续建模操作的基础。

mermaid

三维特征

基于草图或已有几何，创建复杂的三维特征：

  1. 拉伸(Extrusion)

    • 单向拉伸
    • 双向拉伸
    • 对称拉伸
    • 拉伸到面

  2. 旋转(Revolution)

    • 角度旋转
    • 整周旋转
    • 双向旋转

  3. 扫描(Sweep)

    • 沿路径扫描
    • 多截面扫描
    • 引导线扫描

  4. 放样(Loft)

    • 直纹放样
    • 平滑放样
    • 约束放样

2. 几何编辑功能

GeomOCC提供了丰富的几何编辑工具，支持对已有几何进行各种修改操作。

布尔运算

布尔运算是复杂模型创建的基础，支持三种基本运算：

mermaid

代码示例：布尔并集

// 创建布尔运算管理器
OperBoolManager boolManager;

// 获取两个待运算的实体
QString solid1Id = "Solid1";
QString solid2Id = "Solid2";

// 执行并集运算
bool success = boolManager.booleanUnion(solid1Id, solid2Id, "UnionResult");

if (success) {
    // 运算成功，移除原始实体
    removeGeometry(solid1Id);
    removeGeometry(solid2Id);
}
特征操作

常用的特征操作包括：

  • 倒角(Chamfer)：对边进行倒角处理
  • 圆角(Fillet)：对边进行圆角处理
  • 抽壳(Shell)：将实体转换为薄壁壳体
  • 拔模(Draft)：为实体添加拔模角度
  • 加强筋(Rib)：在实体上添加筋结构
几何变换

支持多种几何变换操作：

变换类型描述参数
平移(Translate)沿指定方向移动几何方向向量，距离
旋转(Rotate)绕指定轴旋转几何旋转轴，角度
缩放(Scale)按比例缩放几何缩放中心，比例因子
镜像(Mirror)生成几何的镜像副本镜像平面
阵列(Pattern)创建几何的多个副本阵列类型，数量，间距

3. 数据管理功能

GeomOCC采用HDF5格式进行数据存储，支持复杂几何数据的高效读写。

数据存储架构

mermaid

文件操作

代码示例：保存项目

// 创建保存操作实例
OperSaveHDF5 saveOper;

// 设置文件名
QString fileName = "project.h5";
saveOper.setFileName(fileName);

// 添加所有几何数据
QList<QString> allGeometryIds = getGeometryManager()->getAllGeometryIds();
foreach (QString id, allGeometryIds) {
    saveOper.addGeometry(id);
}

// 执行保存
bool success = saveOper.execute();

if (success) {
    showMessage("Project saved successfully");
} else {
    showError("Failed to save project");
}

代码示例：加载项目

// 创建打开操作实例
OperOpenHDF5 openOper;

// 设置文件名
QString fileName = "project.h5";
openOper.setFileName(fileName);

// 执行加载
bool success = openOper.execute();

if (success) {
    // 获取加载的几何数据
    QList<QString> loadedGeometryIds = openOper.getGeometries();
    
    // 更新视图
    updateView();
    
    showMessage("Project loaded successfully");
} else {
    showError("Failed to load project");
}

4. 可视化功能

GeomOCC提供了强大的几何可视化功能，支持多种显示模式和交互操作。

显示模式

支持多种几何显示模式：

  • 线框模式(Wireframe)
  • 着色模式(Shaded)
  • 隐藏线模式(Hidden Line)
  • 半透明模式(Transparent)
  • 渲染模式(Rendered)
交互操作

支持丰富的视图交互操作：

  • 旋转(Rotate)：按住鼠标左键拖动
  • 平移(Pan)：按住鼠标中键拖动
  • 缩放(Zoom)：鼠标滚轮或按住鼠标右键拖动
  • 选择(Select)：单击鼠标左键
  • 框选(Box Select)：按住Ctrl键+鼠标左键拖动

标准化接口设计

GeomOCC的一大特色是其标准化的几何接口设计，这使得未来可能替换底层几何引擎而不影响上层应用。

接口抽象层

mermaid

接口示例

几何操作接口

// IGeometryOperation.h
class IGeometryOperation {
public:
    virtual ~IGeometryOperation() = default;
    
    // 创建基本几何
    virtual GeometryId createPoint(const Point3D& point) = 0;
    virtual GeometryId createLine(const Point3D& start, const Point3D& end) = 0;
    virtual GeometryId createCircle(const Point3D& center, double radius, const Vector3D& normal) = 0;
    virtual GeometryId createBox(const Point3D& origin, double length, double width, double height) = 0;
    
    // 布尔运算
    virtual GeometryId booleanUnion(const GeometryId& id1, const GeometryId& id2) = 0;
    virtual GeometryId booleanIntersection(const GeometryId& id1, const GeometryId& id2) = 0;
    virtual GeometryId booleanDifference(const GeometryId& id1, const GeometryId& id2) = 0;
    
    // 几何变换
    virtual bool translate(const GeometryId& id, const Vector3D& vector) = 0;
    virtual bool rotate(const GeometryId& id, const Vector3D& axis, double angle) = 0;
    virtual bool scale(const GeometryId& id, const Point3D& center, double factor) = 0;
    
    // 几何查询
    virtual BoundingBox getBoundingBox(const GeometryId& id) = 0;
    virtual GeometryType getGeometryType(const GeometryId& id) = 0;
};

开发与部署

环境配置

开发环境要求
  • 操作系统：Windows 10/11, Linux (Ubuntu 20.04+), macOS 10.15+
  • 编译器：MSVC 2019+, GCC 9+, Clang 10+
  • Qt版本：Qt 5.15+
  • OCC版本：OpenCASCADE 7.5+
  • 其他依赖：HDF5 1.10+, Python 3.8+
编译步骤
  1. 获取代码
git clone https://gitcode.com/FastcaeCode/APPGeomOCC.git
cd APPGeomOCC
  1. 配置依赖
# 安装必要依赖
sudo apt-get install build-essential qt5-default libocct-foundation-dev libocct-modeling-algorithms-dev libocct-visualization-dev libhdf5-dev python3-dev
  1. 编译项目
# 创建构建目录
mkdir build && cd build

# 配置项目
qmake ../CADOCCApp.pro

# 编译
make -j$(nproc)
  1. 安装
sudo make install

二次开发指南

扩展几何操作

GeomOCC设计了便捷的扩展机制，允许开发者添加自定义的几何操作。

步骤1：创建操作管理器

// MyCustomOperationManager.h
#include "OperManagerBase.h"

class OperMyCustomOperation : public OperManagerBase {
    Q_OBJECT
public:
    explicit OperMyCustomOperation(QObject* parent = nullptr);
    
    // 实现必要的接口
    bool execute() override;
    void undo() override;
    void redo() override;
    
    // 设置操作参数
    void setParameters(double param1, const QString& param2);
    
private:
    double m_param1;
    QString m_param2;
    QString m_resultId; // 存储操作结果ID，用于撤销
};

步骤2：实现操作逻辑

// MyCustomOperationManager.cpp
#include "MyCustomOperationManager.h"
#include "GeometryManager.h"

OperMyCustomOperation::OperMyCustomOperation(QObject* parent)
    : OperManagerBase(parent), m_param1(0) {}

void OperMyCustomOperation::setParameters(double param1, const QString& param2) {
    m_param1 = param1;
    m_param2 = param2;
}

bool OperMyCustomOperation::execute() {
    // 获取几何管理器
    auto geomManager = getGeometryManager();
    
    // 执行自定义操作
    m_resultId = geomManager->myCustomOperation(m_param1, m_param2);
    
    return !m_resultId.isEmpty();
}

void OperMyCustomOperation::undo() {
    // 撤销操作：删除创建的几何
    if (!m_resultId.isEmpty()) {
        getGeometryManager()->removeGeometry(m_resultId);
    }
}

void OperMyCustomOperation::redo() {
    // 重做操作：重新执行
    execute();
}

步骤3：注册操作

// 在应用初始化时注册
void ApplicationCAD::registerCustomOperations() {
    // 注册自定义操作
    OperationRegistry::instance()->registerOperation(
        "MyCustomOperation", 
        []() { return new OperMyCustomOperation(); },
        "Custom Operations",
        "My Custom Operation"
    );
}

步骤4：创建UI界面

为新操作创建对话框，用于接收用户输入的参数。

应用场景

GeomOCC可应用于多个领域的几何建模需求：

工程仿真前处理

在CAE仿真流程中，GeomOCC可作为前处理模块，为仿真提供高质量的几何模型。

mermaid

CAD系统开发

基于GeomOCC可快速开发专用CAD系统，满足特定行业需求。

几何算法研究

作为开源项目，GeomOCC也是几何算法研究的理想平台，研究者可在此基础上实现和验证新算法。

教育与培训

GeomOCC的开源特性使其成为几何建模教育的良好工具，学生可通过源码学习几何建模原理和实现。

项目 roadmap

当前版本 (v2.0.0)

  • 基础几何建模功能
  • 几何编辑能力
  • 标准化接口设计
  • HDF5数据存储
  • 基本UI界面

未来计划

短期计划 (v2.1.0)

  • 增强草图功能
  • 增加更多几何操作
  • 优化UI体验
  • 提升性能

中期计划 (v3.0.0)

  • 支持更多几何格式
  • 增强可视化效果
  • Python接口完善
  • 并行计算支持

长期计划 (v4.0.0)

  • 多引擎支持
  • 云协同功能
  • AI辅助建模
  • VR/AR可视化

总结与展望

FastCAE-GeomOCC项目通过基于OCC引擎构建标准化几何建模接口，为CAE仿真和CAD系统开发提供了强大而灵活的几何建模解决方案。其模块化架构和标准化接口设计不仅保证了当前功能的稳定性和高效性，也为未来的扩展和优化奠定了基础。

随着项目的不断发展，我们期待GeomOCC能够：

  1. 成为开源CAE社区的核心几何模块
  2. 支持更多先进的几何建模算法
  3. 构建活跃的开发者社区
  4. 培养更多几何建模领域的人才

无论您是CAE工程师、CAD开发者，还是对几何建模感兴趣的研究者，GeomOCC都为您提供了一个理想的平台。我们欢迎您加入项目，共同推动开源几何建模技术的发展！

资源与支持

  • 项目仓库：https://gitcode.com/FastcaeCode/APPGeomOCC
  • 文档：项目Doc目录下的文档和教程
  • 社区：FastCAE用户交流群
  • 贡献指南：参见项目CONTRIBUTING.md

附录

常用类参考

类名头文件功能描述
ApplicationCADApplicationCAD.h应用程序主类
MainWindowMainWindow.h主窗口类
OperSolidManagerOperSolidManager.h实体建模管理器
OperTransformationManagerOperTransformationManager.h几何变换管理器
RenderWidgetRenderWidget.h几何渲染窗口
GeometryManagerGeometryManager.h几何数据管理

常见问题解答

Q: GeomOCC支持哪些几何格式导入导出？ A: 当前版本支持STEP、IGES、STL等常见格式的导入导出，未来将增加更多格式支持。

Q: 如何替换GeomOCC的几何引擎？ A: GeomOCC采用标准化接口设计，只需实现新的几何引擎接口并在配置中指定即可替换。

Q: GeomOCC是否支持大规模几何模型？ A: GeomOCC针对大规模模型进行了优化，支持多级LOD显示和增量渲染，可处理复杂模型。

Q: 如何参与GeomOCC项目开发？ A: 您可以通过项目仓库提交issue和PR，或加入开发者社区参与讨论。

Q: GeomOCC的许可证是什么？ A: GeomOCC采用LGPL许可证，允许商业使用，但修改的源码需要开源。

如果您觉得本文对您有帮助，请点赞、收藏并关注项目更新！下期我们将带来"GeomOCC高级建模技术"专题，敬请期待！

【免费下载链接】APPGeomOCC 基于OCC开源几何建模引擎，实现基础的几何建模功能，基本几何编辑能力，同时建立了一套几何建模的标准接口，能够实现几何引擎的替换。 【免费下载链接】APPGeomOCC 项目地址: https://gitcode.com/FastcaeCode/APPGeomOCC

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值