一、软件介绍
本工具用于对街景图片进行预处理，自动或手动标记画面中的遮挡物（如行人、车辆、树木、路灯等），并使用 AI 模型对遮挡区域进行智能修复，生成更干净的街景图片，方便后续用于 3D 建模等用途。
主要功能
- 图片输入：支持打开本地图片，或直接粘贴图片网址 / 百度街景分享链接加载高清街景。
- 自动识别遮挡物：基于目标检测模型，自动识别画面中的行人、汽车、自行车等常见遮挡物。
- 手动涂抹遮挡物：支持画笔涂抹和橡皮擦修正，涂抹区域以红色高亮显示。
- AI 智能修复：基于AI模型，对标记的遮挡区域进行智能填充，还原地面、墙面等背景纹理。
- 保存结果：可保存修复后的图片，也可单独保存遮挡蒙版。
- 高清街景加载：百度街景链接会通过下载全景瓦片并投影，生成 1920×1080 的高清透视图。
界面布局
- 左侧：工具栏（图片输入、自动识别、手动涂抹、去除遮挡、保存）
- 右侧：图片画布，支持缩放和涂抹操作
- 底部：状态栏，显示当前操作状态
二、运行环境
- 操作系统：Windows 10 / 11
- Python：3.10 及以上
- 依赖库：PySide6、OpenCV、NumPy、Requests、Pillow、Ultralytics、ONNX Runtime
三、操作指南
1. 加载图片
方式一：打开本地图片
点击左侧工具栏 「打开本地图片」按钮，选择需要处理的 JPG、PNG、WEBP、BMP、TIFF 等格式图片。
方式二：从网址加载
在地址输入框中粘贴以下任一类型的链接，点击 「从网址加载」：
- 普通图片直链（以 `.jpg`、`.png` 等结尾）
- 百度街景分享链接（如 `
https://map.baidu.com/@...#panoid=...&;heading=...&pitch=...`）
> 提示：百度街景链接加载时会自动下载全景瓦片并投影为高清透视图，过程大约几秒到十几秒，请等待状态栏提示完成。
2. 自动识别遮挡物
1. 在 「自动识别遮挡物」 区域勾选需要识别的类别。
- 默认勾选：行人、自行车、汽车、摩托车、公交车、卡车
- 可选：红绿灯、消防栓、停止标志、停车计时器、长椅
2. 拖动 「置信度」 滑块调整识别阈值（默认 0.25）。
- 值越大，识别结果越严格，误检越少。
- 值越小，识别结果越多，可能包含更多误判。
3. 点击 「开始自动识别」。
4. 识别完成后，遮挡区域会以绿色半透明蒙版显示在图片上。
5. 如需重新识别，可点击 **「清除自动识别结果」** 后再次识别。
3. 手动涂抹遮挡物
1. 选择 「画笔（红色高亮）」 或 「橡皮擦」模式。
2. 拖动 「笔刷大小」滑块调整笔触粗细。
3. 在右侧图片上按住鼠标左键涂抹需要标记的遮挡区域。
- 画笔模式：在图片上画出红色高亮区域，表示需要去除。
- 橡皮擦模式：擦除已涂抹的红色区域。
4. 支持以下辅助操作：
- 撤销：撤销上一步涂抹
- 重做：恢复撤销的涂抹
- 清空涂抹：清除所有手动涂抹区域
> 提示：自动识别和手动涂抹的遮挡区域会合并计算，可以同时使用两种方式。
4. 去除遮挡物
1. 确认图片上已显示需要去除的遮挡区域（绿色为自动识别，红色为手动涂抹）。
2. 在 「去除遮挡」 区域拖动 「修复分辨率」 滑块设置修复尺寸（默认 1024）。
-
数值越大，AI 修复细节越丰富，但处理速度越慢，显存/内存占用越高。
-
数值越小，处理速度越快，但修复质量可能下降。
3. 点击 「去除遮挡物」按钮。
4. 等待 AI 模型处理完成，画布上的图片会替换为修复后的结果。
5. 若对结果不满意，可点击 「还原原图」 重新调整蒙版后再次修复。
5. 保存结果
- 保存修复后图片：点击后选择保存路径，输出为 PNG 或 JPG 格式。
- 保存遮挡蒙版：点击后选择保存路径，输出为 PNG 格式的黑白蒙版（白色为遮挡区域）。
6. 视图操作
- 缩放：按住 `Ctrl` 键，滚动鼠标滚轮可放大或缩小画布。
- 自适应：加载新图片时，画布会自动适应窗口大小。
四、注意事项
1. 网络要求：百度街景加载和 YOLO 模型首次运行需要联网，请保持网络畅通。
2. 临时文件：软件启动时会在项目目录下创建 `temp` 文件夹存放临时缓存，关闭软件时会自动清理。
3. 修复分辨率：如果电脑配置较低或图片较大，建议将修复分辨率适当调小，避免内存不足。
4.
AI 修复限制：对于大面积遮挡或纹理复杂区域，AI 修复可能无法完全还原真实场景，可结合手动涂抹反复调整。
五、常见问题
Q1：百度街景链接加载失败？
- 检查链接是否完整，是否包含 `panoid` 参数。
- 检查网络连接是否正常。
- 尝试重新复制浏览器地址栏中的链接。
Q2：加载的百度街景图片和网页上看到的角度不一致？
- 本软件优先读取百度街景 URL 路径中 `@...h` 的角度参数，以匹配网页实际显示的画面。
- 请确保复制的是浏览器地址栏中的完整链接。
Q3：自动识别效果不理想？
- 尝试调整置信度阈值。
- 勾选更多识别类别。
- 结合手动涂抹功能补充未识别到的遮挡区域。
Q4：去除遮挡出现模糊或不自然？
- 尝试提高修复分辨率。
- 检查蒙版是否覆盖了过多非遮挡区域。
- 对于复杂区域，可多次小范围修复，避免一次性修复过大区域。
图片：
------------------------
六、文件
回帖后才可看到本帖隐藏内容。VIP贵宾免回帖。
乱打内容会被封号。可粘贴一句“感谢楼主分享”
[
本帖最後由 魔嘉 於 2026-7-29 13:52 編輯 ]
English
简简切換
