Repolode
提交项目
OpenStitching

OpenStitching/stitching

基于 OpenCV 拼接模块的 Python 图像拼接库，可将重叠照片合成全景图。

在 GitHub 查看
Star
2,641
Fork
218
未关闭 Issue
7
最近提交
5天前

这是什么？

stitching 是一个用于图像拼接的 Python 包，可将有重叠区域的多张图片合成为一张全景图。它基于 OpenCV 的 stitching 模块，流程参照 OpenCV 的 stitching_detailed.py 示例，包括特征检测、匹配、相机参数估计和图像融合等步骤，便于逐步查看和调整。

使用方式有三种：通过 `stitch` 命令行工具处理文件路径或通配符，使用 Docker 镜像免去 Python 环境配置，或在 Python 脚本中调用 `Stitcher` 类并自定义特征检测器、置信度阈值等参数。针对仿射运动场景还提供 `AffineStitcher`。开启 verbose 模式后会保存中间结果，方便定位拼接问题。

对于没有显示设备的服务器或容器环境，可安装 `stitching-headless` 版本。配套的教程 Notebook 展示了 RANSAC 匹配和接缝线等分析方式。

核心功能

  • 01基于 OpenCV 拼接流程，将有重叠的图片合成全景图。
  • 02提供 `stitch` 命令行工具，支持文件列表和通配符。
  • 03提供 Python `Stitcher` 类，可自定义检测器、置信度阈值等参数。
  • 04包含用于仿射运动场景的 `AffineStitcher`。
  • 05verbose 模式会保存中间结果，便于排查问题。
  • 06提供无显示环境使用的 headless 版本。

适用场景

  • 在脚本或数据处理流程中批量将重叠照片合成全景图。
  • 拼接扫描或拍摄的图纸碎片等分段图像。
  • 在服务器的 Docker 容器中运行全景图生成任务。

快速上手

  1. 1

    通过 pip 从 PyPI 安装该包

    pip install stitching
  2. 2

    使用命令行工具拼接当前目录中的所有 JPG 文件

    stitch *.jpg

使用前须知

  • 图像拼接依赖 OpenCV 的 stitching 模块，会带来较大的依赖体积。

收录于专题

计算机视觉工具与库

标签

#computer-vision#image-stitching#panorama#opencv#python#opencv-python

常见问题

stitching 是什么？
基于 OpenCV 拼接模块的 Python 图像拼接库，可将重叠照片合成全景图。 stitching 是一个用于图像拼接的 Python 包，可将有重叠区域的多张图片合成为一张全景图。它基于 OpenCV 的 stitching 模块，流程参照 OpenCV 的 stitching_detailed.py 示例，包括特征检测、匹配、相机参数估计和图像融合等步骤，便于逐步查看和调整。
stitching 可以免费使用吗？用的什么许可证？
stitching 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
stitching 还在维护吗？
活跃维护中。stitching 最近一次提交是在 2026年11月2日。
stitching 适合用来做什么？
在脚本或数据处理流程中批量将重叠照片合成全景图。 拼接扫描或拍摄的图纸碎片等分段图像。 在服务器的 Docker 容器中运行全景图生成任务。
stitching 怎么安装和运行？
通过 pip 从 PyPI 安装该包: pip install stitching 使用命令行工具拼接当前目录中的所有 JPG 文件: stitch *.jpg
在哪里获取 stitching？
源代码和安装说明在 GitHub 上：https://github.com/OpenStitching/stitching

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目