jonstonchan/opencv4

jonstonchan/opencv4镜像说明

镜像概述

本镜像为基于Ubuntu系统的OpenCV4 C++开发环境，标签格式为{ubuntu版本}-{opencv版本}（例如16.04-4.1.0表示基础镜像为ubuntu:16.04，集成OpenCV 4.1.0）。所有镜像均包含OpenCV扩展模块（opencv_contrib）。

核心功能

• 提供完整的OpenCV4 C++开发编译环境
• 集成OpenCV官方扩展模块opencv_contrib
• 支持pkg-config工具（配置名称为opencv4）
• 基于Ubuntu系统，兼容常见C++开发流程

使用场景

• C++ OpenCV项目的快速开发与编译
• OpenCV功能验证与测试场景
• 避免本地配置OpenCV的繁琐步骤，快速搭建一致的开发环境

配置说明

OpenCV构建参数

镜像中OpenCV的构建参数如下：

cmake
cmake \
    -D BUILD_DOCS=OFF \
    -D BUILD_EXAMPLES=OFF \
    -D BUILD_opencv_apps=OFF \
    -D BUILD_PERF_TESTS=OFF \
    -D BUILD_TBB=OFF \
    -D BUILD_TESTS=OFF \
    -D CMAKE_BUILD_TYPE=RELEASE \
    -D CMAKE_INSTALL_PREFIX=/usr/local \
    -D OPENCV_EXTRA_MODULES_PATH=../../opencv_contrib/modules \
    -D OPENCV_GENERATE_PKGCONFIG=ON ..

pkg-config使用方法

使用pkg-config获取OpenCV4的编译链接参数时，需指定opencv4：

sh
pkg-config --cflags --libs opencv4

安装验证示例

验证代码（main.cpp）

cpp
#include <iostream>
#include <opencv2/opencv.hpp>

int main() {
    // 输出OpenCV完整构建信息
    std::cout << cv::getBuildInformation() << std::endl;
    // 输出OpenCV版本号
    std::cout << "OpenCV version: " << CV_VERSION << std::endl;
    return 0;
}

构建与运行命令

sh
docker run --rm \
    -v "$PWD:/app" \
    --workdir "/app" \
    --user="$(id -u):$(id -g)" \
    docker.xuanyuan.run/"jonstonchan/opencv4:20.04-4.5.5" \
    bash -c \
    'g++ main.cpp -o app $(pkg-config --cflags --libs opencv4) && ./app'

注意：若在Docker外部运行编译后的程序且未安装OpenCV，会出现共享库缺失错误（如libopencv_core.so.405找不到）。