stitching

环境要求

• Python 环境（用 pip 安装 stitching）
• 有重叠区域的待拼接图片（jpg 等）
• 若在服务器/无图形界面环境（Docker、云环境），需改用 stitching-headless
• 或已安装 Docker，可直接使用 openstitching/stitch 镜像

安装与启动步骤

1. 1安装 stitching

   在本地 Python 环境中通过 PyPI 安装 stitching 包，安装后即可使用 stitch 命令行工具。

   pip install stitching

   复制

2. 2服务器环境装 headless

   若在无图形界面的服务器、Docker 或云环境中使用，改装 headless 版本，功能相同但去掉界面依赖。

   pip install stitching-headless

   复制

3. 3查看命令帮助

   确认安装成功并查看可用参数。安装完成后命令行会提供 stitch 命令。

   stitch -h

   复制

4. 4拼接目录内所有图片

   进入存放图片的目录后运行，会拼接当前目录下所有 jpg 文件并输出全景图。

   stitch *.jpg

   复制

5. 5拼接指定文件

   可以按通配符选择目录中以 IMG 开头、.jpg 结尾的文件，也可以显式列出每张图片。

   stitch img_dir/IMG*.jpg
   stitch img1.jpg img2.jpg img3.jpg

   复制

6. 6开启 verbose 排查问题

   加 -v 后会在指定目录保存全部中间结果，便于定位图片拼接失败的原因。

   stitch *.jpg -v

   复制

7. 7用 Docker 运行

   不想配置 Python 环境时，用官方镜像运行；把宿主机数据目录挂载到容器 /data，并把当前目录理解为 /data。需把 {version} 换成实际版本号。

   docker container run --rm -v /path/to/data:/data openstitching/stitch:{version} -h

   复制

如何确认成功

运行 stitch -h 能正常打印帮助信息，说明安装成功；执行拼接命令后目录中生成拼接好的全景图。

常见问题

注意事项

• 命令中的 {version} 是占位符，需替换为 Docker 镜像的真实版本号。
• Docker 方式下 README 所说的“当前目录”对应容器内的 /data 目录。
• docker 命令使用 --rm，容器退出后会自动删除，请确认输出文件已写入挂载目录。
• 图片之间必须有重叠区域，否则拼接可能失败。