C 语言 (Windows)

本章介绍如何在 Windows 系统上用 CMake 和 Visual Studio 配置 Mech-DLK SDK 中的 C 语言 API 的例程。

例程简介

例程分为 2 类:BasicAdvanced

  • Basic 例程:使用 Mech-DLK 导出的各类单级模型推理单张图片、获取并可视化结果;

  • Advanced 例程:级联模型推理、多图同时推理。

Basic

Advanced

使用前提

使用 Mech-DLK SDK 中的 C 语言例程,需先满足以下使用前提:

  • 安装必需软件。

  • 添加相关的环境变量。

安装必需软件

使用 Mech-DLK SDK 的 C 语言例程,必须安装 Mech-DLK SDK、CMake 及 Visual Studio。

安装最新版本的 Mech-DLK SDK

请根据 安装指南 安装 Mech-DLK SDK 及其依赖的第三方库和资源文件。

安装 CMake(3.2 或以上版本)

  1. 下载 CMake:选择 Windows x64 Installer 右侧的安装包。

    cmake download
  2. 安装时,请勾选下图中的两个选项,以将 CMake 添加至环境变量,并创建 CMake 的桌面快捷方式。

cmake 1

安装 Visual Studio(2017 或以上版本)

  1. 下载 Visual Studio 安装包

  2. 安装时,请勾选 桌面应用和移动应用 分类中的“使用 C++ 的桌面开发”工作负荷,再单击右下角的 安装

sample c workload

添加环境变量

请根据以下步骤添加相关的环境变量。

  1. 右键单击桌面上的 此电脑,选择 属性

  2. 选择 高级系统设置,在弹出的 系统属性 对话框的高级选项卡上,单击 环境变量,进入 环境变量 界面。

  3. 系统变量框中,滚动到 Path 并双击它进入到 编辑环境变量 页面。

  4. 单击右上角 新建,添加 Mech-DLK SDK 的路径 xxx\mechdlk_sdk,然后单击 上移 按钮移动该路径至顶部,再单击右下角 确定

添加环境变量后,请重启电脑,使添加的环境变量生效。

构建及运行例程

你可以一次性构建全部例程。

使用 CMake 配置例程

  1. 双击 CMake 桌面图标打开软件。

  2. 选择或输入源码路径与构建目录路径。如果没有构建目录路径,可以直接在源码路径后添加 \build,并继续以下的配置操作。

    Where is the source code

    xxx\mechdlk_sdk\samples\c

    Where to build the binaries

    xxx\mechdlk_sdk\samples\c\build

  3. 单击 Configure。首次配置时,因没有构建目录路径,此时会弹窗请求构建 build 文件夹,请单击 Yes

    create build

    进入配置页面,选择 Visual Studio 的版本,然后单击 Finish

    configuration

    配置成功后,日志最末行将显示 Configuring done

    c windows configuring done
  1. 单击 Generate 生成解决方案。生成成功后,日志最末行将显示 Generating done。然后,单击 Open Project,使用 Visual Studio 打开解决方案。

    c windows generating done
你也可以打开 build 文件夹(路径:xxx\mechdlk_sdk\samples\c\build),找到并双击 MechDLKSDKCSamples.sln 文件,使用 Visual Studio 打开解决方案。

使用 Visual Studio 构建例程

  1. 确认 Visual Studio 工具栏中的解决方案配置为 Release 模式。当前未提供 Debug 版本的 DLL 文件。

  2. 单击 生成  生成解决方案。每个例程会生成对应的 EXE 格式可执行文件,保存在 Release 文件夹中,位于 xxx\mechdlk_sdk\samples\c\build 目录下。

    generate solution
  3. 将项目文件夹中的 resources 文件夹拷贝至以下目录下:

    • xxx\mechdlk_sdk\samples\c\build\Release

  4. 将项目文件夹中的 3rd_dll 文件夹内的全部文件、Mech-DLK SDK 文件夹(xxx/mechdlk_sdk/dll)路径下的全部文件拷贝至xxx\mechdlk_sdk\samples\c\build\Release目录下。

运行例程

你可以在 Visual Studio 中直接运行例程,也可以双击运行例程的可执行文件。

在 Visual Studio 中运行例程

  1. 解决方案资源管理器 窗口中右键单击想要运行的例程,并选择 设为启动项目

    startup project
  2. 单击工具栏中的debugger windows运行该例程。

运行例程可执行文件

打开 Release 文件夹,双击运行与例程同名的 EXE 文件,即可得到运行结果。

我们重视您的隐私

我们使用 cookie 为您在我们的网站上提供最佳体验。继续使用该网站即表示您同意使用 cookie。如果您拒绝,将使用一个单独的 cookie 来确保您在访问本网站时不会被跟踪或记住。