视频选项
本节列出 mpv 的视频输出和渲染选项。
视频输出驱动
输出驱动选择
bash
# GPU 输出（推荐）
vo=gpu
# GPU-Next 输出
vo=gpu-next
# 空输出（仅音频）
vo=null
# 自动选择
vo=autoGPU API
bash
# Vulkan
gpu-api=vulkan
# OpenGL
gpu-api=opengl
# Direct3D 11
gpu-api=d3d11硬件解码
硬件解码器
bash
# 自动选择
hwdec=auto
# 安全模式
hwdec=auto-safe
# 强制硬件解码
hwdec=auto-copy
# 禁用硬件解码
hwdec=no特定硬件解码器
bash
# NVIDIA
hwdec=nvdec
hwdec=nvdec-copy
# Intel (Linux)
hwdec=vaapi
hwdec=vaapi-copy
# AMD (Linux)
hwdec=vaapi
hwdec=vaapi-copy
# macOS
hwdec=videotoolbox
hwdec=videotoolbox-copy
# Windows
hwdec=d3d11va
hwdec=d3d11va-copy
hwdec=dxva2
hwdec=dxva2-copy视频渲染
渲染配置文件
bash
# 高质量渲染
profile=gpu-hq
# 默认质量
profile=gpu
# 快速渲染
profile=fast渲染选项
bash
# 插值
interpolation=yes
interpolation=no
# 视频同步
video-sync=display-resample
video-sync=display-tempo
video-sync=audio
# 去隔行扫描
deinterlace=auto
deinterlace=yes
deinterlace=no色彩管理
ICC 配置文件
bash
# 自动加载 ICC 配置文件
icc-profile-auto=yes
# 指定 ICC 配置文件
icc-profile=/path/to/profile.icc
# 色彩管理意图
icc-intent=relative-colorimetric
icc-intent=perceptual
icc-intent=saturation
icc-intent=absolute-colorimetricHDR 支持
bash
# 启用 HDR
tone-mapping=auto
# HDR 色调映射算法
tone-mapping=mobius
tone-mapping=reinhard
tone-mapping=hable
tone-mapping=bt.2390
# HDR 色调映射参数
tone-mapping-param=0.5视频缩放
缩放算法
bash
# 缩放算法
scale=bilinear
scale=lanczos
scale=spline36
scale=ewa_lanczos
# 缩放参数
scale-param1=0
scale-param2=0抗锯齿
bash
# 抗锯齿
antialiasing=yes
antialiasing=no
# 抗锯齿参数
antialiasing-param1=0
antialiasing-param2=0视频滤镜
内置滤镜
bash
# 去噪
vf=lavfi=[hqdn3d]
# 锐化
vf=lavfi=[unsharp]
# 裁剪
vf=lavfi=[crop=1280:720:0:0]
# 缩放
vf=lavfi=[scale=1920:1080]GPU 滤镜
bash
# GPU 去噪
glsl-shader=~/.config/mpv/shaders/adaptive-sharpen.glsl
# GPU 锐化
glsl-shader=~/.config/mpv/shaders/FSRCNNX_x2_16-0-4-1.glsl视频输出控制
窗口控制
bash
# 窗口大小
geometry=1280x720
# 窗口位置
geometry=100:100
# 窗口大小和位置
geometry=1280x720+100+100
# 百分比大小
geometry=50%x50%全屏控制
bash
# 全屏
fullscreen=yes
# 全屏显示器
fs-screen=0
# 无边框全屏
border=no视频性能
帧率控制
bash
# 显示帧率
video-sync=display-resample
# 帧率限制
video-sync=display-tempo
# 禁用帧率同步
video-sync=audio渲染优化
bash
# 减少渲染延迟
video-latency-hacks=yes
# 禁用垂直同步
opengl-swapinterval=0
# 使用多线程
vd-lavc-threads=0视频调试
调试信息
bash
# 显示视频信息
mpv --msg-level=all=v video.mp4
# 显示性能统计
mpv --stats video.mp4
# 显示帧信息
mpv --framedrop=decoder video.mp4视频测试
bash
# 测试视频输出
mpv --vo=gpu --hwdec=auto video.mp4
# 测试视频质量
mpv --profile=gpu-hq video.mp4