[Lua] k7f_zen “要是连这个都不会用，就别问vs滤镜怎么玩了”

[hooke007]

一句话介绍：应该是最简单的辅助使用vs滤镜的mpv脚本。

一天夜里，反复修改重写了一遍又一遍的测试脚本后，厌烦了那些大量的重复劳动，于是就有了这个基于 K7F 二次封装的脚本。
只关注我常用的测试功能，因此只封装了几个模块可供调用。

此脚本适用于：
vs和k7f文档看不懂的；
像我一样懒了的且要求不多的；

自动生成的vpy脚本肯定不如手写的全面，会看文档手写的还是建议你手写。

安装

1. （跳过冗长的vs前置部署教学）请直接使用最新的基于 vsNV 包版的mpv。
2. 下载 k7f_zen 到mpv脚本目录，示例的脚本选项和快捷指令可参考对应文件。

[hooke007]

脚本选项参数

选项	默认/可用值
cache_dir	~~/	生成临时vpy脚本的路径，需要确保目录真实存在
debug	no yes	使用快捷指令时，控制台输出所有选项更新后的值
vpy_view	log console osd	生成vpy时使用的内容记录模式
preset	0 1 2 12 21 3	功能预设。 （无，自定义超分，RIFE补帧，超分+RIFE，RIFE+超分，终极反交错）
append	yes no	此脚本滤镜的触发插入位置， yes 为末尾， no 为首位
display_h	-1	【整数】限制最终输出的高度（“RIFE补帧”前也会预处理到此高度），负值表示采用检测到的显示设备分辨率高度，0 为不限制
prescale_h	720	【整数】“自定义超分”前预处理的缩放高度
fps_max	32	“RIFE补帧”前判定跳过的原帧率阈值（原始帧率超过该值就不补帧）
model_uai	_test.onnx	“自定义超分”使用模型的完整文件名（只支持读取 .../vs-plugins/models/ 目录）
model_rife	46 ??	“RIFE补帧”使用模型的型号。其它可用值同步匹配RIFE模块参数 'model'
inference	dml migx trt	“自定义超分” 和 “RIFE补帧” 使用的推理引擎。 dml 为通用接口，但显卡必须支持DX12。 migx 为RDNA显卡专用。 trt 为RTX显卡专用，可最大化效果和速率
gpu	0 1 2	多个预设使用的显卡编号，值 0 表示显卡序号位1
gpu_t	2	【整数】推理引擎的线程数，一般不超过3

补充：

• 考虑到基本都是重型号滤镜，如果你的机器不够强，强烈建议你 preset 保持为 0 打开mpv，等加载待播放的文件完成后再用下方的示例调起滤镜防止启动耗时很长。
• model_uai 可使用的模型文件在这里。以前懒人包内置的旧vpy超分脚本使用的ESRGAN模型是AnimeJaNai系列。
  如果修改文件名或使用你从其它地方获取的模型，请不要使用奇怪的符号或空格作为文件名，会导致模型读取异常。
• 其它关于自定义超分类的问题可参考关联帖 《使用自定义的超分辨率AI模型》
• 如果你不了解什么是RIFE补帧，先看 《RIFE 实时补帧》
• prescale_h 如果你使用“超分+RIFE”，请注意把该值设为和 display_h 一样或更高（不然前面的超分就白做了）
• migx 暂无法使用。
• trt 推理引擎使用前，对于首次遇到的分辨率或首次更换模型，都要重新生成引擎（弹出一个黑色的终端窗口），这个过程依据你的机器性能或模型大小时间不一，也可能在这个过程中爆显存或出错闪退。
• 终极反交错指的是QTGMC，如果你没听过，那你一定用不到它。目前的这个版本是对性能需求十分巨大的（不亚于AI超分）。

快捷指令

除去示例input.conf里的内容，
建议优先打开控制台使用短版本的脚本命令（更方便，除非你愿意预先编写几十行命令覆盖所有需求。。。）

script-message vpy_update 选项名 选项值

比如中途更改vs滤镜使用的模块（一键RIFE补帧）：

script-message vpy_update preset 2

比如中途更改超分使用的模型：

script-message vpy_update model_uai Zarxrax_Anime1080Fixer_SUC_x1_fp32_op17.onnx

Tip

一个帮你快速略过重复输入前半部分的命令推荐你绑定到快捷键上

F1   script-message-to console type "script-message vpy_update "

[hooke007]

FAQ

• 运行时变更指令没有效果？
  • 看控制台报错信息。如果看到vs滤镜静默运行失败（大量橘黄色警告文字），先根据报错信息判定是不是你命令中传递参数错误。
    

    ## 如果是你的传递参数错误（例如）
    script-message vpy_update model_uai xxxx
    ## 需要重新传递正确值
    script-message vpy_update model_uai xxxx.onnx