opencv 安装
一、地址
opencv官网
opencv Github
官方安装流程
二、概述
opencv有两种安装方式:1、根据自己的平台选择官方编译好的版本;2、下载源码自己编译。
三、预编译版本
官方预编译版本满足大多数需求。预编译版本有两个途径:
1、OpenCV核心团队:
- GitHub releases
- SourceForget.net
2、第三方机构:
- System packages in popular Linux distributions
- PyPI
- Conda
- Conan
- vcpkg
- NuGet
- Brew
- Maven
四、从源码构建
如果现有的预编译版本不满足使用需求,可以下载源码自行构建编译。OpenCV使用CMake构建管理系统进行配置和构建。
Step 0:依赖
安装c++编译器(compiler)和构建工具(build tool)。
*NIX平台,通常使用GCC/C++或者Clang作为编译器,使用Make或者Ninja作为构建工具。
Windows平台,可以使用Visual Studio IDE或者MinGW-w64作为编译器。
Android平台,使用Android NDK里面的Native toolchains作为编译器。
IOS、OSX平台,使用XCode IDE。
从官方网站安装CMake。
获取其他第三方依赖:例如具有视频解码功能的库,GUI显示相关的库;对选择的算法提供优化功能的库;用于生成文档和其他额外功能的工具等。查看OpenCV配置选项参考,获取可用选项和相应的依赖库。
Step 1:获取源码
典型的软件项目由一个或多个代码仓库组成。OpenCV有三个代码仓库:opencv- 主库,包含稳定且积极支持的算法;opencv_contrib 包含实验和非免费(专利)算法;还有一个带测试数据的仓库:opecv_extra 。
这三个仓库有两种下载方式:
1、下载仓库的快照存档,但是上面三个仓库的名称跳转既是;
2、glone仓库的完成提交历史(后面可以自由切换版本):
git clone https://github.com/opencv/opencv
git -C opencv checkout <some-tag>
# optionally
git clone https://github.com/opencv/opencv_contrib
git -C opencv_contrib checkout <same-tag-as-opencv>
# optionally
git clone https://github.com/opencv/opencv_extra
git -C opencv_extra checkout <same-tag-as-opencv>
注: 1、opencv_contrib 模块和opencv_extra 模块都是可选项,自行根据需求安装下载;
2、如果下载这俩模块,需要确保彼此兼容性。一般情况下下载对应版本号即可。
3、考虑目标平台和开发工具的版本。最新的OpenCV可能在非常老的编译器上出现构建问题。
Step 2:配置
在这一步CMake将会验证所有的工具和依赖是否可用以及兼容性问题。同时根据选择的平台生成中间文件。比如:Makefiles、IDE 工程和解决方案。通常这一步会在一个新建的build文件夹中完成。
Note: 这一步还可以使用 cmake-gui 来可视化修改编译选项。
Step 3:构建
在构建过程中,源文件被编译成目标文件,这些目标文件被链接在一起或者组合成库和相应的程序,这个步骤通过一下命令完成:cmake --build <build-directory> <build-options>
,或者直接调用make
Step 4:安装(可选)
在安装过程中,将把生成目录中的生成结果和其他文件复制到安装位置。UNIX上默认的安装位置是 /usr/local ,Windows上默认安装位置是 C:/Program files 。这个位置可以在配置步骤中通过设置 CMAKE_INSTALL_PREFIX 选项来更改。安装命令:cmake --build <build-directory> --target install <other-options>
。
Note: 1、此步骤是可选的,不安装可以直接在build目录中使用;
2、若安装位置受系统保护,需要加上sudo权限: sudo cmake …
五、配置选项
5.1 概述
配置选项可以通过一下三种方式设置:
- 命令行:
cmake -Doption=value ...
- 初始缓存文件:
cmake -C my_options.txt ...
- 交互式界面:
cmake-gui
个人推荐使用cmake-gui可视化配置,由于选项太多了,使用命令行或是修改配置文件,一是不直观,二是容易漏,三是太麻烦;使用cmake-gui对应的好处,一是可以直接搜索想要的配置选项;二是上面Step2提到的配置生成过程中产生的错误尤其是依赖错误,可以方便的看提示及修改;三是生成之后的配置信息可以很方便的预览,特别是某些模块是否启用,依赖库的信息等。当然最终每个人依据个人喜好以及使用场景选择。
OpenCV的大部分配置选项可以在顶层的cmake脚本中找到:opencv/CMakeLists.txt 。一些选项是和特定的模块对应的。
可以使用CMake工具打印所有的可用选项:
# initial configuration
cmake ../opencv
# print all options
cmake -L
# print all options with help message
cmake -LH
# print all options including advanced
cmake -LA
其中,比较重要的选项是以 WITH_, ENABLE_, BUILD_, OPENCV_ 为开头的。选项的默认值因平台和其他选项值而异。
5.2、通用选项
5.2.1 构建额外模块选项
这里的附件模块即Step1中提到的opencv_contrib仓库中的算法模块。编译选项可以指定其中的部分抑或是全部,参考OpenCV编码风格指南
example:
# build with all modules in opencv_contrib
cmake -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules ../opencv
# build with one of opencv_contrib modules
cmake -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules/bgsegm ../opencv
# build with two custom modules (semicolon must be escaped in bash)
cmake -DOPENCV_EXTRA_MODULES_PATH=../my_mod1\;../my_mod2 ../opencv
5.2.2 构建Debug/Release选项
CMAKE_BUILD_TYPE
是一个可选项,用以指定生成的OpenCV库文件是debug版本抑或是release版本,区别在于debug会禁用许多编译器优化,也可以指定 CV_DISABLE_OPTIMIZATION
选项禁用优化功能,禁用优化的好处是方便断点调试。debug版本生成的二进制文件中包含调试符号。要在release版本中启用调试符号,需要开启BUILD_WITH_DEBUG_INFO
选项。
cmake -DCMAKE_BUILD_TYPE=Debug ../opencv
cmake --build .
5.2.3 构建静态库/动态库选项
BUILD_SHARED_LIBS
选择控制生成动态库 (.dll, .so, .dylib) 抑或是静态库(.a, .lib)。默认值取决于构建的目标平台,大多数情况下默认是ON(生成静态库)。
cmake -DBUILD_SHARED_LIBS=OFF ../opencv
ENABLE_PIC
设置CMAKE_POSITION_INDEPENDENT_CODE 选项。这是一个CMake的功能,启用或禁用 位置无关代码(PIC) 的生成。构建动态库或打算把静态库链接到动态库的时候,必须启用此选项。默认为ON。
5.2.4 构建 pkg-config 选项
OPENCV_GENERATE_PKGCONFIG
选项可以生成.pc
文件。至于什么是.pc(package configure 包/库配置文件)文件,比如gtk-2.0的pc文件内容如下:
prefix=/usr
exec_prefix=/usr
libdir=/usr/lib
includedir=/usr/include
target=x11
gtk_binary_version=2.4.0
gtk_host=i386-redhat-linux-gnu
Name: GTK+
Description: GIMP Tool Kit (targettarget)Version:2.6.7Requires:gdk−{target}-2.0 atk
Libs: -Llibdir−lgtk−{target}-2.0
Cflags: -I${includedir}/gtk-2.0
可以看到.pc文件中包含了一个库的头文件、库文件所在的路径信息。GCC等编译某个工程用到这个依赖库的时候,这样用 gcc -c pkg-config –cflags gtk-2.0 sample.c
就可以方便的添加依赖信息。使用 pkg-config 的 –cflags 参数可以给出在编译时所需要的选项,而 –libs 参数可以给出连接时的选项。gcc sample.o -o sample pkg-config –libs gtk-2.0
。
但是,由于配置过程的复杂性,生成的.pc文件可能包含不完整的第三方依赖项列表,并且可能在某些配置中不起作用,尤其是构建的静态库中。此功能自OpenCV 4.x版本以后不再正式支持,默认禁用。
5.2.5 构建tests,samples and applications
有两种类型的tests:准确性accuracy (opencv_test_) and 性能performance (opencv_perf_)。默认情况下启用tests和applications,examples需要手动启用。
相应的CMake选项:
cmake \
-DBUILD_TESTS=ON \
-DBUILD_PERF_TESTS=ON \
-DBUILD_EXAMPLES=ON \
-DBUILD_opencv_apps=ON \
../opencv
5.2.6 构建部分模块
每一个模块都是modules目录下的一个子文件夹。每个模块都有单独的使能选项,可以禁用某个模块不参与构建:cmake -DBUILD_opencv_calib3d=OFF ../opencv
,也可以只构建指定的模块和它们的依赖项:cmake -DBUILD_LIST=calib3d,videoio,ts ../opencv
,这里我们指定了三个模块,但是配置脚本会自动确定所需要的其他依赖项。
– OpenCV modules:
– To be built: calib3d core features2d flann highgui imgcodecs imgproc ts videoio
5.2.7 下载依赖项
配置脚本可以尝试从网络上下载附加的库和文件,如果失败,相应的功能会被关闭。默认情况下,所有的文件被下载到<source>/.cache
目录,然后解压或复制到构建目录。也可以通过设置环境变量或者配置选择来更改下载缓存的位置:
export OPENCV_DOWNLOAD_PATH=/tmp/opencv-cache
cmake ../opencv
# or
cmake -DOPENCV_DOWNLOAD_PATH=/tmp/opencv-cache ../opencv
下载过程的日志会被保存在构建目录的CMakeDownloadLog.txt
中。对于下载失败文件,会在构建目录中的帮助脚本中添加一个命令,例如download_with_wget.sh
,你可以运行这些脚本,也可修改。
注:个人经验,这些第三方依赖往往难以在配置脚本中自行下载,有一个好办法,在OpenCV 官方GitHub中找到这些第三方依赖仓库(在该仓库不同的分支下,手动下拉选择即可),手动下载,并放到相应的位置,配置脚本就不会再重新下载了,此时可以正常往下执行
5.2.8 CPU级别的优化
在x86_64的机器上,OpenCV默认会针对SSE3指令集进行编译,可以通过以下选项进行修改:
cmake -DCPU_DISPATCH=AVX,AVX2 ../opencv
Note:其他平台有自己的指令集:例如ARM上
的VFPV
和NEON
,PowerPC上的VSCX
。
一些函数支持dispathch机制,通过编译多个指令集并在运行时选择其中一个,编译多个指令集列表选项:cmake -DCPU_DISPATCH=AVX,AVX2 ../opencv
。
要禁用dispatch机制,此选项设置为空即可:cmake -DCPU_DISPATCH= ../opencv
。
可以使用以下选项禁用部分代码的优化,以便进行debug:
# disable universal intrinsics
cmake -DCV_ENABLE_INTRINSICS=OFF ../opencv
# disable all possible built-in optimizations
cmake -DCV_DISABLE_OPTIMIZATION=ON ../opencv
Note:更多关于CPU优化选项的细节,可以查看CPU优化选项文章来源:https://www.toymoban.com/news/detail-607337.html
5.2.9 Profiling, coverage, sanitize, hardening, size optimization
以下选项可用于生产带有检测或改进安全性的特殊构建,默认都被禁用。文章来源地址https://www.toymoban.com/news/detail-607337.html
选项 | 编译器 | 说明 |
---|---|---|
ENABLE_PROFILING | GCC or Clang | Enable profiling compiler and linker options |
ENABLE_COVERAGE | GCC or Clang | Enable code coverage support. |
OPENCV_ENABLE_MEMORY_SANITIZER | N/A | Enable several quirks in code to assist memory sanitizer. |
ENABLE_BUILD_HARDENING | GCC, Clang, MSVC | Enable compiler options which reduce possibility of code exploitation. |
ENABLE_LTO | GCC, Clang, MSVC | Enable Link Time Optimization (LTO) |
ENABLE_THIN_LTO | Clang | Enable thin LTO which incorporates intermediate bitcode to binaries allowing consumers optimize their applications later. |
到了这里,关于第一章之OpenCV安装的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!