Jasna VR180 视频修复完全指南分眼检测、片商投影自动路由与快速上手【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是面向视频修复的开源工具对 VR180左右眼并排的 VR 画面有专门处理自动识别 VR180 格式、把画面拆成左右眼分别做视频修复再按片商规则选择马赛克展平方式全程默认配置即可跑通。本文带你从零理解它的工作方式并给出 GUI 与 CLI 两种动手路径。硬修 VR180 会翻车在哪分眼处理怎么解决先看痛点。VR180 视频里左眼、右眼两幅画面并排挤在同一个宽幅画幅中典型如 3840×1920左右各 1920×1920。如果直接把它交给普通 2D 修复模型模型看到的是两幅画面拼接后的变形图马赛克检测与重建都会失准修出来的结果往往是糊的、扭曲的。Jasna 的做法是拆开来修流程分三步把宽画面对半切开得到左眼、右眼两路独立信号每只眼各自完成马赛克检测与修复互不干扰把两眼的修复结果拼回并排画幅输出。这一步的核心逻辑在 jasna/vr180.py 的SbsDetectionAdapter检测框和掩码始终留在源画面坐标里只有马赛克区域的修复差分会被重新贴回去马赛克以外的像素原封不动。记住这个结论分眼不是为了好看而是为了让 2D 模型看到正常比例的画面。理解了这一点后面所有配置都好懂。识别、拆眼、投影决定成片质量的三个开关Jasna 对 VR180 的处理链路上有三个决定因素先判断这是不是 VR再执行怎么拆眼最后决定马赛克按哪种投影展平。识别自动模式靠什么判断一个视频是 VR默认选自动时Jasna 满足以下任一条件就启用分眼处理判断逻辑在resolve_vr_mode()日志会打印一行VR mode: requestedauto resolvedsbs/off projection... reason...供你确认条件说明严格 2:1 且高度 1080如 3840×1920、8192×4096直接判定为并排 VR文件名含已知片商标记如FSVSS、SAVR、S1VR、VRKM文件带 VR 空间元数据并排 等距柱状的立体/球面投影标记三条都不满足时文件按普通平面视频处理不会误伤。规则细节可查 docs/zh/vr180.md。拆眼强制分眼与偶数宽度限制自动模式偏保守漏认时可以用强制档位sbs把所有文件都当 VR 拆眼处理投影仍按片商路由sbs-fisheye则在此基础上让所有马赛克统一走鱼眼投影。注意两条硬约束SBS 处理要求帧宽度为偶数奇数宽度会直接报错显示宽高比不在 1.90–2.10 区间时日志会给出 unusual SBS aspect 警告。投影按片商自动选择马赛克展平方式不同片商制作马赛克的方式不同不存在一套通吃所有视频的投影参数所以 Jasna 内置了一张片商→投影路由表jasna/vr180.py 的STUDIO_PROJECTION。三种投影的含义raw原始——按画面原样使用马赛克区域未知片商时的安全默认fisheye鱼眼——马赛克在鱼眼视图下才显示正常的片商适用gnomonic等距/球心投影——平坦无变形的视图最利于 2D 修复模型。路由规则如下自动模式下生效来源片商投影路由表ATVR、CJVR、IPVR、KAVRraw路由表NHVR、PXVR、TMAVR鱼眼路由表VRPRD等距投影文件名含鱼眼片商标记FSVSS、SAVR、URVRSP、CRVR、PXVR鱼眼投影不满意可以在区间编辑器里手动覆盖打开修复预览在VR 投影菜单选 自动 / 原始 / 鱼眼 / 等距投影菜单标签会实时显示自动模式实际解析出的值点应用后该视频保存此选择最终处理与预览一致。提醒一点区间编辑器预览只显示左眼但扫描和导出处理的是双眼不影响最终效果。三个开关都清楚了接下来选一条动手路线。动手做GUI 四步走与 CLI 一行命令GUI 路线四步修完一个 VR180像添加普通视频一样添加 VR 视频高级设置中把VR180 模式保持自动推荐设置项定义见 jasna/gui/settings_sections/advanced.py检测模型选内置的rfdetr-vr-v1——VR180 专用zelefans-vr-yolo-v2需单独下载是可选备用模型清单见 docs/zh/models.md开始处理。只想修一部分用区间编辑器指定时间段即可。CLI 路线用 --vr-mode 控制行为纯命令行用户只需关心--vr-mode参数完整用法见 docs/zh/cli.mdjasna --input input.mp4 --output output.mp4 --vr-mode auto jasna --input input.mp4 --output output.mp4 --vr-mode sbs-fisheye四个可选值值行为auto默认自动识别 片商投影路由off当普通平面视频处理sbs强制分眼投影仍按片商路由sbs-fisheye强制分眼所有区域用鱼眼投影另外记住LTX 引擎不支持 VR180 并排视频遇到 VR 文件请搭配 BasicVSR 使用。两条路线都走通后剩下的是几个新手常见疑问。容易踩的坑显存、漏识别与变形疑虑坑VR 修复比 2D 更吃显存解法左右两路分别处理占用确实更多。显存吃紧时优先把最大片段长度调小例如 180 → 60Jasna 还会在显存不足时自动把等待帧临时挪到内存不用手动配置。坑我的 VR 文件没被自动识别解法自动模式偏保守——2:1 规则要求严格 2:1 且高度超 1080低分辨率或比例不精确的文件会漏掉。此时在设置里改选SBS — 分眼处理强制启用前提帧宽度为偶数。坑修完画面会整体变形吗解法不会。检测、跟踪、掩码、混合全程在源坐标进行只有马赛克区域的修复差分经过投影变换实现见 jasna/vr_projection.py区域外像素原样保留。坑区间编辑器里只看到一只眼解法那是设计如此——预览展示左眼处理时双眼都会修不必担心。这些坑基本覆盖了你上手 VR180 修复时会遇到的所有摩擦点。收个尾Jasna 处理 VR180 的思路浓缩成三点自动识别2:1 高分辨率 / 片商名 / 空间元数据三选一触发、分眼独立修复拆开检测修复再拼回、片商投影路由raw / 鱼眼 / 等距投影自动选择可手动覆盖。保持默认自动模式配上内置的 rfdetr-vr-v1 检测模型开箱即用。【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考