hdgigante/python-opencv

Python OpenCV Docker镜像文档

!https://github.com/gigante/python-opencv/actions/workflows/build.yml/badge.svg !https://img.shields.io/docker/pulls/hdgigante/python-opencv?style=flat-square

1. 镜像概述

Python OpenCV是包含OpenCV库及其Python绑定的Docker镜像，旨在为计算机视觉开发提供便捷的运行环境。该镜像预安装了OpenCV核心库及扩展模块，无需手动配置即可快速启动Python视觉项目开发与部署。

镜像可在https://hub.docker.com/r/hdgigante/python-opencv%E8%8E%B7%E5%8F%96%E3%80%82

2. 核心功能与特性

• OpenCV核心组件：包含官方OpenCV库及contrib扩展模块
• Python生态：集成Python 3环境及pip包管理工具
• 科学计算依赖：预装Numpy数值计算库
• OCR支持：内置Tesseract OCR引擎
• 数学优化库：包含Eigen线性代数库、OpenBlas数学库、Intel TBB并行计算库
• 图像格式支持：集成libjpeg、libpng、libtiff、libwebp及openjpeg图像编解码库

3. 支持的镜像标签

4. 使用方法

4.1 基本使用

通过以下命令启动交互式Python环境，验证OpenCV安装：

bash
docker run -it hdgigante/python-opencv python3
>>> import cv2
>>> print(cv2.__version__)  # 输出OpenCV版本号

4.2 运行本地项目

挂载本地项目目录并运行Python脚本：

bash
docker run -it -v $(pwd):/app hdgigante/python-opencv python3 /app/your_script.py

4.3 Docker Compose配置示例

创建docker-compose.yml文件，集成到项目中：

yaml
version: '3'
services:
  cv-app:
    image: hdgigante/python-opencv:4.12.0-ubuntu
    volumes:
      - ./src:/app
    command: python3 /app/main.py
    working_dir: /app

启动服务：

bash
docker-compose up

5. 构建配置参数

镜像构建时使用以下OpenCV编译选项，可根据需求调整：

-D OPENCV_ENABLE_NONFREE=ON           # 启用非免费算法
-D WITH_JPEG=ON                       # 启用JPEG支持
-D WITH_PNG=ON                        # 启用PNG支持
-D WITH_TIFF=ON                       # 启用TIFF支持
-D WITH_WEBP=ON                       # 启用WebP支持
-D WITH_JASPER=ON                     # 启用Jasper支持
-D WITH_EIGEN=ON                      # 启用Eigen线性代数库
-D WITH_TBB=ON                        # 启用Intel TBB并行计算
-D WITH_LAPACK=ON                     # 启用LAPACK线性代数库
-D WITH_PROTOBUF=ON                   # 启用Protobuf支持
-D WITH_V4L=OFF                       # 禁用V4L视频捕获
-D WITH_GSTREAMER=OFF                 # 禁用GStreamer
-D WITH_GTK=OFF                       # 禁用GTK GUI
-D WITH_QT=OFF                        # 禁用QT GUI
-D WITH_CUDA=OFF                      # 禁用CUDA支持
-D WITH_VTK=OFF                       # 禁用VTK可视化
-D WITH_OPENEXR=OFF                   # 禁用OpenEXR支持
-D WITH_FFMPEG=OFF                    # 禁用FFMPEG视频处理
-D WITH_OPENCL=OFF                    # 禁用OpenCL加速
-D WITH_OPENNI=OFF                    # 禁用OpenNI
-D WITH_XINE=OFF                      # 禁用Xine
-D WITH_GDAL=OFF                      # 禁用GDAL
-D WITH_IPP=OFF                       # 禁用IPP
-D BUILD_OPENCV_PYTHON3=ON            # 构建Python 3绑定
-D BUILD_OPENCV_PYTHON2=OFF           # 禁用Python 2绑定
-D BUILD_OPENCV_JAVA=OFF              # 禁用Java绑定
-D BUILD_TESTS=OFF                    # 禁用测试构建
-D BUILD_IPP_IW=OFF                   # 禁用IPP IW构建
-D BUILD_PERF_TESTS=OFF               # 禁用性能测试
-D BUILD_EXAMPLES=OFF                 # 禁用示例构建
-D BUILD_ANDROID_EXAMPLES=OFF         # 禁用Android示例
-D BUILD_DOCS=OFF                     # 禁用文档构建
-D BUILD_ITT=OFF                      # 禁用ITT支持
-D INSTALL_PYTHON_EXAMPLES=OFF        # 不安装Python示例
-D INSTALL_C_EXAMPLES=OFF             # 不安装C示例
-D INSTALL_TESTS=OFF                  # 不安装测试

4.4 本地构建

如需本地构建镜像，可使用以下命令（需项目Makefile支持）：

bash
make build CV=5.0.0-alpha DIST=fedora

6. 使用场景与适用范围

• 计算机视觉开发：快速搭建OpenCV开发环境，无需手动配置依赖
• 图像处理应用：部署基于Python和OpenCV的图像识别、特征提取应用
• OCR项目：结合Tesseract实现文本识别功能
• 教学与实验：计算机视觉课程的实践环境，算法原型验证
• CI/CD集成：作为视觉项目的自动化测试环境
• 轻量级部署：选择alpine标签实现最小化镜像体积部署

7. 参考资料

• https://docs.opencv.org/
• https://docs.opencv.org/4.11.0/dd/dd5/tutorial_py_setup_in_fedora.html# Python OpenCV Docker镜像文档

!https://github.com/gigante/python-opencv/actions/workflows/build.yml/badge.svg !https://img.shields.io/docker/pulls/hdgigante/python-opencv?style=flat-square

1. 镜像概述

Python OpenCV是包含OpenCV库（带contrib扩展模块）和Python绑定的Docker镜像，旨在为计算机视觉开发提供便捷、一致的运行环境，无需手动配置复杂的依赖关系。

该镜像可在https://hub.docker.com/r/hdgigante/python-opencv%E8%8E%B7%E5%8F%96%E3%80%82

2. 核心功能与特性

• OpenCV组件：包含官方https://github.com/opencv/opencv%E5%BA%93%E5%8F%8Ahttps://github.com/opencv/opencv_contrib%E6%89%A9%E5%B1%95%E6%A8%A1%E5%9D%97
• Python环境：集成Python 3及pip包管理工具
• 科学计算库：预装Numpy数值计算库
• OCR支持：内置Tesseract OCR引擎
• 数学优化库：Eigen线性代数库、OpenBlas数学库、Intel TBB并行计算库
• 图像格式支持：libjpeg、libpng、libtiff、libwebp及openjpeg图像编解码库

3. 支持的镜像标签