企业官网建设流程全解析

Jasna自动修复VR180视频完整教程：分眼处理与按片商智能选择投影

【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna

Jasna 是一款 JAV 视频修复工具，内置 VR180 视频自动修复能力：它会识别并排（Side-by-Side）VR 画面，把左眼、右眼拆开分别修复，再重新合成输出；同时会根据片商（工作室）智能选择最适合马赛克区域的修复投影（raw / 鱼眼 / 等距投影），全程无需手动配置。本文面向新手，手把手讲清 Jasna 如何自动处理 VR180 视频。

什么是 VR180 视频？为什么要分眼处理？

VR180 是常见的 VR 视频格式：左右两眼的画面并排拼接在同一个宽幅画面里（例如 3840×1920，左右各 1920×1920）。

直接用普通方式修复这类视频会出问题：2D 修复模型看到的是"两幅画面挤在一起"的变形图像，修复效果不理想。Jasna 的做法是：

1. 把宽画面对半拆成左眼、右眼两路；
2. 对每只眼独立运行马赛克检测与修复，双眼互不干扰；
3. 把双眼的修复结果重新拼合成完整的并排画面输出。

这个分眼处理逻辑实现在 jasna/vr180.py 的SbsDetectionAdapter中：检测框和掩码始终保留在源画面坐标里，只有修复后的"差分"会被重新投影回去，马赛克以外的画面一个像素都不会被改动。

自动识别 VR180：Jasna 如何判断一个视频是 VR？

把 VR 视频像普通视频一样添加到 Jasna 即可，VR180 模式保持默认的"自动（推荐）"。自动模式按以下规则判断（详见 docs/zh/vr180.md）：

三条中任意一条满足就会启用分眼处理；都不满足时，视频会按普通平面视频处理，不会误伤。

💡 自动模式判断依据是 jasna/vr180.py 中的resolve_vr_mode()，日志里会打印一行VR mode: requested=auto resolved=sbs/off projection=... reason=...，方便确认它的判断结果。

按片商智能选择投影：Jasna 最巧妙的地方

各片商制作马赛克的方式不同，不存在一种适合所有视频的投影设置。Jasna 会在修复前按片商为每个马赛克区域自动选择最合适的展平方式，可选三种投影：

• raw（原始）— 按画面原样使用该区域，未知片商时的安全默认值；
• 鱼眼（fisheye）— 适用于马赛克在鱼眼视图下显示正常的片商；
• 等距投影（gnomonic）— 平坦、无变形的视图，最适合 2D 修复模型。

内置的片商→投影路由表（来自 jasna/vr180.py 的STUDIO_PROJECTION）：

此外，文件名中命中FSVSS / SAVR / URVRSP / CRVR / PXVR等鱼眼片商标记时，也会自动走鱼眼投影。

不满意自动结果？区间编辑器里手动切换

视频被识别为 VR180 后，区间编辑器（jasna/gui/segment_editor.py）中的VR 投影菜单会启用：

1. 打开修复预览；
2. 在VR 投影菜单中选择自动 / 原始 / 鱼眼 / 等距投影，直接比较当前帧效果；
3. 选择应用，该设置会为当前视频保存，最终处理将使用与预览相同的投影。

菜单标签会实时显示"自动"模式实际解析出的投影（如"VR 投影（自动：鱼眼）"），所见即所得。

💡 注意：区间编辑器预览只显示左眼，但扫描和导出处理的是双眼，效果不受影响。

快速上手：GUI 四步修复 VR180

1. 像添加普通视频一样添加 VR 视频；
2. 在高级设置中把VR180 模式保持为自动（推荐）（设置面板位于 jasna/gui/settings_sections/advanced.py）；
3. 检测模型选择内置的rfdetr-vr-v1（VR180 专用，效果最佳；zelefans-vr-yolo-v2为可选备用，见 docs/zh/models.md）；
4. 正常开始处理。只修一部分？用区间编辑器指定区间即可。

命令行玩家：CLI 快速修复 VR180

Jasna 也支持纯命令行（详见 docs/zh/cli.md），核心是--vr-mode参数，可选四个值：

示例命令：

jasna --input input.mp4 --output output.mp4 --vr-mode auto jasna --input input.mp4 --output output.mp4 --vr-mode sbs-fisheye

常见问题 FAQ

Q：VR 修复占更多显存吗？会多一些，因为左右两路分别处理。显存不足时优先调小"最大片段长度"（如从 180 调到 60），Jasna 也会在显存吃紧时自动把等待帧临时挪到内存，无需配置。

Q：为什么我的 VR 视频没被识别？自动模式比较保守：2:1 规则要求严格 2:1 且高度超过 1080。低分辨率或比例不精确的文件可手动选SBS — 分眼处理强制启用（注意：SBS 要求帧宽度为偶数）。

Q：修复后的画面会整体变形吗？不会。检测、跟踪、掩码和混合始终在源坐标进行，只有马赛克区域的修复差分会经过投影变换（实现见 jasna/vr_projection.py），区域外像素原样保留。

小结

Jasna 处理 VR180 的核心思路可以概括为三句话：自动识别（2:1 高分辨率 / 片商名 / 空间元数据）、分眼独立修复（双眼拆开检测与修复再拼合）、按片商智能选投影（raw / 鱼眼 / 等距投影自动路由，区间编辑器可预览并手动覆盖）。保持默认"自动"模式 + rfdetr-vr-v1 检测模型，就能获得开箱即用的 VR180 修复效果。

【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna