VISP学习：二、Visp的手动安装

一、 简要说明

可能有的同学在快速安装之后已经注意到了，原生GDI的调用依然遇到问题。比如某些不能指定显示支持的类和api，无法指定使用opencv的显示框架。所以此处采用手动安装的方法禁用GDI，以及安装第三方库。过程如官网教程所示，本篇教程做简单的翻译和修改。

官网教程链接：https://visp-doc.inria.fr/doxygen/visp-daily/tutorial-install-win10-msvc15.html （vs2019教程请自己移步官方文档，过程基本类似）

前期准备：同上一篇教程，Visual studio 2017、cmake、git、所需要的第三方库安装包（opencv等）

二、 第三方库的安装（以opencv为例，其他略同，详细步骤见官网）

1. 先建立visp的文件夹。目录自定。文件夹命名为visp-ws

2. 打开opencv的安装包，安装opencv。
   
   需要注意，安装目录设置到上级目录即可，安装程序会自动设置子文件夹。
   如图填写安装路径，最后的安装路径即 C:\visp-ws\opencv

3. 随后将安装好的opencv文件夹改名为opencv-版本号
   例如：opencv-4.3.0

4. 添加环境变量
   右键“此电脑”->属性->高级系统设置->“高级“选项卡->环境变量
   先添加OpenCV_DIR环境变量
   当前用户的环境变量处点击新建（变量值路径自己按实际修改）
   变量名：OpenCV_DIR
   变量值：C:\visp-ws\opencv-4.3.0\build

再添加Path环境变量
双击当前用户环境变量里面的path
新建如下路径：C:\visp-ws\opencv-4.3.0\build\x64\vc15\bin
点击确定。至此opencv第三方库配置完成。
（Eigen3的配置有可能导致后面sln文件编译不成功，后面会再说）

三、 获取Visp源码
这里有很多种方式，上个教程已经说过。如：
打开cmd，输入如下指令（如果安装位置不是系统盘，需要先输入盘符，改变指令位置）

d:
cd D:\visp-ws
git clone https://github.com/lagadic/visp.git

如果路径中存在空格，如Program Files
那么在整个路径外侧打上双引号，如 ” D:\ Program Files “
关于更多dos命令行的技巧请自行百度。

四、 利用Cmake配置.sln解决方案

1. 打开Cmake，并填写好源代码文件路径和生成方案保存路径
   
2. 单击configure按钮进行配置。
   弹出对话框点击“是“，以创建生成方案保存路径

选择编译器，选择x64。然后点击finish。

随后会自动检测到第三方库。如前文所述，Visp自带的显示api无法使用。所以此处把USE_GDI取消勾选（点击一下图中USE_GDI右侧的勾），部分同学eigen的第三方配置出错也会导致后面sln文件编译不成功，此处也可取消勾选。
再次点击configure按钮，所有红线应该消失。最后点击generate。生成sln文件。

3. 生成并安装ViSP库
   使用vs2017（注意不要是blender）打开…/visp-build-vc15/VISP.sln解决方案文件
   将配置修改为release。之后进入菜单"Build > Build Solution"或点击“ Ctrl + Shift + B” 以构建ViSP。
   
   生成后如图
   
   然后右键右侧的Install，点击生成（generate）
   
   结果如图
   

五、 添加Visp环境变量
添加path：…\visp-build-vc15\install\x64\vc15\bin (…自己补全)
添加环境变量VISP_DIR
…\visp-build-vc15\install

至此配置全部完成。