开发功能
=============

    本章将详细介绍 DaoAI 3D AOI Viewer 软件开发包 (SDK) 的配置和使用。DaoAI 3D AOI Viewer 提供了一套全面的工具，用于调用各种相机功能、处理输出及执行其他通用功能，以满足软件开发的需求。

前提设置
------------

你需要以下的前提准备来使用软件开发包功能。

* 安装 `DaoAI AOI 软件(建议下载最新版本) `
* 下载 `OpenCV – 4.5.5 <https://opencv.org/releases/>`_
* 下载 `Visual Studio IDE Community <https://visualstudio.microsoft.com>`_

安装 DaoAI AOI 软件
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    在使用软件开发包前，必须先安装 DaoAI AOI软件，点击软件安装包的下载 `链接 <https://daoairoboticsinc-my.sharepoint.com/:u:/g/personal/nrd_daoai_com/EdKJCff1FZ9ClC7MIaxq9y8BLbV-112OPUvoruQvobZYsQ?e=eZBTfd>`_ ，建议安装最新版本的软件。关于安装详情，请查阅： :ref:`软件安装指南` 。

OpenCV
~~~~~~~

    下载 OpenCV-4.5.5 后，如果您选择的是 Windows 包，那你会看到下图的 **.exe** 文件，双击运行(解压)。

    .. image:: images/opencv_download.png
            :scale: 120%
    
    解压后，OpenCV库的文件就在你解压目录的 opencv 文件夹中。

    .. image:: images/opencv_unzip.png
            :scale: 100%

Visual Studio
~~~~~~~~~~~~~~

    在这个例子中，使用了 **Visual Studio IDE 2022 Community** ，打开 **Visual Studio Installer** ，选择 **“Modify”** 。

    .. image:: images/modify_vs.png
            :scale: 80%

    最重要的两个是： **Windows 10 SDK(最新的版本即可)** 和 **MSVC v142** ，如下图所示，勾选、下载并安装：

    .. image:: images/vs_installation_details.png
            :scale: 100%

    重新启动 Visual Studio 后将会自动安装完成。打开 Visual Studio ，打开 **DaoAI AOI SDK示例代码** 的 **aoi_ad3dcamera_samples.sln** 项目。

    .. image:: images/example_path.png
            :scale: 100%

    创建 DaoAI AOI 项目后，你需要配置其中的项目设置。

    .. image:: images/projects.png
            :scale: 100%

    以下方的项目举例, 这是(aoi_ad3dcamera_samples)C++项目。右键点击 **Solution** 的 properties，可以选择启动项目，点击 **应用** 并 **OK** 。

    .. image:: images/startup_project.png
            :scale: 80%

    然后选择启动设置为release x64, 然后点击Local Windows Debugger 就可以运行项目了。

    .. image:: images/run_0.png
        :scale: 80%
        
|

环境配置
------------


    此处会使用 aoi_ad3dcamera_samples 演示，进行以下项目的配置。

    右键点击 aoi_ad3dcamera_samples C++ 的项目，然后打开属性。
        
        .. image:: images/properties_page.png
            :scale: 80%

    在 **通用(General)** 的 **平台工具集(Platform Toolset)** 选取 **Visual Studio 2019 (v142)** 。

        .. image:: images/v142.png
            :scale: 80%
    

    打开 **C++** , 在 **常规(General)** 菜单里的 **Additional Include Directories** 中添加 DaoAI AOI 安装目录下的 **include** 文件夹路径：通常在 **C:\\Program Files\\DaoAI AOI\\SDK\\3D Camera\\include** 
    如果你的工程需要OpenCV处理，还有 OpenCV 库解压后的 include 文件夹路径：通常在 **解压目录\\opencv\\build\\include**

        .. image:: images/add_include_sdk.png
            :scale: 80%

    打开 **Linker**, 在 **常规(General)** 菜单里的 **Additional Library Directories** 中添加 DaoAI AOI 安装目录下的 **lib** 文件夹路径：通常在 **C:\\Program Files\\DaoAI AOI\\SDK\\3D Camera\\lib** 
    如果你的工程需要OpenCV处理，还有 OpenCV 库解压后的 include 文件夹路径：通常在 **解压目录\\opencv\\build\\x64\\vc15\\lib**
        
        .. image:: images/add_lib_linker.png
            :scale: 80%

    打开 **Linker**, 在 **输入(Input)** 菜单里的 **Additional Library** 中添加 aoi_ad3dcamera.lib 
    如果你的工程需要OpenCV处理，还有 OpenCV 库的opencv_world455.lib
        
        .. image:: images/add_lib.png
            :scale: 80%

常见问题
------------

当你完成上述配置后，出现无法运行，提示无法找到 aoi_ad3dcamera.dll 。

你可以查看 Debugging 环境是否有多余的环境变量：右键点击项目，在 **Debugging** 菜单里的 **Environment** 是否存在变量，如有，请删掉所有的变量。