OCCT 实战（2）Windows平台编译OCCT

一、Windows平台编译OCCT

1、准备环境

• 安装工具：
  • Visual Studio（推荐 VS2019/2022，选择 C++ 桌面开发 组件）。
  • CMake（≥3.16，安装时勾选“添加到系统 PATH”）。
  • Qt（≥5.15，安装时勾选 MSVC 版本，与 VS 编译器匹配）。
  • Git（用于拉取 OCCT 源码）。
• 第三方库（必须）：
  • Tcl/Tk： 用于 OCCT 的绘图窗口（Tcl/Tk 提供图形界面支持）。
  • FreeType： 处理字体渲染，用于文本和标签的显示。

2、下载源码

git clone https://git.dev.opencascade.org/repos/occt.git
cd occt
git checkout V7_8  # 切换到稳定版本（如7.8）

3、下载第三方库

下载链接：https://dev.opencascade.org/release

第三方库解压后放到OCCTOCCThirdParty目录下，与OCCT源码同级

4、使用 CMake 配置

步骤一：指定源码目录与编译目录

步骤二：点击"Configure"进行配置

步骤三：配置第三方库路径

• 3RDPARTY_DIR：设置第三方库的路径。

步骤四：配置Qt相关的路径

• Qt5_DIR：明确指定 Qt5 的安装位置，帮助 CMake 正确找到 Qt5 库和头文件。
• BUILD_SAMPLES_QT：勾选，用于控制是否构建基于 Qt 框架的示例程序。

步骤五：配置安装路径

• INSTALL_DIR：指定编译后文件的安装位置。

步骤六：配置要使用的第三方工具

• USE_FREEIMAGE：勾选，用于控制 OCCT 是否集成 FreeImage 库来处理图像格式。

步骤七：配置、生成

• 点击"Configure"进行配置
• 配置完成后点击"Generate"
• 生成完成后点击"Open Project"打开项目

5、编译OCCT源码

如果前面的配置都是OK的，点击"Open Project"可以看到项目结构，如下：

点击"生成" >> “批生成”，批生成用于一次性管理多个项目配置的编译过程。

6、运行示例

如果勾选了BUILD_SAMPLES_QT选项，生成的项目会包含Samples文件夹

• 鼠标右击OCCTOverview，选择"配置启动项目"
• 鼠标右击OCCTOverview，选择"属性" >> “配置属性” >> “调试” >> “环境”，使用下面的配置项

CASROOT=E:\OCCT
CSF_FPE=0
CSF_OCCTResourcePath=E:\OCCT\src
CSF_OCCTDataPath=E:\OCCT\data
CSF_OCCTSamplesPath=E:\OCCT\samples
CSF_OCCTTestsPath=E:\OCCT\tests
CSF_OCCTDocPath=E:\OCCT\dox
QT_DEBUG_PLUGINS=1
PATH=%PATH%;C:\Qt\Qt5.6.3\5.6.3\msvc2015_64\bin;C:\Qt\Qt5.6.3\5.6.3\msvc2015_64\plugins\platforms;E:\OCCThridParty\freetype-2.5.5-vc14-64\bin;E:\OCCThridParty\tcltk-86-64\bin;

• 鼠标右击OCCTOverview，选择"生成"，成功之后运行项目，如下：

7、本地编译官方文档

OCCT有提供在线的官方文档，也可以在本地编译官方手册，如下：

• 三方库tlctk、doxygen、Graphviz对应的bin文件夹，添加到环境变量

• cd 到OCCT源码的adm文件夹，执行下面的命令分别编译用户说明与API说明

  gendoc -overview -s=local
  gendoc -refman -s=local
  

• 在本地查看编译好的文档