播放视频时,右键“A–B 循环”依次把当前点设为 A 入点、B 出点;B 必须晚于 A,设置后自动循环。菜单可暂停循环或清除标记,换片会清除 A/B,暂停播放不会自动跳转。
右键“在 VS Renderer 中打开当前视频”打开完整视频;“将 A–B 段送到 VS Renderer 时间组”会按源帧率对齐区间,建立前段、A–B 段、后段并选中 A–B 组,方便加滤镜。两者均打开新的 Renderer 窗口,适用于本地普通视频;不会自动编码。独立播放器首次使用需选择已安装的 VSRenderer.exe。
在“设置 → 文件关联”勾选格式,点击“安装所选格式的资源管理器缩略图”,可为 JXL、AVIF、WebP、HEIC/HEIF、QOI、JPEG 2000、EXR 和高位深 AV1 等生成预览,不改变默认打开程序。卸载按钮恢复安装前的缩略图处理器;安装只作用于当前 Windows 用户。
这是 Windows 文件列表缩略图,与下方进度条悬停预览独立。安装会将组件及匹配的 FFmpeg 依赖复制到用户本地目录,单文件播放器退出后仍可使用;升级后可再次安装。缩略图用于浏览,不作为 HDR/ICC 色彩校准依据。
OpenNGU 本地接入:在“图像处理 → 上采样滤镜 → 常规直通模式”中第一项为 OpenNGU,后接 Jinc、D3D11;第二上采样第三项为 OpenNGU,默认仍为 Jinc。BT.709 SDR 使用运行目录 shaders/OpenNGU-AA-Medium-BestMatch-2x-SDR.hlsl 及其相邻缓存;不可用时回退并在 Tab 说明。第二级只在已有处理结果仍需放大时执行,保留原滤镜。私有参数由用户本地提供,不包含在公开源码补丁中。
“记住播放位置”同时保存当前文件的音轨、两路字幕选择/关闭状态、字幕显示开关及外挂文件。打开后等轨道信息就绪再恢复;失效轨道/不存在外挂回退到默认选择,不改用户原文件。BD导航显式传入的轨道优先于历史记录。
进度条悬停缩略图通过随包FFmpeg单线程独立解一帧,不跳动主播放器。220ms防抖、过期请求取消、32张缓存和10秒超时;仅本地普通媒体,网络/BD MPLS/音频/图片模式不生成。设置可关闭。缩略图是导航预览,不用于HDR色准判断;安装目录需包含ffmpeg.exe。
Tab显示当前帧率、实时缺口、音视频与色彩状态,界面说明统一使用英文括号。底部处理路径详情暂时隐藏,并移除系统首个GPU说明;输出交换链位深不等于显示面板位深。
渲染设置的“视频渲染器”下一行是“音频渲染器”,全新配置默认 3FP (WASAPI)。下一行选择 Windows 默认端点或实际枚举的设备,随后是独占开关。设置保存在 audio/renderer、audio/endpoint、audio/exclusive,导入/导出 INI 同步保留。旧版明确选择 LAV 的配置迁移为 DirectShow,不覆盖已有用户选择;Lite 固定为 3FP。
3FP 设备与独占复用已有 C ABI,异步打开完成后、Play 前提交独占设置。共享模式遵守 Windows 混音格式;配套内核补丁使独占优先协商源采样率,不支持才尝试混音率和常用率。切换音轨、外挂音频或解码后发现采样率变化会重新协商。Tab 信息显示内核返回的实际输出率、共享/独占、独占回退与重采样,而不是用保存值冒充硬件结果。
Full 的 DirectShow 选项连接既有 LAV Audio + 系统渲染图,与解码页 LAV 选择联动。3FP 设备/独占选项不作用于 DirectShow;网络、MPLS、倍速等原有原生回退约束仍保留。madVR 使用 3FP 音频时,回到 1 倍速不再错误地静音原生音频。
**3FP 仍为 PCM 输出,没有新增 Dolby/DTS/TrueHD IEC61937 码流直通。**独占不等于 bit-perfect;音量、EQ、声道变换及倍速仍可能改动 PCM。DirectShow 的码流能力取决于 LAV 配置、系统渲染器与接收设备,本轮未做 AVR 直通验收。
配套内核允许用户明确打开的 \\server\share\file.mkv、//server/share/file.mkv、file://server/share/file.mkv(GUI 转换后)与扩展 UNC 文件路径。Unicode、空格和长路径保留。Windows 当前账号必须已有 SMB 权限,本程序不绕过认证、不保存 NAS 密码。
仍拒绝设备命名空间、GLOBALROOT、命名管道、IPC$、DOS 设备名、备用数据流、目录和 reparse/junction。UNC 媒体内部再引用其他文件/URL 会被阻断;DFS、共享根重定向、网络播放列表、NAS 实机 VS 索引不在已验收范围。
空置时显示按钮教程和虚线指引,打开媒体或进入极简模式后隐藏。内容保存在滤镜说明JSON的playerGuide字段:Full为程序目录下vpy/preset-descriptions.json,单文件版为EXE旁的preset-descriptions.json。首次补入默认教程会保留已有滤镜说明,编辑保存后即时刷新。
center.text修改中间文字,center.x/y是相对页面宽高的比例;guides中的targets指定控件ID,虚线横坐标跟随这些控件中心的平均位置。length为向上虚线长度,xOffset调整整条指引横向偏移,textOffsetX只移动文字,width控制文字换行宽度;这些尺寸均为Qt逻辑像素。修改text即可改说明,baselineGap控制虚线底端与进度条之间的空隙。默认模板位于源码assets/player-guide.json。
打开或拖入视频、音频、图片;右键可打开文件夹或网络链接。Ctrl+O 打开媒体,Ctrl+P 加载 VPY。图片和网络视频不执行 VS 滤镜。
底栏提供播放、逐帧、关键帧、前后文件、时间/帧号输入和倍速。普通视频拖动进度条可预览,松开精确定位并恢复原状态;BD 松开后只提交最终定位,见 蓝光。帧号修改后按 Enter 或移开焦点提交。
进退一帧会暂停播放并移动到相邻画面,再按播放可继续;直通模式按当前画面的时间戳定位,长视频无需从头扫描。直接输入绝对帧号在未建立对应索引时仍可能需要较长等待。
| 操作 | 快捷键 / 鼠标 |
|---|---|
| 播放/暂停 | Space |
| 切换全屏 / 退出全屏 | Enter 或 F11 / Esc |
| 输入/输出与运行信息 | Tab |
| 短跳转 | ←/→,默认 ±1 秒,设置中可改帧/关键帧 |
| 较大跳转 | Ctrl+←/→ 默认 ±10 秒,Ctrl+Alt+←/→ 默认 ±60 秒 |
| 切换图片 | ←/→,同目录名称排序 |
| 滚轮 | 视频默认音量,可改鼠标锚定缩放;图片缩放,Shift+滚轮平移 |
D3D11/Jinc 和无预设原画使用 3FP 直通,不建立 VS 索引。右键“图像处理”分别选择“上采样滤镜”“第二上采样滤镜”“下采样”。主滤镜中的 Anime4K A CNN、AFast CNN、AFast 1X 各有普通与额外增强两档,六档归在一个子菜单,常规算法单列;第二上采样默认 Jinc (Anti-Alias),独立于下采样。AFast 1X 在源尺寸处理,不执行 CNN 放大;最终放大交给第二上采样,切换 1X 两档不会改变第二上采样选择。RTX VSR 开启时提示并改用 D3D11 主直通。Full/Lite 均支持这三段;Lite 不执行任意 VPY 或补帧组合。
Full的vpy/preset-descriptions.json也管理算法和菜单标题的鼠标悬停说明,修改后重新打开右键菜单生效。停留在“上采样滤镜”“第二上采样滤镜”“补帧”等父分类标题上就会显示说明,不需要移入子菜单;进入子菜单或离开分类后停止显示该分类说明。Jinc沿用builtin/Anime-4-Jinc.vpy,D3D11沿用builtin/Anime-5-D3D11.vpy,你原来填写的内容会在常规直通、第二上采样和下采样中共同显示。其余算法各使用一个scaling/Nearest、scaling/Bilinear、scaling/Bicubic、scaling/Lanczos3、scaling/Lanczos4、scaling/Spline36或scaling/SuperXbr键,三个采样菜单共用。
分类标题使用menu/开头的键,包括upsampling、secondUpsampling、downsampling、anime4k、passThrough、interpolation等。补帧自动切换的两种输出模式分别使用interpolation/auto/Jinc和interpolation/auto/D3D11,与builtin/Interpolation-0-RIFE.vpy及其D3D11变体的全宽高RIFE说明分开。六档 Anime4K 的悬停说明使用 anime/8、anime/9、anime/0、anime/1、anime/6、anime/7,依次对应 A CNN 增强/普通、AFast CNN 增强/普通和 AFast 1X 增强/普通。新增默认键见源码assets/player-menu-descriptions.json;补齐缺失键时保留已有说明和playerGuide。
内置 Anime4K 使用原生 HLSL;修改过的 VPY 或不兼容着色器保留原 GLSL。302/915 个库条目已预编译;归档里的源文件和配套字节码一起按需提取,不要求每次重新转换。不支持的 COMPUTE、CHROMA、OFFSET 等语义仍明确拒绝或回退。
原始高度 ≥2160p 时禁用内置 Anime4K,Jinc/D3D11 保持可选。渲染设置列出六档 Anime4K、MoeSR 和 Jinc/D3D11 直通,单击选择起始档位、勾选参与自动切换,D3D11 必选;Tab 与底栏显示实际生效链路。自定义 VPY 不受此内置限制,需自行评估资源。
“VapourSynth 预设”只显示用户与社区预设。用户说明来自 Renderer 预设管理的备注;开发者说明由 vpy/preset-descriptions.json 的 builtin/文件名.vpy 键填写。程序只补缺失的空键,保留已写说明,不内置推荐文案。
完整便携版的说明文件位于 VS-GUI-Full/vpy/preset-descriptions.json。只修改冒号右侧双引号内的说明,例如 "builtin/Anime-0-CNN-Enhanced.vpy": "这里写你的说明";保留左侧路径、双引号与条目间逗号,保存为 UTF-8。保存后重新打开右键菜单即可读取。开发运行读取 build/mingw-release/vpy/preset-descriptions.json,这是另一份文件。
Full“图像处理 → 补帧”提供 Jinc/D3D11 自动入口以及 RIFE、RIFE 半宽高、MVTools HQ/LQ 的固定组合。渲染设置用 Jinc/D3D11 两排复选框分别控制自动补帧参与档位;未勾选的档位会跳过,到最后一档仍超载时显示提示。旧配置的补帧起始档位会转换为从该档起参与。关闭补帧后恢复 Anime 自动超分。单文件 Player 提供内置原生 Anime4K、Jinc/D3D11 和自定义着色器,不执行任意 VPY 或 RIFE/MVTools。
“超分补帧组合”的前三项先 Anime4K 到 2160,再把整帧降到 960×540 补帧,最后选择 Anime4K/Jinc/D3D11 输出;原帧细节也会下降。第四项只用半尺寸 RIFE 推理,保留 1080 原帧,再 Anime4K 到 2160。前者的流畅不代表保留了前一级超分细节。4070 Laptop 的指定样本中,Jinc/D3D11 末端达标;另外两项未达标,详见性能台账。
HDR 映射使用上游 RTX TrueHDR,仅允许 D3D11 直通;不兼容路径会提示“请切换到d3d11模式”。详细配置进入渲染/色彩页,实际状态受 NVIDIA 驱动、源格式和 Windows HDR 输出限制;VideoEnhancer 的中灰 22 参数未映射到此接口。
Full 默认将未修改正文的内置 Anime4K 交给原生 D3D11/HLSL。内置 VPY 仍保留,程序核对正文后再选择路径;手工修改同名文件不会被当成原生模板跳过。HDR、主动启用 libplacebo 色彩处理、先缩放后增强、超过 3840×2160 的滤镜视口等情况继续原 GLSL/VPY,状态栏说明原因。
旧发行包中仅使用core.placebo.Shader旧插件名称的原装档位,也识别为同一套HLSL模板,无需覆盖现有VPY;增加裁剪等实际处理的脚本继续由VS执行。
右键“VapourSynth 预设 → 用户自定义 → 以 HLSL 执行”控制 Full 的优先 HLSL 路径,并记住选择。自定义 VPY 需要同时满足以下条件才能提取 shader:
- 含本项目生成的滤镜图元数据,且实际 Python 正文与该图重新生成的内容一致。
- 只有一个从头到尾的时间组,目标 shader 位于启用处理链的末尾。
- shader 的语法、hook、资源绑定、输出尺寸和色彩路径均在原生执行器的支持范围内。
提取后,前面的滤镜与源读取仍由 VapourSynth 执行,末尾 shader 在 GPU 纹理上运行。原有处理顺序保持不变。中间节点、额外 Python、逐帧回调、时域滤镜和 AI 插件不会被自动翻译成 HLSL;关闭开关或检查失败时继续原 VPY。运行失败也会恢复原 GLSL,并显示原因。
在本地视频模式右键打开“自定义 GLSL/HLSL 着色器”:
-
选择“导入着色器…”,打开
.hlsl、.glsl或.hook文件。 -
.hlsl直接编译;兼容 mpv GLSL 经过 GLSL → SPIR-V → HLSL → D3D11 字节码转换。成功后才切换当前选择。本地多通道HLSL支持:同一
.hlsl可包含多个以//!HOOK MAIN或//!HOOK PREKERNEL开头的段,使用//!BIND、//!SAVE、//!WIDTH、//!HEIGHT等指令描述资源和输出尺寸。每段是独立的main/ps_5_0HLSL;播放器逐段编译执行,不能把所有段直接交给单次FXC编译。普通不含HOOK指令的HLSL仍沿用单pass约定。此格式需要包含该续修的播放器。 -
“存储路径(浏览)…”可选择保存目录;默认位于配置文件旁的
shaders/custom。导入源按内容标识保存,字节码在该目录的cache中;已保存源出现在同一菜单。 -
选择“关闭自定义着色器”恢复普通缩放。底栏与
Tab显示实际生效路径。
图片、音频、网络和 madVR 模式会禁用该导入菜单。直接播放时遇到不兼容的媒体或色彩设置,程序停用该视频的自定义 shader,保留视频播放及导入源;打开下一个文件时重新检查。单文件版没有通用 GLSL 执行后端,转换失败会说明原因,不会将不兼容文件当成成功启用。
缓存按保存的源内容、转换语义版本、转换器及编译器标识校验后复用;内容或工具变化会在下次导入或载入时重新转换,截断或结构损坏的缓存会重建。导入失败保留此前有效的着色器与选择。外部源已复制到存储目录后,修改外部原文件需要重新导入。播放帧不调用 Python 或 Windows SDK;GLSL 导入需要 runtime/shader-tools 中的转换组件,缺失时会明确报错。
通用 GLSL 导入支持 MAIN / PREKERNEL / LUMA 的多 pass 像素着色器,以及受支持的 BIND、SAVE、WHEN、WIDTH、HEIGHT、COMPONENTS 语义。按 MAIN → PREKERNEL 阶段执行,各阶段保留文件顺序;覆盖当前 PREKERNEL 图像时不接受显式宽高。中间纹理使用 FP16,COMPONENTS 1~4 正确补齐未存储的通道;每份文件最多 128 个 pass、每 pass 最多 16 个纹理绑定。
尺寸表达式支持 .w/.h、.width/.height 及 + - * / > < = !;WHEN 为 0 时跳过对应 pass。NATIVE 仅可用于读取原始宽高,不提供其像素采样;依赖被跳过 pass 的纹理等运行时不兼容情况会明确失败。仅支持程序所定义的普通 SDR RGB 路径;HDR、BT.2020/P3 色域、额外显示变换等情况会被拒绝或回退。LUMA hook 先按当前受支持 SDR 矩阵提取亮度,再合回 RGB;不代表支持 CHROMA 或 HDR shader。
每个像素pass最多读取16张纹理,导入、缓存校验和原生执行使用同一D3D11限制;完整Mode A(49个pass、最多15个绑定)已完成编译及1×/2×/3×/4× GPU输出对照。此结论不扩展到未实现的计算着色器等语义。
CHROMA 等未实现 hook、计算着色器、外部纹理、OFFSET、#include 和不支持的指令不会被忽略。每份文件的实际支持情况以导入检查结果为准,不能仅因扩展名正确或语言编译成功就视为兼容。
原生 HLSL 使用 main / ps_5_0,可读取浮点 TEXCOORD0 和 SV_Position,输出为浮点 SV_Target0;浮点二维源纹理绑定 t0,普通线性 clamp 采样器绑定 s0。不支持整数纹理、比较采样器或额外资源布局。最小透传示例:
Texture2D<float4> Source : register(t0);
SamplerState LinearClamp : register(s0);
float4 main(float2 uv : TEXCOORD0) : SV_Target
{
return Source.SampleLevel(LinearClamp, uv, 0);
}可选常量缓冲 b0 必须是总计 32 字节、偏移分别为 0 和 16 的两个 float4,可命名为 sourceSize 和 outputSize,各自 xy 为尺寸、zw 为其倒数。直接播放的 HLSL 目标尺寸随视频视口决定。需要其它入口、寄存器布局、资源类型或运行时的 HLSL 须先适配接口。
底栏音量显示百分比;静音按钮使用话筒图标,带斜线表示静音,静音保留音量数值。静音下方的 EQ 按钮展开均衡器浮层,调节即时生效,点击按钮或浮层外部收起;不打开独立对话框。均衡器与倍速面板只保留一个展开。
右键选择内/外音轨、同步、均衡器及主/次字幕。同目录匹配的音频和字幕可自动加载,其余匹配结果在菜单切换;轨道显示名称、语言和 Default/Forced。
Full 的“AI 实时字幕”使用独立组件。先从下载页面安装 AI-Subtitles,或将完整扩展目录指定到字幕设置,再从右键启用。本轮已准备 Qwen3-ASR-0.6B INT8 CPU 包与真实音频测试;远端列表要等待维护者上传。安装布局、文件与模型来源见 组件指南。识别窗口默认 5 秒,末尾不足一窗也会提交;跳转按 generation 丢弃旧结果。字幕不做翻译,也不保证逐词时间戳精度。
播放视频时,音频拖到画面上半部挂为外部音轨,下半部单独播放;字幕拖到上 40% 挂为次字幕,下 60% 挂为主字幕。通过菜单核对当前选择,避免误加载其它集数。
窗口模式底栏位于视频下方;全屏为自动隐藏浮层,约一秒无操作收起,鼠标移到实际底栏区域唤出。顶部可唤出标题和退出全屏按钮。
主题设置分别控制底栏、播放列表与右键/倍速菜单不透明度;新配置底栏与菜单默认 100%。Tab 面板可调整大小,透明度条独立显示,也可启用右侧音频峰值详情。
设置左下角可加载/保存完整 INI。“确定”保存关闭,“应用”保留窗口与播放状态。文件关联页注册格式后,仍需在 Windows 默认应用中选择播放器。
截图/PhotoCraft 见 截图与图片,HDR 与高级输出见 色彩,卡顿见 性能排查。
- 音量条为 0–200%,百分比可编辑;静音、EQ和百分比位于音量条下一行。上下键默认每次5%,滚轮最大100%。EQ再次点击关闭,M再次取消静音,L再次收起播放列表。右键音频处理可打开低延迟动态响度标准化,默认关闭。
- 设置→快捷键集中配置动作、步进和值及开关;默认
Ctrl+↑/↓调倍速,Ctrl+Shift+←/→切章节,Ctrl+C复制当前帧 PNG,.进退极简模式。 - 极简模式只解码音频;音频默认使用该模式,窗口过窄时也自动进入,收为紧凑音频窗口,不显示Tab详细信息。按
.切换时保持当前进度及播放/暂停状态;Enter 进入全屏,再按 Enter 回到常规模式。常规音频模式才显示封面与歌词。 - 图片工具栏“缩放、压缩和转换格式”可固定比例或拉伸。Full 经 RAW 中间图像交给 AWJ;SDR 非 sRGB 像素先转换到 sRGB,原文件不改写,原 EXIF 不通过 RAW 复制。HDR 使用线性 scRGB FP16 接口。Lite按所选传统/HLSL算法重新采样并调用外部FFmpeg输出,具体选择见下文。
- 动画 GIF 走视频播放;多页 TIFF 以 100ms/页循环,可暂停,TIFF 不提供 GIF 式逐页时长。
- 页面主题保存在程序旁
themes.ini,使用VSP-Main、VSP-Settings;默认背景透明度高、亮度低,避免遮住文字。 - 性能页的缓冲池上限只作用于 2160p 及以上软解,Auto 不超过应用内存预算的一半。常规仅按8帧和解码流水线计算预算,不预占内存上限;尖峰前15秒临时扩至最多48帧、4GiB(含解码流水线预留),合并连续尖峰后缩回8帧目标;跳转后重新探测。内存分配器可能保留已分配缓冲,RSS 不保证立即回到启动基线;指定 GBC 片段测量见源码工作区测试台账。功耗接口及权限要求见本页下方说明。
- 单文件首次运行在 EXE 旁解包到本次进程目录,退出后清理;崩溃留下的受控目录在下次启动清理。该位置须可写,FFmpeg shared 仍放在旁边或 PATH。
底栏为状态提示保留一行文字的固定高度,文字显示3秒后清空,避免控件上下跳动;打开媒体时显示“打开文件:文件名”。EQ浮层位于整个控制栏上方,分贝刻度不与进度条重叠。Tab中的三段缩放算法在同一行,切换到其他窗口后保持显示,再按Tab关闭;音频详情下拉列表展开时保持在信息面板上方。
输出尺寸可填写分辨率,也可切换为比例,输入 2x、50%、1:2 或 1/2。Full支持传统算法、五种内置HLSL重新采样(最近邻、双线性、Jinc、Lanczos3/4),以及从内置库选择GLSL滤镜;实际可用性取决于该滤镜的离线图片路径。Lite提供传统算法及Native支持的同五种HLSL;两者均直接调用外置FFmpeg编码,不使用AWJ或质量搜索。HLSL是内置重新采样内核,不是任意模型的图片导出接口。
位深按格式选择:PNG默认16、可选8;JXL默认12、可选8/10/16;AVIF默认10、可选8/12;WebP固定8。当前JPEGli后端只支持8位JPEG,因此Full的JPEGli与Lite的FFmpeg JPEG均固定8位,未提供无效的10位选项。色度采样显示完整的yuv420p、yuv422p、yuv444p。Full的质量搜索仍由AWJ执行。
“设置 → 主题”中的多页面主题支持保存主题名称、背景图、透明度、亮度与颜色;主题库可切换已导入主题,支持文件夹和 ZIP/7z 导入、ZIP 导出。包内为 skin.ini 与图片,导入图片复制到配置目录的 themes/;保存后立即刷新已打开的页面,无需重启。背景位于独立底层,视频预览区域保持原画面;使用较低亮度可让文字清晰。单文件版的主题和配置保存在启动器旁,退出清理运行目录不会删除它们。
“设置 → 渲染设置 → 查看超分算法Pareto图”读取 player.ini:
[render]
paretoImage=填入图片或 HTML 的绝对路径,也可填相对该 INI 的路径;点击后用系统关联程序打开。Full 使用 VS-GUI-Full/player.ini,单文件使用 VS-Player.exe 旁的 player.ini。图放在配置旁时会保存相对文件名;旧设备绝对路径失效时优先寻找配置旁的同名文件。默认文件名为Pareto.avif,单文件还可读取已打包的同名图;迁移自定义图时须连同图文件或重新打包。程序不生成或下载图表。
Tab 功耗显示:NVIDIA GPU 复用系统已安装的 NVML,数值为受支持 NVIDIA GPU 的功耗合计;CPU 复用已安装的 PawnIO 和官方只读模块。接口缺失、硬件不支持或权限不足显示 N/A;程序不安装驱动或更改权限。本机普通权限的 CPU 读取被驱动拒绝,GPU 读取已实测。原始计数差分和支持边界见源码工作区 development/pawnio-power.md。
《摇曳露营 Movie Flac X2》的默认 FLAC 2.0 抽样原始响度偏低;100% 保持原始增益,需要提升可按素材启用动态响度标准化或手动主音量。检测结果是该素材抽样结果,不作为所有视频的统一加增益依据。
RAW 图片由配套 Native 内核和 libraw.dll 开发,使用完整尺寸、相机白平衡及16位 sRGB 输出;打开失败明确提示,不使用缩略图冒充开发结果。蓝牙同步补偿在解码设置中启用,codec 可手动指定,补偿叠加声音同步的手动偏移;端点识别与刷新率更新约5秒检查一次。估计值并非实际耳机延迟测量。