C++ OpenCV安装教程

C++ OpenCV编译安装教程

环境说明

win10 + MinGW64 + Cmake

下载mingw64 (版本：12.1.0 posix-seh)

image-20230302161954389

下载Cmake (版本3.17.5)

注：mingw64和cmake下载安装完成后记得把bin目录添加到【环境变量】，如：

image-20230513095456699

下载opencv (版本4.6.0，下载后双击exe，选择目录进行解压即可)

GitHub加速链接(复制下载链接后在链接前面添加https://gh.flyinbug.top/gh/即可)，如

https://gh.flyinbug.top/gh/https://github.com/opencv/opencv/releases/download/4.6.0/opencv-4.6.0-vc14_vc15.exe

Cmake编译配置

编译前

打开cmake-gui，选择opencv源码路径和编译输出路径，如：

image-20230513095213227

注：输出目录为 build/release，要自己在sources文件夹下新建

然后，点击config，选择刚安装的gcc、g++编译器后，等待结束，中间会下载一些东西，不出意外的话肯定报红，没关系，接下来告诉你怎么手动下载好。

【主要是下载ade和ffmpeg这两个东西】

TIPS：下载的东西会存放在 sources/.cache目录下

首先去编译输出的目录build/release下，找到 CMakeDownloadLog.txt这个文件，下载的东西都会在这里记录下来。

然后搜索 cmake_download，如图所示是下载 ade 的示例：

image-20230513102848948

去给定的地址下载好后，按照上图所说那样，把文件重命名然后放到 .cache/ade（或者 .cache/ffmpeg）

TIPS：提供两个加速地址：

  1. https://gh.gh2233.ml/ 用于加速github.com，用法：（在下载链接前添加即可）

    https://gh.gh2233.ml/https://github.com/opencv/ade/archive/v0.1.1d.zip

  2. https://raw.staticdn.net 用于加速raw.githubusercontent.com，用法：（替换域名即可）

    https://raw.staticdn.net/opencv/opencv_3rdparty/65ec04d4573dcdfa4531f0b9e67f35d8ffff873e/ffmpeg/opencv_videoio_ffmpeg_64.dll

都下载完成且放到对应的文件夹后的样子（注意使用的opencv不是4.6.0版本时，你的文件名前缀和我的可能不一样）

image-20230513104214872

使用4.6.0版本时，可以直接去我分享的链接下载，已经把这几个文件都打包好了，下载下来解压到 sources/.cache/目录下即可，链接如下：

文件链接：https://ajream.coding.net/s/4d16cd42-8fd3-4547-9432-1261f3ed4f1e，密码：xty8

接下来进行编译配置

配置编译选项

  1. 不需要test测试文件，所以把test都不打勾

image-20230513100235537

  1. 不需要编译python包（以后要用python开发opencv可以用pip下载安装）

    image-20230513100606815

  2. 不需要编译Java包

    image-20230513100705191

  3. 勾选 opengl

    image-20230513100807488

  4. 勾选build_opencv_world

    image-20230513100936844

  5. 勾选pkg

    image-20230513101009810

  6. 不勾选 precompiled_headers

    image-20230513104558977

  7. 设置安装路径，可以在mingw64安装路径下新建一个cpplibs文件夹，专门存放各种c++库

    image-20230513105444640

重新点击config，没有报红即可（如果是CMake Warning则不用理会）

然后generate

开始正式编译

打开cmd，进入 build/release目录，然后输入指令 mingw32-make -j7进行编译（时间较长）

TIPS: -j7表示使用7个线程进行编译，一般不超过cpu核心的2倍

注：这个过程如果出错，不要担心，回去看看配置编译选项这里是不是有什么没有配置，记得不要编译python，如果系统没有安装python的话或者python版本太旧可能会报错。

重新配置好后，重新config->generate->输入mingw32-make -j8，之前编译好的一些东西不用再编译，会在原来的基础上继续编译的。

image-20230513113732551

安装

  1. 编译完成后，继续输入 mingw32-make install 即可自动安装到前面指定的文件夹内

  2. 进入安装好的文件夹中，把bin目录添加到环境变量

    image-20230513110018194

    image-20230513110018194

image-20230513114010614

测试

新建一个cmake项目，其中Cmakelists.txt如下

cmake_minimum_required(VERSION 3.0.0)
project(cvTest VERSION 0.1.0)
set(CMAKE_CXX_STANDARD 11)

# 设置OpenCVConfig.cmake所在路径
set(OpenCV_DIR D:\\xxxx\\cpplibs\\opencv\\x64\\mingw\\lib)

find_package(OpenCV REQUIRED)

include_directories(${OpenCV_INCLUDE_DIRS})
add_executable(cvTest WIN32 main.cpp)
target_link_libraries(cvTest ${OpenCV_LIBS})

测试代码main.cpp

#include <opencv2/opencv.hpp>
#include <iostream>
int main()
{
    // 图像显示测试
    cv::Mat img = cv::imread(R"(D:\test\1.jpg)");  // 这里使用R"()"是c++11新特性，可以不用对反斜杠“\”转义了

	if (!img.data)//判断图片是否加载进来
	{
		std::cout << "不能加载图片" << std::endl;
		return -1;
	}
	cv::namedWindow("加载的图片", cv::WINDOW_AUTOSIZE);
	cv::imshow("加载的图片", img);//""内命名一致，才能显示在一个窗口
	cv::waitKey(0);

}

image-20230513110729451

参考文章

  1. Windows安装OpenCV——利用MinGW+CMake从源码编译
  2. openCV：环境配置和测试代码
  3. WIN10 CMAKE +MINGW64 编译安装C++ OPENCV踩坑日记 - InvisibleVictory的文章 - 知乎
  4. Windows使用mingw64编译安装opencv

扩展模块opencv_contrib安装

前言

看该教程前请先看前面的OpenCV基础模块安装教程

下载

下载 opencv_contrib模块（需要与opencv基础模块版本号4.6.0相同，国内可以在gitcode下载）

image

配置、编译、安装

打开cmake-gui，选择新的一个编译输出路径build/contrib，然后点击config，等待结束。

完成后按照【在基础模块的配置上】继续设置下面几个配置：

  1. 设置contrib模块路径 xxxx/opencv_contrib-4.6.0/modules（注意要包含modules）
    image-20230513163704147

  2. 勾选 nonfree（允许使用带专栏的算法）
    image-20230513163853739

重新点击configure，然后等待，这又会下载很多东西，不出意外又会报红，因此接下来又需要手动下载了。【下载方式见文章最后-configure报红解决办法】

下载完毕并重命名且放到对应文件夹后，再次点击configure，然后generate，再然后就是关闭cmake，在 build/contrib目录下打开cmd，输入命令 mingw32-make -j7 开始编译（通常需要30分钟以上）

编译完成即可使用命令 mingw32-make install 进行安装， 然后添加环境变量（注意是把含有.dll的bin目录添加到环境变量）

configure报红解决办法

进入 build/contrib 目录，打开【CMakeDownloadLog.txt】文件，找到所有含有 "cmake_download" 的行， 单独复制到一个文件中，方便后面对照下载。

如：

#cmake_download "D:/xxxx/opencv460/opencv/sources/.cache/xfeatures2d/vgg/7cd47228edec52b6d82f46511af325c5-vgg_generated_80.i" "https://raw.githubusercontent.com/opencv/opencv_3rdparty/fccf7cd6a4b12079f73bbfb21745f9babcd4eb1d/vgg_generated_80.i"

# 第2个链接是文件下载位置，第1个链接则是下载文件并重命名后保存的位置

对着每一条下载链接，把所有 raw.githubusercontent.com 都改为 raw.staticdn.net 后再去下载。

下载完成按照第1个链接描述那样，重命名并保存到指定位置。

【到此完成了】

附：写了个python脚本自动下载文件，安装了python以及requests库的可以用我的脚本进行下载(注意，有个 .dat文件较大，请自行下载)

import requests
import os


def getItemUrls(fpath):
    items = []
    with open(fpath, 'r') as f:
        lines = f.readlines()
        for line in lines:
            if('cmake_download' in line):
                line = line.strip().replace('"', '')
                linfo = line.split()
                fileSavePath = linfo[1]
                url = linfo[2].replace(
                    'raw.githubusercontent.com', 'raw.staticdn.net')
                item = dict(file=fileSavePath, url=url)
                items.append(item)
    return items


def save(savepath, content):
    with open(savepath, 'wb') as f:
        f.write(content)


print('请输入 CMakeDownloadLog.txt 的文件路径',
      r'比如D:\opencv\sources\build\release\CMakeDownloadLog.txt', sep='\n')
fp = input(': ')

items = getItemUrls(fp)

for i in range(len(items[0:-1])):
    item = items[i]
    os.makedirs('/'.join(item['file'].split('/')[:-1]), exist_ok=True)
    try:
        r = requests.get(item['url'], timeout=20)
    except:
        print(f"下载失败，请自己下载{item['url']}\n并保存为 {item['file']}")
    save(item['file'], r.content)
    print(f'i={i} --> 已下载 {item["url"]} 并保存好')

print("下载结束")
print(f"注意：由于最后一个文件过大，请自己下载{items[-1]['url']}\n并保存为 {items[-1]['file']}")
posted @ 2023-05-13 11:26  aJream  阅读(505)  评论(3)  编辑  收藏  举报