19.4 在 Windows 下创建应用程序

使用 HALCON 算子的 C 程序必须包含 HalconC.h 文件，该文件包含所有与用户相关的 HALCON 系统定义以及 C 接口所需的声明。为此，请在 C 文件顶部添加以下命令：

  #include "HalconC.h"

要创建应用程序，您必须将函数库 halconc.lib/.dll 链接到您的程序中。

示例项目显示了必要的 Visual C++ 设置。在示例中，项目应为 WIN 32 ConsoleApplication 类型。请注意，如果项目中添加了新文件，Visual C++ 编译器会隐式调用 "更新所有依赖项"。由于 HALCON 既可在 Windows 下运行，也可在 Linux 下运行，因此如果在 Linux 下包含文件 HalconC.h，则包含若干 Linux 专用头文件。由于在 Windows 下不存在这些头文件，而且 Visual C++ 编译器会忽略包含文件中的操作系统特定情况，因此您会收到许多关于缺少头文件的警告信息。这些都可以忽略。

确保栈大小足够。某些复杂的图像处理问题需要高达 1 MB 的栈大小，因此请确保对编译器进行相应配置。有关该主题的更多信息，请参阅编译器手册。

HALCON XL 应用：  ! 
请注意，只有在需要 HALCON XL 功能时才使用。

如果要使用 HALCON XL，则必须在项目中链接 halconxl.lib/.dll 和 halconcxl.lib/.dll 库，而不是 halcon.lib/.dll 和 halconc.lib/.dll。

在 Windows 下使用 CMake 构建 HALCON 示例

您可以在 %HALCONEXAMPLES%\c 下面的目录中找到展示各种 HALCON 用例以及如何用 C 语言实现这些用例的示例。您可以使用提供的 CMakeLists.txt 文件用 CMake 构建这些示例。

要使用 CMake 生成示例程序，请执行以下操作：

1. 如有需要，请从 CMake 网站 下载 CMake（3.7.1 或更高版本）并安装。
2. 创建构建目录，然后运行 cmake 配置构建并创建应用程序：

     mkdir build
     cd build
     cmake %HALCONEXAMPLES%\c
     cmake --build .
   

   要进行配置，CMake 需要知道 HALCON 安装的位置、示例文件的位置以及要使用的 HALCON 架构：

   • 通过 HALCON_DIR CMake 选项指定 HALCON 的安装位置，如果未设置该选项，则通过 %HALCONROOT% 环境变量指定。
   • 通过 %HALCONEXAMPLES% 环境变量指定 HALCON 示例文件的位置。
   • 使用 HALCON_ARCHITECTURE CMake 选项或 %HALCONARCH% 环境变量指定 HALCON 架构。如果选项和环境变量都未设置，CMake 将尝试根据主机构建系统来猜测架构。

   有关如何使用 CMake 的一般信息，请参阅 CMake 文档 。

   HALCON XL 应用：默认情况下，示例将使用标准版本的 HALCON 构建。如果要使用 HALCON XL 进行编译，请在 CMake 配置步骤中将选项 HALCON_XL 设为 ON 或 1。为此，请使用以下语法：

     cmake -DHALCON_XL=1 %HALCONEXAMPLES%\c
   

3. 作为选项，您可以使用 -G 选项指定新构建树的生成器。
   有关 CMake 生成器的更多信息，请参阅 CMake 文档 。