mpv - Online sa Cloud

PROGRAMA:

NAME

mpv - isang media player

SINOPSIS

mpv [mga opsyon] [file|URL|PLAYLIST|-]
mpv [mga opsyon] na file

DESCRIPTION

mpv ay isang media player batay sa MPlayer at mplayer2. Sinusuportahan nito ang maraming uri ng video
mga format ng file, audio at video codec, at mga uri ng subtitle. Ang mga espesyal na uri ng URL ng input ay
magagamit upang basahin ang input mula sa iba't ibang mga mapagkukunan maliban sa mga file sa disk. Depende sa
platform, sinusuportahan ang iba't ibang paraan ng paglabas ng video at audio.

Ang mga halimbawa ng paggamit para mabilis kang makapagsimula ay makikita sa dulo ng man page na ito.

INTERAKTIBONG Kontrol

Ang mpv ay may ganap na nako-configure, command-driven na control layer na nagbibigay-daan sa iyong kontrolin ang mpv
gamit ang keyboard, mouse, o remote control (walang suporta sa LIRC - i-configure ang mga remote bilang
input device sa halip).

Tingnan ang --input- mga opsyon para sa mga paraan upang i-customize ito.

Keyboard Kontrolin
Kaliwa at KARAPATAN
Humanap ng paatras/pasulong ng 5 segundo. Ang Shift+arrow ay 1 segundong eksaktong naghahanap (tingnan
--hr-hanapin).

UP at DOWN
Humanap/paatras ng 1 minuto. Ang Shift+arrow ay 5 segundong eksaktong naghahanap (tingnan
--hr-hanapin).

Ctrl+LEFT at Ctrl+RIGHT
Humanap sa nakaraan/susunod na subtitle. Napapailalim sa ilang mga paghihigpit at maaaring hindi gumana
palagi; tingnan mo sub_seek utos.

[ at ]
Bawasan/taasan ang kasalukuyang bilis ng pag-playback ng 10%.

{ at }
Halve/doble ang kasalukuyang bilis ng pag-playback.

BACKSPACE
I-reset sa normal ang bilis ng pag-playback.

< at >
Paatras/pasulong sa playlist.

ENTER Sumulong sa playlist.

p / Puwang
I-pause (pindutin muli unpause).

. Hakbang pasulong. Ang pagpindot ng isang beses ay magpo-pause, bawat magkakasunod na pagpindot ay magpe-play ng isang frame
at pagkatapos ay pumunta sa pause mode muli.

, Hakbang paatras. Ang pagpindot ng isang beses ay magpo-pause, bawat magkakasunod na pagpindot ay magpe-play ng isa
frame sa reverse at pagkatapos ay pumunta sa pause mode muli.

q Tumigil sa paglalaro at huminto.

Q katulad q, ngunit iimbak ang kasalukuyang posisyon ng pag-playback. Ang pag-play ng parehong file sa ibang pagkakataon ay
ipagpatuloy sa lumang posisyon ng playback kung maaari.

/ at *
Bawasan/taasan ang volume.

9 at 0
Bawasan/taasan ang volume.

m I-mute ang tunog.

_ Umikot sa mga magagamit na video track.

# Umikot sa mga magagamit na audio track.

f I-toggle ang fullscreen (tingnan din --fs).

ESC Lumabas sa fullscreen mode.

T I-toggle ang stay-on-top (tingnan din --sa taas).

w at e
Bawasan/taasan ang hanay ng pan-and-scan.

o (din P)
Ipakita ang progression bar, lumipas na oras at kabuuang tagal sa OSD.

O I-toggle ang mga estado ng OSD sa pagitan ng normal at oras/tagal ng pag-playback.

v I-toggle ang visibility ng subtitle.

j at J
Umikot sa mga magagamit na subtitle.

x at z
Ayusin ang pagkaantala ng subtitle ng +/- 0.1 segundo.

l Itakda/i-clear ang mga AB loop point. Tingnan mo ab-loop utos para sa mga detalye.

L I-toggle ang infinite looping.

Ctrl + at Ctrl -
Ayusin ang pagkaantala ng audio nang +/- 0.1 segundo.

u Lumipat sa pagitan ng paglalapat ng walang mga pag-override sa istilo sa mga subtitle ng SSA/ASS, at pag-override
halos ganap ang mga ito gamit ang normal na istilo ng subtitle. Tingnan mo --ass-style-override para
karagdagang impormasyon.

V I-toggle ang subtitle na VSFilter aspect compatibility mode. Tingnan mo
--ass-vsfilter-aspect-compat para sa karagdagang impormasyon.

r at t
Ilipat ang mga subtitle pataas/pababa.

s Kumuha ng screenshot.

S Kumuha ng screenshot, nang walang mga subtitle. (Kung gumagana ito ay depende sa driver ng VO
suporta.)

Ctrl s Kumuha ng screenshot, habang ipinapakita ito ng window (na may mga subtitle, OSD, at naka-scale na video).

I Ipakita ang filename sa OSD.

PGUP at PGDWN
Humanap sa simula ng nakaraan/susunod na kabanata. Sa karamihan ng mga kaso, "nakaraang" kalooban
talagang pumunta sa simula ng kasalukuyang kabanata; tingnan mo --chapter-seek-threshold.

Shift+PGUP at Shift+PGDWN
Humanap ng paatras o pasulong sa loob ng 10 minuto. (Dati itong nakamapa sa PGUP/PGDWN
nang walang Shift.)

d I-activate/i-deactivate ang deinterlacer.

A Pag-override ng aspect ratio ng cycle.

(Ang mga sumusunod na key ay may bisa lamang kapag gumagamit ng isang video output na sumusuporta sa
kaukulang pagsasaayos, o ang software equalizer (--vf=eq).)

1 at 2
Ayusin ang kaibahan.

3 at 4
Ayusin ang ningning.

5 at 6
Ayusin ang gamma.

7 at 8
Ayusin ang saturation.

Alt + 0 (At command+0 on OSX)
Baguhin ang laki ng window ng video sa kalahati ng orihinal na laki nito.

Alt + 1 (At command+1 on OSX)
Baguhin ang laki ng window ng video sa orihinal nitong laki.

Alt + 2 (At command+2 on OSX)
Baguhin ang laki ng window ng video upang doblehin ang orihinal na laki nito.

utos + f (OSX lamang)
I-toggle ang fullscreen (tingnan din --fs).

utos + [ at utos + ] (OSX lamang)
Itakda ang alpha ng window ng video.

(Ang mga sumusunod na key ay wasto kung mayroon kang keyboard na may mga multimedia key.)

PAUSE I-pause.

STOP Tumigil sa paglalaro at huminto.

nAKARAANG at NEXT
Humanap ng paatras/pasulong ng 1 minuto.

(Ang mga sumusunod na key ay may bisa lamang kung nag-compile ka sa TV o DVB input support.)

h at k
Piliin ang nakaraan/susunod na channel.

mouse Kontrolin
butones 3 at butones 4
Humanap ng paatras/pasulong ng 1 minuto.

butones 5 at butones 6
Bawasan/taasan ang volume.

PAGGAMIT

Bawat bandila ang opsyon ay may a walang bandila katapat, hal ang kabaligtaran ng --fs Ang opsyon ay
--hindi-fs. --fs=oo ay katulad ng --fs, --fs=hindi ay pareho --hindi-fs.

Kung ang isang opsyon ay minarkahan bilang (XXX lamang), gagana lang ito kasabay ng XXX opsyon
o kaya XXX ay pinagsama-sama sa.

Nakakatakas mga puwang at iba espesyal character
Tandaan na ang shell ay bahagyang i-parse at guguluhin ang mga argumento na ipapasa mo sa mpv.
Halimbawa, maaaring kailanganin mong mag-quote o mag-escape ng mga opsyon at filename:
mpv "filename sa spaces.mkv" --title="window pamagat"

Ito ay nagiging mas kumplikado kung ang suboption parser ay kasangkot. Inilalagay ng suboption parser
ilang mga opsyon sa isang string, at ipinapasa ang mga ito sa isang bahagi nang sabay-sabay, sa halip na
gamit ang maramihang mga opsyon sa antas ng command line.

Ang suboption parser ay maaaring mag-quote ng mga string na may " at [...]. Bilang karagdagan, mayroong isang espesyal
anyo ng pagsipi sa %n% inilarawan sa ibaba.

Halimbawa, ang openl Maaaring kumuha ang VO ng maraming opsyon:
mpv pagsubok.mkv --vo=opengl:scale=lanczos:icc-profile=file.icc,xv

Ito ay pumasa sukat=lanczos at icc-profile=file.icc sa openl, at tinutukoy din xv as
fallback VO. Kung ang icc-profile path ay naglalaman ng mga puwang o mga character tulad ng , or :, kailangan mo
upang banggitin ang mga ito:
mpv '--vo=opengl:icc-profile="file sa spaces.icc",xv'

Maaaring talagang tanggalin ng mga shell ang ilang mga panipi mula sa string na ipinasa sa commandline, kaya ang
halimbawa ay sinipi ang string ng dalawang beses, tinitiyak na natatanggap ng mpv ang " mga quote

Ang [...] anyo ng mga panipi na bumabalot sa lahat sa pagitan [ at ]. Ito ay kapaki-pakinabang sa mga shell na iyon
huwag bigyang-kahulugan ang mga character na ito sa gitna ng isang argumento (tulad ng bash). Ang mga quotes na ito
ay balanse (mula sa mpv 0.9.0): ang [ at ] pugad, at ang quote ay magtatapos sa huli ]
na walang tugma [ sa loob ng string. (Halimbawa, [a[b]c] mga resulta a[b]c.)

Ang fixed-length na quoting syntax ay inilaan para sa paggamit sa mga panlabas na script at program.

Ito ay nagsimula sa % at may sumusunod na format:

%n%string_of_length_n

Mga halimbawa

mpv --ao=pcm:file=%10%C:test.wav pagsubok.avi

O sa isang script:

mpv --ao=pcm:file=%`expr haba "$NAME"`%"$NAME" pagsubok.avi

Ang mga suboption na ipinasa sa client API ay napapailalim din sa pagtakas. Gamit
mpv_set_option_string() ay eksakto tulad ng pagpasa --name=data sa command line (ngunit
nang walang pagpoproseso ng shell ng string). Sinusuportahan ng ilang opsyon ang pagpasa ng mga halaga sa higit pa
structured na paraan sa halip na mga flat string, at maaaring maiwasan ang suboption parsing gulo. Para sa
Halimbawa, --vf suporta MPV_FORMAT_NODE, na nagbibigay-daan sa iyong ipasa ang mga suboption bilang isang nested data
istraktura ng mga mapa at array. (--vo Sinusuportahan ito sa parehong paraan, kahit na ang katotohanang ito ay
hindi dokumentado.)

Landas
Kailangang mag-ingat kapag nagpapasa ng mga arbitrary na path at filename sa mpv. Halimbawa,
mga landas na nagsisimula sa - ay bibigyang-kahulugan bilang mga opsyon. Gayundin, kung ang isang landas ay naglalaman ng
pagkakasunud-sunod :/ /, ang string bago iyon ay maaaring bigyang-kahulugan bilang protocol prefix, kahit na
:/ / ay maaaring maging bahagi ng isang legal na landas ng UNIX. Upang maiwasan ang mga problema sa mga arbitrary na landas, dapat mong
siguraduhin na ang mga ganap na landas na dumaan sa mpv ay nagsisimula sa /, at mga relatibong landas na may ./.

Ang pangalan - mismo ay binibigyang-kahulugan bilang stdin, at magiging sanhi ng mpv na hindi paganahin ang mga kontrol ng console.
(Na ginagawang angkop para sa paglalaro ng data na naka-pipe sa stdin.)

Para sa mga path na ipinasa sa mga suboption, ang sitwasyon ay mas kumplikado sa pamamagitan ng pangangailangan upang makatakas
mga espesyal na karakter. Upang gawin ito sa paligid, ang landas ay maaaring karagdagang balot sa
fixed-length na syntax, hal %n%string_of_length_n (tingnan sa itaas).

Ang ilang mga opsyon sa mpv ay nagbibigay-kahulugan sa mga landas na nagsisimula sa ~. Sa kasalukuyan, ang prefix ~~/ lumalawak sa
mpv na direktoryo ng pagsasaayos (karaniwan ~/.config/mpv/). ~/ lumalawak sa tahanan ng gumagamit
direktoryo. (Ang trailing / ay palaging kinakailangan.) Mayroon ding mga sumusunod na landas:

┌────────────────────────────────────────┐.
│Pangalan │ Kahulugan │
└────────────────────────────────────────┘.

│~~bahay/ │ katulad ng ~~/ │
├────────────────────────────────────────┤.
│~~global/ │ ang pandaigdigang config path, kung │
│ │ available (wala sa win32) │
├────────────────────────────────────────┤.
│~~osxbundle/ │ ang OSX bundle resource path │
│ │ (OSX lang) │
├────────────────────────────────────────┤.
│~~desktop/ │ ang landas patungo sa desktop (win32, │
│ │ OSX) │
└────────────────────────────────────────┘.

Per-File Options
Kapag nagpe-play ng maramihang mga file, ang anumang opsyon na ibinigay sa command line ay karaniwang nakakaapekto sa lahat
mga file. Halimbawa:

mpv --isang file1.mkv --b file2.mkv --c

┌──────────┬────────────────┐
│File │ Mga aktibong opsyon │
├──────────┼────────────────┤
│file1.mkv │ --a --b --c │
├──────────┼────────────────┤
│file2.mkv │ --a --b --c │
└──────────┴────────────────┘

(Ito ay iba sa MPlayer at mplayer2.)

Gayundin, kung ang anumang opsyon ay binago sa runtime (sa pamamagitan ng mga input command), hindi sila na-reset kapag a
bagong file ang nilalaro.

Minsan, kapaki-pakinabang na baguhin ang mga opsyon sa bawat file. Ito ay maaaring makamit sa pamamagitan ng pagdaragdag ng
espesyal na per-file marker --{ at --}. (Tandaan na dapat mong takasan ang mga ito sa ilang mga shell.)
Halimbawa:

mpv --isang file1.mkv --b --\{ --c file2.mkv --d file3.mkv --e --\} file4.mkv --f

┌──────────┬─────────────────────────
│File │ Mga aktibong opsyon │
├──────────┼─────────────────────────
│file1.mkv │ --a --b --f │
├──────────┼─────────────────────────
│file2.mkv │ --a --b --f --c --d --e │
├──────────┼─────────────────────────
│file3.mkv │ --a --b --f --c --d --e │
├──────────┼─────────────────────────
│file4.mkv │ --a --b --f │
└──────────┴─────────────────────────

Bilang karagdagan, ang anumang file-local na opsyon na binago sa runtime ay ni-reset kapag ang kasalukuyang file
huminto sa paglalaro. Kung opsyon --c ay binago sa panahon ng pag-playback ng file2.mkv, ito ay ni-reset kapag
sumusulong sa file3.mkv. Nakakaapekto lamang ito sa mga opsyon sa file-local. Ang pagpipilian --a ay hindi kailanman
i-reset dito.

Configuration MGA FILE

lugar at palaugnayan
Maaari mong ilagay ang lahat ng mga opsyon sa configuration file na babasahin sa tuwing ang mpv ay
tumakbo. Ang configuration file sa buong system na 'mpv.conf' ay nasa iyong configuration directory
(eg /etc/mpv or /usr/local/etc/mpv), ang partikular sa user ay ~/.config/mpv/mpv.conf.
Para sa mga detalye at partikular na platform (sa partikular na mga landas ng Windows) tingnan ang MGA FILE seksyon.

I-override ng mga opsyong partikular sa user ang mga opsyon at opsyon sa buong system na ibinigay sa command line
override alinman. Ang syntax ng mga configuration file ay opsyon=halaga. Lahat pagkatapos ng a
# ay itinuturing na isang komento. Maaaring paganahin ang mga opsyon na gumagana nang walang mga halaga sa pamamagitan ng pagtatakda ng mga ito
sa oo at hindi pinagana sa pamamagitan ng pagtatakda ng mga ito sa hindi. Kahit na ang mga suboption ay maaaring tukuyin sa ganitong paraan.

Halimbawa ng configuration file

# Gumamit ng openl video output bilang default.
vo=opengl
# Gumamit ng mga panipi para sa teksto na maaaring maglaman ng mga puwang:
status-msg="Oras: ${time-pos}"

Nakakatakas mga puwang at espesyal character
Ginagawa ito tulad ng sa mga pagpipilian sa command line. Ang shell ay hindi kasangkot dito, ngunit opsyon
kailangan pa ring sipiin ang mga value bilang kabuuan kung naglalaman ito ng ilang partikular na character tulad ng mga puwang. A
config entry ay maaaring ma-quote sa ", pati na rin sa fixed-length syntax (%n%) nabanggit
dati. Ito ay tulad ng pagpasa sa eksaktong mga nilalaman ng naka-quote na string bilang command line
opsyon. Ang mga C-style na pagtakas ay kasalukuyang _hindi_ binibigyang-kahulugan sa antas na ito, bagama't ang ilan
gawin ito nang manu-mano. (Ito ay isang gulo at marahil ay dapat baguhin sa ilang mga punto.)

Paglalagay Utos Linya Options sa ang Configuration talaksan
Halos lahat ng mga opsyon sa command line ay maaaring ilagay sa configuration file. Narito ang isang maliit
gabay:

.
│Pagpipilian │ Pagpasok ng file ng configuration │
.
│--bandila │ bandila │
.
│-optino Val │ opt=val │
.
│--opt=val │ opt=val │
.
│-optino "may mga espasyo" │ opt="may mga espasyo" │
.

Partikular sa file Configuration File
Maaari ka ring magsulat ng mga file-specific na configuration file. Kung gusto mong magkaroon ng configuration
file para sa isang file na tinatawag na 'video.avi', lumikha ng isang file na may pangalang 'video.avi.conf' gamit ang
mga opsyon na partikular sa file dito at ilagay ito ~/.config/mpv/. Maaari mo ring ilagay ang
configuration file sa parehong direktoryo ng file na ipe-play. Parehong kailangan mong itakda
ang --use-filedir-conf opsyon (alinman sa command line o sa iyong global config file).
Kung ang isang file-specific na configuration file ay matatagpuan sa parehong direktoryo, walang file-specific
ang configuration ay na-load mula sa ~/.config/mpv. Bilang karagdagan, ang --use-filedir-conf opsyon
nagbibigay-daan sa mga file ng pagsasaayos na tukoy sa direktoryo. Para dito, sinubukan muna ng mpv na mag-load ng a
mpv.conf mula sa parehong direktoryo kung saan nilalaro ang file at pagkatapos ay susubukang mag-load ng anuman
configuration na tukoy sa file.

Profile
Para mapadali ang pagtatrabaho sa iba't ibang configuration, maaaring tukuyin ang mga profile sa
configuration file. Nagsisimula ang isang profile sa pangalan nito sa mga square bracket, hal [aking profile].
Ang lahat ng sumusunod na opsyon ay magiging bahagi ng profile. Isang paglalarawan (ipinakita ni --profile=help)
maaaring tukuyin gamit ang profile-desc opsyon. Upang tapusin ang profile, magsimula ng isa pa o gumamit
ang pangalan ng profile default upang magpatuloy sa mga normal na opsyon.

Halimbawa ng mpv config file na may mga profile

# normal na top-level na opsyon
fullscreen=oo

# isang profile na maaaring paganahin sa --profile=big-cache
[malaking cache]
cache=123400
demuxer-readahead-secs=20

[mabagal]
profile-desc="some profile name"
vo=opengl:scale=ewa_lanczos:scale-radius=16

[mabilis]
vo=vdpau

Ang # gamit ang isang profile ay muling nagpapalawak nito
[mabagal]
framedrop=hindi
# maaari mo ring isama ang iba pang mga profile
profile=malaki-cache

Auto profile
Ang ilang mga profile ay awtomatikong na-load. Ang sumusunod na halimbawa ay nagpapakita nito:

Awtomatikong paglo-load ng profile

[vo.vdpau]
# Gumamit ng hardware decoding
hwdec=vdpau

[protocol.dvd]
profile-desc="profile para sa dvd:// stream"
alang=en

[extension.flv]
profile-desc="profile para sa .flv file"
vf=flip

[ao.alsa]
device=spdif

Ang pangalan ng profile ay sumusunod sa schema uri.pangalan, kung saan ang uri ay maaaring vo upang tumugma sa halaga ng
--vo ang opsyon ay nakatakda sa, ao para --ao, protokol para sa input/output protocol na ginagamit (tingnan
--list-protocols), At karugtong para sa pagpapalawig ng landas ng kasalukuyang nilalaro
file (hindi ang format ng file).

Ang feature na ito ay napakalimitado, at walang ibang mga auto profile.

PAGKUHA MGA LALAKI

Maaaring kunin ang mga screenshot ng kasalukuyang nilalaro na file gamit ang 'screenshot' input mode
command, na bilang default ay nakatali sa s susi. Mga file na pinangalanan shotNNNN.jpg ay maliligtas sa
ang gumaganang direktoryo, gamit ang unang magagamit na numero - walang mga file na mapapatungan.

Ang isang screenshot ay karaniwang naglalaman ng mga hindi naka-scale na nilalaman ng video sa dulo ng video
filter chain at mga subtitle. Bilang default, S kumukuha ng mga screenshot nang walang subtitle, habang s
may kasamang mga subtitle.

Hindi tulad ng sa MPlayer, ang screenshot video filter ay hindi kinakailangan. Ang filter na ito ay hindi kailanman
kinakailangan sa mpv, at naalis na.

TERMINAL STATUS LINE

Sa panahon ng pag-playback, ipinapakita ng mpv ang status ng playback sa terminal. Parang may something
ganito:
NG: 00:03:12 / 00:24:25 (13%) AV: -0.000

Ang linya ng katayuan ay maaaring ma-override ng --term-status-msg pagpipilian.

Ang sumusunod ay isang listahan ng mga bagay na maaaring lumabas sa linya ng katayuan. Mga katangian ng input,
na maaaring magamit upang makuha ang parehong impormasyon nang manu-mano, ay nakalista din.

· NG: or V: (video lang) o A: (audio lang)

· Ang kasalukuyang posisyon ng oras sa HH: MM: SS format (oras ng pag-playback ari-arian)

· Ang kabuuang tagal ng file (wala kung hindi alam) (haba ari-arian)

· Bilis ng pag-playback, hal. `` x2.0``. Makikita lamang kung ang bilis ay hindi normal. Ito ang
bilis na hiniling ng user, at hindi ang aktwal na bilis (karaniwan ay pareho sila, maliban kung
masyadong mabagal ang playback). (pabilisin ari-arian.)

· Porsyento ng pag-playback, hal (13%). Gaano karami ng file ang na-play. Karaniwan
kinakalkula mula sa posisyon at tagal ng pag-playback, ngunit maaaring mag-fallback sa ibang mga pamamaraan
(tulad ng posisyon ng byte) kung hindi available ang mga ito. (porsyento-pos ari-arian.)

· Ang pag-sync ng audio/video bilang AV: 0.000. Ito ang pagkakaiba sa pagitan ng audio at video
oras. Karaniwan dapat itong 0 o malapit sa 0. Kung ito ay lumalaki, maaari itong magpahiwatig ng a
problema sa pag-playback. (avsync ari-arian.)

· Kabuuang pagbabago sa pag-sync ng A/V, hal CT: -0.417. Karaniwang hindi nakikita. Maaaring magpakita kung mayroon
audio "nawawala", o hindi sapat na mga frame ang maaaring i-drop. Kadalasan ito ay magsasaad ng a
problema. (kabuuang-avsync-pagbabago ari-arian.)

· Encoding state in {...}, ipinapakita lang sa encoding mode.

· Ipakita ang estado ng pag-sync. Kung aktibo ang display sync (display-sync-active ari-arian), ipinapakita nito
DS: 2.500/13, kung saan ang unang numero ay average na bilang ng mga vsync sa bawat video frame (hal
2.5 kapag nagpe-play ng mga 24Hz na video sa 60Hz na mga screen), na maaaring mag-jitter kung ang ratio ay hindi
round off, o may mga mistimed frames (vsync-ratio), at ang pangalawang bilang ng
tinantyang bilang ng mga vsync na masyadong nagtagal (vo-delayed-frame-count ari-arian). Ang
ang huli ay isang heuristic, dahil sa pangkalahatan ay hindi posible na matukoy ito nang may katiyakan.

· Nahulog na mga frame, hal Nahulog: 4. Lumalabas lamang kung ang bilang ay hindi 0. Maaaring lumaki kung ang
ang video framerate ay mas mataas kaysa sa display, o kung masyadong mabagal ang pag-render ng video.
Maaari ding dagdagan sa "mga hiccups" at kapag ang video frame ay hindi maipakita sa
oras. (vo-drop-frame-count property.) Kung ang decoder ay bumaba ng mga frame, ang bilang ng
Ang mga decoder-drop na frame ay idinagdag din sa display, hal: Nahulog: 4/34. ito
nangyayari lamang kung ang pag-drop ng frame ng decoder ay pinagana gamit ang --framedrop mga pagpipilian.
(drop-frame-count ari-arian.)

· Katayuan ng cache, hal cache: 2s+134KB. Makikita kung pinagana ang stream cache. Ang una
ipinapakita ng value ang dami ng video na na-buffer sa demuxer sa mga segundo, ang pangalawang value
Ipinapakita ng karagdagan na-buffer ang data sa stream cache sa kilobytes. (demuxer-cache-tagal
at ginagamit ng cache ari-arian.)

PROTOCOLS

http://..., https://, ...
Maraming network protocol ang sinusuportahan, ngunit ang protocol prefix ay dapat palaging
tinukoy. Hindi kailanman susubukan ng mpv na hulaan kung ang isang filename ay talagang isang network
tirahan. Ang isang protocol prefix ay palaging kinakailangan.

Tandaan na hindi lahat ng prefix ay nakadokumento dito. Ang mga undocumented prefix ay alinman
mga alias sa mga nakadokumentong protocol, o mga pag-redirect lang sa mga protocol na ipinatupad
at dokumentado sa FFmpeg.

- I-play ang data mula sa stdin.

smb://PATH
Maglaro ng landas mula sa Samba share.

bd://[title][/device] --bluray-device=PATH
Magpatugtog ng Blu-Ray disc. Sa kasalukuyan, hindi ito tumatanggap ng mga ISO file. Sa halip, dapat
i-mount ang ISO file bilang filesystem, at ituro --bluray-device sa naka-mount
direktang direktoryo.

dvd://[title|[starttitle]-endtitle][/device] --dvd-device=PATH
Magpatugtog ng DVD. Hindi sinusuportahan ang mga DVD menu. Kung walang ibibigay na titulo, ang pinakamahabang titulo ay
awtomatikong napili.

dvdnav:// ay isang lumang alyas para sa dvd:// at ginagawa ang parehong bagay.

dvdread://...:
Magpatugtog ng DVD gamit ang lumang libdvdread code. Ito ang ginagawa ng MPlayer at mas lumang mpv
ginagamit ng mga bersyon para sa dvd://. Ang paggamit ay hindi hinihikayat. Ito ay ibinigay lamang para sa pagiging tugma
at para sa paglipat.

tv://[channel][/input_id] --tv-...
Analogue TV sa pamamagitan ng V4L. Kapaki-pakinabang din para sa mga webcam. (Linux lang.)

pvr:// --pvr-...
PVR. (Linux lang.)

dvb://[cardnumber@]channel --dvbin-...
Digital TV sa pamamagitan ng DVB. (Linux lang.)

mf://[filemask|@listfile] --mf-...
Mag-play ng serye ng mga larawan bilang video.

cdda://track[-endtrack][:speed][/device] --cdrom-device=PATH --cdda-...
Magpatugtog ng CD.

lavf://...
I-access ang anumang FFmpeg/Libav libavformat protocol. Talaga, pumasa ito sa string
pagkatapos ng // direkta sa libavformat.

av://type:options
Ito ay inilaan para sa paggamit ng libavdevice input. uri ay ang libavdevice demuxer
pangalan, at pagpipilian ay ang (pseudo-)filename na ipinasa sa demuxer.

Halimbawa, mpv av://lavfi:mandelbrot gumagamit ng libavfilter wrapper
kasama sa libavdevice, at gagamitin ang mandelbrot source filter upang bumuo
input ng data.

avdevice:// ay isang alyas.

file://PATH
Isang lokal na landas bilang URL. Maaaring maging kapaki-pakinabang sa ilang mga espesyal na kaso ng paggamit. Tandaan na PATH
mismo ay dapat magsimula sa isang pangatlo / upang gawing ganap na landas ang landas.

fd://123
Basahin ang data mula sa ibinigay na UNIX FD (halimbawa 123). Ito ay katulad ng piping data
sa stdin sa pamamagitan ng -, ngunit maaaring gumamit ng arbitrary na file descriptor. Hindi gagana ng tama
sa MS Windows.

edl://[edl detalye as in edl-mpv.rst]
Pagsama-samahin ang mga bahagi ng maraming file at i-play ang mga ito.

wala://
Gayahin ang isang walang laman na file.

memory://data
Gamitin ang data bahagi bilang pinagmumulan ng datos.

PSEUDO GUI MODE

Ang mpv ay walang opisyal na GUI, maliban sa OSC (ON SCREEN Controller), na hindi isang buo
GUI at hindi nilalayong maging. Gayunpaman, upang mabayaran ang kakulangan ng inaasahang pag-uugali ng GUI,
Ang mpv ay magsisimula sa ilang mga kaso sa ilang mga setting na binago upang kumilos nang bahagya na parang isang GUI
mode.

Sa kasalukuyan, ito ay nangyayari lamang sa mga sumusunod na kaso:

· kung nagsimulang gamitin ang mpv.desktop file sa Linux (hal. nagsimula sa mga menu o file
mga asosasyon na ibinigay ng mga desktop environment)

· kung nagsimula sa explorer.exe sa Windows (teknikal, kung nagsimula ito sa Windows, at
lahat ng stdout/stderr/stdin handle ay hindi nakatakda)

· mano-manong pagdaragdag --profile=pseudo-gui sa command line

Ang mode na ito ay tahasang nagdaragdag --profile=pseudo-gui sa command line, kasama ang pseudo-gui
profile na paunang natukoy na may mga sumusunod na nilalaman:

[pseudo-gui]
terminal=hindi
force-window=oo
idle=minsan
screenshot-directory=~~desktop/

Ito ay sumusunod sa mpv config file format. Upang i-customize ang pseudo-GUI mode, maaari mong ilagay ang iyong
sarili pseudo-gui profile sa iyong mpv.conf. Ang profile na ito ay magpapahusay sa default na profile,
sa halip na i-overwrite ito.

Palaging ino-override ng profile ang iba pang mga setting sa mpv.conf.

Opsyon

Subaybayan Pagpili
--alang=
Tumukoy ng listahan ng priyoridad ng mga wikang audio na gagamitin. Iba't ibang mga format ng lalagyan
gumamit ng iba't ibang mga code ng wika. Gumagamit ang mga DVD ng ISO 639-1 na dalawang titik na mga code ng wika,
Gumagamit ang Matroska, MPEG-TS at NUT ng ISO 639-2 na tatlong titik na mga code ng wika, habang gumagamit ang OGM
isang free-form na identifier. Tingnan din --tulong.

Mga halimbawa

mpv dvd://1 --alang=hu,en
Pinipili ang track ng wikang Hungarian sa isang DVD at bumabalik sa Ingles
kung hindi available ang Hungarian.

mpv --alang=jpn halimbawa.mkv
Nagpe-play ng Matroska file sa Japanese.

--slang=
Tumukoy ng listahan ng priyoridad ng mga wikang subtitle na gagamitin. Iba't ibang mga format ng lalagyan
gumamit ng iba't ibang mga code ng wika. Gumagamit ang mga DVD ng ISO 639-1 na dalawang titik na code ng wika,
Gumagamit si Matroska ng ISO 639-2 na tatlong titik na mga code ng wika habang ang OGM ay gumagamit ng isang free-form
identifier. Tingnan din --sid.

Mga halimbawa

· mpv dvd://1 --slang=hu,en pinipili ang Hungarian subtitle track sa isang DVD at
bumabalik sa English kung hindi available ang Hungarian.

· mpv --slang=jpn halimbawa.mkv gumaganap ng Matroska file na may mga Japanese subtitle.

--tulong=
Pumili ng audio track. kotse pinipili ang default, hindi hindi pinapagana ang audio. Tingnan din --alang.
Ang mpv ay karaniwang nagpi-print ng mga available na audio track sa terminal kapag sinisimulan ang pag-playback
ng isang file.

--sid=
Ipakita ang subtitle stream na tinukoy ni . kotse pinipili ang default, hindi
hindi pinapagana ang mga subtitle.

Tingnan din --balbal, --walang-sub.

--vid=
Pumili ng channel ng video. kotse pinipili ang default, hindi hindi pinapagana ang video.

--ff-aid= , --ff-sid= , --ff-vid=
Pumili ng mga audio/subtitle/video stream ayon sa FFmpeg stream index. Ang FFmpeg stream
index ay medyo arbitrary, ngunit kapaki-pakinabang kapag nakikipag-ugnayan sa ibang software
gamit ang FFmpeg (isaalang-alang ffprobe).

Tandaan na may mga panlabas na track (idinagdag sa --sub-file at mga katulad na opsyon), doon
ay magiging mga stream na may mga duplicate na ID. Sa kasong ito, ang unang stream sa pagkakasunud-sunod ay
Napili.

--edisyon=
(Matroska file lang) Tukuyin ang edisyon (set ng mga kabanata) na gagamitin, kung saan 0 ang
una. Kung nakatakda sa kotse (ang default), pipiliin ng mpv ang unang edisyon na idineklara bilang
isang default, o kung walang default, tinukoy ang unang edisyon.

Pag-playback Kontrolin
--simula = oras>
Humanap sa ibinigay na posisyon sa oras.

Ang pangkalahatang format para sa mga ganap na oras ay [[hh:]mm:]ss[.ms]. Kung bibigyan ng oras
na may prefix ng + or -, ang paghahanap ay kamag-anak mula sa simula o dulo ng file.
(Dahil mpv 0.14, ang simula ng file ay palaging itinuturing na 0.)

pp% naghahanap ng porsyentong posisyon pp (0-100).

#c naghahanap ng numero ng kabanata c. (Magsisimula ang mga kabanata sa 1.)

Mga halimbawa

--start=+56, --start=+00:56
Hinahanap ang oras ng pagsisimula + 56 segundo.

--start=-56, --start=-00:56
Naghahanap hanggang sa oras ng pagtatapos - 56 segundo.

--start=01:10:00
Naghahanap ng 1 oras 10 min.

--start=50%
Hinahanap sa gitna ng file.

--start=30 --end=40
Naghahangad ng 30 segundo, nagpe-play ng 10 segundo, at lalabas.

--start=-3:20 --haba=10
Naghahangad ng 3 minuto at 20 segundo bago matapos ang file, nagpe-play ng 10
segundo, at paglabas.

--start='#2' --end='#4'
Nagpe-play ang kabanata 2 at 3, at lalabas.

--end=
Huminto sa ibinigay na ganap na oras. Gamitin --haba kung ang oras ay dapat na may kaugnayan sa
--simula. Tingnan --simula para sa mga wastong halaga ng opsyon at mga halimbawa.

--haba= oras>
Huminto pagkatapos ng ibinigay na oras na may kaugnayan sa oras ng pagsisimula. Tingnan mo --simula para sa wastong opsyon
mga halaga at halimbawa.

--rebase-start-time=
Kung ililipat ang oras ng pagsisimula ng file sa 00:00:00 (default: oo). Ito ay mas mababa
awkward para sa mga file na nagsisimula sa isang random na timestamp, gaya ng mga transport stream. Naka-on
sa kabilang banda, kung mayroong mga pag-reset ng timestamp, ang resulta ay maaaring maging sa halip
kakaiba. Para sa kadahilanang ito, at kung sakaling interesado ka sa totoo
timestamp, maaaring hindi paganahin ang gawi na ito hindi.

--bilis=<0.01-100>
Pabagalin o pabilisin ang pag-playback sa pamamagitan ng salik na ibinigay bilang parameter.

If --audio-pitch-correction (naka-on bilang default) ay ginagamit, naglalaro nang mas mataas ang bilis
kaysa sa normal ay awtomatikong ipinapasok ang scaletempo filter ng audio.

--loop=
Nag-loop ng playback N beses. Isang halaga ng 1 nilalaro ito ng isang beses (default), 2 dalawang beses, atbp.
inf ibig sabihin ay magpakailanman. hindi ay pareho 1 at hindi pinapagana ang pag-loop. Kung ang ilang mga file ay
tinukoy sa command line, ang buong playlist ay naka-loop.

Ang pilitin mode ay tulad ng inf, ngunit hindi nilalaktawan ang mga entry sa playlist na naging
minarkahan bilang nabigo. Nangangahulugan ito na ang manlalaro ay maaaring mag-aksaya ng oras ng CPU sa pagsubok na mag-loop ng isang file
wala yan. Ngunit maaari itong maging kapaki-pakinabang para sa paglalaro ng mga webradio sa ilalim ng napakasama
kundisyon ng network.

--pause
Simulan ang player sa naka-pause na estado.

--shuffle
I-play ang mga file sa random na pagkakasunud-sunod.

--kabanata=
Tukuyin kung saang kabanata magsisimulang maglaro. Opsyonal na tukuyin kung aling kabanata ang magtatapos
naglalaro sa. Tingnan din --simula.

--playlist-pos=
Itakda kung aling file sa panloob na playlist ang sisimulan ng pag-playback. Ang index ay isang
integer, na may 0 ibig sabihin ang unang file. Ang halaga hindi nangangahulugan na ang pagpili ng
ang entry upang i-play ay naiwan sa playback resume mechanism (default). Kung isang entry
sa ibinigay na index ay hindi umiiral, ang pag-uugali ay hindi natukoy at maaaring magbago
hinaharap na mga bersyon ng mpv. Ang parehong naaangkop kung ang playlist ay naglalaman ng karagdagang mga playlist
(huwag umasa ng anumang makatwirang pag-uugali). Ang pagpasa ng playlist file sa mpv ay dapat gumana
sa pagpipiliang ito, bagaman. Hal mpv playlist.m3u --playlist-pos=123 gagana bilang
inaasahan, basta playlist.m3u hindi nagli-link sa higit pang mga playlist.

--playlist=
Mag-play ng mga file ayon sa isang playlist file (Sinusuportahan ang ilang karaniwang mga format. Kung walang format
ay nakita, ito ay ituturing bilang listahan ng mga file, na pinaghihiwalay ng mga newline na character.
Tandaan na hindi sinusuportahan ang mga format ng XML playlist.)

Maaari kang direktang maglaro ng mga playlist at nang wala ang opsyong ito, gayunpaman, ang opsyong ito
hindi pinapagana ang anumang mekanismo ng seguridad na maaaring nasa lugar. Maaaring kailanganin mo rin ito
opsyon upang i-load ang mga plaintext na file bilang playlist.

BABALA:
Ang paraan ng mpv ay gumagamit ng mga file ng playlist sa pamamagitan ng --playlist ay hindi ligtas laban sa malisyosong
mga nabuong file. Ang mga nasabing file ay maaaring mag-trigger ng mga mapaminsalang aksyon. Ito ang naging
kaso para sa lahat ng mpv at MPlayer na bersyon, ngunit sa kasamaang-palad ang katotohanang ito ay hindi maayos
naidokumento nang mas maaga, at ang ilang mga tao ay nagrekomenda pa nga sa maling paraan ng paggamit ng
--playlist na may hindi pinagkakatiwalaang mga mapagkukunan. Huwag gamitin --playlist na may random na internet
mga mapagkukunan o mga file na hindi mo pinagkakatiwalaan!

Maaaring maglaman ang playlist ng mga entry gamit ang iba pang mga protocol, gaya ng mga lokal na file, o
(pinaka malubha), mga espesyal na protocol tulad ng avdevice://, na likas
hindi ligtas.

--chapter-merge-threshold=
Threshold para sa pagsasama-sama ng halos magkakasunod na mga bahagi ng kabanata sa millisecond
(default: 100). Ang ilang mga Matroska file na may mga nakaayos na kabanata ay may hindi tumpak na kabanata
pagtatapos ng mga timestamp, na nagdudulot ng maliit na agwat sa pagitan ng pagtatapos ng isang kabanata at simula ng
ang susunod kung kailan sila dapat magkatugma. Kung ang dulo ng isang bahagi ng playback ay mas mababa sa
ang ibinigay na threshold mula sa simula ng susunod at pagkatapos ay patuloy na mag-play ng video
karaniwan sa pagbabago ng kabanata sa halip na maghanap.

--chapter-seek-threshold=
Distansya sa mga segundo mula sa simula ng isang kabanata kung saan ang isang pabalik na kabanata
mapupunta ang seek sa nakaraang kabanata (default: 5.0). Lampas sa threshold na ito, a
Ang backward chapter seek ay mapupunta sa simula ng kasalukuyang kabanata sa halip. A
ang ibig sabihin ng negatibong halaga ay palaging bumalik sa nakaraang kabanata.

--hr-seek=
Piliin kung kailan gagamit ng mga tumpak na paghahanap na hindi limitado sa mga keyframe. Ang mga ganyang hinahanap
nangangailangan ng pag-decode ng video mula sa nakaraang keyframe hanggang sa target na posisyon at iba pa
maaaring tumagal ng ilang oras depende sa pagganap ng pag-decode. Para sa ilang format ng video,
hindi pinagana ang mga tumpak na paghahanap. Pinipili ng opsyong ito ang default na pagpipiliang gagamitin
naghahanap; posibleng tahasang i-override ang default na iyon sa kahulugan ng key
bindings at nasa slave mode na mga utos.

hindi Huwag gumamit ng tumpak na paghahanap.

hindi mapag-aalinlanganan
Gumamit ng tumpak na paghahanap kung ang paghahanap ay nasa isang ganap na posisyon sa file, tulad
bilang isang chapter seek, ngunit hindi para sa relative seeks tulad ng default na pag-uugali ng
mga arrow key (default).

oo Gumamit ng tumpak na paghahanap hangga't maaari.

palagi Katulad ng oo (para sa pagkakatugma).

--hr-seek-demuxer-offset=
Ang pagpipiliang ito ay umiiral upang malutas ang mga pagkabigo na gumawa ng mga tumpak na paghahanap (tulad ng sa --hr-hanapin)
sanhi ng mga bug o limitasyon sa mga demuxer para sa ilang mga format ng file. Ang ilang mga demuxer
mabigong maghanap sa isang keyframe bago ang ibinigay na target na posisyon, papunta sa ibang pagkakataon
posisyon sa halip. Ang halaga ng opsyong ito ay ibinabawas sa time stamp na ibinigay
sa demuxer. Kaya, kung itinakda mo ang pagpipiliang ito sa 1.5 at subukang gumawa ng isang tumpak na hanapin
60 segundo, sinabihan ang demuxer na hanapin ang oras na 58.5, na sana ay mabawasan ang
pagkakataon na ito ay maling napupunta sa ilang oras pagkalipas ng 60 segundo. Ang downside ng
Ang pagtatakda ng pagpipiliang ito ay ang mga tumpak na paghahanap ay nagiging mas mabagal, dahil ang video sa pagitan ng
mas naunang demuxer na posisyon at ang tunay na target ay maaaring hindi kinakailangang ma-decode.

--hr-seek-framedrop=
Payagan ang video decoder na mag-drop ng mga frame habang naghahanap, kung ang mga frame na ito ay bago ang
maghanap ng target. Kung ito ay pinagana, ang tumpak na paghahanap ay maaaring maging mas mabilis, ngunit kung ikaw ay gumagamit
mga filter ng video na nagbabago ng mga timestamp o nagdaragdag ng mga bagong frame, maaari itong humantong sa tumpak
naghahanap ng paglaktaw sa target na frame. Ang halimbawang ito ay maaaring masira ang frame backstepping kapag
naka-enable ang deinterlacing.

Default: oo

--index=
Kinokontrol kung paano maghanap sa mga file. Tandaan na kung ang index ay nawawala mula sa isang file, ito
ay binuo sa mabilisang bilang default, kaya hindi mo kailangang baguhin ito. Ngunit maaaring
tumulong sa ilang sirang file.

default
gumamit ng index kung ang file ay may isa, o buuin ito kung nawawala

muling likhain
huwag basahin o gamitin ang index ng file

TANDAAN:
Gumagana lang ang opsyong ito kung sinusuportahan ng pinagbabatayan ng media ang paghahanap (ibig sabihin, hindi sa
stdin, tubo, atbp).

--load-unsafe-playlists
Mag-load ng mga URL mula sa mga playlist na itinuturing na hindi ligtas (default: hindi). Kabilang dito ang
mga espesyal na protocol at anumang bagay na hindi tumutukoy sa mga normal na file. Mga lokal na file at
Ang mga HTTP link sa kabilang banda ay palaging itinuturing na ligtas.

Tandaan na ang --playlist palaging naglo-load ng lahat ng mga entry, kaya gamitin mo iyon sa halip kung ikaw
talagang may pangangailangan para sa pagpapaandar na ito.

--loop-file=
I-loop ang isang file nang N beses. inf ibig sabihin ay magpakailanman, hindi nangangahulugang normal na pag-playback. Para sa
pagiging tugma, --loop-file at --loop-file=oo tinatanggap din, at pareho
as --loop-file=inf.

Ang pagkakaiba sa --loop ay hindi ito umiikot sa playlist, ang file lang
mismo. Kung ang playlist ay naglalaman lamang ng isang file, ang pagkakaiba sa pagitan ng dalawa
Ang opsyon ay ang opsyong ito ay nagsasagawa ng seek on loop, sa halip na i-reload ang file.

--ab-loop-a= , --ab-loop-b=
Itakda ang mga loop point. Kung ang playback ay pumasa sa b timestamp, hahanapin nito ang a
timestamp. Naghahanap ng lampas sa b point ay hindi loop (ito ay sinadya). Ang
ang mga loop-point ay maaaring iakma sa runtime na may kaukulang mga katangian. Tingnan din
ab_loop utos.

--nakaayos-kabanata, --walang-utos-kabanata
Pinagana bilang default. Huwag paganahin ang suporta para sa mga kabanata na iniutos ng Matroska. hindi gagawin ng mpv
mag-load o maghanap ng mga segment ng video mula sa iba pang mga file, at babalewalain din ang anuman
pagkakasunud-sunod ng kabanata na tinukoy para sa pangunahing file.

--ordered-chapters-files=
Nilo-load ang ibinigay na file bilang playlist, at sinusubukang gamitin ang mga file na nakapaloob dito bilang
mga reference na file kapag binubuksan ang isang Matroska file na gumagamit ng mga nakaayos na kabanata. Ito
Ino-override ang normal na mekanismo para sa paglo-load ng mga reference na file sa pamamagitan ng pag-scan ng pareho
direktoryo kung saan matatagpuan ang pangunahing file.

Kapaki-pakinabang para sa pag-load ng mga order na mga file ng kabanata na hindi matatagpuan sa lokal
filesystem, o kung ang mga reference na file ay nasa iba't ibang direktoryo.

Tandaan: ang isang playlist ay maaaring kasing simple ng isang text file na naglalaman ng mga filename na pinaghihiwalay ng
mga bagong linya.

--chapters-file=
Mag-load ng mga kabanata mula sa file na ito, sa halip na gamitin ang metadata ng kabanata na makikita sa
pangunahing file.

--step=
Laktawan segundo pagkatapos ng bawat frame.

TANDAAN:
Wala --hr-hanapin, ang paglaktaw ay mapupunta sa mga keyframe.

--stop-playback-on-init-failure=
Ihinto ang pag-playback kung ang alinman sa audio o video ay hindi masimulan. Sa kasalukuyan, ang default
pag-uugali ay hindi para sa command line player, ngunit oo para sa libmpv. Sa hindi, pag-playback
magpapatuloy sa video-only o audio-only na mode kung nabigo ang isa sa mga ito. Ito ay hindi
makakaapekto sa pag-playback ng mga audio-only o video-only na mga file.

Programa Pag-uugali
- Tumulong Ipakita ang maikling buod ng mga opsyon.

-v Dagdagan ang antas ng verbosity, isang antas para sa bawat isa -v matatagpuan sa command line.

--bersyon, -V
I-print ang string ng bersyon at lumabas.

--walang-config
Huwag i-load ang mga default na configuration file. Pinipigilan nito ang pag-load ng parehong
antas ng gumagamit at sa buong sistema mpv.conf at input.conf mga file. Iba pang mga configuration file
ay naka-block din, tulad ng mga resume playback na file.

TANDAAN:
Mga file na tahasang hiniling ng mga opsyon sa command line, tulad ng --isama or
--use-filedir-conf, ilo-load pa rin.

Tingnan din --config-dir.

--listahan-mga opsyon
Nagpi-print ng lahat ng magagamit na opsyon.

--list-properties
Mag-print ng listahan ng mga available na property.

--list-protocols
Mag-print ng listahan ng mga sinusuportahang protocol.

--log-file=
Binubuksan ang ibinigay na landas para sa pagsulat, at mag-print ng mga mensahe ng log dito. Ang mga kasalukuyang file ay
putulin. Ang antas ng log ay palaging tumutugma sa -v, anuman ang terminal
mga antas ng verbosity.

--config-dir=
Pilitin ang ibang configuration directory. Kung ito ay nakatakda, ang ibinigay na direktoryo ay
ginagamit upang i-load ang mga file ng pagsasaayos, at lahat ng iba pang mga direktoryo ng pagsasaayos ay
hindi pinansin. Nangangahulugan ito ng pandaigdigang direktoryo ng pagsasaayos ng mpv pati na rin ang bawat user
hindi pinapansin ang mga direktoryo, at na-override sa pamamagitan ng mga variable ng kapaligiran (MPV_HOME) ay
hindi rin pinansin.

Tandaan na ang --walang-config inuuna ang opsyon kaysa sa opsyong ito.

--save-position-on-quit
Palaging i-save ang kasalukuyang posisyon ng pag-playback sa paghinto. Kapag na-play muli ang file na ito
mamaya, hahanapin ng player ang lumang posisyon ng playback sa pagsisimula. Ito ay hindi
mangyayari kung ang pag-playback ng isang file ay itinigil sa anumang paraan maliban sa pagtigil. Para sa
halimbawa, ang pagpunta sa susunod na file sa playlist ay hindi magse-save ng posisyon, at
simulan ang pag-playback sa simula sa susunod na pag-play ng file.

Ang pag-uugali na ito ay hindi pinagana bilang default, ngunit palaging magagamit kapag huminto sa
manlalaro na may Shift+Q.

--dump-stats=
Sumulat ng ilang mga istatistika sa ibinigay na file. Ang file ay pinutol sa pagbubukas. Ang
Ang file ay maglalaman ng mga raw sample, bawat isa ay may timestamp. Upang gawing a
nababasa, ang script TOOLS/stats-conv.py maaaring gamitin (na kasalukuyang nagpapakita nito
bilang isang graph).

Ang pagpipiliang ito ay kapaki-pakinabang para sa pag-debug lamang.

--idle=
Ginagawang walang ginagawa ang mpv sa halip na huminto kapag walang file na ipe-play. Karamihan
kapaki-pakinabang sa slave mode, kung saan makokontrol ang mpv sa pamamagitan ng mga input command.

minsan ay idle lang sa simula at hahayaan ang player na magsara kapag mayroon na ang unang playlist
tapos play back.

--include=
Tukuyin ang configuration file na i-parse pagkatapos ng mga default.

--load-scripts=
Kung itakda sa hindi, huwag mag-auto-load ng mga script mula sa script subdirectory ng pagsasaayos
(Karaniwan ay ~/.config/mpv/scripts/). (Default: oo)

--script=
Mag-load ng Lua script. Maaari kang mag-load ng maramihang mga script sa pamamagitan ng paghihiwalay sa mga ito gamit ang mga kuwit
(,).

--script-opts=key1=value1,key2=value2,...
Magtakda ng mga opsyon para sa mga script. Ang isang script ay maaaring mag-query ng isang opsyon sa pamamagitan ng key. Kung gagamitin ang isang opsyon
at kung anong mga semantika ang mayroon ang halaga ng opsyon ay ganap na nakasalalay sa mga na-load na script.
Binabalewala ang mga value na hindi kine-claim ng anumang script.

--merge-files
Magpanggap na ang lahat ng mga file na ipinasa sa mpv ay pinagsama sa isang solong, malaking file. Ito
gumagamit ng suporta sa timeline/EDL sa loob. Tandaan na hindi ito gagana para sa iniutos na kabanata
file.

--no-resume-playback
Huwag ibalik ang posisyon ng playback mula sa panoorin_mamaya subdirectory ng pagsasaayos
(Karaniwan ay ~/.config/mpv/watch_later/). Tingnan quit_watch_later input command.

--profile=
Gamitin ang ibinigay na (mga) profile, --profile=help nagpapakita ng listahan ng mga tinukoy na profile.

--reset-on-next-file=
Karaniwan, susubukan ng mpv na panatilihin ang lahat ng mga setting kapag nagpe-play sa susunod na file sa
playlist, kahit na binago sila ng user sa panahon ng pag-playback. (Ang pag-uugali na ito ay
ang kabaligtaran ng MPlayer's, na sumusubok na i-reset ang lahat ng mga setting kapag nagsimula sa susunod
file.)

Default: Huwag i-reset ang anuman.

Mababago ito sa opsyong ito. Tumatanggap ito ng listahan ng mga opsyon, at gagawin ng mpv
i-reset ang halaga ng mga opsyong ito sa simula ng playback sa paunang halaga. Ang
ang paunang halaga ay alinman sa default na halaga, o bilang itinakda ng config file o command
linya.

Sa ilang mga kaso, maaaring hindi ito gumana gaya ng inaasahan. Halimbawa, --volume ay lamang maging
i-reset kung ito ay tahasang nakatakda sa config file o sa command line.

Ang espesyal na pangalan lahat nire-reset ang maraming opsyon hangga't maaari.

Mga halimbawa

· --reset-on-next-file=pause I-reset ang pause mode kapag lumipat sa susunod na file.

· --reset-on-next-file=fullscreen,bilis I-reset ang fullscreen at bilis ng pag-playback
mga setting kung binago ang mga ito sa panahon ng pag-playback.

· --reset-on-next-file=all Subukang i-reset ang lahat ng mga setting na binago noong panahon
playback.

--write-filename-in-watch-later-config
Prepend the watch later config files with the name of the file they refer to. Ito
ay nakasulat lamang bilang komento sa tuktok ng file.

BABALA:
Maaaring ilantad ng opsyong ito ang impormasyong sensitibo sa privacy at sa gayon ay hindi pinagana ng
default.

--ignore-path-in-watch-later-config
Huwag pansinin ang path (ibig sabihin, gamitin lang ang filename) kapag gumagamit ng feature na watch later.

--show-profile=
Ipakita ang paglalarawan at nilalaman ng isang profile.

--use-filedir-conf
Maghanap ng isang file-specific na configuration file sa parehong direktoryo ng file na iyon
ay nilalaro. Tingnan mo Partikular sa file Configuration File.

BABALA:
Maaaring mapanganib kung nagpe-play mula sa hindi pinagkakatiwalaang media.

--ytdl, --no-ytdl
Paganahin ang youtube-dl hook-script. Titingnan nito ang input URL, at ipe-play ang
video na matatagpuan sa website. Gumagana ito sa maraming streaming site, hindi lang sa
isa na pinangalanan sa script. Nangangailangan ito ng kamakailang bersyon ng youtube-dl to
mai-install sa system. (Pinagana bilang default, maliban kapag ang client API /
libmpv ay ginagamit.)

Kung walang magagawa ang script sa isang URL, wala itong magagawa.

--ytdl-format=
Format/kalidad ng video na direktang ipinapasa sa youtube-dl. Ang mga posibleng halaga ay
partikular sa website at sa video, para sa isang ibinigay na url ang mga available na format ay maaaring
natagpuan sa utos youtube-dl --list-formats URL. Tingnan ang youtube-dl's
dokumentasyon para sa mga available na alias. (Default: default ng youtube-dl, sa kasalukuyan
bestvideo+bestaudio/best)

--ytdl-raw-options= = [, = [,...]]
Ipasa ang mga arbitrary na opsyon sa youtube-dl. Ang parameter at argumento ay dapat ipasa bilang a
pares ng key-value. Dapat isama ang mga opsyon na walang argumento =.

Walang pagsusuri sa katinuan kaya posibleng masira ang mga bagay (ibig sabihin, hindi wasto ang pagpasa
mga parameter sa youtube-dl).

halimbawa

--ytdl-raw-options=username=user,password=pass
--ytdl-raw-options=force-ipv6=

Video
--vo=
Tumukoy ng listahan ng priyoridad ng mga driver ng output ng video na gagamitin. Para sa interactive na paggamit,
ang isa ay karaniwang tumutukoy ng isang solong gagamitin, ngunit sa mga configuration file,
ang pagtukoy ng isang listahan ng mga fallback ay maaaring magkaroon ng kahulugan. Tingnan mo VIDEO oUTPUT MGA DRIVER para sa mga detalye
at mga paglalarawan ng magagamit na mga driver.

--vd=<[+|-]family1:(*|decoder1),[+|-]family2:(*|decoder2),...[-]>
Tumukoy ng listahan ng priyoridad ng mga video decoder na gagamitin, ayon sa kanilang pamilya at
pangalan. Tingnan mo --Ad para sa karagdagang detalye. Pareho sa mga opsyong ito ay gumagamit ng parehong syntax at
semantika; ang pagkakaiba lamang ay ang mga ito ay nagpapatakbo sa iba't ibang mga listahan ng codec.

TANDAAN:
Tingnan --vd=tulong para sa buong listahan ng mga available na decoder.

--vf=
Tumukoy ng listahan ng mga filter ng video na ilalapat sa stream ng video. Tingnan mo VIDEO Mga filter para
mga detalye at paglalarawan ng magagamit na mga filter. Mga variant ng opsyon --vf-add,
--vf-pre, --vf-del at --vf-clr umiiral upang baguhin ang isang naunang tinukoy na listahan, ngunit
hindi mo dapat kailanganin ang mga ito para sa karaniwang paggamit.

--walang-video
Huwag i-play ang video. Sa ilang mga demuxer, maaaring hindi ito gumana. Sa mga kasong iyon maaari mong subukan
--vo=null sa halip.

Susubukan lamang ng mpv na i-download ang audio kung ang media ay na-stream gamit ang youtube-dl,
dahil nakakatipid ito ng bandwidth. Ginagawa ito sa pamamagitan ng pagtatakda ng ytdl_format sa
"bestaudio/best" sa ytdl_hook.lua script.

--hindi napapanahon
Huwag matulog kapag naglalabas ng mga video frame. Kapaki-pakinabang para sa mga benchmark kapag ginamit kasama ng
--walang-audio.

--framedrop=
Laktawan ang pagpapakita ng ilang mga frame upang mapanatili ang A/V sync sa mabagal na system, o paglalaro ng mataas
framerate na video sa mga video output na may mas mataas na limitasyon sa framerate.

Pinipili ng argumento ang mga paraan ng pag-drop, at maaaring isa sa mga sumusunod:

Huwag paganahin ang anumang framedropping.

Mag-drop ng mga late frame sa output ng video (default). Nagde-decode at nagsasala pa rin ito
lahat ng mga frame, ngunit hindi nagbibigay ng mga ito sa VO. Sinusubukan nitong i-query ang display
FPS (X11 lang, hindi tama sa mga multi-monitor system), o ipinapalagay na walang katapusan
ipakita ang FPS kung nabigo iyon. Ang mga patak ay ipinahiwatig sa linya ng katayuan ng terminal
as D: patlang. Kung ang decoder ay masyadong mabagal, sa teorya ay kailangan ng lahat ng mga frame
i-drop (dahil ang lahat ng mga frame ay huli na) - upang maiwasan ito, ang pag-drop ng frame
hihinto kung ang epektibong framerate ay mas mababa sa 10 FPS.


Luma, framedrop mode na nakabatay sa decoder. (Ito ay kapareho ng --framedrop=oo in
mpv 0.5.x at bago.) Sinasabi nito sa decoder na laktawan ang mga frame (maliban kung sila ay
ay kinakailangan upang mabasa ang mga frame sa hinaharap). Maaaring makatulong sa mabagal na sistema, ngunit maaari
makagawa ng hindi mapapanood na pabagu-bagong output, o kahit na ganap na i-freeze ang display.
Hindi inirerekomenda. Ang --vd-lavc-framedrop Kinokontrol ng opsyon kung ano ang mga frame
drop.


Paganahin ang parehong mga mode. Hindi inirerekomenda.

TANDAAN:
--vo=vdpau ay may sariling code para sa vo mode ng framedrop. Bahagyang pagkakaiba sa
iba pang mga VO ay posible.

--display-fps=
Itakda ang display FPS na ginamit sa --video-sync=display-* mga mode. Bilang default a
ginagamit ang nakitang halaga (X11 lang, hindi tama sa mga multi-monitor system). Panatilihin sa
isipin na ang pagtatakda ng maling halaga (kahit na bahagyang mali) ay maaaring makasira sa video
playback.

--hwdec=
Tukuyin ang hardware video decoding API na dapat gamitin kung maaari. kung
hardware decoding ay talagang tapos na ay depende sa video codec. Kung hardware decoding
ay hindi posible, ang mpv ay babalik sa software decoding.

maaaring isa sa mga sumusunod:

hindi palaging gumamit ng software decoding (default)

kotse tingnan sa ibaba

vdpau nangangailangan --vo=vdpau or --vo=opengl (Linux lang)

vaapi nangangailangan --vo=opengl or --vo=vaapi (Linux lang)

vaapi-copy
kinokopya ang video pabalik sa system RAM (Linux na may mga Intel GPU lang)

videotoolbox
nangangailangan --vo=opengl (OS X 10.8 at mas bago lang)

dxva2-copy
kinokopya ang video pabalik sa system RAM (Windows lang)

rpi nangangailangan --vo=rpi (Raspberry Pi lang - default kung available)

kotse sinusubukang awtomatikong paganahin ang hardware decoding gamit ang unang magagamit
paraan. Depende pa rin ito kung anong VO ang ginagamit mo. Halimbawa, kung hindi mo ginagamit
--vo=vdpau or --vo=opengl, hindi kailanman papaganahin ang vdpau decoding. Tandaan din na kung
hindi talaga gumagana ang unang nahanap na paraan, palagi itong babalik sa software
decoding, sa halip na subukan ang susunod na paraan (maaaring mahalaga sa ilang mga sistema ng Linux).

Ang vaapi mode, kung ginamit sa --vo=opengl, nangangailangan ng Mesa 11 at malamang na gumagana
sa mga Intel GPU lang. Nangangailangan din ito ng opengl EGL backend (awtomatikong ginagamit
kung bakante). Maaari mo ring subukan ang lumang GLX backend sa pamamagitan ng pagpilit dito
--vo=opengl:backend=x11, ngunit ang vaapi/GLX interop ay sinasabing mas mabagal kaysa
vaapi-copy.

Ang vaapi-copy pinapayagan ka ng mode na gumamit ng vaapi sa anumang VO. Dahil kinokopya nito ang
decoded video pabalik sa system RAM, ito ay malamang na mas mahusay kaysa sa vaapi mode.

TANDAAN:
Kapag ginagamit ang switch na ito, ginagawa pa rin ang hardware decoding para sa ilang codec.
Tingnan --hwdec-codecs upang paganahin ang hardware decoding para sa higit pang mga codec.

--hwdec-preload=
Ito ay kapaki-pakinabang para sa openl at openl-cb VOs para sa paglikha ng hardware decoding
OpenGL interop na konteksto, ngunit hindi aktwal na pinapagana ang mismong pag-decode ng hardware
(katulad --hwdec ginagawa).

Kung itakda sa hindi (default), ang --hwdec ginagamit ang opsyon.

para openl, kung nakatakda, huwag gumawa ng interop na konteksto kapag hinihiling, ngunit kapag ang VO ay
nilikha.

para openl-cb, kung nakatakda, i-load ang konteksto ng interop sa sandaling ang konteksto ng OpenGL ay
nilikha. Since openl-cb ay walang on-demand na paglo-load, nagbibigay-daan ito sa pagpapagana ng hardware
decoding sa runtime sa lahat, nang hindi kinakailangang pansamantalang itakda ang hwdec opsyon
sa panahon lamang ng pagsisimula ng konteksto ng OpenGL sa mpv_opengl_cb_init_gl().

--videotoolbox-format=
Itakda ang panloob na format ng pixel na ginamit ni --hwdec=videotoolbox sa OSX. Ang pagpili ng
ang format ay maaaring makaimpluwensya nang malaki sa pagganap. Sa kabilang banda, wala
mukhang isang mahusay na paraan upang makita ang pinakamahusay na format para sa ibinigay na hardware. nv12, ang
default, gumagana nang mas mahusay sa modernong hardware, habang uyvy422 mukhang mas mabuti para sa
lumang hardware. rgb0 gumagana din.

--panscan=<0.0-1.0>
Ine-enable ang pan-and-scan na functionality (pag-crop sa mga gilid ng hal. isang 16:9 na video na gagawin
kasya ito sa isang 4:3 na display na walang mga itim na banda). Kinokontrol ng hanay kung gaano karami ang larawan
ay na-crop. Maaaring hindi gumana sa lahat ng mga driver ng output ng video.

--video-aspect=
I-override ang aspect ratio ng video, kung sakaling mali o nawawala ang impormasyon ng aspeto
ang file na nilalaro. Tingnan din --walang-video-aspect.

Dalawang halaga ang may espesyal na kahulugan:

0 huwag paganahin ang paghawak ng aspect ratio, magpanggap na may mga square pixel ang video

-1 gamitin ang video stream o aspeto ng lalagyan (default)

Ngunit tandaan na ang pangangasiwa sa mga espesyal na halagang ito ay maaaring magbago sa hinaharap.

Mga halimbawa

· --video-aspect=4:3 or --video-aspect=1.3333

· --video-aspect=16:9 or --video-aspect=1.7777

--walang-video-aspect
Huwag pansinin ang impormasyon ng aspect ratio mula sa video file at ipagpalagay na ang video ay may parisukat
mga pixel. Tingnan din --video-aspect.

--video-aspect-method=
Itinatakda nito ang default na paraan ng pagtukoy ng aspeto ng video (kung ang aspeto ay _hindi_
na-override ng user na may --video-aspect o iba pa).

mestiso Mas gusto ang lalagyan na aspect ratio. Kung lumipat ang aspeto ng bitstream
mid-stream, lumipat sa mas gusto ang bitstream na aspeto. Ito ang default
pag-uugali sa mpv at mplayer2.

lalagyan
Mas gusto ang container aspect ratio. Ito ay tila ang default
pag-uugali sa VLC, hindi bababa sa Matroska.

bitstream
Mahigpit na mas gusto ang bitstream aspect ratio, maliban kung ang bitstream na aspeto
hindi nakatakda ang ratio. Ito ay tila ang default na pag-uugali sa XBMC/kodi, sa
hindi bababa sa Matroska.

Karaniwan hindi mo dapat itakda ito. Subukan ang lalagyan at bitstream mga pagpipilian kung ikaw
makatagpo ng video na may maling aspect ratio sa mpv, ngunit mukhang tama sa
ibang players.

--video-unscaled
Huwag paganahin ang pag-scale ng video. Kung mas malaki ang window kaysa sa video, mga itim na bar
ay idinagdag. Kung hindi, ang video ay na-crop. Ang video ay maaari pa ring maimpluwensyahan ng
ang iba pang mga --video-... mga pagpipilian. (Ngunit hindi lahat; halimbawa --video-zoom walang ginagawa
kung pinagana ang opsyong ito.)

Ang mga aspeto ng video at monitor ay hindi papansinin. Pagwawasto ng aspeto ay
kailangang i-scale ang video sa X o Y na direksyon, ngunit hindi pinapagana ang opsyong ito
pag-scale, hindi pagpapagana ng lahat ng pagwawasto ng aspeto.

Tandaan na maaari pa ring gamitin ang scaler algorithm, kahit na hindi naka-scale ang video.
Halimbawa, maaari itong makaimpluwensya sa conversion ng chroma.

Ang opsyong ito ay hindi pinagana kung ang --walang-keepaspect ginagamit ang opsyon.

--video-pan-x= , --video-pan-y=
Inililipat ang ipinapakitang rektanggulo ng video ayon sa ibinigay na halaga sa direksyong X o Y. Ang
Ang unit ay nasa mga fraction ng laki ng naka-scale na video (ang buong laki, kahit na ang mga bahagi
ng video ay hindi nakikita dahil sa panscan o iba pang mga opsyon).

Halimbawa, ang pagpapakita ng 1280x720 video na fullscreen sa isang 1680x1050 na screen na may
--video-pan-x=-0.1 ililipat ang video na 168 pixels pakaliwa (gumawa ng 128 pixels
ng hindi nakikitang pinagmulang video).

Ang opsyong ito ay hindi pinagana kung ang --walang-keepaspect ginagamit ang opsyon.

--video-rotate=<0-360|hindi>
I-rotate ang video clockwise, sa degrees. Kasalukuyang sumusuporta sa 90° na mga hakbang lamang. Kung hindi
ay ibinigay, ang video ay hindi kailanman paikutin, kahit na ang file ay may rotation metadata. (Ang
ang halaga ng pag-ikot ay idinagdag sa metadata ng pag-ikot, na nangangahulugang ang halaga 0 gusto
i-rotate ang video ayon sa rotation metadata.)

--video-stereo-mode=
Itakda ang stereo 3D output mode (default: mono). Ginagawa ito sa pamamagitan ng pagpasok ng
stereo3d filter ng conversion.

Ang pseudo-mode hindi ganap na hindi pinapagana ang awtomatikong conversion.

Ang mode mono ay isang alyas sa ml, na tumutukoy sa kaliwang frame sa 2D. Ito ang
default, na nangangahulugang susubukan ng mpv na magpakita ng mga 3D na pelikula sa 2D, sa halip na ang sira
Ang 3D na imahe ay hindi inilaan para sa pagkonsumo (tulad ng pagpapakita ng kaliwa at kanang frame
magkatabi, atbp.).

paggamit --video-stereo-mode=help upang ilista ang lahat ng magagamit na mga mode. Suriin sa stereo3d
i-filter ang dokumentasyon upang makita kung ano ang ibig sabihin ng mga pangalan. Tandaan na ang ilang mga pangalan ay tumutukoy sa
mga mode na hindi sinusuportahan ng stereo3d - ang mga mode na ito ay maaaring lumitaw sa mga file, ngunit hindi maaari
pinangangasiwaan ng maayos ng mpv.

--video-zoom=
I-adjust ang video display scale factor ayon sa ibinigay na value. Ang yunit ay nasa mga fraction
ng (naka-scale) na laki ng video ng window.

Halimbawa, binigyan ng 1280x720 na video na ipinapakita sa isang 1280x720 na window, --video-zoom=-0.1
gagawing mas maliit ang video ng 128 pixels sa direksyon ng X, at 72 pixels sa Y
direksyon.

Ang opsyong ito ay hindi pinagana kung ang --walang-keepaspect ginagamit ang opsyon.

--video-align-x=<-1-1>, --video-align-y=<-1-1>
Inililipat ang rektanggulo ng video sa loob ng mga itim na hangganan, na karaniwang idinaragdag sa pad
ang video sa screen kung magkaiba ang mga aspect ratio ng video at screen.
--video-align-y=-1 ililipat ang video sa tuktok ng screen (nag-iiwan ng hangganan
sa ibaba lamang), isang halaga ng 0 nakasentro ito (default), at isang halaga ng 1 ilalagay
ang video sa ibaba ng screen.

Kung perpektong magkatugma ang aspeto ng video at screen, walang magagawa ang mga opsyong ito.

Ang opsyong ito ay hindi pinagana kung ang --walang-keepaspect ginagamit ang opsyon.

--tama-pts, --walang-tama-pts
--walang-tama-pts inililipat ang mpv sa isang mode kung saan tinutukoy ang timing ng video gamit ang a
nakapirming halaga ng framerate (alinman sa paggamit ng --fps opsyon, o gamit ang impormasyon ng file).
Minsan, ang mga file na may napakasira na mga timestamp ay maaaring i-play nang medyo maayos dito
mode. Tandaan na ang mga filter ng video, pag-render ng subtitle at pag-synchronize ng audio ay maaaring
ganap na nasira sa mode na ito.

--fps=
I-override ang framerate ng video. Kapaki-pakinabang kung mali o nawawala ang orihinal na halaga.

TANDAAN:
Nagtatrabaho sa --walang-tama-pts mode lang.

--deinterlace=
Paganahin o huwag paganahin ang interlacing (default: auto, na karaniwang nangangahulugang hindi). Interlaced
nagpapakita ang video ng mga pangit na parang suklay na artifact, na makikita sa mabilis na paggalaw. Pinapagana
ito ay karaniwang naglalagay ng yadif video filter upang i-deinterlace ang video, o
hinahayaan ang output ng video na maglapat ng deinterlacing kung sinusuportahan.

Ito ay kumikilos nang eksakto tulad ng deinterlace input property (karaniwan ay nakamapa sa d).

kotse ay isang teknikalidad. Sa mahigpit na pagsasalita, ang default para sa opsyong ito ay
deinterlacing hindi pinagana, ngunit ang kotse kaso kailangan kung yadif ay idinagdag sa
i-filter ang chain nang manu-mano gamit ang --vf. Kung gayon ang core ay hindi dapat i-disable ang deinterlacing lamang
dahil ang --deinterlace ay hindi nakatakda.

--field-dominance=
Itakda ang unang field para sa interlaced na nilalaman. Kapaki-pakinabang para sa mga deinterlacer na doble ang
frame rate: --vf=yadif=patlang at --vo=vdpau:deint.

kotse (default) Kung hindi na-export ng decoder ang naaangkop na impormasyon, ito
bumabalik sa tuktok (una sa itaas na field).

tuktok unang field sa itaas

ilalim ilalim na patlang muna

TANDAAN:
Setting alinman tuktok or ilalim ay i-flag ang lahat ng mga frame bilang interlaced.

--mga frame=
Play/convert lang muna mga video frame, pagkatapos ay huminto.

--frames=0 nilo-load ang file, ngunit agad na huminto bago simulan ang pag-playback.
(Maaaring maging kapaki-pakinabang para sa mga script na nais lamang matukoy ang ilang mga katangian ng file.)

Para sa audio-only playback, ang anumang value na mas malaki sa 0 ay agad na titigil sa pag-playback
pagkatapos ng pagsisimula. Gumagana ang value na 0 tulad ng sa video.

--video-output-levels=
Mga antas ng kulay ng RGB na ginagamit sa conversion ng YUV sa RGB. Karaniwan, ang mga aparatong output tulad ng
Ang mga monitor ng PC ay gumagamit ng buong hanay ng mga antas ng kulay. Gayunpaman, ang ilang mga TV at video monitor
asahan ang mga antas ng studio RGB. Pagbibigay ng buong saklaw na output sa isang device na umaasang studio
Ang antas ng input ay nagreresulta sa mga durog na itim at puti, ang kabaligtaran sa madilim na kulay abong itim
at madilim na puti.

Hindi lahat ng VO ay sumusuporta sa opsyong ito. Ang ilan ay tahimik na papansinin ito.

Ang mga available na hanay ng kulay ay:

kotse awtomatikong pagpili (katumbas ng buong saklaw) (default)

limitado
limitadong saklaw (16-235 bawat bahagi), mga antas ng studio

ganap buong saklaw (0-255 bawat bahagi), mga antas ng PC

TANDAAN:
Maipapayo na gamitin ang pagpipiliang hanay ng kulay ng iyong graphics driver, kung
magagamit.

--hwdec-codecs=
Payagan ang hardware decoding para sa isang partikular na listahan ng mga codec lamang. Ang espesyal na halaga lahat
palaging pinapayagan ang lahat ng mga codec.

Makukuha mo ang listahan ng mga pinapayagang codec gamit ang mpv --vd=tulong. Alisin ang prefix, hal
sa halip ng lavc:h264 gamitin h264.

Bilang default, nakatakda ito sa h264,vc1,wmv3,hevc,mpeg2video. Tandaan na ang hardware
acceleration espesyal na codec tulad ng h264_vdpau ay hindi na nauugnay, at sa katunayan
ay inalis mula sa Libav sa form na ito.

Karaniwang kailangan lang ito sa mga sirang GPU, kung saan iniuulat ang isang codec bilang
suportado, ngunit ang pag-decode ay nagdudulot ng mas maraming problema kaysa sa nalulutas nito.

halimbawa

mpv --hwdec=vdpau --vo=vdpau --hwdec-codecs=h264,mpeg2video
I-enable ang vdpau decoding para sa h264 at mpeg2 lang.

--vd-lavc-check-hw-profile=
Suriin ang profile ng hardware decoder (default: oo). Kung hindi ay nakatakda, ang pinakamataas na profile ng
ang hardware decoder ay pinili nang walang kondisyon, at ang pag-decode ay pinilit kahit na
ang profile ng video ay mas mataas kaysa doon. Ang resulta ay malamang na sira
pag-decode, ngunit maaari ring makatulong kung ang mga nakita o naiulat na mga profile ay kahit papaano
hindi tama.

--vd-lavc-software-fallback=
Fallback sa software decoding kung nabigo ang hardware-accelerated decoder (default:
3). Kung ito ay isang numero, ang fallback ay ma-trigger kung ang N frame ay nabigong mag-decode
sunud-sunod. 1 ay katumbas ng oo.

--vd-lavc-bitexact
Gumamit lamang ng mga bit-exact na algorithm sa lahat ng hakbang sa pag-decode (para sa pagsubok ng codec).

--vd-lavc-mabilis (MPEG-2, MPEG-4, at H.264 lamang)
Paganahin ang mga pag-optimize na hindi sumusunod sa detalye ng format at
posibleng magdulot ng mga problema, tulad ng mas simpleng dequantization, mas simpleng paggalaw
kabayaran, ipagpalagay na ang paggamit ng default na quantization matrix, ipagpalagay na YUV 4:2:0
at paglaktaw ng ilang pagsusuri upang makita ang mga nasirang bitstream.

--vd-lavc-o= = [, = [,...]]
Ipasa ang AVOptions sa libavcodec decoder. Tandaan, isang patch para gawin ang o= hindi kailangan at
ipasa ang lahat ng hindi kilalang mga opsyon sa pamamagitan ng sistema ng AVOption ay malugod na tinatanggap. Isang buong listahan ng
Ang AVOptions ay matatagpuan sa FFmpeg manual.

Ang ilang mga opsyon na dating mga direktang opsyon ay maaaring itakda sa mekanismong ito, tulad ng
kulisap, kulay-abo, idct, ec, vismv, skip_top (ay st), skip_bottom (ay sb), mag-alis ng mga insekto.

halimbawa

--vd-lavc-o=debug=pict

--vd-lavc-show-all=
Ipakita kahit na sirang/corrupt na mga frame (default: hindi). Kung nakatakda ang opsyong ito sa hindi,
Ang libavcodec ay hindi maglalabas ng mga frame na na-decode bago ang isang paunang keyframe
ay na-decode, o mga frame na kinikilala bilang sira.

--vd-lavc-skiploopfilter= (H.264 lamang)
Nilalaktawan ang loop filter (AKA deblocking) habang nagde-decode ng H.264. Mula nang na-filter
Ang frame ay dapat gamitin bilang sanggunian para sa pag-decode ng mga umaasa na frame, ito ay may a
mas masamang epekto sa kalidad kaysa sa hindi paggawa ng pag-deblock sa hal. MPEG-2 na video. Ngunit sa
hindi bababa sa para sa mataas na bitrate HDTV, ito ay nagbibigay ng isang malaking speedup na may maliit na nakikita
pagkawala ng kalidad.

maaaring isa sa mga sumusunod:

wala Huwag kailanman laktawan.

default
Laktawan ang mga walang kwentang hakbang sa pagproseso (hal. 0 size na packet sa AVI).

nonref Laktawan ang mga frame na hindi naka-reference (ibig sabihin, hindi ginagamit para sa pag-decode ng iba
mga frame, ang error ay hindi maaaring "bumuo").

bidir Laktawan ang B-Frames.

nonkey Laktawan ang lahat ng mga frame maliban sa mga keyframe.

lahat Laktawan ang lahat ng mga frame.

--vd-lavc-skipidct= (MPEG-1/2 lamang)
Nilaktawan ang hakbang ng IDCT. Ito ay lubhang nagpapababa ng kalidad sa halos lahat ng mga kaso (tingnan
skiploopfilter para sa mga available na skip value).

--vd-lavc-skipframe=
Lubos na nilaktawan ang pag-decode ng mga frame. Malaki ang bilis, ngunit maalog na galaw at kung minsan
masamang artifact (tingnan ang skiploopfilter para sa mga available na skip value).

--vd-lavc-framedrop=
Itakda ang framedropping mode na ginamit sa --framedrop (tingnan ang skiploopfilter para sa available na skip
halaga).

--vd-lavc-threads=
Bilang ng mga thread na gagamitin para sa pag-decode. Kung talagang sinusuportahan ang threading
depende sa codec (default: 0). 0 ay nangangahulugan ng autodetect na bilang ng mga core sa makina
at gamitin iyon, hanggang sa maximum na 16. Maaari kang magtakda ng higit sa 16 na mga thread nang manu-mano.

audio
--audio-pitch-correction=
Kung ito ay pinagana (default), ang paglalaro na may bilis na iba sa normal
awtomatikong ipinapasok ang scaletempo filter ng audio. Para sa mga detalye, tingnan ang audio filter
seksyon.

--audio-device=
Gamitin ang ibinigay na audio device. Binubuo ito ng pangalan ng audio output, hal tumaas,
sinundan ng /, na sinusundan ng pangalan ng partikular na device ng audio output.

Maaari mong ilista ang mga audio device na may --audio-device=help. Inilalabas nito ang pangalan ng device
sa mga quote, na sinusundan ng isang paglalarawan. Ang pangalan ng device ang kailangan mong ipasa
ang --audio-device pagpipilian.

Ang default na halaga para sa opsyong ito ay kotse, na sumusubok sa bawat audio output
pagkakasunod-sunod ng kagustuhan gamit ang default na device.

Tandaan na maraming AO ang may a aparato sub-option, na nag-o-override sa pagpili ng device
ng opsyong ito (ngunit hindi ang pagpili ng audio output). Gayundin, ang pagpilit ng isang AO na may
--ao ay i-override ang pagpili ng audio output ng --audio-device (ngunit hindi ang device
pagpili).

Kasalukuyang hindi ipinapatupad para sa karamihan ng mga AO.

--audio-fallback-to-null=
Kung walang mabubuksang audio device, kumilos na parang --ao=null ay ibinigay. Ito ay kapaki-pakinabang
sa kumbinasyon ng --audio-device: sa halip na magdulot ng error kung ang napili
wala ang device, maaaring hayaan ng user ng client API (o isang Lua script) ang pag-playback
magpatuloy nang normal, at suriin ang kasalukuyang-ao at listahan ng audio-device mga pag-aari sa
gumawa ng mataas na antas ng mga desisyon tungkol sa kung paano magpatuloy.

--ao=
Tumukoy ng listahan ng priyoridad ng mga driver ng audio output na gagamitin. Para sa interactive na paggamit ng isa
ay karaniwang tumutukoy ng isang solong gagamitin, ngunit sa pagsasaayos ng mga file na tumutukoy sa a
maaaring magkaroon ng kahulugan ang listahan ng mga fallback. Tingnan mo Audio oUTPUT MGA DRIVER para sa mga detalye at
mga paglalarawan ng magagamit na mga driver.

--af=
Tumukoy ng listahan ng mga audio filter na ilalapat sa audio stream. Tingnan mo Audio Mga filter para
mga detalye at paglalarawan ng magagamit na mga filter. Mga variant ng opsyon --af-add,
--af-pre, --af-del at --af-clr umiiral upang baguhin ang isang naunang tinukoy na listahan, ngunit
hindi mo dapat kailanganin ang mga ito para sa karaniwang paggamit.

--audio-spdif=
Listahan ng mga codec kung saan dapat gamitin ang naka-compress na audio passthrough. Gumagana ito
para sa parehong klasikong S/PDIF at HDMI.

Ang mga posibleng codec ay ac3, dts, dts-hd. Maaaring tukuyin ang maramihang mga codec sa pamamagitan ng
paghihiwalay sa kanila ng ,. dts ay tumutukoy sa mababang bitrate na DTS core, habang dts-hd ay tumutukoy sa
DTS MA (nag-iiba-iba ang suporta ng receiver at OS). Dapat mo lang gamitin ang alinman dts or dts-hd
(kung pareho ang tinukoy, at dts mauna, lang dts gagamitin).

Sa pangkalahatan, ang lahat ng mga codec sa spdif pamilyang nakalista kasama ng --ad=tulong ay suportado sa
teorya.

babala

Walang gaanong dahilan para gamitin ito. Sinusuportahan ng HDMI ang hindi naka-compress
multichannel PCM, at mpv ay sumusuporta sa lossless DTS-HD decoding sa pamamagitan ng FFmpeg's
libdcadec wrapper.

--ad=<[+|-]family1:(*|decoder1),[+|-]family2:(*|decoder2),...[-]>
Tumukoy ng listahan ng priyoridad ng mga audio decoder na gagamitin, ayon sa kanilang pamilya at
pangalan ng decoder. Mga entry tulad ng pamilya:* unahin ang lahat ng mga decoder ng ibinigay na pamilya.
Kapag tinutukoy kung aling decoder ang gagamitin, ang unang decoder na tumutugma sa audio
napili ang format. Kung hindi iyon magagamit, gagamitin ang susunod na decoder. Sa wakas, ito
sinusubukan ang lahat ng iba pang mga decoder na hindi tahasang pinili o tinanggihan ng
pagpipilian.

- sa dulo ng listahan ay pinipigilan ang fallback sa iba pang available na decoder na wala sa
--Ad listahan. + sa harap ng isang entry ay pinipilit ang decoder. Ang dalawang ito ay hindi dapat
karaniwang ginagamit, dahil sinisira nila ang normal na decoder auto-selection!

- sa harap ng isang entry ay hindi pinapagana ang pagpili ng decoder.

Mga halimbawa

--ad=lavc:mp3float
Mas gusto ang FFmpeg/Libav mp3float decoder sa lahat ng iba pang MP3 decoder.

--ad=spdif:ac3,lavc:*
Palaging mas gusto ang spdif AC3 kaysa sa FFmpeg/Libav kaysa sa anupaman.

--ad=tulong
Ilista ang lahat ng available na decoder.

babala

Paganahin ang naka-compress na audio passthrough (AC3 at DTS sa pamamagitan ng SPDIF/HDMI) gamit ang
hindi na ginagamit ang opsyong ito. Gamitin --audio-spdif sa halip.

--volume=
Itakda ang dami ng startup. 0 ay nangangahulugang katahimikan, 100 ay nangangahulugang walang pagbabawas ng volume o
pagpapalakas. Ang halaga ng -1 (ang default) ay hindi magbabago sa volume. Tingnan din
--softvol.

TANDAAN:
Binago ito pagkatapos ng paglabas ng mpv 0.9. Bago iyon, 100 talaga ang ibig sabihin
maximum na volume. Kasabay nito, ang sukat ng volume ay ginawang kubiko, kaya ang luma
ang mga halaga ay hindi pa rin tumutugma sa mga bago.

--audio-delay=
Pagkaantala ng audio sa mga segundo (positibo o negatibong float value). Pagkaantala ng mga positibong halaga
ang audio, at mga negatibong halaga ay naantala ang video.

--walang-audio
Huwag magpatugtog ng tunog.

--mute=
Itakda ang status ng pag-mute ng audio sa pagsisimula. kotse (default) ay hindi babaguhin ang mute status. Gayundin
makita --volume.

--softvol=
Kontrolin kung gagamitin ang mga kontrol ng volume ng audio output driver o ang
panloob na filter ng dami ng mpv.

hindi mas gusto ang mga kontrol ng driver ng audio, gamitin lang ang filter ng volume kung talagang
kailangan

oo laging gamitin ang volume filter

kotse mas gusto ang volume filter kung ang audio driver ay gumagamit ng system mixer (default)

Ang hangarin ng kotse ay upang maiwasan ang pagbabago ng mga setting ng system mixer mula sa loob ng mpv
na may mga default na setting. Ang mpv ay isang video player, hindi isang panel ng mixer. Sa kabila
kamay, pinagana ang mga kontrol ng mixer para sa mga sound server tulad ng PulseAudio, na nagbibigay
dami ng bawat aplikasyon.

--audio-demuxer=<[+]pangalan>
Gamitin ang ganitong uri ng audio demuxer kapag gumagamit --audio-file. Gumamit ng '+' bago ang pangalan sa
pilitin ito; ito ay laktawan ang ilang mga tseke. Ibigay ang pangalan ng demuxer bilang naka-print ni
--audio-demuxer=help.

--ad-lavc-ac3drc=
Piliin ang antas ng Dynamic Range Compression para sa mga AC-3 na audio stream. ay isang
float value mula 0 hanggang 1, kung saan ang 0 ay nangangahulugang walang compression (na ang
default) at ang 1 ay nangangahulugan ng buong compression (gawing mas tahimik at vice ang malalakas na sipi
versa). Ang mga halagang hanggang 6 ay tinatanggap din, ngunit puro pang-eksperimento. Ang pagpipiliang ito
nagpapakita lang ng epekto kung naglalaman ang AC-3 stream ng kinakailangang range compression
impormasyon.

Ang pamantayan ay nag-uutos na ang DRC ay pinagana bilang default, ngunit ang mpv (at ilang iba pa
mga manlalaro) huwag pansinin ito para sa mas magandang kalidad ng audio.

--ad-lavc-downmix=
Kung hihilingin ang audio channel downmixing mula sa decoder (default: oo). Ang ilan
Ang mga decoder, tulad ng AC-3, AAC at DTS, ay maaaring mag-remix ng audio sa pag-decode. Ang hinihinging numero
ng mga channel ng output ay nakatakda sa --audio-channel opsyon. Kapaki-pakinabang para sa paglalaro
surround audio sa isang stereo system.

--ad-lavc-threads=<0-16>
Bilang ng mga thread na gagamitin para sa pag-decode. Kung talagang sinusuportahan ang threading
depende sa codec. Sa pagsulat na ito, ito ay suportado para sa ilang lossless codec lamang.
0 ay nangangahulugan ng autodetect na bilang ng mga core sa makina at gamitin iyon, hanggang sa maximum
ng 16 (default: 1).

--ad-lavc-o= = [, = [,...]]
Ipasa ang AVOptions sa libavcodec decoder. Tandaan, isang patch upang gawin ang o= hindi kailangan at
ipasa ang lahat ng hindi kilalang mga opsyon sa pamamagitan ng sistema ng AVOption ay malugod na tinatanggap. Isang buong listahan ng
Ang AVOptions ay matatagpuan sa FFmpeg manual.

--ad-spdif-dtshd= , --dtshd, --no-dtshd
Kung dumaan ang DTS, gamitin ang DTS-HD.

babala

Ito at pagpapagana ng passthrough sa pamamagitan ng --Ad ay hindi na ginagamit pabor sa paggamit
--audio-spdif=dts-hd.

--audio-channel=
Humiling ng layout ng channel para sa audio output (default: auto). Hihilingin nito sa AO na
magbukas ng device na may ibinigay na layout ng channel. Bahala na ang AO para tanggapin ito
layout, o pumili ng fallback o mag-error out kung hindi ang hiniling na layout
suportado.

Ang --audio-channel ang opsyon ay kukuha ng channel number o tahasang channel
layout. Ang mga numero ng channel ay tumutukoy sa mga default na layout, hal. 2 channel ay tumutukoy sa stereo,
6 ay tumutukoy sa 5.1.

Tingnan --audio-channels=help output para sa tinukoy na mga default na layout. Ito rin ay naglilista
mga pangalan ng speaker, na maaaring magamit upang ipahayag ang mga arbitrary na layout ng channel (hal
fl-fr-lfe ay 2.1).

Ang default ay --audio-channels=auto, na sumusubok na mag-play ng audio gamit ang input
layout ng channel ng file. (O mas tiyak, ang output ng audio filter chain.)
(walang laman ay isang tinatanggap na hindi na ginagamit na alyas para sa kotse.)

Hihilingin din nito ang layout ng channel mula sa decoder. Kung ang decoder ay hindi
suportahan ang layout, babalik ito sa orihinal nitong layout ng channel. (Pwede mong gamitin
--ad-lavc-downmix=no para gawing palaging output ng decoder ang native layout nito.) Tandaan
na ilang decoder lang ang sumusuporta sa remixing audio. Kasama sa ilan ang AC-3, AAC o
Audio ng DTS.

Kung ang layout ng channel ng media file (ie ang decoder) at ang channel ng AO
hindi tumutugma ang layout, susubukan ng mpv na magpasok ng filter ng conversion.

babala

paggamit kotse maaaring magdulot ng mga isyu kapag gumagamit ng audio sa HDMI. Ang OS ay
karaniwang nag-uulat ng lahat ng mga layout ng channel na _maaaring_ lumampas sa HDMI, kahit na ang
hindi sinusuportahan ng receiver ang mga ito. Kung ang isang receiver ay nakakuha ng hindi suportadong channel
layout, maaaring mangyari ang mga random na bagay, tulad ng pag-drop ng karagdagang
channel, o pagdaragdag ng ingay.

--audio-display=
Ang pagtatakda ng opsyong ito sa pagkagiliw (default) ay magpapakita ng mga attachment ng larawan (hal
album cover art) kapag nagpe-play ng mga audio file. Ipapakita nito ang unang larawang natagpuan,
at ang mga karagdagang larawan ay magagamit bilang mga video track.

Ang pagtatakda ng opsyong ito sa hindi ganap na hindi pinapagana ang pagpapakita ng video kapag nagpe-play ng audio
file.

Walang impluwensya ang opsyong ito sa mga file na may normal na video track.

--audio-file=
Mag-play ng audio mula sa isang external na file habang nanonood ng video. Ang bawat paggamit ng opsyong ito
ay magdaragdag ng bagong audio track. Ang mga detalye ay katulad ng kung paano --sub-file gawa.

--audio-format=
Piliin ang sample na format na ginamit para sa output mula sa audio filter layer hanggang sa tunog
card. Ang mga halaga na maaaring gamitin ay nakalista sa ibaba sa paglalarawan ng
format filter ng audio.

--audio-samplerate=
Piliin ang output sample rate na gagamitin (siyempre may mga limitasyon ang sound card
ito). Kung ang napiling dalas ng sample ay iba sa dalas ng kasalukuyang
media, ang lavrresample audio filter ay ipapasok sa audio filter layer
upang mabayaran ang pagkakaiba.

--gapless-audio=
Subukang mag-play ng magkakasunod na mga audio file nang walang katahimikan o pagkagambala sa punto ng
pagbabago ng file. Default: mahina.

hindi I-disable ang walang gap na audio.

oo Binubuksan ang audio device gamit ang mga parameter na pinili ayon sa una
na-play ang file at pagkatapos ay pinananatiling bukas para sa walang puwang na pag-playback. Nangangahulugan ito na kung
ang unang file halimbawa ay may mababang sample rate, pagkatapos ay ang mga sumusunod na file
maaaring ma-resampling sa parehong mababang rate ng sample, na magreresulta sa pinababang tunog
kalidad. Kung naglalaro ka ng mga file na may iba't ibang mga parameter, isaalang-alang ang paggamit ng mga opsyon
tulad ng --audio-samplerate at --audio-format upang tahasang piliin kung ano ang
magiging shared output format.

mahina Karaniwan, pinananatiling bukas ang audio device (gamit ang format na una
sinimulan sa). Kung ang format ng audio ay nagbabago ang output ng decoder, ang audio
sarado at muling binuksan ang device. Nangangahulugan ito na karaniwan kang magkakaroon ng gapless
audio na may mga file na na-encode gamit ang parehong mga setting, ngunit maaaring hindi
gapless sa ibang mga kaso. (Hindi tulad ng sa oo, hindi mo kailangang mag-alala
mga kaso sa sulok tulad ng unang file na nagtatakda ng napakababang kalidad na format ng output,
at sinisira ang pag-playback ng mas mataas na kalidad na mga file na kasunod.)

TANDAAN:
Ang feature na ito ay ipinatupad sa simpleng paraan at umaasa sa audio output device
buffering upang ipagpatuloy ang pag-playback habang lumilipat mula sa isang file patungo sa isa pa. Kung
Ang pag-playback ng bagong file ay nagsisimula nang mabagal, halimbawa dahil ito ay nilalaro mula sa a
malayong lokasyon ng network o dahil tinukoy mo ang mga setting ng cache na
nangangailangan ng oras para sa paunang pagpuno ng cache, pagkatapos ay maaaring maubos ang buffered na audio
bago magsimula ang pag-playback ng bagong file.

--initial-audio-sync, --walang-initial-audio-sync
Kapag nagsisimula ng isang video file o pagkatapos ng mga kaganapan tulad ng paghahanap, ang mpv ay gagawin bilang default
baguhin ang audio stream upang simulan ito mula sa parehong timestamp bilang video, sa pamamagitan ng
alinman sa pagpasok ng katahimikan sa simula o pagputol sa mga unang sample. Hindi pagpapagana
ginagawa ng opsyong ito na kumilos ang player tulad ng ginawa ng mga mas lumang bersyon ng mpv: video at audio
ay parehong sinimulan kaagad kahit na magkaiba ang kanilang mga timestamp sa pagsisimula, at pagkatapos ay ang video
unti-unting inaayos ang timing kung kinakailangan upang maabot ang tamang pag-synchronize sa ibang pagkakataon.

--softvol-max=<100.0-1000.0>
Itakda ang maximum na antas ng amplification sa porsyento (default: 130). Isang halaga ng 130 will
nagbibigay-daan sa iyong ayusin ang volume hanggang sa humigit-kumulang doble sa normal na antas.

--audio-file-auto= , --walang-audio-file-auto
Mag-load ng mga karagdagang audio file na tumutugma sa video filename. Tinutukoy ng parameter
kung paano itinutugma ang mga external na audio file. eksakto ay pinagana bilang default.

hindi Huwag awtomatikong i-load ang mga external na audio file.

eksakto I-load ang media filename na may extension ng audio file (default).

malabo I-load ang lahat ng mga audio file na naglalaman ng media filename.

lahat I-load ang lahat ng mga audio file sa kasalukuyang direktoryo.

--audio-client-name=
Ang pangalan ng application na iniuulat ng player sa audio API. Maaaring maging kapaki-pakinabang kung gusto mo
upang pilitin ang ibang audio profile (hal. sa PulseAudio), o itakda ang sarili mo
pangalan ng application kapag gumagamit ng libmpv.

--volume-restore-data=
Ginagamit sa loob para sa paggamit ng resume ng playback (hal quit_watch_later). Ibinabalik
Ang halaga ay kailangang gawin nang maingat, dahil maaaring magkaroon ang iba't ibang AO pati na rin ang softvol
iba't ibang hanay ng halaga, at hindi namin gustong ibalik ang volume kung itatakda ang volume
binabago ito sa buong sistema. Ang mga normal na opsyon (tulad ng --volume) ay palaging magtatakda ng
dami. Idinagdag ang opsyong ito para sa pagpapanumbalik ng volume sa mas ligtas na paraan (sa pamamagitan ng pag-iimbak ng
paraan na ginamit upang itakda ang lakas ng tunog), at sa pangkalahatan ay hindi kapaki-pakinabang. Ang semantika nito ay
itinuturing na pribado sa mpv.

Huwag gamitin.

--audio-buffer=
Itakda ang minimum na buffer ng output ng audio. Ang audio device ay maaaring aktwal na lumikha ng a
mas malaking buffer kung gusto nito. Kung gagawa ang device ng mas maliit na buffer, karagdagang
Ang audio ay naka-buffer sa isang karagdagang buffer ng software.

Ang pagpapalaki nito ay magpapabagal sa soft-volume at iba pang mga filter, ipakilala
karagdagang mga isyu sa pagbabago ng bilis ng pag-playback, at i-block ang player sa audio format
pagbabago. Ang isang mas maliit na buffer ay maaaring humantong sa mga pag-dropout ng audio.

Ang pagpipiliang ito ay dapat gamitin para sa pagsubok lamang. Kung nakakatulong ang isang hindi default na halaga
makabuluhang, dapat makipag-ugnayan sa mga developer ng mpv.

Default: 0.2 (200 ms).

Mga Subtitle
--walang-sub
Huwag pumili ng anumang subtitle kapag na-load ang file.

--sub-demuxer=<[+]pangalan>
Force subtitle demuxer type para sa --sub-file. Ibigay ang pangalan ng demuxer bilang naka-print ni
--sub-demuxer=tulong.

--sub-delay=
Naantala ang mga subtitle ni segundo. Maaaring maging negatibo.

--sub-file=subtitlefile
Magdagdag ng subtitle file sa listahan ng mga panlabas na subtitle.

Kung gumagamit ka ng --sub-file isang beses lang, ang subtitle na file na ito ay ipinapakita bilang default.

If --sub-file ay ginagamit nang maraming beses, ang subtitle na gagamitin ay maaaring ilipat sa
runtime sa pamamagitan ng pagbibisikleta ng mga subtitle na track. Posibleng magpakita ng dalawang subtitle nang sabay-sabay:
gamitin --sid upang piliin ang unang subtitle index, at --pangalawang-sid upang piliin ang
pangalawang index. (Ang index ay naka-print sa terminal output pagkatapos ng --sid= nasa
listahan ng mga stream.)

--secondary-sid=
Pumili ng pangalawang subtitle na stream. Ito ay katulad ng --sid. Kung pangalawa
pinili ang subtitle, ire-render ito bilang toptitle (ibig sabihin, sa tuktok ng
screen) sa tabi ng normal na subtitle, at nagbibigay ng paraan upang mag-render ng dalawang subtitle
sabay-sabay.

Mayroong ilang mga caveat na nauugnay sa tampok na ito. Halimbawa, ang mga subtitle ng bitmap
ay palaging ire-render sa kanilang karaniwang posisyon, kaya ang pagpili ng bitmap subtitle bilang
ang pangalawang subtitle ay magreresulta sa magkakapatong na mga subtitle. Ang mga pangalawang subtitle ay
hindi kailanman ipinapakita sa terminal kung ang video ay hindi pinagana.

TANDAAN:
Ang pag-istilo at interpretasyon ng anumang mga tag sa pag-format ay hindi pinagana para sa pangalawa
subtitle. Sa panloob, ang parehong mekanismo bilang --walang-sub-ass ay ginagamit upang hubarin ang
istilo

TANDAAN:
Kung ang pangunahing subtitle stream ay naglalaman ng mga tag sa pag-format na nagpapakita ng subtitle
sa itaas ng screen, ito ay magkakapatong sa pangalawang subtitle. Upang
pigilan ito, maaari mong gamitin --walang-sub-ass upang huwag paganahin ang pag-istilo sa pangunahing subtitle
stream.

--sub-scale=<0-100>
Salik para sa laki ng font ng subtitle ng teksto (default: 1).

TANDAAN:
Nakakaapekto rin ito sa mga subtitle ng ASS, at maaaring humantong sa maling subtitle
rendering. Gamitin nang may pag-iingat, o gamitin --sub-text-font-size sa halip.

--sub-scale-by-window=
Kung susukatin ang mga subtitle gamit ang laki ng window (default: oo). Kung ito ay
hindi pinagana, ang pagbabago ng laki ng window ay hindi magbabago sa laki ng font ng subtitle.

katulad --sub-scale, maaari nitong masira ang mga subtitle ng ASS.

--sub-scale-with-window=
Gawing kaugnay ang laki ng font ng subtitle sa window, sa halip na sa video. Ito ay
kapaki-pakinabang kung gusto mo palagi ang parehong laki ng font, kahit na hindi tinatago ng video ang
ganap na window, hal dahil hindi tugma ang aspeto ng screen at aspeto ng window (at ang player
nagdaragdag ng mga itim na bar).

Default: oo.

Mali ang pangalan ng opsyong ito. Ang pagkakaiba sa nakakalito na katulad na pagpipilian sa tunog
--sub-scale-by-window ay na --sub-scale-with-window kaliskis pa rin sa
tinatayang laki ng window, habang hindi pinapagana ng ibang opsyon ang pag-scale na ito.

Nakakaapekto lamang sa mga subtitle ng plain text (o ASS kung --ass-style-override ay nakatakdang mataas
tama na).

--ass-scale-with-window=
katulad --sub-scale-with-window, ngunit nakakaapekto lamang sa mga subtitle sa ASS na format. Gaya ng
--sub-scale, maaari nitong masira ang mga subtitle ng ASS.

Default: hindi.

--naka-embed na mga font, --walang naka-embed na mga font
Gumamit ng mga font na naka-embed sa mga Matroska container file at ASS script (default: naka-enable).
Maaaring gamitin ang mga font na ito para sa pag-render ng subtitle ng SSA/ASS.

--sub-pos=<0-100>
Tukuyin ang posisyon ng mga subtitle sa screen. Ang halaga ay ang patayong posisyon
ng subtitle sa % ng taas ng screen.

TANDAAN:
Nakakaapekto rin ito sa mga subtitle ng ASS, at maaaring humantong sa maling subtitle
rendering. Gamitin nang may pag-iingat, o gamitin --sub-text-margin-y sa halip.

--sub-speed=<0.1-10.0>
I-multiply ang mga timestamp ng subtitle na kaganapan sa ibinigay na halaga. Maaaring gamitin upang ayusin ang
bilis ng pag-playback para sa mga format ng subtitle na nakabatay sa frame. Nakakaapekto lamang sa mga subtitle ng teksto.

halimbawa

--sub-speed=25/23.976` gumaganap ng mga subtitle na nakabatay sa frame na na-load
sa pag-aakalang isang framerate na 23.976 sa 25 FPS.

--ass-force-style=<[Estilo.]Param=Halaga[,...]>
I-override ang ilang mga parameter ng impormasyon ng estilo o script.

Mga halimbawa

· --ass-force-style=FontName=Arial,Default.Bold=1

· --ass-force-style=PlayResY=768

TANDAAN:
Ang paggamit sa opsyong ito ay maaaring humantong sa maling pag-render ng subtitle.

--ass-hinting=
Itakda ang uri ng pahiwatig ng font. ay maaaring maging:

wala walang pahiwatig (default)

liwanag FreeType autohinter, light mode

normal FreeType autohinter, normal na mode

katutubo font native hinter

babala

Ang pagpapagana ng pahiwatig ay maaaring humantong sa maling posisyon ng teksto (sa mga sitwasyong ito ay
dapat tumugma sa background ng video), o bawasan ang kinis ng
mga animation na may ilang script ng ASS na hindi maganda ang pagkakagawa. Inirerekomenda na huwag
gamitin ang opsyong ito, maliban kung talagang kinakailangan.

--ass-line-spacing=
Itakda ang value ng line spacing para sa SSA/ASS renderer.

--ass-shaper=
Itakda ang text layout engine na ginagamit ng libass.

simple gumagamit lamang ng Fribidi, mabilis, hindi nagre-render nang tama ng ilang wika

mahirap unawain
gumagamit ng HarfBuzz, mas mabagal, mas malawak na suporta sa wika

mahirap unawain ay ang default. Kung ang libass ay hindi pa naipon laban sa HarfBuzz, libass
tahimik na bumalik sa simple.

--ass-styles=
I-load ang lahat ng istilo ng SSA/ASS na makikita sa tinukoy na file at gamitin ang mga ito para sa pag-render ng text
mga subtitle. Ang syntax ng file ay eksaktong katulad ng [V4 Mga Estilo] / [V4+ Mga Estilo]
seksyon ng SSA/ASS.

TANDAAN:
Ang paggamit sa opsyong ito ay maaaring humantong sa maling pag-render ng subtitle.

--ass-style-override=
Kontrolin kung dapat ilapat ang mga override sa istilo ng user.

oo Ilapat ang lahat ng --ass-* mga pagpipilian sa pag-override ng istilo. Pagbabago ng default para sa alinman
sa mga opsyong ito ay maaaring humantong sa maling pag-render ng subtitle (default).

signfs gaya ng oo, ngunit mag-apply --sub-scale lamang sa mga palatandaan

hindi Mag-render ng mga subtitle bilang pinilit ng mga script ng subtitle.

pilitin Subukang pilitin ang estilo ng font gaya ng tinukoy ng --sub-text-* mga pagpipilian. Pwede
madaling masira ang rendering.

--ass-force-margin
Pinapagana ang paglalagay ng mga toptitle at subtitle sa mga itim na hangganan kapag available ang mga ito,
kung ang mga subtitle ay nasa ASS na format.

Default: hindi.

--sub-use-margin
Pinapagana ang paglalagay ng mga toptitle at subtitle sa mga itim na hangganan kapag available ang mga ito,
kung ang mga subtitle ay nasa plain text na format (o ASS kung --ass-style-override ay naka-set
sapat na mataas).

Default: oo.

Pinalitan ng pangalan mula sa --ass-use-margins. Upang maglagay din ng mga subtitle ng ASS sa mga hangganan (tulad ng
lumang opsyon), idagdag din --ass-force-margin.

--ass-vsfilter-aspect-compat=
I-stretch ang mga subtitle ng SSA/ASS kapag nagpe-play ng mga anamorphic na video para sa compatibility
tradisyonal na pag-uugali ng VSFilter. Walang epekto ang switch na ito kapag naka-store ang video
na may mga parisukat na pixel.

Ang tagapag-render na pinakakaraniwang ginagamit sa kasaysayan para sa mga format ng subtitle ng SSA/ASS,
Ang VSFilter, ay may kaduda-dudang pag-uugali na nagresulta sa pag-stretch din ng mga subtitle
kung ang video ay nakaimbak sa anamorphic na format na nangangailangan ng scaling para sa pagpapakita.
Karaniwang hindi kanais-nais ang pag-uugaling ito at maaaring kumilos ang mga mas bagong bersyon ng VSFilter
iba. Gayunpaman, maraming umiiral na mga script ang nagbabayad para sa pag-uunat ni
pagbabago ng mga bagay sa kabilang direksyon. Kaya, kung ang mga naturang script ay ipinapakita
"tama", hindi lalabas ang mga ito ayon sa nilalayon. Ang switch na ito ay nagbibigay-daan sa pagtulad ng
ang lumang pag-uugali ng VSFilter (hindi kanais-nais ngunit inaasahan ng maraming umiiral na mga script).

Pinagana bilang default.

--ass-vsfilter-blur-compat=
iskala \blur mga tag ayon sa resolusyon ng video sa halip na resolusyon ng script (pinagana ng
default). Ito ay bug sa VSFilter, na ayon sa ilan, ay hindi na maaayos pa
sa ngalan ng compatibility.

Tandaan na ginagamit nito ang aktwal na resolution ng video para sa pagkalkula ng offset scale
factor, hindi kung ano ang ginagamit ng video filter chain o ng video output.

--ass-vsfilter-color-compat=
Mangle na mga kulay tulad ng (xy-)vsfilter do (default: basic). Sa kasaysayan, ang VSFilter ay
hindi alam ang espasyo sa kulay. Ito ay walang problema hangga't ang espasyo ng kulay na ginagamit para sa SD
ginamit ang video (BT.601). Ngunit nang lumipat ang lahat sa HD (BT.709), ang VSFilter ay
Kino-convert pa rin ang mga kulay ng RGB sa BT.601, na-render ang mga ito sa video frame, at
pinangasiwaan ang frame sa output ng video, na gagamit ng BT.709 para sa conversion sa
RGB. Ang resulta ay gusot na mga kulay ng subtitle. Nang maglaon, idinagdag ang masamang hack sa itaas
ng ASS na format upang kontrolin kung paano guguluhin ang mga kulay.

pangunahing Pangasiwaan lamang ang BT.601->BT.709 mangling, kung ang mga subtitle ay tila nagpapahiwatig na
ito ay kinakailangan (default).

ganap Pangasiwaan ang buong YCbCr Matris header na may lahat ng mga puwang ng kulay ng video na sinusuportahan ng
libass at mpv. Ito ay maaaring humantong sa hindi magandang pagkasira sa mga kaso ng sulok at hindi
mahigpit na kailangan para sa pagiging tugma (sana), kaya naman hindi ito
default.

puwersa-601
Force BT.601->BT.709 mangling, anuman ang subtitle header o kulay ng video
espasyo.

hindi I-disable nang lubusan ang color mangling. Ang lahat ng mga kulay ay RGB.

Pagpili ng kahit ano maliban sa hindi gagawing nakadepende sa video ang kulay ng subtitle
color space, at halimbawa sa teorya ay hindi posibleng gumamit muli ng subtitle na script
kasama ang isa pang video file. Ang --ass-style-override ang opsyon ay hindi nakakaapekto kung paano ito
binibigyang kahulugan ang opsyon.

--stretch-dvd-subs=
I-stretch ang mga subtitle ng DVD kapag nagpe-play ng mga anamorphic na video para sa mas magandang hitsura ng mga font
hindi magandang pinagkadalubhasaan ang mga DVD. Ang switch na ito ay walang epekto kapag ang video ay nakaimbak na may parisukat
pixels - na para sa pag-input ng DVD ay hindi maaaring mangyari.

Maraming mga studio ang may posibilidad na gumamit ng mga bitmap na font na idinisenyo para sa mga square pixel kapag nag-aakda
Mga DVD, na nagiging sanhi ng hitsura ng mga font sa pag-playback sa mga DVD player. Ang pagpipiliang ito
inaayos ang mga ito, gayunpaman sa presyo ng posibleng hindi pagkakatugma ng ilang subtitle (hal. sign
mga pagsasalin).

Hindi pinagana nang default.

--stretch-image-subs-to-screen=
I-stretch ang DVD at iba pang mga subtitle ng imahe sa screen, hindi pinapansin ang mga margin ng video.
Ito ay may katulad na epekto bilang --sub-use-margin para sa mga subtitle ng teksto, maliban na ang
ang mismong teksto ay maaabot, hindi lamang muling iposisyon. (Hindi bababa sa pangkalahatan ito
ay hindi maiiwasan, dahil ang isang bitmap ng imahe ay maaaring sa teorya ay binubuo ng isang bitmap
sumasaklaw sa buong screen, at hindi malalaman ng player kung saan eksakto ang mga bahagi ng teksto
ay matatagpuan.)

Ang pagpipiliang ito ay hindi nagpapakita ng mga subtitle nang tama. Gamitin nang may pag-iingat.

Hindi pinagana nang default.

--sub-ass, --walang-sub-ass
I-render ang mga subtitle ng ASS nang native (naka-enable bilang default).

If --walang-sub-ass ay tinukoy, ang lahat ng mga tag at mga deklarasyon ng istilo ay tinanggal at
hindi pinansin sa display. Ginagamit ng tagapag-render ng subtitle ang istilo ng font gaya ng tinukoy ng
--sub-text- mga pagpipilian sa halip.

TANDAAN:
paggamit --walang-sub-ass maaaring humantong sa hindi tama o ganap na sirang pag-render ng
Mga subtitle ng ASS/SSA. Minsan ay maaaring maging kapaki-pakinabang ang puwersahang i-override ang pag-istilo
ng mga subtitle ng ASS, ngunit dapat na iwasan sa pangkalahatan.

TANDAAN:
Subukang gamitin --ass-style-override=force sa halip.

--sub-auto= , --walang-sub-auto
Mag-load ng mga karagdagang subtitle na file na tumutugma sa filename ng video. Tinutukoy ng parameter
kung paano itinutugma ang mga panlabas na subtitle na file. eksakto ay pinagana bilang default.

hindi Huwag awtomatikong i-load ang mga panlabas na subtitle na file.

eksakto I-load ang media filename na may subtitle file extension (default).

malabo I-load ang lahat ng sub na naglalaman ng media filename.

lahat I-load ang lahat ng subs sa kasalukuyang at --sub-path mga direktoryo.

--sub-codepage=
Kung sinusuportahan ng iyong system iconv(3), maaari mong gamitin ang opsyong ito upang tukuyin ang subtitle
codepage. Bilang default, gagamitin ang uchardet para hulaan ang charset. Kung hindi ang mpv
compiled with uchardet, enca ang gagamitin. Kung ang mpv ay pinagsama-sama sa alinman
uchardet o enca, UTF-8:UTF-8-BIRA ay ang default, na nangangahulugang susubukan nitong
gumamit ng UTF-8, kung hindi man ang UTF-8-BIRA pseudo codepage (tingnan sa ibaba).

Ang default na halaga para sa opsyong ito ay kotse, na ang aktwal na epekto ay nakasalalay sa kung
Ang ENCA ay pinagsama-sama.

babala

Kung pipilitin mo ang charset, kahit na ang mga subtitle na kilala bilang UTF-8 ay gagawin
ma-recode, na marahil ay hindi ang iyong inaasahan. Prefix codepages na may
utf8: kung gusto mong gamitin lang ang codepage kung hindi valid ang input
UTF-8.

Mga halimbawa

· --sub-codepage=utf8:latin2 Gamitin ang Latin 2 kung ang input ay hindi UTF-8.

· --sub-codepage=cp1250 Laging pilitin ang recoding sa cp1250.

Ang pseudo codepage UTF-8-BIRA ay ginagamit sa loob. Kapag ito ang codepage,
ang mga subtitle ay binibigyang kahulugan bilang UTF-8 na may "Latin 1" bilang fallback para sa mga byte na
hindi wastong mga sequence ng UTF-8. iconv ay hindi kailanman kasama sa mode na ito.

Kung pinagsama-sama ang player na may suporta sa ENCA, makokontrol mo ito sa mga sumusunod
syntax:

--sub-codepage=enca: : codepage>

Tinukoy ang wika gamit ang dalawang titik na code upang matulungan ang ENCA na matukoy ang codepage
awtomatiko. Kung may inilagay na di-wastong code ng wika, magrereklamo at maglilista ang mpv
wastong mga wika. (Gayunpaman, tandaan na ang listahang ito ay ipi-print lamang kapag ang
ang conversion code ay aktwal na tinatawag, halimbawa kapag naglo-load ng isang panlabas na subtitle).
Ang fallback na codepage ay ginagamit kung nabigo ang autodetection. Kung walang tinukoy na fallback,
UTF-8-BIRA Ginagamit.

Mga halimbawa

· --sub-codepage=enca:pl:cp1250 hulaan ang pag-encode, ipagpalagay na ang mga subtitle ay
Polish, bumalik sa cp1250

· --sub-codepage=enca:pl hulaan ang pag-encode para sa Polish, bumalik sa UTF-8.

· --sub-codepage=enca subukan ang universal detection, bumalik sa UTF-8.

Kung ang player ay pinagsama-sama ng suporta sa libguess, maaari mo itong gamitin sa:

--sub-codepage=hulaan: : codepage>

Ang libgues ay palaging nangangailangan ng isang wika. Walang universal detection mode. Gamitin
--sub-codepage=guess:help upang makakuha ng listahan ng mga wikang napapailalim sa parehong caveat bilang
may ENCA sa itaas.

Kung ang player ay pinagsama-sama sa suporta ng uchardet maaari mo itong gamitin sa:

--sub-codepage=uchardet

Ang mode na ito ay hindi gumagamit ng wika o fallback na codepage.

--sub-fix-timing, --no-sub-fix-timing
Bilang default, isinasaayos ang timing ng subtitle upang alisin ang mga maliliit na gaps o mga overlap sa pagitan
mga subtitle (kung ang pagkakaiba ay mas maliit sa 210 ms, ang gap o overlap ay
inalis).

--sub-forced-only
Magpakita lamang ng mga sapilitang subtitle para sa DVD subtitle stream na pinili ng hal
--balbal.

--sub-fps=
Tukuyin ang framerate ng subtitle file (default: video fps). Nakakaapekto sa text
mga subtitle lang.

TANDAAN:
> pinapabilis ng video fps ang mga subtitle para sa mga frame-based na subtitle file at
pinapabagal ang mga ito para sa mga nakabatay sa oras.

Tingnan din --sub-bilis pagpipilian.

--sub-gauss=<0.0-3.0>
Ilapat ang Gaussian blur sa mga subtitle ng larawan (default: 0). Makakatulong ito sa paggawa ng pixelated
Mas maganda ang hitsura ng DVD/Vobsubs. Ang isang halaga maliban sa 0 ay lilipat din sa subtitle ng software
scaling. Baka mabagal.

TANDAAN:
Hindi kailanman inilapat sa mga subtitle ng teksto.

--sub-gray
I-convert ang mga subtitle ng larawan sa grayscale. Makakatulong sa paggawa ng dilaw na DVD/Vobsubs
nicer.

TANDAAN:
Hindi kailanman inilapat sa mga subtitle ng teksto.

--sub-paths=
Tukuyin ang mga karagdagang direktoryo upang maghanap ng mga subtitle na tumutugma sa video. Maramihan
ang mga direktoryo ay maaaring paghiwalayin ng ":" (";" sa Windows). Ang mga landas ay maaaring maging kamag-anak o
ganap. Ang mga kaugnay na landas ay binibigyang-kahulugan na nauugnay sa direktoryo ng video file.

halimbawa

Ipagpalagay na /path/to/video/video.avi ay nilalaro at
--sub-paths=sub:subtitles:/tmp/subs ay tinukoy, hinahanap ng mpv ang
mga subtitle na file sa mga direktoryo na ito:

· /path/to/video/

· /path/to/video/sub/

· /path/to/video/subtitles/

· /tmp/subs/

· ang sub configuration subdirectory (karaniwan ~/.config/mpv/sub/)

--sub-visibility, --no-sub-visibility
Maaaring gamitin upang huwag paganahin ang pagpapakita ng mga subtitle, ngunit piliin at i-decode pa rin ang mga ito.

--sub-clear-on-seek
(Malabo, bihirang kapaki-pakinabang.) Maaaring gamitin upang i-play ang mga sirang mkv file na may duplicate
Mga field ng ReadOrder. Ang ReadOrder ay ang unang field sa isang Matroska-style ASS subtitle
mga pakete. Dapat itong natatangi, at ginagamit ito ng libass para sa mabilis na pag-aalis ng
mga duplicate. Hindi pinapagana ng opsyong ito ang pag-cache ng mga subtitle sa mga paghahanap, kaya pagkatapos ng paghahanap
Hindi maalis ng libass ang mga subtitle packet na may parehong ReadOrder gaya ng mga naunang packet.

Bintana
--title=
Itakda ang pamagat ng window. Ito ay ginagamit para sa window ng video, at kung maaari, ay nagtatakda din
ang pamagat ng audio stream.

Pinalawak ang mga ari-arian. (Tingnan Ari-arian Paglawak.)

BABALA:
May panganib na magdulot ito ng makabuluhang paggamit ng CPU, depende sa
mga katangiang ginamit. Ang pagpapalit ng pamagat ng window ay kadalasang isang mabagal na operasyon, at kung ang
Ang pamagat ay nagbabago sa bawat frame, ang pag-playback ay maaaring masira.

--screen=
Sa mga pagsasaayos ng multi-monitor (ibig sabihin, isang desktop na sumasaklaw sa maramihang
ipinapakita), ang opsyong ito ay nagsasabi sa mpv kung saang screen ipapakita ang video.

Tandaan (X11)

Hindi gumagana nang maayos ang opsyong ito sa lahat ng window manager. Sa mga ito
kaso, maaari mong subukang gamitin --geometry upang malinaw na iposisyon ang bintana.
Posible rin na ang window manager ay nagbibigay ng mga katutubong tampok sa
kontrolin kung aling mga screen ang dapat gamitin ng mga window ng application.

Tingnan din --fs-screen.

--fullscreen, --fs
Fullscreen playback.

--fs-screen=
Sa mga pagsasaayos ng multi-monitor (ibig sabihin, isang desktop na sumasaklaw sa maramihang
ipinapakita), ang opsyong ito ay nagsasabi sa mpv kung saang screen pupunta ang fullscreen. Kung default is
sa kondisyon na ang mpv ay magbabalik sa paggamit ng pag-uugali depende sa kung ano ang gumagamit
binigay ng tabing pagpipilian.

Tandaan (X11)

Ang pagpipiliang ito ay gumagana nang maayos lamang sa mga tagapamahala ng window na
maunawaan ang EWMH _NET_WM_FULLSCREEN_MONITORS pahiwatig

Tandaan (OS X)

lahat ay hindi gumagana sa OS X at magiging tulad ng kasalukuyan.

Tingnan din --screen.

--fs-black-out-screens
OS X lang. I-black out ang iba pang mga display kapag fullscreen.

--keep-open=
Huwag wakasan kapag naglalaro o naghahanap ng higit sa dulo ng file, at mayroon
hindi susunod na file na ipe-play (at --loop ay hindi ginagamit). Sa halip, i-pause ang player.
Kapag sinusubukang maghanap sa kabila ng dulo ng file, susubukan ng player na hanapin ang
huling frame.

Ang mga sumusunod na argumento ay maaaring ibigay:

hindi Kung magtatapos ang kasalukuyang file, pumunta sa susunod na file o wakasan. (Default.)

oo Huwag wakasan kung ang kasalukuyang file ay ang huling entry sa playlist. Katumbas
sa --panatilihing-bukas walang argumento.

palagi katulad oo, ngunit nalalapat din sa mga file bago ang huling entry sa playlist. Ito
nangangahulugan na ang pag-playback ay hindi kailanman awtomatikong uusad sa susunod na file.

TANDAAN:
Ang pagpipiliang ito ay hindi iginagalang kapag ginagamit --mga frame. Tahasang lumalaktaw sa
susunod na file kung gumagamit ang binding pilitin tatapusin din ang pag-playback.

Gayundin, kung mangyari ang mga pagkakamali o hindi pangkaraniwang pangyayari, maaari pa ring umalis ang manlalaro.

Dahil mpv 0.6.0, hindi ito humihinto kung may susunod na file sa playlist, o ang
ang playlist ay naka-loop. Tinatayang, ito ay magpo-pause kapag ang player ay normal
exit, ngunit sa pagsasanay may mga kaso sa sulok kung saan hindi ito ang kaso (hal
mpv --panatilihing-bukas file.mkv / dev / null ay magpe-play ng file.mkv nang normal, pagkatapos ay mabibigong buksan
/ dev / null, pagkatapos ay lumabas). (Sa mpv 0.8.0, palagi ay ipinakilala, na nagpapanumbalik ng dati
pag-uugali.)

--force-window=
Gumawa ng video output window kahit na walang video. Ito ay maaaring maging kapaki-pakinabang kapag
pagpapanggap na ang mpv ay isang GUI application. Sa kasalukuyan, laging may sukat ang bintana
640x480, at napapailalim sa --geometry, --autofit, at mga katulad na opsyon.

BABALA:
Ang window ay nilikha lamang pagkatapos ng pagsisimula (upang matiyak na ang default na window
gumagana pa rin ang placement kung iba ang laki ng video sa --force-window
default na laki ng window). Maaari itong maging problema kung hindi gagana ang pagsisimula
perpekto, tulad ng kapag nagbubukas ng mga URL na may masamang koneksyon sa network, o pagbubukas
sirang mga video file. Ang Kagyat mode ay maaaring gamitin upang lumikha ng window palagi
sa pagsisimula ng programa, ngunit maaaring magdulot ito ng iba pang mga isyu.

--sa taas
Ginagawang manatili ang window ng player sa ibabaw ng iba pang mga bintana.

Sa Windows, kung pinagsama sa fullscreen mode, nagiging sanhi ito ng mpv na tratuhin bilang
eksklusibong fullscreen na window na lumalampas sa Desktop Window Manager.

--hangganan, --walang hanggan
Mag-play ng video na may window border at mga dekorasyon. Dahil naka-on ito bilang default, gamitin
--walang hanggan upang huwag paganahin ang karaniwang mga dekorasyon sa bintana.

--sa-lahat-ng-workspace
(X11 lang) Ipakita ang video window sa lahat ng virtual desktop.

--geometry=<[W[xH]][+-x+-y]>, --geometry=
Ayusin ang paunang posisyon o laki ng window. W at H itakda ang laki ng window sa mga pixel.
x at y itakda ang posisyon ng window, na sinusukat sa mga pixel mula sa kaliwang sulok sa itaas ng
screen sa kaliwang sulok sa itaas ng larawang ipinapakita. Kung porsyento ang tanda
(%) ay ibinigay pagkatapos ng argumento, ginagawa nitong porsyento ng screen ang halaga
laki sa direksyong iyon. Ang mga posisyon ay tinukoy na katulad ng karaniwang X11
--geometry format ng opsyon, kung saan ang ibig sabihin ng +10-50 ay "ilagay ang 10 pixels mula sa kaliwa
border at 50 pixels mula sa lower border" at "--20+-10" ay nangangahulugang "place 20 pixels
lampas sa kanan at 10 pixel na lampas sa tuktok na hangganan".

Kung ang isang panlabas na window ay tinukoy gamit ang --wid opsyon, binabalewala ang opsyong ito.

Ang mga coordinate ay nauugnay sa screen na ibinigay sa --screen para sa output ng video
mga driver na ganap na sumusuporta --screen.

TANDAAN:
Sa pangkalahatan ay sinusuportahan lamang ng mga GUI VO. Binalewala para sa pag-encode.

Tandaan (X11)

Hindi gumagana nang maayos ang opsyong ito sa lahat ng window manager.

Mga halimbawa

50:40 Inilalagay ang window sa x=50, y=40.

50%: 50%
Inilalagay ang window sa gitna ng screen.

100%: 100%
Inilalagay ang window sa kanang sulok sa ibaba ng screen.

50% Itinatakda ang lapad ng window sa kalahati ng lapad ng screen. Ang taas ng bintana ay nakatakda sa gayon
na ang window ay may video aspect ratio.

50%x50%
Pinipilit ang lapad at taas ng window sa kalahati ng lapad at taas ng screen.
Magpapakita ng mga itim na hangganan upang mabayaran ang rasyon ng aspeto ng video (na may
karamihan sa mga VO at wala --walang-keepaspect).

50%+10+10
Itinatakda ang window sa kalahati ng mga lapad ng screen, at inilalagay ito sa 10 pixels
sa ibaba/kaliwa ng kaliwang sulok sa itaas ng screen.

Tingnan din --autofit at --autofit-mas malaki para sa pag-angkop ng bintana sa isang ibinigay na laki
nang hindi binabago ang aspect ratio.

--autofit=<[W[xH]]>
Itakda ang paunang laki ng window sa isang maximum na laki na tinukoy ni WxH, nang hindi nagbabago
aspect ratio ng window. Ang laki ay sinusukat sa mga pixel, o kung ang isang numero ay
sinusundan ng isang tanda ng porsyento (%), sa mga porsyento ng laki ng screen.

Hindi kailanman binabago ng opsyong ito ang aspect ratio ng window. Kung ang aspect ratio
hindi tugma, binabawasan ang laki ng window hanggang sa magkasya ito sa tinukoy na laki.

Ang posisyon ng bintana ay hindi isinasaalang-alang, at hindi rin binago ng opsyong ito (ang
ang window manager ay maaari pa ring maglagay ng window nang iba depende sa laki). Gamitin
--geometry upang baguhin ang posisyon ng bintana. Ang mga epekto nito ay inilapat pagkatapos nito
pagpipilian.

Tingnan --geometry para sa mga detalye kung paano ito pinangangasiwaan gamit ang mga multi-monitor setup.

paggamit --autofit-mas malaki sa halip kung gusto mo lang limitahan ang maximum na laki ng
window, sa halip na palaging pilitin ang laki ng window.

paggamit --geometry kung gusto mong pilitin ang parehong lapad at taas ng window sa isang tiyak
laki.

TANDAAN:
Sa pangkalahatan ay sinusuportahan lamang ng mga GUI VO. Binalewala para sa pag-encode.

Mga halimbawa

70% Gawing 70% ng laki ng screen ang lapad ng window, na pinapanatili ang aspect ratio.

1000 Itakda ang lapad ng window sa 1000 pixels, pinapanatili ang aspect ratio.

70%: 60%
Gawing mas malaki ang bintana hangga't maaari, nang hindi lalampas sa 70% ng
lapad ng screen, o mas mataas sa 60% ng taas ng screen.

--autofit-larger=<[W[xH]]>
Ang pagpipiliang ito ay kumikilos nang eksakto tulad ng --autofit, maliban sa laki ng window ay binago lamang
kung mas malaki ang window kaysa sa tinukoy na laki.

halimbawa

90%x80%
Kung ang video ay mas malaki sa 90% ng lapad ng screen o 80% ng screen
taas, gawing mas maliit ang bintana hanggang sa alinman sa lapad nito ay 90% ng
screen, o ang taas nito ay 80% ng screen.

--autofit-smaller=<[W[xH]]>
Ang pagpipiliang ito ay kumikilos nang eksakto tulad ng --autofit, maliban na itinatakda nito ang pinakamababang laki ng
ang bintana (tulad ng --autofit-mas malaki nagtatakda ng maximum).

halimbawa

500x500
Gawing hindi bababa sa 500 pixels ang lapad ng window at 500 pixels ang taas (depende
sa aspect ratio ng video, ang lapad o taas ay magiging mas malaki sa 500 in
upang panatilihing pareho ang aspect ratio).

--window-scale=
Baguhin ang laki ng video window sa maramihang (o fraction) ng laki ng video. Ang pagpipiliang ito
ay inilapat dati --autofit at iba pang mga opsyon ang inilapat (kaya i-override nila ito
pagpipilian).

Halimbawa, --window-scale=0.5 ipapakita ang window sa kalahati ng laki ng video.

--cursor-autohide=
Gawing awtomatikong itago ang cursor ng mouse pagkatapos ng ibinigay na bilang ng mga millisecond. hindi habilin
huwag paganahin ang autohide ng cursor. palagi nangangahulugan na ang cursor ay mananatiling nakatago.

--cursor-autohide-fs-only
Kung ibinigay ang opsyong ito, palaging makikita ang cursor sa windowed mode. Sa
fullscreen mode, ang cursor ay ipinapakita o nakatago ayon sa --cursor-autohide.

--no-fixed-vo, --fixed-vo
--no-fixed-vo nagpapatupad ng pagsasara at muling pagbubukas ng video window para sa maraming file
(isang (un)initialization para sa bawat file).

--force-rgba-osd-rendering
Baguhin kung paano i-render ng ilang video output ang OSD at mga text subtitle. Ito ay hindi
baguhin ang hitsura ng mga subtitle at mayroon lamang mga implikasyon sa pagganap. Para sa mga VO
na sumusuporta sa katutubong pag-render ng ASS (tulad ng vdpau, openl, direct3d), ito ay maaaring
bahagyang mas mabilis o mas mabagal, depende sa mga driver at hardware ng GPU. Para sa iba pang mga VO,
pinapabagal lang nito ang pag-render.

--force-window-position
Pilit na ilipat ang window ng output ng video ng mpv sa default na lokasyon tuwing mayroong a
pagbabago sa mga parameter ng video, stream ng video o file. Ito ang dating default
pag-uugali. Sa kasalukuyan ay nakakaapekto lamang sa mga X11 VO.

--pintig ng puso-cmd=
Ang utos na isinasagawa bawat 30 segundo sa panahon ng pag-playback sa pamamagitan ng sistema() - ibig sabihin gamit
ang shell. Ang oras sa pagitan ng mga utos ay maaaring ipasadya gamit ang
--heartbeat-interval opsyon. Hindi pinapatakbo ang command habang naka-pause ang playback.

TANDAAN:
Ginagamit ng mpv ang utos na ito nang walang anumang pagsusuri. Responsibilidad mong tiyakin
hindi ito nagdudulot ng mga problema sa seguridad (hal. siguraduhing gumamit ng mga buong path kung "." ay
sa iyong landas tulad ng sa Windows). Gumagana lang din ito kapag nagpe-play ng video (ibig sabihin, hindi
sa --walang-video ngunit gumagana sa -vo=null).

Maaari itong "maling gamitin" upang i-disable ang mga screensaver na hindi sumusuporta sa wastong X API
(Tingnan din --stop-screensaver). Kung sa tingin mo ito ay masyadong kumplikado, tanungin ang may-akda
ng screensaver program upang suportahan ang mga wastong X API. Tandaan na ang
--stop-screensaver hindi talaga nakakaimpluwensya sa heartbeat code.

Halimbawa para sa xscreensaver

mpv --heartbeat-cmd="xscreensaver-command -deactivate" file

Halimbawa para sa GNOME screensaver

mpv --heartbeat-cmd="gnome-screensaver-command -p" file

--heartbeat-interval=
Oras sa pagitan --pintig ng puso-cmd mga invocation sa ilang segundo (default: 30).

TANDAAN:
Hindi ito nakakaapekto sa normal na pagpapatakbo ng screensaver sa anumang paraan.

--walang-ingatan, --keepaspect
--walang-keepaspect ay palaging iuunat ang video sa laki ng window, at idi-disable ang
mga pahiwatig ng window manager na pinipilit ang window aspect ratio. (Hindi pinansin sa fullscreen
mode.)

--no-keepaspect-window, --keepaspect-window
--keepaspect-window (ang default) ay ila-lock ang laki ng window sa aspeto ng video.
--walang-keepaspect-window hindi pinapagana ang gawi na ito, at sa halip ay magdagdag ng mga itim na bar kung
aspeto ng window at hindi pagkakatugma ng aspeto ng video. Kung talagang gumagana ito ay depende sa
VO backend. (Balewalain sa fullscreen mode.)

--monitoraspect=
Itakda ang aspect ratio ng iyong monitor o TV screen. Ang isang halaga ng 0 ay hindi pinapagana ang isang nakaraan
setting (hal. sa config file). Ino-override ang --monitorpixelaspect pagtatakda kung
pinagana.

Tingnan din --monitorpixelaspect at --video-aspect.

Mga halimbawa

· --monitoraspect=4:3 or --monitoraspect=1.3333

· --monitoraspect=16:9 or --monitoraspect=1.7777

--monitorpixelaspect=
Itakda ang aspeto ng isang pixel ng iyong monitor o TV screen (default: 1). Isang halaga
ng 1 ay nangangahulugan ng mga square pixel (tama para sa (halos?) lahat ng LCD). Tingnan din --monitoraspect
at --video-aspect.

--stop-screensaver, --walang-stop-screensaver
Ino-off ang screensaver (o screen blanker at mga katulad na mekanismo) sa pagsisimula at
ino-on itong muli sa paglabas (default: oo). Ang screensaver ay palaging muling pinapagana kapag
naka-pause ang player.

Hindi ito sinusuportahan sa lahat ng video output o platform. Minsan nga eh
ipinatupad, ngunit hindi gumagana (madalas na nangyayari sa GNOME). Baka kaya mo
gawin ito sa paligid gamit --pintig ng puso-cmd sa halip.

--wid=
Ito ay nagsasabi sa mpv na i-attach sa isang umiiral na window. Kung napili ang isang VO na sumusuporta
ang pagpipiliang ito, gagamitin nito ang window na iyon para sa output ng video. I-scale ng mpv ang video sa
ang laki ng window na ito, at magdaragdag ng mga itim na bar upang mabayaran kung ang aspect ratio
iba ang video.

Sa X11, ang ID ay binibigyang kahulugan bilang a Bintana sa X11. Hindi tulad ng MPlayer/mplayer2, mpv
palaging gumagawa ng sarili nitong window, at itinatakda ang wid window bilang magulang. Ang bintana ay
palaging i-resize upang ganap na masakop ang parent window. Ang halaga 0 ay binibigyang kahulugan
lalo na, at ang mpv ay direktang gumuhit sa root window.

Sa win32, ang ID ay binibigyang kahulugan bilang HWND. Ipasa ito bilang value cast sa inpttr_t. mpv
gagawa ng sarili nitong window, at itatakda ang wid window bilang magulang, tulad ng sa X11.

Sa OSX/Cocoa, ang ID ay binibigyang kahulugan bilang NSView*. Ipasa ito bilang value cast sa inpttr_t.
Ang mpv ay gagawa ng sarili nitong sub-view. Dahil hindi sinusuportahan ng OSX ang window embed ng
mga banyagang proseso, ito ay gumagana lamang sa libmpv, at mag-crash kapag ginamit mula sa
command line.

--walang-window-drag
Huwag ilipat ang window kapag nag-click dito at ginagalaw ang pointer ng mouse.

--x11-pangalan
Itakda ang window class name para sa X11-based na video output method.

--x11-netwm=
(X11 lang) Kontrolin ang paggamit ng mga feature ng NetWM protocol.

Ito ay maaaring makatulong o hindi sa mga sirang window manager. Nagbibigay ito ng ilan
functionality na ipinatupad ng inalis na ngayon --fstype opsyon. sa totoo lang,
hindi alam ng mga developer kung hanggang saan kailangan ang opsyong ito, kaya
ang feedback ay malugod na tinatanggap.

Sa partikular, oo pipilitin ang paggamit ng NetWM fullscreen na suporta, kahit na hindi
ini-advertise ng WM. Maaari itong maging kapaki-pakinabang para sa mga WM na sinasadyang sirain, tulad ng
XMonad. (Ang XMonad diumano ay hindi nag-a-advertise ng fullscreen na suporta, dahil gumagamit ang Flash
ito. Tila, ang mga application na gustong gumamit ng fullscreen ay dapat pa rin
huwag pansinin ang mga pahiwatig ng suporta sa NetWM, o magbigay ng isang solusyon. Nakakahiya sa XMonad
sadyang sinira ang mga protocol ng X (parang ang X ay hindi pa sapat na masama).

Bilang default, ang suporta sa NetWM ay autodetected (kotse).

Maaaring alisin ang opsyong ito sa hinaharap.

--x11-bypass-compositor=
Kung itakda sa oo (default), pagkatapos ay hilingin sa kompositor na i-unredirect ang mpv window. Ito
ay gumagamit ng _NET_WM_BYPASS_COMPOSITOR pahiwatig

Disko Aparato
--cdrom-device=
Tukuyin ang CD-ROM device (default: /dev/cdrom).

--dvd-device=
Tukuyin ang DVD device o .iso filename (default: /dev/dvd). Maaari mo ring tukuyin ang a
direktoryo na naglalaman ng mga file na dati nang kinopya nang direkta mula sa isang DVD (na may hal
vobcopy).

halimbawa

mpv dvd:// --dvd-device=/path/to/dvd/

--bluray-device=
(Blu-ray lang) Tukuyin ang lokasyon ng Blu-ray disc. Dapat ay isang direktoryo na may Blu-ray
istraktura.

halimbawa

mpv bd:// --bluray-device=/path/to/bd/

--bluray-angle=
Ang ilang mga Blu-ray disc ay naglalaman ng mga eksena na maaaring tingnan mula sa maraming anggulo. Ito
ang opsyon ay nagsasabi sa mpv kung aling anggulo ang gagamitin (default: 1).

--cdda-...
Magagamit ang mga opsyong ito para ibagay ang feature ng pagbabasa ng CD Audio ng mpv.

--cdda-bilis=
Itakda ang bilis ng pag-ikot ng CD.

--cdda-paranoia=<0-2>
Itakda ang antas ng paranoya. Ang mga halaga maliban sa 0 ay tila sinisira ang pag-playback ng anuman maliban sa
unang track.

0 huwag paganahin ang pagsuri (default)

1 overlap checking lang

2 buong pagwawasto at pag-verify ng data

--cdda-sector-size=
Itakda ang atomic read size.

--cdda-overlap=
Pilitin ang pinakamababang overlap na paghahanap sa panahon ng pag-verify sa mga sektor.

--cdda-toc-bias
Ipagpalagay na ang simulang offset ng track 1 gaya ng iniulat sa TOC ay magiging
tinutugunan bilang LBA 0. Kailangan ito ng ilang mga disc para makuha nang tama ang mga hangganan ng track.

--cdda-toc-offset=
Idagdag sektor sa mga halagang iniulat kapag tinutugunan ang mga track. Maaaring
negatibo.

--cdda-skip=
(Huwag kailanman) tanggapin ang hindi perpektong pagbabagong-tatag ng data.

--cdda-cdtext=
Mag-print ng CD text. Ito ay hindi pinagana bilang default, dahil sinisira nito ang pagganap sa
Mga CD-ROM drive para sa hindi kilalang dahilan.

--dvd-speed=
Subukang limitahan ang bilis ng DVD (default: 0, walang pagbabago). Ang bilis ng base ng DVD ay 1385 kB/s, kaya isang
Maaaring magbasa ang 8x drive sa bilis na hanggang 11080 kB/s. Ang mas mabagal na bilis ay ginagawang higit ang pagmamaneho
tahimik. Para sa panonood ng mga DVD, 2700 kB/s ay dapat na tahimik at sapat na mabilis. Nire-reset ng mpv ang
bilis sa default na halaga ng drive sa pagsasara. Mga value na hindi bababa sa 100 mean speed in
kB/s. Ang mga halagang mas mababa sa 100 ay nangangahulugan ng mga multiple ng 1385 kB/s, ibig sabihin --dvd-speed=8 pipili
11080 kB/s.

TANDAAN:
Kailangan mo ng write access sa DVD device para baguhin ang bilis.

--dvd-angle=
Ang ilang mga DVD ay naglalaman ng mga eksena na maaaring matingnan mula sa maraming anggulo. Ang pagpipiliang ito
nagsasabi sa mpv kung aling anggulo ang gagamitin (default: 1).

Pangbalanse
--liwanag=<-100-100>
Ayusin ang liwanag ng signal ng video (default: 0). Hindi sinusuportahan ng lahat ng video
mga driver ng output.

--contrast=<-100-100>
Ayusin ang contrast ng signal ng video (default: 0). Hindi sinusuportahan ng lahat ng video
mga driver ng output.

--saturation=<-100-100>
Ayusin ang saturation ng signal ng video (default: 0). Maaari kang makakuha ng grayscale
output gamit ang pagpipiliang ito. Hindi sinusuportahan ng lahat ng mga driver ng output ng video.

--gamma=<-100-100>
Ayusin ang gamma ng signal ng video (default: 0). Hindi sinusuportahan ng lahat ng video
mga driver ng output.

--kulay=<-100-100>
Ayusin ang kulay ng signal ng video (default: 0). Maaari kang makakuha ng may kulay na negatibo ng
ang larawang may ganitong opsyon. Hindi sinusuportahan ng lahat ng mga driver ng output ng video.

Demuxer
--demuxer=<[+]pangalan>
Force demuxer type. Gumamit ng '+' bago ang pangalan upang pilitin ito; ito ay laktawan ang ilan
mga tseke. Ibigay ang pangalan ng demuxer bilang naka-print ni --demuxer=tulong.

--demuxer-lavf-analyzeduration=
Pinakamataas na haba sa mga segundo upang suriin ang mga katangian ng stream.

--demuxer-lavf-probescore=<1-100>
Minimum na kinakailangang libavformat probe score. Ang mas mababang mga halaga ay mangangailangan ng mas kaunting data
na-load (ginagawa ang mga stream na magsimula nang mas mabilis), ngunit ginagawang hindi gaanong maaasahan ang pagtukoy sa format ng file.
Maaaring gamitin upang pilitin ang mga awtomatikong natukoy na libavformat demuxer, kahit na libavformat
isinasaalang-alang ang pagtuklas na hindi sapat na maaasahan. (Default: 26.)

--demuxer-lavf-allow-mimetype=
Payagan ang pagkuha ng format mula sa uri ng HTTP MIME (default: oo). Itakda ito sa no in
Ang paglalaro ng mga bagay mula sa HTTP ay misteryosong nabigo, kahit na gumagana ang parehong mga file
mula sa lokal na disk.

Ito ay default upang mabawasan ang latency kapag nagbubukas ng mga stream ng HTTP.

--demuxer-lavf-format=
Pilitin ang isang partikular na libavformat demuxer.

--demuxer-lavf-hacks=
Bilang default, ang ilang mga format ay hahawakan nang iba sa iba pang mga format ng
tahasang sinusuri ang mga ito. Karamihan sa mga ito ay nagbabayad para sa kakaiba o hindi perpekto
pag-uugali mula sa libavformat demuxers. pagpasa hindi hindi pinapagana ang mga ito. Para sa pag-debug at
pagsubok lamang.

--demuxer-lavf-genpts-mode=
Mode para sa pagkuha ng nawawalang packet PTS values ​​mula sa packet DTS. lavf Binibigyang-daan
libavformat's mga genpt pagpipilian. hindi dini-disable ito. Ito ay dating pinagana bilang default,
ngunit pagkatapos ay itinuring na hindi na kailangan. Maaaring makatulong ang pagpapagana nito
mga problema sa timestamp, o palalalain ang mga ito.

--demuxer-lavf-o= = [, = [,...]]
Ipasa ang AVOptions sa libavformat demuxer.

Tandaan, isang patch para gawin ang o= hindi kailangan at ipasa ang lahat ng hindi kilalang mga opsyon sa pamamagitan ng
Malugod na tinatanggap ang sistema ng AVOption. Ang isang buong listahan ng AVOptions ay matatagpuan sa FFmpeg
manwal. Tandaan na ang ilang mga opsyon ay maaaring sumalungat sa mga opsyon sa mpv.

halimbawa

--demuxer-lavf-o=fflags=+ignidx

--demuxer-lavf-probesize=
Pinakamataas na dami ng data na susuriin sa yugto ng pagtuklas. Sa kaso ng MPEG-TS
tinutukoy ng value na ito ang maximum na bilang ng mga TS packet na ii-scan.

--demuxer-lavf-buffersize=
Laki ng stream read buffer na inilaan para sa libavformat sa bytes (default: 32768).
Ang pagpapababa sa laki ay maaaring magpababa ng latency. Tandaan na maaaring i-relocate ng libavformat ang
buffer sa loob, o hindi ganap na gamitin ang lahat ng ito.

--demuxer-lavf-cryptokey=
Encryption key na dapat gamitin ng demuxer. Ito ang raw binary data ng susi
na-convert sa isang hexadecimal string.

--demuxer-mkv-subtitle-preroll, --mkv-subtitle-preroll
Subukang mas mabuti na magpakita ng mga naka-embed na malambot na subtitle kapag naghahanap sa isang lugar. Normally, pwede
mangyari na ang subtitle sa seek target ay hindi ipinapakita dahil sa kung paano ang ilang lalagyan
idinisenyo ang mga format ng file. Ang mga subtitle ay lilitaw lamang kung naghahanap bago o eksakto
sa posisyon na unang lalabas ang isang subtitle. Upang mapalala ito, madalas ang mga subtitle
nag-time na lumabas ng napakaliit na halaga bago ang nauugnay na video frame, kaya't
ang paghahanap sa video frame ay karaniwang hindi nagde-demux ng subtitle sa posisyong iyon.

Kapag na-enable ang opsyong ito, ang demuxer ay nagsimulang magbasa ng data nang kaunti bago ang paghahanap
target, para lumabas nang tama ang mga subtitle. Tandaan na ginagawa nitong mas mabagal ang paghahanap,
at hindi garantisadong palaging gagana. Gumagana lang ito kung malapit lang ang subtitle
sa hinahanap na target.

Gumagana lamang sa panloob na Matroska demuxer. Palaging pinagana para sa ganap at
hr-seeks, at binabago ng opsyong ito ang gawi na may relative o imprecise seeks lang.

Maaari mong gamitin ang --demuxer-mkv-subtitle-preroll-secs opsyon upang tukuyin kung gaano karaming data
ang demuxer ay dapat na paunang magbasa nang higit pa upang mahanap ang mga subtitle packet na maaaring
magkakapatong. Ang pagtatakda nito sa 0 ay epektibong madi-disable ang preroll na mekanismong ito. Setting
ang isang napakalaking halaga ay maaaring maging napakabagal sa paghahanap, at ang isang napakalaking halaga ay gagawin
ganap na muling basahin ang buong file mula sa simula hanggang sa paghahanap ng target sa bawat paghahanap
ay maaaring maging mas mabagal sa dulo ng file. Ang mga detalye ay magulo, at ang halaga
ay talagang naka-round down sa cluster na may nakaraang video keyframe.

May impormasyon ang ilang file, lalo na ang mga file na may mas bagong bersyon ng mkvmerge
naka-embed na maaaring magamit upang matukoy kung anong mga subtitle packet ang magkakapatong sa isang paghahanap
target. Sa mga kasong ito, babawasan ng mpv ang dami ng data na nabasa sa pinakamababa.
(Bagaman mababasa pa rin ito lahat data sa pagitan ng cluster na naglalaman ng una
gustong subtitle packet, at ang target na hanapin.)

Tingnan din --hr-seek-demuxer-offset opsyon. Ang pagpipiliang ito ay maaaring makamit ang isang katulad na epekto,
ngunit kung aktibo lamang ang hr-seek. Gumagana ito sa anumang demuxer, ngunit gumagawa ng maraming paghahanap
mas mabagal, dahil kailangan nitong i-decode ang data ng audio at video sa halip na laktawan lang ito.

--mkv-subtitle-preroll ay isang hindi na ginagamit na alyas.

--demuxer-mkv-subtitle-preroll-secs=
Tingnan --demuxer-mkv-subtitle-preroll.

--demuxer-mkv-probe-video-duration=
Kapag binubuksan ang file, hanapin hanggang sa dulo nito, at tingnan kung anong timestamp ang huli
video packet ay mayroon, at iulat iyon bilang tagal ng file. Ito ay para lamang sa
compatibility sa Haali lang. Sa mode na ito, posibleng ang pagbubukas ay
mas mabagal (lalo na kapag nagpe-play sa http), o ang gawi na may mga sirang file ay
mas masahol pa. Kaya huwag gamitin ang opsyong ito.

Ang oo ginagamit lang ng mode ang index at nagbabasa ng maliit na bilang ng mga bloke mula sa dulo
ng file. Ang ganap ang mode ay talagang binabagtas ang buong file at maaaring gumawa ng a
maaasahang pagtatantya kahit na walang index (tulad ng mga bahagyang file).

--demuxer-rawaudio-channels=
Bilang ng mga channel (o layout ng channel) kung --demuxer=rawaudio ay ginagamit (default:
stereo).

--demuxer-rawaudio-format=
Sample na format para sa --demuxer=rawaudio (default: s16le). Gamitin
--demuxer-rawaudio-format=help para makakuha ng listahan ng lahat ng format.

--demuxer-rawaudio-rate=
Sample rate para sa --demuxer=rawaudio (default: 44 kHz).

--demuxer-rawvideo-fps=
Rate sa mga frame bawat segundo para sa --demuxer=rawvideo (default: 25.0).

--demuxer-rawvideo-w= , --demuxer-rawvideo-h=
Dimensyon ng larawan sa mga pixel para sa --demuxer=rawvideo.

halimbawa

Magpatugtog ng hilaw na sample ng YUV:

mpv sample-720x576.yuv --demuxer=rawvideo
--demuxer-rawvideo-w=720 --demuxer-rawvideo-h=576

--demuxer-rawvideo-format=
Color space (fourcc) sa hex o string para sa --demuxer=rawvideo (default: YV12).

--demuxer-rawvideo-mp-format=
Kulay ng espasyo ayon sa panloob na format ng video para sa --demuxer=rawvideo. Gamitin
--demuxer-rawvideo-mp-format=help para sa isang listahan ng mga posibleng format.

--demuxer-rawvideo-codec=
Itakda ang video codec sa halip na piliin ang rawvideo codec kapag ginagamit
--demuxer=rawvideo. Gumagamit ito ng parehong mga halaga tulad ng mga pangalan ng codec sa --vd (ngunit ito ay
hindi tumatanggap ng mga pangalan ng decoder).

--demuxer-rawvideo-size=
Laki ng frame sa mga byte kapag ginagamit --demuxer=rawvideo.

--demuxer-max-packet= , --demuxer-max-bytes=
Kinokontrol nito kung gaano kalaki ang pinapayagang mag-buffer nang maaga ang demuxer. Ang demuxer ay
karaniwang subukang magbasa nang maaga hangga't kinakailangan, o kung gaano karami ang hinihiling
--demuxer-readahead-seg. ang --demuxer-max-... ang mga opsyon ay maaaring gamitin upang paghigpitan
ang maximum readahead. Nililimitahan nito ang labis na pagbabasa sa kaso ng mga sirang file o
na-desync ang pag-playback. Ihihinto ng demuxer ang pagbabasa ng mga karagdagang packet sa sandaling isa
ng mga limitasyon ay naabot. (Ang mga limitasyon ay maaari pa ring bahagyang lumampas dahil sa
teknikal na dahilan.)

Itakda ang mga limitasyong ito nang mas mataas kung makakakuha ka ng packet queue overflow warning, at sa tingin mo
ang normal na pag-playback ay magiging posible sa mas malaking packet queue.

Tingnan --listahan-mga opsyon para sa mga default at hanay ng halaga.

--demuxer-thread=
Patakbuhin ang demuxer sa isang hiwalay na thread, at hayaan itong mag-prefetch ng isang tiyak na halaga ng
mga packet (default: oo). Ang pagkakaroon nito ay maaaring humantong sa mas maayos na pag-playback, ngunit naka-on
ang kabilang banda ay maaaring magdagdag ng mga pagkaantala sa paghahanap o pagsubaybay sa paglipat.

--demuxer-readahead-secs=
If --demuxer-thread ay pinagana, kinokontrol nito kung magkano ang dapat buffer ng demuxer
nauuna sa ilang segundo (default: 1). Hangga't walang packet na may pagkakaiba sa timestamp
mas mataas kaysa sa readahead na halaga na nauugnay sa huling packet na ibinalik sa
decoder, patuloy na nagbabasa ang demuxer.

Tandaan na ang --cache-seg I-override ng opsyon ang halagang ito kung pinagana ang isang cache,
at mas malaki ang halaga.

(Ang halagang ito ay malamang na malabo, dahil maraming mga format ng file ay hindi nag-iimbak ng linear
mga timestamp.)

--force-seekable=
Kung sa tingin ng player na ang media ay hindi hinahanap (hal. paglalaro mula sa pipe, o
ito ay isang http stream na may server na hindi sumusuporta sa mga kahilingan sa hanay), naghahanap ng kalooban
may kapansanan. Ang pagpipiliang ito ay maaaring puwersahang paganahin ito. Para sa mga paghahanap sa loob ng cache,
may magandang pagkakataon na magtagumpay.

input
--native-keyrepeat
Gamitin ang mga setting ng system para sa keyrepeat delay at rate, sa halip na --input-ar-delay at
--input-ar-rate. (Kung nalalapat ito ay depende sa VO backend at kung paano ito pinangangasiwaan
input ng keyboard. Hindi nalalapat sa terminal input.)

--input-ar-delay
Mag-antala sa mga millisecond bago tayo magsimulang mag-autorepeat ng key (0 para i-disable).

--input-ar-rate
Bilang ng mga pagpindot sa key na bubuo bawat segundo sa autorepeat.

--input-conf=
Tukuyin ang input configuration file maliban sa default na lokasyon sa mpv
direktoryo ng pagsasaayos (karaniwan ~/.config/mpv/input.conf).

--no-input-default-bindings
I-disable ang mpv default (built-in) na mga key binding.

--input-cmdlist
Ini-print ang lahat ng mga utos na maaaring itali sa mga susi.

--input-doubleclick-time=
Oras sa millisecond upang makilala ang dalawang magkasunod na pagpindot sa button bilang isang double-click
(default: 300).

--input-keylist
Ini-print ang lahat ng mga susi na maaaring itali sa mga utos.

--input-key-fifo-size=<2-65000>
Tukuyin ang laki ng FIFO na buffer ng mga pangunahing kaganapan (default: 7). Kung ito ay masyadong
maliit ang ilang mga kaganapan ay maaaring mawala. Ang pangunahing kawalan ng pagtatakda nito sa isang napakalaking
Ang halaga ay kung pipigilan mo ang isang susi na nagpapalitaw ng ilang partikular na mabagal na utos noon
maaaring hindi tumutugon ang manlalaro habang pinoproseso nito ang lahat ng nakapila na command.

--input-test
Input test mode. Sa halip na magsagawa ng mga utos sa mga pagpindot sa key, ipapakita ng mpv ang
key at ang nakatali na mga utos sa OSD. Kailangang gamitin sa isang dummy video, at ang
ang mga normal na paraan upang huminto ang manlalaro ay hindi gagana (ang mga pangunahing pagkakatali na karaniwang humihinto ay
maipakita sa OSD lamang, tulad ng anumang iba pang pagbubuklod). Tingnan mo INPUT.CONF.

--input-file=
Basahin ang mga utos mula sa ibinigay na file. Karamihan ay kapaki-pakinabang sa isang FIFO. Since mpv 0.7.0 din
naiintindihan ang mga utos ng JSON (tingnan JSON IPC), ngunit hindi ka makakakuha ng mga tugon o kaganapan. Gamitin
--input-unix-socket para sa isang bagay na bi-directional. Sa MS Windows, ang mga command ng JSON ay
hindi magagamit.

Maaari din itong tumukoy ng direktang file descriptor na may fd://N (UNIX lang). Dito sa
kaso, isusulat ang mga tugon ng JSON kung maisusulat ang FD.

TANDAAN:
Kapag ang ibinigay na file ay isang FIFO mpv, bubukas ang magkabilang dulo, kaya marami kang magagawa miss
"Humanap 10 " > mp_pipe at ang tubo ay mananatiling wasto.

--input-terminal, --walang-input-terminal
--walang-input-terminal pinipigilan ang player na basahin ang mga pangunahing kaganapan mula sa pamantayan
input. Kapaki-pakinabang kapag nagbabasa ng data mula sa karaniwang input. Ito ay awtomatikong pinagana
kailan - ay matatagpuan sa command line. May mga sitwasyon kung saan kailangan mong itakda ito
mano-mano, hal. kung bubuksan mo /dev/stdin (o ang katumbas sa iyong system), gumamit ng stdin
sa isang playlist o naglalayong magbasa mula sa stdin mamaya sa pamamagitan ng loadfile o loadlist
utos ng alipin.

--input-unix-socket=
Paganahin ang suporta ng IPC at lumikha ng socket sa pakikinig sa ibinigay na landas.

Tingnan JSON IPC para sa mga detalye.

Hindi available sa MS Windows.

--input-appleremote=
(OS X lang) I-enable/i-disable ang suporta sa Apple Remote. Pinagana bilang default (maliban sa
libmpv).

--input-cursor, --walang-input-cursor
Pahintulutan ang mpv na makatanggap ng mga event ng pointer na iniulat ng driver ng output ng video. Kailangan
upang gamitin ang OSC, o upang piliin ang mga buton sa mga menu ng DVD. Ang suporta ay nakasalalay sa VO
sa paggamit.

--input-media-keys=
(OS X lang) I-enable/i-disable ang suporta sa mga media key. Pinagana bilang default (maliban sa
libmpv).

--input-right-alt-gr, --no-input-right-alt-gr
(Cocoa at Windows lang) Gamitin ang tamang Alt key bilang Alt Gr para makagawa ng espesyal
mga karakter. Kung hindi pinagana, bilangin ang tamang Alt bilang Alt modifier key. Pinagana ng
default.

--input-vo-keyboard=
I-disable ang lahat ng keyboard input sa para sa mga VO na hindi makakasali sa tamang keyboard
pagpapadala ng input. Maaaring hindi makaapekto sa lahat ng VO. Karaniwang kapaki-pakinabang para sa pag-embed lamang.

Sa X11, ang isang sub-window na may input na naka-enable ay kukuha ng lahat ng keyboard input hangga't ito ay
1. isang bata ng isang nakatutok na window, at 2. ang mouse ay nasa loob ng sub-window. Ang
maaaring nakawin ang lahat ng input ng keyboard mula sa application na nag-embed sa mpv window,
at sa kabilang banda, ang mpv window ay hindi makakatanggap ng input kung ang mouse ay nasa labas
ng mpv window, kahit na may focus ang mpv. Ang mga modernong toolkit ay gumagana sa paligid nito
kakaibang gawi ng X11, ngunit nasira ito ng walang muwang na pag-embed ng mga dayuhang bintana.

Ang tanging paraan upang mahawakan ito nang makatwiran ay ang paggamit ng XEmbed protocol, na noon
dinisenyo upang malutas ang mga problemang ito. Nagbibigay ang GTK GtkSocket, na sumusuporta sa XEmbed. Qt
mukhang hindi nagbibigay ng anumang gumagana sa mga mas bagong bersyon.

Kung sinusuportahan ng embedder ang XEmbed, dapat gumana ang input sa mga default na setting at sa
hindi pinagana ang opsyong ito. Tandaan na input-default-bindings ay hindi pinagana bilang default sa
pati na rin ang libmpv - dapat itong paganahin kung gusto mo ang mpv default key bindings.

(Ang pagpipiliang ito ay pinalitan ng pangalan mula sa --input-x11-keyboard.)

--input-app-events=
(OS X lang) I-enable/i-disable ang application wide keyboard event para ang keyboard na iyon
ang mga shortcut ay maaaring iproseso nang walang window. Pinagana bilang default (maliban sa
libmpv).

OSD
--osc, --walang-osc
Kung ilo-load ang on-screen-controller (default: yes).

--no-osd-bar, --osd-bar
Huwag paganahin ang pagpapakita ng OSD bar. Gagawin nitong gumamit ng OSD ang ilang bagay (tulad ng paghahanap).
mga text message sa halip na bar.

Maaari mong i-configure ito sa bawat-command na batayan sa input.conf gamit osd- prefix,
makita input utos prefix. Kung gusto mong ganap na huwag paganahin ang OSD, gamitin
--osd-level=0.

--osd-tagal=
Itakda ang tagal ng mga mensahe ng OSD sa ms (default: 1000).

--osd-font= , --sub-text-font=
Tukuyin ang font na gagamitin para sa OSD at para sa mga subtitle na hindi mismo tumutukoy sa a
partikular na font. Ang default ay sans-serif.

Mga halimbawa

· --osd-font='Bitstream Vera Sans'

· --osd-font='MS Nakakatawa Sans'

TANDAAN:
Ang --sub-text-font opsyon (at karamihan sa iba pa --sub-text- mga opsyon) ay binabalewala kapag
Ang mga ASS-subtitle ay nai-render, maliban kung ang --walang-sub-ass ang pagpipilian ay tinukoy.

Ito ay ginamit upang suportahan ang mga pattern ng fontconfig. Simula sa libass 0.13.0, ito
tumigil sa pagtatrabaho.

--osd-font-size= , --sub-text-font-size=
Tukuyin ang laki ng OSD/sub na font. Ang unit ay ang laki sa mga naka-scale na pixel sa isang window
taas na 720. Ang aktwal na laki ng pixel ay naka-scale sa taas ng window: kung ang
ang taas ng window ay mas malaki o mas maliit sa 720, ang aktwal na laki ng teksto ay tumataas
o bumababa rin.

Default: 55.

--osd-msg1=
Ipakita ang string na ito bilang mensahe sa OSD na may OSD level 1 (nakikita bilang default). Ang
ang mensahe ay makikita bilang default, at hangga't walang ibang mensahe ang sumasaklaw dito, at ang
Ang antas ng OSD ay hindi nagbabago (tingnan --osd-level). Pinapalawak ang mga ari-arian; tingnan mo Ari-arian
Paglawak.

--osd-msg2=
Katulad ng --osd-msg1, ngunit para sa OSD level 2. Kung ito ay isang walang laman na string (default),
pagkatapos ay ipinapakita ang oras ng pag-playback.

--osd-msg3=
Katulad ng --osd-msg1, ngunit para sa OSD level 3. Kung ito ay isang walang laman na string (default),
pagkatapos ay ipapakita ang oras ng pag-playback, tagal, at ilan pang impormasyon.

Ginagamit din ito para sa show_progress utos (bilang default na nakamapa sa P), o sa
ilang hindi default na mga kaso kapag naghahanap.

--osd-status-msg ay katumbas ng legacy (ngunit may kaunting pagkakaiba).

--osd-status-msg=
Magpakita ng custom na string habang nagpe-playback sa halip na ang standard na text ng status. Ito
override ang status text na ginamit para sa --osd-level=3, kapag ginagamit ang show_progress
utos (bilang default na nakamapa sa P), o sa ilang hindi default na mga kaso kapag naghahanap.
Pinapalawak ang mga ari-arian. Tingnan mo Ari-arian Paglawak.

Ang pagpipiliang ito ay pinalitan ng --osd-msg3. Ang pagkakaiba lang nito
opsyon na tahasang kasama ${osd-sym-cc}. Binabalewala ang opsyong ito kung --osd-msg3 is
hindi walang laman.

--osd-playing-msg=
Magpakita ng mensahe sa OSD kapag nagsimula ang playback. Ang string ay pinalawak para sa mga katangian,
hal --osd-playing-msg='file: ${filename}' ay magpapakita ng mensahe file: sinundan ng
isang puwang at ang kasalukuyang nilalaro na filename.

Tingnan Ari-arian Paglawak.

--osd-bar-align-x=<-1-1>
Posisyon ng OSD bar. -1 ay malayo sa kaliwa, 0 ay nasa gitna, 1 ay malayo sa kanan. Fractional
pinahihintulutan ang mga halaga (tulad ng 0.5).

--osd-bar-align-y=<-1-1>
Posisyon ng OSD bar. -1 ang nasa itaas, 0 ang nasa gitna, 1 ang nasa ibaba. Mga fractional na halaga
(tulad ng 0.5) ay pinapayagan.

--osd-bar-w=<1-100>
Lapad ng OSD bar, sa porsyento ng lapad ng screen (default: 75). Isang halaga ng
50 ay nangangahulugan na ang bar ay kalahati ng lapad ng screen.

--osd-bar-h=<0.1-50>
Taas ng OSD bar, sa porsyento ng taas ng screen (default: 3.125).

--osd-back-color= , --sub-text-back-color=
Tingnan --osd-kulay. Kulay na ginamit para sa background ng OSD/sub text.

--osd-blur=<0..20.0>, --sub-text-blur=<0..20.0>
Gaussian blur factor. Ang ibig sabihin ng 0 ay walang inilapat na blur (default).

--osd-bold= , --sub-text-bold=
I-format ang text sa bold.

--osd-border-color= , --sub-text-border-color=
Tingnan --osd-kulay. Kulay na ginamit para sa OSD/sub font border.

TANDAAN:
hindi pinansin kung kailan --osd-likod-kulay/--sub-text-back-color ay tinukoy (o higit pa
eksakto: kapag ang opsyong iyon ay hindi nakatakda sa ganap na transparent).

--osd-border-size= , --sub-text-border-size=
Sukat ng hangganan ng OSD/sub font sa mga naka-scale na pixel (tingnan ang --osd-font-size para sa mga detalye).
Ang halaga ng 0 ay hindi pinapagana ang mga hangganan.

Default: 3.

--osd-color= , --sub-text-color=
Tukuyin ang kulay na ginamit para sa OSD/unstyled text subtitles.

Ang kulay ay tinukoy sa form r/g/b, kung saan tinukoy ang bawat bahagi ng kulay
bilang numero sa hanay na 0.0 hanggang 1.0. Posible ring tukuyin ang transparency
sa pamamagitan ng paggamit r/g/b/a, kung saan ang alpha value na 0 ay nangangahulugang ganap na transparent, at 1.0 ay nangangahulugan
malabo. Kung ang alpha component ay hindi ibinigay, ang kulay ay 100% opaque.

Ang pagpasa ng isang numero sa opsyon ay nagtatakda ng OSD sa kulay abo, at ang form kulay abo/a
hinahayaan kang tukuyin ang alpha bilang karagdagan.

Mga halimbawa

· --osd-color=1.0/0.0/0.0 itakda ang OSD sa opaque na pula

· --osd-color=1.0/0.0/0.0/0.75 itakda ang OSD sa opaque na pula na may 75% alpha

· --osd-color=0.5/0.75 itakda ang OSD sa 50% gray na may 75% alpha

Bilang kahalili, maaaring tukuyin ang kulay bilang RGB hex triplet sa anyo #RRGGBB,
kung saan ang bawat 2-digit na pangkat ay nagpapahayag ng halaga ng kulay sa hanay na 0 (00) sa 255 (FF).
Halimbawa, # FF0000 ay pula. Ito ay katulad ng mga kulay ng web. Ang Alpha ay binibigyan ng
#AARRGGBB.

Mga halimbawa

· --osd-color='#FF0000' itakda ang OSD sa opaque na pula

· --osd-color='#C0808080' itakda ang OSD sa 50% gray na may 75% alpha

--osd-fractions
Ipakita ang mga oras ng OSD na may mga fraction ng segundo (sa millisecond na katumpakan). Kapaki-pakinabang na makita
ang eksaktong timestamp ng isang video frame.

--osd-level=<0-3>
Tinutukoy kung saang mode dapat magsimula ang OSD.

0 Ganap na hindi pinagana ang OSD (mga subtitle lamang)

1 pinagana (lumalabas lamang sa pakikipag-ugnayan ng user)

2 pinagana + kasalukuyang oras na nakikita bilang default

3 pinagana + --osd-status-msg (kasalukuyang oras at katayuan bilang default)

--osd-margin-x= , --sub-text-margin-x=
Kaliwa at kanang screen margin para sa OSD/subs sa mga naka-scale na pixel (tingnan --osd-font-size
para sa mga detalye).

Tinutukoy ng opsyong ito ang distansya ng OSD sa kaliwa, gayundin kung saan
ang distansya mula sa kanang hangganan ay masisira ang mahabang OSD text.

Default: 25.

--osd-margin-y= , --sub-text-margin-y=
Sa itaas at ibabang margin ng screen para sa OSD/subs sa mga naka-scale na pixel (tingnan ang --osd-font-size
para sa mga detalye).

Tinutukoy ng opsyong ito ang mga patayong margin ng OSD. Ito ay ginagamit din para sa
hindi naka-istilong mga subtitle ng teksto. Kung gusto mo lang itaas ang vertical na posisyon ng subtitle,
gamitin --sub-pos.

Default: 22.

--osd-align-x= , --sub-text-align-x=...
Kontrolin kung saang sulok ng screen OSD o mga subtitle ng teksto ang dapat ihanay
(default: sentro para sa subs, kaliwa para sa OSD).

Hindi kailanman inilapat sa mga subtitle ng ASS, maliban sa --walang-sub-ass mode. Gayundin, ginagawa nito
hindi nalalapat sa mga subtitle ng larawan.

--osd-align-y= --sub-text-align-y=...
Patayong posisyon (default: ilalim para sa subs, tuktok para sa OSD). Tingnan ang mga detalye
--osd-align-x.

--osd-scale=
OSD font size multiplier, pinarami ng --osd-font-size halaga.

--osd-scale-by-window=
Kung i-scale ang OSD sa laki ng window (default: oo). Kung ito ay hindi pinagana,
--osd-font-size at iba pang mga opsyon sa OSD na gumagamit ng mga naka-scale na pixel ay palaging nasa aktwal
mga pixel. Ang epekto ay ang pagbabago ng laki ng window ay hindi magbabago sa laki ng font ng OSD.

--osd-shadow-color= , --sub-text-shadow-color=
Tingnan --osd-kulay. Kulay na ginamit para sa OSD/sub text shadow.

--osd-shadow-offset= , --sub-text-shadow-offset=
Pag-alis ng anino ng OSD/sub text sa mga naka-scale na pixel (tingnan ang --osd-font-size para
mga detalye). Ang isang halaga ng 0 ay hindi pinapagana ang mga anino.

Default: 0.

--osd-spacing= , --sub-text-spacing=
Pahalang na OSD/sub font spacing sa mga naka-scale na pixel (tingnan ang --osd-font-size para sa mga detalye).
Ang halagang ito ay idinagdag sa normal na puwang ng titik. Pinapayagan ang mga negatibong halaga.

Default: 0.

screenshot
--screenshot-format=
Itakda ang uri ng file ng imahe na ginagamit para sa pag-save ng mga screenshot.

Magagamit na mga pagpipilian:

png PNG

ppm PPM

pgm PGM

pgmyuv PGM na may format na YV12 pixel

tga HAART

jpg JPEG (default)

jpeg JPEG (katulad ng jpg, ngunit may .jpeg file na nagtatapos)

--screenshot-tag-colorspace=
I-tag ang mga screenshot na may naaangkop na colorspace.

Tandaan na hindi lahat ng format ay sinusuportahan.

Default: hindi.

--screenshot-high-bit-depth=
Kung maaari, magsulat ng mga screenshot na may kaunting lalim na katulad ng pinagmulang video
(default: oo). Ito ay kawili-wili lalo na para sa PNG, dahil ito minsan
nag-trigger ng pagsusulat ng 16 bit PNG na may malalaking sukat ng file.

--screenshot-template=
Tukuyin ang template ng filename na ginamit upang mag-save ng mga screenshot. Tinutukoy ng template ang
filename na walang extension ng file, at maaaring maglaman ng mga format specifier, na magiging
pinalitan kapag kumukuha ng screenshot. Bilang default, ang template ay mpv-shot%n, Na
nagreresulta sa mga filename tulad ng mpv-shot0012.png halimbawa.

Ang template ay maaaring magsimula sa isang kamag-anak o ganap na landas, upang tukuyin ang a
lokasyon ng direktoryo kung saan dapat i-save ang mga screenshot.

Kung ang panghuling filename ng screenshot ay tumuturo sa isang umiiral nang file, gagawin ng file
hindi mapapatungan. Maaaring hindi mase-save ang screenshot, o kung ang template
naglalaman ng %n, na-save gamit ang iba, bagong nabuong filename.

Pinapayagan ang mga tagatukoy ng format:

%[#][0X]n
Isang sequence number, na may palaman na mga zero hanggang sa haba X (default: 04). Hal
pagpasa sa format %04n magbubunga 0012 sa ika-12 na screenshot. Ang numero
ay nadaragdagan sa tuwing kukuha ng screenshot o kung ang file na
umiiral. Ang haba X dapat nasa hanay na 0-9. Gamit ang opsyonal na # sign, mpv
gagamit ng pinakamababang available na numero. Halimbawa, kung kukuha ka ng tatlo
mga screenshot--0001, 0002, 0003--at tanggalin ang unang dalawa, ang susunod na dalawa
ang mga screenshot ay hindi magiging 0004 at 0005, ngunit 0001 at 0002 muli.

%f Filename ng kasalukuyang nilalaro na video.

%F Katulad ng %f, ngunit hubarin ang extension ng file, kasama ang tuldok.

%x Direktoryo na landas ng kasalukuyang nilalaro na video. Kung ang video ay wala sa
filesystem (ngunit hal http://), lumawak ito sa isang walang laman na string.

%X{fallback}
Katulad ng %x, ngunit kung ang video file ay wala sa filesystem, ibalik ang
fallback string sa loob ng {...}.

%p Kasalukuyang oras ng pag-playback, sa parehong format tulad ng ginamit sa OSD. Ang resulta ay
isang string ng anyong "HH:MM:SS". Halimbawa, kung ang video ay nasa oras
posisyong 5 minuto at 34 segundo, %p ay papalitan ng "00:05:34".

%P Kapareho ng %p, ngunit pinalawig sa oras ng pag-playback sa mga millisecond. Ito ay
na-format bilang "HH:MM:SS.mmm", na ang "mmm" ay ang millisecond na bahagi ng
oras ng pag-playback.

TANDAAN:
Ito ay isang simpleng paraan para makakuha ng mga natatanging timestamp sa bawat frame. (Kuwadro
Ang mga numero ay magiging mas madaling maunawaan, ngunit hindi madaling ipatupad dahil
karaniwang gumagamit ng mga time stamp ang mga format ng lalagyan para sa pagtukoy ng mga frame.)

%wX Tukuyin ang kasalukuyang oras ng pag-playback gamit ang string ng format X. %p ay tulad ng
%wH:%wM:%wS, at %P ay tulad ng %wH:%wM:%wS.%wT.

Balido format mga specifier:

%wH oras (may palaman na may 0 hanggang dalawang digit)

%wh oras (hindi may palaman)

%wM minuto (00-59)

%wm kabuuang minuto (kasama ang mga oras, hindi katulad %wM)

%wS segundo (00-59)

%ws kabuuang segundo (kasama ang mga oras at minuto)

%wf gaya ng %ws, ngunit bilang float

%wT millisecond (000-999)

%tX Tukuyin ang kasalukuyang lokal na petsa/oras gamit ang format X. Ang format na ito
ginagamit ng specifier ang UNIX strftime() function sa loob, at ipinapasok ang
resulta ng pagpasa ng "%X" sa strftime. Halimbawa, % tm ilalagay ang numero
ng kasalukuyang buwan bilang numero. Kailangan mong gumamit ng maramihan %tX mga specifier sa
bumuo ng isang buong string ng petsa/oras.

%{prop[:fallback teksto]}
Ipasok ang halaga ng ari-arian ng alipin na 'prop'. Hal %{filename} ay pareho
as %f. Kung ang pag-aari ay hindi umiiral o hindi magagamit, isang error na teksto ay
ipinasok, maliban kung may tinukoy na fallback.

%% Pinalitan ng % karakter mismo.

--screenshot-directory=
Mag-imbak ng mga screenshot sa direktoryong ito. Ang landas na ito ay pinagsama sa filename
nabuo ng --screenshot-template. Kung ang filename ng template ay ganap na,
hindi pinapansin ang direktoryo.

Kung ang direktoryo ay hindi umiiral, ito ay nilikha sa unang screenshot. Kung ito ay
hindi isang direktoryo, ang isang error ay nabuo kapag sinusubukang magsulat ng isang screenshot.

Ang pagpipiliang ito ay hindi nakatakda bilang default, at sa gayon ay magsusulat ng mga screenshot sa direktoryo
kung saan nagsimula ang mpv. Sa pseudo-gui mode (tingnan PSEUDO GUI MODE), ito ay nakatakda
sa desktop.

--screenshot-jpeg-quality=<0-100>
Itakda ang antas ng kalidad ng JPEG. Ang mas mataas ay nangangahulugan ng mas mahusay na kalidad. Ang default ay 90.

--screenshot-jpeg-source-chroma=
Sumulat ng mga JPEG file na may parehong chroma subsampling gaya ng video (default: oo). Kung
hindi pinagana, ginagamit ang default na libjpeg.

--screenshot-png-compression=<0-9>
Itakda ang antas ng compression ng PNG. Ang mas mataas ay nangangahulugan ng mas mahusay na compression. Makakaapekto ito
ang laki ng file ng nakasulat na screenshot file at ang oras na kinakailangan upang magsulat ng a
screenshot. Ang masyadong mataas na compression ay maaaring tumagal ng sapat na oras ng CPU upang maputol
playback. Ang default ay 7.

--screenshot-png-filter=<0-5>
Itakda ang inilapat na filter bago ang PNG compression. 0 ay wala, 1 ay "sub", 2 ay "up",
3 ay "average", 4 ay "Paeth", at 5 ay "mixed". Nakakaapekto ito sa antas ng
compression na maaaring makamit. Para sa karamihan ng mga larawan, ang "mixed" ay nakakamit ang pinakamahusay
ratio ng compression, kaya ito ang default.

software Scaler
--sws-scaler=
Tukuyin ang software scaler algorithm na gagamitin --vf=scale. Nakakaapekto rin ito
mga driver ng video output na kulang sa hardware acceleration, hal x11. Tingnan din
--vf=scale.

Upang makakuha ng listahan ng mga available na scaler, tumakbo --sws-scaler=help.

Default: bicubic.

--sws-lgb=<0-100>
Software scaler Gaussian blur filter (luma). Tingnan mo --sws-scaler.

--sws-cgb=<0-100>
Software scaler Gaussian blur filter (chroma). Tingnan mo --sws-scaler.

--sws-ls=<-100-100>
Software scaler sharpen filter (luma). Tingnan mo --sws-scaler.

--sws-cs=<-100-100>
Software scaler sharpen filter (chroma). Tingnan mo --sws-scaler.

--sws-chs=
Software scaler chroma horizontal shifting. Tingnan mo --sws-scaler.

--sws-cvs=
Software scaler chroma vertical shifting. Tingnan mo --sws-scaler.

Pandulo
--tahimik
Gawing mas kaunting verbose ang output ng console; sa partikular, pinipigilan ang linya ng katayuan (ibig sabihin, AV:
3.4 (00:00:03.37) / 5320.6 ...) mula sa pagpapakita. Partikular na kapaki-pakinabang sa mabagal
mga terminal o sira na hindi maayos na humahawak sa pagbabalik ng karwahe (hal \r).

Tingnan din --talagang-tahimik at --msg-level.

--talagang-tahimik
Magpakita ng mas kaunting output at mga mensahe ng katayuan kaysa sa may --tahimik.

--walang terminal, --terminal
Huwag paganahin ang anumang paggamit ng terminal at stdin/stdout/stderr. Ito ay ganap na tumahimik
anumang output ng mensahe.

Hindi magkatulad --talagang-tahimik, hindi rin nito pinapagana ang input at terminal initialization.

--walang-msg-color
I-disable ang makulay na console output sa mga terminal.

--msg-level=
Direktang kontrolin ang verbosity para sa bawat module. Ang lahat binago ng module ang verbosity ng
lahat ng mga module na hindi tahasang tinukoy sa command line.

Patakbuhin ang mpv gamit ang --msg-level=all=trace upang makita ang lahat ng mga mensahe mpv output. Maaari mong gamitin ang
mga pangalan ng module na naka-print sa output (naka-prefix sa bawat linya sa [...]) upang limitahan ang
output sa mga kawili-wiling module.

TANDAAN:
Ang ilang mga mensahe ay naka-print bago ang command line ay na-parse at samakatuwid ay
hindi apektado ng --msg-level. Upang makontrol ang mga mensaheng ito, kailangan mong gamitin ang
MPV_VERBOSE variable ng kapaligiran; tingnan mo Kapaligiran MGA VARIABLE para sa mga detalye.

Magagamit na mga antas:

hindi kumpletong katahimikan

nakamamatay mga nakamamatay na mensahe lamang

mali mga mensahe ng error

balaan mga mensahe ng babala

info mga mensaheng nagbibigay-kaalaman

katayuan mga mensahe ng katayuan (default)

v pasalitang mensahe

mag-alis ng mga insekto i-debug ang mga mensahe

kopyahin o sipiin sa pamamagitan ng pag-aninag napaka maingay na mga mensahe sa pag-debug

--term-osd, --no-term-osd, --term-osd=puwersa
Ipakita ang mga mensahe ng OSD sa console kapag walang available na video output. Pinagana ng
default.

pilitin nagbibigay-daan sa terminal OSD kahit na gumawa ng video window.

--term-osd-bar, --no-term-osd-bar
Paganahin ang pag-print ng progress bar sa ilalim ng linya ng katayuan sa terminal. (Na-disable ni
default.)

--term-osd-bar-chars=
Ipasadya ang --term-osd-bar tampok. Ang string ay inaasahang binubuo ng 5
mga character (simula, kaliwang espasyo, tagapagpahiwatig ng posisyon, kanang espasyo, wakas). Pwede mong gamitin
Mga character na Unicode, ngunit tandaan na ang mga double-width na character ay hindi ituturing
tama.

Default: [-+-].

--term-playing-msg=
Mag-print ng isang string pagkatapos simulan ang pag-playback. Ang string ay pinalawak para sa mga katangian,
hal --term-playing-msg='file: ${filename}' ay i-print ang string file: sinundan ng
isang puwang at ang kasalukuyang nilalaro na filename.

Tingnan Ari-arian Paglawak.

--term-status-msg=
Mag-print ng custom na string habang nagpe-playback sa halip na ang karaniwang linya ng katayuan.
Pinapalawak ang mga ari-arian. Tingnan mo Ari-arian Paglawak.

--msg-module
Ilagay ang pangalan ng module sa bawat mensahe ng console.

--oras ng mensahe
Prepend timing impormasyon sa bawat console message.

TV
--tv-...
Ang mga opsyong ito ay nagtutugma ng iba't ibang katangian ng TV capture module. Para sa panonood ng TV
gamit ang mpv, gamitin tv:// or tv:// o kahit na tv:// (Tingnan ang
opsyon mga tv-channel para channel_name sa ibaba) bilang isang media URL. Maaari mo ring gamitin
tv:/// upang simulan ang panonood ng video mula sa isang composite o S-Video input (tingnan ang
opsyon input para sa mga detalye).

--tv-device=
Tukuyin ang TV device (default: / dev / video0).

--tv-channel=
Itakda ang tuner sa channel.

--walang-tv-audio
walang tunog

--tv-automute=<0-255> (v4l at v4l2 lamang)
Kung ang lakas ng signal na iniulat ng device ay mas mababa sa halagang ito, gagawin ang audio at video
ma-mute. Sa karamihan ng mga kaso, sapat na ang pag-automate=100. Ang default ay 0 (automute
may kapansanan).

--tv-driver=
Tingnan --tv=driver=help para sa isang listahan ng mga pinagsama-samang TV input driver. magagamit: dummy,
v4l2 (default: autodetect)

--tv-input=
Tukuyin ang input (default: 0 (TV), tingnan ang console output para sa mga available na input).

--tv-freq=
Tukuyin ang dalas upang itakda ang tuner sa (hal. 511.250). Hindi tugma sa
parameter ng channel.

--tv-outfmt=
Tukuyin ang output format ng tuner na may preset na value na sinusuportahan ng V4L
driver (YV12, UYVY, YUY2, I420) o isang arbitrary na format na ibinigay bilang hex value.

--tv-width=
lapad ng window ng output

--tv-taas=
taas ng window ng output

--tv-fps=
framerate kung saan kukuha ng video (mga frame bawat segundo)

--tv-buffersize=
maximum na laki ng capture buffer sa megabytes (default: dynamical)

--tv-norm=
Tingnan ang output ng console para sa isang listahan ng lahat ng magagamit na pamantayan, tingnan din ang karaniwan
opsyon sa ibaba.

--tv-normid= (v4l2 lamang)
Itinatakda ang pamantayan sa TV sa ibinigay na numerong ID. Ang pamantayan ng TV ay nakasalalay sa pagkuha ng card.
Tingnan ang output ng console para sa isang listahan ng mga available na pamantayan sa TV.

--tv-chanlist=
magagamit: argentina, australia, china-bcast, europe-silangan, europe-kanluran, france,
ireland, italy, japan-bcast, japan-cable, newzealand, russia, southafrica,
us-bcast, us-cable, us-cable-hrc

--tv-channels= - [= ], - [= ],...
Magtakda ng mga pangalan para sa mga channel.

TANDAAN:
Kung ay isang integer na higit sa 1000, ito ay ituturing bilang frequency (in
kHz) sa halip na pangalan ng channel mula sa talahanayan ng dalas. Gamitin ang _ para sa mga puwang sa mga pangalan
(o makipaglaro sa pagsipi ;-) ). Ang mga pangalan ng channel ay isusulat gamit ang OSD,
at utos ng alipin tv_step_channel, tv_set_channel at tv_last_channel habilin
magagamit para sa isang remote control. Hindi tugma sa dalas parameter

TANDAAN:
Ang channel number ang magiging posisyon sa listahan ng 'mga channel', simula
na may 1.

Mga halimbawa

tv://1, tv://TV1, tv_set_channel 1, tv_set_channel TV1

--tv-[brightness|contrast|hue|saturation]=<-100-100>
Itakda ang image equalizer sa card.

--tv-audiorate=
Itakda ang input audio sample rate.

--tv-forceaudio
Kumuha ng audio kahit na walang audio source na iniulat ng v4l.

--tv-alsa
Kunin mula sa ALSA.

--tv-amode=<0-3>
Pumili ng audio mode:

0 mono

1 isteryo

2 wika 1

3 wika 2

--tv-forcechan=<1-2>
Bilang default, ang bilang ng mga naitalang audio channel ay awtomatikong tinutukoy ng
pagtatanong sa audio mode mula sa TV card. Ang pagpipiliang ito ay nagbibigay-daan sa pagpilit ng stereo/mono
pag-record anuman ang opsyon sa amode at ang mga halagang ibinalik ng v4l. Maaari itong
gamitin para sa pag-troubleshoot kapag hindi maiulat ng TV card ang kasalukuyang audio
mode.

--tv-adevice=
Magtakda ng audio device. ay dapat na /dev/xxx para sa OSS at isang hardware ID para sa ALSA.
Dapat mong palitan ang anumang ':' ng isang '.' sa hardware ID para sa ALSA.

--tv-audioid=
Pumili ng audio output ng capture card, kung mayroon itong higit sa isa.

--tv-[volume|bass|treble|balanse]=<0-100>
Ang mga opsyong ito ay nagtatakda ng mga parameter ng mixer sa video capture card. Sila ay mag
walang epekto, kung ang iyong card ay walang isa. Para sa v4l2 50 na mga mapa sa default
halaga ng kontrol, tulad ng iniulat ng driver.

--tv-gain=<0-100>
Itakda ang gain control para sa mga video device (karaniwan ay mga webcam) sa gustong halaga at
patayin ang awtomatikong kontrol. Ang isang halaga ng 0 ay nagbibigay-daan sa awtomatikong kontrol. Kung ito
ang opsyon ay tinanggal, ang makakuha ng kontrol ay hindi mababago.

--tv-immediatemode=
Ang halaga ng 0 ay nangangahulugan ng pagkuha at pag-buffer ng audio at video nang magkasama. Isang halaga ng 1
Ang ibig sabihin ng (default) ay gumawa lang ng video capture at hayaan ang audio na dumaan sa isang loopback
cable mula sa TV card patungo sa sound card.

--tv-mjpeg
Gumamit ng hardware MJPEG compression (kung sinusuportahan ito ng card). Kapag ginagamit ang opsyong ito,
hindi mo kailangang tukuyin ang lapad at taas ng window ng output, dahil ang mpv
ay awtomatikong matukoy ito mula sa halaga ng decimation (tingnan sa ibaba).

--tv-decimation=<1|2|4>
piliin ang laki ng larawan na i-compress ng hardware MJPEG
compression:

1 buong laki

· 704x576 PAL

· 704x480 NTSC

2 katamtamang laki

· 352x288 PAL

· 352x240 NTSC

4 maliit na sukat

· 176x144 PAL

· 176x120 NTSC

--tv-quality=<0-100>
Piliin ang kalidad ng JPEG compression (<60 inirerekomenda para sa buong laki).

--tv-scan-autostart
Simulan ang pag-scan ng channel kaagad pagkatapos ng startup (default: hindi pinagana).

--tv-scan-period=<0.1-2.0>
Tukuyin ang pagkaantala sa mga segundo bago lumipat sa susunod na channel (default: 0.5). Ibaba
ang mga halaga ay magdudulot ng mas mabilis na pag-scan, ngunit maaaring makakita ng mga hindi aktibong channel sa TV bilang aktibo.

--tv-scan-threshold=<1-100>
Halaga ng threshold para sa lakas ng signal (sa porsyento), gaya ng iniulat ng device
(default: 50). Ang lakas ng signal na mas mataas kaysa sa halagang ito ay magsasaad na ang
kasalukuyang aktibo ang channel sa pag-scan.

Cache
--cache=
Itakda ang laki ng cache sa kilobytes, huwag paganahin ito hindi, o awtomatikong paganahin
ito kung kinakailangan kasama kotse (default: kotse). Sa kotse, ang cache ay karaniwang magiging
pinagana para sa mga stream ng network, gamit ang laki na itinakda ni --cache-default. May oo, ang
Ang cache ay palaging ie-enable sa laki na itinakda ni --cache-default (maliban kung ang
stream ay hindi maaaring i-cache, o --cache-default hindi pinapagana ang pag-cache).

Maaaring maging kapaki-pakinabang kapag nagpe-play ng mga file mula sa mabagal na media, ngunit maaari ding magkaroon ng negatibo
effect, lalo na sa mga format ng file na nangangailangan ng maraming paghahanap, gaya ng MP4.

Tandaan na ang kalahati ng laki ng cache ay gagamitin upang payagan ang mabilis na paghahanap pabalik. Ito rin ay
ang dahilan kung bakit ang isang buong cache ay karaniwang hindi iniuulat bilang 100% puno. Ang pagpuno ng cache
hindi kasama sa display ang bahagi ng cache na nakalaan para sa paghahanap pabalik. Ang
Ang aktwal na maximum na porsyento ay karaniwang magiging ratio sa pagitan ng readahead at
mga laki ng backbuffer.

--cache-default=
Itakda ang laki ng cache sa kilobytes (default: 75000 KB). Gamit hindi ay hindi mag
awtomatikong paganahin ang cache hal kapag nagpe-play mula sa isang network stream. Tandaan na
paggamit --cache ay palaging i-override ang opsyong ito.

--cache-initial=
Magsisimula ang pag-playback kapag napuno na ang cache ng ganito karaming kilobytes
data (default: 0).

--cache-seek-min=
Kung ang isang paghahanap ay gagawin sa isang posisyon sa loob ng laki ng cache mula sa
kasalukuyang posisyon, hihintayin ng mpv na mapunan ang cache sa posisyong ito
kaysa sa pagsasagawa ng stream seek (default: 500).

Mahalaga ito para sa maliliit na pasulong na paghahanap. Sa mabagal na stream (lalo na sa HTTP stream)
mayroong isang tradeoff sa pagitan ng paglaktaw sa data sa pagitan ng kasalukuyang posisyon at paghahanap
destinasyon, o pagsasagawa ng aktwal na paghahanap. Depende sa sitwasyon, alinman sa
maaaring mas mabagal ang mga ito kaysa sa ibang paraan. Ang pagpipiliang ito ay nagbibigay-daan sa kontrol dito.

--cache-backbuffer=
Sukat ng cache back buffer (default: 75000 KB). Magdaragdag ito sa kabuuang cache
laki, at inilaan ang halaga para sa paghahanap pabalik. Ang nakareserbang halaga ay hindi magiging
ginagamit para sa readahead, at sa halip ay pinapanatili ang nabasa nang data upang paganahin ang mabilis na paghahanap
back.

--cache-file=
Gumawa ng cache file sa filesystem.

Mayroong dalawang paraan ng paggamit nito:

1. Pagpasa sa isang landas (isang filename). Palaging ma-overwrite ang file. Kapag ang
pangkalahatang cache ay pinagana, ang file cache na ito ay gagamitin upang iimbak ang anumang nabasa
mula sa source stream.

Palagi nitong ino-overwrite ang cache file, at hindi ka makakagamit ng isang umiiral nang cache
file upang ipagpatuloy ang pag-playback ng isang stream. (Sa teknikal, hindi alam ng mpv kung alin
ang mga bloke sa file ay wasto at alin ang hindi.)

Ang resultang file ay hindi kinakailangang maglaman ng lahat ng data ng source stream.
Halimbawa, kung hahanapin mo, ang mga bahaging nalaktawan ay hindi kailanman nababasa at
dahil dito ay hindi nakasulat sa cache. Ang mga nilaktawan na bahagi ay napuno
may mga zero. Nangangahulugan ito na ang cache file ay hindi kinakailangang tumutugma sa a
buong pag-download ng source stream.

Ang parehong mga isyung ito ay maaaring mapabuti kung mayroong anumang interes ng gumagamit.

BABALA:
Nagdudulot ng random na katiwalian kapag ginamit sa mga iniutos na kabanata o may
--audio-file.

2. Pagpasa ng string TMP. Hindi ito bibigyang-kahulugan bilang filename. Sa halip, isang
nalikha ang hindi nakikitang pansamantalang file. Depende ito sa iyong C library kung saan ito
Ang file ay nilikha (karaniwang / tmp /), at kung ang filename ay nakikita (ang tmpfile()
ginagamit ang function). Sa ilang mga system, ang awtomatikong pagtanggal ng cache file ay maaaring
hindi magagarantiyahan.

Kung gusto mong gumamit ng file cache, inirerekomenda ang mode na ito, dahil hindi
break order na mga kabanata o --audio-file. Ang mga mode na ito ay nagbubukas ng maramihang mga stream ng cache,
at ang paggamit ng parehong file para sa kanila ay malinaw na nag-aaway.

Tingnan din --cache-file-size.

--cache-file-size=
Pinakamataas na laki ng file na ginawa gamit ang --cache-file. Para sa mga read access sa itaas nito
laki, ang cache ay hindi ginagamit.

Tandaan na ang ilang mga kaso ng paggamit, tulad ng paglalaro ng mga order na kabanata na may naka-enable na cache,
ay talagang lilikha ng maramihang mga cache file, bawat isa ay gagamit ng hanggang ganito
espasyo sa disk.

(Default: 1048576, 1 GB.)

--walang-cache
I-off ang pag-cache ng stream ng input. Tingnan mo --cache.

--cache-secs=
Ilang segundo ng audio/video ang i-prefetch kung aktibo ang cache. Ino-override ito
ang --demuxer-readahead-seg opsyon kung at kung pinagana lang ang cache at ang
mas malaki ang halaga. (Default: 10.)

--cache-pause, --no-cache-pause
Kung dapat awtomatikong mag-pause ang player kapag ubos na ang cache, at i-unpause
kapag may available pang data ("buffering").

network
--user-agent=
paggamit bilang user agent para sa HTTP streaming.

--cookies, --walang-cookies
Suportahan ang cookies kapag gumagawa ng mga kahilingan sa HTTP. Hindi pinagana bilang default.

--cookies-file=
Basahin ang HTTP cookies mula sa . Ang file ay ipinapalagay na nasa Netscape na format.

--http-header-fields=
Magtakda ng mga custom na HTTP field kapag ina-access ang HTTP stream.

halimbawa

mpv --http-header-fields='Field1: value1','Field2: value2'
http://localhost: 1234

Bubuo ng kahilingan sa HTTP:

GET / HTTP / 1.0
Host: localhost:1234
Ahente ng Gumagamit: MPlayer
Icy-MetaData: 1
Field1: value1
Field2: value2
Koneksyon: malapit

--tls-ca-file=
Certificate authority database file para gamitin sa TLS. (Tahimik na nabigo sa mas matanda
Mga bersyon ng FFmpeg o Libav.)

--tls-verify
I-verify ang mga peer certificate kapag gumagamit ng TLS (hal https://...). (Tahimik na nabigo
na may mas lumang mga bersyon ng FFmpeg o Libav.)

--tls-cert-file
Isang file na naglalaman ng certificate na gagamitin sa pakikipagkamay sa kapantay.

--tls-key-file
Isang file na naglalaman ng pribadong key para sa certificate.

--referrer=
Tumukoy ng path ng referrer o URL para sa mga kahilingan sa HTTP.

--network-timeout=
Tukuyin ang network timeout sa ilang segundo. Naaapektuhan nito ang hindi bababa sa HTTP. Ang espesyal
ginagamit ng value 0 (default) ang mga default na FFmpeg/Libav. Kung ang isang protocol ay ginagamit na ginagawa
hindi sumusuporta sa mga timeout, tahimik na binabalewala ang opsyong ito.

--rtsp-transport=
Piliin ang paraan ng transportasyon ng RTSP (default: tcp). Pinipili nito ang pinagbabatayan na network
transportasyon kapag naglalaro rtsp://... Mga URL. Ang halaga lavf iniiwan ang desisyon sa
libavformat.

--hls-bitrate= >
Kung nilalaro ang mga stream ng HLS, kinokontrol ng opsyong ito kung anong mga stream ang pinipili
default. Pinapayagan ng pagpipilian ang mga sumusunod na parameter:

hindi Huwag gumawa ng anumang espesyal. Kadalasan, pipiliin lang nito ang una
audio/video stream na mahahanap nito.

minuto Piliin ang mga stream na may pinakamababang bitrate.

max Pareho, ngunit pinakamataas na bitrate. (Default.)

Bukod pa rito, kung ang opsyon ay isang numero, ang stream na may pinakamataas na rate ay katumbas ng o
sa ibaba ang halaga ng opsyon ay pinili.

Ang bitrate na ginamit ay ipinadala ng server, at walang garantiya na ito talaga
makahulugan.

DVB
--dvbin-card=<1-4>
Tinutukoy gamit ang card number 1-4 (default: 1).

--dvbin-file=
Nagtuturo sa mpv na basahin ang listahan ng mga channel mula sa . Ang default ay nasa mpv
direktoryo ng pagsasaayos (karaniwan ~/.config/mpv) na may filename
channels.conf.{sat,ter,cbl,atsc} (batay sa uri ng iyong card) o channels.conf bilang isang
huling paraan. Para sa mga DVB-S/2 card, isang VDR 1.7.x format na listahan ng channel ay inirerekomenda bilang
pinapayagan nito ang pag-tune sa mga channel ng DVB-S2, pagpapagana ng mga subtitle at pag-decode ng PMT (na
higit na nagpapabuti sa demuxing). Ang mga listahan ng channel ng klasikong format ng mplayer ay nananatili pa rin
suportado (nang walang mga pagpapahusay na ito), at para sa iba pang mga uri ng card, limitado lang ang VDR
format na suporta sa listahan ng channel ay ipinatupad (patches welcome). Para sa mga channel na may
dynamic na paglipat ng PID o hindi kumpleto channels.conf, --dvbin-full-transponder o ang
magic PID 8192 ay inirerekomenda.

--dvbin-timeout=<1-30>
Pinakamataas na bilang ng mga segundong hihintayin kapag sinusubukang ibagay ang dalas bago sumuko
(default: 30).

--dvbin-full-transponder=
Walang mga filter na ilapat sa mga PID ng programa, ibagay lamang sa dalas at ipasa ang buong transponder
sa demuxer. Ito ay kapaki-pakinabang upang mag-record ng maramihang mga programa sa isang solong transponder, o
upang ayusin ang mga isyu sa channels.conf. Inirerekomenda din na gamitin ito para sa
mga channel na nagpapalipat-lipat ng mga PID on-the-fly, hal para sa mga balita sa rehiyon.

Default: hindi

sari-sari
--display-tags=tag1,tags2,...
Itakda ang listahan ng mga tag na dapat ipakita sa terminal. Mga tag na nasa
listahan, ngunit wala sa nilalaro na file, ay hindi ipapakita. Kung magtatapos ang isang halaga
sa *, lahat ng mga tag ay itinutugma sa pamamagitan ng prefix (bagama't walang pangkalahatang globbing). Basta
pagdaan * mahalagang pagsasala.

Kasama sa default ang isang karaniwang listahan ng mga tag, tumawag sa mpv gamit ang --listahan-mga opsyon para makita ito.

--mc=
Maximum AV sync correction sa bawat frame (sa mga segundo)

--autosync=
Unti-unting inaayos ang A/V sync batay sa mga sukat ng pagkaantala ng audio. Tinutukoy
--autosync=0, ang default, ay magiging sanhi ng frame timing na ganap na nakabatay sa audio
pagkaantala ng mga sukat. Tinutukoy --autosync=1 ay gagawin ang parehong, ngunit subtly
baguhin ang A/V correction algorithm. Isang hindi pantay na video framerate sa isang video na
gumaganap ng maayos sa --walang-audio madalas na matutulungan sa pamamagitan ng pagtatakda nito sa isang integer na halaga
mas malaki sa 1. Kung mas mataas ang value, mas malapit ang timing --walang-audio.
Sumubok --autosync=30 para maayos ang mga problema sa mga sound driver na hindi nagpapatupad
isang perpektong pagsukat ng pagkaantala ng audio. Sa halagang ito, kung mag-offset ang malaking A/V sync
mangyari, tatagal lang sila ng mga 1 o 2 segundo bago mag-settle. Ang pagkaantala na ito sa
oras ng reaksyon sa biglaang pag-offset ng A/V ay dapat ang tanging side-effect ng pag-ikot nito
opsyon sa, para sa lahat ng sound driver.

--video-sync=
Paano nagsi-synchronize ang player ng audio at video.

Ang mga mode na nagsisimula sa display- subukang ganap na mag-output ng mga video frame
sabaysabay sa display, gamit ang nakitang display vertical refresh rate bilang a
pahiwatig kung gaano kabilis ang mga frame ay ipapakita sa karaniwan. Binabago ng mga mode na ito ang bilis ng video
bahagyang upang tumugma sa display. Tingnan mo --video-sync-... mga opsyon para sa fine tuning. Ang
Ang katatagan ng mode na ito ay higit na nababawasan sa pamamagitan ng paggawa ng ilang mga ideyal na pagpapalagay,
na maaaring hindi palaging naaangkop sa katotohanan. Maaaring depende ang pag-uugali sa VO at sa
mga driver ng video at audio ng system. Dapat gumamit ng pare-parehong framerate ang mga media file.
Maaaring gumana rin ang VFR sa section-wise sa ilang mga format ng lalagyan (ngunit hindi eg mkv).
Kung natukoy ng sync code ang matinding A/V desync, o hindi matukoy ang framerate,
awtomatikong bumabalik ang player sa audio mode para sa ilang oras o permanente.

Ang mga mode na may desync sa kanilang mga pangalan ay huwag subukang panatilihing naka-sync ang audio/video.
Ang mga ito ay dahan-dahan (o mabilis) mag-desync, hanggang sa mangyari ang susunod na paghahanap. Ang mga mode na ito
ay sinadya para sa pagsubok, hindi seryosong paggamit.

audio Oras ng mga video frame sa audio. Ito ang pinaka-matatag na mode, dahil ang player
ay hindi kailangang mag-isip ng anuman tungkol sa kung paano kumikilos ang display. Ang
Ang kawalan ay maaari itong humantong sa paminsan-minsang pagbagsak o pag-uulit ng frame. Kung
hindi pinagana ang audio, ginagamit nito ang system clock. Ito ang default na mode.

display-resample
I-resample ang audio upang tumugma sa video. Susubukan din ng mode na ito na ayusin ang audio
bilis upang mabayaran ang iba pang pag-anod. (Ibig sabihin, ipe-play nito ang audio sa
ibang bilis paminsan-minsan upang bawasan ang pagkakaiba ng A/V.)

display-resample-vdrop
I-resample ang audio upang tumugma sa video. Mag-drop ng mga video frame upang mabayaran
naaanod.

display-resample-desync
Tulad ng nakaraang mode, ngunit walang A/V compensation.

display-vdrop
I-drop o ulitin ang mga video frame upang mabayaran ang pag-desync ng video. (Bagaman ito
ay dapat magkaroon ng parehong epekto bilang audio, ang pagpapatupad ay napaka
iba.)

display-adrop
I-drop o ulitin ang audio data upang mabayaran ang pag-desync ng video. Tingnan mo
--video-sync-adrop-size. Ang mode na ito ay magdudulot ng malubhang audio artifact kung ang
Ang real monitor refresh rate ay masyadong naiiba sa naiulat o sapilitang rate.

display-desync
I-sync ang video upang ipakita, at hayaang mag-play ang audio nang mag-isa.

desync I-sync ang video ayon sa system clock, at hayaang mag-play ang audio nang mag-isa.

--video-sync-max-video-change=
Pinakamataas na pagkakaiba sa bilis sa porsyento na inilalapat sa video na may
--video-sync=display-... (default: 1). Idi-disable ang display sync mode kung ang
monitor at video refresh paraan ay hindi tumutugma sa loob ng ibinigay na hanay. Sinusubukan nito
maramihan din: ang paglalaro ng 30 fps na video sa isang 60 Hz screen ay magdo-duplicate bawat isa
pangalawang frame. Ang pag-play ng 24 fps na video sa isang 60 Hz screen ay magpe-play ng video sa isang
2-3-2-3-... pattern.

Ang mga default na setting ay hindi sapat na maluwag upang mapabilis ang 23.976 fps na video sa 25 fps.
Itinuturing naming masyadong sukdulan ang pagbabago ng pitch upang payagan ang gawi na ito bilang default. Itakda
ang pagpipiliang ito sa isang halaga ng 5 upang paganahin ito.

Tandaan na sa --video-sync=display-resample mode, ang bilis ng audio ay karagdagang
mababago ng maliit na halaga kung kinakailangan para sa A/V sync. Tingnan mo
--video-sync-max-audio-change.

--video-sync-max-audio-change=
Pinakamataas karagdagan pagkakaiba ng bilis sa porsyento na inilalapat sa audio na may
--video-sync=display-... (default: 0.125). Karaniwan, pinapatugtog ng player ang audio sa
ang bilis ng video. Ngunit kung ang pagkakaiba sa pagitan ng posisyon ng audio at video ay
masyadong mataas, hal dahil sa drift o iba pang mga error sa timing, susubukan nitong pabilisin o
pabagalin ang audio sa pamamagitan ng karagdagang salik na ito. Masyadong mababa ang mga halaga ay maaaring humantong sa video frame
pag-drop o pag-uulit kung hindi mabayaran ang A/V desync, masyadong mataas ang mga value
maaaring humantong sa magulong pag-drop ng frame dahil sa audio na "overshooting" at paglaktaw
maraming video frame bago makapag-react ang logic ng pag-sync.

--video-sync-adrop-size=
Para sa --video-sync=display-adrop mode. Ang mode na ito ay duplicate/ibinabagsak ang audio data sa
panatilihing naka-sync ang audio sa video. Upang maiwasan ang mga audio artifact sa jitter (na gagawin
magdagdag/mag-alis ng mga sample sa lahat ng oras), ginagawa ito sa medyo malaki, nakapirming mga unit,
kinokontrol ng pagpipiliang ito. Ang unit ay segundo.

--mf-fps=
Ginagamit ang framerate kapag nagde-decode mula sa maraming PNG o JPEG file na may mf:// (default:
1).

--mf-type=
Uri ng file ng input para sa mf:// (magagamit: jpeg, png, tga, sgi). Bilang default, ito ay
nahulaan mula sa extension ng file.

--stream-capture=
Nagbibigay-daan sa pagkuha ng pangunahing stream (hindi karagdagang audio track o iba pang uri ng
stream) sa ibinigay na file. Ang pagkuha ay maaari ding simulan at itigil sa pamamagitan ng pagbabago
ang filename na may stream-capture ari-arian ng alipin. Sa pangkalahatan ito ay hindi
makagawa ng magagamit na mga resulta para sa anumang bagay maliban sa MPEG o mga raw stream, maliban kung kumukuha
kasama ang mga header ng file at hindi naaantala. Tandaan na, dahil sa cache
latencies, ang nakuhang data ay maaaring magsimula at magtapos na medyo naantala kumpara sa kung ano ang sa iyo
tingnan ang ipinapakita.

Palaging nakadugtong ang patutunguhang file. (Bago ang mpv 0.8.0, ang file ay
na-overwrite.)

--stream-dump=
Katulad ng --stream-capture, ngunit huwag simulan ang pag-playback. Sa halip, ang buong file ay
itinapon.

--stream-lavf-o=opt1=value1,opt2=value2,...
Itakda ang AVOptions sa mga stream na binuksan gamit ang libavformat. Hindi alam o maling spelling na mga opsyon ay
tahimik na hindi pinansin. (Ang mga ito ay binanggit sa terminal output sa verbose mode, ibig sabihin
--v. Sa pangkalahatan, hindi kami makakapag-print ng mga error, dahil ang iba pang mga opsyon gaya ng hal. user
ahente ay hindi magagamit sa lahat ng mga protocol, at mga error sa pag-print para sa hindi kilalang mga opsyon
magiging masyadong maingay.)

--vo-mmcss-profile=
(Windows lang.) Itakda ang MMCSS profile para sa video renderer thread (default:
Pag-playback).

--priyoridad=
(Windows lang.) Itakda ang priyoridad ng proseso para sa mpv ayon sa paunang natukoy
mga priyoridad na magagamit sa ilalim ng Windows.

Mga posibleng halaga ng : idle|belownormal|normal|abovenormal|high|realtime

BABALA:
Ang paggamit ng realtime na priyoridad ay maaaring magdulot ng system lockup.

--force-media-title=
Pilitin ang nilalaman ng pamagat ng media ari-arian sa halagang ito. Kapaki-pakinabang para sa mga script
na gustong magtakda ng pamagat, nang hindi ina-override ang setting ng user --pamagat.

Audio oUTPUT MGA DRIVER

Ang mga driver ng output ng audio ay mga interface sa iba't ibang pasilidad ng audio output. Ang syntax ay:

--ao=
Tumukoy ng listahan ng priyoridad ng mga driver ng audio output na gagamitin.

Kung ang listahan ay may sumusunod na ',', ang mpv ay babalik sa mga driver na wala sa listahan.
Opsyonal ang mga suboption at kadalasang maaaring tanggalin.

Maaari mo ring itakda ang mga default para sa bawat driver. Ang mga default ay inilapat bago ang normal
mga parameter ng driver.

--ao-defaults=
Itakda ang mga default para sa bawat driver.

TANDAAN:
Tingnan --ao= tulong para sa isang listahan ng mga pinagsama-samang audio output driver. Ang driver --ao=alsa is
ginustong --ao=pulso ay mas gusto sa mga system kung saan ginagamit ang PulseAudio. Sa Windows,
--ao=wasapi ay ginustong, bagaman maaari itong magdulot ng problema kung minsan, kung saan
--ao=dtunog dapat gamitin. Sa mga sistema ng BSD, --ao=oss or --ao=sndio` maaaring gumana (ang
ang huli ay eksperimento). Sa mga OS X system, gamitin --ao=coreaudio.

Mga halimbawa

· --ao=alsa,oss, Subukan ang driver ng ALSA, pagkatapos ang driver ng OSS, pagkatapos ang iba pa.

· --ao=alsa:resample=yes:device=[plughw:0,3] Hinahayaan ang ALSA na mag-sample at itakda ang
pangalan ng device bilang unang card, pang-apat na device.

Ang mga available na audio output driver ay:

tumaas (Linux lamang)
ALSA audio output driver

aparato=
Itinatakda ang pangalan ng device. Para sa ac3 output sa pamamagitan ng S/PDIF, gumamit ng "iec958" o "spdif"
device, maliban kung alam mo talaga kung paano ito itakda nang tama.

resample=oo
Paganahin ang ALSA resampling plugin. (Ito ay hindi pinagana bilang default, dahil ang ilan
ang mga driver ay nag-uulat ng maling pagkaantala ng audio sa ilang mga kaso.)

panghalo-aparato=
Itakda ang mixer device na ginamit --walang-softvol (default: default).

panghalo-pangalan=
Itakda ang pangalan ng elemento ng mixer (default: Panginoon). Ito ay halimbawa PCM
or Panginoon.

panghalo-index=
Itakda ang index ng mixer channel (default: 0). Isaalang-alang ang output ng
"amixer mga kontrol", kung gayon ang index ay ang numero na sumusunod sa pangalan ng
ang elemento.

non-interleaved
Payagan ang output ng mga non-interleaved na format (kung ginagamit ito ng audio decoder
format). Kasalukuyang hindi pinagana bilang default, dahil ilang sikat na plugin ng ALSA
ay ganap na sira na may mga non-interleaved na format.

huwag pansinin-chmap
Huwag basahin o itakda ang channel map ng ALSA device - hilingin lamang ang
kinakailangang bilang ng mga channel, at pagkatapos ay ipasa ang audio kung nasan ito. Ito
opsyon na malamang na hindi dapat gamitin. Maaari itong maging kapaki-pakinabang para sa pag-debug, o
para sa mga static na setup na may espesyal na engineered na configuration ng ALSA (sa ito
kaso dapat lagi mong pilitin ang parehong layout sa --audio-channel, o ito
gagana lamang para sa mga file na gumagamit ng implicit na layout sa iyong ALSA device).

TANDAAN:
Kinakailangan ng MPlayer at mplayer2 na palitan mo ang anumang ',' ng '.' at anumang ':' na may
'=' sa pangalan ng ALSA device. hindi na ito ginagawa ng mpv. Sa halip, sipiin ang
pangalan ng device:
--ao=alsa:device=[plug:surround50]

Tandaan na ang [ at ] quote lang ang pangalan ng device. Sa ilang mga shell (tulad ng zsh),
kailangan mong i-quote ang pagpipiliang string upang maiwasan ang shell mula sa pagbibigay-kahulugan sa
bracket sa halip na ipasa ang mga ito sa mpv.

Sa totoo lang, dapat mong gamitin ang --audio-device opsyon, sa halip na itakda ang
direktang aparato.

BABALA:
Ang pangangasiwa ng multichannel/surround audio ay binago sa mpv 0.8.0 mula sa gawi
sa MPlayer/mplayer2 at mas lumang bersyon ng mpv.

Ang lumang gawi ay ang player ay palaging naka-downmix sa stereo bilang default. Ang
--audio-channel (O --mga channel bago iyon) ang opsyon ay kailangang itakda upang makuha
multichannel na audio. Pagkatapos ang paglalaro ng stereo ay gagamitin ang default aparato (na
karaniwang nagbibigay-daan sa maramihang mga programa na mag-play ng audio nang sabay-sabay sa pamamagitan ng dmix),
habang naglalaro ng anumang bagay na may mas maraming channel ay magbubukas ng isa sa hardware
mga device, hal sa pamamagitan ng palibutan51 alias (karaniwang may eksklusibong access).
Kung ang manlalaro ay gagamit ng eksklusibong pag-access o hindi ay depende sa file
pinaglalaruan

Ang bagong gawi mula noong mpv 0.8.0 ay palaging nagbibigay-daan sa multichannel audio, ibig sabihin
--audio-channels=auto ay ang default. Gayunpaman, dahil ang ALSA ay hindi nagbibigay ng magandang paraan
upang i-play ang multichannel na audio sa isang hindi eksklusibong paraan (nang hindi hinaharangan ang iba
mga application mula sa paggamit ng audio), ang player ay limitado sa mga kakayahan ng
ang default device bilang default, na nangangahulugang sinusuportahan lamang nito ang stereo at mono (at
hindi bababa sa kasalukuyang karaniwang mga pagsasaayos ng ALSA). Ngunit kung ang isang hardware na aparato ay
pinili, pagkatapos ay karaniwang gagana ang multichannel na audio.

Ang maikling kuwento ay: kung gusto mo ng multichannel audio na may ALSA, gamitin --audio-device
upang piliin ang device (gamitin --audio-device=help para makakuha ng listahan ng lahat ng device at
kanilang mpv name).

Maaari mo ring subukan paggamit ang upmix isaksak. Ang setup na ito ay nagbibigay-daan sa multichannel na audio
sa default device na may awtomatikong paghahalo na may nakabahaging access, kaya naglalaro
gagana ang stereo at multichannel na audio sa parehong oras gaya ng inaasahan.

atin Driver ng output ng audio ng OSS


Itinatakda ang audio output device (default: /dev/dsp).


Itinatakda ang audio mixer device (default: /dev/mixer).


Itinatakda ang channel ng audio mixer (default: pcm). Kasama sa iba pang wastong halaga vol,
pcm, linya. Para sa kumpletong listahan ng mga opsyon, hanapin SOUND_DEVICE_NAMES in
/usr/include/linux/soundcard.h.

diyak JACK (Jack Audio Connection Kit) driver ng audio output

port=
Kumokonekta sa mga port na may ibinigay na pangalan (default: mga pisikal na port).

pangalan=
Pangalan ng kliyente na ipinasa kay JACK (default: mpv). Kapaki-pakinabang kung gusto mo
may ilang mga koneksyon na awtomatikong naitatag.

(hindi-)autostart
Awtomatikong simulan ang jackd kung kinakailangan (default: hindi pinagana). Tandaan na ito
malamang na hindi mapagkakatiwalaan at babahain ang stdout ng mga mensahe ng server.

(hindi-) kumonekta
Awtomatikong lumikha ng mga koneksyon sa mga output port (default: pinagana). Kailan
pinagana, ang maximum na bilang ng mga channel ng output ay magiging limitado sa bilang
ng mga magagamit na output port.

std-channel-layout=waveext|anuman
Piliin ang karaniwang layout ng channel (default: waveext). Si JACK mismo ay walang
paniwala ng mga layout ng channel (ibig sabihin, pagtatalaga kung aling tagapagsalita ang isang ibinigay na channel
dapat na mapa sa) - ito ay tumatagal lamang ng anumang mga output ng application, at
nire-reroute ito sa anumang tinukoy ng user. Nangangahulugan ito na ang gumagamit at ang
ang application ay namamahala sa pagharap sa layout ng channel. waveext Gumagamit
WAVE_FORMAT_EXTENSIBLE order, na, kahit na ito ay tinukoy ng
Ang Microsoft, ay ang pamantayan sa maraming mga sistema. Ang halaga anumang pinapatanggap ni JACK
anuman ang nanggagaling sa audio filter chain, anuman ang layout ng channel at
nang walang muling pag-aayos. Ang mode na ito ay malamang na hindi masyadong kapaki-pakinabang, maliban sa para sa
pag-debug o kapag ginamit sa mga nakapirming setup.

coreaudio (Mac OS X lamang)
Native Mac OS X audio output driver gamit ang AudioUnits at ang CoreAudio sound
server.

Awtomatikong nagre-redirect sa coreaudio_exclusive kapag naglalaro ng mga naka-compress na format.

baguhin-pisikal-format=
Baguhin ang pisikal na format sa isang katulad ng hiniling na format ng audio
(default: hindi). Ito ay may kalamangan na magagawa ng multichannel audio output
trabaho talaga. Ang kawalan ay mababago nito ang audio sa buong system
mga setting. Ito ay katumbas ng pagbabago ng format setting sa audio
Aparato diyalogo sa audio Midi Setup kagamitan. Tandaan na hindi ito
epekto sa napiling setup ng speaker.

eksklusibo
Gumamit ng eksklusibong mode na pag-access. Ito ay nagre-redirect lamang sa coreaudio_exclusive, Ngunit
dapat na mas gusto kaysa sa direktang paggamit ng AO na iyon.

coreaudio_exclusive (Mac OS X lamang)
Native Mac OS X audio output driver gamit ang direktang pag-access sa device at eksklusibong mode
(bypasses ang sound server).

bukas Pang-eksperimentong OpenAL audio output driver

TANDAAN:
Ang driver na ito ay hindi masyadong kapaki-pakinabang. Mabagal ang pag-play ng multi-channel na audio gamit ito.

pulso PulseAudio audio output driver

[ ][: lababo>]
Tukuyin ang host at opsyonal na output sink na gagamitin. Isang walang laman string
gumagamit ng lokal na koneksyon, ang "localhost" ay gumagamit ng paglipat ng network (malamang na hindi
anong gusto mo).

buffer=<1-2000|katutubo>
Itakda ang laki ng buffer ng audio sa millisecond. Ang mas mataas na halaga ay buffer ng mas maraming data,
at may mas mababang posibilidad ng buffer underruns. Ang isang mas maliit na halaga ay gumagawa ng
mas mabilis na tumugon ang audio stream, hal. sa mga pagbabago sa bilis ng pag-playback. Default: 250.

latency-hacks=
Paganahin ang mga hack upang malutas ang mga bug sa timing ng PulseAudio (default: hindi). Kung pinagana,
Ang mpv ay gagawa ng mga detalyadong pagkalkula ng latency sa sarili nitong. Kung hindi pinagana, ito ay
gamitin ang PulseAudio na awtomatikong na-update ang impormasyon ng timing. Hindi pagpapagana nito
maaaring makatulong sa hal. naka-network na audio o ilang plugin, habang pinapagana ito
maaaring makatulong sa ilang hindi kilalang sitwasyon (kailangan itong maging mabuti
gawi sa mga lumang bersyon ng PulseAudio).

Kung mayroon kang nauutal na video kapag gumagamit ng pulso, subukang paganahin ang opsyong ito.
(O bilang kahalili, subukang i-update ang PulseAudio.)

dsound (Windows lamang)
DirectX DirectSound audio output driver

TANDAAN:
Ang driver na ito ay para sa pagiging tugma sa mga lumang system.

aparato=
Itinatakda ang numero ng device na gagamitin. Nagpe-play ng file gamit ang -v ay magpapakita ng listahan ng
magagamit na mga aparato.

laki ng buffer=
Laki ng buffer ng DirectSound sa millisecond (default: 200).

sdl SDL 1.2+ audio output driver. Dapat gumana sa anumang platform na sinusuportahan ng SDL 1.2, ngunit
maaaring mangailangan ng SDL_AUDIODRIVER variable ng kapaligiran upang itakda nang naaangkop para sa
ang iyong system.

TANDAAN:
Ang driver na ito ay para sa compatibility sa mga sobrang dayuhang kapaligiran, tulad ng
mga system kung saan wala sa iba pang mga driver ang magagamit.

buflen=
Itinatakda ang haba ng buffer ng audio sa mga segundo. Ginagamit lamang bilang pahiwatig ng tunog
sistema. Nagpe-play ng file gamit ang -v ay magpapakita ng eksaktong hiniling at nakuha
laki ng buffer. Pinipili ng value na 0 ang default ng sound system.

bufcnt=
Itinatakda ang bilang ng mga karagdagang buffer ng audio sa mpv. Kadalasan ay hindi kailangang baguhin.

walang halaga Hindi gumagawa ng audio output ngunit pinapanatili ang bilis ng pag-playback ng video. Gamitin --ao=null:oras
para sa benchmarking.

hindi napapanahon
Huwag gayahin ang timing ng isang perpektong audio device. Nangangahulugan ito ng audio decoding
ay pupunta nang mabilis hangga't maaari, sa halip na i-timing ito sa system clock.

nagpapahina ng lakas Simulated buffer haba sa segundo.

labasan
Ginawa ang laki ng tipak sa mga sample.

pabilisin Simulate ang bilis ng pag-playback ng audio bilang isang multiplier. Karaniwan, isang tunay na audio device
hindi magiging eksaktong kasing bilis ng system clock. Ito ay lilihis lamang a
kaunti, at nakakatulong ang opsyong ito na gayahin ito.

Latency
Simulated na latency ng device. Dagdag pa ito sa EOF.

sira-eof
Gayahin ang mga sirang audio driver, na palaging nagdaragdag ng nakapirming latency ng device sa
ang naiulat na posisyon ng pag-playback ng audio.

sira-antala
Gayahin ang mga sirang audio driver, na hindi nag-uulat ng latency nang tama.

mga layout ng channel
Kung hindi walang laman, ito ay a , nakahiwalay na listahan ng mga layout ng channel na pinapayagan ng AO.
Magagamit ito para subukan ang pagpili ng layout ng channel.

pcm Raw PCM/WAVE file writer audio output

(walang-)waveheader
Isama o huwag isama ang WAVE header (default: kasama). Kapag hindi
kasama, ang raw PCM ay bubuo.

file=
Isulat ang tunog sa sa halip na ang default audiodump.wav. Kung
walang waveheader ay tinukoy, ang default ay audiodump.pcm.

(hindi-) idugtong
Idagdag sa file, sa halip na i-overwrite ito. Palaging gamitin ito kasama ang
walang waveheader opsyon - kasama waveheader sira, kasi magsusulat ng a
WAVE header sa tuwing bubuksan ang file.

rsound Audio output sa isang RSound daemon

TANDAAN:
Ganap na walang silbi, maliban kung nilayon mong patakbuhin ang RSound. Hindi dapat malito sa
RoarAudio, na isang bagay na ganap na naiiba.

host=
Itakda ang address ng server (default: localhost). Maaaring maging isang network
hostname para sa mga koneksyon sa TCP o isang Unix domain socket path na nagsisimula sa '/'.

port=
Itakda ang TCP port na ginamit para sa pagkonekta sa server (default: 12345). Hindi
ginagamit kung kumokonekta sa isang Unix domain socket.

sndio Audio output sa OpenBSD sndio sound system

TANDAAN:
Pang-eksperimento. May mga kilalang bug at isyu.

(Tandaan: sumusuporta lamang sa mono, stereo, 4.0, 5.1 at 7.1 na mga layout ng channel.)

aparato=
sndio device na gagamitin (default: $AUDIODEVICE, ayon sa pagkakabanggit snd0).

wasapi Output ng audio sa Windows Audio Session API.

eksklusibo
Humihiling ng eksklusibo, direktang pag-access sa hardware. Sa pamamagitan ng kahulugan pinipigilan ang tunog
pag-playback ng anumang iba pang programa hanggang sa lumabas ang mpv.

aparato=
Ginagamit ang hiniling na endpoint sa halip na ang default na audio endpoint ng system.
Parehong may bisa ang ordinal na numero (0,1,2,...) at ang GUID String; ang GUID
ang string ay garantisadong hindi magbabago maliban kung ang driver ay na-uninstall.

Sinusuportahan din ang paghahanap ng mga aktibong device sa pamamagitan ng nababasang pangalan ng tao. Kung higit sa
isang device ang tumutugma sa pangalan, tumangging i-load ito.

Ang opsyong ito ay halos hindi na ginagamit pabor sa mas pangkalahatan
--audio-device opsyon. Ang sabi, --audio-device=help magbibigay ng listahan ng
mga wastong GUID ng device (na may prefix na wasapi/), pati na rin ang kanilang nababasa ng tao
mga pangalan, na dapat gumana dito.

VIDEO oUTPUT MGA DRIVER

Ang mga driver ng output ng video ay mga interface sa iba't ibang mga pasilidad ng output ng video. Ang syntax ay:

--vo=
Tumukoy ng listahan ng priyoridad ng mga driver ng output ng video na gagamitin.

Kung ang listahan ay may sumusunod na ',', ang mpv ay babalik sa mga driver na wala sa listahan.
Opsyonal ang mga suboption at kadalasang maaaring tanggalin.

Maaari mo ring itakda ang mga default para sa bawat driver. Ang mga default ay inilapat bago ang normal
mga parameter ng driver.

--vo-defaults=
Itakda ang mga default para sa bawat driver.

TANDAAN:
Tingnan --vo= tulong para sa isang listahan ng mga pinagsama-samang video output driver.

Ang inirerekumendang output driver ay --vo=opengl-hq. Ang lahat ng iba pang mga driver ay para sa
pagkakatugma o mga espesyal na layunin. Bilang default, --vo=opengl ay ginagamit, ngunit kung iyon ay lilitaw
hindi gumana, bumabalik ito sa iba pang mga driver (sa parehong pagkakasunud-sunod tulad ng nakalista ng --vo= tulong).

Ang mga available na video output driver ay:

xv (X11 lamang)
Gumagamit ng XVideo extension para paganahin ang hardware-accelerated display. Ito ang pinaka
katugmang VO sa X, ngunit maaaring mababa ang kalidad, at may mga isyu sa OSD at subtitle
pagpapakita.

TANDAAN:
Ang driver na ito ay para sa pagiging tugma sa mga lumang system.

adaptor=
Pumili ng isang partikular na adaptor ng XVideo (tingnan ang mga resulta ng xvinfo).

port=
Pumili ng isang partikular na XVideo port.

ck=
Piliin ang pinagmulan kung saan kinukuha ang color key (default: cur).

cur Kinukuha ng default ang color key na kasalukuyang nakatakda sa Xv.

gamitin Gamitin ngunit huwag itakda ang color key mula sa mpv (gamitin ang --colorkey opsyon
upang baguhin ito).

itakda Pareho sa paggamit ngunit itinatakda din ang ibinigay na key ng kulay.

ck-paraan=
Itinatakda ang color key drawing method (default: man).

lalaki Iguhit nang manu-mano ang color key (binabawasan ang flicker sa ilang mga kaso).

bg Itakda ang color key bilang background ng window.

kotse Hayaang iguhit ni Xv ang color key.

colorkey=
Binabago ang color key sa isang RGB value na gusto mo. 0x000000 ay itim at
0xffffff maputi.

walang colorkey
Hindi pinapagana ang color-keying.

buffer=
Bilang ng mga buffer ng imahe na gagamitin para sa panloob na ringbuffer (default: 2).
Ang pagpapataas nito ay gagamit ng mas maraming memorya, ngunit maaaring makatulong sa X server na hindi
sapat na mabilis na pagtugon kung ang video FPS ay malapit sa o mas mataas kaysa sa
display refresh rate.

x11 (X11 lamang)
Nakabahaging memorya ng video output driver na walang hardware acceleration na gumagana kahit kailan
Ang X11 ay naroroon.

TANDAAN:
Ito ay isang fallback lamang, at hindi dapat gamitin nang normal.

vdpau (X11 lamang)
Gumagamit ng interface ng VDPAU upang ipakita at opsyonal ding mag-decode ng video. Hardware
decoding ay ginagamit sa --hwdec=vdpau.

TANDAAN:
Ang mga naunang bersyon ng mpv (at MPlayer, mplayer2) ay nagbigay ng mga sub-opsyon upang ibagay
vdpau post-processing, tulad ng deint, patalasin, denoise, chroma-deint, hilahin mo,
hqscaling. Ang mga sub-option na ito ay hindi na ginagamit, at dapat mong gamitin ang vdpaupp
video filter na lang.

patalasin=<-1-1>
(Hindi na ginagamit. Tingnan ang tala tungkol sa vdpaupp.)

Para sa mga positibong value, maglapat ng sharpening algorithm sa video, para sa negatibo
pinahahalagahan ang isang blurring algorithm (default: 0).

denoise=<0-1>
(Hindi na ginagamit. Tingnan ang tala tungkol sa vdpaupp.)

Maglapat ng algorithm sa pagbabawas ng ingay sa video (default: 0; walang ingay
pagbawas).

deint=<-4-4>
(Hindi na ginagamit. Tingnan ang tala tungkol sa vdpaupp.)

Piliin ang deinterlacing mode (default: 0). Sa mga mas lumang bersyon (pati na rin
MPlayer/mplayer2) maaari mong gamitin ang opsyong ito upang paganahin ang deinterlacing. Ito
ay hindi na gumagana, at ang deinterlacing ay pinagana sa alinman sa d susi (ni
default na naka-map sa command ikot deinterlace), o ang --deinterlace
opsyon. Gayundin, upang piliin ang default na deint mode, dapat kang gumamit ng isang bagay
gaya ng --vf-defaults=vdpaupp:deint-mode=temporal sa halip na ang sub-opsyon na ito.

0 Piliin ang vdpaupp default na filter ng video, na tumutugma sa 3.

1 Ipakita lamang ang unang field.

2 Nag-deinterlacing si Bob.

3 Motion-adaptive temporal deinterlacing. Maaaring humantong sa A/V desync sa
mabagal na video hardware at/o mataas na resolution.

4 Motion-adaptive temporal deinterlacing na may edge-guided spatial
interpolation. Kailangan ng mabilis na video hardware.

chroma-deint
(Hindi na ginagamit. Tingnan ang tala tungkol sa vdpaupp.)

Pinapatakbo ang mga temporal na deinterlacer sa luma at chroma (default). Gamitin
no-chroma-deint para lang gumamit ng luma at pabilisin ang advanced na deinterlacing.
Kapaki-pakinabang sa mabagal na memorya ng video.

hilahin mo (Hindi na ginagamit. Tingnan ang tala tungkol sa vdpaupp.)

Subukang mag-apply ng inverse telecine, nangangailangan ng motion adaptive temporal deinterlacing.

hqscaling=<0-9>
(Hindi na ginagamit. Tingnan ang tala tungkol sa vdpaupp.)

0 Gumamit ng default na VDPAU scaling (default).

1-9 Ilapat ang mataas na kalidad ng VDPAU scaling (nangangailangan ng may kakayahang hardware).

fps=
I-override ang autodetected na halaga ng refresh rate ng display (kinakailangan ang halaga para sa
framedrop upang payagan ang mga rate ng pag-playback ng video na mas mataas kaysa sa rate ng pag-refresh ng display,
at para sa vsync-aware frame timing adjustments). Ang ibig sabihin ng default 0 ay gamitin
autodetected na halaga. Ang isang positibong halaga ay binibigyang kahulugan bilang isang refresh rate sa Hz
at ino-override ang autodetected na halaga. Hindi pinapagana ng negatibong halaga ang lahat ng timing
pagsasaayos at lohika ng framedrop.

composite-detect
Ang kasalukuyang pagpapatupad ng VDPAU ng NVIDIA ay medyo naiiba sa ilalim ng a
compositing window manager at hindi nagbibigay ng tumpak na frame timing
impormasyon. Kapag pinagana ang opsyong ito, sinusubukan ng player na tuklasin kung a
Aktibo ang compositing window manager. Kung ang isa ay nakita, ang player
hindi pinapagana ang mga pagsasaayos ng timing na parang tinukoy ng user fps=-1 (bilang sila
ay batay sa maling input). Nangangahulugan ito na medyo mas kaunti ang oras
tumpak kaysa sa walang compositing, ngunit may composited mode na pag-uugali ng
ang driver ng NVIDIA, walang hard playback speed limit kahit wala ang
may kapansanan na lohika. Pinagana bilang default, gamitin walang-composite-detect huwag paganahin.

queuetime_windowed= at queuetime_fs=
Gamitin ang pagpapagana ng presentation queue ng VDPAU upang i-queue ang hinaharap na video frame
nagbabago nang mas maaga sa maraming millisecond na ito (default: 50). Tingnan sa ibaba
para sa karagdagang impormasyon.

output_surfaces=<2-15>
Ilaan ang maraming output surface na ito para magpakita ng mga video frame (default: 3). Tingnan mo
sa ibaba para sa karagdagang impormasyon.

colorkey=<#RRGGBB|#AARRGGBB>
Itakda ang kulay ng background ng pila ng presentasyon ng VDPAU, na sa pagsasanay ay ang
ginagamit ang colorkey kung gumagana ang VDPAU sa overlay mode (default: #020507, Ang ilang mga
lilim ng itim). Kung ang alpha component ng value na ito ay 0, ang default
VDPAU colorkey ang gagamitin sa halip (na kadalasang berde).

puwersa-yuv
Huwag tanggapin ang RGBA input. Nangangahulugan ito na ang mpv ay maglalagay ng isang filter upang i-convert sa a
YUV format bago ang VO. Minsan kapaki-pakinabang upang pilitin ang pagkakaroon ng ilang
Mga feature na YUV lang, tulad ng video equalizer o deinterlacing.

Gamit ang VDPAU frame queuing functionality na kinokontrol ng mga pagpipilian sa queuetime
ginagawang hindi gaanong sensitibo ang frame flip timing ng mpv sa pag-load ng CPU ng system at nagbibigay-daan ang mpv sa
simulan nang bahagya ang pag-decode ng susunod na frame, na maaaring mabawasan ang jitter na dulot
sa pamamagitan ng indibidwal na mabagal na pag-decode ng mga frame. Gayunpaman, magagawa ng mga driver ng NVIDIA graphics
iba pang pag-uugali ng window tulad ng window moves pabagu-bago kung VDPAU ay gumagamit ng blit queue
(pangunahing nangyayari kung pinagana mo ang composite extension) at ang feature na ito ay
aktibo. Kung nangyari ito sa iyong system at nakakaabala sa iyo pagkatapos ay maaari mong itakda ang
queuetime value sa 0 para i-disable ang feature na ito. Ang mga setting na gagamitin sa windowed at
Ang fullscreen mode ay hiwalay dahil walang dapat na dahilan para hindi paganahin ito
fullscreen mode (dahil ang isyu ng driver ay hindi dapat makaapekto sa mismong video).

Maaari kang mag-queue ng higit pang mga frame sa unahan sa pamamagitan ng pagtaas ng mga halaga ng queuetime at ang
output_surfaces bilang (upang matiyak ang sapat na mga ibabaw upang mag-buffer ng video para sa isang tiyak na oras
kailangan mo ng kahit gaano karaming surface gaya ng mga frame ng video sa panahong iyon,
kasama ang dalawa). Makakatulong ito na gawing mas maayos ang video sa ilang sitwasyon. Ang pangunahing kawalan
ay pinataas na mga kinakailangan sa RAM ng video para sa mga surface at mas mabagal na tugon sa display
sa mga utos ng user (makikita lamang ang mga pagbabago sa display ilang oras pagkatapos ng mga ito
nakapila). Ang pagpapatupad ng graphics driver ay maaari ding may mga limitasyon sa haba ng
maximum na oras ng pagpila o bilang ng mga nakapila na ibabaw na gumagana nang maayos o sa lahat.

direct3d_shaders (Windows lamang)
Video output driver na gumagamit ng Direct3D interface.

TANDAAN:
Ang driver na ito ay para sa compatibility sa mga system na hindi nagbibigay ng tamang OpenGL
mga driver.

mas gusto-stretchrect
paggamit IDirect3DDevice9::StretchRect sa iba pang mga pamamaraan kung maaari.

huwag paganahin-stretchrect
Huwag kailanman i-render ang video gamit IDirect3DDevice9::StretchRect.

huwag paganahin-texture
Huwag kailanman i-render ang video gamit ang D3D texture rendering. Pag-render gamit ang mga texture
+ papayagan pa rin ang shader. Idagdag disable-shaders upang ganap na huwag paganahin
pag-render ng video na may mga texture.

disable-shaders
Huwag kailanman gumamit ng mga shader kapag nagre-render ng video.

lamang-8bit
Huwag kailanman mag-render ng YUV video na may higit sa 8 bits bawat bahagi. Gamit ang watawat na ito
pipilitin ang pag-convert ng software sa 8-bit.

huwag paganahin-texture-align
Karaniwan ang mga sukat ng texture ay palaging nakahanay sa 16. Kapag pinagana ang opsyong ito,
ang texture ng video ay palaging magiging eksaktong kapareho ng laki ng video
mismo.

Mga opsyon sa pag-debug. Maaaring hindi tama ang mga ito, maaaring alisin sa hinaharap, maaaring
crash, maaaring magdulot ng pagbagal, atbp. Makipag-ugnayan sa mga developer kung talagang kailangan mo ng anuman
ng mga ito para sa pagganap o tamang operasyon.

puwersa-kapangyarihan-ng-2
Palaging pilitin ang mga texture sa lakas na 2, kahit na nag-uulat ang device
non-power-of-2 na mga sukat ng texture bilang suportado.

texture-memory=
Nakakaapekto lamang sa pagpapatakbo kapag naka-enable ang mga shader/texturing, at (E)OSD. Maaari
mga halaga:

default (default)
paggamit D3DPOOL_DEFAULT, Na may isang D3DPOOL_SYSTEMMEM texture para sa pag-lock. Kung
sinusuportahan ng driver D3DDEVCAPS_TEXTURESYSTEMMEMORY, D3DPOOL_SYSTEMMEM
ay direktang ginagamit.

default-pool
paggamit D3DPOOL_DEFAULT. (Gaya ng default, ngunit huwag gumamit ng anino-texture.)

default-pool-shadow
paggamit D3DPOOL_DEFAULT, Na may isang D3DPOOL_SYSTEMMEM texture para sa pag-lock.
(Gaya ng default, ngunit palaging pilitin ang anino-texture.)

pinamamahalaan
paggamit D3DPOOL_MANAGED.

kumamot
paggamit D3DPOOL_SCRATCH, Na may isang D3DPOOL_SYSTEMMEM texture para sa pag-lock.

swap-discard
paggamit D3DSWAPEFFECT_DISCARD, na maaaring mas mabilis. Maaaring mas mabagal din, bilang
ito ay dapat (?) i-clear ang bawat frame.

eksaktong-backbuffer
Palaging i-resize ang backbuffer sa laki ng window.

direct3d (Windows lamang)
Katulad ng direct3d_shaders, ngunit kasama ang mga pagpipilian huwag paganahin-texture at disable-shaders
pilit.

TANDAAN:
Ang driver na ito ay para sa pagiging tugma sa mga lumang system.

openl OpenGL video output driver. Sinusuportahan nito ang pinahabang pamamaraan ng pag-scale, dithering at
pamamahala ng kulay.

Bilang default, sinusubukan nitong gumamit ng mabilis at mabibigo na mga setting. Gamitin ang alias openl-hq sa
gamitin ang driver na ito na may mga default na nakatakda sa mataas na kalidad na pag-render.

Nangangailangan ng hindi bababa sa OpenGL 2.1.

Ang ilang mga tampok ay magagamit lamang sa mga driver ng graphics na may kakayahang OpenGL 3 (o kung ang
magagamit ang mga kinakailangang extension).

Ang OpenGL ES 2.0 at 3.0 ay sinusuportahan din.

Ang pag-decode ng hardware sa OpenGL-interop ay sinusuportahan sa ilang antas. Tandaan na sa
sa mode na ito, maaaring hindi maayos na pangasiwaan ang ilang case ng sulok, at color space
Ang conversion at chroma upsampling ay karaniwang nasa kamay ng hardware decoder
API.

openl gumagamit ng mga FBO bilang default. Minsan makakamit mo ang mas mahusay na kalidad o
pagganap sa pamamagitan ng pagbabago ng fbo-format suboption sa rgb16f, rgb32f or Rgb. Kilala
Kasama sa mga problema ang hindi pagtanggap ng Mesa/Intel rgb16, Mesa minsan hindi ini-compile
na may suporta sa float texture, at napakabagal ng ilang pag-setup ng OS X rgb16 pero
mabilis kasama rgb32f. Kung mayroon kang mga problema, maaari mo ring subukang ipasa ang dumb-mode=oo
sub-pagpipilian.

pipi-mode=
Ang mode na ito ay lubos na pinaghihigpitan, at idi-disable ang karamihan sa pinalawig na OpenGL
mga tampok. Kabilang dito ang mga de-kalidad na scaler at custom shader!

Ito ay inilaan para sa hardware na hindi sumusuporta sa mga FBO (kabilang ang GLES,
na hindi sapat ang suporta nito), o upang makakuha ng higit pang pagganap mula sa
masama o lumang hardware.

Awtomatikong pinipilit ang mode na ito kung kinakailangan, at kadalasan ang opsyong ito
kapaki-pakinabang para sa pag-debug. Awtomatiko rin itong pinapagana kung walang gumagamit
mga tampok na nangangailangan ng mga FBO.

Maaaring tahimik na alisin ang opsyong ito sa hinaharap.

sukat=

bilinear
Bilinear hardware texture filtering (pinakamabilis, napakababang kalidad). Ito ay
ang default para sa mga dahilan ng pagiging tugma.

spline36
Katamtamang kalidad at bilis. Ito ang default kapag ginagamit openl-hq.

lanczos
Lanczos scaling. Nagbibigay ng katamtamang kalidad at bilis. Sa pangkalahatan ay mas masahol pa kaysa sa
spline36, ngunit nagreresulta ito sa bahagyang mas matalas na imahe na mabuti para sa
ilang uri ng nilalaman. Maaaring kontrolin ang bilang ng mga gripo
sukat-radius, ngunit pinakamainam na hindi nababago.

Ang filter na ito ay tumutugma sa luma lanczos3 alias kung ang default na radius
ay ginagamit, habang lanczos2 tumutugma sa isang radius ng 2.

(Ang filter na ito ay isang alias para sa sins-nag-window sins)

ewa_lanczos
Elliptic weighted average na pag-scale ng Lanczos. Kilala rin bilang Jinc.
Medyo mabagal, ngunit napakagandang kalidad. Maaaring kontrolin ang radius gamit ang
sukat-radius. Ang pagtaas ng radius ay ginagawang mas matalas ang filter ngunit nagdaragdag
mas tugtog.

(Ang filter na ito ay isang alias para sa jinc-nag-window jinc)

ewa_lanczossharp
Isang bahagyang pinahasa na bersyon ng ewa_lanczos, na-preconfigure upang gumamit ng isang
perpektong radius at parameter. Kung kayang patakbuhin ito ng iyong hardware, malamang na ito
kung ano ang dapat mong gamitin bilang default.

mitchell
Mitchell-Netravali. Ang B at C maaaring itakda ang mga parameter gamit ang iskala-param1
at iskala-param2. Ang filter na ito ay napakahusay sa downscaling (tingnan dscale).

labis na sample
Isang bersyon ng pinakamalapit na kapitbahay na (naively) oversamples pixels, kaya na
ang mga pixel na nagsasapawan ng mga gilid ay nagiging linearly interpolated sa halip na bilugan.
Ito ay mahalagang nag-aalis ng maliliit na imperpeksyon at mga artifact ng judder
sanhi ng interpolation ng pinakamalapit na kapitbahay, kapalit ng pagdaragdag ng ilan
lumabo. Ang filter na ito ay mahusay sa temporal interpolation, at kilala rin bilang
"smoothmotion" (tingnan tscale).

pasadya Isang custom shader na tinukoy ng user (tingnan scale-shader).

May ilan pang mga filter, ngunit karamihan ay hindi gaanong kapaki-pakinabang. Para sa kumpletong listahan,
pumasa Tulungan bilang halaga, hal:

mpv --vo=opengl:scale=help

scale-param1= , sukat-param2=
Itakda ang mga parameter ng filter. Hindi papansinin kung ang filter ay hindi nakaayos. Kasalukuyan,
nakakaapekto ito sa mga sumusunod na parameter ng filter:

bcspline
Mga parameter ng spline (B at C). Default sa 0.5 para sa pareho.

gaussian
Parameter ng scale (t). Ang pagpapataas nito ay nagiging mas malabo ang resulta.
Default sa 1.

labis na sample
Pinakamababang distansya sa isang gilid bago gamitin ang interpolation. Setting
ito sa 0 ay palaging mag-interpolate sa mga gilid, samantalang ang pagtatakda nito sa 0.5
ay hindi kailanman interpolate, kaya kumikilos na parang ang regular na pinakamalapit
ginamit ang algorithm ng kapitbahay. Default sa 0.0.

scale-blur=
Kernel scaling factor (kilala rin bilang blur factor). Ang pagpapababa nito ay gumagawa
ang resulta ay mas matalas, ang pagtaas nito ay nagiging malabo (default 0). Kung nakatakda sa
0, ang ginustong blur factor ng kernel ay ginagamit. Tandaan na ang pagtatakda din nito
mababa (hal. 0.5) ay humahantong sa masamang resulta. Karaniwang inirerekomenda na manatili sa
mga halaga sa pagitan ng 0.8 at 1.2.

scale-radius=
Itakda ang radius para sa mga filter na nakalista sa ibaba, dapat ay isang float number sa pagitan ng 0.5 at
16.0. Default sa gustong radius ng filter kung hindi tinukoy.
sins at mga derivatives, jinc at mga derivatives, gaussian, kahon at tatsulok

Tandaan na depende sa mga detalye ng pagpapatupad ng filter at pag-scale ng video
ratio, maaaring iba ang radius na aktwal na ginagamit (malamang
medyo nadagdagan).

timbangan-antiring=
Itakda ang lakas ng antiringing. Sinusubukan nitong alisin ang pag-ring, ngunit maaari
ipakilala ang iba pang mga artifact sa proseso. Dapat ay isang float number sa pagitan ng 0.0
at 1.0. Ang default na halaga ng 0.0 ay ganap na hindi pinapagana ang antiringing.

Tandaan na hindi ito nakakaapekto sa mga espesyal na filter bilinear at bicubic_fast.

scale-window=
(Mga advanced na user lang) Pumili ng custom na windowing function para sa kernel.
Default sa gustong window ng filter kung hindi nakatakda. Gamitin scale-window=tulong sa
kumuha ng listahan ng mga sinusuportahang function ng windowing.

scale-wparam=
(Mga advanced na user lang) I-configure ang parameter para sa ibinigay na function ng window
by scale-window. Hindi papansinin kung ang bintana ay hindi tunable. Sa kasalukuyan, ito
nakakaapekto sa mga sumusunod na parameter ng window:

kaiser Parameter ng window (alpha). Default sa 6.33.

blackman
Parameter ng window (alpha). Default sa 0.16.

gaussian
Parameter ng sukat (t). Ang pagtaas nito ay ginagawang mas malawak ang bintana.
Default sa 1.

scaler-lut-size=<4..10>
Itakda ang laki ng lookup texture para sa mga scaler kernels (default: 6). Ang
ang aktwal na laki ng texture ay 2^N para sa isang opsyon na halaga ng N. Kaya ang lookup
ang texture na may default na setting ay gumagamit ng 64 na sample.

Ang lahat ng mga timbang ay bilinearly interpolated mula sa mga sample na iyon, kaya tumataas
ang laki ng lookup table ay maaaring mapabuti ang katumpakan ng scaler.

scaler-resizes-lamang
Huwag paganahin ang scaler kung ang larawan ng video ay hindi na-resize. Kung ganoon, bilinear
ay ginagamit sa halip kung ano ang nakatakda sa sukatan. Ipaparami ng Bilinear ang
perpektong pinagmumulan ng larawan kung walang ginagawang pag-scale. Tandaan na ang pagpipiliang ito
hindi kailanman nakakaapekto cscale.

pbo Paganahin ang paggamit ng mga PBO. Ito ay bahagyang mas mabilis, ngunit kung minsan ay maaaring humantong sa
kalat-kalat at pansamantalang katiwalian ng imahe (sa teorya, dahil ang reupload ay hindi
muling sinubukan kapag nabigo ito), at marahil ay talagang nag-trigger ng mas mabagal na mga landas sa
mga driver na hindi sumusuporta sa mga PBO ng maayos.

dither-depth=
Itakda ang dither target depth sa N. Default: hindi.

hindi Huwag paganahin ang anumang dithering na ginawa ng mpv.

kotse Awtomatikong pagpili. Kung ang output bit depth ay hindi matukoy, 8 bits
bawat bahagi ay ipinapalagay.

8 Dither sa 8 bit na output.

Tandaan na ang lalim ng nakakonektang video display device ay hindi maaaring
nakita. Kadalasan, ang mga LCD panel ay gagawa ng dithering sa kanilang sarili, na sumasalungat
sa openl's dithering at humahantong sa pangit na output.

dither-size-fruit=<2-8>
Itakda ang laki ng dither matrix (default: 6). Ang aktwal na laki ng
matrix ay (2^N) x (2^N) para sa isang opsyon na halaga ng N, kaya ang halaga ng 6 ay nagbibigay ng a
laki ng 64x64. Ang matrix ay nabuo sa oras ng pagsisimula, at isang malaking matrix
maaaring magtagal sa pagkalkula (segundo).

Ginamit sa dither=prutas mode lang.

dither=
Piliin ang dithering algorithm (default: prutas). (Karaniwan, ang dither-depth
kinokontrol ng opsyon kung pinagana ang dithering.)

temporal-dither
Paganahin ang temporal dithering. (Aktibo lang kung naka-enable ang dithering sa pangkalahatan.)
Nagbabago ito sa pagitan ng 8 magkakaibang pattern ng dithering sa bawat frame sa pamamagitan ng pagbabago
ang oryentasyon ng naka-tile na dithering matrix. Sa kasamaang palad, ito ay maaaring humantong
upang kumurap sa mga LCD display, dahil ang mga ito ay may mataas na oras ng reaksyon.

temporal-dither-period=<1-128>
Tinutukoy kung gaano kadalas ina-update ang pattern ng dithering kung kailan temporal-dither
ay ginagamit. 1 (ang default) ay mag-a-update sa bawat video frame, 2 sa bawat
ibang frame, atbp.

mag-alis ng mga insekto Tingnan kung may mga error sa OpenGL, ibig sabihin, tawag glGetError(). Humiling din ng debug na OpenGL
konteksto (na walang ginagawa sa kasalukuyang mga driver ng graphics dahil dito
pagsulat).

paghihiwalay
Bawasan ang pagkautal na dulot ng hindi pagkakatugma sa video fps at pag-refresh ng display
rate (kilala rin bilang judder).

BABALA:
Nangangailangan ito ng pagtatakda ng --video-sync opsyon sa isa sa display-
mode, o ito ay tahimik na idi-disable. Hindi ito kinakailangan bago ang mpv
0.14.0.

Ito ay mahalagang pagtatangka upang i-interpolate ang nawawalang mga frame sa pamamagitan ng convoluting
ang video sa kahabaan ng temporal axis. Ang filter na ginamit ay maaaring kontrolin gamit
ang tscale setting na ito.

Tandaan na umaasa ito sa vsync upang gumana, tingnan swapinterval para sa karagdagang
impormasyon.

swapinterval=
Interval sa mga ipinapakitang frame sa pagitan ng dalawang buffer swaps. 1 ay katumbas ng
paganahin ang VSYNC, 0 upang hindi paganahin ang VSYNC. Default sa 1 kung hindi tinukoy.

Tandaan na nakadepende ito sa tamang suporta sa OpenGL vsync. Sa ilang mga platform at
mga driver, gumagana lang ito nang mapagkakatiwalaan kapag nasa fullscreen mode. Maaari rin
nangangailangan ng mga hack na partikular sa driver kung gumagamit ng maraming monitor, upang matiyak ang mpv
nagsi-sync sa kanan. Ang pagsasama-sama ng mga tagapamahala ng window ay maaari ding humantong sa masama
mga resulta, tulad ng nawawala o hindi tamang pagpapakita ng impormasyon ng FPS (tingnan ang
--display-fps).

dscale=
katulad sukatan, ngunit ilapat ang mga filter na ito sa downscaling sa halip. Kung ang pagpipiliang ito
ay hindi nakatakda, ang filter na ipinahiwatig ng sukatan ilalapat.

cscale=
As sukatan, ngunit para sa interpolating na impormasyon ng chroma. Kung ang imahe ay hindi
subsampled, ganap na binabalewala ang opsyong ito.

tscale=
Ang filter na ginagamit para sa interpolating ng temporal axis (mga frame). Ito ay lamang
ginagamit kung paghihiwalay ay pinagana. Ang tanging wastong pagpipilian para sa tscale ay
mapaghihiwalay na mga filter ng convolution (gamitin tscale=tulong para makakuha ng listahan). Ang default
is mitchell.

Tandaan na ang maximum na sinusuportahang radius ng filter ay kasalukuyang 3, dahil sa
mga limitasyon sa bilang ng mga texture ng video na maaaring i-load
sabay-sabay.

tscale-clamp
I-clamp ang tscale i-filter ang hanay ng halaga ng kernel sa [0-1]. Binabawasan nito
labis na nagri-ring na artifact sa temporal na domain (na karaniwang nagpapakita
ang kanilang mga sarili bilang maiikling flash o fringes ng itim, karamihan sa paligid ng gumagalaw na mga gilid)
kapalit ng potensyal na pagdaragdag ng higit pang blur.

dscale-radius, cscale-radius, tscale-radius, at iba pa
Itakda ang mga parameter ng filter para sa dscale, cscale at tscale, Ayon sa pagkakabanggit.

Tingnan ang kaukulang mga opsyon para sa sukatan.

linear-scaling
Scale sa linear light. Dapat lamang itong gamitin sa a fbo-format na mayroon sa
hindi bababa sa 16 bit na katumpakan.

tamang-downscaling
Kapag gumagamit ng convolution based na mga filter, pahabain ang laki ng filter kapag
downscaling. Pinapataas ang kalidad, ngunit binabawasan ang performance habang binabawasan ang laki.

Ito ay gaganap ng bahagyang sub-optimal para sa anamorphic na video (ngunit pa rin
mas mabuti kaysa wala ito) dahil palawigin nito ang laki upang tumugma lamang sa
mas banayad sa mga kadahilanan ng sukat sa pagitan ng mga palakol.

prescale=
Nagbibigay ang opsyong ito ng mga filter na hindi nakabatay sa convolution para sa pag-upscale. Ang mga ito
binago ng mga filter ang video sa maramihang orihinal na laki (lahat sa kasalukuyan
ang mga sinusuportahang prescaler ay maaari lamang magsagawa ng pagdodoble ng imahe sa isang solong pass).
Sa pangkalahatan, isa pang convolution based na filter (ang pangunahing scaler) ang ilalapat
pagkatapos ng prescaler upang tumugma sa target na laki ng display.

wala Huwag paganahin ang lahat ng mga prescaler. Ito ang default.

superxbr
Isang medyo mabilis na prescaler na orihinal na binuo para sa pixel art.

Ang ilang mga parameter ay maaaring ibagay sa superxbr-matalim at
superxbr-edge-strength mga pagpipilian.

nnedi3 Isang artipisyal na neural network na nakabatay sa deinterlacer, na maaaring magamit upang
upscale na mga larawan.

Napakabagal at nangangailangan ng kamakailang mid o high end na graphics card upang
gumana nang maayos (sa 2015).

Tandaan na ang lahat ng mga filter sa itaas ay idinisenyo (o ipinatupad) upang iproseso
luma plane lang at malamang na hindi gagana gaya ng nilayon para sa video sa RGB na format.

prescale-passes=<1..5>
Ang bilang ng mga pass para ilapat ang prescaler (default ay 1). Pagtatakda nito
hanggang 2 ay magsasagawa ng 4x na upscaling.

prescale-downscaling-threshold=<0..32>
Pinipigilan ng opsyong ito ang "labis na paggamit" ng paggamit ng mga prescaler, na maaaring sanhi ng
misconfiguration, o sinusubukan ng user na maglaro ng video na may mas malaking sukat. Sa
ang pagpipiliang ito, maaaring tukuyin ng user ang pinakamataas na pinapayagang pagbabawas ng ratio sa pareho
sukat. Upang masiyahan ito, ang bilang ng mga pass para sa prescaler ay magiging
nabawasan, at kung kinakailangan ay maaari ding i-disable ang prescaler.

Ang default na halaga ay 2.0, at dapat na maiwasan ang karamihan sa tila
hindi makatwirang paggamit ng mga prescaler. Karamihan sa mga gumagamit ay malamang na nais na itakda ito sa a
mas maliit na halaga sa pagitan ng 1.0 at 1.5 para sa mas mahusay na pagganap.

Ang halagang mas mababa sa 1.0 ay hindi papaganahin ang tseke.

nnedi3-neurons=<16|32|64|128>
Tukuyin ang mga neuron para sa nnedi3 prescaling (mga default na 32). Ang rendering
inaasahang magiging linear ang oras sa bilang ng mga neuron.

nnedi3-window=<8x4|8x6>
Tukuyin ang laki ng lokal na window para sa sampling sa nnedi3 prescaling (mga default
upang maging 8x4). Ang 8x6 Ang window ay gumagawa ng mas matalas na mga imahe, ngunit mas mabagal din.

nnedi3-upload=
Tukuyin kung paano i-upload ang mga timbang ng NN sa GPU. Depende sa graphics card,
driver, shader compiler at nnedi3 na mga setting, ang parehong paraan ay maaaring mas mabilis o
mas mabagal.

Ubo I-upload ang mga timbang na ito sa pamamagitan ng magkatulad na buffer object. Ito ang default.
(nangangailangan ng OpenGL 3.1 / GLES 3.0)

shader Hard code ang lahat ng mga timbang sa source code ng shader. (nangangailangan
OpenGL 3.3 / GLES 3.0)

pre-shaders= , post-shaders= , scale-shader=
Custom na GLSL fragment shaders.

mga pre-shader (listahan)
Nalalapat ang mga ito pagkatapos ng conversion sa RGB at bago ang linearization
at upscaling. Gumagana sa non-linear RGB (katulad ng input). Ito ay
ang pinakamagandang lugar para maglagay ng mga bagay tulad ng patalasin ang mga filter.

scale-shader
Magagamit ito sa halip na scale/cscale kapag nakatakda ang mga opsyong iyon
pasadya. Ang colorspace na pinapatakbo nito ay depende sa mga halaga ng
linear-scaling at sigmoid-upscaling, kaya dapat walang mga pagpapalagay
ginawa dito.

post-shaders (listahan)
Nalalapat ang mga ito pagkatapos ng pag-upscale at paghahalo ng subtitle (kapag
timpla-subtitle ay pinagana), ngunit bago ang pamamahala ng kulay. Nagpapatakbo
sa linear RGB kung linear-scaling ay may bisa, kung hindi man ay hindi linear
RGB. Ito ang pinakamagandang lugar para sa mga pagbabago sa colorspace (hal.
saturation mapping).

Dapat tukuyin ng mga file na ito ang isang function na may sumusunod na lagda:

sample ng vec4(sampler2D tex, vec2 pos, vec2 tex_size)

Ang mga kahulugan ng mga parameter ay ang mga sumusunod:

sampler2D tex
Ang pinagmulang texture para sa shader.

vec2 magpaskil
Ang posisyon na isa-sample, sa coordinate space [0-1].

vec2 tex_size
Ang laki ng texture, sa mga pixel. Maaaring iba ito sa image_size,
hal. para sa subsampled na nilalaman o para sa mga post-shader.

Bilang karagdagan sa mga parameter na ito, ang mga sumusunod na uniporme ay sa buong mundo din
Available ang:

lumutang walang pili
Isang random na numero sa hanay [0-1], naiiba sa bawat frame.

int balangkas
Isang simpleng bilang ng mga frame na nai-render, tumataas ng isa sa bawat frame at
hindi kailanman nagre-reset (anuman ang hinahanap).

vec2 laki_ng larawan
Ang laki sa mga pixel ng input na imahe.

Halimbawa, ang isang shader na nagbabaligtad ng mga kulay ay maaaring magmukhang ganito:

sample ng vec4(sampler2D tex, vec2 pos, vec2 tex_size)
{
kulay ng vec4 = texture(tex, pos);
ibalik ang vec4(1.0 - color.rgb, color.a);
}

i-deband Paganahin ang debanding algorithm. Ito ay lubos na binabawasan ang dami ng nakikita
banding, blocking at iba pang quantization artifacts, sa mahal ng napaka
bahagyang lumabo ang ilan sa mga pinakamagandang detalye. Sa pagsasagawa, ito ay halos
palaging isang pagpapabuti - ang tanging dahilan upang hindi paganahin ito ay para sa
pagganap.

deband-iteration=<1..16>
Ang bilang ng mga hakbang sa pag-debanding na isasagawa sa bawat sample. Ang bawat hakbang ay nababawasan ng kaunti
mas maraming banding, ngunit nangangailangan ng oras upang makalkula. Tandaan na ang lakas ng bawat hakbang
nahuhulog nang napakabilis, kaya ang mataas na numero (>4) ay halos walang silbi.
(Default na 1)

deband-threshold=<0..4096>
Ang cut-off threshold ng debanding filter. Ang mas mataas na mga numero ay nagpapataas ng
Ang lakas ng debanding ay kapansin-pansing ngunit unti-unting binabawasan ang mga detalye ng larawan.
(Default na 64)

deband-range=<1..64>
Ang paunang radius ng debanding filter. Ang radius ay tumataas nang linear para sa
bawat pag-ulit. Ang isang mas mataas na radius ay makakahanap ng higit pang mga gradient, ngunit isang mas mababang radius
ay magiging mas agresibo. (Default 16)

Kung dagdagan mo ang deband-iteration, marahil ay dapat mong bawasan ito sa
bayaran.

deband-grain=<0..4096>
Magdagdag ng ilang dagdag na ingay sa larawan. Malaking tulong ito sa pagtakpan
natitirang mga artifact ng quantization. Ang mas mataas na mga numero ay nagdaragdag ng mas maraming ingay. (Default
48)

sigmoid-upscaling
Kapag nag-upscale, gumamit ng sigmoidal color transform upang maiwasang bigyang-diin ang pag-ring
mga artifact. Ito rin ay nagpapahiwatig linear-scaling.

sigmoid-center
Ang sentro ng sigmoid curve na ginamit para sa sigmoid-upscaling, dapat ay float
sa pagitan ng 0.0 at 1.0. Default sa 0.75 kung hindi tinukoy.

sigmoid-slope
Ang slope ng sigmoid curve na ginamit para sa sigmoid-upscaling, dapat ay float
sa pagitan ng 1.0 at 20.0. Default sa 6.5 kung hindi tinukoy.

patalasin=
Kung nakatakda sa isang value maliban sa 0, paganahin ang isang unsharp masking filter. Positibo
patalasin ng mga halaga ang imahe (ngunit magdagdag ng higit pang pag-ring at pag-alyas). Negatibo
ang mga halaga ay magpapalabo sa larawan. Kung ang iyong GPU ay sapat na malakas, isaalang-alang
mga alternatibo tulad ng ewa_lanczossharp scale filter, o ang scale-blur
sub-pagpipilian.

(Ang tampok na ito ay ang kapalit ng luma patalasin3 at patalasin5 mga scaler.)

glifinish
tawag glFinish() bago at pagkatapos magpalit ng mga buffer (default: hindi pinagana).
Mas mabagal, ngunit maaaring makatulong na makakuha ng mas magagandang resulta kapag gumagawa ng framedropping. Pwede
ganap na sumira sa pagganap. Ang mga detalye ay ganap na nakasalalay sa OpenGL
driver.

waitvsync
tawag glXWaitVideoSyncSGI pagkatapos ng bawat buffer swap (default: hindi pinagana). Ito
maaaring makatulong o hindi sa katumpakan ng timing ng video at pagbagsak ng frame. Posible
na ginagawa nitong mas mabagal ang output ng video, o walang epekto.

X11/GLX lang.

vsync-fences=
I-synchronize ang CPU sa Nth nakaraang frame gamit ang GL_ARB_sync extension. A
hindi pinapagana ng value ng 0 ang gawi na ito (default). Ang halaga ng 1 ay nangangahulugang gagawin nito
i-synchronize sa kasalukuyang frame pagkatapos i-render ito. Gusto glifinish at
waitvsync, maaari itong magpababa o makasira sa performance. Ang bentahe nito ay kaya nito
sumasaklaw sa maraming frame, at epektibong nililimitahan ang bilang ng mga frame ng GPU
mga pila sa unahan (na may impluwensya rin sa vsync).

dwmflush=
Tawag DwmFlush pagkatapos magpalit ng mga buffer sa Windows (default: auto). Ito rin
set SwapInterval(0) upang huwag pansinin ang OpenGL timing. Ang mga halaga ay: hindi (naka-disable),
naka-windowed (sa windowed mode lang), oo (sa full screen din).

Ang halaga kotse susubukang tukuyin kung aktibo ang kompositor, at
tawag DwmFlush lamang kung ito ay tila.

Maaaring makatulong ito sa pagkuha ng mas pare-parehong mga pagitan ng frame, lalo na sa
mga high-fps clip - na maaari ring bawasan ang mga nalaglag na frame. Karaniwang isang halaga
of windowed dapat sapat na dahil maaaring lampasan ng full screen ang DWM.

Windows lang.

sw Magpatuloy kahit na may nakitang software renderer.

backend=
Ang halaga kotse (ang default) ay pinipili ang windowing backend. Kaya mo rin
pumasa Tulungan upang makakuha ng kumpletong listahan ng mga pinagsama-sama sa mga backend (pinagsunod-sunod ayon sa
autoprobe order).

kotse awtomatikong piliin (default)

tsokolate Cocoa/OS X

manalo Win32/WGL

anggulo Direct3D11 sa pamamagitan ng OpenGL ES translation layer ANGLE. Ito
sumusuporta sa halos lahat ng bagay manalo ginagawa ng backend, maliban sa mga profile ng ICC,
mataas na bit depth na input ng video, at ang nnedi3 prescaler.

dxinterop (pang-eksperimentong)
Win32, gamit ang WGL para sa pag-render at Direct3D 9Ex para sa presentasyon.
Gumagana lamang sa Nvidia at AMD.

x11 X11/GLX

wayland
Wayland/EGL

drm-egl
DRM/EGL

x11egl X11/EGL

es=
Piliin kung gagamitin ang GLES:

oo Subukang mas gusto ang ES kaysa sa Desktop GL

hindi Subukang mas gusto ang desktop GL kaysa sa ES

kotse Gamitin ang default para sa bawat backend (default)

fbo-format=
Pinipili ang panloob na format ng mga texture na ginagamit para sa mga FBO. Ang format ay maaari
makaimpluwensya sa pagganap at kalidad ng output ng video. fmt maaaring isa sa:
rgb, rgba, rgb8, rgb10, rgb10_a2, rgb16, rgb16f, rgb32f, rgba12, rgba16,
rgba16f, rgba32f. Default: kotse, na nagmamapa sa rgba16 sa desktop GL, at
rgb10_a2 sa GLES (hal. ANGLE).

gamma=<0.1..2.0>
Magtakda ng gamma value (default: 1.0). Kung ang gamma ay inaayos sa ibang mga paraan (tulad ng
sa --gamma opsyon o key bindings at ang gama ari-arian), ang halaga
ay pinarami sa iba pang halaga ng gamma.

Mga inirerekomendang halaga batay sa liwanag ng kapaligiran:

1.0 Maliwanag na iluminado (default)

0.9 Medyo malabo

0.8 Itim na kwarto

gamma-auto
Awtomatikong itinatama ang gamma value depende sa ambient lighting
kundisyon (pagdaragdag ng gamma boost para sa madilim na silid).

Sa ambient illuminance na 64lux, pipiliin ng mpv ang 1.0 gamma value (hindi
boost), at bahagyang taasan ang boost hanggang 0.8 para sa 16lux.

TANDAAN: Ipinatupad lamang sa OS X.

target-prim=
Tinutukoy ang mga pangunahin ng display. Ang mga kulay ng video ay iaakma dito
colorspace kung kinakailangan. Ang mga wastong halaga ay:

kotse Huwag paganahin ang anumang adaptation (default)

bt.470m
ITU-R BT.470 M

bt.601-525
ITU-R BT.601 (525-line SD system, hal. NTSC), SMPTE 170M/240M

bt.601-625
ITU-R BT.601 (625-line SD system, hal. PAL/SECAM), ITU-R BT.470 B/G

bt.709 ITU-R BT.709 (HD), IEC 61966-2-4 (sRGB), SMPTE RP177 Annex B

bt.2020
ITU-R BT.2020 (UHD)

mansanas Apple RGB

adobe AdobeRGB (1998)

propeta
ProPhoto RGB (ROMM)

cie1931
CIE 1931 RGB (hindi malito sa CIE XYZ)

target-trc=
Tinutukoy ang mga katangian ng paglilipat (gamma) ng display. Mga kulay ng video
ay iaakma sa kurba na ito. Ang mga wastong halaga ay:

kotse Huwag paganahin ang anumang adaptation (default)

bt.1886
ITU-R BT.1886 curve, nang walang pagbaba ng liwanag (tinatayang 1.961)

srgb IEC 61966-2-4 (sRGB)

pahaba Linear na ilaw na output

gamma1.8
Pure power curve (gamma 1.8), ginagamit din para sa Apple RGB

gamma2.2
Pure power curve (gamma 2.2)

gamma2.8
Pure power curve (gamma 2.8), ginagamit din para sa BT.470-BG

propeta
ProPhoto RGB (ROMM)

icc-profile=
Mag-load ng ICC profile at gamitin ito para ibahin ang linear RGB sa screen output.
Nangangailangan ng suporta ng LittleCMS 2 na pinagsama-sama. Ino-override ng opsyong ito ang
target-prim, target-trc at icc-profile-auto mga pagpipilian.

icc-profile-auto
Awtomatikong piliin ang ICC display profile na kasalukuyang tinukoy ng
mga setting ng pagpapakita ng operating system.

TANDAAN: Sa Windows, ang default na profile ay dapat na isang ICC profile. Mga profile ng WCS
ay hindi suportado.

icc-cache-dir=
I-store at i-load ang mga 3D LUT na ginawa mula sa ICC profile sa direktoryong ito.
Magagamit ito para pabilisin ang paglo-load, dahil maaaring magtagal ang LittleCMS 2
lumikha ng isang 3D LUT. Tandaan na ang mga file na ito ay naglalaman ng mga hindi naka-compress na LUT. Ang kanilang
depende ang laki sa 3dlut-size, at maaaring maging napakalaki.

TANDAAN: Ito ay hindi awtomatikong nililinis, kaya luma, hindi nagamit na mga cache file ay maaaring
dumikit nang walang katapusan.

icc-intent=
Tinutukoy ang layunin ng ICC na ginamit para sa pagbabago ng kulay (kapag ginagamit
icc-profile).

0 pang-unawa

1 kamag-anak na colorimetric (default)

2 lunod

3 ganap na colorimetric

3dlut-size= x x
Sukat ng 3D LUT na nabuo mula sa ICC profile sa bawat dimensyon.
Ang default ay 128x256x64. Ang mga sukat ay dapat na isang kapangyarihan ng dalawa, at 512 lamang.

timpla-subtitle=
Direktang paghaluin ang mga subtitle sa mga upscaled na video frame, bago ang interpolation
at/o pamamahala ng kulay (default: hindi). Ang pagpapagana nito ay nagiging sanhi ng mga subtitle
apektado ng icc-profile, target-prim, target-trc, paghihiwalay, gama at
post-shader. Pinapataas din nito ang pagganap ng subtitle kapag gumagamit
paghihiwalay.

Ang downside ng pagpapagana nito ay ang paghihigpit ng mga subtitle sa nakikita
bahagi ng video, kaya hindi ka maaaring magkaroon ng mga subtitle sa mga itim na margin
sa ibaba ng isang video (halimbawa).

If video ay pinili, ang pag-uugali ay katulad ng oo, ngunit ang mga sub ay iginuhit sa
ang katutubong resolution ng video, at na-scale kasama ng video.

BABALA:
Binabago nito ang paraan ng paghawak ng mga kulay ng subtitle. Karaniwan, subtitle
ang mga kulay ay ipinapalagay na nasa sRGB at pinamamahalaan ang kulay tulad nito. Pinapagana ito
ginagawa silang itinuturing na nasa espasyo ng kulay ng video sa halip. Ito ay
mabuti kung gusto mong tumugma sa video ang mga bagay tulad ng softsubbed ASS signs
mga kulay, ngunit maaaring magdulot ng bahagyang pagkasira ng mga subtitle ng SRT o katulad nito.

alpha=
Nagpapasya kung ano ang gagawin kung ang input ay may alpha component (default: timpla).

maghalo Paghaluin ang frame laban sa isang itim na background.

oo Subukang lumikha ng isang framebuffer na may alpha component. Ginagawa lamang nito
pakiramdam kung ang video ay naglalaman ng alpha na impormasyon (na lubhang
bihira). Maaaring hindi suportado sa lahat ng platform. Kung alpha framebuffers
ay hindi magagamit, tahimik itong bumabalik sa isang normal na framebuffer. Tandaan
na kung itatakda mo ang fbo-format opsyon sa isang hindi default na halaga, a
dapat na tukuyin ang format na may alpha, o hindi ito gagana.

hindi Huwag pansinin ang alpha component.

parihaba-texture
Pilitin ang paggamit ng mga rectangle texture (default: hindi). Karaniwang hindi ito dapat
anumang mga pakinabang sa normal na mga texture. Tandaan na ang hardware decoding ay na-override
ang watawat na ito.

background=
Kulay na ginamit upang gumuhit ng mga bahagi ng mpv window na hindi sakop ng video. Tingnan mo
--osd-kulay opsyon kung paano tinukoy ang mga kulay.

openl-hq
Katulad ng openl, ngunit may mga default na setting para sa mataas na kalidad na pag-render.

Ito ay katumbas ng:

--vo=opengl:scale=spline36:cscale=spline36:dscale=mitchell:dither-depth=auto:correct-downscaling:sigmoid-upscaling:pbo:deband:es=no

Tandaan na ang ilang mas murang LCD ay gumagawa ng dithering na lubhang nakakasagabal openl's
dithering. Hindi pagpapagana ng dithering sa dither-depth=hindi Tinutulungan.

sdl SDL 2.0+ Render video output driver, depende sa system na mayroon o walang hardware
acceleration. Dapat gumana sa lahat ng platform na sinusuportahan ng SDL 2.0. Para sa pag-tune, sumangguni
sa iyong kopya ng file SDL_hints.h.

TANDAAN:
Ang driver na ito ay para sa compatibility sa mga system na hindi nagbibigay ng tamang graphics
mga driver, o na sumusuporta lamang sa GLES.

sw Magpatuloy kahit na may nakitang software renderer.

switch-mode
Atasan ang SDL na ilipat ang monitor video mode kapag fullscreen.

vaapi Intel VA API video output driver na may suporta para sa hardware decoding. Tandaan na
walang ganap na dahilan para gamitin ito, maliban sa gustong gumamit ng hardware
pag-decode upang makatipid ng kuryente sa mga laptop, o posibleng maiwasan ang pagpunit ng video sa ilan
mga pag-setup

TANDAAN:
Ang driver na ito ay para sa compatibility sa mga crappy system. Maaari mong gamitin ang vaapi hardware
nagde-decode gamit ang --vo=opengl masyadong.

scaling=

default
Default ng driver (default din ng mpv).

mabilis Mabilis, ngunit mababang kalidad.

hq Hindi natukoy na driver na umaasa sa mataas na kalidad na scaling, mabagal.

la hindi linya anamorphic scaling

deint-mode=
Piliin ang deinterlacing algorithm. Tandaan na bilang default ang deinterlacing ay
sa una laging naka-off, at kailangang i-enable gamit ang d key (default key
nagbubuklod para sa ikot deinterlace).

Hindi nalalapat ang opsyong ito kung sinusuportahan ng libva ang video post processing (vpp). Sa
sa kasong ito, ang default para sa deint-mode is hindi, at pagpapagana ng deinterlacing sa pamamagitan ng
ang pakikipag-ugnayan ng gumagamit gamit ang mga pamamaraan na nabanggit sa itaas ay aktwal na ipinapasok ang
vavpp filter ng video. Kung ang vpp ay hindi aktwal na suportado ng libva backend
sa paggamit, maaari mong gamitin ang opsyong ito upang puwersahang paganahin ang VO based deinterlacing.

hindi Huwag payagan ang deinterlacing (default para sa mas bagong libva).

unang-patlang
Ipakita lamang ang unang field (dumaan --field-dominance).

palutang bob deinterlacing (default para sa mas lumang libva).

scaled-osd=
Kung pinagana, ang OSD ay ire-render sa resolution ng video at i-scale sa
Resolusyon ng display. Bilang default, ito ay hindi pinagana, at ang OSD ay nai-render sa
resolution ng display kung sinusuportahan ito ng driver.

walang halaga Hindi gumagawa ng video output. Kapaki-pakinabang para sa benchmarking.

Karaniwan, mas mahusay na huwag paganahin ang video gamit ang --walang-video sa halip.

fps=
Gayahin ang display FPS. Ito ay artipisyal na nililimitahan kung gaano karaming mga frame ang VO
tumatanggap bawat segundo.

caca Color ASCII art video output driver na gumagana sa isang text console.

TANDAAN:
Joke ang driver na ito.

larawan I-output ang bawat frame sa isang file ng imahe sa kasalukuyang direktoryo. Ang bawat file ay tumatagal ng
numero ng frame na may padded na may mga nangungunang zero bilang pangalan.

format=
Piliin ang format ng file ng imahe.

jpg JPEG file, extension .jpg. (Default.)

jpeg JPEG file, extension .jpeg.

png PNG na mga file.

ppm Portable na format ng bitmap.

pgm Portable na graymap na format.

pgmyuv Portable na graymap na format, gamit ang YV12 pixel na format.

tga Truevision TGA.

png-compression=<0-9>
PNG compression factor (speed vs. file size tradeoff) (default: 7)

png-filter=<0-5>
Inilapat ang filter bago ang PNG compression (0 = wala; 1 = sub; 2 = pataas; 3 =
karaniwan; 4 = Paeth; 5 = halo-halong) (default: 5)

jpeg-quality=<0-100>
Salik ng kalidad ng JPEG (default: 90)

(no-)jpeg-progressive
Tukuyin ang pamantayan o progresibong JPEG (default: hindi).

(no-)jpeg-baseline
Tukuyin ang paggamit ng JPEG baseline o hindi (default: oo).

jpeg-optimize=<0-100>
JPEG optimization factor (default: 100)

jpeg-smooth=<0-100>
makinis na kadahilanan (default: 0)

jpeg-dpi=<1->
JPEG DPI (default: 72)

outdir=
Tukuyin ang direktoryo kung saan i-save ang mga file ng imahe (default: ./).

wayland (Wayland lamang)
Ibinahagi ng Wayland ang output ng memory video bilang fallback para sa openl.

TANDAAN:
Ang driver na ito ay para sa compatibility sa mga system na hindi nagbibigay ng gumaganang OpenGL
mga driver.

alpha Gumamit ng buffer format na sumusuporta sa mga video at larawang may alpha information

rgb565 Gamitin ang RGB565 bilang buffer format. Ang format na ito ay ipinatupad sa karamihan ng mga platform,
lalo na sa naka-embed kung saan ito ay mas mahusay kaysa sa RGB8888.

Tripleng pag-buffer
Gumamit ng 3 buffer sa halip na 2. Ito ay maaaring humantong sa mas tuluy-tuloy na pag-playback, ngunit magagamit
higit pang memorya.

openl-cb
Para sa paggamit sa libmpv direktang OpenGL na pag-embed; walang silbi sa anumang iba pang konteksto. (Tingnan
.)

Sinusuportahan din nito ang marami sa mga suboption na openl Mayroon si VO. Takbo mpv
--vo=opengl-cb:help para sa isang listahan.

Sinusuportahan din nito ang vo_cmdline utos.

rpi (Raspberry Pi)
Native na video output sa Raspberry Pi gamit ang MMAL API.

display=
Piliin ang display number kung saan dapat ipakita ang overlay ng video
(default: 0).

layer=
Piliin ang layer ng dispmanx kung saan dapat ipakita ang overlay ng video
(default: -10). Tandaan na gagamitin din ng mpv ang 2 layer sa itaas ng napili
layer, upang hawakan ang background ng window at OSD. Aktwal na pag-render ng video
mangyari sa layer sa itaas ng napiling layer.

background=
Kung magre-render ng itim na background sa likod ng video (default: hindi).
Karaniwan ito ay mas mahusay na patayin ang console framebuffer sa halip, na nagbibigay
mas magandang pagtanghal.

osd=
Pinagana bilang default. Kung hindi pinagana sa hindi, walang OSD layer na nalikha. Ito rin
nangangahulugang walang mga subtitle na ibibigay.

sabi ni drm (Direkta -Render Manager)
Driver ng output ng video gamit ang Setting ng Kernel Mode / Direct Rendering Manager. Dapat
gagamitin kapag ayaw mag-install ng full-blown na graphical na kapaligiran (hal
X). Hindi sinusuportahan ang hardware acceleration (kung kailangan mo ito, suriin ang drm-egl
backend para sa openl VO).

connector=
Piliin ang connector na gagamitin (karaniwan ay monitor ito.) Kung nakatakda sa -1, mpv
nire-render ang output sa unang available na connector. (default: -1)

devpath=
Path sa graphic card device. (default: /dev/dri/card0)

mode=
Mode ID na gagamitin (resolution, bit depth at frame rate). (default: 0)

Audio Mga filter

Nagbibigay-daan sa iyo ang mga filter ng audio na baguhin ang audio stream at ang mga katangian nito. Ang syntax ay:

--af=
I-setup ang isang hanay ng mga audio filter.

TANDAAN:
Upang makakuha ng buong listahan ng mga available na audio filter, tingnan --af=tulong.

Gayundin, tandaan na ang karamihan sa mga aktwal na filter ay magagamit sa pamamagitan ng lavfi wrapper, na
nagbibigay sa iyo ng access sa karamihan ng mga filter ng libavfilter. Kabilang dito ang lahat ng mga filter na mayroon
na-port mula sa MPlayer hanggang libavfilter.

Maaari ka ring magtakda ng mga default para sa bawat filter. Ang mga default ay inilapat bago ang normal
mga parameter ng filter.

--af-defaults=
Itakda ang mga default para sa bawat filter.

Ang mga filter ng audio ay pinamamahalaan sa mga listahan. Mayroong ilang mga utos upang pamahalaan ang listahan ng filter:

--af-add=
Idinaragdag ang mga filter na ibinigay bilang mga argumento sa listahan ng filter.

--af-pre=
Inihahanda ang mga filter na ibinigay bilang mga argumento sa listahan ng filter.

--af-del=
Tinatanggal ang mga filter sa mga ibinigay na index. Ang mga index na numero ay nagsisimula sa 0, negatibo
ang mga numero ay tumutugon sa dulo ng listahan (-1 ang huli).

--af-clr
Ganap na walang laman ang listahan ng filter.

Ang mga available na filter ay:

lavrresample[=option1:option2:...]
Gumagamit ang filter na ito ng libavresample (o libswresample, depende sa build) para baguhin
sample rate, sample na format, o layout ng channel ng audio stream. Ang filter na ito ay
awtomatikong pinagana kung hindi sinusuportahan ng audio output ang audio configuration
ng file na nilalaro.

Sinusuportahan lang nito ang mga sumusunod na sample na format: u8, s16, s32, float.

laki ng filter=
Haba ng filter na may kinalaman sa mas mababang sampling rate. (default: 16)

phase-shift=
Log2 ng bilang ng mga polyphase entries. (..., 10->1024, 11->2048, 12->4096,
...) (default: 10->1024)

cutoff=
Cutoff frequency (0.0-1.0), default set depende sa haba ng filter.

pahaba Kung nakatakda, ang mga filter ay linearly interpolated sa pagitan ng polyphase entry.
(default: hindi)

walang hiwalay
Huwag tanggalin kung magkatugma ang input at output audio format/rate/channel. (Kung ikaw
gusto lang magtakda ng mga default para sa filter na ito na gagamitin kahit ni
awtomatikong nagpasok ng lavrresample na mga pagkakataon, mas gusto mo ang setting
sila kasama --af-defaults=lavrresample:....)

gawing normal=
Kung mag-normalize kapag nire-remix ang mga layout ng channel (default: oo). Ito ay
hal. inilapat kapag hinahalo ang surround audio sa stereo. Ang advantage niyan
ginagarantiyahan nito na walang maaaring mangyari. Sa kasamaang palad, maaari din ito
humantong sa masyadong mababang mga antas ng volume. Kung paganahin mo o hindi paganahin ito ay
mahalagang bagay ng panlasa, ngunit ang default ay gumagamit ng mas ligtas na pagpipilian.

o=
Itakda ang AVOptions sa SwrContext o AVAudioResampleContext. Ang mga ito ay dapat na
dokumentado ng FFmpeg o Libav.

lavcac3enc[=tospdif[:bitrate[:minch]]]
I-encode ang multi-channel na audio sa AC-3 sa runtime gamit ang libavcodec. Sinusuportahan ang 16-bit
native-endian input format, maximum na 6 na channel. Big-endian ang output kapag
naglalabas ng raw AC-3 stream, native-endian kapag nag-output sa S/PDIF. Kung ang input
ang sample rate ay hindi 48 kHz, 44.1 kHz o 32 kHz, ito ay ire-resampling sa 48 kHz.

tospdif=
Output raw AC-3 stream kung hindi, output sa S/PDIF para sa pass-through kung oo
(default).

bitrate=
Ang paggamit ng bitrate para sa AC-3 stream. Itakda ito sa 384 para makakuha ng 384 kbps.

Ang default ay 640. Maaaring hindi ito mahawakan ng ilang receiver.

Mga wastong halaga: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320,
384, 448, 512, 576, 640.

Ang espesyal na halaga kotse pumipili ng default na bitrate batay sa input channel
numero:

1ch 96

2ch 192

3ch 224

4ch 384

5ch 448

6ch 448

minch=
Kung ang input channel number ay mas mababa sa , aalisin ang filter
mismo (default: 3).

equalizer=g1:g2:g3:...:g10
10 octave band graphic equalizer, ipinatupad gamit ang 10 IIR band-pass filter. Ito
nangangahulugan na gumagana ito anuman ang uri ng audio na pinapatugtog. Ang
Ang mga center frequency para sa 10 banda ay:

┌────┬────────────┐
│Hindi. │ dalas │
├────┼────────────┤
│0 │ 31.25 Hz │
├────┼────────────┤
│1 │ 62.50 Hz │
├────┼────────────┤
│2 │ 125.00 Hz │
├────┼────────────┤
│3 │ 250.00 Hz │
├────┼────────────┤
│4 │ 500.00 Hz │
├────┼────────────┤
│5 │ 1.00 kHz │
├────┼────────────┤
│6 │ 2.00 kHz │
├────┼────────────┤
│7 │ 4.00 kHz │
├────┼────────────┤
│8 │ 8.00 kHz │
├────┼────────────┤
│9 │ 16.00 kHz │
└────┴────────────┘

Kung ang sample rate ng tunog na pinapatugtog ay mas mababa kaysa sa gitnang frequency para sa
isang frequency band, pagkatapos ay idi-disable ang banda na iyon. Ang isang kilalang bug na may ganitong filter ay
na ang mga katangian para sa pinakamataas na banda ay hindi ganap na simetriko kung ang
ang sample rate ay malapit sa gitnang frequency ng banda na iyon. Ang problemang ito ay maaaring
nagtrabaho sa paligid sa pamamagitan ng pag-upsampling ng tunog gamit ang isang resampling filter bago ito umabot
ang filter na ito.

: : :...:
mga numero ng floating point na kumakatawan sa nakuha sa dB para sa bawat frequency band
(-12-12)

halimbawa

mpv --af=equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi
Papalakasin ang tunog sa upper at lower frequency region habang
halos ganap na kinakansela ito sa paligid ng 1 kHz.

channels=nch[:ruta]
Maaaring gamitin para sa pagdaragdag, pag-alis, pagruruta at pagkopya ng mga audio channel. Kung pwede lang
ay ibinigay, ang default na pagruruta ay ginagamit. Ito ay gumagana bilang mga sumusunod: Kung ang bilang ng mga output
Ang mga channel ay mas malaki kaysa sa bilang ng mga input channel, ang mga walang laman na channel ay ipinasok
(maliban sa paghahalo mula sa mono hanggang stereo; pagkatapos ay duplicate ang mono channel). Kung
ang bilang ng mga channel ng output ay mas mababa kaysa sa bilang ng mga channel ng input, ang
lampas sa mga channel ay pinutol.

bilang ng mga channel ng output (1-8)


Listahan ng , hiwalay na mga ruta, sa anyo from1-to1, from2-to2,.... Bawat pares
tumutukoy kung saan dadalhin ang bawat channel. Maaaring mayroong hindi hihigit sa 8 ruta. Kung wala
argument na ito, ang default na pagruruta ay ginagamit. Since , ay ginagamit din sa paghihiwalay
mga filter, dapat mong banggitin ang argumentong ito kasama ng [...] o katulad.

Mga halimbawa

mpv --af=channels=4:[0-1,1-0,2-2,3-3] media.avi
Papalitan ang bilang ng mga channel sa 4 at magse-set up ng 4 na ruta na nagpapalitan
channel 0 at channel 1 at iwanang buo ang channel 2 at 3. Obserbahan mo yan
kung ang media na naglalaman ng dalawang channel ay pinatugtog, ang channel 2 at 3 ay gagawin
naglalaman ng katahimikan ngunit mapapalitan pa rin ang 0 at 1.

mpv --af=channels=6:[0-0,0-1,0-2,0-3] media.avi
Papalitan ng 6 ang bilang ng mga channel at magse-set up ng 4 na rutang kinokopya
channel 0 hanggang channel 0 hanggang 3. Ang channel 4 at 5 ay maglalaman ng katahimikan.

TANDAAN:
Marahil ay hindi mo dapat gamitin ang filter na ito. Kung gusto mong baguhin ang output
layout ng channel, subukan ang format filter, na maaaring awtomatikong gumawa ng mpv up- at
downmix karaniwang mga layout ng channel.

format=format:srate:channels:out-format:out-srate:out-channels
Hindi gumagawa ng anumang conversion ng format mismo. Sa halip, maaari itong maging sanhi ng filter system
maglagay ng mga kinakailangang filter ng conversion bago o pagkatapos ng filter na ito kung kinakailangan. Ito ay
pangunahing kapaki-pakinabang para sa pagkontrol sa format ng audio na pumapasok sa iba pang mga filter. Upang
tukuyin ang format para sa audio output, tingnan --audio-format, --audio-samplerate, at
--audio-channel. Nagagawang pilitin ng filter na ito ang isang partikular na format, samantalang
--audio-* maaaring ma-override ng ao batay sa pagiging tugma ng output.

Ang lahat ng mga parameter ay opsyonal. Ang unang 3 parameter ay naghihigpit sa kung ano ang filter
tinatanggap bilang input. Dahil dito, magiging sanhi sila ng pagpasok ng mga filter ng conversion
bago ang isang ito. Ang palabas- sinasabi ng mga parameter ang mga filter o audio output na sumusunod
ang filter na ito kung paano i-interpret ang data nang hindi aktwal na gumagawa ng conversion. Setting
ang mga ito ay malamang na masira ang mga bagay maliban kung talagang alam mong gusto mo ito para sa ilan
dahilan, tulad ng pagsubok o pagharap sa sirang media.


Pilitin ang pag-convert sa format na ito. Gamitin --af=format=format=help para makakuha ng listahan
ng mga wastong format.


Pilitin ang conversion sa isang partikular na sample rate. Ang rate ay isang integer, 48000
halimbawa.


Pilitin ang paghahalo sa isang partikular na layout ng channel. Tingnan mo --audio-channel pagpipilian para sa
posibleng mga halaga.







NOTA: ang filter na ito ay dating pinangalanan pilitin. Ang matanda format filter na ginagawa noon
conversion mismo, hindi tulad ng isang ito na hinahayaan ang filter system na pangasiwaan ang
pagbabalik-loob

dami [= [:...]]
Nagpapatupad ng kontrol sa dami ng software. Gamitin ang filter na ito nang may pag-iingat dahil kaya nito
bawasan ang ratio ng signal sa ingay ng tunog. Sa karamihan ng mga kaso, pinakamahusay na gamitin ang
Panginoon volume control ng iyong sound card o ang volume knob sa iyong amplifier.

NOTA: Ang filter na ito ay hindi muling pumasok at samakatuwid ay maaari lamang paganahin nang isang beses para sa bawat isa
audio stream.


Itinatakda ang gustong makuha sa dB para sa lahat ng channel sa stream mula -200 dB hanggang
+60 dB, kung saan ang -200 dB ay ganap na nagmu-mute ng tunog at ang +60 dB ay katumbas ng pakinabang ng
1000 (default: 0).

replaygain-track
Isaayos ang volume gain ayon sa track-gain replaygain value na nakaimbak sa
ang file metadata.

replaygain-album
Tulad ng replaygain-track, ngunit ginagamit ang halaga ng album-gain sa halip.

replaygain-preamp
Pre-amplification gain sa dB para ilapat sa napiling replaygain gain
(default: 0).

replaygain-clip=yes|no
Pigilan ang clipping na dulot ng replaygain sa pamamagitan ng awtomatikong pagpapababa ng gain
(default). Gamitin replaygain-clip=no upang huwag paganahin ito.

replaygain-fallback
Makakuha ng dB upang mailapat kung ang file ay walang replay gain tag. Ang pagpipiliang ito ay
palaging inilalapat kung ang replaygain logic ay kahit papaano ay hindi aktibo. Kung ito ay
inilapat, walang ibang replaygain na opsyon ang inilalapat.

softclip
Ino-on ang malambot na clipping. Ang soft-clipping ay maaaring gawing mas makinis ang tunog kung napaka
mataas na antas ng volume ang ginagamit. Paganahin ang opsyong ito kung ang dynamic na hanay ng
napakababa ng mga loudspeaker.

BABALA: Ang tampok na ito ay lumilikha ng pagbaluktot at dapat ituring na huli
resort

s16 Force S16 sample format kung nakatakda. Mas mababang kalidad, ngunit maaaring mas mabilis sa ilan
sitwasyon.

tanggalin Alisin ang filter kung ang volume ay hindi nabago sa oras ng pagsasaayos ng audio filter.
Kapaki-pakinabang sa replaygain: kung ang kasalukuyang file ay walang mga tag ng replaygain, kung gayon ang
aalisin ang filter kung pinagana ang opsyong ito. (Kung --softvol=oo Ginagamit
at ang mga kontrol ng volume ng player ay ginagamit sa panahon ng pag-playback, ibang volume
ilalagay ang filter.)

halimbawa

mpv --af=volume=10.1 media.avi
Papalakasin ang tunog ng 10.1 dB at hard-clip kung ang antas ng tunog ay
masyadong mataas.

pan=n:[ ]
Pinaghahalo ang mga channel nang arbitraryo. Karaniwang kumbinasyon ng volume at mga channel
filter na maaaring gamitin upang i-down-mix ang maraming channel sa iilan lamang, hal stereo sa
mono, o iba-iba ang "lapad" ng center speaker sa isang surround sound system. Ito
Mahirap gamitin ang filter, at mangangailangan ng ilang pag-iikot bago ang ninanais na resulta
nakuha. Ang bilang ng mga opsyon para sa filter na ito ay depende sa bilang ng output
mga channel. Isang halimbawa kung paano i-downmix ang isang anim na channel na file sa dalawang channel kasama nito
Ang filter ay matatagpuan sa seksyon ng mga halimbawa malapit sa dulo.

Bilang ng mga channel ng output (1-8).


Isang listahan ng mga halaga [L00,L01,L02,...,L10,L11,L12,...,Ln0,Ln1,Ln2,...], Kung saan
bawat elemento Lij ibig sabihin kung gaano karami ng input channel i ang nahahalo sa output
channel j (saklaw 0-1). Kaya sa prinsipyo mayroon ka munang n mga numero na nagsasabi kung ano
na gagawin sa unang channel ng input, pagkatapos ay n mga numero na kumikilos sa pangalawa
input channel atbp. Kung hindi mo tinukoy ang anumang mga numero para sa ilang input
channel, 0 ang ipinapalagay. Tandaan na ang mga halaga ay pinaghihiwalay ng ,, Kung saan ay
ginamit na ng opsyong parser para paghiwalayin ang mga filter. Ito ang dahilan kung bakit kailangan mo
sipiin ang listahan ng halaga na may [...] o katulad.

Mga halimbawa

mpv --af=pan=1:[0.5,0.5] media.avi
I-downmix mula stereo hanggang mono.

mpv --af=pan=3:[1,0,0.5,0,1,0.5] media.avi
Magbibigay ng 3 channel output na umaalis sa mga channel na 0 at 1 buo, at paghaluin
channel 0 at 1 sa output channel 2 (na maaaring ipadala sa a
subwoofer halimbawa).

TANDAAN:
Kung gusto mo lang pilitin ang pag-remix sa isang partikular na layout ng output channel, ito ay
mas madaling gamitin ang format salain. Halimbawa, mpv '--af=format=channels=5.1'
'--audio-channels=5.1' palaging pipilitin ang pag-remix ng audio sa 5.1 at i-output ito
ganito.

pagkaantala[=[ch1,ch2,...]]
Inaantala ang tunog sa mga loudspeaker upang ang tunog ay mula sa iba
dumarating ang mga channel sa posisyon ng pakikinig nang sabay-sabay. Ito ay kapaki-pakinabang lamang kung ikaw
may higit sa 2 loudspeaker.

[ch1,ch2,...]
Ang pagkaantala sa ms na dapat ipataw sa bawat channel (floating point
numero sa pagitan ng 0 at 1000).

Upang kalkulahin ang kinakailangang pagkaantala para sa iba't ibang mga channel, gawin ang sumusunod:

1. Sukatin ang distansya sa mga loudspeaker sa metro kaugnay ng iyong pakikinig
posisyon, na nagbibigay sa iyo ng mga distansyang s1 hanggang s5 (para sa isang 5.1 na sistema). Walang
punto sa pagbabayad para sa subwoofer (hindi mo maririnig ang pagkakaiba
kahit papaano).

2. Ibawas ang mga distansyang s1 hanggang s5 mula sa pinakamataas na distansya, ibig sabihin s [i] = max (s) -
s[i]; i = 1 ... 5.

3. Kalkulahin ang mga kinakailangang pagkaantala sa ms as d[i] = 1000*s[i]/342; i = 1 ... 5.

halimbawa

mpv --af=delay=[10.5,10.5,0,0,7,0] media.avi
Maaantala ang kaliwa at kanan sa harap ng 10.5 ms, ang dalawang likurang channel at
ang subwoofer sa pamamagitan ng 0 ms at ang gitnang channel sa pamamagitan ng 7 ms.

drc[=paraan:target]
Naglalapat ng dynamic range compression. Pina-maximize nito ang volume sa pamamagitan ng pag-compress sa
dynamic na hanay ng signal ng audio. (Dating tinatawag volnorm.)


Itinatakda ang ginamit na paraan.

1 Gumamit ng isang sample upang pakinisin ang mga variation sa pamamagitan ng pamantayan
weighted mean sa mga nakaraang sample (default).

2 Gumamit ng ilang sample para pakinisin ang mga variation sa pamamagitan ng standard
weighted mean sa mga nakaraang sample.


Itinatakda ang target na amplitude bilang isang fraction ng maximum para sa uri ng sample
(default: 0.25).

TANDAAN:
Ang filter na ito ay maaaring magdulot ng pagbaluktot sa mga audio signal na may napakalaki
dynamic na hanay.

scaletempo[=option1:option2:...]
Sinusukat ang tempo ng audio nang hindi binabago ang pitch, opsyonal na naka-sync sa bilis ng pag-playback
(default).

Gumagana ito sa pamamagitan ng paglalaro ng 'stride' ms ng audio sa normal na bilis pagkatapos ay pagkonsumo
'stride*scale' ms ng input audio. Pinagsasama-sama nito ang mga hakbang sa pamamagitan ng paghahalo
'overlap'% ng hakbang na may audio kasunod ng nakaraang hakbang. Opsyonal ito
nagsasagawa ng maikling istatistikal na pagsusuri sa susunod na 'paghahanap' ms ng audio upang matukoy
ang pinakamahusay na overlap na posisyon.

sukat=
Nominal na halaga sa sukat ng tempo. Sinusukat ang halagang ito bilang karagdagan sa bilis.
(default: 1.0)

hakbang=
Haba sa millisecond upang ilabas ang bawat hakbang. Masyadong mataas na halaga ang magdudulot
kapansin-pansing paglaktaw sa mataas na sukat na halaga at isang echo sa mababang sukat na halaga.
Ang napakababang halaga ay magbabago sa pitch. Ang pagtaas ay nagpapabuti sa pagganap. (default:
60)

magkakapatong=
Porsiyento ng hakbang na magkakapatong. Ang pagbabawas ay nagpapabuti sa pagganap. (default:
.20)

paghahanap=
Haba sa millisecond upang maghanap ng pinakamahusay na posisyon sa pag-overlap. Bumababa
lubos na nagpapabuti sa pagganap. Sa mga mabagal na system, malamang na gusto mong itakda
napakababa nito. (default: 14)

bilis=
Itakda ang tugon sa pagbabago ng bilis.

oras I-scale ang tempo na naka-sync sa bilis (default).

alkitran Binabaliktad ang epekto ng filter. Mga scale pitch nang hindi binabago ang tempo. Idagdag
ito sa iyong input.conf sa hakbang sa pamamagitan ng mga musikal na semi-tono:

[ bilis ng multiply 0.9438743126816935
] bilis ng multiply 1.059463094352953

BABALA:
Nawawala ang pag-sync sa video.

kapwa I-scale ang parehong tempo at pitch.

wala Huwag pansinin ang mga pagbabago sa bilis.

Mga halimbawa

mpv --af=scaletempo --bilis=1.2 media.ogg
Magpapatugtog ng media sa 1.2x normal na bilis, na may audio sa normal na pitch.
Ang pagpapalit ng bilis ng pag-playback ay magbabago ng tempo ng audio upang tumugma.

mpv --af=scaletempo=scale=1.2:speed=none --bilis=1.2 media.ogg
Magpapatugtog ng media sa 1.2x normal na bilis, na may audio sa normal na pitch, ngunit
ang pagbabago ng bilis ng pag-playback ay walang epekto sa tempo ng audio.

mpv --af=scaletempo=stride=30:overlap=.50:search=10 media.ogg
Isasaayos ang mga parameter ng kalidad at pagganap.

mpv --af=format=float,scaletempo media.ogg
Gagamitin ba ang scaletempo ng float code. Siguro mas mabilis sa ilang platform.

mpv --af=scaletempo=scale=1.2:speed=pitch audio.ogg
Magpapatugtog ng media sa 1.2x normal na bilis, na may audio sa normal na pitch.
Ang pagpapalit ng bilis ng pag-playback ay magbabago ng pitch, na mag-iiwan ng tempo ng audio sa 1.2x.

goma band
Mataas na kalidad ng pitch correction na may librubberband. Ito ay maaaring gamitin bilang kapalit ng
scaletempo, at gagamitin upang ayusin ang pitch ng audio kapag nagpe-play sa iba't ibang bilis
mula sa normal.

Ang filter na ito ay may ilang mga sub-opsyon. Maaari mong ilista ang mga ito mpv
--af=rubberband=tulong. Ipapakita rin nito ang mga default na halaga para sa bawat opsyon. Ang
Ang mga opsyon ay hindi nakadokumento dito, dahil ipinasa lamang ang mga ito sa librubberband.
Tingnan ang dokumentasyon ng librubberband para malaman kung ano ang ginagawa ng bawat opsyon:
http://breakfastquay.com/rubberband/code-doc/classRubberBand_1_1RubberBandStretcher.html
(Ang pagmamapa ng mpv rubberband filter sub-option na mga pangalan at mga halaga sa mga
Ang librubberband ay sumusunod sa isang simpleng pattern: "Pagpipilian" + Pangalan + halaga.)

lavfi=graph
I-filter ang audio gamit ang libavfilter ng FFmpeg.


Libavfilter graph. Tingnan mo lavfi video filter para sa mga detalye - ang graph syntax ay
pareho.

BABALA:
Huwag kalimutang mag-quote ng mga graph ng libavfilter tulad ng inilarawan sa lavfi video
seksyon ng filter.

o=
AVOptions.

VIDEO Mga filter

Binibigyang-daan ka ng mga filter ng video na baguhin ang stream ng video at ang mga katangian nito. Ang syntax ay:

--vf=
I-setup ang isang hanay ng mga filter ng video.

Maaari ka ring magtakda ng mga default para sa bawat filter. Ang mga default ay inilapat bago ang normal
mga parameter ng filter.

--vf-defaults=
Itakda ang mga default para sa bawat filter.

TANDAAN:
Upang makakuha ng buong listahan ng mga available na filter ng video, tingnan --vf=tulong.

Gayundin, tandaan na ang karamihan sa mga aktwal na filter ay magagamit sa pamamagitan ng lavfi wrapper, na
nagbibigay sa iyo ng access sa karamihan ng mga filter ng libavfilter. Kabilang dito ang lahat ng mga filter na mayroon
na-port mula sa MPlayer hanggang libavfilter.

Ang mga filter ng video ay pinamamahalaan sa mga listahan. Mayroong ilang mga utos upang pamahalaan ang listahan ng filter.

--vf-add=
Idinaragdag ang mga filter na ibinigay bilang mga argumento sa listahan ng filter.

--vf-pre=
Inihahanda ang mga filter na ibinigay bilang mga argumento sa listahan ng filter.

--vf-del=
Tinatanggal ang mga filter sa mga ibinigay na index. Ang mga index na numero ay nagsisimula sa 0, negatibo
ang mga numero ay tumutugon sa dulo ng listahan (-1 ang huli).

--vf-clr
Ganap na walang laman ang listahan ng filter.

Sa mga filter na sumusuporta dito, maa-access mo ang mga parameter ayon sa kanilang pangalan.

--vf= = tulong
Ini-print ang mga pangalan ng parameter at mga hanay ng halaga ng parameter para sa isang partikular na filter.

--vf=
Nagtatakda ng pinangalanang parameter sa ibinigay na halaga. Gamitin ang on at off o oo at hindi para magtakda ng flag
parameter.

Ang mga available na filter ay:

i-crop[=w:h:x:y]
I-crop ang ibinigay na bahagi ng larawan at itinatapon ang natitira. Kapaki-pakinabang upang alisin ang itim
mga banda mula sa widescreen na mga video.

,
Na-crop ang lapad at taas, default sa orihinal na lapad at taas.

,
Ang posisyon ng na-crop na larawan, ang default ay nasa gitna.

palawakin[=w:h:x:y:aspect:round]
Pinapalawak (hindi mga scale) ang resolution ng video sa ibinigay na halaga at inilalagay ang hindi naka-scale
orihinal sa mga coordinate x, y.

,
Pinalawak na lapad, taas (default: orihinal na lapad, taas). Mga negatibong halaga para sa
Ang w at h ay itinuturing bilang mga offset sa orihinal na laki.

halimbawa

palawakin=0:-50:0:0
Nagdaragdag ng 50 pixel na hangganan sa ibaba ng larawan.

,
posisyon ng orihinal na larawan sa pinalawak na larawan (default: center)


Lumalawak upang magkasya sa isang aspeto sa halip na isang resolution (default: 0).

halimbawa

palawakin=800::::4/3
Lumalawak sa 800x600, maliban kung ang pinagmulan ay mas mataas na resolution, sa
kung aling kaso ito ay lumalawak upang punan ang isang 4/3 na aspeto.


Iniikot pataas upang gawing nahahati ang lapad at taas ng (default: 1).

paltik Binaligtad ang imahe.

salamin Sinasalamin ang imahe sa Y axis.

paikutin[=0|90|180|270]
Pinaikot ang larawan sa pamamagitan ng multiple na 90 degrees clock-wise.

scale[=w:h:param:param2:chr-drop:noup:arnd
Ini-scale ang larawan gamit ang software scaler (mabagal) at gumaganap ng YUV<->RGB na kulay
pagpapalit ng espasyo (tingnan din --sws).

Ang lahat ng mga parameter ay opsyonal.

:
naka-scale na lapad/taas (default: orihinal na lapad/taas)

0 naka-scale d_width/d_height

-1 orihinal na lapad/taas

-2 Kalkulahin ang w/h gamit ang ibang dimensyon at ang prescaled na aspeto
ratio.

-3 Kalkulahin ang w/h gamit ang ibang dimensyon at ang orihinal na aspeto
ratio.

-(n+8) Tulad ng -n sa itaas, ngunit ni-round ang dimensyon sa pinakamalapit na multiple ng
16.

[: ] (Tingnan ang Rin --sws)
Magtakda ng ilang parameter ng pag-scale depende sa uri ng scaler na napili
--sws:

--sws=2 (bicubic): B (blurring) at C (ringing)
0.00:0.60 default
0.00:0.75 "precise bicubic" ng VirtualDub
0.00:0.50 Catmull-Rom spline
0.33:0.33 Mitchell-Netravali spline
1.00:0.00 kubiko B-spline

--sws=7 (Gaussian): anghang (0 (malambot) - 100 (matalim))

--sws=9 (Lanczos): haba ng filter (1-10)


paglaktaw ng chroma

0 Gamitin ang lahat ng magagamit na linya ng input para sa chroma (default).

1 Gamitin lamang ang bawat 2. input line para sa chroma.

2 Gamitin lamang ang bawat 4. input line para sa chroma.

3 Gamitin lamang ang bawat 8. input line para sa chroma.

Huwag payagan ang pag-upscale lampas sa orihinal na mga dimensyon.

0 Payagan ang pag-upscale (default).

1 Huwag payagan ang pag-upscale kung ang isang dimensyon ay lumampas sa orihinal na halaga nito.

2 Huwag payagan ang pag-upscale kung ang parehong dimensyon ay lumampas sa kanilang mga orihinal na halaga.

Tumpak na pag-ikot para sa vertical scaler, na maaaring mas mabilis o mas mabagal
kaysa sa default na pag-ikot.

hindi Huwag paganahin ang tumpak na pag-ikot (default).

oo Paganahin ang tumpak na pag-round.

dsize[=w:h:aspect-method:r:aspect]
Binabago ang nilalayong laki/aspect ng display sa isang arbitrary na punto sa chain ng filter.
Ang aspeto ay maaaring ibigay bilang isang fraction (4/3) o floating point number (1.33).
Bilang kahalili, maaari mong tukuyin ang eksaktong lapad at taas ng display na nais. Tandaan
na ginagawa ng filter na ito hindi gawin ang anumang scaling mismo; ito ay nakakaapekto lamang sa kung ano ang mamaya scaler
(software o hardware) ang gagawin kapag nag-auto-scaling sa tamang aspeto.

,
Bagong lapad at taas ng display.

Maaari din itong mga espesyal na halaga:

0 orihinal na lapad at taas ng display

-1 orihinal na lapad at taas ng video (default)

-2 Kalkulahin ang w/h gamit ang ibang dimensyon at ang orihinal na display
aspect ratio.

-3 Kalkulahin ang w/h gamit ang ibang dimensyon at ang orihinal na aspeto ng video
ratio.

halimbawa

dsize=800:-2
Tumutukoy ng resolution ng display na 800x600 para sa isang 4/3 na aspetong video,
o 800x450 para sa isang 16/9 na aspetong video.


Binabago ang lapad at taas ayon sa orihinal na mga aspect ratio.

-1 Huwag pansinin ang orihinal na aspect ratio (default).

0 Panatilihin ang display aspect ratio sa pamamagitan ng paggamit at bilang pinakamataas na resolusyon.

1 Panatilihin ang display aspect ratio sa pamamagitan ng paggamit at bilang pinakamababang resolusyon.

2 Panatilihin ang aspect ratio ng video sa pamamagitan ng paggamit at bilang pinakamataas na resolusyon.

3 Panatilihin ang aspect ratio ng video sa pamamagitan ng paggamit at bilang pinakamababang resolusyon.

halimbawa

dsize=800:600:0
Tumutukoy ng display resolution na hindi hihigit sa 800x600, o mas maliit, in
upang mapanatili ang aspeto.

Iniikot pataas upang gawing nahahati ang lapad at taas ng (default: 1).


Pilitin ang isang aspect ratio.

format=fmt= :colormatrix= :...
Nililimitahan ang espasyo ng kulay para sa susunod na filter nang hindi gumagawa ng anumang conversion. Gamitin
kasama ang scale filter para sa isang tunay na conversion.

TANDAAN:
Para sa listahan ng mga available na format, tingnan format=fmt=tulong.

Format name, hal rgb15, bgr24, 420p, atbp. (default: huwag baguhin).


I-format ang pangalan na dapat palitan para sa output. Kung wala sila
ang parehong mga byte bawat pixel at chroma subsamplimg, ito ay mabibigo.


Kinokontrol ang YUV sa RGB color space conversion kapag nagpe-play ng video. meron
iba't ibang pamantayan. Karaniwan, dapat gamitin ang BT.601 para sa SD video, at BT.709
para sa HD na video. (Ginagawa ito bilang default.) Paggamit ng hindi tamang mga resulta ng color space
sa bahagyang nasa ilalim o higit sa saturated at shifted na mga kulay.

Ang mga opsyon na ito ay hindi palaging sinusuportahan. Nagbibigay ang iba't ibang mga output ng video
iba't ibang antas ng suporta. Ang openl at vdpau mga driver ng output ng video
karaniwang nag-aalok ng buong suporta. Ang xv maaaring itakda ng output ang espasyo ng kulay kung ang
Sinusuportahan ito ng driver ng video ng system, ngunit hindi ang mga antas ng input at output. Ang sukatan
Maaaring i-configure ng filter ng video ang espasyo ng kulay at mga antas ng input, ngunit kung ang
ang format ng output ay RGB (kung sinusuportahan ng driver ng video output ang RGB output, ikaw
maaaring pilitin ito sa -vf sukat, format=rgba).

Kung nakatakda ang opsyong ito sa kotse (na ang default), ang kulay ng video
space flag ang gagamitin. Kung hindi nakatakda ang flag na iyon, magiging kulay ang espasyo
awtomatikong napili. Ginagawa ito gamit ang isang simpleng heuristic na sinusubukan
upang makilala ang SD at HD na video. Kung ang video ay mas malaki sa 1279x576 pixels,
BT.709 (HD) ang gagamitin; kung hindi BT.601 (SD) ang napili.

Ang mga magagamit na puwang ng kulay ay:

kotse awtomatikong pagpili (default)

bt.601 ITU-R BT.601 (SD)

bt.709 ITU-R BT.709 (HD)

bt.2020-ncl
ITU-R BT.2020 non-constant luminance system

bt.2020-cl
ITU-R BT.2020 constant luminance system

smpte-240m
SMPTE-240M


Mga antas ng kulay ng YUV na ginamit sa conversion ng YUV sa RGB. Ang pagpipiliang ito ay lamang
kinakailangan kapag naglalaro ng mga sirang file na hindi sumusunod sa karaniwang kulay
mga antas o kung saan mali ang na-flag. Kung hindi tinukoy ng video ang kulay nito
saklaw, ito ay ipinapalagay na limitadong saklaw.

Ang parehong mga limitasyon tulad ng sa mag-aplay.

Ang mga available na hanay ng kulay ay:

kotse awtomatikong pagpili (karaniwang limitadong saklaw) (default)

limitado
limitadong saklaw (16-235 para sa luma, 16-240 para sa chroma)

ganap buong hanay (0-255 para sa parehong luma at chroma)


RGB primarya kung saan naka-encode ang source file. Karaniwan dapat na ganito
itinakda sa header ng file, ngunit kapag naglalaro ito ng mga sirang o maling pagkaka-tag na file
maaaring gamitin upang i-override ang setting.

Ang pagpipiliang ito ay nakakaapekto lamang sa mga driver ng video output na gumaganap ng kulay
pamamahala, halimbawa openl sa target-prim or icc-profile
itinakda ang mga suboption.

Kung nakatakda ang opsyong ito sa kotse (na ang default), ang video
primaries flag ang gagamitin. Kung hindi nakatakda ang flag na iyon, gagana ang color space
ay awtomatikong mapipili, gamit ang sumusunod na heuristics: Kung ang
ay itinakda o tinutukoy bilang BT.2020 o BT.709, ang
ginagamit ang mga kaukulang primarya. Kung hindi, kung ang taas ng video ay
eksaktong 576 (PAL), BT.601-625 ang ginagamit. Kung ito ay eksaktong 480 o 486 (NTSC),
Ginagamit ang BT.601-525. Kung iba ang resolution ng video, ang BT.709 ay
ginagamit.

Ang mga available na primarya ay:

kotse awtomatikong pagpili (default)

bt.601-525
ITU-R BT.601 (SD) 525-line system (NTSC, SMPTE-C)

bt.601-625
ITU-R BT.601 (SD) 625-line system (PAL, SECAM)

bt.709 ITU-R BT.709 (HD) (parehong primarya gaya ng sRGB)

bt.2020
ITU-R BT.2020 (UHD)

mansanas Apple RGB

adobe AdobeRGB (1998)

propeta
ProPhoto RGB (ROMM)

cie1931
CIE 1931 RGB


Gamma function kung saan naka-encode ang source file. Karaniwan dapat ito
itakda sa header ng file, ngunit kapag naglalaro ng mga sirang o maling pagkaka-tag ng mga file
magagamit ito para i-override ang setting.

Ang pagpipiliang ito ay nakakaapekto lamang sa mga driver ng video output na gumaganap ng kulay
pamamahala.

Kung nakatakda ang opsyong ito sa kotse (na ang default), gagawin ng gamma
itakda sa BT.1886 para sa YCbCr content, sRGB para sa RGB na content at Linear
para sa nilalaman ng XYZ.

Ang mga magagamit na gamma function ay:

kotse awtomatikong pagpili (default)

bt.1886
ITU-R BT.1886 (approximation ng BT.601/BT.709/BT.2020 curve)

srgb IEC 61966-2-4 (sRGB)

pahaba Linear na ilaw

gamma1.8
Pure power curve (gamma 1.8)

gamma2.2
Pure power curve (gamma 2.2)

gamma2.8
Pure power curve (gamma 2.8)

propeta
ProPhoto RGB (ROMM) curve


Itakda ang stereo mode kung saan ipinapalagay na naka-encode ang video. Ganun din
mga halaga bilang ang --video-stereo-mode pagpipilian.


Itakda ang stereo mode na dapat ipakita ang video bilang. Kinukuha ang parehong mga halaga
bilang --video-stereo-mode pagpipilian.


Itakda ang pag-ikot na ipinapalagay na naka-encode ang video sa mga degree. Ang
espesyal na halaga -1 gumagamit ng format ng pag-input.

,
Itakda ang laki ng display. Tandaan na ang pagtatakda ng laki ng display ay ang video
ay naka-scale sa parehong direksyon sa halip na baguhin lamang ang aspect ratio ay isang
detalye ng pagpapatupad, at maaaring magbago sa ibang pagkakataon.

Itakda ang display aspect ratio ng video frame. Ito ay isang float, ngunit mga halaga
tulad ng [16: 9] makapasa din ([...] para sa pagsipi upang maiwasan ang opsyon
parser mula sa pagbibigay-kahulugan sa : tauhan).

noformat[=fmt]
Nililimitahan ang espasyo ng kulay para sa susunod na filter nang hindi gumagawa ng anumang conversion. Unlike
ang filter ng format, papayagan nito ang anumang espasyo ng kulay maliban sa tinukoy mo.

TANDAAN:
Para sa listahan ng mga available na format, tingnan noformat=fmt=help.

Pangalan ng format, hal rgb15, bgr24, 420p, atbp. (default: 420p).

lavfi=graph[:sws-flags[:o=opts]]
I-filter ang video gamit ang libavfilter ng FFmpeg.


Ang libavfilter graph string. Ang filter ay dapat may isang video input pad
at isang solong video output pad.

Tingnan https://ffmpeg.org/ffmpeg-filters.html para sa syntax at magagamit na mga filter.

BABALA:
Kung gusto mong gamitin ang buong filter syntax sa opsyong ito, kailangan mo
quote ang filter graph upang maiwasan ang syntax ng mpv at ang filter
graph syntax mula sa clashing.

Mga halimbawa

-vf lavfi=[gradfun=20:30,vflip]
gradfun filter na may mga parameter na walang kapararakan, na sinusundan ng a vflip
salain. (Ipinapakita nito kung paano kumukuha ng graph ang libavfilter at hindi
iisang filter lang.) Ang filter graph string ay sinipi na may [
at ]. Hindi ito nangangailangan ng karagdagang pagsipi o pagtakas kasama ng ilan
shell (tulad ng bash), habang ang iba (tulad ng zsh) ay nangangailangan ng karagdagang "
mga quote sa paligid ng pagpipiliang string.

'--vf=lavfi="gradfun=20:30,vflip"'
Katulad ng dati, ngunit gumagamit ng panipi na dapat ay ligtas sa lahat
mga shell. Ang panlabas ' quotes siguraduhin na ang shell ay hindi
alisin ang " quotes na kailangan ng mpv.

'--vf=lavfi=graph="gradfun=radius=30:strength=20,vflip"'
Katulad ng dati, ngunit gumagamit ng pinangalanang mga parameter para sa lahat.


Kung maglalagay ang libavfilter ng mga filter para sa conversion ng pixel format, ang opsyong ito
nagbibigay ng mga flag na dapat ipasa sa libswscale. Ang pagpipiliang ito ay numero
at tumatagal ng medyo matalinong kumbinasyon ng SWS_ mga watawat.

Tingnan http://git.videolan.org/?p=ffmpeg.git;a=blob;f=libswscale/swscale.h.

Itakda ang mga opsyon sa AVFilterGraph. Dapat itong idokumento ng FFmpeg.

halimbawa

'--vf=lavfi=yadif:o="threads=2,thread_type=slice"'
pinipilit ang isang tiyak na configuration ng threading.

eq[=gamma:contrast:brightness:saturation:rg:gg:bg:weight]
Software equalizer na gumagamit ng mga lookup table (mabagal), na nagpapahintulot sa gamma correction in
karagdagan sa simpleng pagsasaayos ng liwanag at kaibahan. Ang mga parameter ay ibinibigay bilang
mga halaga ng floating point.

<0.1-10>
paunang halaga ng gamma (default: 1.0)

<-2-2> paunang kaibahan, kung saan ang mga negatibong halaga ay nagreresulta sa isang negatibong larawan (default:
1.0)

<-1-1> paunang liwanag (default: 0.0)

<0-3> paunang saturation (default: 1.0)

<0.1-10>
halaga ng gamma para sa pulang bahagi (default: 1.0)

<0.1-10>
halaga ng gamma para sa berdeng bahagi (default: 1.0)

<0.1-10>
halaga ng gamma para sa asul na bahagi (default: 1.0)

<0-1> Maaaring gamitin ang parameter ng timbang upang bawasan ang epekto ng mataas na halaga ng gamma
sa maliwanag na mga lugar ng imahe, hal. pigilan ang mga ito sa sobrang pagpapalakas at patas
purong puti. Ang halaga na 0.0 ay bumababa sa gamma correction
habang iniiwan ito ng 1.0 sa buong lakas nito (default: 1.0).

pullup[=jl:jr:jt:jb:sb:mp]
Pulldown reversal (inverse telecine) filter, na may kakayahang pangasiwaan ang halo-halong
hard-telecine, 24000/1001 fps progressive, at 30000/1001 fps progressive content.
Ang hilahin mo ginagamit ng filter ang konteksto sa hinaharap sa paggawa ng mga desisyon nito. Ito ay
stateless sa diwa na hindi ito naka-lock sa isang pattern na susundan, ngunit ito
sa halip ay umaasa sa mga sumusunod na field upang matukoy ang mga tugma at
muling buuin ang mga progresibong frame.

jl, jr, jt, at jb
Itinatakda ng mga opsyong ito ang dami ng "junk" na babalewalain sa kaliwa, kanan, itaas,
at ibaba ng larawan, ayon sa pagkakabanggit. Ang kaliwa/kanan ay nasa mga unit na 8 pixels,
habang ang itaas/ibaba ay nasa mga yunit ng 2 linya. Ang default ay 8 pixel sa bawat isa
panig.

sb (mahigpit break)
Ang pagtatakda ng opsyong ito sa 1 ay magbabawas sa mga pagkakataong hilahin mo pagbuo ng isang
paminsan-minsang hindi tugmang frame, ngunit maaari rin itong magdulot ng labis na bilang ng
mga frame na ihuhulog sa panahon ng mga high motion sequence. Sa kabaligtaran, ang pagtatakda nito
to -1 ang gagawin hilahin mo mas madaling tumugma sa mga field. Ito ay maaaring makatulong sa pagproseso ng
video kung saan may bahagyang paglabo sa pagitan ng mga field, ngunit maaari ring magdulot
magkakaroon ng interlaced na mga frame sa output.

mp (sukatan eroplano)
Maaaring itakda ang opsyong ito sa u or v na gumamit ng chroma plane sa halip na luma
eroplano para gawin hilahin momga kalkulasyon. Ito ay maaaring mapabuti ang katumpakan sa napaka
malinis na pinagmumulan ng materyal, ngunit mas malamang na bawasan ang katumpakan, lalo na kung
may chroma noise (rainbow effect) o anumang grayscale na video. Pangunahing
layunin ng pagtatakda mp sa isang chroma plane ay upang bawasan ang pagkarga ng CPU at gawin
pullup magagamit sa realtime sa mabagal machine.

yadif=[mode:interlaced-only]
Isa pang deinterlacing na filter



balangkas Output 1 frame para sa bawat frame.

parang Output 1 frame para sa bawat field.

frame-nospatial
katulad balangkas ngunit nilalaktawan ang spatial interlacing check.

field-nospatial
katulad parang ngunit nilalaktawan ang spatial interlacing check.



hindi I-deinterlace ang lahat ng mga frame (default).

oo Ang mga deinterlace na frame lang ang minarkahan bilang interlaced (default kung ang filter na ito
ay ipinasok sa pamamagitan ng deinterlace pag-aari).

Ang filter na ito, ay awtomatikong ipinapasok kapag ginagamit ang d key (o anumang iba pang key na
pinapalipat-lipat ang deinterlace ari-arian o kapag ginagamit ang --deinterlace switch), ipagpalagay
ang output ng video ay walang suporta sa katutubong deinterlacing.

Kung gusto mo lang itakda ang default na mode, ilagay ang filter na ito at ang mga opsyon nito
--vf-defaults sa halip, at paganahin ang deinterlacing sa d or --deinterlace.

Tandaan din na ang d Ang susi ay sapat na hangal upang magpasok ng isang deinterlacer nang dalawang beses kapag
pagsingit ng yadif na may --vf, kaya inirerekomenda ang paggamit ng mga pamamaraan sa itaas.

sub=[=bottom-margin:top-margin]
Inililipat ang pag-render ng subtitle sa isang arbitrary na punto sa chain ng filter, o puwersa
pag-render ng subtitle sa filter ng video kumpara sa paggamit ng video output OSD
support.


Nagdaragdag ng itim na banda sa ibaba ng frame. Maaaring ilagay ng SSA/ASS renderer
mga subtitle doon (na may --sub-use-margin).


Itim na banda sa itaas para sa mga toptitle (na may --sub-use-margin).

Mga halimbawa

--vf=sub,eq
Inililipat ang sub rendering bago ang eq filter. Ilalagay nito ang parehong subtitle
mga kulay at video sa ilalim ng impluwensya ng mga setting ng video equalizer.

stereo3d[=in:out]
Nagko-convert ang Stereo3d sa pagitan ng iba't ibang stereoscopic na format ng imahe.

Stereoscopic na format ng imahe ng input. Mga posibleng halaga:

sbsl or side_by_side_left_first
magkatabi parallel (kaliwang mata sa kaliwa, kanang mata sa kanan)

sbsr or side_by_side_right_first
magkatabi na crosseye (kanang mata sa kaliwa, kaliwang mata sa kanan)

abl or above_below_left_first
itaas-ibaba (kaliwang mata sa itaas, kanang mata sa ibaba)

abr or above_below_right_first
itaas-ibaba (kanang mata sa itaas, kaliwang mata sa ibaba)

ab2l or above_below_half_height_left_first
sa itaas-ibaba na may kalahating taas na resolution (kaliwang mata sa itaas, kanang mata
sa ibaba)

ab2r or above_below_half_height_right_first
itaas-ibaba na may kalahating taas na resolution (kanang mata sa itaas, kaliwang mata
sa ibaba)

Stereoscopic na format ng imahe ng output. Ang mga posibleng halaga ay ang lahat ng input
mga format pati na rin ang:

arcg or anaglyph_red_cyan_gray
anaglyph red/cyan grey (red filter sa kaliwang mata, cyan filter sa kanan
mata)

arko or anaglyph_red_cyan_half_color
anaglyph pula/cyan kalahating kulay (pulang filter sa kaliwang mata, cyan filter
sa kanang mata)

arcc or anaglyph_red_cyan_color
anaglyph red/cyan color (red filter sa kaliwang mata, cyan filter sa kanan
mata)

arcd or anaglyph_red_cyan_dubois
anaglyph red/cyan na kulay na na-optimize na may hindi bababa sa mga parisukat na projection
ng Dubois (pulang filter sa kaliwang mata, cyan filter sa kanang mata)

agmg or anaglyph_green_magenta_gray
anaglyph green/magenta gray (berdeng filter sa kaliwang mata, magenta filter
sa kanang mata)

agmh or anaglyph_green_magenta_half_color
anaglyph berde/magenta kalahating kulay (berdeng filter sa kaliwang mata,
magenta filter sa kanang mata)

agmc or anaglyph_green_magenta_color
anaglyph green/magenta colored (berdeng filter sa kaliwang mata, magenta
filter sa kanang mata)

aybg or anaglyph_yellow_blue_gray
anaglyph dilaw/asul na kulay abo (dilaw na filter sa kaliwang mata, asul na filter sa
kanang mata)

aybh or anaglyph_yellow_blue_half_color
anaglyph dilaw/asul na kalahating kulay (dilaw na filter sa kaliwang mata, asul
filter sa kanang mata)

aybc or anaglyph_yellow_blue_color
anaglyph dilaw/asul na kulay (dilaw na filter sa kaliwang mata, asul na filter
sa kanang mata)

irl or interleave_rows_left_first
Mga interleaved na row (ang kaliwang mata ay may tuktok na row, ang kanang mata ay nagsisimula sa susunod na row)

irr or interleave_rows_right_first
Mga interleaved na row (ang kanang mata ay nasa itaas na row, ang kaliwang mata ay nagsisimula sa susunod na row)

ml or mono_left
mono output (kaliwang mata lang)

mr or mono_right
mono output (kanang mata lang)

gradfun[=lakas[:radius|:laki= ]]
Ayusin ang mga banding artifact na kung minsan ay ipinapasok sa halos patag na mga rehiyon ng
pagputol sa 8-bit na lalim ng kulay. Inuugnay ang mga gradient na dapat pumunta kung saan
ang mga banda ay, at dithers sila.


Pinakamataas na halaga kung saan babaguhin ng filter ang anumang isang pixel. Pati yung
threshold para sa pag-detect ng halos patag na mga rehiyon (default: 1.5).


Kapitbahayan upang magkasya ang gradient sa. Ang mas malaking radius ay ginagawang mas makinis
gradients, ngunit pinipigilan din ang filter na baguhin ang mga pixel na malapit sa detalyado
mga rehiyon (default: hindi pinagana).

laki ng filter sa porsyento ng diagonal na laki ng imahe. Nakasanayan na ito
kalkulahin ang panghuling laki ng radius (default: 1).

dlopen=dll[:a0[:a1[:a2[:a3]]]]
Naglo-load ng panlabas na library upang i-filter ang larawan. Ang interface ng library ay ang
vf_dlopen interface na tinukoy gamit libmpcodecs/vf_dlopen.h.

BABALA:
Hindi na ginagamit ang filter na ito.

dll=
Tukuyin ang library na ilo-load. Ito ay maaaring mangailangan ng isang buong file system path sa
Sa ibang mga kaso. Ang argumentong ito ay kinakailangan.

a0=
Tukuyin ang unang parameter na ipapasa sa library.

a1=
Tukuyin ang pangalawang parameter na ipapasa sa library.

a2=
Tukuyin ang ikatlong parameter na ipapasa sa library.

a3=
Tukuyin ang ikaapat na parameter na ipapasa sa library.

vaporsynth=file:buffered-frames:concurrent-frames
Naglo-load ng script ng filter ng VapourSynth. Ito ay inilaan para sa naka-stream na pagproseso: mpv
talagang nagbibigay ng source na filter, sa halip na gumamit ng native na VapourSynth video
pinagmulan. Sasagutin ng mpv source ang mga kahilingan sa frame sa loob lamang ng maliit na window ng
mga frame (ang laki ng window na ito ay kinokontrol ng buffered-frame parameter),
at ang mga kahilingan sa labas nito ay magbabalik ng mga error. Dahil dito, hindi mo magagamit nang buo
kapangyarihan ng VapourSynth, ngunit maaari kang gumamit ng ilang mga filter.

Kung gusto mo lang maglaro ng video na nabuo ng isang VapourSynth (ibig sabihin, gamit ang isang native
VapourSynth video source), mas magandang gamitin vspipe at isang FIFO para pakainin ang video
sa mpv. Ang parehong naaangkop kung ang filter na script ay nangangailangan ng random na pag-access sa frame (tingnan
buffered-frame parameter).

Ang filter na ito ay pang-eksperimento. Kung ito ay lumabas na ito ay gumagana nang maayos at ginagamit, ito
ipo-port sa libavfilter. Kung hindi, ito ay tatanggalin lamang.

file Filename ng script source. Sa kasalukuyan, ito ay palaging isang script ng python.
Ang variable video_in ay nakatakda sa mpv video source, at ito ay inaasahan
na ang script ay nagbabasa ng video mula dito. (Kung hindi, ang mpv ay hindi magde-decode ng video,
at ang pila ng packet ng video ay aapaw, sa kalaunan ay humahantong sa pagiging audio
huminto.) Inaasahan ding dadaan ang script sa mga timestamp gamit ang
_DurationNum at _DurationDen mga katangian ng frame.

Halimbawa:

mag-import ng vaporsynth bilang vs
core = vs.get_core()
core.std.AddBorders(video_in, 10, 10, 20, 20).set_output()

BABALA:
Ire-reload ang script sa bawat paghahanap. Ginagawa ito upang i-reset ang
salain nang maayos sa mga discontinuities.

buffered-frame
Pinakamataas na bilang ng mga na-decode na video frame na dapat i-buffer bago ang
filter (default: 4). Tinutukoy nito ang maximum na bilang ng mga frame sa script
maaaring humiling pabalik. Hal kung buffered-frames=5, at ang script lang
humiling ng frame 15, maaari pa rin itong humiling ng frame 10, ngunit ang frame 9 ay hindi
magagamit na. Kung humiling ito ng frame 30, ang mpv ay magde-decode ng 15 pang mga frame,
at panatilihin lamang ang mga frame 25-30.

Ang aktwal na bilang ng mga buffered na frame ay nakadepende rin sa halaga ng
concurrent-frames opsyon. Sa kasalukuyan, ang parehong mga halaga ng opsyon ay pinarami sa
makuha ang panghuling laki ng buffer.

(Karaniwan, ang mga filter ng mapagkukunan ng VapourSynth ay dapat magbigay ng random na pag-access, ngunit ang mpv
ay ginawa para sa pag-playback, at hindi nagbibigay ng frame-eksaktong random na pag-access. Ang
Ang paraan ng paggana ng filter ng video na ito ay isang kompromiso para gumana ang mga simpleng filter
gayon pa man.)

concurrent-frames
Bilang ng mga frame na dapat hilingin nang magkatulad. Ang antas ng
Ang concurrency ay depende sa filter at kung gaano kabilis ma-decode ng mpv ang video
pakainin ang filter. Ang halagang ito ay dapat na proporsyonal sa bilang ng
mga core sa iyong makina. Kadalasan, ginagawa itong mas mataas kaysa sa bilang ng mga core
maaari talagang gawin itong mas mabagal.

Bilang default, ginagamit nito ang espesyal na halaga kotse, na nagtatakda ng opsyon sa
bilang ng mga nakitang lohikal na CPU core.

Ang mga sumusunod na variable ay tinukoy ng mpv:

video_in
Ang mpv video source bilang vaporsynth clip. Tandaan na wala itong nakatakdang haba,
na nakakalito sa maraming mga filter. Gamit Hinukuhan sa clip na may mataas na haba ng dummy
maaari itong gawing isang may hangganang clip.

video_in_dw, video_in_dh
Laki ng display ng video. Maaaring iba sa laki ng video kung ang video
ay hindi gumagamit ng mga square pixel (hal. DVD).

container_fps
Ang halaga ng FPS tulad ng iniulat ng mga header ng file. Maaaring mali o ganap ang halagang ito
sira (hal. 0 o NaN). Kahit na ang halaga ay tama, kung isa pang filter
binabago ang totoong FPS (sa pamamagitan ng pag-drop o pagpasok ng mga frame), ang halaga nito
variable ay maaaring hindi kapaki-pakinabang. Tandaan na ang --fps opsyon sa command line
nilalampasan ang halagang ito.

Kapaki-pakinabang para sa ilang mga filter na nagpipilit na magkaroon ng FPS.

display_fps
Refresh rate ng kasalukuyang display. Tandaan na ang value na ito ay maaaring 0.

vaporsynth-tamad
Katulad ng vaporsynth, ngunit hindi naglo-load ng mga script ng Python. Sa halip, isang custom na backend
gamit ang Lua at ang raw VapourSynth API ay ginagamit. Ang syntax ay ganap na naiiba,
at ganap na walang mga tampok na kaginhawaan ay ibinigay. Walang uri ng pagsusuri
alinman, at maaari kang mag-trigger ng mga pag-crash.

Halimbawa:

video_out = invoke("morpho", "Open", {clip = video_in})

Ang espesyal na variable video_in ay ang mpv video source, habang ang espesyal na variable
pagbibidyo sa labas ay ginagamit upang basahin ang video mula sa. Ang 1st argument ay ang plugin (tinanong gamit ang
getPluginByNs), ang ika-2 ay ang pangalan ng filter, at ang ika-3 argumento ay isang talahanayan na may
ang mga argumento. Hindi sinusuportahan ang mga posisyong argumento. Dapat magkatugma ang mga uri
eksakto. Dahil ang Lua ay kakila-kilabot at hindi matukoy ang mga integer at float, integer
ang mga argumento ay dapat na may prefix na i_, kung saan ang prefix ay aalisin at ang
Ang argumento ay inihagis sa isang integer. Dapat bang magsimula ang pangalan ng argumento sa i_, ikaw ay
wala sa swerte.

Ang mga clip (VSNodeRef) ay ipinasa bilang light userdata, kaya sinusubukang ipasa ang anuman
ang uri ng userdata ay magreresulta sa mga matitigas na pag-crash.

vavpp Pagproseso ng post ng video ng VA-AP-API. Gumagana sa --vo=vaapi at --vo=opengl lamang.
Kasalukuyang deinterlaces. Awtomatikong ipinapasok ang filter na ito kung ang deinterlacing ay
hiniling (gamit ang d key, bilang default na naka-map sa command ikot
deinterlace, O ang --deinterlace pagpipilian).

deint=
Piliin ang deinterlacing algorithm.

hindi Huwag magsagawa ng deinterlacing.

unang-patlang
Ipakita lamang ang unang field (dumaan --field-dominance).

palutang bob deinterlacing (default).

habi, motion-adaptive, motion-compensated
Mga advanced na deinterlacing algorithm. Kung talagang gumagana ang mga ito
depende sa GPU hardware, sa mga GPU driver, driver bug, at mpv
mga bug



hindi I-deinterlace ang lahat ng mga frame.

oo Tanging ang mga deinterlace na frame na minarkahan bilang interlaced (default).

vdpaupp
VDPAU video post processing. Gumagana sa --vo=vdpau at --vo=opengl lamang. Ito
Awtomatikong ipinapasok ang filter kung hihilingin ang deinterlacing (gamit ang d
key, bilang default na naka-map sa command ikot deinterlace, O ang --deinterlace
opsyon). Kapag pinapagana ang deinterlacing, ito ay palaging ginustong kaysa sa software
deinterlacer filter kung ang vdpau Ginagamit ang VO, at kung openl ay ginagamit at
na-activate ang hardware decoding kahit isang beses lang (ibig sabihin, na-load ang vdpau).

patalasin=<-1-1>
Para sa mga positibong value, maglapat ng sharpening algorithm sa video, para sa negatibo
pinahahalagahan ang isang blurring algorithm (default: 0).

denoise=<0-1>
Maglapat ng algorithm sa pagbabawas ng ingay sa video (default: 0; walang ingay
pagbawas).

deint=
Kung pinagana ang deinterlacing (default: hindi). Kung pinagana, gagamitin nito ang
napili ang mode gamit ang deint-mode.

deint-mode=
Piliin ang deinterlacing mode (default: temporal). Lahat ng mga mode ay gumagalang
--field-dominance.

Tandaan na kasalukuyang may mekanismo na nagpapahintulot sa vdpau VO na magbago
ang deint-mode ng awtomatikong ipinasok vdpaupp mga filter. Upang maiwasan ang pagkalito, ito ay
inirerekomenda na huwag gamitin ang --vo=vdpau mga subopsyon na nauugnay sa pag-filter.

unang-patlang
Ipakita lamang ang unang field.

palutang Nag-deinterlacing si Bob.

pansamantala
Motion-adaptive temporal deinterlacing. Maaaring humantong sa A/V desync sa
mabagal na video hardware at/o mataas na resolution.

temporal-spatial
Motion-adaptive temporal deinterlacing na may edge-guided spatial
interpolation. Kailangan ng mabilis na video hardware.

chroma-deint
Pinapatakbo ang mga temporal na deinterlacer sa luma at chroma (default). Gamitin
no-chroma-deint para lang gumamit ng luma at pabilisin ang advanced na deinterlacing.
Kapaki-pakinabang sa mabagal na memorya ng video.

hilahin mo Subukang mag-apply ng inverse telecine, nangangailangan ng motion adaptive temporal deinterlacing.

interlaced-only=
If oo (default), mga deinterlace na frame lang ang minarkahan bilang interlaced.

hqscaling=<0-9>

0 Gumamit ng default na VDPAU scaling (default).

1-9 Ilapat ang mataas na kalidad ng VDPAU scaling (nangangailangan ng may kakayahang hardware).

vdpaurb
VDPAU video read back. Gumagana sa --vo=vdpau at --vo=opengl lamang. Ang filter na ito
ay magbabasa pabalik ng mga frame na na-decode ng VDPAU upang ang iba pang mga filter, na hindi
karaniwang katugma sa VDPAU, maaaring gamitin tulad ng normal. Ang filter na ito ay dapat na
tinukoy noon vdpaupp sa filter chain kung vdpaupp Ginagamit.

buffer=
Nagpapahina ng lakas mga frame sa chain ng filter. Ang filter na ito ay malamang na walang silbi,
maliban sa pag-debug. (Tandaan na hindi ito makakatulong sa pagpapakinis ng mga latency sa
pag-decode, dahil hindi kailanman maglalabas ng frame ang filter kung hindi puno ang buffer,
maliban sa EOF.)

PAG-ENCOD

Maaari kang mag-encode ng mga file mula sa isang format/codec patungo sa isa pa gamit ang pasilidad na ito.

--o=
Pinapagana ang encoding mode at tinutukoy ang pangalan ng output file.

--ng=
Tinutukoy ang format ng output (i-override ang autodetection sa pamamagitan ng extension ng pangalan ng file ng
ang file na tinukoy ni -o). Ito ay maaaring isang listahan na pinaghihiwalay ng kuwit ng mga posibleng format
subukan. Tingnan mo --of=help para sa buong listahan ng mga sinusuportahang format.

--ofopts=
Tinutukoy ang mga opsyon sa format ng output para sa libavformat. Tingnan mo --ofopts=tulong para sa isang buong
listahan ng mga suportadong opsyon.

Ang mga opsyon ay pinamamahalaan sa mga listahan. Mayroong ilang mga utos upang pamahalaan ang listahan ng mga opsyon.

--ofopts-add=
Idinaragdag ang mga opsyon na ibinigay bilang mga argumento sa listahan ng mga opsyon.

--ofopts-pre=
Inihahanda ang mga opsyon na ibinigay bilang mga argumento sa listahan ng mga opsyon.

--ofopts-del=
Tinatanggal ang mga opsyon sa mga ibinigay na index. Ang mga numero ng index ay nagsisimula sa 0, negatibo
ang mga numero ay tumutugon sa dulo ng listahan (-1 ang huli).

--ofopts-clr
Ganap na walang laman ang listahan ng mga opsyon.

--ofps= halaga>
Tinutukoy ang time base ng format ng output (default: 24000). Mga mababang halaga tulad ng 25 na limitasyon
video fps sa pamamagitan ng pag-drop ng mga frame.

--oautofps
Itinatakda ang time base ng format ng output sa nahulaan na frame rate ng input na video
(ginagaya ang pag-uugali ng MEncoder, kapaki-pakinabang para sa AVI; maaaring magdulot ng pagbagsak ng frame). Tandaan na
hindi lahat ng mga codec at hindi lahat ng mga format ay sumusuporta sa pag-encode ng VFR, at ang ilan ay mayroon
mga bug kapag tinukoy ang isang target na bitrate - gamitin --ofps or --oautofps para pilitin ang CFR
pag-encode sa mga kasong ito.

--omaxfps= halaga>
Tinutukoy ang pinakamababang distansya ng mga katabing frame (default: 0, na nangangahulugang hindi nakatakda).
Ang nilalaman ng mas mababang frame rate ay hindi muling isinasaayos sa frame rate na ito; nilalaman ng mas mataas
frame rate ay decimated sa frame rate na ito.

--oharddup
Kung nakatakda, ang frame rate na ibinigay ng --ofps ay natatamo hindi sa pamamagitan ng paglaktaw ng mga time code, ngunit
sa pamamagitan ng pagdodoble ng mga frame (constant frame rate mode).

--oneverdrop
Kung nakatakda, hindi kailanman ibinabagsak ang mga frame. Sa halip, ang mga time code ng video ay muling isinasaayos sa
laging tumataas. Ito ay maaaring magdulot ng AV desync, bagaman; upang ayusin ito, gumamit ng a
high-fps time base gamit --ofps at ganap na iwasan --oautofps.

--oac=
Tinutukoy ang output audio codec. Ito ay maaaring isang listahan na pinaghihiwalay ng kuwit ng posible
mga codec upang subukan. Tingnan mo --oac=tulong para sa buong listahan ng mga sinusuportahang codec.

--oaoffset=
Inililipat ang data ng audio ayon sa ibinigay na oras (sa mga segundo) sa pamamagitan ng pagdaragdag/pag-alis ng mga sample sa
magsimula.

--oacopts=
Tinutukoy ang output audio codec na mga opsyon para sa libavcodec. Tingnan mo --oacopts=tulong para sa isang
buong listahan ng mga sinusuportahang opsyon.

halimbawa

--oac=libmp3lame --oacopts=b=128000
pinipili ang 128 kbps MP3 encoding.

Ang mga opsyon ay pinamamahalaan sa mga listahan. Mayroong ilang mga utos upang pamahalaan ang listahan ng mga opsyon.

--oacopts-add=
Idinaragdag ang mga opsyon na ibinigay bilang mga argumento sa listahan ng mga opsyon.

--oacopts-pre=
Inihahanda ang mga opsyon na ibinigay bilang mga argumento sa listahan ng mga opsyon.

--oacopts-del=
Tinatanggal ang mga opsyon sa mga ibinigay na index. Ang mga numero ng index ay nagsisimula sa 0, negatibo
ang mga numero ay tumutugon sa dulo ng listahan (-1 ang huli).

--oacopts-clr
Ganap na walang laman ang listahan ng mga opsyon.

--una una
Pilitin ang audio stream na maging unang stream sa output. Bilang default ang
ang order ay hindi natukoy.

--ovc=
Tinutukoy ang output video codec. Ito ay maaaring isang listahan na pinaghihiwalay ng kuwit ng posible
mga codec upang subukan. Tingnan mo --ovc=tulong para sa buong listahan ng mga sinusuportahang codec.

--ovoffset=
Inililipat ang data ng video ayon sa ibinigay na oras (sa mga segundo) sa pamamagitan ng paglilipat ng mga halaga ng pts.

--ovcopts
Tinutukoy ang mga opsyon sa output na video codec para sa libavcodec. Tingnan ang --ovcopts=help para sa a
buong listahan ng mga sinusuportahang opsyon.

Mga halimbawa

"--ovc=mpeg4 --ovcopts=qscale=5"
pinipili ang constant quantizer scale 5 para sa MPEG-4 encoding.

"--ovc=libx264 --ovcopts=crf=23"
pinipili ang VBR quality factor 23 para sa H.264 encoding.

Ang mga opsyon ay pinamamahalaan sa mga listahan. Mayroong ilang mga utos upang pamahalaan ang listahan ng mga opsyon.

--ovcopts-add=
Idinaragdag ang mga opsyon na ibinigay bilang mga argumento sa listahan ng mga opsyon.

--ovcopts-pre=
Inihahanda ang mga opsyon na ibinigay bilang mga argumento sa listahan ng mga opsyon.

--ovcopts-del=
Tinatanggal ang mga opsyon sa mga ibinigay na index. Ang mga numero ng index ay nagsisimula sa 0, negatibo
ang mga numero ay tumutugon sa dulo ng listahan (-1 ang huli).

--ovcopts-clr
Ganap na walang laman ang listahan ng mga opsyon.

--ovfirst
Pilitin ang video stream na maging unang stream sa output. Bilang default ang
ang order ay hindi natukoy.

--ocopyts
Kinokopya ang input pts sa output video (hindi sinusuportahan ng ilang output container
mga format, hal. AVI). Naayos pa rin ang mga discontinuities. Bilang default, nakatakda ang mga audio pts
sa oras ng pag-playback at mga video pts ay naka-synchronize upang tumugma sa mga audio pts, bilang ilang output
hindi sinusuportahan ng mga format ang anupaman.

--orawts
Kinokopya ang input pts sa output video (hindi sinusuportahan ng ilang output container
mga format, hal. AVI). Sa mode na ito, hindi naayos ang mga discontinuity at lahat ng pts ay naayos
dumaan sa as-is. Huwag kailanman maghanap pabalik o gumamit ng maraming input file dito
mode!

--walang-ometadata
Ino-off ang pagkopya ng metadata mula sa mga input file patungo sa mga output file kapag nag-e-encode (na
ay pinagana bilang default).

COMMAND Interface

Ang mpv core ay maaaring kontrolin gamit ang mga command at properties. Ang isang bilang ng mga paraan upang makipag-ugnayan
sa player gamitin ang mga ito: key bindings (input.conf), OSD (nagpapakita ng impormasyon na may
properties), JSON IPC, ang client API (libmpv), at ang classic na slave mode.

input.conf
Ang input.conf file ay binubuo ng isang listahan ng mga key binding, halimbawa:

s screenshot # kumuha ng screenshot gamit ang s key
KALIWA humingi ng 15 # imapa ang kaliwang arrow key sa paghahanap ng pasulong nang 15 segundo

Ang bawat linya ay nagmamapa ng isang susi sa isang input command. Tinukoy ang mga susi sa literal na halaga ng mga ito
(upper case kung isasama sa Ilipat), o isang pangalan para sa mga espesyal na key. Halimbawa, a mapa sa
ang a key na walang shift, at A mapa sa a may shift.

Ang file ay matatagpuan sa direktoryo ng pagsasaayos ng mpv (karaniwang sa
~/.config/mpv/input.conf depende sa platform). Ang mga default na binding ay tinukoy dito:

https://github.com/mpv-player/mpv/blob/master/etc/input.conf

Ang isang listahan ng mga espesyal na susi ay maaaring makuha gamit ang
mpv --input-keylist

Sa pangkalahatan, ang mga susi ay maaaring pagsamahin sa Ilipat, Ctrl at Alt:

ctrl+q quit

mpv maaaring simulan sa input test mode, na nagpapakita ng mga key binding at ang mga command
nakatali sila sa OSD, sa halip na isagawa ang mga utos:

mpv --input-test --force-window --idle

(Ang pagsasara lamang ng bintana ay gagawa mpv exit, ang pagpindot sa mga normal na key ay magpapakita lamang ng
nagbubuklod, kahit na nakamapang huminto.)

Pangkalahatan input Utos palaugnayan
[Shift+][Ctrl+][Alt+][Meta+] [{ }] [ ] ( )* [;
]

Tandaan na bilang default, ang tamang Alt key ay maaaring gamitin upang lumikha ng mga espesyal na character, at sa gayon
hindi nagrerehistro bilang isang modifier. Ang pagpipilian --no-input-right-alt-gr nagbabago ang ugali na ito.

Ang mga bagong linya ay palaging nagsisimula ng isang bagong binding. # nagsisimula ng komento (sa labas ng naka-quote na string
mga argumento). Upang magbigkis ng mga utos sa # susi, SHARP maaaring magamit.

ay alinman sa literal na karakter na ginawa ng susi (ASCII o Unicode character), o a
simbolikong pangalan (tulad ng inilimbag ni --input-keylist).

(nakayakap sa { at }) ay ang input section para sa command na ito.

Ang mga argumento ay pinaghihiwalay ng whitespace. Nalalapat ito kahit sa mga argumentong string. Para dito
dahilan, ang mga argumentong string ay dapat na sinipi ". Sa loob ng mga quote, ang C-style escaping ay maaaring
ginagamit.

Maaari mong isailalim ang maramihang mga utos sa isang susi. Halimbawa:
isang show-text na "command 1" ; show-text na "command 2"

Posible ring itali ang isang utos sa isang sequence ng mga key:
abc show-text "command run after a, b, c has been pressed"

(Hindi ito ipinapakita sa pangkalahatang command syntax.)

If a or ab or b ay nakatali na, tatakbo ito sa unang utos na tumutugma, at ang
hindi kailanman tatawagin ang multi-key command. Maaaring i-remap ang mga intermediate key huwag pansinin in
upang maiwasan ang isyung ito. Ang maximum na bilang ng (hindi modifier) ​​na key para sa mga kumbinasyon ay
kasalukuyang 4.

listahan of input Command
huwag pansinin Gamitin ito para "i-block" ang mga susi na dapat ay hindi nakatali, at walang gagawin. Mahusay gamitin sa
hindi pinapagana ang mga default na binding, nang hindi pinapagana ang lahat ng mga binding na may
--no-input-default-bindings.

maghanap [relative|absolute|absolute-percent|relative-percent|eksaktong|keyframes]
Baguhin ang posisyon ng pag-playback. Bilang default, naghahanap sa pamamagitan ng kaugnay na dami ng mga segundo.

Ang pangalawang argumento ay binubuo ng mga flag na kumokontrol sa seek mode:

kamag-anak (default)
Maghanap ng kaugnay sa kasalukuyang posisyon (ang negatibong halaga ay naghahanap pabalik).

hindi mapag-aalinlanganan
Maghanap sa isang ibinigay na oras.

ganap na porsyento
Maghanap sa isang naibigay na posisyon sa porsyento.

kamag-anak-porsiyento
Maghanap kaugnay sa kasalukuyang posisyon sa porsyento.

mga keyframe
Palaging i-restart ang playback sa mga hangganan ng keyframe (mabilis).

eksakto Palaging gawin ang eksaktong/oras/tumpak na paghahanap (mabagal).

Maaaring pagsamahin ang maramihang mga flag, hal: absolute+keyframes.

Sa pamamagitan ng default, mga keyframe ay ginagamit para sa mga kamag-anak na naghahanap, at eksakto ay ginagamit para sa ganap
naghahanap.

Bago ang mpv 0.9, ang mga keyframe at eksakto kailangang ipasa ang mga flag bilang 3rd parameter
(pangunahing gumagamit ng espasyo sa halip na +). Ang ika-3 parameter ay na-parse pa rin, ngunit ay
itinuturing na hindi na ginagamit.

balik-hanapin [mode]
Ina-undo ang maghanap command, at ilang iba pang utos na naghahanap (ngunit hindi lahat
sa kanila). Ang pagtawag sa command na ito nang isang beses ay talon sa posisyon ng pag-playback bago ang
Humanap. Ang pagtawag dito sa pangalawang pagkakataon ay nag-undo sa balik-hanapin utos sa sarili. Ito lang
gumagana sa loob ng isang file.

Ang unang argumento ay opsyonal, at maaaring baguhin ang gawi:

markahan Markahan ang kasalukuyang posisyon ng oras. Ang susunod na normal balik-hanapin utos ay
balikan ang puntong ito, gaano man karaming paghahanap ang nangyari mula noong huling pagkakataon.

Ang paggamit nito nang walang anumang mga argumento ay nagbibigay sa iyo ng default na gawi.

frame-hakbang
I-play ang isang frame, pagkatapos ay i-pause. Walang ginagawa sa audio-only playback.

frame-back-step
Bumalik ng isang frame, pagkatapos ay i-pause. Tandaan na ito ay maaaring maging napakabagal (sinusubukan itong maging
tumpak, hindi mabilis), at kung minsan ay nabigo na kumilos gaya ng inaasahan. Kung gaano ito gumagana
depende sa kung gumagana nang tama ang tumpak na paghahanap (hal. tingnan ang
--hr-seek-demuxer-offset opsyon). Mga filter ng video o iba pang video post-processing na
binago ang timing ng mga frame (hal. deinterlacing) ay karaniwang dapat gumana, ngunit maaaring gawin
Ang backstepping ay tahimik na kumikilos nang hindi tama sa mga kaso sa sulok. Gamit
--hr-seek-framedrop=hindi dapat makatulong, bagama't maaari nitong gawing mas mabagal ang eksaktong paghahanap.

Hindi ito gumagana sa audio-only playback.

itakda
Itakda ang ibinigay na ari-arian sa ibinigay na halaga.

idagdag [ ]
Idagdag ang ibinigay na halaga sa property. Sa overflow o underflow, i-clamp ang property
sa maximum. Kung ay tinanggal, ipagpalagay 1.

ikot [pataas|pababa]
Ikot ang ibinigay na ari-arian. up at pababa itakda ang direksyon ng pag-ikot. Sa overflow, itakda ang
property pabalik sa minimum, sa underflow itakda ito sa maximum. Kung up or pababa is
inalis, ipagpalagay up.

dumami
Pina-multiply ang value ng isang property gamit ang numeric factor.

screenshot [mga subtitle|video|window|- [single|bawat-frame]]
Kumuha ng screenshot.

Unang argumento:

(default)
I-save ang larawan ng video, sa orihinal nitong resolution, at may mga subtitle. Ang ilan
ang mga video output ay maaari pa ring isama ang OSD sa output sa ilalim ng tiyak
pangyayari.


katulad subtitle, ngunit karaniwang walang OSD o mga subtitle. Ang eksaktong pag-uugali
depende sa napiling video output.


I-save ang mga nilalaman ng mpv window. Karaniwang naka-scale, na may OSD at
mga subtitle. Ang eksaktong pag-uugali ay nakasalalay sa napiling output ng video, at kung
walang available na suporta, ito ay kikilos tulad ng video.


Kumuha ng screenshot bawat frame. Ibigay muli ang utos na ito upang ihinto ang pagkuha
mga screenshot. Tandaan na dapat mong i-disable ang frame-dropping kapag ginagamit ito
mode - o maaari kang makatanggap ng mga duplicate na larawan sa mga kaso kung kailan ang isang frame ay
bumaba. Ang watawat na ito ay maaaring isama sa iba pang mga watawat, hal
video+bawat-frame.

screenshot-to-file [mga subtitle|video|window]
Kumuha ng screenshot at i-save ito sa isang naibigay na file. Ang format ng file ay magiging
nahulaan ng extension (at --screenshot-format ay binabalewala - ang pag-uugali kapag
ang extension ay nawawala o hindi alam ay arbitrary).

Ang pangalawang argumento ay tulad ng unang argumento sa screenshot.

Kung ang file ay mayroon na, ito ay mapapatungan.

Tulad ng lahat ng parameter ng input command, napapailalim ang filename sa pagpapalawak ng property bilang
inilarawan sa Ari-arian Paglawak.

playlist-susunod [mahina|puwersa]
Pumunta sa susunod na entry sa playlist.

mahina (default)
Kung kasalukuyang nilalaro ang huling file sa playlist, huwag gawin.

pilitin Wakasan ang pag-playback kung wala nang mga file sa playlist.

playlist-prev [mahina|puwersa]
Pumunta sa nakaraang entry sa playlist.

mahina (default)
Kung kasalukuyang nilalaro ang unang file sa playlist, huwag gawin.

pilitin Tapusin ang pag-playback kung ang unang file ay nilalaro.

loadfile [palitan|idagdag|idagdag-laro [mga pagpipilian]]
I-load ang ibinigay na file at i-play ito.

Pangalawang argumento:

(default)
Ihinto ang pag-playback ng kasalukuyang file, at i-play kaagad ang bagong file.


Idagdag ang file sa playlist.


Idagdag ang file, at kung walang kasalukuyang nagpe-play, simulan ang pag-playback.
(Palaging nagsisimula sa idinagdag na file, kahit na walang laman ang playlist
bago patakbuhin ang utos na ito.)

Ang ikatlong argumento ay isang listahan ng mga opsyon at halaga na dapat itakda habang ang
nagpe-play ang file. Ito ay sa anyo opt1=value1,opt2=value2,... Hindi lahat ng pagpipilian ay maaari
mabago sa ganitong paraan. Ang ilang mga opsyon ay nangangailangan ng pag-restart ng player.

loadlist [palitan|idagdag]
I-load ang ibinigay na file ng playlist (tulad ng --playlist).

malinaw ang playlist
I-clear ang playlist, maliban sa kasalukuyang nilalaro na file.

playlist-alisin kasalukuyang|
Alisin ang entry sa playlist sa ibinigay na index. Nagsisimulang magbilang ang mga halaga ng index sa 0.
Ang espesyal na halaga kasalukuyan inaalis ang kasalukuyang entry. Tandaan na ang pag-alis ng kasalukuyang
ang entry ay huminto din sa pag-playback at magsisimulang maglaro sa susunod na entry.

playlist-move
Ilipat ang entry sa playlist sa index1, para pumalit ito sa entry index2.
(Paradoxically, ang inilipat na playlist entry ay hindi magkakaroon ng index value na index2 pagkatapos
gumagalaw kung ang index1 ay mas mababa kaysa sa index2, dahil ang index2 ay tumutukoy sa target na entry,
hindi ang index na magkakaroon ng entry pagkatapos lumipat.)

playlist-shuffle
I-shuffle ang playlist. Ito ay katulad ng ginagawa sa simula kung ang --shuffle
ginagamit ang opsyon.

tumakbo utos arg1 arg2 ...
Patakbuhin ang ibinigay na utos. Hindi tulad sa MPlayer/mplayer2 at mga naunang bersyon ng mpv
(0.2.x at mas luma), hindi nito tinatawag ang shell. Sa halip, ang utos ay pinapatakbo
direkta, sa bawat argumento ay ipinasa nang hiwalay. Ang bawat argumento ay pinalawak tulad ng sa
Ari-arian Paglawak. Tandaan na mayroong static na limitasyon ng (sa pagsulat na ito) 9
mga argumento (maaaring taasan ang limitasyong ito kapag hinihiling).

Ang programa ay pinapatakbo sa isang hiwalay na paraan. mpv ay hindi naghihintay hanggang sa ang utos ay
nakumpleto, ngunit nagpapatuloy sa pag-playback pagkatapos itong i-spawning.

Upang makuha ang lumang pag-uugali, gamitin / Bin / SH at -c bilang unang dalawang argumento.

halimbawa

tumakbo "/ Bin / SH" "-c" "echo $ {title} > /tmp/naglalaro"

Ito ay hindi isang partikular na magandang halimbawa, dahil hindi ito humahawak
pagtakas, at maaaring payagan ng isang espesyal na inihandang file ang isang umaatake
magsagawa ng mga arbitrary na utos ng shell. Inirerekomenda na magsulat ng isang maliit
shell script, at tawagan iyon ng tumakbo.

umalis [ ]
Lumabas sa player. Kung may ibinigay na argumento, ginagamit ito bilang process exit code.

quit-watch-mamaya [ ]
Lumabas sa player, at mag-imbak ng kasalukuyang posisyon ng pag-playback. Ang pag-play sa file na iyon sa ibang pagkakataon ay hahanapin
sa nakaraang posisyon sa pagsisimula. Ang (opsyonal) argumento ay eksakto tulad ng sa
umalis utos.

sub-add [ [ [ ]]]
I-load ang ibinigay na subtitle file. Pinili ito bilang kasalukuyang subtitle pagkatapos mag-load.

Ang flag args ay isa sa mga sumusunod na halaga:


Piliin kaagad ang subtitle.


Huwag piliin ang subtitle. (O sa ilang espesyal na sitwasyon, hayaan ang default
nagpasya ang mekanismo ng pagpili ng stream.)


Piliin ang subtitle. Kung naidagdag na ang isang subtitle na may parehong filename,
pinili ang isa, sa halip na mag-load ng duplicate na entry. (Sa kasong ito,
Ang pamagat/wika ay binabalewala, at kung ang binago mula noong na-load ito, ang mga ito
ang mga pagbabago ay hindi makikita.)

Ang pamagat itinatakda ng argumento ang pamagat ng track sa UI.

Ang lang itinatakda ng argumento ang track language, at maaari ring makaimpluwensya sa pagpili ng stream
sa flag itakda sa kotse.

sub-alisin [ ]
Alisin ang ibinigay na subtitle na track. Kung ang id Nawawala ang argumento, alisin ang kasalukuyang
subaybayan. (Gumagana sa mga panlabas na subtitle na file lamang.)

sub-reload [ ]
I-reload ang ibinigay na mga subtitle na track. Kung ang id nawawala ang argumento, i-reload ang kasalukuyang
subaybayan. (Gumagana sa mga panlabas na subtitle na file lamang.)

Gumagana ito sa pamamagitan ng pag-unload at muling pagdaragdag ng subtitle track.

sub-step
Baguhin ang timing ng subtitle, na ang subtitle na kaganapan pagkatapos ng susunod pangalawang pamagat
ipinapakita ang mga kaganapan. maaaring negatibo ang paghakbang pabalik.

sub-seek
Humanap sa susunod (laktawan ang nakatakda sa 1) o ang nakaraang (laktawan ang nakatakda sa -1) subtitle. Ito
ay katulad ng sub-step, maliban na naghahanap ito ng video at audio sa halip na mag-adjust
ang pagkaantala ng subtitle.

Para sa mga naka-embed na subtitle (tulad ng sa Matroska), gagana lang ito sa mga subtitle na kaganapan
na naipakita na, o nasa loob ng maikling hanay ng prefetch.

osd [ ]
I-toggle ang antas ng OSD. Kung ay tinukoy, itakda ang OSD mode (tingnan --osd-level para
wastong halaga).

print-text
Mag-print ng text sa stdout. Ang string ay maaaring maglaman ng mga katangian (tingnan Ari-arian Paglawak).

palabas-teksto [ |- [ ]]
Ipakita ang teksto sa OSD. Ang string ay maaaring maglaman ng mga katangian, na pinalawak bilang
inilarawan sa Ari-arian Paglawak. Magagamit ito upang ipakita ang oras ng pag-playback, pangalan ng file,
at iba pa.


Ang oras sa ms upang ipakita ang mensahe para sa. Bilang default, gumagamit ito ng parehong halaga
as --osd-tagal.


Ang pinakamababang antas ng OSD upang ipakita ang teksto sa (tingnan --osd-level).

show-progress
Ipakita ang progress bar, ang lumipas na oras at ang kabuuang tagal ng file sa
OSD.

write-watch-later-config
Isulat ang resume config file na ang quit-watch-mamaya nagsusulat ang command, ngunit magpatuloy
normal na pag-playback.

itigil Ihinto ang pag-playback at i-clear ang playlist. Sa mga default na setting, ito ay mahalagang tulad ng
umalis. Kapaki-pakinabang para sa client API: maaaring ihinto ang pag-playback nang hindi tinatapos ang
player.

mouse [ [single|doble]]
Magpadala ng event ng mouse na may ibinigay na coordinate (, ).

Pangalawang argumento:


Ang numero ng pindutan ng na-click na pindutan ng mouse. Isa ito sa 0-19. Kung
ay tinanggal, ang posisyon lamang ang maa-update.

Ikatlong argumento:

(default)
Ang kaganapan ng mouse ay kumakatawan sa regular na solong pag-click.


Ang kaganapan ng mouse ay kumakatawan sa double-click.

pagpindot ng key
Magpadala ng mahalagang kaganapan sa pamamagitan ng tagapangasiwa ng input ng mpv, na nagti-trigger ng anumang pag-uugali
naka-configure sa key na iyon. key_name ay gumagamit ng input.conf scheme ng pagpapangalan para sa mga susi at
mga modifier. Kapaki-pakinabang para sa API ng kliyente: maaaring ipadala ang mga pangunahing kaganapan sa libmpv upang mahawakan
sa loob.

keydown
Kapareho ng pagpindot ng key, ngunit itinatakda ang KEYDOWN bandila upang kung ang susi ay nakatali sa a
repeatable command, paulit-ulit itong tatakbo gamit ang key repeat timing ng mpv hanggang
ang susi pataas utos ay tinatawag.

susi pataas [ ]
Itakda ang SUSI PATAAS watawat, pinahinto ang anumang paulit-ulit na gawi na na-trigger.
key_name ay opsyonal. Kung key_name ay hindi ibinigay o isang walang laman na string, SUSI PATAAS ay
itakda sa lahat ng mga susi. Kung hindi, SUSI PATAAS itatakda lamang sa key na tinukoy ni
key_name.

audio-add [ [ [ ]]]
I-load ang ibinigay na audio file. Tingnan mo sub-add utos.

pag-alis ng audio [ ]
Alisin ang ibinigay na audio track. Tingnan mo sub-alisin utos.

audio-reload [ ]
I-reload ang ibinigay na mga audio track. Tingnan mo sub-reload utos.

rescan-external-files [ ]
I-scan muli ang mga panlabas na file ayon sa kasalukuyang --sub-auto at --audio-file-auto
mga setting. Magagamit ito para i-auto-load ang mga external na file pagkatapos na-load ang file.

Ang paraan Ang argumento ay isa sa mga sumusunod:

(default)
Piliin ang default na audio at mga subtitle na stream, na karaniwang pinipili
panlabas na mga file na may pinakamataas na kagustuhan. (Ang pagpapatupad ay hindi perpekto,
at maaaring mapabuti kapag hiniling.)


Huwag baguhin ang mga kasalukuyang napiling track.

input Command na ay marahil paksa sa Baguhin
af set|add|toggle|del|clr filter1=params, filter2,...
Baguhin ang chain ng filter ng audio. Tingnan mo vf utos.

vf set|add|toggle|del|clr filter1=params, filter2,...
Baguhin ang chain ng filter ng video.

Ang unang argumento ang nagpapasya kung ano ang mangyayari:

itakda I-overwrite ang nakaraang chain ng filter gamit ang bago.

idagdag Idagdag ang bagong chain ng filter sa nauna.

toggle Suriin kung ang ibinigay na filter (na may eksaktong mga parameter) ay nasa
video chain. Kung oo, alisin ang filter. Kung hindi, idagdag ang filter. (Kung marami
ang mga filter ay ipinasa sa utos, ginagawa ito para sa bawat filter.)

del Alisin ang ibinigay na mga filter mula sa video chain. Hindi tulad sa ibang mga kaso,
ang pangalawang parameter ay isang listahan ng mga pangalan ng filter o integer na pinaghihiwalay ng kuwit
index. 0 ay magsasaad ng unang filter. Ang mga negatibong index ay nagsisimula sa
huling filter, at -1 nagsasaad ng huling filter.

clr Alisin ang lahat ng mga filter. Tandaan na tulad ng iba pang mga sub-command, hindi ito
kontrolin ang awtomatikong ipinasok na mga filter.

Maaari kang magtalaga ng mga label na i-filter sa pamamagitan ng paglalagay ng prefix sa kanila @pangalan: (kung saan pangalan ay isang
arbitrary identifier na pinili ng user). Maaaring gamitin ang mga label upang sumangguni sa mga filter ayon sa pangalan
sa lahat ng mga utos sa pagbabago ng chain ng filter. Para sa idagdag, gamit ang isang nagamit na
papalitan ng label ang kasalukuyang filter.

Ang vf Ipinapakita ng command ang listahan ng mga hiniling na filter sa OSD pagkatapos baguhin ang
chain ng filter. Ito ay halos katumbas ng palabas-teksto ${vf}. Tandaan na
Ang mga awtomatikong ipinasok na filter para sa conversion ng format ay hindi ipinapakita sa listahan, kung ano lang
ay hiniling ng gumagamit.

Karaniwan, susuriin ng mga utos kung muling ginawa ang chain ng video
matagumpay, at aalisin ang operasyon kapag nabigo. Kung ang utos ay tumakbo bago
video ay na-configure (maaaring mangyari kung ang command ay tatakbo kaagad pagkatapos buksan ang a
file at bago ma-decode ang isang video frame), hindi maaaring patakbuhin ang pagsusuring ito. Pagkatapos ay maaari
mangyari na ang paggawa ng video chain ay nabigo.

Halimbawa para sa input.conf

· a vf itakda paltik baligtarin ang video sa a susi

· b vf itakda "" alisin ang lahat ng mga filter ng video sa b

· c vf toggle lavfi=gradfun i-toggle ang debanding sa c

cycle-values ["!reverse"] ...
Umikot sa isang listahan ng mga halaga. Ang bawat invocation ng command ay magtatakda ng ibinigay
ari-arian sa susunod na halaga sa listahan. Ang utos ay nagpapanatili ng isang panloob na counter
kung aling value ang susunod na pipiliin, at alin ang una ay 0. Ire-reset ito sa 0 kapag ang huli
naabot ang halaga.

Ang panloob na counter ay nauugnay gamit ang pangalan ng property at ang listahan ng halaga. Kung
maramihang mga command (nakatali sa iba't ibang mga key) ay gumagamit ng parehong pangalan at listahan ng halaga, sila
ay ibahagi ang panloob na counter.

Ang espesyal na argumento !reverse ay maaaring gamitin upang iikot ang listahan ng halaga nang pabaliktad.
Kung ikukumpara sa isang utos na naglilista lamang ng halaga sa kabaligtaran, gagawin ng utos na ito
aktwal na ibahagi ang panloob na counter sa pasulong na pagbibisikleta na key binding (hangga't
dahil ang iba pang mga argumento ay pareho).

Tandaan na mayroong static na limitasyon ng (sa pagsulat na ito) 10 argumento (limitasyon na ito
maaaring itaas kapag hinihingi).

enable-section [mga watawat]
Paganahin ang lahat ng key binding sa pinangalanang seksyon ng input.

Ang pinaganang mga seksyon ng input ay bumubuo ng isang stack. Mga binding sa mga seksyon sa tuktok ng
ang stack ay mas gusto kaysa sa mas mababang mga seksyon. Inilalagay ng command na ito ang seksyon sa itaas ng
salansan. Kung ang seksyon ay nasa stack na, tahasan itong tinanggal
bago. (Ang isang seksyon ay hindi maaaring nasa stack nang higit sa isang beses.)

Ang flag Ang parameter ay maaaring isang kumbinasyon (na pinaghihiwalay ng +) ng mga sumusunod na watawat:


Lahat ng mga seksyon na pinagana bago ang bagong pinagana na seksyon ay hindi pinagana. sila
ay muling ie-enable sa sandaling maalis ang lahat ng eksklusibong seksyon sa itaas ng mga ito.
Sa madaling salita, nililiman ng bagong seksyon ang lahat ng nakaraang seksyon.


Hindi magagamit ang feature na ito sa pamamagitan ng pampublikong API.


Pareho.

disable-section
Huwag paganahin ang pinangalanang seksyon ng input. Ina-undo enable-section.

define-section [default|sapilitang]
Gumawa ng pinangalanang seksyon ng input, o palitan ang mga nilalaman ng isang umiiral nang input
seksyon Ang nilalaman Parametro ay gumagamit ng parehong syntax bilang ang input.conf file (maliban
na ang paggamit ng seksyong syntax sa loob nito ay hindi pinapayagan), kasama ang pangangailangang maghiwalay
mga binding na may bagong linyang karakter.

Kung ang nilalaman Ang parameter ay isang walang laman na string, ang seksyon ay tinanggal.

Ang seksyon na may pangalan default ay ang normal na seksyon ng pag-input.

Sa pangkalahatan, kailangang paganahin ang mga seksyon ng input gamit ang enable-section utos, o
hindi sila pinapansin.

Ang huling parameter ay may sumusunod na kahulugan:

(din ginamit if parametro tinanggal)
Gumamit ng key binding na tinukoy ng seksyong ito kung hindi pa nagagawa ng user
itali ang susi na ito sa isang utos.


Palaging itali ang isang susi. (Ang seksyon ng input na pinakakamakailang ginawang aktibo
mananalo kung may ambiguities.)

overlay-add
Magdagdag ng OSD overlay na nagmula sa raw data. Ito ay maaaring maging kapaki-pakinabang para sa mga script at
mga application na kumokontrol sa mpv, at gustong magpakita ng mga bagay sa itaas ng video
window.

Karaniwang ipinapakita ang mga overlay sa resolution ng screen, ngunit sa ilang VO, ang
ang resolution ay nabawasan sa resolution ng video. Maaari mong basahin ang osd-width at
osd-taas ari-arian. At least kasama --vo-xv at anamorphic na video (tulad ng DVD),
osd-par dapat basahin din, at ang overlay ay dapat na may bayad sa aspeto.
(Mga direksyon sa hinaharap: baka dapat pangalagaan ng mpv ang ilan sa mga bagay na ito
awtomatiko, ngunit mahirap sabihin kung saan iguguhit ang linya.)

id ay isang integer sa pagitan ng 0 at 63 na nagpapakilala sa elemento ng overlay. Ang ID ay maaaring
ginagamit upang magdagdag ng maraming bahagi ng overlay, i-update ang isang bahagi sa pamamagitan ng paggamit ng command na ito na may isang
mayroon nang ID, o upang alisin ang isang bahagi na may overlay-alis. Gamit ang dati
ang hindi nagamit na ID ay magdaragdag ng bagong overlay, habang ang muling paggamit ng ID ay mag-a-update nito. (Kinabukasan
mga direksyon: dapat mayroong isang bagay upang matiyak ang iba't ibang mga programa na gustong gawin
gumawa ng mga overlay ay hindi sumasalungat sa isa't isa, sakaling kailanganin iyon.)

x at y tukuyin ang posisyon kung saan dapat ipakita ang OSD.

file tumutukoy sa file kung saan nabasa ang raw na data ng imahe. Maaari itong maging isang numero
UNIX file descriptor na may prefix na @ (eg @4), o isang filename. Ang file ay magiging
nakamapang sa memorya ng mmap(). Ang ilang VO ay direktang ipapasa ang naka-map na pointer sa
ipakita ang mga API (hal. opengl o vdpau), kaya walang aktwal na pagkopya ang kasangkot. Pinutol
ang source file habang aktibo ang overlay ay mag-crash sa player. Hindi mo dapat
baguhin ang data habang aktibo ang overlay, dahil ang data ay mahalagang
na-access sa mga random na puntos. Sa halip, tumawag overlay-add muli (mas mabuti na may a
ibang rehiyon ng memorya upang maiwasan ang pagkapunit).

Posible ring magpasa ng isang raw memory address para magamit bilang bitmap memory ni
pagpasa ng memory address bilang integer na may prefix na an & karakter. Pagpasa sa
maling bagay dito ay babagsak ang player. Ang mode na ito ay maaaring maging kapaki-pakinabang para sa paggamit sa
libmpv. Ang ginalaw Ang parameter ay idinagdag lamang sa memorya ng address (dahil ang mpv
0.8.0, hindi pinansin noon).

ginalaw ay ang byte offset ng unang pixel sa source file. (Ang kasalukuyan
ang pagpapatupad ay palaging mmap ang buong file mula sa posisyon 0 hanggang sa dulo ng
larawan, kaya dapat na iwasan ang malalaking offset. Bago ang mpv 0.8.0, ang offset ay
direktang ipinasa sa mmap, ngunit binago ito upang gawing mas madali ang paggamit nito.)

fmt ay isang string na nagpapakilala sa format ng imahe. Sa kasalukuyan, lamang bgra ay tinukoy. Ito
ang format ay may 4 na byte bawat pixel, na may 8 bits bawat bahagi. Hindi gaanong makabuluhan 8
ang mga bit ay asul, at ang pinaka makabuluhang 8 bit ay alpha (sa maliit na endian, ang
Ang mga bahagi ay BGRA, na may B bilang unang byte). Gumagamit ito ng premultiplied alpha: every
ang bahagi ng kulay ay na-multiply na sa bahagi ng alpha. Ang ibig sabihin nito ay ang
ang numeric na halaga ng bawat bahagi ay katumbas o mas maliit kaysa sa alpha component.
(Ang paglabag sa panuntunang ito ay hahantong sa iba't ibang resulta na may iba't ibang VO: numeric
ang mga overflow na nagreresulta mula sa paghahalo ng mga sirang alpha value ay itinuturing na isang bagay na
hindi dapat mangyari, at dahil dito ang mga pagpapatupad ay hindi matiyak na makukuha mo
predictable na pag-uugali sa kasong ito.)

w, h, at mahabang hakbang tukuyin ang laki ng overlay. w ay ang nakikitang lapad ng
overlay, habang mahabang hakbang nagbibigay ng lapad sa bytes sa memorya. Sa simpleng kaso, at
sa bgra format, hakbang==4*w. Sa pangkalahatan, ang kabuuang halaga ng memorya na na-access
is mahabang hakbang * h. (Sa teknikal, ang pinakamababang laki ay magiging mahabang hakbang * (h - 1) + w * 4,
ngunit para sa pagiging simple, maa-access ng player ang lahat mahabang hakbang * h bytes.)

babala

Kapag ina-update ang overlay, dapat kang maghanda ng pangalawang nakabahaging memorya
rehiyon (hal. gamitin ang offset na parameter) at idagdag ito bilang overlay,
sa halip na muling gamitin ang parehong memorya sa bawat oras. Kung hindi, maaari kang makakuha
ang katumbas ng pagpunit, kapag ang iyong aplikasyon at mpv ay nagsulat/nagbasa ng
buffer sa parehong oras. Gayundin, tandaan na maaaring ma-access ng mpv ang isang
memorya ng overlay sa mga random na oras sa tuwing nararamdaman ang pangangailangan na gawin ito, para sa
halimbawa kapag muling iginuhit ang screen.

overlay-alis
Alisin ang isang overlay na idinagdag sa overlay-add at ang parehong ID. Walang gagawin kung hindi
umiiral ang overlay na may ganitong ID.

script-mensahe ...
Magpadala ng mensahe sa lahat ng kliyente, at ipasa ito sa sumusunod na listahan ng mga argumento. Ano
ang ibig sabihin ng mensaheng ito, kung gaano karaming mga argumento ang kinakailangan, at kung ano ang ibig sabihin ng mga argumento
ganap na hanggang sa receiver at sa nagpadala. Natatanggap ng bawat kliyente ang mensahe, kaya maging
maingat sa mga pag-aaway ng pangalan (o paggamit script_message_to).

script-message-to ...
Katulad ng script_message, ngunit ipadala lamang ito sa kliyenteng pinangalanan . Bawat kliyente
(mga script atbp.) ay may natatanging pangalan. Halimbawa, makukuha ng mga script ng Lua ang kanilang pangalan sa pamamagitan ng
mp.get_script_name().

script-binding
Mag-invoke ng key binding na ibinigay ng script. Magagamit ito para i-remap ang mga key binding
na ibinigay ng mga panlabas na script ng Lua.

Ang argumento ay ang pangalan ng nagbubuklod.

Maaari itong opsyonal na lagyan ng prefix ng pangalan ng script, gamit / bilang separator,
hal script_binding scriptname/bindingname.

Para sa pagkakumpleto, narito kung paano gumagana ang utos na ito sa loob. Ang mga detalye ay maaaring
baguhin anumang oras. Sa anumang tumutugmang pangunahing kaganapan, script_message_to or script_message is
tinatawag (depende sa kung ang pangalan ng script ay kasama), kung saan ang unang argument
ay ang string pagbibigkis ng susi, ang pangalawang argumento ay ang pangalan ng nagbubuklod, at ang
Ang ikatlong argumento ay ang pangunahing estado bilang string. Ang pangunahing estado ay binubuo ng isang bilang ng
mga titik. Ang unang titik ay isa sa d (Pinindot ang susi), u (pinakawalan), r
(Naka-down pa rin ang key, at naulit; kung pinagana lang ang pag-uulit ng key para dito
nagbubuklod), p (Pinindot ang key; nangyayari kung hindi masusubaybayan ang pataas/pababa). Ang ikalawa
sulat kung ang kaganapan ay nagmula sa mouse, alinman m (button ng mouse) o -
(iba pa).

ab-loop
Ikot sa pamamagitan ng AB loop estado. Itatakda ng unang utos ang A punto (ang
ab-loop-a ari-arian); ang pangalawa ang B punto, at ang pangatlo ay magwawalis ng parehong mga puntos.

vo-cmdline
I-reset ang sub-option ng kasalukuyang VO. Kasalukuyang gumagana sa openl (Kabilang ang
openl-hq). Ang argument ay ang sub-option na string na karaniwang ipinapasa sa VO sa
command line. Hindi lahat ng sub-option ay maaaring itakda, ngunit ang mga maaari ay ire-reset
kahit na hindi sila lumitaw sa argumento. Maaaring baguhin ang utos na ito o
tinanggal sa hinaharap.

drop-buffer
I-drop ang mga buffer ng audio/video/demuxer, at i-restart mula sa bago. Maaaring makatulong sa
hindi hinahanap na mga stream na lumalabas sa sync. Maaaring baguhin ang utos na ito o
tinanggal sa hinaharap.

screenshot-raw [mga subtitle|video|window]
Magbalik ng screenshot sa memorya. Magagamit lang ito sa pamamagitan ng client API. Ang
Ang MPV_FORMAT_NODE_MAP na ibinalik ng command na ito ay mayroong w, h, mahabang hakbang mga field na nakatakda sa
halatang nilalaman. A format field ay nakatakda sa bgr0 bilang default. Ang format na ito ay
organisado bilang B8G8R8X8 (kung saan B ay ang LSB). Ang nilalaman ng padding X is
hindi natukoy. Ang data Ang field ay may uri ng MPV_FORMAT_BYTE_ARRAY na may aktwal na larawan
datos. Ang imahe ay napalaya sa sandaling ang resulta node ay napalaya.

Mga hindi dokumentadong utos: tv-huling-channel (TV/DVB lang), ao-reload (pang-eksperimento/panloob).

Hooks
Ang mga hook ay magkakasabay na kaganapan sa pagitan ng player core at isang script o katulad nito. Nalalapat ito sa
client API (kabilang ang Lua scripting interface). Karaniwan, ang mga kaganapan ay dapat na
asynchronous, at ang hook API ay nagbibigay ng awkward at hindi malinaw na paraan upang mahawakan ang mga kaganapang iyon
nangangailangan ng mas mahigpit na koordinasyon. Walang ginawang garantiya ng katatagan ng API. Hindi sumusunod
ang eksaktong protocol ay maaaring gawing random na mag-freeze ang player. Talaga, walang dapat gumamit
ang API na ito.

Mayroong dalawang espesyal na utos na kasangkot. Gayundin, dapat makinig ang kliyente para sa mga mensahe ng kliyente
(MPV_EVENT_CLIENT_MESSAGE sa C API).

hook-add
Mag-subscribe sa hook na kinilala ng unang argumento (karaniwang, ang pangalan ng
kaganapan). Ang id Ang argumento ay isang arbitrary na integer na pinili ng user. karapatang mauna is
ginagamit upang pag-uri-uriin ang lahat ng mga humahawak ng kawit sa buong mundo sa lahat ng mga kliyente. Ang bawat kliyente ay maaaring
magparehistro ng maramihang mga tagapangasiwa ng kawit (kahit para sa parehong pangalan ng kawit). Kapag ang kawit ay
nakarehistro, hindi ito maaaring i-unregister.

Kapag nangyari ang isang partikular na kaganapan, ang lahat ng mga rehistradong handler ay tatakbo nang sunud-sunod. Ito ay gumagamit ng
isang protocol na dapat tahasang sundin ng bawat kliyente. Kapag ang isang hook handler ay tumakbo, a
mensahe ng kliyente (MPV_EVENT_CLIENT_MESSAGE) ay ipinadala sa kliyenteng nagparehistro
ang kawit. Ang mensaheng ito ay may mga sumusunod na argumento:

1. ang tali hook_run

2. ang id argument na nakarehistro ang hook bilang string (maaari itong magamit sa
wastong hawakan ang maraming kawit na nakarehistro ng parehong kliyente, hangga't ang id
ang argumento ay natatangi sa kliyente)

3. isang bagay na hindi natukoy, na ginagamit ng mekanismo ng kawit upang subaybayan ang pagpapatupad ng kawit
(sa kasalukuyan, ito ang hook-name, ngunit ito ay maaaring magbago nang walang babala)

Sa pagtanggap ng mensaheng ito, maaaring pangasiwaan ng kliyente ang kaganapan. Habang ginagawa ito, ang
ang player core ay tutugon pa rin sa mga kahilingan, ngunit ang pag-playback ay karaniwang ititigil.

Kapag tapos na ang kliyente, dapat itong ipagpatuloy ang pagsasagawa ng hook ng core sa pamamagitan ng pagpapatakbo ng
kawit-ack utos.

kawit-ack
Patakbuhin ang susunod na kawit sa pandaigdigang kadena ng mga kawit. Ang argumento ay ang ika-3 argumento ng
ang mensahe ng kliyente na nagsisimula sa pagpapatupad ng hook para sa kasalukuyang kliyente.

Ang mga sumusunod na kawit ay kasalukuyang tinukoy:

on_load
Tinatawag kapag ang isang file ay bubuksan, bago ang anumang bagay ay aktwal na gawin. Halimbawa,
maaari mong basahin at isulat ang stream-open-filename property kung saan ire-redirect ang isang URL
ibang bagay (isaalang-alang ang suporta para sa mga streaming site na bihirang magbigay sa user ng a
direktang media URL), o maaari kang magtakda ng mga opsyon sa bawat file sa pamamagitan ng pagtatakda ng property
file-local-options/ pangalan>. Ang manlalaro ay maghihintay hanggang ang lahat ng mga kawit ay tumakbo.

on_unload
Patakbuhin bago isara ang isang file, at bago aktwal na i-uninitialize ang lahat. Hindi
posibleng ipagpatuloy ang pag-playback sa ganitong estado.

input Utos Prefix
Ang mga prefix na ito ay inilalagay sa pagitan ng key name at ng aktwal na command. Maaaring maramihang prefix
matukoy. Pinaghihiwalay sila ng whitespace.

osd-auto (default)
Gamitin ang default na gawi para sa command na ito.

walang-osd Huwag gumamit ng anumang OSD para sa utos na ito.

osd-bar
Kung maaari, magpakita ng bar na may ganitong command. Ipapakita ng mga utos ng Seek ang pag-unlad
bar, maaaring ipakita ng mga command sa pagpapalit ng property ang bagong itinakda na halaga.

osd-msg
Kung maaari, magpakita ng mensahe ng OSD na may ganitong command. Seek command ipakita ang kasalukuyang
oras ng pag-playback, ipinapakita ng mga command sa pagpapalit ng property ang bagong itinakdang halaga bilang text.

osd-msg-bar
Pagsamahin ang osd-bar at osd-msg.

hilaw Huwag palawakin ang mga katangian sa mga argumento ng string. (Gusto "${property-name}".)

expand-properties (default)
Ang lahat ng mga argumento ng string ay pinalawak tulad ng inilarawan sa Ari-arian Paglawak.

mauulit
Para sa ilang utos, ang pagpindot sa isang key ay hindi magpapatakbo ng command nang paulit-ulit. Ito
pinipilit ng prefix ang pag-uulit ng key sa anumang kaso.

Ang lahat ng osd prefix ay na-override pa rin ng global --osd-level mga setting.

input Seksyon
Ang mga seksyon ng pag-input ay nagpangkat ng isang hanay ng mga binding, at paganahin o huwag paganahin ang mga ito nang sabay-sabay. Sa
input.conf, ang bawat key binding ay itinalaga sa isang input section, sa halip na magkaroon talaga
tahasang mga seksyon ng teksto.

Tingnan din enable_section at disable_section utos.

Mga paunang natukoy na binding:

default
Ang mga binding na walang seksyon ng pag-input ay tahasang itinalaga sa seksyong ito. Ito ay
pinagana bilang default sa panahon ng normal na pag-playback.

gawing encode Seksyon na aktibo sa encoding mode. Eksklusibo itong pinagana, kaya't
mga binding sa default hindi pinapansin ang mga seksyon.

Mga Katangian
Ginagamit ang mga katangian para magtakda ng mga opsyon sa mpv sa panahon ng runtime, o para mag-query ng di-makatwirang impormasyon.
Maaari silang manipulahin gamit ang itakda/idagdag/ikot mga utos, at nakuha gamit ang palabas-teksto, O
anumang bagay na gumagamit ng pagpapalawak ng ari-arian. (Tingnan Ari-arian Paglawak.)

Ang pangalan ng property ay may annotated na RW upang isaad kung ang property ay karaniwan
maisusulat.

Kung ang isang opsyon ay isinangguni, ang property ay karaniwang kukuha/magbabalik ng eksaktong parehong mga halaga
bilang pagpipilian. Sa mga kasong ito, ang mga pag-aari ay isang paraan lamang upang baguhin ang isang opsyon sa runtime.

Ari-arian listahan
osd-level (RW)
Tingnan --osd-level.

osd-scale (RW)
OSD font size multiplier, tingnan --osd-scale.

silo (RW)
Tingnan --loop.

loop-file (RW)
Tingnan --loop-file (gumagamit ng oo/hindi).

pabilisin (RW)
Tingnan --bilis.

audio-speed-correct, video-bilis-pagwawasto
Factor multiply sa pabilisin kung saan sinusubukan ng player na i-play ang file. Karaniwan
ito ay eksaktong 1. (Ang display sync mode ay gagawin itong kapaki-pakinabang.)

Ipapakita ito ng OSD formatting sa anyo ng + 1.23456%, na may bilang na (hilaw
- 1) * 100 para sa ibinigay na halaga ng raw property.

display-sync-active
Ibalik kung --video-sync=display ay talagang aktibo.

filename
Kasalukuyang nilalaro ang file, na may natanggal na landas. Kung ito ay isang URL, subukang i-undo ang porsyento
encoding din. (Ang resulta ay hindi kinakailangang tama, ngunit mukhang mas mahusay para sa
mga layunin ng pagpapakita. Gamitin ang landas property upang makakuha ng hindi binagong filename.)

laki ng file
Haba sa byte ng source file/stream. (Ito ay kapareho ng ${stream-end}. Para sa
nag-order ng mga kabanata at tulad nito, ibinabalik ang laki ng kasalukuyang nilalaro na segment.)

tinantyang-frame-count
Kabuuang bilang ng mga frame sa kasalukuyang file.

TANDAAN:
Ito ay isang pagtatantya lamang. (Ito ay kinakalkula mula sa dalawang hindi mapagkakatiwalaang dami: fps at
haba ng stream.)

tinantyang-frame-number
Bilang ng kasalukuyang frame sa kasalukuyang stream.

TANDAAN:
Ito ay isang pagtatantya lamang. (Ito ay kinakalkula mula sa dalawang hindi mapagkakatiwalaang dami: fps at
posibleng mga bilugan na timestamp.)

landas Buong path ng kasalukuyang nilalaro na file. Kadalasan ito ay eksaktong parehong string mo
ipasa ang mpv command line o ang loadfile utos, kahit na ito ay isang kamag-anak na landas.
Kung inaasahan mo ang isang ganap na landas, kakailanganin mong matukoy ito sa iyong sarili, halimbawa
sa pamamagitan ng paggamit ng working-directory ari-arian.

pamagat ng media
Kung ang kasalukuyang nilalaro na file ay may a pamagat tag, gamitin mo yan.

Kung hindi, kung ang uri ng media ay DVD, ibalik ang volume ID ng DVD.

Kung hindi, ibalik ang filename ari-arian.

format-file
Simbolikong pangalan ng format ng file. Sa ilang mga kaso, ito ay isang listahan na pinaghihiwalay ng kuwit ng
format ng mga pangalan, hal mp4 ay mov,mp4,m4a,3gp,3g2,mj2 (maaaring lumaki ang listahan sa hinaharap
para sa anumang format).

demuxer
Pangalan ng kasalukuyang demuxer. (Ito ay walang silbi.)

stream-landas
Filename (buong path) ng stream layer filename. (Ito ay malamang na walang silbi. Ito
mukhang ito ay maaaring naiiba mula sa landas kapag gumagamit lamang ng mga iniutos na kabanata.)

stream-pos (RW)
Raw byte na posisyon sa source stream.

stream-end
Raw end na posisyon sa bytes sa source stream.

tagal
Tagal ng kasalukuyang file sa mga segundo. Kung ang tagal ay hindi alam, ang ari-arian
ay hindi magagamit. Tandaan na ang tagal ng file ay hindi palaging eksaktong alam, kaya ito ay
isang pagtatantya.

Pinapalitan nito ang haba property, na hindi na ginagamit pagkatapos ng paglabas ng mpv 0.9.
(Ang mga semantika ay pareho.)

avsync Huling pagkakaiba sa pag-synchronize ng A/V. Hindi magagamit kung ang audio o video ay hindi pinagana.

kabuuang-avsync-pagbabago
Kabuuang AV sync correction tapos na. Hindi magagamit kung ang audio o video ay hindi pinagana.

drop-frame-count
Ang mga video frame ay ibinaba ng decoder, dahil ang video ay masyadong malayo sa audio (kapag ginagamit
--framedrop=decoder). Minsan, maaari itong dagdagan sa ibang mga sitwasyon, hal
kapag ang mga video packet ay nasira, o ang decoder ay hindi sumusunod sa karaniwang mga patakaran.
Hindi available kung naka-disable ang video.

vo-drop-frame-count
Mga frame na ibinaba ng VO (kapag ginagamit --framedrop=vo).

mistimed-frame-count
Bilang ng mga video frame na hindi na-time nang tama sa display-sync mode para sa
alang-alang sa pagpapanatili ng A/V sync. Hindi kasama dito ang mga panlabas na pangyayari, tulad ng
masyadong mabagal ang pag-render ng video o kahit papaano ay nilaktawan ng driver ng graphics ang isang vsync. Ito
hindi rin kasama ang mga error sa pag-ikot (na maaaring mangyari lalo na sa masama
mga timestamp ng pinagmulan). Halimbawa, gamit ang display-desync hindi dapat magbago ang mode
ang halagang ito mula sa 0.

vsync-ratio
Para sa kung gaano karaming mga vsync ang isang frame ay ipinapakita sa average. Ito ay magagamit kung
ang display-sync ay aktibo lamang. Para sa 30 FPS na video sa isang 60 Hz screen, ito ay magiging 2.
Ito ang moving average ng kung ano talaga ang nakaiskedyul, kaya 24 FPS sa 60 Hz
hindi kailanman mananatili nang eksakto sa 2.5, ngunit jitter depende sa huling frame na ipinapakita.

vo-delayed-frame-count
Tinantyang bilang ng mga frame na naantala dahil sa mga panlabas na pangyayari sa display-sync
mode. Tandaan na sa pangkalahatan, kailangang hulaan ng mpv na ito ay nangyayari, at ang hula
maaaring hindi tumpak.

porsyento-pos (RW)
Posisyon sa kasalukuyang file (0-100). Ang kalamangan sa paggamit nito sa halip na
ang pagkalkula nito mula sa iba pang mga katangian ay ang wastong pagbabalik nito sa pagtatantya
ang posisyon ng playback mula sa posisyon ng byte, kung hindi alam ang tagal ng file.

oras-pos (RW)
Posisyon sa kasalukuyang file sa ilang segundo.

oras-pagsisimula
Hindi na ginagamit. Palaging nagbabalik ng 0. Bago ang mpv 0.14, ito ay ginagamit upang ibalik ang oras ng pagsisimula
ng file (maaaring makaapekto hal. transport streams). Tingnan mo --rebase-start-time pagpipilian.

natitirang oras
Ang natitirang haba ng file sa ilang segundo. Tandaan na ang tagal ng file ay hindi palaging
eksaktong kilala, kaya ito ay isang pagtatantya.

playtime-natitira
natitirang oras pinaliit ng agos pabilisin.

oras ng pag-playback (RW)
Posisyon sa kasalukuyang file sa ilang segundo. Unlike oras-pos, ang oras ay clamped sa
saklaw ng file. (Ang hindi tumpak na mga tagal ng file atbp. ay maaaring makalabas sa saklaw.
Kapaki-pakinabang din kapag sinubukan ng user na maghanap sa labas ng file, bilang target ng paghahanap
ang oras ay itinuturing na kasalukuyang posisyon habang naghahanap.)

kabanata (RW)
Kasalukuyang numero ng kabanata. Ang bilang ng unang kabanata ay 0.

edisyon (RW)
Kasalukuyang numero ng edisyon ng MKV. Ang pagtatakda sa property na ito sa ibang value ay magre-restart
playback. Ang bilang ng unang edisyon ay 0.

mga pamagat ng disc
Bilang ng mga pamagat ng BD/DVD.

Ito ay may ilang mga sub-properties. Palitan N gamit ang 0-based na index ng edisyon.

mga pamagat/bilang ng disc
Bilang ng mga pamagat.

mga pamagat/id ng disc
Title ID bilang integer. Sa kasalukuyan, ito ay kapareho ng index ng pamagat.

mga pamagat/haba ng disc
Haba sa segundo. Maaaring hindi available sa ilang mga kaso (kasalukuyang ito
gumagana para sa libdvdnav lamang).

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (para sa bawat edisyon)
"id" MPV_FORMAT_INT64
"haba" MPV_FORMAT_DOUBLE

listahan ng pamagat ng disc
Listahan ng mga pamagat ng BD/DVD.

pamagat ng disc (RW)
Kasalukuyang BD/DVD title number. Ang pagsusulat ay gumagana lamang para sa dvdnav:// at bd:// (At
mga alias para sa mga ito).

kabanata
Bilang ng mga kabanata.

edisyon
Bilang ng mga edisyon ng MKV.

edisyon-listahan
Listahan ng mga edisyon, kasalukuyang entry na minarkahan. Sa kasalukuyan, ang halaga ng raw property ay
walang silbi

Ito ay may ilang mga sub-properties. Palitan N gamit ang 0-based na index ng edisyon.

edisyon-listahan/bilang
Bilang ng mga edisyon. Kung walang mga edisyon, maaari itong maging 0 o 1 (1 kung
may walang kwentang dummy edition).

edisyon-listahan/N/id
Edition ID bilang integer. Gamitin ito upang itakda ang edisyon ari-arian. Kasalukuyan,
ito ay kapareho ng index ng edisyon.

edition-list/N/default
oo kung ito ang default na edisyon, hindi kung hindi man.

edisyon-listahan/N/pamagat
Pamagat ng edisyon bilang nakaimbak sa file. Hindi laging available.

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (para sa bawat edisyon)
"id" MPV_FORMAT_INT64
"title" MPV_FORMAT_STRING
"default" MPV_FORMAT_FLAG

ab-loop-a, ab-loop-b (RW)
Itakda/kumuha ng mga AB loop point. Tingnan ang kaukulang mga opsyon at ab_loop utos Ang
espesyal na halaga hindi sa alinman sa mga katangiang ito ay hindi pinapagana ang pag-loop.

anggulo (RW)
Kasalukuyang anggulo ng DVD.

metadata
Metadata key/value pairs.

Kung ang ari-arian ay na-access sa Lua's mp.get_property_native, nagbabalik ito ng talahanayan
na may mga metadata key na nagmamapa sa mga halaga ng metadata. Kung ito ay na-access kasama ng kliyente
API, ito ay nagbabalik ng a MPV_FORMAT_NODE_MAP, na may mga tag key na nagma-map sa mga halaga ng tag.

Para sa OSD, nagbabalik ito ng naka-format na listahan. Sinusubukang kunin ang property na ito bilang isang raw
hindi gumagana ang string.

Ito ay may ilang mga sub-properties:

metadata/by-key/
Halaga ng metadata entry .

metadata/listahan/bilang
Bilang ng mga entry ng metadata.

metadata/list/N/key
Pangalan ng key ng Nth metadata entry. (Ang unang entry ay 0).

metadata/list/N/value
Halaga ng Nth metadata entry.

metadata/
Lumang bersyon ng metadata/by-key/. Ang paggamit ay nasiraan ng loob, dahil ang
Ang metadata key string ay maaaring sumalungat sa iba pang mga sub-properties.

Maaaring magbago ang layout ng property na ito. Ang mga mungkahi ay malugod na tinatanggap kung paano
eksakto dapat gumana ang property na ito.

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_MAP
(key at string value para sa bawat metadata entry)

na-filter-metadata
katulad metadata, ngunit kasama lamang ang mga field na nakalista sa --display-tags pagpipilian Ito
ay ang parehong hanay ng mga tag na naka-print sa terminal.

kabanata-metadata
Metadata ng kasalukuyang kabanata. Gumagana katulad ng metadata ari-arian. Pinapayagan din nito ang
parehong mga paraan ng pag-access (gamit ang mga sub-properties).

Ang metadata ng bawat kabanata ay napakabihirang. Karaniwan, ang pangalan ng kabanata lamang (pamagat) ay nakatakda.

Para sa pag-access ng iba pang impormasyon, tulad ng pagsisimula ng kabanata, tingnan ang listahan ng kabanata ari-arian.

vf-metadata/
Idinagdag ang metadata ng mga filter ng video. Na-access ng label ng filter, na kung hindi
tahasang tinukoy gamit ang @filter-label: syntax, ay magiging NN.

Gumagana katulad ng metadata ari-arian. Pinapayagan nito ang parehong mga paraan ng pag-access (gamit ang
sub-properties).

Ang isang halimbawa ng ganitong uri ng metadata ay ang mga parameter ng pag-crop na idinagdag ni
--vf=lavfi=cropdetect.

af-metadata/
Katumbas ng vf-metadata/, ngunit para sa mga filter ng audio.

i-pause (RW)
I-pause ang status. Ito ay kadalasan oo or hindi. Tingnan --pause.

idle Bumalik oo kung walang file na na-load, ngunit ang player ay nananatili sa paligid dahil sa
--walang ginagawa pagpipilian.

core-idle
Bumalik oo kung ang playback core ay naka-pause, kung hindi hindi. Ito ay maaaring iba
i-pause sa mga espesyal na sitwasyon, tulad ng kapag ang player ay nag-pause sa sarili dahil sa mababa
cache ng network.

Nagbabalik din ito oo kung nagre-restart ang playback o kung wala talagang nagpe-play. Sa
sa ibang salita, ito lamang hindi kung may nagpe-play talaga ng video. (Pag-uugali mula noong mpv
0.7.0.)

cache Katayuan ng pagpuno ng cache ng network (0-100.0).

laki ng cache (RW)
Laki ng cache ng network sa KB. Ito ay katulad ng --cache. Pinapayagan nitong itakda ang cache
laki sa runtime. Sa kasalukuyan, hindi posibleng paganahin o i-disable ang cache sa
runtime gamit ang property na ito, para lang i-resize ang isang kasalukuyang cache.

Hindi kasama dito ang laki ng backbuffer (binago pagkatapos ng mpv 0.10.0).

Tandaan na sinusubukan nitong panatilihin ang mga nilalaman ng cache hangga't maaari. Upang gawin ito
mas madali, ang code sa pagbabago ng laki ng cache ay maglalaan ng bagong cache habang ang lumang cache ay
nakalaan pa rin.

Huwag gamitin ito kapag nagpe-play ng DVD o Blu-ray.

walang cache (R)
Kabuuang libreng laki ng cache sa KB.

ginagamit ng cache (R)
Kabuuang laki ng nagamit na cache sa KB.

cache-idle (R)
Kita oo kung ang cache ay idle, na nangangahulugan na ang cache ay puno ng mas maraming bilang
posible, at kasalukuyang hindi nagbabasa ng higit pang data.

demuxer-cache-tagal
Tinatayang tagal ng video na na-buffer sa demuxer, sa mga segundo. Ang hula ay
napaka hindi mapagkakatiwalaan, at kadalasan ang property ay hindi magiging available, kahit na ang data
ay buffered.

demuxer-cache-time
Tinatayang oras ng pag-buffer ng video sa demuxer, sa mga segundo. Katulad ng
demuxer-cache-tagal ngunit ibinabalik ang huling timestamp ng buffered data sa demuxer.

demuxer-cache-idle
Kita oo kung ang demuxer ay idle, na nangangahulugan na ang demuxer cache ay napuno sa
hiniling na halaga, at kasalukuyang hindi nagbabasa ng higit pang data.

naka-pause-for-cache
Kita oo kapag ang playback ay naka-pause dahil sa paghihintay para sa cache.

cache-buffering-state
Ibalik ang porsyento (0-100) ng katayuan ng cache fill hanggang sa gawin ng player
unpause (na may kaugnayan sa naka-pause-for-cache).

eof-reached
Kita oo kung natapos na ang pag-playback, hindi kung hindi. Tandaan na ito ay karaniwan
kawili-wili lamang kung --panatilihing-bukas ay pinagana, dahil kung hindi ay gagawin ng manlalaro
agad na i-play ang susunod na file (o lumabas o pumasok sa idle mode), at sa mga kasong ito ang
eof-reached Ang ari-arian ay lohikal na mali-clear kaagad pagkatapos itong maitakda.

paghahanap
Kita oo kung ang manlalaro ay kasalukuyang naghahanap, o kung hindi man ay sinusubukang i-restart
playback. (Posibleng bumalik ito oo habang nilo-load ang isang file, o kapag
pagpapalit ng nakaayos na mga segment ng kabanata. Ito ay dahil ang parehong pinagbabatayan na code ay
ginagamit para sa paghahanap at muling pag-sync.)

hr-hanapin (RW)
Tingnan --hr-hanapin.

dami (RW)
Kasalukuyang dami (tingnan --volume para sa mga detalye).

pipi (RW)
Kasalukuyang mute status (oo/hindi).

pagkaantala ng audio (RW)
Tingnan --audio-antala.

audio-codec
Pinili ang audio codec para sa pag-decode.

audio-codec-name
Audio codec.

audio-params
Audio format bilang output ng audio decoder. Ito ay may ilang mga sub-properties:

audio-params/format
Ang sample na format bilang string. Gumagamit ito ng parehong mga pangalan tulad ng ginamit sa iba
mga lugar ng mpv.

audio-params/samplerate
I-sample.

audio-params/channel
Ang layout ng channel bilang isang string. Ito ay katulad ng kung ano ang --audio-channel
tumatanggap.

audio-params/hr-channel
As channel, ngunit sa halip na ang posibleng misteryosong aktwal na layout na ipinadala sa
audio device, magbalik ng isang form na sana ay mas nababasa ng tao. (Karaniwan lang
audio-out-params/hr-channels may katuturan.)

audio-params/channel-count
Bilang ng mga audio channel. Ito ay kalabisan sa channel patlang na inilarawan
sa itaas.

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_MAP
"format" MPV_FORMAT_STRING
"samplerate" MPV_FORMAT_INT64
"mga channel" MPV_FORMAT_STRING
"channel-count" MPV_FORMAT_INT64
"hr-channels" MPV_FORMAT_STRING

audio-out-params
Katulad ng audio-params, ngunit ang format ng data na nakasulat sa audio API.

tulong (RW)
Kasalukuyang audio track (katulad ng --tulong).

audio (RW)
Alyas para sa tulong.

balanse (RW)
Balanse ng channel ng audio. (Ang pagpapatupad ng tampok na ito ay medyo kakaiba. Ito
ay hindi binabago ang mga volume ng bawat channel, ngunit sa halip ay nagse-set up ng pan matrix upang paghaluin
ang kaliwa at kanang mga channel.)

fullscreen (RW)
Tingnan --fullscreen.

deinterlace (RW)
Tingnan --deinterlace.

field-dominance (RW)
Tingnan --field-dominance

colormatrix (R)
Nagre-redirect sa video-params/colormatrix. Ang parameter na ito (pati na rin ang mga katulad) ay maaari
ma-override sa format filter ng video.

colormatrix-input-range (R)
Tingnan colormatrix.

mga antas ng video-output (RW)
Tingnan --video-output-levels,

colormatrix-primaries (R)
Tingnan colormatrix.

sa taas (RW)
Tingnan --sa taas.

hangganan (RW)
Tingnan --hangganan.

on-all-workspaces (RW)
Tingnan --sa-lahat-ng-workspace. Maaaring hindi gumana ang pag-unset sa lahat ng WM.

framedrop (RW)
Tingnan --framedrop.

gama (RW)
Tingnan --gamma.

liwanag (RW)
Tingnan --liwanag.

kaibahan (RW)
Tingnan --kaibahan.

lunod (RW)
Tingnan --saturation.

kulay (RW)
Tingnan --kulay.

hwdec (RW)
Sinasalamin ang --hwdec pagpipilian.

Maaaring baguhin ng pagsulat dito ang kasalukuyang ginagamit na hardware decoder, kung maaari.
(Sa loob, maaaring muling simulan ng manlalaro ang decoder, at magsasagawa ng paghahanap sa
i-refresh nang maayos ang video.) Maaari mong panoorin ang iba pang mga katangian ng hwdec upang makita
kung ito ay matagumpay.

Hindi tulad ng sa mpv 0.9.x at dati, hindi nito ibinabalik ang kasalukuyang aktibong hardware
decoder

hwdec-aktibo
Bumalik oo or hindi, depende sa kung ang anumang uri ng hardware decoding ay aktwal na nasa
Gamitin.

hwdec-detected
Kung aktibo ang software decoding, ibabalik nito ang ginagamit na hardware decoder.
Kung hindi, babalik din ito hindi, o kung naaangkop, ang kasalukuyang naka-load na hardware
decoding API. Ito ay malalaman lamang kapag ang VO ay nagbukas (at posibleng mamaya). Sa
ilang VOs (tulad ng openl), hindi ito alam nang maaga, ngunit kapag ang decoder
sinubukang likhain ang hw decoder na matagumpay. Gayundin, hw decoder na may -kopya
babalik ang suffix hindi habang walang video na nade-decode. Ang lahat ng ito ay sumasalamin kung paano
ang pag-detect ng mga hw decoder ay nakita at ginagamit sa loob ng mpv.

panscan (RW)
Tingnan --panscan.

format ng video
Format ng video bilang string.

video-codec
Napili ang video codec para sa pag-decode.

lapad, taas
Laki ng video. Ginagamit nito ang laki ng video bilang na-decode, o kung walang video frame
na-decode pa, ang (posibleng hindi tama) na lalagyan ay nakasaad ang laki.

video-params
Mga parameter ng video, bilang output ng decoder (na may mga override tulad ng aspeto atbp.
inilapat). Ito ay may ilang mga sub-properties:

video-params/pixelformat
Ang format ng pixel bilang string. Gumagamit ito ng parehong mga pangalan tulad ng ginamit sa ibang mga lugar
ng mpv.

video-params/average-bpp
Average na bits-per-pixel bilang integer. Iba ang ginagamit ng mga subsample na planar na format
resolution, na siyang dahilan kung minsan ang value na ito ay kakaiba o
nakakalito. Maaaring hindi available sa ilang mga format.

video-params/plane-depth
Bit depth para sa bawat bahagi ng kulay bilang integer. Ito ay nakalantad lamang para sa
planar o single-component na mga format, at hindi available para sa iba pang mga format.

video-params/w, video-params/h
Laki ng video bilang integer, na walang inilapat na pagwawasto ng aspeto.

video-params/dw, video-params/dh
Laki ng video bilang mga integer, naka-scale para sa tamang aspect ratio.

video-params/aspect
Ipakita ang aspect ratio bilang float.

video-params/par
Pixel aspect ratio.

video-params/colormatrix
Ang colormatrix na ginagamit bilang string. (Ang mga eksaktong halaga ay maaaring magbago.)

video-params/colorlevels
Ang mga antas ng kulay bilang string. (Ang mga eksaktong halaga ay maaaring magbago.)

video-params/primaries
Ang mga primaryang ginagamit bilang string. (Ang mga eksaktong halaga ay maaaring magbago.)

video-params/gamma
Ang gamma function na ginagamit bilang string. (Ang mga eksaktong halaga ay maaaring magbago.)

video-params/chroma-location
Lokasyon ng Chroma bilang string. (Ang mga eksaktong halaga ay maaaring magbago.)

video-params/rotate
Nilalayon na pag-ikot ng display sa mga degree (clockwise).

video-params/stereo-in
Stereo 3D mode ng source file. (Tingnan --video-stereo-mode opsyon.)

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_MAP
"pixelformat" MPV_FORMAT_STRING
"w" MPV_FORMAT_INT64
"h" MPV_FORMAT_INT64
"dw" MPV_FORMAT_INT64
"dh" MPV_FORMAT_INT64
"aspect" MPV_FORMAT_DOUBLE
"par" MPV_FORMAT_DOUBLE
"colormatrix" MPV_FORMAT_STRING
"mga antas ng kulay" MPV_FORMAT_STRING
"primaries" MPV_FORMAT_STRING
"chroma-location" MPV_FORMAT_STRING
"iikot" MPV_FORMAT_INT64
"stereo-in" MPV_FORMAT_STRING

lapad, taas
Laki ng display ng video. Ito ang laki ng video pagkatapos ng mga filter at pag-scale ng aspeto
inilapat. Ang aktwal na laki ng window ng video ay maaari pa ring maiba dito, hal.
kung manu-manong binago ng user ang window ng video.

Ang mga ito ay may parehong mga halaga bilang video-out-params/dw at video-out-params/dh.

video-out-params
Katulad ng video-params, ngunit pagkatapos mailapat ang mga filter ng video. Kung wala
ginagamit ang mga filter ng video, maglalaman ito ng parehong mga halaga bilang video-params. Tandaan na
hindi pa rin ito ang ginagamit ng window ng video, dahil maaaring magbago ang user
ang laki ng window, at lahat ng totoong VO ay gumagawa ng kanilang sariling pag-scale nang hiwalay mula sa
chain ng filter.

May parehong mga sub-properties bilang video-params.

video-frame-info
Tinatayang impormasyon ng kasalukuyang frame. Tandaan na kung ang alinman sa mga ito ay ginagamit sa
OSD, ang impormasyon ay maaaring na-off ng ilang mga frame dahil sa OSD redrawing at frame
ang display ay medyo nakadiskonekta, at maaaring kailanganin mong i-pause at pilitin ang a
muling iguhit.

Mga sub-properti:

video-frame-info/picture-type video-frame-info/interlaced video-frame-info/tff
video-frame-info/repeat

fps Container FPS. Madali itong maglaman ng mga huwad na halaga. Para sa mga video na gumagamit ng moderno
mga format ng container o video codec, madalas itong mali.

tinantyang-vf-fps
Tinantyang/sinusukat na FPS ng video filter chain output. (Kung walang ginagamit na mga filter,
tumutugma ito sa output ng decoder.) Ginagamit nito ang average ng 10 nakaraang frame
mga tagal upang makalkula ang FPS. Magiging hindi tumpak kung kasama ang frame-dropping
(tulad ng kapag ang framedrop ay tahasang pinagana, o pagkatapos ng tumpak na paghahanap). Mga file
na may hindi tumpak na mga timestamp (gaya ng Matroska) ay maaaring humantong sa hindi matatag na mga resulta.

sukat ng bintana (RW)
Multiplier ng laki ng window. Ang pagtatakda nito ay magre-resize ng video window sa mga value
nakapaloob sa lapad at taas pinarami sa value na itinakda sa property na ito.
Pagtatakda ng 1 ay magre-resize sa orihinal na laki ng video (o maging eksakto, ang laki ng video
output ng mga filter). 2 itatakda ang dobleng laki, 0.5 hinahati ang laki.

pinaliit ng bintana
Ibalik kung ang window ng video ay pinaliit o hindi.

mga display-name
Mga pangalan ng mga display na sakop ng mpv window. Sa X11, ito ang mga xrandr
mga pangalan (LVDS1, HDMI1, DP1, VGA1, atbp.).

display-fps (RW)
Ang refresh rate ng kasalukuyang display. Sa kasalukuyan, ito ang pinakamababang FPS sa alinman
display na sakop ng video, gaya ng kinukuha ng pinagbabatayan na mga API ng system (hal.
xrandr sa X11). Hindi ito ang sinusukat na FPS. Ito ay hindi kinakailangang magagamit sa lahat
mga platform. Tandaan na ang alinman sa mga nakalistang katotohanan ay maaaring magbago anumang oras nang walang babala.

tinantyang-display-fps
Available lang kung display-sync mode (tulad ng pinili ni --video-sync) ay aktibo.
Ibinabalik ang aktwal na rate kung saan tila nagaganap ang mga pag-refresh ng display, na sinusukat ng
oras ng sistema.

vsync-jitter
Tinantyang salik ng paglihis ng tagal ng vsync.

video-aspect (RW)
Aspekto ng video, tingnan --video-aspect.

osd-width, osd-taas
Huling kilalang lapad ng OSD (maaaring 0). Ito ay kinakailangan kung gusto mong gamitin ang overlay_add
utos. Binibigyan ka nito ng aktwal na laki ng OSD, na maaaring iba sa window
laki sa ilang mga kaso.

osd-par
Huling kilalang OSD display pixel na aspeto (maaaring 0).

Vid (RW)
Kasalukuyang video track (katulad ng --vid).

video (RW)
Alyas para sa Vid.

video-align-x, video-align-y (RW)
Tingnan --video-align-x at --video-align-y.

video-pan-x, video-pan-y (RW)
Tingnan --video-pan-x at --video-pan-y.

video-zoom (RW)
Tingnan --video-zoom.

video-unscaled (W)
Tingnan --video-unscaled.

programa (W)
Lumipat ng TS program (write-only).

Sid (RW)
Kasalukuyang subtitle track (katulad ng --sid).

pangalawang-sid (RW)
Pangalawang subtitle na track (tingnan --pangalawang-sid).

sub (RW)
Alyas para sa Sid.

sub-antala (RW)
Tingnan --sub-delay.

sub-pos (RW)
Tingnan --sub-pos.

sub-visibility (RW)
Tingnan --sub-visibility.

sub-forced-only (RW)
Tingnan --sub-forced-only.

sub-scale (RW)
Multiplier ng laki ng subtitle ng font.

ass-force-margin (RW)
Tingnan --ass-force-margin.

mga sub-use-margin (RW)
Tingnan --sub-use-margin.

ass-vsfilter-aspect-compat (RW)
Tingnan --ass-vsfilter-aspect-compat.

ass-style-override (RW)
Tingnan --ass-style-override.

stream-capture (RW)
Isang filename, tingnan --stream-capture. Ang pagtatakda nito ay magsisimulang makuha gamit ang ibinigay
filename. Ang pagtatakda nito sa isang walang laman na string ay pipigilan ito.

liwanag ng tv, tv-contrast, tv-saturation, kulay ng tv (RW)
Mga bagay sa TV.

playlist-pos (RW)
Kasalukuyang posisyon sa playlist. Ang unang entry ay nasa posisyon 0. Pagsusulat sa
ang property ay magsisimulang muli sa pag-playback sa nakasulat na entry.

bilang ng playlist
Bilang ng kabuuang mga entry sa playlist.

playlist
Playlist, kasalukuyang entry na minarkahan. Sa kasalukuyan, ang halaga ng raw property ay walang silbi.

Ito ay may ilang mga sub-properties. Palitan N gamit ang 0-based na playlist entry
index.

playlist/bilang
Bilang ng mga entry sa playlist (katulad ng bilang ng playlist).

playlist/N/filename
Filename ng Nth entry.

playlist/N/kasalukuyan, playlist/N/nagpe-play
oo kung ang entry na ito ay kasalukuyang nagpe-play (o nilo-load). Hindi magagamit o hindi
kung hindi. Kapag nagpapalit ng mga file, kasalukuyan at laro maaaring magkaiba,
dahil ang kasalukuyang nagpe-play na file ay hindi pa na-unload; sa kasong ito,
kasalukuyan ay tumutukoy sa bagong seleksyon. (Mula sa mpv 0.7.0.)

playlist/N/title
Pangalan ng Nth entry. Available lang kung ang playlist file ay naglalaman ng ganoon
field, at kung sinusuportahan lamang ito ng parser ng mpv para sa ibinigay na format ng playlist.

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (para sa bawat entry sa playlist)
"filename" MPV_FORMAT_STRING
"kasalukuyang" MPV_FORMAT_FLAG (maaaring nawawala; dahil mpv 0.7.0)
"naglalaro" ng MPV_FORMAT_FLAG (pareho)
"title" MPV_FORMAT_STRING (opsyonal)

listahan ng track
Listahan ng mga audio/video/sub track, kasalukuyang entry na minarkahan. Sa kasalukuyan, ang raw na ari-arian
walang silbi ang halaga.

Ito ay may ilang mga sub-properties. Palitan N gamit ang 0-based na track index.

track-list/count
Kabuuang bilang ng mga track.

track-list/N/id
Ang ID kung paano ito ginagamit -sid/--tulong/--vid. Ito ay natatangi sa mga track ng
ang parehong uri (sub/audio/video), ngunit kung hindi man ay hindi.

track-list/N/type
String na naglalarawan sa uri ng media. Isa sa audio, video, sub.

track-list/N/src-id
Track ID gaya ng ginamit sa source file. Hindi laging available.

track-list/N/title
Pamagat ng track habang naka-imbak ito sa file. Hindi laging available.

track-list/N/lang
Subaybayan ang wika gaya ng natukoy ng file. Hindi laging available.

track-list/N/audio-channel
Para sa mga audio track, ang bilang ng mga audio channel sa audio stream. Hindi
palaging tumpak (depende sa mga pahiwatig ng lalagyan). Hindi laging available.

track-list/N/albumart
oo kung ito ay isang video track na binubuo ng isang larawan, hindi or
hindi magagamit kung hindi man. Ito ay ginagamit para sa mga video track na talaga
naka-attach na mga larawan sa mga audio file.

track-list/N/default
oo kung ang track ay may default na flag na nakatakda sa file, hindi kung hindi man.

track-list/N/sapilitang
oo kung ang track ay may sapilitang flag na nakatakda sa file, hindi kung hindi man.

track-list/N/codec
Halimbawa, ang pangalan ng codec na ginamit ng track na ito h264. Hindi available sa ilan
mga bihirang kaso.

track-list/N/panlabas
oo kung ang track ay isang panlabas na file, hindi kung hindi. Ito ay nakatakda para sa hiwalay
mga subtitle na file.

track-list/N/external-filename
Ang filename kung ang track ay mula sa isang panlabas na file, hindi magagamit kung hindi man.

track-list/N/napili
oo kung kasalukuyang na-decode ang track, hindi kung hindi man.

track-list/N/ff-index
Ang stream index gaya ng karaniwang ginagamit ng mga FFmpeg utilities. Tandaan na ito ay maaari
maaaring maging mali kung ang isang demuxer maliban sa libavformat (--demuxer=lavf) ay
ginamit. Para sa mga mkv file, karaniwang tutugma ang index kahit na ang default
(builtin) demuxer ang ginagamit, ngunit walang matibay na garantiya.

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (para sa bawat track)
"id" MPV_FORMAT_INT64
"type" MPV_FORMAT_STRING
"src-id" MPV_FORMAT_INT64
"title" MPV_FORMAT_STRING
"lang" MPV_FORMAT_STRING
"mga audio-channel" MPV_FORMAT_INT64
"albumart" MPV_FORMAT_FLAG
"default" MPV_FORMAT_FLAG
"sapilitang" MPV_FORMAT_FLAG
"panlabas" MPV_FORMAT_FLAG
"external-filename" MPV_FORMAT_STRING
"codec" MPV_FORMAT_STRING

listahan ng kabanata
Listahan ng mga kabanata, kasalukuyang entry na minarkahan. Sa kasalukuyan, ang halaga ng raw property ay
walang silbi

Ito ay may ilang mga sub-properties. Palitan N na may 0-based na index ng kabanata.

listahan-kabanata/bilang
Bilang ng mga kabanata.

listahan-kabanata/N/pamagat
Pamagat ng kabanata bilang naka-imbak sa file. Hindi laging available.

listahan-kabanata/N/oras
Oras ng pagsisimula ng kabanata sa mga segundo bilang float.

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (para sa bawat kabanata)
"title" MPV_FORMAT_STRING
"oras" MPV_FORMAT_DOUBLE

af (RW)
Tingnan --af at ang af utos.

vf (RW)
Tingnan --vf at ang vf utos.

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (para sa bawat filter na entry)
"pangalan" MPV_FORMAT_STRING
"label" MPV_FORMAT_STRING [opsyonal]
"params" MPV_FORMAT_NODE_MAP [opsyonal]
"key" MPV_FORMAT_STRING
"halaga" MPV_FORMAT_STRING

Posible ring isulat ang property gamit ang format na ito.

video-rotate (RW)
Tingnan --video-rotate pagpipilian.

mahahanap
Ibalik kung karaniwang posible na maghanap sa kasalukuyang file.

bahagyang-naghahanap
Bumalik oo kung ang kasalukuyang file ay itinuturing na mahahanap, ngunit dahil lamang sa cache
ay aktibo. Nangangahulugan ito na ang maliliit na paghahanap ng kamag-anak ay maaaring maayos, ngunit ang mas malalaking paghahanap ay maaaring mabigo
sabagay. Kung ang isang paghahanap ay magtatagumpay o hindi ay karaniwang hindi alam nang maaga.

Kung ang property na ito ay magbabalik ng true, mahahanap babalik din ng totoo.

playback-abort
Ibalik kung itinigil o ititigil ang pag-playback. (Kapaki-pakinabang sa hindi malinaw
mga sitwasyon tulad ng sa panahon on_load pagpoproseso ng hook, kapag maaaring ihinto ng user ang pag-playback,
ngunit ang script ay kailangang tahasang tapusin ang pagproseso.)

cursor-autohide (RW)
Tingnan --cursor-autohide. Ang pagtatakda nito sa isang bagong halaga ay palaging mag-a-update sa cursor,
at i-reset ang panloob na timer.

osd-sym-cc
Ipinapasok ang kasalukuyang simbolo ng OSD bilang opaque OSD control code (cc). Makatuwiran ito
kasama lamang ang palabas-teksto command o mga opsyon na nagtatakda ng mga mensaheng OSD. Ang kontrol
Ang code ay tiyak sa pagpapatupad at walang silbi para sa anumang bagay.

osd-ass-cc
${osd-ass-cc/0} hindi pinapagana ang pagtakas sa mga ASS sequence ng text sa OSD, ${osd-ass-cc/1}
pinapagana itong muli. Bilang default, ang mga sequence ng ASS ay tinatakasan upang maiwasan ang aksidente
pag-format, at maaaring hindi paganahin ng property na ito ang gawi na ito. Tandaan na ang mga katangian
ibalik ang isang opaque na OSD control code, na makatuwiran lamang para sa palabas-teksto utos
o mga opsyon na nagtatakda ng mga mensaheng OSD.

halimbawa

· --osd-status-msg='Ito is ${osd-ass-cc/0}{\\b1}naka-bold text'

· palabas-teksto "Ito is ${osd-ass-cc/0}{\b1}naka-bold text"

Maaaring gamitin ang anumang ASS override tag na nauunawaan ng libass.

Tandaan na kailangan mong takasan ang character, dahil pinoproseso ang string para sa C
escape sequences bago ito ipasa sa OSD code.

Ang isang listahan ng mga tag ay matatagpuan dito: http://docs.aegisub.org/latest/ASS_Tags/

vo-configure
Ibalik kung naka-configure ang VO ngayon. Kadalasan ito ay tumutugma sa kung
makikita ang video window. Kung ang --force-window ginagamit ang opsyon, kadalasan ito
laging bumabalik oo.

bitrate ng video, audio-bitrate, sub-bitrate
Kinakalkula ang mga halaga ng bitrate sa antas ng packet. Gumagana ito sa pamamagitan ng paghati sa laki ng bit
ng lahat ng packet sa pagitan ng dalawang keyframe ayon sa distansya ng timestamp ng presentation.
(Ginagamit nito ang mga timestamp na nakaimbak sa file, kaya hal. ang bilis ng pag-playback ay hindi
makaimpluwensya sa mga ibinalik na halaga.) Sa partikular, ang bitrate ng video ay mag-a-update lamang
bawat keyframe, at ipakita ang "nakaraang" bitrate. Para gawing mas UI friendly ang property,
ang mga update sa mga property na ito ay na-throttle sa isang tiyak na paraan.

Ang unit ay bits per second. Ginagawa ng OSD formatting ang mga value na ito sa kilobits (o
megabits, kung naaangkop), na maaaring mapigilan sa pamamagitan ng paggamit ng hilaw na halaga ng ari-arian,
hal kasama ng ${=video-bitrate}.

Tandaan na ang katumpakan ng mga katangiang ito ay naiimpluwensyahan ng ilang salik. Kung ang
ang pinagbabatayan na demuxer ay muling isinusulat ang mga packet sa demuxing (ginawa para sa ilang mga format ng file),
maaaring medyo off ang bitrate. Kung ang mga timestamp ay hindi maganda o kinakabahan (tulad ng in
Matroska), kahit na ang mga tuluy-tuloy na bitrate stream ay maaaring magpakita ng pabagu-bagong bitrate.

Kung paano eksaktong kinakalkula ang mga halagang ito ay maaaring magbago sa hinaharap.

Sa mga naunang bersyon ng mpv, nagbalik ang mga property na ito ng static (ngunit masama) hula
gamit ang isang ganap na naiibang pamamaraan.

packet-video-bitrate, packet-audio-bitrate, packet-sub-bitrate
Luma at hindi na ginagamit na mga ari-arian para sa video-bitrate, audio-bitrate, sub-bitrate. Sila
kumilos nang eksakto pareho, ngunit ibalik ang isang halaga sa kilobits. Isa pa, wala sila
Pag-format ng OSD, kahit na ang parehong ay maaaring makamit sa hal. ${=video-bitrate}.

Hindi na dapat gamitin ang mga property na ito.

listahan ng audio-device
Ibalik ang listahan ng mga natuklasang audio device. Ito ay kadalasang para gamitin sa kliyente
API, at sumasalamin sa kung ano --audio-device=help sa pagbabalik ng command line player.

Kapag nag-query sa property gamit ang client API na ginagamit MPV_FORMAT_NODE, o kasama si Lua
mp.get_property_native, magbabalik ito ng mpv_node na may mga sumusunod na nilalaman:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (para sa bawat entry ng device)
"pangalan" MPV_FORMAT_STRING
"paglalarawan" MPV_FORMAT_STRING

Ang pangalan ay kung ano ang ipapasa sa --audio-device opsyon (at kadalasan ay isang halip
cryptic audio API-specific ID), habang paglalarawan ay nababasa ng tao na malayang anyo na teksto.
Ang paglalarawan ay isang walang laman na string kung walang natanggap.

Ang espesyal na entry na may nakatakdang pangalan sa kotse pinipili ang default na audio output driver
at ang default na device.

Mapapanood ang property gamit ang property observation mechanism sa client
API at sa mga script ng Lua. (Sa teknikal, ang abiso ng pagbabago ay pinagana sa unang pagkakataon
nabasa ang ari-arian na ito.)

audio-device (RW)
Itakda ang audio device. Ito ay direktang nagbabasa/nagsusulat ng --audio-device opsyon, ngunit sa
write access, ang audio output ay naka-iskedyul para sa reloading.

Ang pagsusulat ng property na ito habang walang audio output ay aktibo ay hindi awtomatikong ie-enable
audio. (Totoo rin ito sa kaso kung kailan hindi pinagana ang audio dahil sa
pagkabigo sa muling pagsisimula pagkatapos ng nakaraang access sa pagsusulat audio-device.)

Hindi rin sinasabi sa iyo ng property na ito kung aling audio device ang aktwal na ginagamit.

Kung paano pinangangasiwaan ang mga detalyeng ito ay maaaring magbago sa hinaharap.

kasalukuyang-vo
Kasalukuyang video output driver (pangalan gaya ng ginamit sa --vo).

kasalukuyang-ao
Kasalukuyang audio output driver (pangalan gaya ng ginamit sa --ao).

audio-out-detected-device
Ibalik ang audio device na pinili ng AO driver (ipinatupad lang para sa ilan
mga driver: sa kasalukuyan lamang coreaudio).

working-directory
Ibalik ang gumaganang direktoryo ng proseso ng mpv. Maaaring maging kapaki-pakinabang para sa mga gumagamit ng JSON IPC,
dahil ang command line player ay karaniwang gumagana sa mga kamag-anak na landas.

listahan ng protocol
Listahan ng mga protocol prefix na posibleng makilala ng player. Ibinalik sila
nang walang trailing :/ / panlapi (na palaging kinakailangan). Sa ilang mga kaso, ang
protocol ay hindi talaga susuportahan (isipin https kung ang ffmpeg ay hindi naipon
na may suporta sa TLS).

mpv-bersyon
Ibalik ang mpv version/copyright string. Depende sa kung paano binuo ang binary, ito
maaaring maglaman ng alinman sa bersyon ng paglabas, o isang git hash lang.

mpv-configuration
Ibalik ang mga argumento ng pagsasaayos na ipinasa sa build system (karaniwang
ang daan ./waff i-configure ang ... ay tinawag).

mga opsyon/ (RW)
Read-only na access sa halaga ng opsyon --. Karamihan sa mga opsyon ay maaaring baguhin sa
runtime sa pamamagitan ng pagsulat sa property na ito. Tandaan na maraming mga opsyon ang nangangailangan ng pag-reload ng
file para magkabisa ang mga pagbabago. Kung may katumbas na property, mas gusto ang setting
ang ari-arian sa halip.

file-local-options/
Kapareho ng mga opsyon/, ngunit kapag nagtatakda ng opsyon sa pamamagitan ng property na ito, ang
ang opsyon ay ire-reset sa lumang halaga nito kapag ang kasalukuyang file ay tumigil sa paglalaro. sinusubukan
upang magsulat ng isang opsyon habang walang file na nagpe-play (o nilo-load) ay nagreresulta sa isang
error.

(Tandaan na kung ang isang opsyon ay minarkahan bilang file-local, kahit na mga pagpipilian/ ay maa-access ang
lokal na halaga, at ang luma halaga, na ibabalik sa pagtatapos ng pag-playback, ay hindi maaaring
basahin o isulat hanggang matapos ang pag-playback.)

opsyon-impormasyon/
Karagdagang impormasyon sa bawat opsyon.

Ito ay may ilang mga sub-properties. Palitan na may pangalan ng isang nangungunang antas
opsyon. Walang garantiya ng katatagan ang ibinibigay sa alinman sa mga sub-properti na ito - sila
maaaring magbago nang malaki sa feature.

option-info//name
Ibinabalik ang pangalan ng opsyon.

option-info//type
Ibalik ang pangalan ng uri ng opsyon, tulad ng Pisi or Integer. Para sa marami
kumplikadong mga uri, hindi ito masyadong tumpak.

option-info//set-from-commandline
Bumalik oo kung ang opsyon ay itinakda mula sa mpv command line, hindi kung hindi man.
Saan ito nakatakda kung ang opsyon ay hal. binago sa runtime ang natitira
hindi natukoy (ibig sabihin maaari itong magbago sa hinaharap).

option-info//set-locally
Bumalik oo kung ang opsyon ay itinakda sa bawat file. Ito ang kaso sa
awtomatikong na-load ang mga profile, file-dir config, at iba pang mga kaso. Ibig sabihin
ang halaga ng opsyon ay ibabalik sa halaga bago magsimula ang pag-playback kung kailan
matatapos ang playback.

option-info//default-value
Ang default na halaga ng opsyon. Maaaring hindi palaging magagamit.

option-info//min, option-info//max
Integer minimum at maximum na mga halaga na pinapayagan para sa opsyon. Available lang kung
ang mga opsyon ay numeric, at ang minimum/maximum ay naitakda sa loob.
Posible rin na isa lang sa mga ito ang nakatakda.

option-info//choices
Kung ang opsyon ay isang pagpipiliang pagpipilian, ang mga posibleng pagpipilian. Mga pagpipilian na
ang mga integer ay maaaring isama o hindi (maaari silang ipahiwatig ng minuto at max).
Tandaan na ang mga opsyon na kumikilos tulad ng mga pagpipilian sa pagpili, ngunit hindi aktuwal
mga opsyon sa pagpili sa loob, maaaring hindi available ang impormasyong ito.

listahan ng ari-arian
Ibalik ang listahan ng mga top-level na property.

Ari-arian Paglawak
Lahat ng string argument sa input command pati na rin ang ilang mga opsyon (tulad ng
--term-playing-msg) ay napapailalim sa pagpapalawak ng ari-arian. Tandaan na ginagawa ng pagpapalawak ng ari-arian
hindi nagtatrabaho sa mga lugar kung saan hal. inaasahan ang mga numerong parameter. (Halimbawa, ang idagdag
ang utos ay hindi gumagawa ng pagpapalawak ng ari-arian. Ang itakda Ang utos ay isang pagbubukod at hindi isang heneral
tuntunin.)

Halimbawa para sa input.conf

i palabas-teksto Filename: ${filename}
ipinapakita ang filename ng kasalukuyang file kapag pinindot ang i susi

Sa loob input.conf, maaaring pigilan ang pagpapalawak ng ari-arian sa pamamagitan ng paglalagay ng hilaw prefix sa harap
ng mga utos.

Ang mga sumusunod na pagpapalawak ay sinusuportahan:

${NAME}
Lumalawak sa halaga ng ari-arian NAME. Kung nabigo ang pagkuha ng ari-arian, palawakin
sa isang error string. (Gamitin ${NAME:} na may trailing : upang palawakin sa isang walang laman na string
sa halip.) Kung NAME ay prefixed na may =, lumawak sa hilaw na halaga ng ari-arian (tingnan
seksyon sa ibaba).

${NAME:STR}
Lumalawak sa halaga ng ari-arian NAME, O STR kung ang ari-arian ay hindi maaaring
nakuha. STR ay pinalawak na recursively.

${?NAME:STR}
Lumalawak sa STR (recursively) kung ang ari-arian NAME ay magagamit.

${!NAME:STR}
Lumalawak sa STR (recursively) kung ang ari-arian NAME hindi na mabawi.

${?NAME==VALUE:STR}
Lumalawak sa STR (recursively) kung ang ari-arian NAME lumalawak sa isang string na katumbas ng
VALUE. Maaari mong prefix NAME sa = upang maihambing ang hilaw na halaga ng isang ari-arian
(tingnan ang seksyon sa ibaba). Kung ang ari-arian ay hindi available, o iba pang mga error ang mangyayari kapag
sa pagkuha nito, ang halaga ay hindi kailanman itinuturing na pantay. Tandaan na VALUE hindi maaaring maglaman
alinman sa mga karakter : or }. Gayundin, ito ay posible na escaping sa " or % maaari
idadagdag sa hinaharap, kung kinakailangan.

${!NAME==VALUE:STR}
Katulad ng sa ? variant, ngunit STR ay pinalawak kung ang halaga ay hindi pantay. (Ginagamit ang
ang parehong semantika tulad ng sa ?.)

$$ Lumalawak sa $.

$} Lumalawak sa }. (Upang makagawa ng karakter na ito sa loob ng recursive expansion.)

$> Huwag paganahin ang pagpapalawak ng ari-arian at espesyal na pangangasiwa ng $ para sa natitirang string.

Sa mga lugar kung saan pinapayagan ang pagpapalawak ng ari-arian, kadalasang tinatanggap din ang mga C-style na pagtakas.
Halimbawa:

· \n nagiging bagong linyang karakter

· \ lumalawak sa

Hilaw at Formatted Mga Katangian
Karaniwan, ang mga katangian ay naka-format bilang text na nababasa ng tao, na nilalayong ipakita sa OSD o
sa terminal. Posibleng kumuha ng hindi na-format (raw) na halaga mula sa isang property sa pamamagitan ng
prefixing ang pangalan nito sa =. Ang mga hilaw na halaga na ito ay maaaring i-parse ng iba pang mga programa at sundin ang
parehong mga kumbensyon gaya ng mga opsyong nauugnay sa mga pag-aari.

Mga halimbawa

· ${time-pos} lumalawak sa 00:14:23 (kung ang posisyon ng playback ay nasa 14 minuto 23 segundo)

· ${=time-pos} lumalawak sa 863.4 (sa parehong oras, kasama ang 400 millisecond - millisecond ay
karaniwang hindi ipinapakita sa naka-format na case)

Minsan, ang pagkakaiba sa dami ng impormasyong dala ng raw at naka-format na ari-arian
ang mga halaga ay maaaring medyo malaki. Sa ilang mga kaso, ang mga raw value ay may higit pang impormasyon, tulad ng mas mataas
katumpakan kaysa sa mga segundo na may oras-pos. Minsan ito ay kabaligtaran, hal. tulong Ipinapakita ng
pamagat ng track at wika sa naka-format na case, ngunit ang track number lang kung ito ay raw.

ON SCREEN Controller

Ang On Screen Controller (short: OSC) ay isang minimal na GUI na isinama sa mpv upang mag-alok ng basic
kontrol ng mouse. Nilalayon nitong gawing mas madali ang pakikipag-ugnayan para sa mga bagong user at sa
paganahin ang tumpak at direktang paghahanap.

Ang OSC ay pinagana bilang default kung ang mpv ay pinagsama-sama sa suporta ng Lua. Maaari itong ma-disable
ganap na gumagamit ng --osc=no pagpipilian.

paggamit ang CSO
Bilang default, ang OSC ay lalabas sa tuwing ang mouse ay ililipat sa loob ng player window at
ay itatago kung ang mouse ay hindi inilipat sa labas ng OSC sa loob ng 0.5 segundo o kung ang mouse ay umalis
ang bintana.

Ang interface
+---------------------------------------- --+
| playlist prev | pamagat | susunod na playlist |
+-------+------+---+--+------+-+----+------+------ --+
| audio | laktawan | hanapin | | hanapin | laktawan | puno |
+-------+ pabalik | pabalik | maglaro | frwd | frwd | screen |
| sub | | | | | | |
+-------+------+------+------+------+------+------ --+
| seekbar |
+----------------+----------------+----------------- --+
| lumipas ang oras | katayuan ng cache | oras na natitira |
+----------------+----------------+----------------- --+

playlist nkrn

.
│left-click │ i-play ang nakaraang file sa playlist │
.
│shift+L-click │ ipakita ang playlist │
.

pamagat
Ipinapakita ang kasalukuyang media-title o filename

┌────────────┬─────────────────┬─────────────────——─‐——─‐——──——
│left-click │ ipakita ang posisyon ng playlist at │
│ │ haba at buong pamagat │
.
│right-click │ ipakita ang filename │
.

playlist susunod

. ───┐
│left-click │ i-play ang susunod na file sa playlist │
├──────────────┼─────────────── ───——─ ───┤
│shift+L-click │ ipakita ang playlist │
└──────────────┴───────────────—───—─ ───┘

audio at sub
Ipinapakita ang napiling track at dami ng magagamit na mga track

┌──────────────┬────────────────────────────────── ┐
│left-click │ cycle audio/sub tracks forward │
├──────────────┼────────────────────────────────── ┤
│right-click │ cycle audio/sub track pabalik │
├──────────────┼────────────────────────────────── ┤
│shift+L-click │ ipakita ang mga available na audio/sub track │
└──────────────┴────────────────────────────────── ┘

laktawan likod

┌──────────────┬────────────────────────────────── ┐
│left-click │ pumunta sa simula ng kabanata / │
│ │ nakaraang kabanata │
├──────────────┼────────────────────────────────── ┤
│shift+L-click │ ipakita ang mga kabanata │
└──────────────┴────────────────────────────────── ┘

maghanap likod

┌──────────────┬──────────────────────────
│left-click │ laktawan pabalik 5 segundo │
├──────────────┼─────────────────────
│right-click │ laktawan pabalik 30 segundo │
├──────────────┼─────────────────────
│shift-L-click │ laktawan pabalik 1 frame │
└──────────────┴───────────────────‘─

maglaro

┌───────────┬────────────────────
│left-click │ toggle play/pause │
└───────────┴───────────────────

maghanap frwd

. ┐
│left-click │ laktawan pasulong 10 segundo │
├──────────────┼─────────────── ───—— ┤
│right-click │ lumaktaw pasulong 60 segundo │
├──────────────┼─────────────── ───—— ┤
│shift-L-click │ laktawan pasulong 1 frame │
└──────────────┴───────────────—───—─ ┘

laktawan frwd

┌──────────────┬─────────────────────────
│left-click │ pumunta sa susunod na kabanata │
├──────────────┼─────────────────────
│shift+L-click │ ipakita ang mga kabanata │
└──────────────┴─────────────────────────

fullscreen

┌───────────┬────────────────────
│left-click │ toggle fullscreen │
└───────────┴───────────────────

seekbar
Ipinapahiwatig ang kasalukuyang posisyon ng pag-playback at posisyon ng mga kabanata

┌───────────┬──────────────────
│left-click │ humanap sa posisyon │
└───────────┴──────────────────

oras Lumipas
Ipinapakita ang kasalukuyang timestamp ng posisyon ng playback

.
│left-click │ i-toggle ang pagpapakita ng mga timecode gamit ang │
│ │ millisecond │
.

cache katayuan
Ipinapakita ang kasalukuyang katayuan ng pagpuno ng cache (makikita lamang kapag mas mababa sa 45%)

oras natitira
Ipinapakita ang natitirang timestamp ng oras ng pag-playback

.
│left-click │ toggle sa pagitan ng total at │
│ │ natitirang oras │
.

Key Mga binding
Ang mga key binding na ito ay aktibo bilang default kung wala nang iba pang nakatali sa mga key na ito.
Sa kaso ng banggaan, ang function ay kailangang itali sa ibang key. Tingnan ang Iskrip
Command seksyon.

┌;
│del │ Permanenteng itago ang OSC hanggang │
│ │ mpv ay na-restart. │
└;

Configuration
Ang OSC ay nag-aalok ng limitadong pagsasaayos sa pamamagitan ng isang config file lua-settings/osc.conf nilagay sa
mpv's user dir at sa pamamagitan ng --script-opts opsyon sa command-line. Mga opsyon na ibinigay sa pamamagitan ng
i-override ng command-line ang mga mula sa config file.

config palaugnayan
Dapat na eksaktong sundin ng config file ang sumusunod na syntax:

# ito ay isang komento
optionA=value1
optionB=value2

# maaari lamang gamitin sa simula ng isang linya at maaaring walang mga puwang sa paligid ng = or
kahit saan.

Command-line palaugnayan
Upang maiwasan ang mga banggaan sa iba pang mga script, ang lahat ng mga opsyon ay kailangang naka-prefix sa osc-.

Halimbawa:

--script-opts=osc-optionA=value1,osc-optionB=value2

Maaaring i-configure Options
showwindowed
Default: oo
Paganahin ang OSC kapag naka-window

showfullscreen
Default: oo
Paganahin ang OSC kapag fullscreen

scalewindowed
Default: 1.0
Scale factor ng OSC kapag naka-window

scalefullscreen
Default: 1.0
Scale factor ng OSC kapag fullscreen

scaleforcedwindow
Default: 2.0
Scale factor ng OSC kapag na-render sa isang sapilitang (dummy) na window

vidscale
Default: oo
I-scale ang OSC gamit ang video
hindi sinusubukang panatilihing pare-pareho ang laki ng OSC hangga't pinapayagan ng laki ng window

baliw
Default: 0.8
Vertical alignment, -1 (itaas) hanggang 1 (ibaba)

halign
Default: 0.0
Pahalang na pagkakahanay, -1 (kaliwa) hanggang 1 (kanan)

boxalpha
Default: 80
Alpha ng background box, 0 (opaque) hanggang 255 (fully transparent)

hidetimeout
Default: 500
Tagal sa ms hanggang sa magtago ang OSC kung walang paggalaw ng mouse, negatibong halaga
hindi pinapagana ang auto-hide

pagkupas
Default: 200
Tagal ng fade out sa ms, 0 = walang fade

deadzonesize
Default: 0
Laki ng deadzone. Ang deadzone ay isang lugar na nagpapakilos sa mouse
tulad ng pag-alis sa bintana. Ang paggalaw doon ay hindi lalabas ang OSC at
ito ay magtatago kaagad kung ang mouse ay pumasok dito. Magsisimula na ang deadzone
sa hangganan ng bintana sa tapat ng OSC at ang laki ay kumokontrol kung magkano
ng bintana na ito ay aabot. Mga halaga sa pagitan ng 0 at 1.

minmousemove
Default: 3
Pinakamababang halaga ng mga pixel na kailangang ilipat ng mouse sa pagitan ng mga ticks upang gawin
lumalabas ang OSC

kaayusan
Default: kahon
Ang layout para sa OSC. Kasalukuyang magagamit ay: box, slimbox,
bottombar at topbar.

seekbarstyle
Default: slider
Itinatakda ang istilo ng seekbar, slider (diamond marker) o bar (fill)

kabuuang oras
Default: hindi
Ipakita ang kabuuang oras sa halip na oras na natitira

mga oras
Default: hindi
Ipakita ang mga timecode na may mga millisecond

Iskrip Command
Ang script ng OSC ay nakikinig sa ilang mga utos ng script. Ang mga utos na ito ay maaaring magkaugnay input.conf,
o ipinadala ng iba pang mga script.

paganahin-osc
Ina-undo huwag paganahin-osc o ang epekto ng del susi.

huwag paganahin-osc
Itago ang OSC nang permanente. Ito rin ang del ginagawa ng susi.

osc-mensahe
Magpakita ng mensahe sa screen gamit ang OSC. Ang unang argumento ay ang mensahe, pangalawa ang
tagal sa segundo.

halimbawa

Maaari mong ilagay ito sa input.conf upang itago ang OSC sa a susi at itago ito gamit ang b:

isang script_message disable-osc
b script_message enable-osc

LUA PAG-SCRIPT

Ang mpv ay maaaring mag-load ng mga script ng Lua. Ipinasa ang mga script sa --script opsyon, o matatagpuan sa script
subdirectory ng mpv configuration directory (karaniwang ~/.config/mpv/scripts/) magiging
na-load sa pagsisimula ng programa. idinaragdag din ng mpv ang script subdirectory sa dulo ng Lua's
path para makapag-import ka rin ng mga script mula doon. Dahil idinagdag ito sa dulo, huwag pangalanan
mga script na gusto mong i-import kapareho ng mga aklatan ng Lua dahil matatakpan ang mga ito
Kanila.

Ang mpv ay nagbibigay ng built-in na module mp, na naglalaman ng mga function upang magpadala ng mga command sa mpv
core at upang kunin ang impormasyon tungkol sa estado ng pag-playback, mga setting ng user, impormasyon ng file,
at iba pa.

Ang mga script na ito ay maaaring gamitin upang kontrolin ang mpv sa katulad na paraan sa slave mode. Sa teknikal, ang
Ginagamit ng Lua code ang client API sa loob.

halimbawa
Isang script na umaalis sa fullscreen mode kapag naka-pause ang player:

function on_pause_change(pangalan, halaga)
kung ang halaga == totoo kung gayon
mp.set_property("fullscreen", "no")
dulo
dulo
mp.observe_property("pause", "bool", on_pause_change)

Detalye on ang script Pinasimulan at lifecycle
Ang iyong script ay ilo-load ng player sa simula ng programa mula sa script configuration
subdirectory, o mula sa isang path na tinukoy sa --script opsyon. Ang ilang mga script ay na-load
panloob (tulad ng --osc). Ang bawat script ay tumatakbo sa sarili nitong thread. Ang iyong script ay unang tumakbo "as
ay", at kapag tapos na iyon, ipinasok ang loop ng kaganapan. Ipapadala ang loop ng kaganapang ito
mga kaganapan na natanggap ng mpv at tumawag sa iyong sariling mga tagapangasiwa ng kaganapan kung saan ka nakarehistro
mp.register_event, o mga timer na idinagdag sa mp.add_timeout o katulad.

Kapag huminto ang manlalaro, hihilingin sa lahat ng mga script na wakasan. Nangyayari ito sa pamamagitan ng a pagpipinid
kaganapan, na bilang default ay ibabalik ang loop ng kaganapan. Kung ang iyong script ay pumasok sa isang
walang katapusang loop, ang mpv ay malamang na kumilos nang maayos sa panahon ng pag-playback (maliban kung ang player ay
sinuspinde, tingnan mp.suspinde), ngunit hindi ito magwawakas kapag huminto, dahil naghihintay ito
iyong script.

Sa panloob, tatawagin ng C code ang function na Lua mp_event_loop pagkatapos mag-load ng Lua
iskrip. Ang function na ito ay karaniwang tinutukoy ng default na prelude na na-load bago ang iyong script
(Tingnan ang player/lua/defaults.lua sa mga mapagkukunan ng mpv). Ang loop ng kaganapan ay maghihintay para sa mga kaganapan at
pagpapadala ng mga kaganapan na nakarehistro sa mp.register_event. Hahawakan din nito ang mga timer na idinagdag
mp.add_timeout at katulad nito (sa pamamagitan ng paghihintay na may timeout).

Dahil mpv 0.6.0, maghihintay ang player hanggang sa ganap na ma-load ang script bago magpatuloy
normal na operasyon. Itinuturing ng player na ganap na na-load ang isang script sa sandaling magsimula ito
naghihintay para sa mga kaganapan sa mpv (o ito ay lumabas). Sa pagsasanay ito ay nangangahulugan na ang manlalaro ay higit pa o mas kaunti
mag-hang hanggang sa bumalik ang script mula sa pangunahing tipak (at mp_event_loop ay tinatawag), o ang
mga tawag sa script mp_event_loop or mp.dispatch_events direkta. Ginagawa ito para magawa ito
posible para sa isang script na ganap na mag-setup ng mga humahawak ng kaganapan atbp. bago aktwal na magsimula ang playback.
Sa mga mas lumang bersyon ng mpv, nangyari ito nang asynchronously.

mp function
Ang mp Ang module ay paunang na-load, bagama't maaari itong i-load nang manu-mano mangailangan 'mp'. Ito
nagbibigay ng pangunahing client API.

mp.command(string)
Patakbuhin ang ibinigay na utos. Ito ay katulad ng mga utos na ginamit sa input.conf. Tingnan mo
listahan of input Command.

Bilang default, magpapakita ito ng isang bagay sa OSD (depende sa utos), na parang
ito ay ginamit sa input.conf. Tingnan input Utos Prefix paano maimpluwensyahan ang paggamit ng OSD
bawat utos.

Kita totoo sa tagumpay, o nil mali sa pagkakamali.

mp.commandv(arg1, arg2, ...)
Kapareho ng mp.utos, ngunit ipasa ang bawat command argument bilang hiwalay na parameter. Ito
may kalamangan na hindi mo kailangang mag-alala tungkol sa pag-quote at pagtakas sa ilan
mga kaso.

Halimbawa:

mp.command("loadfile " .. filename .. " append")
mp.commandv("loadfile", filename, "append")

Ang dalawang utos na ito ay katumbas, maliban na ang unang bersyon ay masira kung ang
Ang filename ay naglalaman ng mga puwang o ilang mga espesyal na character.

Tandaan na ang mga ari-arian ay hindi pinalawak. Maaari mong gamitin ang alinman mp.utos, ang
expand-properties prefix, o ang mp.get_property pamilya ng mga tungkulin.

Hindi magkatulad mp.utos, hindi rin ito gagamit ng OSD bilang default (maliban sa ilan
mga utos na partikular sa OSD).

mp.command_native(talahanayan [,def])
Kapareho ng mp.commandv, ngunit ipasa ang listahan ng argumento bilang talahanayan. Ito ay may kalamangan
na sa hindi bababa sa ilang mga kaso, ang mga argumento ay maaaring ipasa bilang mga katutubong uri.

Nagbabalik ng talahanayan ng resulta sa tagumpay (karaniwang walang laman), o def, mali sa pagkakamali. def is
ang pangalawang parameter na ibinigay sa function, at wala kung nawawala ito.

mp.get_property(pangalan [,def])
Ibalik ang halaga ng ibinigay na property bilang string. Ang mga ito ay ang parehong mga katangian bilang
ginamit sa input.conf. Tingnan mo Mga Katangian para sa isang listahan ng mga ari-arian. Ang ibinalik na string ay
naka-format na katulad ng ${=pangalan} (Tingnan ang Ari-arian Paglawak).

Ibinabalik ang string sa tagumpay, o def, mali sa pagkakamali. def ay ang pangalawang parameter
ibinigay sa function, at wala kung nawawala ito.

mp.get_property_osd(pangalan [,def])
Kapareho ng mp.get_property, ngunit ibalik ang value ng property na naka-format para sa OSD. Ito
ay ang parehong string tulad ng naka-print na may ${name} kapag ginamit sa input.conf.

Ibinabalik ang string sa tagumpay, o def, mali sa pagkakamali. def ay ang pangalawang parameter
na ibinigay sa function, at ito ay isang walang laman na string kung ito ay nawawala. Unlike
get_property(), ang pagtatalaga ng return value sa isang variable ay palaging magreresulta sa a
string.

mp.get_property_bool(pangalan [,def])
Kapareho ng mp.get_property, ngunit ibalik ang halaga ng ari-arian bilang Boolean.

Nagbabalik ng Boolean sa tagumpay, o def, mali sa pagkakamali.

mp.get_property_number(pangalan [,def])
Kapareho ng mp.get_property, ngunit ibalik ang halaga ng ari-arian bilang numero.

Tandaan na habang hindi nakikilala ni Lua ang pagitan ng mga integer at float, mga mpv internal
gawin. Ang function na ito ay humihiling lamang ng isang double float mula sa mpv, at ang mpv ay kadalasan
i-convert ang mga halaga ng integer property upang lumutang.

Nagbabalik ng numero sa tagumpay, o def, mali sa pagkakamali.

mp.get_property_native(pangalan [,def])
Kapareho ng mp.get_property, ngunit ibalik ang halaga ng ari-arian gamit ang pinakamahusay na uri ng Lua
para sa ari-arian. Kadalasan, magbabalik ito ng string, Boolean, o numero. Ang ilan
mga katangian (halimbawa listahan ng kabanata) ay ibinalik bilang mga talahanayan.

Nagbabalik ng halaga sa tagumpay, o def, mali sa pagkakamali. Tandaan na kawalan maaaring maging isang
posible, wastong halaga din sa ilang mga sulok na kaso.

mp.set_property(pangalan, halaga)
Itakda ang ibinigay na ari-arian sa ibinigay na halaga ng string. Tingnan mo mp.get_property at
Mga Katangian para sa karagdagang impormasyon tungkol sa mga ari-arian.

Nagbabalik ng totoo sa tagumpay, o nil mali sa pagkakamali.

mp.set_property_bool(pangalan, halaga)
Kapareho ng mp.set_property, ngunit itakda ang ibinigay na ari-arian sa ibinigay na halaga ng Boolean.

mp.set_property_number(pangalan, halaga)
Kapareho ng mp.set_property, ngunit itakda ang ibinigay na property sa ibinigay na numeric na halaga.

Tandaan na habang hindi nakikilala ni Lua ang pagitan ng mga integer at float, mga mpv internal
gawin. Ang function na ito ay susubok kung ang numero ay maaaring katawanin bilang integer, at
kung gayon, ipapasa nito ang isang integer na halaga sa mpv, kung hindi ay isang double float.

mp.set_property_native(pangalan, halaga)
Kapareho ng mp.set_property, ngunit itakda ang ibinigay na ari-arian gamit ang katutubong uri nito.

Dahil mayroong ilang mga uri ng data na hindi maaaring kumatawan sa katutubong sa Lua, ito
maaaring hindi palaging gumagana gaya ng inaasahan. Halimbawa, habang may magagawa ang Lua wrapper
hulaan upang magpasya kung ang isang Lua table ay isang array o isang mapa, ito ay mabibigo
mga bakanteng mesa. Gayundin, walang maraming pag-aari kung saan makatuwirang gamitin
ito, sa halip na set_property, set_property_bool, set_property_number. Para dito
Dahilan, malamang na iwasan ang function na ito sa ngayon, maliban sa mga katangian
na katutubong gumagamit ng mga talahanayan.

mp.get_time()
Ibalik ang kasalukuyang mpv internal time sa ilang segundo bilang numero. Ito ay karaniwang ang
oras ng system, na may arbitrary na offset.

mp.add_key_binding(key, pangalan|fn [,fn [, mga flag]])
Magrehistro ng callback upang patakbuhin sa isang key binding. Ang pagbubuklod ay imamapa sa
naibigay na susi, na isang string na naglalarawan sa pisikal na susi. Ginagamit nito ang parehong susi
mga pangalan tulad ng sa input.conf, at pinapayagan din ang mga kumbinasyon (hal. ctrl + a).

Pagkatapos tawagan ang function na ito, ang mga pagpindot sa key ay magiging sanhi ng function fn tatawagin
(maliban kung na-remapa ng user ang susi gamit ang isa pang binding).

Ang pangalan Ang argument ay dapat na isang maikling simbolikong string. Nagbibigay-daan ito sa user na mag-remap
ang key binding sa pamamagitan ng input.conf gamit ang script_message utos, at ang pangalan ng
ang key binding (tingnan sa ibaba para sa isang halimbawa). Ang pangalan ay dapat na natatangi sa iba
bindings sa parehong script - kung hindi, ang nakaraang binding na may parehong pangalan ay
ma-overwrite. Maaari mong alisin ang pangalan, kung saan ang isang random na pangalan ay nabuo
sa loob.

Ang huling argumento ay ginagamit para sa mga opsyonal na flag. Ito ay isang talahanayan, na maaaring magkaroon ng
sumusunod na mga entry:

mauulit
Kung itakda sa totoo, nagbibigay-daan sa pag-uulit ng key para sa partikular na pagbubuklod na ito.

mahirap unawain
Kung itakda sa totoo, Pagkatapos fn ay tinatawag sa parehong key up at down na mga kaganapan (pati na rin
bilang key repeat, kung pinagana), na ang unang argumento ay isang talahanayan. Ito
mesa ay may pangyayari entry, na nakatakda sa isa sa mga string pababa,
ulitin, up or pindutin (ang huli kung ang key pataas/pababa ay hindi masusubaybayan). Ito
karagdagang ay may isang is_mouse entry, na nagsasabi kung ang kaganapan ay sanhi
sa pamamagitan ng isang pindutan ng mouse.

Sa panloob, ang mga pangunahing binding ay ipinapadala sa pamamagitan ng script_message_to or script_binding
input command at mp.register_script_message.

Ang pagsisikap na mag-map ng maraming mga utos sa isang susi ay mahalagang mas gusto ang isang random na pagbubuklod,
habang ang iba pang mga binding ay hindi tinatawag. Ito ay ginagarantiyahan na tinukoy ng gumagamit
Ang mga binding sa gitnang input.conf ay mas gusto kaysa sa mga binding na idinagdag dito
function (ngunit tingnan mp.add_forced_key_binding).

Halimbawa:

function something_handler()
print("pinindot ang susi")
dulo
mp.add_key_binding("x", "something", something_handler)

Ipi-print nito ang mensahe ang susi ay pipi kailan x ay pinindot.

Maaaring i-remap ng user ang mga key binding na ito. Pagkatapos ay kailangang ilagay ng user ang sumusunod
kanyang input.conf upang i-remap ang utos sa y susi:

y script_binding ng isang bagay

Ipi-print nito ang mensahe kapag ang susi y ay pinindot. (x gagana pa rin, maliban kung
i-remap ito ng gumagamit.)

Maaari ka ring tahasang magpadala ng mensahe sa isang pinangalanang script lamang. Ipagpalagay ang nasa itaas
ginamit ng script ang filename fooscript.lua:

y script_binding fooscript.something

mp.add_forced_key_binding(...)
Ito ay gumagana halos kapareho ng mp.add_key_binding, ngunit nirerehistro ang susi na nagbubuklod
isang paraan na i-overwrite ang mga custom na binding ng user sa kanyang input.conf.
(mp.add_key_binding ino-overwrite lamang ang mga default na key binding, ngunit hindi ang mga iyon ng
input.conf. ng user)

mp.remove_key_binding(pangalan)
Alisin ang isang key binding na idinagdag sa mp.add_key_binding or mp.add_forced_key_binding.
Gamitin ang parehong pangalan tulad ng ginamit mo kapag nagdaragdag ng mga binding. Hindi pwedeng tanggalin
mga binding kung saan inalis mo ang pangalan.

mp.register_event(pangalan, fn)
Tumawag ng isang partikular na function kapag nangyari ang isang kaganapan. Ang pangalan ng kaganapan ay isang string, at ang
Ang function na fn ay isang halaga ng function na Lua.

Ang ilang mga kaganapan ay may nauugnay na data. Ito ay inilagay sa isang Lua table at ipinasa bilang
argumento sa fn. Ang talahanayan ng Lua bilang default ay naglalaman ng a pangalan field, na isang string
naglalaman ng pangalan ng kaganapan. Kung ang kaganapan ay may nauugnay na error, ang mali ang patlang ay
nakatakda sa isang string na naglalarawan sa error, sa tagumpay ay hindi ito nakatakda.

Kung maraming function ang nakarehistro para sa parehong kaganapan, pinapatakbo ang mga ito
registration order, na ang unang rehistradong function na tumatakbo bago ang lahat ng
iba pa.

Nagbabalik ng true kung may ganoong kaganapan, kung hindi man mali.

Tingnan Mga Kaganapan at listahan of mga kaganapan para sa mga detalye.

mp.unregister_event(fn)
Magpawalang-saysay mp.register_event(..., fn). Inaalis nito ang lahat ng mga tagapangasiwa ng kaganapan na katumbas ng
ang fn parameter. Gumagamit ito ng normal na Lua == paghahambing, kaya maging maingat sa pakikitungo
may mga pagsasara.

mp.observe_property(pangalan, uri, fn)
Manood ng isang property para sa mga pagbabago. Kung ang ari-arian pangalan ay binago, pagkatapos ay ang function
fn(pangalan) tatawagin. uri ay maaaring maging kawalan, o itakda sa isa sa wala, katutubo, bool,
pisi, O numero. wala ay pareho kawalan. Para sa lahat ng iba pang halaga, ang bagong halaga ng
ang ari-arian ay ipapasa bilang pangalawang argumento sa fn, Gamit mp.get_property_
para mabawi ito. Ibig sabihin kung uri ay halimbawa pisi, fn ay halos tinatawag na
in fn(pangalan, mp.get_property_string(pangalan)).

Kung maaari, ang mga kaganapan sa pagbabago ay pinagsama-sama. Kung ang isang ari-arian ay binago ng ilang beses
sa isang hilera, tanging ang huling pagbabago lamang ang nagti-trigger sa pagpapaandar ng pagbabago. (Ang eksaktong pag-uugali
depende sa timing at iba pang bagay.)

Sa ilang mga kaso ang function ay hindi tinatawag kahit na ang ari-arian ay nagbago. kung
ito ay maaaring mangyari depende sa ari-arian.

Kung ang uri is wala or kawalan, ang mga kaganapan sa pagbabago ng ari-arian ay posible. Ito
nangangahulugang ang pagpapaandar ng pagbabago fn matatawagan kahit hindi naman talaga
baguhin.

mp.unobserve_property(fn)
Magpawalang-saysay mp.observe_property(..., fn). Inaalis nito ang lahat ng mga humahawak ng ari-arian
pantay sa fn parameter. Gumagamit ito ng normal na Lua == paghahambing, kaya mag-ingat kapag
pagharap sa mga pagsasara.

mp.add_timeout(segundo, fn)
Tawagan ang ibinigay na function fn kapag ang ibinigay na bilang ng mga segundo ay lumipas na. Tandaan na
ang bilang ng mga segundo ay maaaring fractional. Sa ngayon, ang resolution ng timer ay maaaring bilang
mababa sa 50 ms, bagama't mapapabuti ito sa hinaharap.

Isa itong one-shot timer: aalisin ito kapag na-fire.

Nagbabalik ng timer object. Tingnan mo mp.add_periodic_timer para sa mga detalye.

mp.add_periodic_timer(segundo, fn)
Pana-panahong tawagan ang ibinigay na function. Ito ay tulad ng mp.add_timeout, ngunit ang timer ay
muling idinagdag pagkatapos tumakbo ang function na fn.

Kita a hronometrahisto bagay. Ang hronometrahisto bagay nagbibigay ng ang sumusunod paraan:

huminto () Huwag paganahin ang timer. Walang gagawin kung naka-disable na ang timer.
Tatandaan nito ang kasalukuyang lumipas na oras kapag huminto, upang
ipagpatuloy() mahalagang i-unpause ang timer.

pumatay() Huwag paganahin ang timer. Nire-reset ang lumipas na oras. ipagpatuloy() ay muling simulan ang
timer

ipagpatuloy()
I-restart ang timer. Kung ang timer ay hindi pinagana sa huminto (), ito ay
ipagpatuloy sa oras na ito ay itinigil. Kung ang timer ay hindi pinagana sa
pumatay(), o kung ito ay isang dating pinaandar na one-shot timer (idinagdag ng
add_timeout()), sinisimulan nito ang timer mula sa simula, gamit ang
naunang na-configure ang timeout.

oras (RW)
Ang field na ito ay naglalaman ng kasalukuyang panahon ng timeout. Ang halagang ito ay hindi
na-update habang tumatagal. Ito ay ginagamit lamang upang kalkulahin kapag ang
Ang timer ay dapat na susunod na gagana kapag ang timer ay nag-expire.

Kung isusulat mo ito, maaari kang tumawag t:kill() ; t:resume() upang i-reset ang
kasalukuyang timeout sa bago. (t:stop() hindi gagamitin ang bagong timeout.)

isang shot (RW)
Kung ang timer ay pana-panahon (hindi totoo) o nagpaputok ng isang beses lamang (totoo). Ito
Ang value ay ginagamit kapag nag-expire ang timer (ngunit bago ang timer callback
pinapatakbo ang function na fn).

Tandaan na ang mga ito ay paraan, at kailangan mong tawagan sila gamit : sa halip ng . (Sumangguni
sa http://www.lua.org/manual/5.2/manual.html#3.4.9 .)

Halimbawa:

segundo = 0
timer = mp.add_periodic_timer(1, function()
print("tinatawag bawat segundo")
# itigil ito pagkatapos ng 10 segundo
segundo = segundo + 1
kung segundo >= 10 pagkatapos
timer:kill()
dulo
wakas)

mp.get_opt(key)
Magbalik ng setting mula sa --script-opts opsyon. Bahala na ang user at ang script
kung paano ginagamit ang mekanismong ito. Sa kasalukuyan, lahat ng mga script ay maaaring ma-access ito nang pantay-pantay, kaya ikaw
dapat mag-ingat sa mga banggaan.

mp.get_script_name()
Ibalik ang pangalan ng kasalukuyang script. Ang pangalan ay karaniwang gawa sa filename ng
ang script, na inalis ang direktoryo at extension ng file. Kung maraming script
na magkakaroon ng parehong pangalan, ginagawa itong natatangi sa pamamagitan ng pagdaragdag ng isang numero.

halimbawa

Ang iskrip /path/to/fooscript.lua nagiging kalokohan.

mp.osd_message(text [,tagal])
Magpakita ng mensahe ng OSD sa screen. tagal ay nasa ilang segundo, at opsyonal (mga gamit
--osd-tagal bilang default).

Advanced mp function
Ang mga ito ay nakatira din sa mp module, ngunit nakadokumento nang hiwalay dahil ang mga ito ay kapaki-pakinabang lamang sa
mga espesyal na sitwasyon.

mp.suspend()
Suspindihin ang mpv main loop. Mayroong mahabang paliwanag tungkol dito sa C API
tungkulin mpv_suspend(). Sa madaling salita, pinipigilan nito ang manlalaro na ipakita ang susunod
video frame, para hindi ka ma-block kapag sinusubukang i-access ang player.

Awtomatiko itong tinatawag ng event handler.

mp.resume()
I-undo ang isa mp.suspend() tawagan mp.suspend() pagdaragdag ng panloob na counter, at
mp.resume() binabawasan ito. Kapag ang 0 ay naabot, ang manlalaro ay talagang ipinagpatuloy.

mp.resume_all()
Ire-reset nito ang internal suspend counter at ipagpatuloy ang player. (Parang tumatawag
mp.resume() hanggang sa aktwal na maipagpatuloy ang manlalaro.)

Baka gusto mong tawagan ito kung gagawa ka ng isang bagay na magtatagal,
ngunit hindi talaga kailangan ng access sa player (tulad ng isang network operation). Tandaan na
maa-access mo pa rin ang player anumang oras.

mp.get_wakeup_pipe()
Tawag mpv_get_wakeup_pipe() at ibinabalik ang read end ng wakeup pipe. (Tingnan
kliyente.h para sa mga detalye.)

mp.get_next_timeout()
Ibalik ang kaugnay na oras sa mga segundo kapag ang susunod na timer (mp.add_timeout at
katulad) mag-e-expire. Kung walang timer, bumalik kawalan.

mp.dispatch_events([allow_wait])
Magagamit ito upang magpatakbo ng mga custom na loop ng kaganapan. Kung gusto mong magkaroon ng direktang kontrol ano
ginagawa ng Lua script (sa halip na tawagin ng default na loop ng kaganapan), magagawa mo
itakda ang global variable mp_event_loop sa sarili mong function na nagpapatakbo ng event loop.
Mula sa iyong loop ng kaganapan, dapat kang tumawag mp.dispatch_events() sa dequeue at dispatch
mga kaganapan sa mpv.

Kung ang allow_wait ang parameter ay nakatakda sa totoo, ang function ay haharang hanggang sa susunod
natanggap ang kaganapan o mag-e-expire ang susunod na timer. Kung hindi man (at ito ang default
pag-uugali), babalik ito sa sandaling ma-empty ang event loop. Ito ay malakas
inirerekomendang gamitin mp.get_next_timeout() at mp.get_wakeup_pipe() kung ikaw ay
interesado sa maayos na gumaganang abiso ng mga bagong kaganapan at gumaganang timer.

Ang function na ito ay tumatawag mp.suspend() at mp.resume_all() sa sarili nitong.

mp.enable_messages(level)
Itakda ang minimum na antas ng log kung saan matatanggap ang output ng mensahe ng mpv. Ang mga mensaheng ito
ay karaniwang naka-print sa terminal. Sa pamamagitan ng pagtawag sa function na ito, maaari mong itakda ang
pinakamababang antas ng log ng mga mensahe na dapat matanggap kasama ang log-mensahe kaganapan.
Tingnan ang paglalarawan ng kaganapang ito para sa mga detalye. Ang antas ay isang string, kita n'yo msg.log
para sa mga pinapayagang antas ng log.

mp.register_script_message(pangalan, fn)
Ito ay isang katulong upang ipadala script_message or script_message_to mga panawagan kay Lua
function. fn ay tinatawag na kung script_message or script_message_to (kasama ang script na ito bilang
patutunguhan) ay tumatakbo sa pangalan bilang unang parameter. Ang iba pang mga parameter ay naipasa
sa fn. Kung ang isang mensahe na may ibinigay na pangalan ay nakarehistro na, ito ay mapapatungan.

Ginamit ni mp.add_key_binding, kaya mag-ingat sa mga banggaan ng pangalan.

mp.unregister_script_message(pangalan)
I-undo ang nakaraang pagpaparehistro sa mp.register_script_message. Walang ginagawa kung ang
pangalan ay hindi nakarehistro.

mp.msg function
Ang module na ito ay nagbibigay-daan sa pag-output ng mga mensahe sa terminal, at maaaring i-load mangailangan
'mp.msg'.

msg.log(level, ...)
Ang parameter ng antas ay ang priyoridad ng mensahe. Ito ay isang string at isa sa nakamamatay, mali,
balaan, info, v, mag-alis ng mga insekto. Tutukuyin ng mga setting ng user kung alin sa mga mensaheng ito
ay makikita. Karaniwan, ang lahat ng mga mensahe ay nakikita, maliban v at mag-alis ng mga insekto.

Ang mga parameter pagkatapos nito ay lahat ay na-convert sa mga string. Ang mga puwang ay ipinasok sa
hiwalay na maramihang mga parameter.

Hindi mo kailangang magdagdag ng mga bagong linya.

msg.fatal(...), msg.error(...), msg.warn(...), msg.info(...), msg.verbose(...),
msg.debug(...)
Ang lahat ng ito ay mga shortcut at katumbas ng katumbas msg.log(level, ...)
tawagan

mp.options function
Ang mpv ay may kasamang built-in na module upang pamahalaan ang mga opsyon mula sa mga config-file at sa command-line.
Ang kailangan mo lang gawin ay magbigay ng isang talahanayan na may mga default na opsyon sa read_options function.
I-overwrite ng function ang mga default na value na may mga value na makikita sa config-file at
ang command-line (sa ayos na iyon).

options.read_options(table [, identifier])
A mesa na may mga pares ng key-value. Ang uri ng mga default na halaga ay mahalaga para sa
pag-convert ng mga value na nabasa mula sa config file o command-line pabalik. Huwag gamitin
kawalan bilang default na halaga!

Ang pantukoy ay ginagamit upang tukuyin ang config-file at ang mga opsyon sa command-line.
Ang mga ito ay kailangang natatangi upang maiwasan ang mga banggaan sa iba pang mga script. Default sa
mp.get_script_name().

Halimbawang pagpapatupad:

nangangailangan ng 'mp.options'
lokal na opsyon = {
optionA = "defaultvalueA",
opsyonB = -0.5,
opsyonC = totoo,
}
read_options(options, "myscript")
print(options.optionA)

Ang config file ay maiimbak sa lua-settings/identifier.conf sa folder ng user ng mpv.
Maaaring magsimula sa # ang mga linya ng komento at hindi inaalis ang mga stray space. Ang mga halaga ng Boolean ay
kinakatawan ng oo/hindi.

Halimbawang config:

# komento
optionA=Hello World
opsyonB=9999
opsyonC=hindi

Ang mga opsyon sa command-line ay binabasa mula sa --script-opts parameter. Para maiwasan ang banggaan, lahat
ang mga susi ay kailangang may prefix identifier-.

Halimbawa ng command-line:

--script-opts=myscript-optionA=TEST,myscript-optionB=0,myscript-optionC=oo

mp.utils pagpipilian
Ang built-in na module na ito ay nagbibigay ng mga generic na function ng helper para kay Lua, at may mahigpit na pagsasalita
walang kinalaman sa mpv o video/audio playback. Ang mga ito ay ibinigay para sa kaginhawahan. Karamihan
bumawi sa kakaunting karaniwang aklatan ni Lua.

Maging babala na ang alinman sa mga function na ito ay maaaring mawala anumang oras. Hindi sila mahigpit na bahagi
ng garantisadong API.

utils.getcwd()
Ibinabalik ang direktoryo kung saan inilunsad ang mpv. Sa pagkakamali, nil mali ay ibinalik.

utils.readdir(path [, filter])
Isaalang-alang ang lahat ng mga entry sa ibinigay na landas sa filesystem, at ibalik ang mga ito bilang
array. Ang bawat entry ay isang entry sa direktoryo (nang walang landas). Ang listahan ay hindi naayos
(sa anumang pagkakasunud-sunod ibinalik ito ng operating system).

Kung ang filter ibinigay ang argumento, dapat itong isa sa mga sumusunod na string:

file Maglista ng mga regular na file lamang. Hindi kasama dito ang mga direktoryo, mga espesyal na file (tulad ng
UNIX device files o FIFOs), at mga patay na symlink. Kasama dito ang mga UNIX symlink
sa mga regular na file.

dirs Listahan ng mga direktoryo lamang, o mga symlink sa mga direktoryo. . at .. ay hindi
kasama.

normal Isama ang mga resulta ng pareho file at dirs. (Ito ang default.)

lahat Ilista ang lahat ng mga entry, maging ang mga file ng device, mga patay na symlink, FIFO, at ang . at
.. mga entry.

Sa pagkakamali, nil mali ay ibinalik.

utils.split_path(path)
Hatiin ang isang landas sa bahagi ng direktoryo at bahagi ng filename, at ibalik ang mga ito. Ang
ang unang pagbabalik na halaga ay palaging ang direktoryo. Ang ikalawang return value ay ang trailing
bahagi ng landas, ang entry sa direktoryo.

utils.join_path(p1, p2)
Ibalik ang pagsasama-sama ng 2 landas. Sinusubukang maging matalino. Halimbawa, kung `p2 is
isang ganap na landas, ang p2 ay ibinalik nang walang pagbabago.

utils.subprocess(t)
Nagpapatakbo ng panlabas na proseso at naghihintay hanggang sa lumabas ito. Ibinabalik ang katayuan ng proseso at ang
nakuhang output.

Ang parameter t ay isang mesa. Binabasa ng function ang mga sumusunod na entry:

mga pagtatalo Array ng mga string. Ang unang array entry ay ang executable. Ito ay maaaring
alinman sa isang ganap na landas, o isang filename na walang mga bahagi ng path, kung saan
kaso ang PATH environment variable ay ginagamit upang malutas ang executable. Ang
ang iba pang mga elemento ng array ay ipinapasa bilang mga argumento ng command line.

pwedable
Opsyonal. Kung nakatakda sa totoo (default), kung ihihinto ng user ang pag-playback o
papunta sa susunod na file habang tumatakbo ang proseso, ang magiging proseso
pinatay.

max_size
Opsyonal. Ang maximum na laki sa bytes ng data na maaaring makuha mula sa
stdout. (Default: 16 MB.)

Ang function ay nagbabalik ng isang talahanayan bilang resulta ng mga sumusunod na entry:

katayuan Ang hilaw na katayuan ng paglabas ng proseso. Ito ay magiging negatibo sa pagkakamali.

stdout Nakuha ang output stream bilang string, limitado sa max_size.

mali kawalan sa tagumpay. Ang tali ligpit kung ang proseso ay tinapos sa isang
hindi pangkaraniwang paraan. Ang tali sa loob kung hindi masimulan ang proseso.

Sa Windows, ligpit ay ibinabalik lamang kapag ang proseso ay pinatay ng
mpv bilang resulta ng pwedable na nakatakda sa totoo.

pinatay_ng_amin
Itakda sa totoo kung ang proseso ay pinatay ng mpv bilang resulta ng
pwedable na nakatakda sa totoo.

Sa lahat ng mga kaso, mp.resume_all() ay tahasang tinatawag.

utils.parse_json(str [, landas])
Pino-parse ang ibinigay na string argument bilang JSON, at ibinabalik ito bilang Lua table. Sa pagkakamali,
Babalik nil mali. (Kasalukuyan, mali ay isang string reading lamang mali, dahil doon
ay walang pinong pag-uulat ng error sa anumang uri.)

Ang ibinalik na halaga ay gumagamit ng mga katulad na kumbensyon bilang mp.get_property_native() sa
makilala ang mga walang laman na bagay at array.

Kung ang tugaygayan ang parameter ay totoo (o anumang halaga na katumbas ng totoo), pagkatapos ay sumusunod
Ang non-whitespace na text ay pinahihintulutan ng function, at ang trailing text ay ibinalik
bilang 3rd return value. (Ang pangatlong halaga ng pagbabalik ay palaging nandiyan, ngunit may tugaygayan set, hindi
nakataas ang error.)

utils.format_json(v)
I-format ang ibinigay na talahanayan ng Lua (o halaga) bilang isang string ng JSON at ibalik ito. Sa pagkakamali,
Babalik nil mali. (Ang mga error ay kadalasang nangyayari lamang sa mga uri ng halaga na hindi tugma sa
JSON.)

Ang halaga ng argumento ay gumagamit ng mga katulad na kumbensyon bilang mp.set_property_native() sa
makilala ang mga walang laman na bagay at array.

utils.to_string(v)
Gawing string ang ibinigay na halaga. I-format ang mga talahanayan at ang mga nilalaman nito. Ito ay hindi
gumawa ng anumang espesyal; kailangan lang kasi grabe si Lua.

Mga Kaganapan
Ang mga kaganapan ay mga notification mula sa player core hanggang sa mga script. Maaari kang magparehistro ng isang tagapangasiwa ng kaganapan
sa mp.register_event.

Tandaan na ang lahat ng mga script (at iba pang bahagi ng player) ay tumatanggap ng mga kaganapan nang pantay-pantay, at mayroon
walang bagay na pagharang sa iba pang mga script mula sa pagtanggap ng mga kaganapan.

Halimbawa:

function my_fn(kaganapan)
print("pagsisimula ng playback!")
dulo

mp.register_event("file-loaded", my_fn)

listahan of mga kaganapan
panimulang file
Nangyayari bago mag-load ng bagong file. Kapag natanggap mo ito, ang manlalaro ay
nilo-load ang file (o posibleng tapos na dito).

end-file
Nangyayari pagkatapos ma-unload ang isang file. Karaniwan, ilo-load ng player ang susunod na file
kaagad, o huminto kung ito ang huling file.

Ang kaganapan ay may dahilan field, na kumukuha ng isa sa mga value na ito:

eof Natapos na ang file. Maaari itong (ngunit hindi kailangang) magsama ng mga hindi kumpletong file
o sirang mga koneksyon sa network sa ilalim ng mga pangyayari.

itigil Ang pag-playback ay tinapos sa pamamagitan ng isang utos.

umalis Ang pag-playback ay natapos sa pamamagitan ng pagpapadala ng quit command.

mali Isang error ang nangyari. Sa kasong ito, isang mali naroroon ang field na may error
string.

redirect
Nangyayari sa mga playlist at katulad nito. Tingnan ang mga detalye MPV_END_FILE_REASON_REDIRECT
sa C API.

hindi kilala
Hindi alam. Karaniwang hindi nangyayari, maliban kung ang Lua API ay hindi naka-sync sa
C API. (Gayundin, maaaring mangyari na ang iyong script ay nakakakuha ng mga string ng dahilan na iyon
ay wala pa sa oras na isinulat ang iyong script.)

puno ng file
Mangyayari pagkatapos ma-load ang isang file at magsimulang mag-playback.

maghanap Nangyayari sa paghahanap. (Maaaring kabilang dito ang mga kaso kapag ang manlalaro ay naghahanap sa loob,
kahit na walang pakikipag-ugnayan ng gumagamit. Kasama dito hal. pagbabago ng segment kapag nagpe-play
nag-order ng mga kabanata na Matroska file.)

playback-restart
Simula ng pag-playback pagkatapos ng paghahanap o pagkatapos ma-load ang file.

idle Ang idle mode ay ipinasok. Nangyayari ito kapag natapos ang pag-playback, at sinimulan ang player
sa --walang ginagawa or --force-window. Ang mode na ito ay tahasang natapos kapag ang panimulang file or
pagpipinid nangyayari ang mga pangyayari.

magkudlit Tumawag pagkatapos ipakita ang isang video frame. Ito ay isang hack, at dapat mong iwasan
gamit ito. Gumamit na lang ng mga timer at maaaring manood ng mga kaganapan sa pag-pause/pag-unpause para maiwasan
pag-aaksaya ng CPU kapag naka-pause ang player.

pagpipinid
Ipinadala kapag huminto ang manlalaro, at dapat na wakasan ang script. Karaniwang hinahawakan
awtomatiko. Tingnan mo Detalye on ang script Pinasimulan at lifecycle.

log-mensahe
Tumatanggap ng mga mensaheng pinagana gamit ang mp.enable_messages. Ang data ng mensahe ay nakapaloob sa
ipinasa ang talahanayan bilang unang parameter sa tagapangasiwa ng kaganapan. Ang talahanayan ay naglalaman ng, sa
karagdagan sa mga default na field ng kaganapan, ang mga sumusunod na field:

unlapi Ang module prefix, ay kinikilala ang nagpadala ng mensahe. Ito ay kung ano ang
terminal player na inilalagay sa harap ng text ng mensahe kapag ginagamit ang --v pagpipilian,
at ito rin ang ginagamit --msg-level.

antas Ang antas ng log bilang string. Tingnan mo msg.log para sa posibleng mga pangalan ng antas ng log. Tandaan
na ang mga susunod na bersyon ng mpv ay maaaring magdagdag ng mga bagong antas o alisin (hindi dokumentado)
mga umiiral na.

teksto Ang log message. Ang teksto ay magtatapos sa isang bagong linya na character. Minsan ito
maaaring maglaman ng maraming linya.

Tandaan na ang mga mensaheng ito ay nilalayong maging mga pahiwatig para sa mga tao. Hindi mo dapat
i-parse ang mga ito, at maaaring magbago ang prefix/level/text ng mga mensahe anumang oras.

makakuha ng-property-reply
Hindi dokumentado (hindi kapaki-pakinabang para sa mga script ng Lua).

set-property-reply
Hindi dokumentado (hindi kapaki-pakinabang para sa mga script ng Lua).

command-reply
Hindi dokumentado (hindi kapaki-pakinabang para sa mga script ng Lua).

mensahe ng kliyente
Hindi dokumentado (ginamit sa loob).

video-reconfig
Nangyayari sa output ng video o reconfig ng filter.

audio-reconfig
Nangyayari sa output ng audio o reconfig ng filter.

Nangyayari rin ang mga sumusunod na kaganapan, ngunit hindi na ginagamit: binago ang mga track, inilipat ang track,
i-pause, huminto, metadata-update, pagbabago ng kabanata. Gamitin mp.observe_property() sa halip.

Kasama sa mga extra
Ito ay nagdodokumento ng mga pang-eksperimentong tampok, o mga tampok na "masyadong espesyal" upang magarantiya a
matatag na interface.

mp.add_hook(type, priority, fn)
Magdagdag ng hook callback para sa uri (isang string na nagpapakilala sa isang tiyak na uri ng kawit). Ang mga ito
pinahihintulutan ng mga hook ang player na tumawag sa mga function ng script at maghintay para sa kanilang resulta
(karaniwan, ang interface ng script ng Lua ay asynchronous mula sa punto ng view ng
ang pangunahing manlalaro). karapatang mauna ay isang arbitrary na integer na nagbibigay-daan sa pag-order sa mga hook
ng parehong uri. Ang paggamit ng value na 50 ay inirerekomenda bilang neutral na default na value. fn is
ang function na tatawagin sa panahon ng pagpapatupad ng hook.

Tingnan Hooks para sa kasalukuyang umiiral na mga kawit at kung ano ang kanilang ginagawa - tanging ang listahan ng mga kawit ay
kawili-wili; ang paghawak ng hook execution ay ginagawa ng Lua script function
awtomatiko.

JSON IPC

Ang mpv ay maaaring kontrolin ng mga panlabas na programa gamit ang JSON-based na IPC protocol. Maaari itong maging
pinagana sa pamamagitan ng pagtukoy ng landas sa isang unix socket gamit ang opsyon --input-unix-socket.
Ang mga kliyente ay maaaring kumonekta sa socket na ito at magpadala ng mga utos sa player o tumanggap ng mga kaganapan mula sa
ito.

BABALA:
Hindi ito nilayon na maging isang secure na network protocol. Ito ay tahasang hindi secure: doon
ay walang pagpapatunay, walang pag-encrypt, at ang mga utos mismo ay hindi rin secure. Para sa
halimbawa, ang tumakbo nakalantad ang command, na maaaring magpatakbo ng mga arbitrary na command ng system. Ang
Ang use-case ay lokal na kinokontrol ang player. Hindi ito naiiba sa MPlayer
protocol ng alipin.

Socat halimbawa
Maaari mong gamitin ang socat tool upang magpadala ng mga command (at makatanggap ng tugon) mula sa shell. Ipagpalagay
mpv ay nagsimula sa:

mpv file.mkv --input-unix-socket=/tmp/mpvsocket

Pagkatapos ay makokontrol mo ito gamit ang socat:

> echo '{ "command": ["get_property", "playback-time"] }' | socat - /tmp/mpvsocket
{"data":190.482000,"error":"success"}

Sa kasong ito, kinokopya ng socat ang data sa pagitan ng stdin/stdout at ng mpv socket na koneksyon.

Tingnan ang --walang ginagawa opsyon kung paano simulan ang mpv nang hindi agad lumalabas o naglalaro ng file.

Posible ring magpadala ng input.conf style text-only na mga command:

> echo 'show_text ${playback-time}' | socat - /tmp/mpvsocket

Ngunit hindi ka makakakuha ng tugon sa socket. (Ang partikular na utos na ito ay nagpapakita ng pag-playback
oras sa OSD ng player.)

Protokol
Ang mga kliyente ay maaaring magsagawa ng mga utos sa player sa pamamagitan ng pagpapadala ng mga mensahe sa JSON ng sumusunod na form:

{ "command": ["command_name", "param1", "param2", ...] }

saan command_name ay ang pangalan ng utos na isasagawa, na sinusundan ng isang listahan ng
mga parameter. Dapat na naka-format ang mga parameter bilang mga native na halaga ng JSON (mga integer, string,
mga boolean, ...). Bawat mensahe dapat wakasan sa \n. Bilang karagdagan, \n hindi dapat lumitaw
kahit saan sa loob ng mensahe. Sa pagsasagawa, nangangahulugan ito na ang mga mensahe ay dapat maliitin
bago ipadala sa mpv.

Ang mpv ay magpapadala ng tugon na nagsasaad kung tama ang pagpapatakbo ng command, at isang
karagdagang field na may hawak ng data ng pagbabalik na partikular sa command (maaari din itong null).

{ "error": "tagumpay", "data": null }

Magpapadala rin ang mpv ng mga kaganapan sa mga kliyente na may mga mensahe ng JSON na may sumusunod na form:

{ "kaganapan": "pangalan_kaganapan" }

saan pangalan ng pangyayari ay ang pangalan ng kaganapan. Ang mga karagdagang field na partikular sa kaganapan ay maaari ding
kasalukuyan. Tingnan mo listahan of mga kaganapan para sa isang listahan ng lahat ng sinusuportahang kaganapan.

Dahil maaaring mangyari ang mga kaganapan anumang oras, maaaring mahirap minsan na matukoy kung alin
tugon ay sumasama sa aling utos. Maaaring opsyonal na kasama ng mga utos ang a request_id na, kung
na ibinigay sa kahilingan ng utos, ay makokopya sa verbatim sa tugon. hindi ang mpv
ipaliwanag ang request_id sa anumang paraan; ito ay para lamang sa paggamit ng humihiling.

Halimbawa, ang kahilingang ito:

{ "command": ["get_property", "time-pos"], "request_id": 100 }

Bubuo ng ganitong tugon:

{ "error": "success", "data": 1.468135, "request_id": 100 }

Ang lahat ng utos, tugon, at kaganapan ay pinaghihiwalay sa isa't isa na may isang line break
karakter (\n).

Kung ang unang character (pagkatapos laktawan ang whitespace) ay hindi {, ang magiging utos ay
binibigyang-kahulugan bilang non-JSON text command, dahil ginagamit ang mga ito sa input.conf (o
mpv_command_string() sa client API). Bilang karagdagan, ang linya na nagsisimula sa # at walang laman
hindi pinapansin ang mga linya.

Sa kasalukuyan, ang naka-embed na 0 byte ay nagwawakas sa kasalukuyang linya, ngunit hindi ka dapat umasa dito.

Command
Bilang karagdagan sa mga utos na inilarawan sa listahan of input Command, ilang dagdag na utos
maaari ding gamitin bilang bahagi ng protocol:

Pangalan ng kliyente
Ibalik ang pangalan ng kliyente bilang string. Ito ang string ipc-N na ang N ay isang
integer na numero.

get_time_us
Ibalik ang kasalukuyang mpv internal time sa microseconds bilang numero. Ito ay karaniwang
ang oras ng system, na may arbitrary na offset.

get_property
Ibalik ang halaga ng ibinigay na ari-arian. Ang halaga ay ipapadala sa field ng data ng
ang replay na mensahe.

Halimbawa:

{ "command": ["get_property", "volume"] }
{ "data": 50.0, "error": "tagumpay" }

get_property_string
katulad get_property, ngunit ang magreresultang data ay palaging magiging isang string.

Halimbawa:

{ "command": ["get_property_string", "volume"] }
{ "data": "50.000000", "error": "tagumpay" }

set_property
Itakda ang ibinigay na ari-arian sa ibinigay na halaga. Tingnan mo Mga Katangian para sa karagdagang impormasyon
tungkol sa mga ari-arian.

Halimbawa:

{ "command": ["set_property", "pause", true] }
{ "error": "tagumpay" }

set_property_string
katulad set_property, ngunit ang halaga ng argument ay dapat ipasa bilang string.

Halimbawa:

{ "command": ["set_property_string", "pause", "yes"] }
{ "error": "tagumpay" }

observe_property
Manood ng isang property para sa mga pagbabago. Kung ang ibinigay na ari-arian ay binago, pagkatapos ay isang kaganapan ng
uri pagbabago ng ari-arian ay mabubuo

Halimbawa:

{ "command": ["observe_property", 1, "volume"] }
{ "error": "tagumpay" }
{ "event": "property-change", "id": 1, "data": 52.0, "name": "volume" }

observe_property_string
katulad observe_property, ngunit ang magreresultang data ay palaging magiging isang string.

Halimbawa:

{ "command": ["observe_property_string", 1, "volume"] }
{ "error": "tagumpay" }
{ "event": "property-change", "id": 1, "data": "52.000000", "name": "volume" }

unobserve_property
Magpawalang-saysay observe_property or observe_property_string. Nangangailangan ito ng numeric id
ipinasa sa utos na obserbahan bilang argumento.

Halimbawa:

{ "command": ["unobserve_property", 1] }
{ "error": "tagumpay" }

request_log_messages
Paganahin ang output ng mga mensahe ng log ng mpv. Matatanggap sila bilang mga kaganapan. Ang parameter
sa utos na ito ay ang antas ng log (tingnan mpv_request_log_messages C API function).

Ang output ng mensahe ng log ay para sa mga tao lamang (karamihan ay para sa pag-debug). Sinusubukang
ang pagkuha ng impormasyon sa pamamagitan ng pag-parse ng mga mensaheng ito ay hahantong lamang sa mga pagkasira
hinaharap na mga paglabas ng mpv. Sa halip, gumawa ng isang kahilingan sa tampok, at humingi ng tamang kaganapan
na nagbabalik ng impormasyong kailangan mo.

enable_event, disable_event
Pinapagana o hindi pinapagana ang pinangalanang kaganapan. Sinasalamin ang mpv_request_event C API function.
Kung ang string lahat ay ginagamit sa halip na isang pangalan ng kaganapan, lahat ng mga kaganapan ay pinagana o
may kapansanan

Bilang default, karamihan sa mga kaganapan ay pinagana, at walang gaanong gamit para sa utos na ito.

suspindihin
Suspindihin ang mpv main loop. Mayroong mahabang paliwanag tungkol dito sa C API
tungkulin mpv_suspend(). Sa madaling salita, pinipigilan nito ang manlalaro na ipakita ang susunod
video frame, para hindi ka ma-block kapag sinusubukang i-access ang player.

ipagpatuloy I-undo ang isa suspindihin tawagan suspindihin pagdaragdag ng panloob na counter, at ipagpatuloy
binabawasan ito. Kapag ang 0 ay naabot, ang manlalaro ay talagang ipinagpatuloy.

get_version
Ibinabalik ang bersyon ng client API na ibinibigay ng C API ng remote na mpv instance. (Gayundin
makita DOCS/client-api-changes.rst.)

UTF-8
Karaniwan, ang lahat ng mga string ay nasa UTF-8. Minsan maaaring mangyari na ang mga string ay nasa ilan
sirang encoding (madalas na nangyayari sa mga file tag at tulad nito, at ang mga filename sa maraming Unix ay
hindi rin kinakailangang nasa UTF-8). Nangangahulugan ito na minsan ay nagpapadala ang mpv ng di-wastong JSON. Kung
iyon ay isang problema para sa parser ng application ng kliyente, dapat nitong i-filter ang raw data para sa
di-wastong mga pagkakasunud-sunod ng UTF-8 at gawin ang nais na kapalit, bago i-feed ang data sa
ang JSON parser nito.

Hindi susubukan ng mpv na bumuo ng di-wastong UTF-8 na may mga sirang escape sequence.

CHANGELOG

Walang tunay na changelog, ngunit maaari mong tingnan ang mga sumusunod na bagay:

· Ang release changelog, na dapat maglaman ng karamihan sa mga pagbabagong nakikita ng user, kabilang ang bago
mga tampok at pag-aayos ng bug:

https://github.com/mpv-player/mpv/releases

· Ang git log, na siyang "tunay" na changelog

· Ang file mplayer-changes.rst nasa DOCS sub directory sa git repository, na ginamit
upang maging kapalit ng seksyong ito. Ito ay nagdodokumento ng ilang pagbabago na nangyari mula noong mplayer2
natanggal ang MPlayer.

EMBEDDING SA OTHER MGA PROGRAMA (LIBMPV)

Ang mpv ay maaaring i-embed sa iba pang mga programa bilang backend ng video/audio playback. Ang inirerekomenda
Ang paraan para sa gayon ay ang paggamit ng libmpv. Tingnan mo libmpv/client.h sa repositoryo ng source code ng mpv. Ito
nagbibigay ng C API. Maaaring available ang mga binding para sa ibang mga wika (tingnan ang wiki).

Kapaligiran MGA VARIABLE

Mayroong ilang mga variable ng kapaligiran na maaaring magamit upang kontrolin ang pag-uugali ng
mpv.

BAHAY, XDG_CONFIG_HOME
Ginagamit upang matukoy ang direktoryo ng mpv config. Kung XDG_CONFIG_HOME ay hindi nakatakda,
$HOME/.config/mpv Ginagamit.

$HOME/.mpv ay palaging idinaragdag sa listahan ng mga path ng paghahanap ng config na may mas mababa
prayoridad.

XDG_CONFIG_DIRS
Kung nakatakda, ang XDG-style na mga direktoryo ng configuration ng system ay ginagamit. Kung hindi, ang UNIX
kumbensyon (PREFIX/etc/mpv/) Ginagamit.

TERM Ginagamit upang matukoy ang uri ng terminal.

MPV_HOME
Direktoryo kung saan hinahanap ng mpv ang mga setting ng user. Mga override HOME, at susubukan ng mpv na
i-load ang config file bilang $MPV_HOME/mpv.conf.

MPV_VERBOSE (Tingnan ang Rin -v at --msg-level)
Itakda ang paunang antas ng verbosity sa lahat ng module ng mensahe (default: 0). Ito ay
isang integer, at ang resultang verbosity ay tumutugma sa bilang ng --v pagpipilian
ipinasa sa command line.

MPV_LEAK_REPORT
Kung itakda sa 1, paganahin ang panloob na pag-uulat ng pagtagas ng talloc. Tandaan na ito ay maaaring maging sanhi
problema sa multithreading, kaya mga developer lang ang dapat gumamit nito.

LADSPA_PATH
Tinutukoy ang landas ng paghahanap para sa mga plugin ng LADSPA. Kung ito ay hindi nakatakda, ganap na kwalipikadong landas
dapat gamitin ang mga pangalan.

DISPLAY
Standard X11 display name na gagamitin.

FFmpeg/Libav:
Ina-access ng library na ito ang iba't ibang variable ng kapaligiran. Gayunpaman, hindi sila
centrally documented, at hindi namin trabaho ang pagdodokumento sa kanila. Samakatuwid, ang listahang ito ay
hindi kumpleto.

Mga kapansin-pansing variable ng kapaligiran:

http_proxy
URL para sa proxy http:// at https:// Mga URL

walang_proxy
Listahan ng mga pattern ng domain kung saan walang proxy ang dapat gamitin. Ang mga entry sa listahan ay
pinaghiwalay ng ,. Maaaring isama ang mga pattern *.

libdvdcss:

DVDCSS_CACHE
Tukuyin ang isang direktoryo kung saan mag-iimbak ng mga halaga ng key ng pamagat. Ito ay bibilis
descrambling ng mga DVD na nasa cache. Ang DVDCSS_CACHE ang direktoryo ay
nilikha kung wala ito, at ang isang subdirectory ay nilikha pagkatapos ng pangalan
Pamagat o petsa ng paggawa ng DVD. Kung DVDCSS_CACHE ay hindi nakatakda o walang laman,
Gagamitin ng libdvdcss ang default na halaga na ${HOME}/.dvdcss/ sa ilalim ng Unix
at ang roaming application data directory (% APPDATA%) sa ilalim ng Windows. Ang
hindi pinapagana ng espesyal na halaga na "off" ang pag-cache.

DVDCSS_METHOD
Itinatakda ang paraan ng pagpapatotoo at pag-decryption na gagamitin ng libdvdcss
basahin ang scrambled discs. Maaaring isa sa pamagat, susi or disko.

susi ay ang default na paraan. libdvdcss ay gagamit ng isang set ng kinakalkula na player
key upang subukan at makuha ang disc key. Ito ay maaaring mabigo kung ang drive ay hindi
kilalanin ang alinman sa mga susi ng manlalaro.

disko ay isang fallback na paraan kapag nabigo ang key. Sa halip na gumamit ng player
key, libdvdcss ay i-crack ang disc key gamit ang isang brute force
algorithm. Ang prosesong ito ay masinsinang CPU at nangangailangan ng 64 MB ng memorya
upang mag-imbak ng pansamantalang data.

pamagat ay ang fallback kapag nabigo ang lahat ng iba pang pamamaraan. Hindi ito umaasa
sa isang key exchange sa DVD drive, ngunit sa halip ay gumagamit ng crypto attack
para hulaan ang title key. Sa mga bihirang kaso, maaaring mabigo ito dahil mayroon
hindi sapat na naka-encrypt na data sa disc upang magsagawa ng istatistika
pag-atake, ngunit sa kabilang banda ito ang tanging paraan upang i-decrypt ang isang DVD
nakaimbak sa isang hard disc, o isang DVD na may maling rehiyon sa isang RPC2
biyahe.

DVDCSS_RAW_DEVICE
Tukuyin ang raw device na gagamitin. Ang eksaktong paggamit ay depende sa iyong pagpapatakbo
system, ang Linux utility para mag-set up ng mga raw device ay hilaw(8) halimbawa.
Pakitandaan na sa karamihan ng mga operating system, ang paggamit ng isang raw na device ay nangangailangan
highly aligned buffers: Ang Linux ay nangangailangan ng 2048 bytes alignment (na ang
laki ng isang sektor ng DVD).

DVDCSS_VERBOSE
Itinatakda ang antas ng verbosity ng libdvdcss.

0 Walang anumang mensahe ang mga output.

1 Naglalabas ng mga mensahe ng error sa stderr.

2 Naglalabas ng mga mensahe ng error at mga mensahe sa pag-debug sa stderr.

DVDREAD_NOKEYS
Laktawan ang pagkuha ng lahat ng mga susi sa pagsisimula. Kasalukuyang hindi pinagana.

HOME FIXME: Idokumento ito.

EXIT MGA CODE

Karaniwan mpv nagbabalik ng 0 bilang exit code pagkatapos ng matagumpay na pag-playback. Kung mga error
mangyari, maaaring ibalik ang mga sumusunod na exit code:

1 Error sa pagsisimula ng mpv. Ibinabalik din ito kung ang hindi kilalang mga opsyon ay ipinasa sa
mpv.

2 Hindi ma-play ang file na ipinasa sa mpv. Ito ay medyo malabo: sa kasalukuyan,
Ang pag-playback ng isang file ay itinuturing na matagumpay kung ang pagsisimula ay kadalasan
matagumpay, kahit na mabigo kaagad ang pag-playback pagkatapos ng pagsisimula.

3 Mayroong ilang mga file na maaaring i-play, at ilang mga file na hindi maaaring (gamit
ang kahulugan ng tagumpay mula sa itaas).

4 Umalis dahil sa isang signal, Ctrl+c sa isang VO window (bilang default), o mula sa default
itigil ang mga key binding sa encoding mode.

Tandaan na ang manu-manong paghinto sa player ay palaging hahantong sa exit code 0, na override ang
exit code na ibabalik nang normal. Din ang umalis maaaring lumabas ang input command
code: sa kasong ito, ibinalik ang exit code na iyon.

Gumamit ng mpv online gamit ang mga serbisyo ng onworks.net