Ubuntu 18.04配置OpenCV 4.2.0
目录
本文主要介绍在Ubuntu 18.04中从源码安装配置OpenCV，并使用一个简单的例子验证是否安装成功；
具体安装配置步骤，参考文章见：https://cv-tricks.com/installation/opencv-4-1-ubuntu18-04/
与上述链接中提供的教程不同的是：
- 部分依赖包安装可能需要修改
- 本文安装配置OpenCV版本为4.2，支持使用CUDA对DNN模块加速计算
- 本文不涉及Python接口配置，仅配置为C++使用，所以会跳过步骤Step2~5
Step 1: 安装OpenCV的依赖包
一步一步的安装下面的所有依赖包：
sudo apt-get update -y # Update the list of packages
sudo apt-get remove -y x264 libx264-dev # Remove the older version of libx264-dev and x264
sudo apt-get install -y build-essential checkinstall cmake pkg-config yasm
sudo apt-get install -y git gfortran
sudo add-apt-repository -y "deb http://security.ubuntu.com/ubuntu xenial-security main"
sudo apt-get install -y libjpeg8-dev libjasper-dev libpng12-dev
sudo apt-get install -y libtiff5-dev
sudo apt-get install -y libavcodec-dev libavformat-dev libswscale-dev libdc1394-22-dev
sudo apt-get install -y libxine2-dev libv4l-dev
sudo apt-get install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
sudo apt-get install -y qt5-default libgtk2.0-dev libtbb-dev
sudo apt-get install -y libatlas-base-dev
sudo apt-get install -y libfaac-dev libmp3lame-dev libtheora-dev
sudo apt-get install -y libvorbis-dev libxvidcore-dev
sudo apt-get install -y libopencore-amrnb-dev libopencore-amrwb-dev
sudo apt-get install -y x264 v4l-utils
# Some Optional Dependencies
sudo apt-get install -y libprotobuf-dev protobuf-compiler
sudo apt-get install -y libgoogle-glog-dev libgflags-dev
sudo apt-get install -y libgphoto2-dev libeigen3-dev libhdf5-dev doxygen
在安装上述依赖包的过程中，可能会存在一些错误提示，这里我将自己遇到的问题列出，并给出解决方案;
错误1：
E: Unable to locate package libjasper-dev
执行：
sudo add-apt-repository "deb http://security.ubuntu.com/ubuntu xenial-security main"
sudo apt-get update
再次执行安装依赖包就行；
错误2：
E: Unable to locate package libgstreamer0.10-dev
执行:
sudo apt install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
即可；
Step 2: 下载OpenCV 4.2.0和OpenCV Contrib 4.2.0
OpenCV 4.2.0:
https://github.com/opencv/opencv/releases/tag/4.2.0
OpenCV Contib 4.2.0:
https://github.com/opencv/opencv_contrib/releases/tag/4.2.0
假如将两个压缩包保存到/home/username/opencv4.2/，进行解压；
如，我将下载得到的文件放在了opencv4.2这个文件夹中，修改成"/home/username/opencv4.2/";
最后目录结构如下：
/home/username/opencv4.2/
opencv-4.2.0/
opencv_contrib-4.2.0/
ippicv_2019_lnx_intel64_general_20180723.tgz
相关问题提前说明:
下面几个问题可能出现在安装的不同阶段中,视情况而定;
问题一:
因为网络的原因,如果下载opencv和opencv-contrib时速度比较慢或者下载失败,则可以通过下面链接寻找相应的压缩包(感谢老铁):
https://www.bzblog.online/wordpress/index.php/2020/03/09/opencvdownload/
问题二:
另外，在编译的时候需要ippicv_2019_lnx_intel64_general_20180723.tgz这个文件，下载的时候会特别慢。这里提供一个链接:
链接：https://pan.baidu.com/s/16afQkmJ0Hu9BenxmJy_1cQ 提取码：Uy22
问题三:
再另外,在编译的过程中,出现错误
fatal error: boostdesc_bgm.i: No such file or directory
该问题同样是因为网络的原因,提供链接下载:
链接：https://pan.baidu.com/s/1ihQggYXevvgw7kcMKT8Uvg 提取码：9491
下载完成后,将带有不同关键字符*-vgg*与*-boost*的文件放入文件夹中;
├── boostdesc_bgm_bi.i
├── boostdesc_bgm_hd.i
├── boostdesc_bgm.i
├── boostdesc_binboost_064.i
├── boostdesc_binboost_128.i
├── boostdesc_binboost_256.i
├── boostdesc_lbgm.i
├── vgg_generated_120.i
├── vgg_generated_48.i
├── vgg_generated_64.i
└── vgg_generated_80.i
拷贝到:
mv ./* opencv_contrib-4.2.0/modules/xfeatures2d/src/
问题四:
如果在编译过程中出现下面错误:
opencv_contrib-4.2.0/modules/xfeatures2d/test/test_features2d.cpp:51:10: fatal error: features2d/test/test_detectors_regression.impl.hpp: No such file or directory
或许你可以发现在文件夹opencv_contrib-4.2.0/modules/xfeatures2d/test中没有下面这个文件
test_detectors_regression.impl.hpp
那么,它在哪里呢?它在opencv-4.2.0/modules/features2d/test中`;
因此,修改文件夹opencv_contrib-4.2.0/modules/xfeatures2d/test下的文件:
test_features2d.cpp
将:
#include "features2d/test/test_detectors_regression.impl.hpp"
#include "features2d/test/test_descriptors_regression.impl.hpp"
修改成:
#include "/home/***/opencv-4.2.0/modules/features2d/test/test_detectors_regression.impl.hpp"
#include "/home/***/opencv-4.2.0/modules/features2d/test/test_descriptors_regression.impl.hpp"
同理,也需要修改另外一个文件:
test_rotation_and_scale_invariance.cpp
同理,如果出现以下问题,也需要修改相应文件:
opencv-4.2.0/samples/gpu/surf_keypoint_matcher.cpp:11:10: fatal error: opencv2/xfeatures2d/cuda.hpp: No such file or directory
那么这个文件在哪呢?是在opencv_contrib-4.2.0/modules/xfeatures2d/include/opencv2/xfeatures2d下,因此,需要修改文件夹opencv-4.2.0/samples/gpu/下的文件:
surf_keypoint_matcher.cpp
将:
#include "opencv2/xfeatures2d/cuda.hpp"
修改成:
#include "/home/***/opencv_contrib-4.2.0/modules/xfeatures2d/include/opencv2/xfeatures2d/cuda.hpp"
问题五:
出现如下问题:
CMakeFiles/example_gpu_surf_keypoint_matcher.dir/surf_keypoint_matcher.cpp.o: In function `main':
surf_keypoint_matcher.cpp:(.text.startup.main+0x352): undefined reference to `cv::cuda::SURF_CUDA::SURF_CUDA()'
surf_keypoint_matcher.cpp:(.text.startup.main+0x579): undefined reference to `cv::cuda::SURF_CUDA::operator()(cv::cuda::GpuMat const&, cv::cuda::GpuMat const&, cv::cuda::GpuMat&, cv::cuda::GpuMat&, bool)'
surf_keypoint_matcher.cpp:(.text.startup.main+0x60d): undefined reference to `cv::cuda::SURF_CUDA::operator()(cv::cuda::GpuMat const&, cv::cuda::GpuMat const&, cv::cuda::GpuMat&, cv::cuda::GpuMat&, bool)'
surf_keypoint_matcher.cpp:(.text.startup.main+0x6af): undefined reference to `cv::cuda::SURF_CUDA::defaultNorm() const'
surf_keypoint_matcher.cpp:(.text.startup.main+0x7ca): undefined reference to `cv::cuda::SURF_CUDA::downloadKeypoints(cv::cuda::GpuMat const&, std::vector<cv::KeyPoint, std::allocator<cv::KeyPoint> >&)'
surf_keypoint_matcher.cpp:(.text.startup.main+0x7ea): undefined reference to `cv::cuda::SURF_CUDA::downloadKeypoints(cv::cuda::GpuMat const&, std::vector<cv::KeyPoint, std::allocator<cv::KeyPoint> >&)'
surf_keypoint_matcher.cpp:(.text.startup.main+0x800): undefined reference to `cv::cuda::SURF_CUDA::downloadDescriptors(cv::cuda::GpuMat const&, std::vector<float, std::allocator<float> >&)'
surf_keypoint_matcher.cpp:(.text.startup.main+0x812): undefined reference to `cv::cuda::SURF_CUDA::downloadDescriptors(cv::cuda::GpuMat const&, std::vector<float, std::allocator<float> >&)'
collect2: error: ld returned 1 exit status
samples/gpu/CMakeFiles/example_gpu_surf_keypoint_matcher.dir/build.make:124: recipe for target 'bin/example_gpu_surf_keypoint_matcher' failed
make[2]: *** [bin/example_gpu_surf_keypoint_matcher] Error 1
CMakeFiles/Makefile2:23667: recipe for target 'samples/gpu/CMakeFiles/example_gpu_surf_keypoint_matcher.dir/all' failed
make[1]: *** [samples/gpu/CMakeFiles/example_gpu_surf_keypoint_matcher.dir/all] Error 2
解决方案:
打开文件:
vim opencv-4.2.0/build/samples/gpu/CMakeFiles/example_gpu_surf_keypoint_matcher.dir/link.txt
在文件中--字符串:
CMakeFiles/example_gpu_surf_keypoint_matcher.dir/surf_keypoint_matcher.cpp.o
后面,加上一句:
/home/***/opencv-4.2.0/build/modules/xfeatures2d/CMakeFiles/opencv_xfeatures2d.dir/src/surf.cuda.cpp.o
注意:找到你本机下的文件路径;
服了啊,为什么第一次弄的时候没有出这么多问题,
感谢各位无私奉献的老铁;当然如果网络给力,上面提供的链接不一定用的上;
Step 3: 使用cmake构建库
执行：
cd /home/username/opencv4.2/opencv-4.2.0
mkdir build
cd build
执行：
cmake -D CMAKE_BUILD_TYPE=RELEASE \
-D CMAKE_INSTALL_PREFIX=/usr/local \
-D INSTALL_C_EXAMPLES=ON \
-D CUDA_ARCH_BIN='7.5' \
-D WITH_CUDA=ON \
-D WITH_TBB=ON \
-D WITH_V4L=ON \
-D WITH_QT=ON \
-D WITH_OPENGL=ON \
-D OPENCV_EXTRA_MODULES_PATH=/home/username/opencv4.2/opencv_contrib-4.2.0/modules \
-D BUILD_EXAMPLES=ON \
-D OPENCV_GENERATE_PKGCONFIG=YES ..
上述步骤需要修改的地方有两处：
CUDA_ARCH_BIN='7.5'
由于OpenCV 4.2支持使用CUDA对DNN模块进行加速计算，所以这里配置CUDA；在此之前需要自行配置好NVIDIA显卡的驱动与CUDA；
其中7.5指的是显卡的计算能力，我的是GTX 1660Ti，对应的计算力为7.5;
这里提供一个链接，可以参考：NVIDA CUDA显卡计算能力对应表
第二处需要修改的地方是：
OPENCV_EXTRA_MODULES_PATH=/home/username/opencv4.2/opencv_contrib-4.2.0/modules
这里修改成你本机的opencv_contrib-4.2.0/modules的位置
Step 4: 使用make构建库
查看CPU核心数：
nproc
如，我的CPU核心数为12，执行
cd /home/username/opencv4.2/build
make -j12
等待一段时候，出现Configuration Done即可，
执行：
sudo make install
再次等待一段时候后，执行:
sudo sh -c 'echo "/usr/local/lib" >> /etc/ld.so.conf.d/opencv.conf'
sudo ldconfig
Step 5: 修改opencv4.pc文件
如果上述配置成功，则会在/usr/local/lib/文件夹中出现一个pkgconfig文件夹，里面有一个opencv.pc文件，内容大致如下：
# Package Information for pkg-config
prefix=/usr/local
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir_old=${prefix}/include/opencv4/opencv2
includedir_new=${prefix}/include/opencv4
Name: OpenCV
Description: Open Source Computer Vision Library
Version: 4.2.0
Libs: -L${exec_prefix}/lib -lopencv_gapi -lopencv_stitching -lopencv_aruco -lopencv_bgsegm -lopencv_bioinspired -lopencv_ccalib -lopencv_cudabgsegm -lopencv_cudafeatures2d -lopencv_cudaobjdetect -lopencv_cudastereo -lopencv_cvv -lopencv_dnn_objdetect -lopencv_dnn_superres -lopencv_dpm -lopencv_highgui -lopencv_face -lopencv_freetype -lopencv_fuzzy -lopencv_hdf -lopencv_hfs -lopencv_img_hash -lopencv_line_descriptor -lopencv_quality -lopencv_reg -lopencv_rgbd -lopencv_saliency -lopencv_sfm -lopencv_stereo -lopencv_structured_light -lopencv_phase_unwrapping -lopencv_superres -lopencv_cudacodec -lopencv_surface_matching -lopencv_tracking -lopencv_datasets -lopencv_text -lopencv_dnn -lopencv_plot -lopencv_videostab -lopencv_cudaoptflow -lopencv_optflow -lopencv_cudalegacy -lopencv_videoio -lopencv_cudawarping -lopencv_xfeatures2d -lopencv_shape -lopencv_ml -lopencv_ximgproc -lopencv_video -lopencv_xobjdetect -lopencv_objdetect -lopencv_calib3d -lopencv_imgcodecs -lopencv_features2d -lopencv_flann -lopencv_xphoto -lopencv_photo -lopencv_cudaimgproc -lopencv_cudafilters -lopencv_imgproc -lopencv_cudaarithm -lopencv_core -lopencv_cudev
Libs.private: -lm -lpthread -L/usr/lib/x86_64-linux-gnu -lGL -lGLU -lcudart_static -ldl -lrt -lnppc -lnppial -lnppicc -lnppicom -lnppidei -lnppif -lnppig -lnppim -lnppist -lnppisu -lnppitc -lnpps -lcublas -lcudnn -lcufft -L-L/usr/local/cuda -llib64 -L-L/usr/lib -lx86_64-linux-gnu
Cflags: -I${includedir_old} -I${includedir_new}
注意：需要将第6行修改为：
includedir_old=${prefix}/include/opencv4/opencv2
如果没有自动生成，可以试着新建一个文件，将上述的内容复制进去，继续下一步；
Step 6: 在.bashrc文件中添加PKG_CONFIG_PATH
执行:
sudo gedit ~/.bashrc
在文件最后添加:
PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig
export PKG_CONFIG_PATH
退出后，执行
source ~/.bashrc
# 判断路径时候添加成功，返回:/usr/local/lib/pkgconfig即可
echo $PKG_CONFIG_PATH
Step 7: 使用C++代码进行验证
在任意目录下创建test.cpp文件，加入下面内容：
#include "opencv.hpp"
using namespace cv;
using namespace std;
int main( int argc, char** argv )
{
cout << "OpenCV version : " << CV_VERSION << endl;
cout << "Major version : " << CV_MAJOR_VERSION << endl;
cout << "Minor version : " << CV_MINOR_VERSION << endl;
cout << "Subminor version : " << CV_SUBMINOR_VERSION << endl;
}
使用命令行在其文件夹下执行：
# 编译test.cpp程序，并生成可执行文件
g++ -std=c++11 test.cpp `pkg-config --libs --cflags opencv4` -o result
# 执行可执行文件
./result
输出以下内容，即表明配置成功
OpenCV version : 4.2.0
Major version : 4
Minor version : 2
Subminor version : 0
