开发文档 | 钛川工业 CAD 组件

入门指南

快速集成-MFC

在 Visual Studio 里从零创建一个多文档 MFC 程序，把 TSE 三维视口嵌入到 CView 中，并完成引擎启动、视口缩放与运行时 DLL 部署。

开发环境Visual Studio · MFC
平台Windows x64
语言C++

集成完成后运行程序出现的 TSE 3D 视口界面 — 完成后的效果：TSE 三维视口已嵌入 MFC 视图，并随窗口尺寸自适应

创建一个默认的多文档 MFC 程序

按照 VS 默认配置生成一个多个文档的 MFC 程序

尝试运行一下这个项目，效果如下

编辑附加依赖项增加 sdk lib 库

增加 flow_bridge_platform.dll.lib
增加 flow_bridge_adaptor_hwnd.lib

在 MFC 代码中引入 tse.hpp 文件

定义 ENABLE_ENGINE_HWND_ADAPTOR 以开启 HWND UI 适配器
包含 hpp/tse.hpp 文件以获取 SDK 功能接口

在 simple_mfcView.cpp 中定义 ENABLE_ENGINE_HWND_ADAPTOR 并包含 tse.hpp

在成员函数中放置一个 m_hwnd 成员变量标识引擎窗口

在 CView 中添加 OnInitialUpdate 方法

在 OnInitialUpdate 函数中填入以下代码以启动引擎，创建窗口句柄

simple_mfcView.cpp

void CsimplemfcView::OnInitialUpdate()
{
    CView::OnInitialUpdate();

    // 设置许可证，在这里写入许可证
    tse::EngineSingleton::instance().set_license_key("00-A1111111-G2222222-K3333333-B4444444");

    // 启动引擎
    tse::EngineSingleton::instance().startup_sync();

    // 创建 UI 句柄
    m_hwnd = tse::EngineSingleton::instance().create_hwnd_widget();
    // 绑定父窗口
    ::SetParent(m_hwnd, GetSafeHwnd());

    // 显示引擎视图
    ::ShowWindow(m_hwnd, SW_SHOW);
}

在 CView 中绑定 WM_SIZE 消息

在 CView 中添加一个 OnSize 函数处理引擎视口缩放

在 OnSize 函数中填入如下代码以处理引擎视口缩放

simple_mfcView.cpp

void CsimplemfcView::OnSize(UINT nType, int cx, int cy)
{
    CView::OnSize(nType, cx, cy); // 先调用基类

    // 安全过滤：最小化或尺寸无效时直接返回
    if (nType == SIZE_MINIMIZED || cx <= 0 || cy <= 0)
        return;

    m_hwnd; // 引擎窗口句柄

    // 检查目标子窗口是否有效）
    if (m_hwnd && ::IsWindow(m_hwnd))
    {
        // 使用新的 cx, cy 调整子窗口大小，使其填满客户区
        ::SetWindowPos(m_hwnd, nullptr, 0, 0, cx, cy,
            SWP_NOZORDER | SWP_NOACTIVATE);
    }
}

将 SDK 对应的 DLL 复制到 mfc 可执行文件的目录下

运行程序即可出现 3D 界面

入门指南

快速集成-Qt5

使用 Qt Creator 从零创建一个 Qt Widgets 项目，把 TSE 三维视口嵌入到 QWidget 中，并完成引擎启动、视口缩放与运行时 DLL 部署。

开发环境Qt Creator · Qt 5
构建系统CMake
语言C++

使用 Qt Creator 创建一个 Qt Widgets 项目

选择 CMake 构建系统

本文使用 CMake 构建。

按照默认配置完成项目创建

在 Qt Creator 中选择 Qt 5.12.12 MSVC2017 64 位 Kit

先运行默认项目确认窗口正常

在 CMakeLists.txt 中引入 SDK 代码库

CMakeLists.txt

find_package(flow_bridge REQUIRED)
find_package(flow_bridge_adaptor_qt5 REQUIRED)

target_link_libraries(
  simple_qt PRIVATE
    flow_bridge::flow_bridge      # 引擎内核
    flow_bridge::adaptor_qt5      # 引擎 Qt 视口封装
)

flow_bridge_deploy_runtime(simple_qt) # 部署引擎内核二进制资源
flow_bridge_adaptor_qt5_deploy_runtime(simple_qt) # 部署引擎 Qt 视口二进制资源

在 Qt Creator 的构建环境中配置 CMake 包路径

flow_bridge_DIR：用于寻找引擎内核，指向 SDK 的 CMake 目录
flow_bridge_adaptor_qt5_DIR：用于寻找引擎 Qt5 适配器，指向 SDK 的 CMake 目录

在主窗口中启动引擎并嵌入 Qt 视口

在 MainWindow 构造函数中设置许可证、启动引擎，再将创建的 Qt 控件设为主窗口的中心控件。

mainwindow.cpp

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 设置引擎许可证
    tse::EngineSingleton::instance().set_license_key("00-A1111111-G2222222-K3333333-B4444444");

    // 启动引擎
    tse::EngineSingleton::instance().startup_sync();

    // 创建引擎 QWidget 控件
    QWidget* view = tse::EngineSingleton::instance().create_qt5_widget(nullptr);

    // 嵌入主界面
    setCentralWidget(view);
}

将 SDK bin 目录下的 DLL 复制到可执行文件目录

把 SDK 的 bin 目录下所需 DLL 放到编译生成的 exe 同级目录。

运行程序查看 3D 界面