mpv - Online di Awan

PROGRAM:

NAMA

mpv - pemutar media

RINGKASAN

mpv [opsi] [file|URL|PLAYLIST|-]
mpv [opsi] file

DESKRIPSI

mpv adalah pemutar media berbasis MPlayer dan mplayer2. Ini mendukung berbagai macam video
format file, codec audio dan video, dan jenis subtitle. Jenis URL masukan khusus adalah
tersedia untuk membaca input dari berbagai sumber selain file disk. Bergantung kepada
platform, berbagai metode output video dan audio yang berbeda didukung.

Contoh penggunaan untuk membantu Anda memulai dengan cepat dapat ditemukan di akhir halaman manual ini.

INTERAKTIF PENGENDALIAN

mpv memiliki lapisan kontrol yang sepenuhnya dapat dikonfigurasi dan digerakkan oleh perintah yang memungkinkan Anda untuk mengontrol mpv
menggunakan keyboard, mouse, atau remote control (tidak ada dukungan LIRC - konfigurasikan remote sebagai
perangkat input sebagai gantinya).

Lihat --memasukkan- pilihan cara untuk menyesuaikannya.

Keyboard kontrol
KIRI dan KANAN
Mencari mundur/maju 5 detik. Shift+panah melakukan pencarian tepat 1 detik (lihat
--jam-mencari).

UP dan BAWAH
Mencari maju/mundur 1 menit. Shift+panah melakukan pencarian tepat 5 detik (lihat
--jam-mencari).

Ctrl+KIRI dan Ctrl + KANAN
Carilah subjudul sebelumnya/berikutnya. Tunduk pada beberapa batasan dan mungkin tidak berfungsi
selalu; Lihat sub_mencari perintah.

[ dan ]
Kurangi/tingkatkan kecepatan pemutaran saat ini sebesar 10%.

{ dan }
Membagi dua/menggandakan kecepatan pemutaran saat ini.

BACKSPACE
Setel ulang kecepatan pemutaran ke normal.

< dan >
Mundur/maju dalam daftar putar.

ENTER Maju dalam daftar putar.

p / SPACE
Jeda (menekan lagi untuk membatalkan jeda).

. Maju. Menekan sekali akan berhenti, setiap penekanan berturut-turut akan memutar satu bingkai
dan kemudian masuk ke mode jeda lagi.

, Langkah mundur. Menekan sekali akan berhenti, setiap tekan berturut-turut akan memutar satu
bingkai secara terbalik dan kemudian masuk ke mode jeda lagi.

q Berhenti bermain dan berhenti.

Q Seperti q, tetapi simpan posisi pemutaran saat ini. Memutar file yang sama nanti akan
lanjutkan pada posisi pemutaran lama jika memungkinkan.

/ dan *
Mengurangi/menambah volume.

9 dan 0
Mengurangi/menambah volume.

m Bisukan suara.

_ Putar melalui trek video yang tersedia.

# Putar melalui trek audio yang tersedia.

f Alihkan layar penuh (lihat juga --fs).

ESC Keluar dari mode layar penuh.

T Beralih tetap di atas (lihat juga --di atas).

w dan e
Kurangi/tambahkan rentang pan-and-scan.

o (Juga P)
Tampilkan bilah perkembangan, waktu yang telah berlalu dan total durasi pada OSD.

O Alihkan status OSD antara waktu/durasi normal dan pemutaran.

v Alihkan visibilitas subtitle.

j dan J
Telusuri subtitle yang tersedia.

x dan z
Sesuaikan penundaan subtitle dengan +/- 0.1 detik.

l Setel/hapus titik loop AB. Lihat ab-loop perintah untuk rincian.

L Beralih perulangan tak terbatas.

Ctrl + dan Ctrl -
Sesuaikan penundaan audio dengan +/- 0.1 detik.

u Beralih antara menerapkan tanpa penggantian gaya ke subtitel SSA/ASS, dan mengganti
mereka hampir sepenuhnya dengan gaya subtitle normal. Lihat --penggantian gaya pantat untuk
Info lebih lanjut.

V Alihkan mode kompatibilitas aspek subtitle VSFilter. Lihat
--ass-vsfilter-aspect-compat untuk info lebih lanjut.

r dan t
Pindahkan subtitle ke atas/bawah.

s Ambil tangkapan layar.

S Ambil tangkapan layar, tanpa subtitle. (Apakah ini berfungsi tergantung pada driver VO
mendukung.)

Ctrl s Ambil tangkapan layar, seperti yang ditunjukkan jendela (dengan subtitle, OSD, dan video berskala).

I Tampilkan nama file pada OSD.

PGUP dan PGDWN
Mencari ke awal bab sebelumnya/berikutnya. Dalam kebanyakan kasus, "sebelumnya" akan
benar-benar pergi ke awal bab saat ini; Lihat --bab-mencari-ambang.

Shift + PGUP dan Shift+PGDWN
Mencari mundur atau maju dengan 10 menit. (Dulu ini dipetakan ke PGUP/PGDWN
tanpa Shift.)

d Mengaktifkan/menonaktifkan deinterlacer.

A Penggantian rasio aspek siklus.

(Kunci berikut hanya berlaku saat menggunakan output video yang mendukung
penyesuaian yang sesuai, atau equalizer perangkat lunak (--vf=persamaan).)

1 dan 2
Sesuaikan kontras.

3 dan 4
Sesuaikan kecerahan.

5 dan 6
Sesuaikan gama.

7 dan 8
Sesuaikan saturasi.

Alt + 0 (Dan perintah+0 on OSX)
Ubah ukuran jendela video menjadi setengah dari ukuran aslinya.

Alt + 1 (Dan perintah+1 on OSX)
Ubah ukuran jendela video ke ukuran aslinya.

Alt + 2 (Dan perintah+2 on OSX)
Ubah ukuran jendela video untuk menggandakan ukuran aslinya.

Command + f (OSX saja)
Alihkan layar penuh (lihat juga --fs).

Command + [ dan Command + ] (OSX saja)
Setel alfa jendela video.

(Tombol berikut ini valid jika Anda memiliki keyboard dengan tombol multimedia.)

JEDA Jeda.

BERHENTI Berhenti bermain dan berhenti.

SEBELUMNYA dan BERIKUTNYA
Mencari mundur/maju 1 menit.

(Kunci berikut hanya valid jika Anda mengkompilasi dengan dukungan input TV atau DVB.)

h dan k
Pilih saluran sebelumnya/berikutnya.

Mouse kontrol
tombol 3 dan tombol 4
Mencari mundur/maju 1 menit.

tombol 5 dan tombol 6
Mengurangi/menambah volume.

PENGGUNAAN

Setiap bendera pilihan memiliki tanpa bendera rekanan, misalnya kebalikan dari --fs pilihannya adalah
--tidak-fs. --fs=ya sama seperti --fs, --fs=tidak sama dengan --tidak-fs.

Jika opsi ditandai sebagai (XXX saja), itu hanya akan bekerja dalam kombinasi dengan XXX Option
atau jika XXX dikompilasi di.

Lolos spasi dan lain khusus karakter
Ingatlah bahwa shell sebagian akan mengurai dan memotong argumen yang Anda berikan ke mpv.
Misalnya, Anda mungkin perlu mengutip atau keluar dari opsi dan nama file:
mpv "nama file dengan spasi.mkv" --title="jendela judul"

Ini menjadi lebih rumit jika pengurai subopsi terlibat. Pengurai subopsi menempatkan
beberapa opsi menjadi satu string, dan meneruskannya ke komponen sekaligus, alih-alih
menggunakan beberapa opsi pada tingkat baris perintah.

Pengurai subopsi dapat mengutip string dengan " dan [...]. Selain itu, ada spesial
bentuk mengutip dengan %N% dijelaskan di bawah ini.

Sebagai contoh, terbuka VO dapat mengambil beberapa opsi:
mpv tes.mkv --vo=opengl:scale=lanczos:icc-profile=file.icc,xv

Ini berlalu skala = lanczos dan icc-profile=file.icc untuk terbuka, dan juga menentukan xv as
mundur VO. Jika jalur profil-icc berisi spasi atau karakter seperti , or :kamu butuh
mengutip mereka:
mpv '--vo=opengl:icc-profile="file dengan spasi.icc",xv'

Kerang sebenarnya dapat menghapus beberapa kutipan dari string yang diteruskan ke baris perintah, jadi
contoh mengutip string dua kali, memastikan bahwa mpv menerima " tanda kutip.

[...] bentuk kutipan membungkus segalanya di antara [ dan ]. Ini berguna dengan cangkang yang
jangan menafsirkan karakter ini di tengah argumen (seperti bash). Kutipan ini
seimbang (sejak mpv 0.9.0): the [ dan ] sarang, dan kutipan berakhir pada yang terakhir ]
yang tidak memiliki kecocokan [ di dalam tali. (Sebagai contoh, [a[b]c] hasil dalam a[b]c.)

Sintaks kutipan dengan panjang tetap dimaksudkan untuk digunakan dengan skrip dan program eksternal.

Ini dimulai dengan % dan memiliki format sebagai berikut:

%n%string_of_length_n

contoh

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

Atau dalam skrip:

mpv --ao=pcm:file=%`expr panjangnya "$NAME"`%"$NAME" tes.avi

Subopsi yang diteruskan ke API klien juga dapat lolos. Menggunakan
mpv_set_option_string() persis seperti lewat --nama=data ke baris perintah (tapi
tanpa pemrosesan shell dari string). Beberapa opsi mendukung pemberian nilai lebih
cara terstruktur alih-alih string datar, dan dapat menghindari kekacauan parsing subopsi. Untuk
contoh, --vf mendukung MPV_FORMAT_NODE, yang memungkinkan Anda meneruskan subopsi sebagai data bersarang
struktur peta dan array. (--vo mendukung ini dengan cara yang sama, meskipun fakta ini
tidak berdokumen.)

Jalan
Beberapa kehati-hatian harus dilakukan saat melewati jalur dan nama file arbitrer ke mpv. Sebagai contoh,
jalur dimulai dengan - akan ditafsirkan sebagai pilihan. Demikian juga, jika suatu jalur berisi
urutan :/ /, string sebelumnya mungkin ditafsirkan sebagai awalan protokol, meskipun
:/ / dapat menjadi bagian dari jalur UNIX legal. Untuk menghindari masalah dengan jalur sewenang-wenang, Anda harus
pastikan bahwa jalur absolut yang diteruskan ke mpv dimulai dengan /, dan jalur relatif dengan ./.

Nama - sendiri ditafsirkan sebagai stdin, dan akan menyebabkan mpv menonaktifkan kontrol konsol.
(Yang membuatnya cocok untuk memutar data yang disalurkan ke stdin.)

Untuk jalur yang diteruskan ke subopsi, situasinya semakin rumit dengan kebutuhan untuk melarikan diri
karakter spesial. Untuk menyiasatinya, jalan juga dapat dibungkus dengan
sintaks dengan panjang tetap, mis %n%string_of_length_n (Lihat di atas).

Beberapa opsi mpv menafsirkan jalur yang dimulai dengan ~. Saat ini, awalan ~~/ meluas ke
direktori konfigurasi mpv (biasanya ~/.config/mpv/). ~/ diperluas ke rumah pengguna
direktori. (yang tertinggal / selalu diperlukan.) Ada juga jalur berikut:

┌─ans───── Chasan XNUMX Choll XNUMX Choll XNUMXX XNUMX Chocanding "" "" "" XNUMXirim XNUMXirim XNUMX olakkanansansansansansansans poto─ansansansansansans pirim - - XNUMX. XNUMX. XNUMX.kan XNUMX.kan XNUMX.kankan XNUMX.kankan XNUMXkan XNUMXkanansansans Miss─
Nama Arti
└────── teks acoran───X chambatan ilangan ilangan Phace uransansans chepaskan XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMXX XNUMX Ch XNUMX Ch XNUMXos XNUMXX XNUMX Chocansansansansansans potack. Uman qacam ilangan uas sesuai

│~~rumah/ sama dengan ~~/ │
├────── teks acoran───X chambatan ilangan ilangan Phace uransansans chepaskan XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMXX XNUMX Ch XNUMX Ch XNUMXos XNUMXX XNUMX Chocansansansansansans potack. Uman qacam ilangan uas sesuai
│~~global/ jalur konfigurasi global, jika
tersedia (bukan di win32)
├────── teks acoran───X chambatan ilangan ilangan Phace uransansans chepaskan XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMXX XNUMX Ch XNUMX Ch XNUMXos XNUMXX XNUMX Chocansansansansansans potack. Uman qacam ilangan uas sesuai
│~~osxbundel/ jalur sumber daya bundel OSX
(hanya OSX)
├────── teks acoran───X chambatan ilangan ilangan Phace uransansans chepaskan XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMXX XNUMX Ch XNUMX Ch XNUMXos XNUMXX XNUMX Chocansansansansansans potack. Uman qacam ilangan uas sesuai
│~~ desktop/ jalur ke desktop (win32,
OSX)
└────── teks acoran───X chambatan ilangan ilangan Phace uransansans chepaskan XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMXX XNUMX Ch XNUMX Ch XNUMXos XNUMXX XNUMX Chocansansansansansans potack. Uman qacam ilangan uas sesuai

Per-File Opsi
Saat memutar banyak file, opsi apa pun yang diberikan pada baris perintah biasanya memengaruhi semua
file. Contoh:

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

┌──────────┬──────────────-.
File Opsi aktif
├──────────┼──────────────-.
file1.mkv --Sebuah --B --C │
├──────────┼──────────────-.
file2.mkv --Sebuah --B --C │
└──────────┴──────────────-.

(Ini berbeda dari MPlayer dan mplayer2.)

Juga, jika ada opsi yang diubah saat runtime (melalui perintah input), opsi tersebut tidak disetel ulang saat a
file baru diputar.

Terkadang, berguna untuk mengubah opsi per file. Hal ini dapat dicapai dengan menambahkan
penanda per file khusus --{ dan --}. (Perhatikan bahwa Anda harus menghindari ini pada beberapa shell.)
Contoh:

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

┌───────────────────────────────────────────────────
File Opsi aktif
├───────────────────────────────────────────────────
file1.mkv --Sebuah --B --F │
├───────────────────────────────────────────────────
file2.mkv --Sebuah --B --F --C --D --e │
├───────────────────────────────────────────────────
file3.mkv --Sebuah --B --F --C --D --e │
├───────────────────────────────────────────────────
file4.mkv --Sebuah --B --F │
└───────────────────────────────────────────────────

Selain itu, opsi file-lokal apa pun yang diubah saat runtime diatur ulang ketika file saat ini
berhenti bermain. Jika opsi --C berubah selama pemutaran file2.mkv, itu diatur ulang ketika
maju ke file3.mkv. Ini hanya memengaruhi opsi file-lokal. Pilihan --Sebuah tidak pernah
ulang di sini.

KONFIGURASI FILE

Lokasi dan Sintaksis
Anda dapat meletakkan semua opsi dalam file konfigurasi yang akan dibaca setiap kali mpv diputar
Lari. File konfigurasi seluruh sistem 'mpv.conf' ada di direktori konfigurasi Anda
(misalnya /etc/mpv or /usr/local/etc/mpv), yang khusus pengguna adalah ~/.config/mpv/mpv.conf.
Untuk detail dan spesifikasi platform (khususnya jalur Windows) lihat FILE bagian.

Opsi khusus pengguna mengesampingkan opsi dan opsi di seluruh sistem yang diberikan pada baris perintah
menimpa baik. Sintaks dari file konfigurasi adalah pilihan = nilai. Semuanya setelah a
# dianggap sebagai komentar. Opsi yang berfungsi tanpa nilai dapat diaktifkan dengan menyetelnya
untuk iya nih dan dinonaktifkan dengan menyetelnya ke tidak. Bahkan subopsi dapat ditentukan dengan cara ini.

Contoh file konfigurasi

# Gunakan output video opengl secara default.
vo=buka
# Gunakan tanda kutip untuk teks yang dapat berisi spasi:
status-msg="Waktu: ${time-pos}"

Lolos spasi dan khusus karakter
Ini dilakukan seperti dengan opsi baris perintah. Shell tidak terlibat di sini, tetapi opsi
nilai masih perlu dikutip secara keseluruhan jika mengandung karakter tertentu seperti spasi. A
entri konfigurasi dapat dikutip dengan ", serta dengan sintaks panjang tetap (%N%) disebutkan
sebelum. Ini seperti meneruskan konten persis dari string yang dikutip sebagai baris perintah
pilihan. Pelarian gaya-C saat ini _tidak_ ditafsirkan pada level ini, meskipun beberapa
pilihan melakukan ini secara manual. (Ini berantakan dan mungkin harus diubah di beberapa titik.)

Puting perintah baris Opsi ke itu konfigurasi File
Hampir semua opsi baris perintah dapat dimasukkan ke dalam file konfigurasi. Ini kecil
panduan:

┌────── teks acoran───X chambatan uracebook─ans─ Chepaskan XNUMXX XNUMX Chollans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX Chsans XNUMX Chosans XNUMX Chosososansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXssumaneses bing bingolirim tolasanasan uas - ilangan
Opsi Entri file konfigurasi
├────── teks acoran───X chambatan uracebook─ans─ Chepaskan XNUMXX XNUMX Chollans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX Chsans XNUMX Chosans XNUMX Chosososansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXssumaneses bing bingolirim tolasanasan uas - ilangan
│--bendera │ bendera │
├────── teks acoran───X chambatan uracebook─ans─ Chepaskan XNUMXX XNUMX Chollans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX Chsans XNUMX Chosans XNUMX Chosososansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXssumaneses bing bingolirim tolasanasan uas - ilangan
│-memilih val │ memilih=val │
├────── teks acoran───X chambatan uracebook─ans─ Chepaskan XNUMXX XNUMX Chollans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX Chsans XNUMX Chosans XNUMX Chosososansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXssumaneses bing bingolirim tolasanasan uas - ilangan
│--memilih=val │ memilih=val │
├────── teks acoran───X chambatan uracebook─ans─ Chepaskan XNUMXX XNUMX Chollans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX Chsans XNUMX Chosans XNUMX Chosososansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXssumaneses bing bingolirim tolasanasan uas - ilangan
│-memilih "memiliki spasi" │ opt="memiliki spasi" │
└────── teks acoran───X chambatan uracebook─ans─ Chepaskan XNUMXX XNUMX Chollans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX Chsans XNUMX Chosans XNUMX Chosososansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXssumaneses bing bingolirim tolasanasan uas - ilangan

Khusus file konfigurasi File
Anda juga dapat menulis file konfigurasi khusus file. Jika Anda ingin memiliki konfigurasi
file untuk file bernama 'video.avi', buat file bernama 'video.avi.conf' dengan
opsi khusus file di dalamnya dan masukkan ~/.config/mpv/. Anda juga dapat menempatkan
file konfigurasi di direktori yang sama dengan file yang akan diputar. Keduanya mengharuskan Anda untuk mengatur
itu --gunakan-filedir-conf opsi (baik di baris perintah atau di file konfigurasi global Anda).
Jika file konfigurasi khusus file ditemukan di direktori yang sama, tidak ada file khusus
konfigurasi dimuat dari ~/.config/mpv. Selain itu, --gunakan-filedir-conf Option
mengaktifkan file konfigurasi khusus direktori. Untuk ini, mpv pertama-tama mencoba memuat
mpv.conf dari direktori yang sama dengan file yang diputar dan kemudian mencoba memuat apa saja
konfigurasi khusus file.

profil
Untuk memudahkan bekerja dengan konfigurasi yang berbeda, profil dapat ditentukan di
file konfigurasi. Profil dimulai dengan namanya dalam tanda kurung siku, mis [Profil saya].
Semua opsi berikut akan menjadi bagian dari profil. Deskripsi (ditunjukkan oleh --profil=bantuan)
dapat didefinisikan dengan profil-desc pilihan. Untuk mengakhiri profil, mulai yang lain atau gunakan
nama profil kegagalan untuk melanjutkan dengan opsi normal.

Contoh file konfigurasi mpv dengan profil

# opsi tingkat atas normal
layar penuh=ya

# profil yang dapat diaktifkan dengan --profile=big-cache
[tembolok besar]
cache = 123400
demuxer-readahead-detik=20

[lambat]
profile-desc="beberapa nama profil"
vo=opengl:skala=ewa_lanczos:skala-radius=16

[cepat]
vo=vdpau

# menggunakan profil lagi memperluasnya
[lambat]
framedrop=tidak
# Anda juga dapat memasukkan profil lain
profil=cache besar

Mobil profil
Beberapa profil dimuat secara otomatis. Contoh berikut menunjukkan hal ini:

Pemuatan profil otomatis

[vo.vdpau]
# Gunakan decoding perangkat keras
hwdec=vdpau

[protokol.dvd]
profile-desc="profil untuk dvd:// streaming"
alang=id

[ekstensi.flv]
profile-desc="profil untuk file .flv"
vf=balik

[ao.alsa]
perangkat = spdif

Nama profil mengikuti skema ketik nama, di mana jenisnya bisa vo untuk mencocokkan nilai
--vo pilihan diatur ke, ao untuk --ao, protokol untuk protokol input/output yang digunakan (lihat
--daftar-protokol), Dan perpanjangan untuk perpanjangan jalur yang sedang dimainkan
berkas (tidak format berkas).

Fitur ini sangat terbatas, dan tidak ada profil otomatis lainnya.

MEMUKAU Tangkapan layar

Tangkapan layar dari file yang sedang diputar dapat diambil menggunakan mode input 'tangkapan layar'
perintah, yang secara default terikat ke s kunci. File bernama tembakanNNNN.jpg akan disimpan di
direktori kerja, menggunakan nomor pertama yang tersedia - tidak ada file yang akan ditimpa.

Tangkapan layar biasanya berisi konten video tanpa skala di akhir video
rantai filter dan subtitle. Secara default, S mengambil tangkapan layar tanpa subtitle, sementara s
termasuk subtitle.

Berbeda dengan MPlayer, screenshot filter video tidak diperlukan. Filter ini tidak pernah
diperlukan dalam mpv, dan telah dihapus.

TERMINAL STATUS GARIS

Selama pemutaran, mpv menunjukkan status pemutaran di terminal. Sepertinya sesuatu
seperti ini:
DARI: 00:03:12 / 00:24:25 (13%) AV: -0.000

Baris status dapat diganti dengan --istilah-status-pesan .

Berikut ini adalah daftar hal-hal yang dapat muncul di baris status. Properti masukan,
yang dapat digunakan untuk mendapatkan informasi yang sama secara manual, juga terdaftar.

· DARI: or V: (hanya video) atau A: (hanya suara)

· Posisi waktu saat ini di JJ:MM:SS format (waktu pemutaran Properti)

· Total durasi file (tidak ada jika tidak diketahui) (panjangnya Properti)

· Kecepatan pemutaran, misalnya `` x2.0``. Hanya terlihat jika kecepatannya tidak normal. Ini adalah
kecepatan yang diminta pengguna, dan bukan kecepatan sebenarnya (biasanya harus sama, kecuali
pemutaran terlalu lambat). (kecepatan Properti.)

· Persentase pemutaran, misalnya (13%). Berapa banyak file yang telah diputar. Biasanya
dihitung dari posisi dan durasi pemutaran, tetapi dapat mundur ke metode lain
(seperti posisi byte) jika ini tidak tersedia. (persen-pos Properti.)

· Sinkronisasi audio/video sebagai AV: 0.000. Inilah perbedaan antara audio dan video
waktu. Biasanya harus 0 atau mendekati 0. Jika tumbuh, mungkin menunjukkan a
masalah pemutaran. (sinkronisasi otomatis Properti.)

· Perubahan sinkronisasi A/V total, mis ct: -0.417. Biasanya tidak terlihat. Bisa muncul jika ada
audio "hilang", atau tidak cukup bingkai yang dapat dijatuhkan. Biasanya ini akan menunjukkan
masalah. (total-avsync-perubahan Properti.)

· Status pengkodean dalam {...}, hanya ditampilkan dalam mode enkode.

· Tampilkan status sinkronisasi. Jika sinkronisasi tampilan aktif (tampilan-sinkronisasi-aktif properti), ini menunjukkan
DS: 2.500/13, di mana angka pertama adalah jumlah rata-rata vsyncs per bingkai video (mis
2.5 saat memutar video 24Hz pada layar 60Hz), yang mungkin bergetar jika rasionya tidak
pembulatan, atau ada frame yang salah waktu (rasio-vsync), dan bilangan kedua dari
perkiraan jumlah vsync yang memakan waktu terlalu lama (vo-penundaan-frame-count Properti). NS
yang terakhir adalah heuristik, karena umumnya tidak mungkin untuk menentukan ini dengan pasti.

· Bingkai yang dijatuhkan, misalnya Menjatuhkan: 4. Muncul hanya jika hitungannya tidak 0. Dapat tumbuh jika
framerate video lebih tinggi dari tampilan, atau jika rendering video terlalu lambat.
Juga dapat bertambah pada "cegukan" dan ketika bingkai video tidak dapat ditampilkan di
waktu. (vo-drop-frame-count properti.) Jika decoder menjatuhkan frame, jumlah
bingkai yang dijatuhkan dekoder juga ditambahkan ke tampilan, misalnya: Menjatuhkan: 4/34. Ini
hanya terjadi jika penurunan bingkai dekoder diaktifkan dengan --bingkaijatuh Pilihan.
(jumlah bingkai jatuh Properti.)

· Status cache, misalnya Cache: 2dtk+134KB. Terlihat jika cache streaming diaktifkan. Pertama
nilai menunjukkan jumlah buffer video di demuxer dalam hitungan detik, nilai kedua
menunjukkan tambahan data buffer dalam cache aliran dalam kilobyte. (demuxer-cache-durasi
dan cache-digunakan properti.)

PROTOKOL

http://..., https://, ...
Banyak protokol jaringan yang didukung, tetapi awalan protokol harus selalu
ditentukan. mpv tidak akan pernah mencoba menebak apakah nama file sebenarnya adalah jaringan
alamat. Awalan protokol selalu diperlukan.

Perhatikan bahwa tidak semua awalan didokumentasikan di sini. Awalan yang tidak berdokumen adalah
alias ke protokol terdokumentasi, atau hanya pengalihan ke protokol yang diimplementasikan
dan didokumentasikan dalam FFmpeg.

- Putar data dari stdin.

seseorang: //PATH
Mainkan jalur dari Samba share.

bd://[judul][/perangkat] --bluray-perangkat=JALAN
Putar disk Blu-Ray. Saat ini, ini tidak menerima file ISO. Sebaliknya, Anda harus
pasang file ISO sebagai sistem file, dan titik --bluray-perangkat ke mount
direktori secara langsung.

dvd://[judul|[judul awal]-judul akhir][/perangkat] --perangkat-dvd=JALAN
Putar DVD. Menu DVD tidak didukung. Jika tidak ada judul yang diberikan, judul terpanjang adalah
dipilih secara otomatis.

DVD: // adalah alias lama untuk DVD:// dan melakukan hal yang persis sama.

dvdread://...:
Putar DVD menggunakan kode libdvdread lama. Inilah yang MPlayer dan mpv lama
versi digunakan untuk DVD://. Penggunaan tidak disarankan. Ini disediakan hanya untuk kompatibilitas
dan untuk transisi.

tv://[saluran][/input_id] --televisi-...
TV analog melalui V4L. Juga berguna untuk webcam. (Linux saja.)

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

dvb://[nomor kartu@]saluran --dvbin-...
TV digital melalui DVB. (Linux saja.)

mf://[mask file|@daftarfile] --mf-...
Putar serangkaian gambar sebagai video.

cdda://track[-endtrack][:kecepatan][/perangkat] --cdrom-device=JALAN --cdda-...
Putar CD.

lav: //...
Akses protokol libavformat FFmpeg/Libav apa pun. Pada dasarnya, ini melewati batas
setelah // langsung ke libavformat.

av://ketik:opsi
Ini dimaksudkan untuk menggunakan input libavdevice. mengetik adalah demuxer libavdevice
nama, dan Pilihan adalah nama file (pseudo-) yang diteruskan ke demuxer.

Sebagai contoh, mpv av://lavfi:mandelbrot memanfaatkan pembungkus libavfilter
termasuk dalam libavdevice, dan akan menggunakan mandelbrot filter sumber untuk menghasilkan
memasukan data.

perangkat av:// adalah alias.

berkas://PATH
Jalur lokal sebagai URL. Mungkin berguna dalam beberapa kasus penggunaan khusus. Perhatikan bahwa PATH
itu sendiri harus dimulai dengan sepertiga / untuk membuat jalur menjadi jalur absolut.

fd://123
Baca data dari FD UNIX yang diberikan (misalnya 123). Ini mirip dengan data perpipaan
untuk stdin melalui -, tetapi dapat menggunakan deskriptor file arbitrer. Tidak akan bekerja dengan benar
pada MS Windows.

edl://[edl spesifikasi as in edl-mpv.pertama]
Gabungkan bagian-bagian dari beberapa file dan mainkan.

batal://
Simulasikan file kosong.

memori://data
Gunakan data bagian sebagai sumber data.

SEMU GUI MODE

mpv tidak memiliki GUI resmi, selain OSC (ON LAYAR CONTROLLER), yang tidak penuh
GUI dan tidak dimaksudkan untuk itu. Namun, untuk mengimbangi kurangnya perilaku GUI yang diharapkan,
mpv dalam beberapa kasus akan dimulai dengan beberapa pengaturan diubah untuk berperilaku sedikit lebih seperti GUI
mode.

Saat ini ini hanya terjadi dalam kasus berikut:

· jika mulai menggunakan mpv.desktop file di Linux (misalnya dimulai dari menu atau file
asosiasi yang disediakan oleh lingkungan desktop)

· jika dimulai dari explorer.exe di Windows (secara teknis, jika dimulai di Windows, dan
semua pegangan stdout/stderr/stdin tidak disetel)

· menambahkan secara manual --profil=pseudo-gui ke baris perintah

Mode ini secara implisit menambahkan --profil=pseudo-gui ke baris perintah, dengan pseudo-gui
profil yang telah ditentukan sebelumnya dengan konten berikut:

[gui palsu]
terminal = tidak
jendela paksa = ya
menganggur = sekali
tangkapan layar-direktori=~~desktop/

Ini mengikuti format file konfigurasi mpv. Untuk menyesuaikan mode pseudo-GUI, Anda dapat menempatkan
sendiri pseudo-gui profil ke Anda mpv.conf. Profil ini akan meningkatkan profil default,
daripada menimpanya.

Profil selalu mengesampingkan pengaturan lain di mpv.conf.

PILIHAN

Melacak Seleksi
--alang=
Tentukan daftar prioritas bahasa audio yang akan digunakan. Format wadah yang berbeda
menggunakan kode bahasa yang berbeda. DVD menggunakan kode bahasa dua huruf ISO 639-1,
Matroska, MPEG-TS dan NUT menggunakan kode bahasa tiga huruf ISO 639-2, sedangkan OGM menggunakan
pengidentifikasi bentuk bebas. Lihat juga --bantuan.

contoh

mpv DVD://1 --alang=hu, en
Memilih trek bahasa Hongaria pada DVD dan kembali menggunakan bahasa Inggris
jika bahasa Hongaria tidak tersedia.

mpv --alang=jpn contoh.mkv
Memutar file Matroska dalam bahasa Jepang.

--gaul=
Tentukan daftar prioritas bahasa terjemahan yang akan digunakan. Format wadah yang berbeda
menggunakan kode bahasa yang berbeda. DVD menggunakan kode bahasa dua huruf ISO 639-1,
Matroska menggunakan kode bahasa tiga huruf ISO 639-2 sedangkan OGM menggunakan bentuk bebas
pengenal. Lihat juga --sid.

contoh

· mpv DVD://1 --slang=hu, en memilih trek subtitle Hungaria pada DVD dan
jatuh kembali pada bahasa Inggris jika bahasa Hongaria tidak tersedia.

· mpv --gaul=jpn contoh.mkv memutar file Matroska dengan teks bahasa Jepang.

--bantuan=
Pilih trek audio. mobil memilih default, tidak menonaktifkan audio. Lihat juga --alang.
mpv biasanya mencetak trek audio yang tersedia di terminal saat memulai pemutaran
dari sebuah file.

--sid=
Tampilkan aliran subtitle yang ditentukan oleh . mobil memilih default, tidak
menonaktifkan subtitle.

Lihat juga --slang, --tanpa-sub.

--vid=
Pilih saluran video. mobil memilih default, tidak menonaktifkan video.

--ff-bantuan= , --ff-sid= , --ff-vid=
Pilih aliran audio/subtitel/video dengan indeks aliran FFmpeg. Aliran FFmpeg
indeks relatif sewenang-wenang, tetapi berguna saat berinteraksi dengan perangkat lunak lain
menggunakan FFmpeg (pertimbangkan ffprobe).

Perhatikan bahwa dengan trek eksternal (ditambahkan dengan --sub-berkas dan opsi serupa), di sana
akan menjadi aliran dengan ID duplikat. Dalam hal ini, aliran pertama dalam urutan adalah
terpilih.

--edisi=
(Hanya file Matroska) Tentukan edisi (kumpulan bab) yang akan digunakan, di mana 0 adalah
pertama. Jika diatur ke mobil (default), mpv akan memilih edisi pertama yang dinyatakan sebagai
default, atau jika tidak ada default, edisi pertama ditentukan.

Putar kontrol
--mulai= waktu>
Carilah posisi waktu tertentu.

Format umum untuk waktu absolut adalah [[hh:]mm:]ss[.ms]. Jika waktu diberikan
dengan awalan + or -, pencarian relatif dari awal atau akhir file.
(Sejak mpv 0.14, awal file selalu dianggap 0.)

hal% berusaha untuk persen posisi pp (0-100).

#c berusaha untuk bab nomor c. (Bab dimulai dari 1.)

contoh

--mulai=+56, --mulai=+00:56
Mencari waktu mulai + 56 detik.

--mulai=-56, --mulai=-00:56
Mencari sampai akhir waktu - 56 detik.

--mulai=01:10:00
Mencari untuk 1 jam 10 menit.

--mulai=50%
Mencari ke tengah file.

--mulai=30 --akhir=40
Mencari 30 detik, memutar 10 detik, dan keluar.

--mulai=-3:20 --panjang=10
Mencari 3 menit dan 20 detik sebelum akhir file, memutar 10
detik, dan keluar.

--mulai='#2' --end='#4'
Memainkan bab 2 dan 3, dan keluar.

--akhir=
Berhenti pada waktu absolut tertentu. Menggunakan --panjang jika waktunya harus relatif terhadap
--Mulailah. Lihat --Mulailah untuk nilai opsi dan contoh yang valid.

--panjang= waktu>
Berhenti setelah waktu tertentu relatif terhadap waktu mulai. Lihat --Mulailah untuk opsi yang valid
nilai dan contoh.

--rebase-start-time=
Apakah akan memindahkan waktu mulai file ke 00:00:00 (standar: ya). Ini kurang
canggung untuk file yang dimulai pada stempel waktu acak, seperti aliran transportasi. Pada
di sisi lain, jika ada penyetelan ulang stempel waktu, perilaku yang dihasilkan bisa agak
aneh. Untuk alasan ini, dan jika Anda benar-benar tertarik dengan yang asli
stempel waktu, perilaku ini dapat dinonaktifkan dengan tidak.

--kecepatan=<0.01-100>
Memperlambat atau mempercepat pemutaran dengan faktor yang diberikan sebagai parameter.

If --koreksi nada audio (diaktifkan secara default) digunakan, bermain dengan kecepatan lebih tinggi
dari biasanya secara otomatis memasukkan skalatempo penyaring suara.

--loop=
Pemutaran loop N waktu. Sebuah nilai dari 1 memainkannya satu kali (default), 2 dua kali, dll.
inf berarti selamanya. tidak sama dengan 1 dan menonaktifkan perulangan. Jika beberapa file adalah
ditentukan pada baris perintah, seluruh daftar putar dilingkarkan.

kekuatan modusnya seperti inf, tetapi tidak melewatkan entri daftar putar yang telah
ditandai sebagai gagal. Ini berarti pemain mungkin membuang waktu CPU untuk mencoba mengulang file
itu tidak ada. Tapi mungkin berguna untuk memainkan webradio di bawah kondisi yang sangat buruk
kondisi jaringan.

--berhenti sebentar
Mulai pemutar dalam keadaan dijeda.

--mengacak
Putar file dalam urutan acak.

--bab=
Tentukan di bab mana Anda akan mulai bermain. Secara opsional tentukan bab mana yang akan diakhiri
bermain di. Lihat juga --Mulailah.

--playlist-pos=
Setel file mana pada daftar putar internal untuk memulai pemutaran. indeks adalah
integer, dengan 0 berarti file pertama. Nilai tidak berarti pemilihan
entri untuk diputar diserahkan kepada mekanisme melanjutkan pemutaran (default). Jika sebuah entri
dengan indeks yang diberikan tidak ada, perilaku tidak ditentukan dan mungkin berubah
versi mpv masa depan. Hal yang sama berlaku jika daftar putar berisi daftar putar lebih lanjut
(jangan mengharapkan perilaku yang masuk akal). Melewati file daftar putar ke mpv seharusnya berfungsi
dengan opsi ini, meskipun. Misalnya mpv daftar putar.m3u --daftar putar-pos=123 akan bekerja sebagai
diharapkan, asalkan daftar putar.m3u tidak menautkan ke daftar putar lebih lanjut.

--daftar putar=
Putar file menurut file daftar putar (Mendukung beberapa format umum. Jika tidak ada format
terdeteksi, itu akan diperlakukan sebagai daftar file, dipisahkan oleh karakter baris baru.
Perhatikan bahwa format daftar putar XML tidak didukung.)

Anda dapat memutar daftar putar secara langsung dan tanpa opsi ini, namun, opsi ini
menonaktifkan mekanisme keamanan apa pun yang mungkin ada. Anda mungkin juga membutuhkan ini
opsi untuk memuat file plaintext sebagai daftar putar.

PERINGATAN:
Cara mpv menggunakan file daftar putar melalui --daftar putar tidak aman terhadap kejahatan
file yang dibangun. File tersebut dapat memicu tindakan berbahaya. Ini telah menjadi
kasus untuk semua versi mpv dan MPlayer, tetapi sayangnya fakta ini tidak baik
didokumentasikan sebelumnya, dan beberapa orang bahkan salah merekomendasikan penggunaan
--daftar putar dengan sumber yang tidak terpercaya. Jangan gunakan --daftar putar dengan internet acak
sumber atau file yang tidak Anda percayai!

Daftar putar dapat berisi entri menggunakan protokol lain, seperti file lokal, atau
(paling parah), protokol khusus seperti perangkat av://, yang secara inheren
tidak aman

--chapter-merge-threshold=
Ambang batas untuk menggabungkan bagian bab yang hampir berurutan dalam milidetik
(standar: 100). Beberapa file Matroska dengan bab yang dipesan memiliki bab yang tidak akurat
cap waktu akhir, menyebabkan celah kecil antara akhir satu bab dan awal
berikutnya ketika mereka harus cocok. Jika akhir dari satu bagian pemutaran kurang dari
ambang batas yang diberikan jauh dari awal yang berikutnya kemudian terus putar video
biasanya selama perubahan bab alih-alih melakukan pencarian.

--chapter-seek-threshold=
Jarak dalam hitungan detik dari awal bab di mana bab mundur
seek akan menuju ke bab sebelumnya (default: 5.0). Melewati ambang batas ini, a
pencarian bab mundur akan pergi ke awal bab saat ini sebagai gantinya. A
nilai negatif berarti selalu kembali ke bab sebelumnya.

--jam-mencari=
Pilih kapan harus menggunakan pencarian tepat yang tidak terbatas pada bingkai utama. Pencarian seperti itu
memerlukan decoding video dari keyframe sebelumnya ke posisi target dan seterusnya
dapat memakan waktu tergantung pada kinerja decoding. Untuk beberapa format video,
pencarian yang tepat dinonaktifkan. Opsi ini memilih pilihan default yang akan digunakan untuk
mencari; dimungkinkan untuk secara eksplisit menimpa default itu dalam definisi kunci
binding dan dalam perintah mode budak.

tidak Jangan pernah menggunakan pencarian yang tepat.

mutlak
Gunakan pencarian yang tepat jika pencarian berada pada posisi absolut dalam file, seperti
sebagai pencarian bab, tetapi tidak untuk pencarian relatif seperti perilaku default
tombol panah (default).

iya nih Gunakan pencarian yang tepat bila memungkinkan.

selalu Sama dengan iya nih (untuk kompatibilitas).

--hr-seek-demuxer-offset=
Opsi ini ada untuk mengatasi kegagalan untuk melakukan pencarian yang tepat (seperti pada --jam-mencari)
disebabkan oleh bug atau keterbatasan dalam demuxer untuk beberapa format file. Beberapa demuxer
gagal mencari keyframe sebelum posisi target yang diberikan, pergi ke nanti
posisi sebagai gantinya. Nilai opsi ini dikurangi dari stempel waktu yang diberikan
ke demuxer. Jadi, jika Anda menyetel opsi ini ke 1.5 dan mencoba melakukan pencarian yang tepat untuk
60 detik, demuxer disuruh mencari waktu 58.5, yang diharapkan mengurangi
kemungkinan bahwa itu salah pergi ke beberapa waktu kemudian dari 60 detik. Kelemahan dari
pengaturan opsi ini adalah bahwa pencarian yang tepat menjadi lebih lambat, karena video antara
posisi demuxer sebelumnya dan target sebenarnya mungkin tidak perlu diterjemahkan.

--hr-seek-framedrop=
Biarkan dekoder video menjatuhkan bingkai selama pencarian, jika bingkai ini sebelum
mencari sasaran. Jika ini diaktifkan, pencarian yang tepat bisa lebih cepat, tetapi jika Anda menggunakan
filter video yang memodifikasi stempel waktu atau menambahkan bingkai baru, ini dapat menghasilkan ketepatan
mencari melewatkan bingkai target. Ini misalnya dapat mematahkan backstepping frame ketika
deinterlacing diaktifkan.

Default: iya nih

--indeks=
Mengontrol cara mencari dalam file. Perhatikan bahwa jika indeks hilang dari file, itu
akan dibangun dengan cepat secara default, jadi Anda tidak perlu mengubahnya. Tapi itu mungkin
membantu dengan beberapa file yang rusak.

kegagalan
gunakan indeks jika file memilikinya, atau buat jika tidak ada

menciptakan
jangan membaca atau menggunakan indeks file

CATATAN:
Opsi ini hanya berfungsi jika media yang mendasari mendukung pencarian (yaitu tidak dengan
stdin, pipa, dll).

--load-unsafe-playlist
Muat URL dari daftar putar yang dianggap tidak aman (default: tidak). Ini termasuk
protokol khusus dan apa pun yang tidak merujuk ke file normal. File lokal dan
Tautan HTTP di sisi lain selalu dianggap aman.

Perhatikan bahwa --daftar putar selalu memuat semua entri, jadi Anda menggunakannya sebagai gantinya jika Anda
benar-benar membutuhkan fungsi ini.

--loop-file=
Ulangi satu file N kali. inf berarti selamanya, tidak berarti pemutaran normal. Untuk
kesesuaian, --loop-file dan --loop-file=ya juga diterima, dan sama
as --loop-file=inf.

Perbedaannya dengan --lingkaran adalah bahwa ini tidak mengulang daftar putar, hanya file
diri. Jika daftar putar hanya berisi satu file, perbedaan di antara keduanya
opsinya adalah opsi ini melakukan pencarian pada loop, alih-alih memuat ulang file.

--ab-loop-a= , --ab-loop-b=
Tetapkan titik lingkaran. Jika pemutaran melewati b stempel waktu, itu akan mencari ke a
stempel waktu. Mencari melewati b titik tidak berulang (ini disengaja). NS
loop-point dapat disesuaikan saat runtime dengan properti yang sesuai. Lihat juga
ab_loop perintah.

--memerintahkan-bab, --no-ordered-chapter
Diaktifkan secara default. Nonaktifkan dukungan untuk bab yang dipesan Matroska. mpv tidak akan
memuat atau mencari segmen video dari file lain, dan juga akan mengabaikan apa pun
urutan bab yang ditentukan untuk file utama.

--ordered-chapters-files=
Memuat file yang diberikan sebagai daftar putar, dan mencoba menggunakan file yang ada di dalamnya sebagai
file referensi saat membuka file Matroska yang menggunakan bab berurutan. Ini
mengesampingkan mekanisme normal untuk memuat file yang direferensikan dengan memindai yang sama
direktori tempat file utama berada.

Berguna untuk memuat file bab yang dipesan yang tidak terletak di lokal
sistem file, atau jika file yang direferensikan berada di direktori yang berbeda.

Catatan: daftar putar bisa sesederhana file teks yang berisi nama file yang dipisahkan oleh
baris baru.

--bab-file=
Muat bab dari file ini, alih-alih menggunakan metadata bab yang ditemukan di
berkas utama.

--langkah=
Melewati detik setelah setiap frame.

CATATAN:
Tanpa --jam-mencari, melewatkan akan snap ke keyframes.

--stop-playback-on-init-failure=
Hentikan pemutaran jika audio atau video gagal diinisialisasi. Saat ini, default
perilaku tidak untuk pemain baris perintah, tapi iya nih untuk libmpv. Dengan tidak, pemutaran
akan melanjutkan dalam mode video-only atau audio-only jika salah satunya gagal. Ini tidak
mempengaruhi pemutaran file audio saja atau video saja.

program Tingkah laku
--membantu Tampilkan ringkasan singkat opsi.

-v Tingkatkan tingkat verbositas, satu tingkat untuk masing-masing -v ditemukan di baris perintah.

--Versi: kapan, -V
Cetak string versi dan keluar.

--tanpa-konfigurasi
Jangan memuat file konfigurasi default. Ini mencegah pemuatan kedua
tingkat pengguna dan seluruh sistem mpv.conf dan masukan.conf file. File konfigurasi lainnya
juga diblokir, seperti melanjutkan file pemutaran.

CATATAN:
File secara eksplisit diminta oleh opsi baris perintah, seperti --termasuk or
--gunakan-filedir-conf, masih akan dimuat.

Juga lihat --config-dir.

--daftar-opsi
Mencetak semua opsi yang tersedia.

--daftar-properti
Cetak daftar properti yang tersedia.

--daftar-protokol
Cetak daftar protokol yang didukung.

--log-file=
Membuka jalur yang diberikan untuk menulis, dan mencetak pesan log ke sana. File yang ada akan
dipotong. Level log selalu sesuai dengan -v, terlepas dari terminal
tingkat verbositas.

--config-dir=
Paksa direktori konfigurasi yang berbeda. Jika ini diatur, direktori yang diberikan adalah
digunakan untuk memuat file konfigurasi, dan semua direktori konfigurasi lainnya adalah
diabaikan. Ini berarti direktori konfigurasi mpv global serta per-pengguna
direktori diabaikan, dan ditimpa melalui variabel lingkungan (MPV_HOME) adalah
juga diabaikan.

Perhatikan bahwa --tanpa-konfigurasi opsi lebih diutamakan daripada opsi ini.

--simpan-posisi-saat-berhenti
Selalu simpan posisi pemutaran saat ini saat berhenti. Ketika file ini diputar lagi
nanti, pemain akan mencari ke posisi pemutaran lama di awal. Ini tidak
terjadi jika pemutaran file dihentikan dengan cara lain selain berhenti. Untuk
misalnya, pergi ke file berikutnya dalam daftar putar tidak akan menyimpan posisi, dan
mulai pemutaran di awal saat berikutnya file diputar.

Perilaku ini dinonaktifkan secara default, tetapi selalu tersedia saat keluar dari
pemain dengan Shift+Q.

--dump-stats=
Tulis statistik tertentu ke file yang diberikan. File terpotong saat dibuka. NS
file akan berisi sampel mentah, masing-masing dengan stempel waktu. Untuk membuat file ini menjadi
bisa dibaca, scriptnya ALAT/stats-conv.py dapat digunakan (yang saat ini menampilkannya
sebagai grafik).

Opsi ini hanya berguna untuk debugging.

--menganggur=
Membuat mpv menunggu diam alih-alih berhenti ketika tidak ada file untuk diputar. Kebanyakan
berguna dalam mode budak, di mana mpv dapat dikontrol melalui perintah input.

sekali hanya akan menganggur di awal dan membiarkan pemain menutup setelah daftar putar pertama memiliki
selesai diputar kembali.

--termasuk=
Tentukan file konfigurasi yang akan diuraikan setelah yang default.

--load-scripts=
Jika diatur ke tidak, jangan memuat skrip secara otomatis dari script subdirektori konfigurasi
(Biasanya ~/.config/mpv/scripts/). (Bawaan: iya nih)

--script=
Muat skrip Lua. Anda dapat memuat beberapa skrip dengan memisahkannya dengan koma
(,).

--script-opts=key1=nilai1,key2=nilai2,...
Setel opsi untuk skrip. Skrip dapat meminta opsi dengan kunci. Jika opsi digunakan
dan semantik apa yang dimiliki nilai opsi sepenuhnya bergantung pada skrip yang dimuat.
Nilai yang tidak diklaim oleh skrip apa pun akan diabaikan.

--merge-file
Berpura-pura bahwa semua file yang diteruskan ke mpv digabungkan menjadi satu file besar. Ini
menggunakan dukungan timeline/EDL secara internal. Perhatikan bahwa ini tidak akan berfungsi untuk bab yang dipesan
file.

--tidak-melanjutkan-pemutaran
Jangan kembalikan posisi pemutaran dari Lihat nanti subdirektori konfigurasi
(Biasanya ~/.config/mpv/watch_later/). Lihat berhenti_watch_later perintah masukan.

--profil=
Gunakan profil yang diberikan, --profil=bantuan menampilkan daftar profil yang ditentukan.

--reset-on-berikutnya-file=
Biasanya, mpv akan mencoba menyimpan semua pengaturan saat memutar file berikutnya di
daftar putar, meskipun diubah oleh pengguna selama pemutaran. (Perilaku ini adalah
kebalikan dari MPlayer, yang mencoba mengatur ulang semua pengaturan saat memulai berikutnya
mengajukan.)

Default: Jangan mengatur ulang apa pun.

Ini dapat diubah dengan opsi ini. Ia menerima daftar opsi, dan mpv akan
mengatur ulang nilai opsi ini pada pemutaran mulai ke nilai awal. NS
nilai awal adalah nilai default, atau seperti yang ditetapkan oleh file konfigurasi atau perintah
line.

Dalam beberapa kasus, ini mungkin tidak berfungsi seperti yang diharapkan. Sebagai contoh, --volume hanya akan
reset jika secara eksplisit diatur dalam file konfigurasi atau baris perintah.

Nama khusus semua me-reset pilihan sebanyak mungkin.

contoh

· --reset-on-next-file=jeda Setel ulang mode jeda saat beralih ke file berikutnya.

· --reset-on-next-file=layar penuh,kecepatan Setel ulang layar penuh dan kecepatan pemutaran
pengaturan jika diubah selama pemutaran.

· --reset-pada-berkas-berikutnya=semua Coba atur ulang semua pengaturan yang diubah selama
pemutaran.

--write-filename-in-watch-latan-config
Tambahkan file konfigurasi arloji nanti dengan nama file yang dirujuk. Ini
hanya ditulis sebagai komentar di bagian atas file.

PERINGATAN:
Opsi ini dapat mengekspos informasi sensitif privasi dan karenanya dinonaktifkan oleh
standar.

--abaikan-jalur-di-tonton-nanti-config
Abaikan jalur (yaitu hanya menggunakan nama file) saat menggunakan fitur tonton nanti.

--tampilkan-profil=
Menampilkan deskripsi dan konten profil.

--gunakan-filedir-conf
Cari file konfigurasi khusus file di direktori yang sama dengan file yang
sedang dimainkan. Lihat Khusus file konfigurasi File.

PERINGATAN:
Mungkin berbahaya jika diputar dari media yang tidak tepercaya.

--ytdl, --tidak-ytdl
Aktifkan skrip kait youtube-dl. Ini akan melihat URL input, dan akan memainkan
video yang terletak di situs web. Ini berfungsi dengan banyak situs streaming, bukan hanya
salah satu skrip yang dinamai. Ini membutuhkan versi terbaru dari youtube-dl untuk
akan diinstal pada sistem. (Diaktifkan secara default, kecuali saat API klien /
libmpv digunakan.)

Jika skrip tidak dapat melakukan apa pun dengan URL, skrip tidak akan melakukan apa pun.

--ytdl-format=
Format/kualitas video yang langsung diteruskan ke youtube-dl. Nilai yang mungkin adalah
khusus untuk situs web dan video, untuk url tertentu format yang tersedia dapat
ditemukan dengan perintah youtube-dl --daftar-format URL. Lihat youtube-dl's
dokumentasi untuk alias yang tersedia. (Default: default youtube-dl, saat ini
video+bestaudio/terbaik)

--ytdl-raw-options= = [, = [,...]]
Berikan opsi arbitrer ke youtube-dl. Parameter dan argumen harus diteruskan sebagai
pasangan nilai kunci. Opsi tanpa argumen harus menyertakan =.

Tidak ada pemeriksaan kewarasan sehingga mungkin merusak barang (yaitu lulus tidak valid
parameter ke youtube-dl).

Example

--ytdl-raw-options=namapengguna=pengguna,kata sandi=lulus
--ytdl-raw-options=paksa-ipv6=

Video
--vo=
Tentukan daftar prioritas driver output video yang akan digunakan. Untuk penggunaan interaktif,
seseorang biasanya akan menentukan satu untuk digunakan, tetapi dalam file konfigurasi,
menentukan daftar fallback mungkin masuk akal. Lihat VIDEO KELUARAN DRIVERS untuk rincian
dan deskripsi driver yang tersedia.

--vd=<[+|-]family1:(*|decoder1),[+|-]family2:(*|decoder2),...[-]>
Tentukan daftar prioritas decoder video yang akan digunakan, menurut keluarganya dan
nama. Lihat --iklan untuk rincian lebih lanjut. Kedua opsi ini menggunakan sintaks yang sama dan
semantik; satu-satunya perbedaan adalah bahwa mereka beroperasi pada daftar codec yang berbeda.

CATATAN:
Lihat --vd=bantuan untuk daftar lengkap decoder yang tersedia.

--vf=
Tentukan daftar filter video untuk diterapkan ke aliran video. Lihat VIDEO FILTER untuk
detail dan deskripsi filter yang tersedia. Varian pilihan --vf-tambahkan,
--vf-pra, --vf-del dan --vf-clr ada untuk mengubah daftar yang ditentukan sebelumnya, tetapi
Anda tidak perlu ini untuk penggunaan biasa.

--tanpa-video
Jangan memutar video. Dengan beberapa demuxer ini mungkin tidak berfungsi. Dalam kasus itu, Anda dapat mencoba
--vo=batal sebagai gantinya.

mpv akan mencoba mengunduh audio hanya jika media dialirkan dengan youtube-dl,
karena menghemat bandwidth. Ini dilakukan dengan menyetel ytdl_format ke
"bestaudio/best" dalam skrip ytdl_hook.lua.

--belum waktunya
Jangan tidur saat mengeluarkan bingkai video. Berguna untuk tolok ukur saat digunakan dengan
--tidak ada suara.

--framedrop=
Lewati menampilkan beberapa bingkai untuk mempertahankan sinkronisasi A/V pada sistem yang lambat, atau memutar tinggi
framerate video pada output video yang memiliki batas framerate atas.

Argumen memilih metode drop, dan dapat berupa salah satu dari berikut ini:

Nonaktifkan setiap framedrop.

Jatuhkan frame terlambat pada output video (default). Ini masih menerjemahkan dan memfilter
semua frame, tetapi tidak merendernya di VO. Ia mencoba untuk menanyakan tampilan
FPS (X11 saja, tidak benar pada sistem multi-monitor), atau mengasumsikan tak terbatas
tampilkan FPS jika gagal. Penurunan ditunjukkan di baris status terminal
as D: bidang. Jika decoder terlalu lambat, secara teori semua frame harus
dijatuhkan (karena semua frame terlambat) - untuk menghindari ini, frame jatuh
berhenti jika framerate efektif di bawah 10 FPS.


Mode framedrop lama berbasis dekoder. (Ini sama dengan --framedrop=ya in
mpv 0.5.x dan sebelumnya.) Ini memberitahu decoder untuk melewati frame (kecuali jika mereka
diperlukan untuk memecahkan kode frame masa depan). Dapat membantu dengan sistem yang lambat, tetapi dapat
menghasilkan output berombak yang tidak dapat ditonton, atau bahkan membekukan tampilan sepenuhnya.
Tidak direkomendasikan. NS --vd-lavc-framedrop opsi mengontrol bingkai apa yang akan
penurunan.


Aktifkan kedua mode. Tidak direkomendasikan.

CATATAN:
--vo=vdpau memiliki kode sendiri untuk vo mode penurunan bingkai. Sedikit perbedaan untuk
VO lainnya dimungkinkan.

--display-fps=
Atur tampilan FPS yang digunakan dengan --video-sync=tampilan-* mode. Secara default
nilai yang terdeteksi digunakan (hanya X11, tidak benar pada sistem multi-monitor). Tetap
ingat bahwa menyetel nilai yang salah (meskipun sedikit salah) dapat merusak video
pemutaran.

--hwdec=
Tentukan API decoding video perangkat keras yang harus digunakan jika memungkinkan. Apakah
decoding perangkat keras sebenarnya dilakukan tergantung pada codec video. Jika decoding perangkat keras
tidak mungkin, mpv akan kembali pada decoding perangkat lunak.

dapat berupa salah satu dari berikut ini:

tidak selalu gunakan software decoding (default)

mobil lihat di bawah

vdpau membutuhkan --vo=vdpau or --vo=terbuka (Linux saja)

vaapi membutuhkan --vo=terbuka or --vo=vaapi (Linux saja)

salinan vaapi
menyalin video kembali ke RAM sistem (Linux dengan GPU Intel saja)

kotak alat video
membutuhkan --vo=terbuka (hanya OS X 10.8 dan yang lebih baru)

salinan dxva2
menyalin video kembali ke RAM sistem (hanya Windows)

rpi membutuhkan --vo=rpi (Hanya Raspberry Pi - default jika tersedia)

mobil mencoba untuk secara otomatis mengaktifkan decoding perangkat keras menggunakan yang pertama tersedia
metode. Ini masih tergantung VO apa yang Anda gunakan. Misalnya, jika Anda tidak menggunakan
--vo=vdpau or --vo=terbuka, decoding vdpau tidak akan pernah diaktifkan. Perhatikan juga bahwa jika
metode yang ditemukan pertama tidak benar-benar berfungsi, itu akan selalu kembali ke perangkat lunak
decoding, daripada mencoba metode berikutnya (mungkin penting pada beberapa sistem Linux).

vaapi mode, jika digunakan dengan --vo=terbuka, membutuhkan Mesa 11 dan kemungkinan besar berfungsi
dengan GPU Intel saja. Ini juga membutuhkan backend opengl EGL (digunakan secara otomatis
jika tersedia). Anda juga dapat mencoba backend GLX lama dengan memaksanya dengan
--vo=opengl:ujung belakang=x11, tetapi interop vaapi/GLX dikatakan lebih lambat dari
salinan vaapi.

salinan vaapi mode memungkinkan Anda menggunakan vaapi dengan VO apa pun. Karena ini menyalin
video yang didekodekan kembali ke RAM sistem, kemungkinan kurang efisien daripada vaapi mode.

CATATAN:
Saat menggunakan sakelar ini, decoding perangkat keras masih hanya dilakukan untuk beberapa codec.
Lihat --hwdec-codec untuk mengaktifkan decoding perangkat keras untuk lebih banyak codec.

--hwdec-preload=
Ini berguna untuk terbuka dan opengl-cb VO untuk membuat decoding perangkat keras
Konteks interop OpenGL, tetapi tanpa benar-benar mengaktifkan decoding perangkat keras itu sendiri
(seperti --hwdec melakukan).

Jika diatur ke tidak (default), --hwdec opsi digunakan.

Untuk terbuka, jika disetel, jangan buat konteks interop sesuai permintaan, tetapi saat VO
dibuat.

Untuk opengl-cb, jika disetel, muat konteks interop segera setelah konteks OpenGL
dibuat. Sejak opengl-cb tidak memiliki pemuatan sesuai permintaan, ini memungkinkan pengaktifan perangkat keras
decoding saat runtime sama sekali, tanpa harus mengatur sementara hwdec Option
hanya selama inisialisasi konteks OpenGL dengan mpv_opengl_cb_init_gl().

--videotoolbox-format=
Atur format piksel internal yang digunakan oleh --hwdec=kotakalatvideo di OSX. Pilihan dari
format dapat sangat mempengaruhi kinerja. Di sisi lain, tidak ada
tampaknya menjadi cara yang baik untuk mendeteksi format terbaik untuk perangkat keras yang diberikan. nv12, yang
default, bekerja lebih baik pada perangkat keras modern, sementara uyvy422 tampaknya lebih baik untuk
perangkat keras lama. rgb0 juga bekerja.

--panscan=<0.0-1.0>
Mengaktifkan fungsi pan-and-scan (memotong sisi misalnya video 16:9 untuk membuat
cocok dengan layar 4:3 tanpa pita hitam). Rentang mengontrol seberapa banyak gambar
dipotong. Mungkin tidak bekerja dengan semua driver output video.

--aspek-video=
Ganti rasio aspek video, jika informasi aspek salah atau hilang dalam
file yang sedang diputar. Lihat juga --tanpa-aspek-video.

Dua nilai memiliki arti khusus:

0 nonaktifkan penanganan rasio aspek, anggap video memiliki piksel persegi

-1 gunakan aliran video atau aspek penampung (default)

Namun perhatikan bahwa penanganan nilai khusus ini mungkin berubah di masa mendatang.

contoh

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

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

--tanpa-aspek-video
Abaikan informasi rasio aspek dari file video dan anggap video memiliki persegi
piksel. Lihat juga --aspek-video.

--video-aspek-metode=
Ini menetapkan metode penentuan aspek video default (jika aspeknya _not_
ditimpa oleh pengguna dengan --aspek-video atau lainnya).

hibrida Lebih suka rasio aspek penampung. Jika aspek bitstream beralih
mid-stream, alihkan ke preferensi aspek bitstream. Ini defaultnya
perilaku di mpv dan mplayer2.

wadah
Lebih suka rasio aspek wadah. Ini rupanya default
perilaku dengan VLC, setidaknya dengan Matroska.

aliran bit
Lebih suka rasio aspek bitstream, kecuali aspek bitstream
rasio tidak diatur. Ini tampaknya merupakan perilaku default dengan XBMC/kodi, di
setidaknya dengan Matroska.

Biasanya Anda tidak harus mengatur ini. Coba wadah dan aliran bit pilihan jika Anda
menemukan video yang memiliki rasio aspek yang salah dalam mpv, tetapi tampaknya benar dalam
pemain lain.

--video-tidak diskalakan
Nonaktifkan penskalaan video. Jika jendela lebih besar dari video, bilah hitam
sudah ditambahkan. Jika tidak, video akan terpotong. Video masih dapat dipengaruhi oleh
yang lain --video-... pilihan. (Tapi tidak semua; misalnya --video-zoom tidak melakukan apa-apa
jika opsi ini diaktifkan.)

Aspek aspek video dan monitor akan diabaikan. Koreksi aspek akan
perlu menskalakan video ke arah X atau Y, tetapi opsi ini dinonaktifkan
penskalaan, menonaktifkan semua koreksi aspek.

Perhatikan bahwa algoritme penskala masih dapat digunakan, meskipun video tidak diskalakan.
Misalnya, ini dapat memengaruhi konversi kroma.

Opsi ini dinonaktifkan jika --tidak-jaga-jaga opsi digunakan.

--video-pan-x= , --video-pan-y=
Memindahkan persegi panjang video yang ditampilkan dengan nilai yang diberikan dalam arah X atau Y. Itu
unit dalam pecahan dari ukuran video yang diskalakan (ukuran penuh, bahkan jika bagian
video tidak terlihat karena panscan atau opsi lain).

Misalnya, menampilkan layar penuh video 1280x720 pada layar 1680x1050 dengan
--video-pan-x=-0.1 akan memindahkan video 168 piksel ke kiri (membuat 128 piksel
dari video sumber tidak terlihat).

Opsi ini dinonaktifkan jika --tidak-jaga-jaga opsi digunakan.

--video-rotate=<0-360|tidak>
Putar video searah jarum jam, dalam derajat. Saat ini hanya mendukung langkah 90 °. Jika tidak
diberikan, video tidak pernah diputar, bahkan jika file memiliki metadata rotasi. (Itu
nilai rotasi ditambahkan ke metadata rotasi, yang berarti nilai 0 akan
putar video sesuai dengan metadata rotasi.)

--video-stereo-mode=
Atur mode keluaran 3D stereo (default: mono). Ini dilakukan dengan memasukkan
stereo3d filter konversi.

Mode semu tidak menonaktifkan konversi otomatis sepenuhnya.

Modusnya mono adalah alias untuk ml, yang mengacu pada bingkai kiri dalam 2D. Ini adalah
default, yang berarti mpv akan mencoba menampilkan film 3D dalam 2D, bukan yang rusak
Gambar 3D tidak dimaksudkan untuk konsumsi (seperti menampilkan bingkai kiri dan kanan
berdampingan, dll).

penggunaan --video-stereo-mode=bantuan untuk membuat daftar semua mode yang tersedia. Periksa dengan stereo3d
filter dokumentasi untuk melihat apa arti nama-nama itu. Perhatikan bahwa beberapa nama merujuk ke
mode tidak didukung oleh stereo3d - mode ini dapat muncul di file, tetapi tidak bisa
ditangani dengan benar oleh mpv.

--video-zoom=
Sesuaikan faktor skala tampilan video dengan nilai yang diberikan. Satuannya dalam pecahan
dari ukuran video jendela (skala).

Misalnya, diberikan video 1280x720 yang ditampilkan di jendela 1280x720, --zoom-video=-0.1
akan membuat video sebesar 128 piksel lebih kecil dalam arah X, dan 72 piksel dalam Y
arah.

Opsi ini dinonaktifkan jika --tidak-jaga-jaga opsi digunakan.

--video-align-x=<-1-1>, --video-align-y=<-1-1>
Memindahkan persegi panjang video di dalam batas hitam, yang biasanya ditambahkan ke pad
video ke layar jika rasio aspek video dan layar berbeda.
--video-align-y=-1 akan memindahkan video ke bagian atas layar (meninggalkan batas
hanya di bagian bawah), nilai 0 memusatkannya (default), dan nilai 1 akan menempatkan
video di bagian bawah layar.

Jika aspek video dan layar sangat cocok, opsi ini tidak melakukan apa pun.

Opsi ini dinonaktifkan jika --tidak-jaga-jaga opsi digunakan.

--benar-poin, --tidak-benar-pts
--tidak-benar-pts mengalihkan mpv ke mode di mana waktu video ditentukan menggunakan a
nilai framerate tetap (baik menggunakan --fps pilihan, atau menggunakan informasi file).
Terkadang, file dengan stempel waktu yang sangat rusak dapat diputar dengan baik di sini
mode. Perhatikan bahwa filter video, rendering subtitle, dan sinkronisasi audio dapat
benar-benar rusak dalam mode ini.

--fps=
Ganti frekuensi gambar video. Berguna jika nilai aslinya salah atau hilang.

CATATAN:
Bekerja dalam --tidak-benar-pts modus saja.

--deinterlace=
Mengaktifkan atau menonaktifkan interlacing (default: auto, yang biasanya berarti tidak). terjalin
video menunjukkan artefak seperti sisir jelek, yang terlihat pada gerakan cepat. Mengaktifkan
ini biasanya memasukkan filter video yadif untuk memisahkan video, atau
memungkinkan output video menerapkan deinterlacing jika didukung.

Ini berperilaku persis seperti deinterlace properti input (biasanya dipetakan ke d).

mobil adalah teknis. Sebenarnya, default untuk opsi ini adalah
deinterlacing dinonaktifkan, tetapi mobil kasus diperlukan jika yadif telah ditambahkan ke
rantai filter secara manual dengan --vf. Maka inti seharusnya tidak menonaktifkan deinterlacing saja
karena --deinterlace tidak diatur.

--dominan-bidang=
Tetapkan bidang pertama untuk konten interlaced. Berguna untuk deinterlacer yang menggandakan
kecepatan bingkai: --vf=yadif=bidang dan --vo=vdpau:deint.

mobil (default) Jika decoder tidak mengekspor informasi yang sesuai, itu
jatuh kembali puncak (bidang atas terlebih dahulu).

puncak lapangan atas dulu

dasar bidang bawah dulu

CATATAN:
Pengaturan baik puncak or dasar akan menandai semua frame sebagai interlaced.

--frame=
Mainkan/konversi hanya terlebih dahulu bingkai video, lalu keluar.

--frame=0 memuat file, tetapi segera berhenti sebelum memulai pemutaran.
(Mungkin berguna untuk skrip yang hanya ingin menentukan beberapa properti file.)

Untuk pemutaran hanya audio, nilai apa pun yang lebih besar dari 0 akan segera keluar dari pemutaran
setelah inisialisasi. Nilai 0 berfungsi seperti video.

--video-output-level=
Tingkat warna RGB digunakan dengan konversi YUV ke RGB. Biasanya, perangkat keluaran seperti
Monitor PC menggunakan tingkat warna rentang penuh. Namun, beberapa TV dan monitor video
mengharapkan tingkat RGB studio. Memberikan output jangkauan penuh ke perangkat yang mengharapkan studio
input level menghasilkan hitam dan putih yang hancur, kebalikannya dalam hitam abu-abu redup
dan putih redup.

Tidak semua VO mendukung opsi ini. Beberapa diam-diam akan mengabaikannya.

Rentang warna yang tersedia adalah:

mobil pemilihan otomatis (sama dengan rentang penuh) (default)

terbatas
jangkauan terbatas (16-235 per komponen), tingkat studio

penuh jangkauan penuh (0-255 per komponen), level PC

CATATAN:
Sebaiknya gunakan opsi rentang warna driver grafis Anda, jika
tersedia.

--hwdec-codec=
Izinkan decoding perangkat keras hanya untuk daftar codec tertentu. Nilai khusus semua
selalu memungkinkan semua codec.

Anda bisa mendapatkan daftar codec yang diizinkan dengan mpv --vd=bantuan. Hapus awalan, mis
alih-alih lavc:h264 menggunakan h264.

Secara default ini diatur ke h264,vc1,wmv3,hevc,mpeg2video. Perhatikan bahwa perangkat keras
akselerasi codec khusus seperti h264_vdpau tidak relevan lagi, dan pada kenyataannya
telah dihapus dari Libav dalam formulir ini.

Ini biasanya hanya diperlukan dengan GPU yang rusak, di mana codec dilaporkan sebagai
didukung, tetapi decoding menyebabkan lebih banyak masalah daripada yang dipecahkan.

Example

mpv --hwdec=vdpau --vo=vdpau --hwdec-codec=h264,mpeg2video
Aktifkan decoding vdpau hanya untuk h264 dan mpeg2.

--vd-lavc-check-hw-profile=
Periksa profil dekoder perangkat keras (default: ya). Jika tidak diatur, profil tertinggi dari
dekoder perangkat keras dipilih tanpa syarat, dan decoding dipaksa bahkan jika
profil video lebih tinggi dari itu. Hasilnya kemungkinan besar rusak
decoding, tetapi juga dapat membantu jika profil yang terdeteksi atau dilaporkan entah bagaimana
salah.

--vd-lavc-software-fallback=
Kembali ke decoding perangkat lunak jika dekoder yang dipercepat perangkat keras gagal (default:
3). Jika ini adalah angka, maka mundur akan dipicu jika N frame gagal untuk memecahkan kode
berturut-turut. 1 sama dengan iya nih.

--vd-lavc-bitexact
Hanya gunakan algoritma bit-exact di semua langkah decoding (untuk pengujian codec).

--vd-lavc-cepat (MPEG-2, MPEG-4, dan H.264 saja)
Aktifkan pengoptimalan yang tidak sesuai dengan spesifikasi format dan
berpotensi menyebabkan masalah, seperti dekuantisasi yang lebih sederhana, gerakan yang lebih sederhana
kompensasi, dengan asumsi penggunaan matriks kuantisasi default, dengan asumsi YUV 4:2:0
dan melewatkan beberapa pemeriksaan untuk mendeteksi bitstream yang rusak.

--vd-lavc-o= = [, = [,...]]
Berikan AVOptions ke dekoder libavcodec. Catatan, tambalan untuk membuat o= tidak dibutuhkan dan
melewati semua opsi yang tidak diketahui melalui sistem AVOption dipersilakan. Daftar lengkap
AVOptions dapat ditemukan di manual FFmpeg.

Beberapa opsi yang dulunya merupakan opsi langsung dapat diatur dengan mekanisme ini, seperti
kesalahan, abu-abu, idct, ec, vismev, lewati_top (dulu st), lewati_bawah (dulu sb), men-debug.

Example

--vd-lavc-o=debug=gambar

--vd-lavc-show-all=
Tampilkan bahkan bingkai yang rusak/rusak (default: tidak). Jika opsi ini disetel ke tidak,
libavcodec tidak akan menampilkan bingkai yang didekodekan sebelum bingkai utama awal
didekodekan, atau bingkai yang dikenali sebagai rusak.

--vd-lavc-skiploopfilter= (H.264 saja)
Melewati loop filter (AKA deblocking) selama decoding H.264. Sejak difilter
frame seharusnya digunakan sebagai referensi untuk decoding frame dependen, ini memiliki
efek yang lebih buruk pada kualitas daripada tidak melakukan deblocking pada misalnya video MPEG-2. Tapi di
setidaknya untuk HDTV bitrate tinggi, ini memberikan percepatan besar dengan sedikit terlihat
kehilangan kualitas.

dapat berupa salah satu dari berikut ini:

tak satupun Jangan pernah lewati.

kegagalan
Lewati langkah-langkah pemrosesan yang tidak berguna (misalnya, paket ukuran 0 dalam AVI).

nonref Lewati frame yang tidak direferensikan (yaitu tidak digunakan untuk decoding lainnya
frame, kesalahan tidak dapat "membangun").

bidir Lewati B-Frame.

bukan kunci Lewati semua bingkai kecuali bingkai utama.

semua Lewati semua bingkai.

--vd-lavc-skipidct= (MPEG-1/2 saja)
Melewati langkah IDCT. Ini sangat menurunkan kualitas di hampir semua kasus (lihat
skiploopfilter untuk nilai lewati yang tersedia).

--vd-lavc-skipframe=
Melewati decoding frame sepenuhnya. Percepatan besar, tetapi gerakan tersentak-sentak dan terkadang
artefak buruk (lihat skiploopfilter untuk nilai lewati yang tersedia).

--vd-lavc-framedrop=
Setel mode penurunan bingkai yang digunakan dengan --bingkaijatuh (lihat skiploopfilter untuk melewatkan yang tersedia
nilai).

--vd-lavc-utas=
Jumlah utas yang digunakan untuk decoding. Apakah threading benar-benar didukung
tergantung pada codec (default: 0). 0 berarti otomatis mendeteksi jumlah inti pada mesin
dan gunakan itu, hingga maksimum 16. Anda dapat mengatur lebih dari 16 utas secara manual.

Audio
--audio-pitch-correction=
Jika ini diaktifkan (default), bermain dengan kecepatan yang berbeda dari biasanya
secara otomatis memasukkan skalatempo penyaring suara. Untuk detailnya, lihat filter audio
bagian.

--audio-perangkat=
Gunakan perangkat audio yang diberikan. Ini terdiri dari nama output audio, misalnya: juga,
diikuti oleh /, diikuti dengan nama perangkat khusus keluaran audio.

Anda dapat membuat daftar perangkat audio dengan --audio-device=bantuan. Ini menampilkan nama perangkat
dalam tanda kutip, diikuti dengan deskripsi. Nama perangkat adalah apa yang harus Anda lewati
itu --perangkat audio .

Nilai default untuk opsi ini adalah mobil, yang mencoba setiap output audio masuk
urutan preferensi dengan perangkat default.

Perhatikan bahwa banyak AO memiliki alat sub-opsi, yang mengesampingkan pemilihan perangkat
pilihan ini (tetapi bukan pilihan output audio). Demikian juga, memaksa AO dengan
--ao akan menimpa pilihan output audio dari --perangkat audio (tapi bukan perangkatnya
pilihan).

Saat ini tidak diterapkan untuk sebagian besar AO.

--audio-fallback-to-null=
Jika tidak ada perangkat audio yang dapat dibuka, bersikaplah seolah-olah --ao=batal diberikan. Ini berguna
dalam kombinasi dengan --perangkat audio: alih-alih menyebabkan kesalahan jika dipilih
perangkat tidak ada, pengguna API klien (atau skrip Lua) dapat membiarkan pemutaran
lanjutkan secara normal, dan periksa saat ini-ao dan audio-perangkat-daftar properti untuk
membuat keputusan tingkat tinggi tentang bagaimana melanjutkan.

--ao=
Tentukan daftar prioritas driver output audio yang akan digunakan. Untuk penggunaan interaktif satu
biasanya akan menentukan satu untuk digunakan, tetapi dalam file konfigurasi menentukan a
daftar fallback mungkin masuk akal. Melihat AUDIO KELUARAN DRIVERS untuk detail dan
deskripsi driver yang tersedia.

--af=
Tentukan daftar filter audio yang akan diterapkan ke aliran audio. Melihat AUDIO FILTER untuk
detail dan deskripsi filter yang tersedia. Varian pilihan --af-tambahkan,
--af-pra, --af-del dan --af-clr ada untuk mengubah daftar yang ditentukan sebelumnya, tetapi
Anda tidak perlu ini untuk penggunaan biasa.

--audio-spidif=
Daftar codec yang passthrough audio terkompresi harus digunakan. Ini bekerja
untuk S/PDIF dan HDMI klasik.

Codec yang mungkin adalah ac3, dts, dts-hd. Beberapa codec dapat ditentukan oleh
memisahkan mereka dengan ,. dts mengacu pada inti DTS bitrate rendah, sementara dts-hd mengacu pada
DTS MA (dukungan receiver dan OS bervariasi). Anda hanya harus menggunakan keduanya dts or dts-hd
(jika keduanya ditentukan, dan dts datang pertama, hanya dts akan digunakan).

Secara umum, semua codec di spdif keluarga terdaftar dengan --ad=bantuan didukung dalam
teori.

peringatan

Tidak ada banyak alasan untuk menggunakan ini. HDMI mendukung tidak terkompresi
PCM multichannel, dan mpv mendukung decoding DTS-HD lossless melalui FFmpeg's
pembungkus libdcadec.

--ad=<[+|-]family1:(*|decoder1),[+|-]family2:(*|decoder2),...[-]>
Tentukan daftar prioritas dekoder audio yang akan digunakan, menurut keluarganya dan
nama dekoder. Entri seperti keluarga:* memprioritaskan semua decoder dari keluarga yang diberikan.
Saat menentukan dekoder mana yang akan digunakan, dekoder pertama yang cocok dengan audio
format dipilih. Jika itu tidak tersedia, decoder berikutnya digunakan. Akhirnya, itu
mencoba semua dekoder lain yang tidak dipilih atau ditolak secara eksplisit oleh
.

- di akhir daftar menekan mundur pada dekoder lain yang tersedia tidak pada
--iklan daftar. + di depan sebuah entri memaksa decoder. Keduanya tidak boleh
biasanya digunakan, karena mereka merusak pemilihan otomatis dekoder normal!

- di depan entri menonaktifkan pemilihan dekoder.

contoh

--iklan=lavc:mp3float
Lebih suka FFmpeg/Libav mp3mengambang decoder atas semua decoder MP3 lainnya.

--ad=spidif:ac3,lavc:*
Selalu lebih suka spdif AC3 daripada FFmpeg/Libav daripada yang lainnya.

--ad=bantuan
Daftar semua decoder yang tersedia.

peringatan

Mengaktifkan passthrough audio terkompresi (AC3 dan DTS melalui SPDIF/HDMI) dengan
opsi ini tidak digunakan lagi. Menggunakan --audio-spdif sebagai gantinya.

--volume=
Atur volume startup. 0 berarti diam, 100 berarti tidak ada pengurangan volume atau
amplifikasi. Nilai -1 (default) tidak akan mengubah volume. Lihat juga
--softvol.

CATATAN:
Ini diubah setelah rilis mpv 0.9. Sebelum itu, 100 sebenarnya berarti
volume maksimum. Pada saat yang sama, skala volume dibuat kubik, jadi yang lama
nilai tidak akan cocok dengan yang baru.

--audio-delay=
Penundaan audio dalam hitungan detik (nilai float positif atau negatif). Penundaan nilai positif
audio, dan nilai negatif menunda video.

--tidak ada suara
Jangan memutar suara.

--bisu=
Setel status bisu audio startup. mobil (default) tidak akan mengubah status mute. Juga
melihat --volume.

--softvol=
Kontrol apakah akan menggunakan kontrol volume driver output audio atau
filter volume mpv internal.

tidak lebih suka kontrol driver audio, gunakan filter volume hanya jika benar-benar
dibutuhkan

iya nih selalu gunakan filter volume

mobil lebih suka filter volume jika driver audio menggunakan mixer sistem (default)

Maksud dari mobil adalah untuk menghindari perubahan pengaturan mixer sistem dari dalam mpv
dengan pengaturan default. mpv adalah pemutar video, bukan panel mixer. Di sisi lain
tangan, kontrol mixer diaktifkan untuk server suara seperti PulseAudio, yang menyediakan
volume per aplikasi.

--audio-demuxer=<[+]nama>
Gunakan jenis demuxer audio ini saat menggunakan --file audio. Gunakan '+' sebelum nama untuk
paksa itu; ini akan melewatkan beberapa pemeriksaan. Berikan nama demuxer seperti yang dicetak oleh
--audio-demuxer=bantuan.

--ad-lavc-ac3drc=
Pilih tingkat Kompresi Rentang Dinamis untuk streaming audio AC-3. adalah
nilai float mulai dari 0 hingga 1, di mana 0 berarti tidak ada kompresi (yang merupakan
default) dan 1 berarti kompresi penuh (buat bagian yang keras lebih senyap dan sebaliknya
sebaliknya). Nilai hingga 6 juga diterima, tetapi murni eksperimental. Pilihan ini
hanya menunjukkan efek jika aliran AC-3 berisi kompresi rentang yang diperlukan
informasi.

Standar mengamanatkan bahwa DRC diaktifkan secara default, tetapi mpv (dan beberapa lainnya
player) abaikan ini demi kualitas audio yang lebih baik.

--ad-lavc-downmix=
Apakah akan meminta downmixing saluran audio dari dekoder (default: ya). Beberapa
decoder, seperti AC-3, AAC dan DTS, dapat me-remix audio pada decoding. Nomor yang diminta
saluran keluaran diatur dengan --saluran-audio pilihan. Berguna untuk bermain
surround audio pada sistem stereo.

--ad-lavc-threads=<0-16>
Jumlah utas yang digunakan untuk decoding. Apakah threading benar-benar didukung
tergantung pada codec. Pada tulisan ini, hanya didukung untuk beberapa codec lossless saja.
0 berarti otomatis mendeteksi jumlah inti pada mesin dan menggunakannya, hingga maksimum
dari 16 (default: 1).

--ad-lavc-o= = [, = [,...]]
Berikan AVOptions ke dekoder libavcodec. Catatan, tambalan untuk membuat o= tidak dibutuhkan dan
melewati semua opsi yang tidak diketahui melalui sistem AVOption dipersilakan. Daftar lengkap
AVOptions dapat ditemukan di manual FFmpeg.

--ad-spidif-dtshd= , --dtshd, --tidak-dtshd
Jika DTS dilewati, gunakan DTS-HD.

peringatan

Ini dan mengaktifkan passthrough melalui --iklan tidak digunakan lagi untuk digunakan
--audio-spidif=dts-hd.

--audio-channel=
Minta tata letak saluran untuk keluaran audio (default: otomatis). Ini akan meminta AO untuk
buka perangkat dengan tata letak saluran yang diberikan. Terserah AO untuk menerima ini
tata letak, atau untuk memilih mundur atau kesalahan jika tata letak yang diminta tidak
didukung.

--saluran-audio pilihan baik mengambil nomor saluran atau saluran eksplisit
tata letak. Nomor saluran mengacu pada tata letak default, misalnya 2 saluran mengacu pada stereo,
6 mengacu pada 5.1.

Lihat --audio-channels=bantuan output untuk layout default yang ditentukan. Ini juga mencantumkan
nama pembicara, yang dapat digunakan untuk mengekspresikan tata letak saluran arbitrer (mis
fl-fr-lfe adalah 2.1).

Standarnya adalah --audio-channels=otomatis, yang mencoba memutar audio menggunakan input
tata letak saluran file. (Atau lebih tepatnya, output dari rantai filter audio.)
(kosong adalah alias usang yang diterima untuk mobil.)

Ini juga akan meminta tata letak saluran dari dekoder. Jika decoder tidak
mendukung tata letak, itu akan kembali ke tata letak saluran aslinya. (Kamu dapat memakai
--ad-lavc-downmix=tidak untuk membuat dekoder selalu menampilkan tata letak aslinya.) Catatan
bahwa hanya beberapa decoder yang mendukung remixing audio. Beberapa yang termasuk AC-3, AAC atau
audio DTS.

Jika tata letak saluran file media (yaitu decoder) dan saluran AO
tata letak tidak cocok, mpv akan mencoba memasukkan filter konversi.

peringatan

Menggunakan mobil dapat menyebabkan masalah saat menggunakan audio melalui HDMI. OS akan
biasanya melaporkan semua tata letak saluran yang _dapat_ melalui HDMI, meskipun
penerima tidak mendukung mereka. Jika penerima mendapatkan saluran yang tidak didukung
tata letak, hal-hal acak dapat terjadi, seperti menjatuhkan tambahan
saluran, atau menambahkan kebisingan.

--audio-display=
Menyetel opsi ini ke lampiran (default) akan menampilkan lampiran gambar (mis
sampul album) saat memutar file audio. Ini akan menampilkan gambar pertama yang ditemukan,
dan gambar tambahan tersedia sebagai trek video.

Menyetel opsi ini ke tidak menonaktifkan tampilan video sepenuhnya saat memutar audio
file.

Opsi ini tidak berpengaruh pada file dengan trek video normal.

--audio-file=
Putar audio dari file eksternal saat melihat video. Setiap penggunaan opsi ini
akan menambahkan trek audio baru. Detailnya mirip dengan caranya --sub-berkas bekerja.

--format-audio=
Pilih format sampel yang digunakan untuk output dari lapisan filter audio ke suara
kartu. Nilai-nilai yang dapat mengadopsi tercantum di bawah ini dalam deskripsi
format penyaring suara.

--audio-samplerate=
Pilih tingkat sampel keluaran yang akan digunakan (tentu saja kartu suara memiliki batasan
ini). Jika frekuensi sampel yang dipilih berbeda dari frekuensi arus
media, filter audio lavrresample akan dimasukkan ke dalam lapisan filter audio
untuk mengkompensasi perbedaan.

--gapless-audio=
Cobalah untuk memutar file audio berturut-turut tanpa keheningan atau gangguan pada titik
perubahan berkas. Bawaan: lemah.

tidak Nonaktifkan audio tanpa celah.

iya nih Perangkat audio dibuka menggunakan parameter yang dipilih sesuai dengan yang pertama
file diputar dan kemudian tetap terbuka untuk pemutaran tanpa celah. Artinya jika
file pertama misalnya memiliki sample rate yang rendah, kemudian file berikut
dapat disampel ulang ke laju sampel rendah yang sama, menghasilkan suara yang berkurang
kualitas. Jika Anda memutar file dengan parameter berbeda, pertimbangkan untuk menggunakan opsi
seperti --audio-sampel dan --format-audio untuk secara eksplisit memilih apa
format output bersama akan.

lemah Biasanya, perangkat audio tetap terbuka (menggunakan format pertama)
diinisialisasi dengan). Jika format audio keluaran dekoder berubah, audio
perangkat ditutup dan dibuka kembali. Ini berarti bahwa Anda biasanya akan mendapatkan gapless
audio dengan file yang dikodekan menggunakan pengaturan yang sama, tetapi mungkin tidak
tanpa celah dalam kasus lain. (Tidak seperti dengan iya nih, Anda tidak perlu khawatir tentang
kasus sudut seperti file pertama yang mengatur format output berkualitas sangat rendah,
dan merusak pemutaran file berkualitas lebih tinggi yang mengikutinya.)

CATATAN:
Fitur ini diimplementasikan dengan cara yang sederhana dan bergantung pada perangkat output audio
buffering untuk melanjutkan pemutaran sambil berpindah dari satu file ke file lainnya. Jika
pemutaran file baru dimulai dengan lambat, misalnya karena diputar dari a
lokasi jaringan jarak jauh atau karena Anda telah menetapkan pengaturan cache yang
memerlukan waktu untuk pengisian cache awal, maka audio buffer mungkin habis
sebelum pemutaran file baru dapat dimulai.

--sinkronisasi-audio awal, --no-sinkronisasi-audio awal
Saat memulai file video atau setelah acara seperti mencari, mpv akan secara default
ubah aliran audio agar dimulai dari stempel waktu yang sama dengan video, dengan
baik memasukkan keheningan di awal atau memotong sampel pertama. menonaktifkan
opsi ini membuat pemain berperilaku seperti versi mpv yang lebih lama: video dan audio
keduanya segera dimulai meskipun stempel waktu mulainya berbeda, dan kemudian video
pengaturan waktu secara bertahap disesuaikan jika perlu untuk mencapai sinkronisasi yang benar nanti.

--softvol-max=<100.0-1000.0>
Atur tingkat amplifikasi maksimum dalam persen (default: 130). Nilai 130 kemauan
memungkinkan Anda untuk menyesuaikan volume hingga sekitar dua kali lipat dari tingkat normal.

--audio-file-auto= , --no-audio-file-otomatis
Muat file audio tambahan yang cocok dengan nama file video. Parameter menentukan
bagaimana file audio eksternal dicocokkan. tepat diaktifkan secara default.

tidak Jangan memuat file audio eksternal secara otomatis.

tepat Muat nama file media dengan ekstensi file audio (default).

kabur Muat semua file audio yang berisi nama file media.

semua Muat semua file audio di direktori saat ini.

--audio-client-name=
Nama aplikasi yang dilaporkan pemutar ke API audio. Dapat bermanfaat jika Anda mau
untuk memaksa profil audio yang berbeda (misalnya dengan PulseAudio), atau untuk mengatur profil Anda sendiri
nama aplikasi saat menggunakan libmpv.

--volume-restore-data=
Digunakan secara internal untuk digunakan oleh resume pemutaran (misalnya dengan berhenti_watch_later). Memulihkan
nilai harus dilakukan dengan hati-hati, karena AO dan softvol yang berbeda dapat memiliki
rentang nilai yang berbeda, dan kami tidak ingin mengembalikan volume jika mengatur volume
mengubahnya secara luas. Opsi normal (seperti --volume) akan selalu mengatur
volume. Opsi ini ditambahkan untuk memulihkan volume dengan cara yang lebih aman (dengan menyimpan
metode yang digunakan untuk mengatur volume), dan umumnya tidak berguna. Semantiknya adalah
dianggap pribadi untuk mpv.

Jangan gunakan.

--audio-buffer=
Atur buffer minimum output audio. Perangkat audio mungkin benar-benar membuat
buffer yang lebih besar jika diinginkan. Jika perangkat membuat buffer yang lebih kecil, tambahan
audio buffer dalam buffer perangkat lunak tambahan.

Membuat ini lebih besar akan membuat volume lembut dan filter lain bereaksi lebih lambat, perkenalkan
masalah tambahan pada perubahan kecepatan pemutaran, dan memblokir pemutar pada format audio
perubahan. Buffer yang lebih kecil dapat menyebabkan putusnya audio.

Opsi ini harus digunakan untuk pengujian saja. Jika nilai non-default membantu
signifikan, para pengembang mpv harus dihubungi.

Bawaan: 0.2 (200 mdtk).

Teks
--tanpa-sub
Jangan pilih subtitle apa pun saat file dimuat.

--sub-demuxer=<[+]nama>
Paksa jenis demuxer subtitle untuk --sub-berkas. Berikan nama demuxer seperti yang dicetak oleh
--sub-demuxer=bantuan.

--sub-penundaan=
Penundaan subtitle oleh detik. Bisa negatif.

--sub-berkas=berkas subtitel
Tambahkan file subtitle ke daftar subtitle eksternal.

Jika Anda menggunakan --sub-berkas hanya sekali, file subtitle ini ditampilkan secara default.

If --sub-berkas digunakan beberapa kali, subtitle yang akan digunakan dapat diganti di
runtime dengan bersepeda trek subtitle. Dimungkinkan untuk menampilkan dua subtitle sekaligus:
menggunakan --sid untuk memilih indeks subtitle pertama, dan --sisi-sekunder untuk memilih
indeks kedua. (Indeks dicetak pada keluaran terminal setelah --sid= dalam
daftar aliran.)

--sekunder-sid=
Pilih aliran subtitle sekunder. Ini mirip dengan --sid. Jika sekunder
subjudul dipilih, itu akan dirender sebagai judul atas (yaitu di atas
screen) di samping subtitle normal, dan menyediakan cara untuk merender dua subtitle
sekaligus.

Ada beberapa peringatan yang terkait dengan fitur ini. Misalnya, subtitle bitmap
akan selalu dirender dalam posisi biasanya, jadi pilih subtitle bitmap sebagai
subjudul sekunder akan menghasilkan subtitel yang tumpang tindih. Subtitle sekunder adalah
tidak pernah ditampilkan di terminal jika video dinonaktifkan.

CATATAN:
Penataan gaya dan interpretasi tag pemformatan apa pun dinonaktifkan untuk tag sekunder
subjudul. Secara internal, mekanisme yang sama seperti --no-sub-keledai digunakan untuk mengupas
penataan gaya.

CATATAN:
Jika aliran subtitle utama berisi tag pemformatan yang menampilkan subtitle
di bagian atas layar, itu akan tumpang tindih dengan subtitle sekunder. Ke
mencegah ini, Anda bisa menggunakan --no-sub-keledai untuk menonaktifkan gaya di subtitle utama
aliran.

--sub-skala=<0-100>
Faktor untuk ukuran font subtitle teks (default: 1).

CATATAN:
Ini juga memengaruhi subtitle ASS, dan dapat menyebabkan subtitle yang salah
rendering. Gunakan dengan hati-hati, atau gunakan --sub-teks-font-ukuran sebagai gantinya.

--sub-skala-oleh-jendela=
Apakah akan menskalakan subtitle dengan ukuran jendela (default: yes). Jika ini adalah
dinonaktifkan, mengubah ukuran jendela tidak akan mengubah ukuran font subtitle.

Seperti --sub-skala, ini dapat merusak subtitle ASS.

--sub-skala-dengan-jendela=
Buat ukuran font subtitle relatif terhadap jendela, bukan video. Ini
berguna jika Anda selalu menginginkan ukuran font yang sama, meskipun videonya tidak menutupi
jendela sepenuhnya, misalnya karena aspek layar dan aspek jendela tidak cocok (dan pemutar
menambahkan bilah hitam).

Standar: ya.

Opsi ini salah nama. Perbedaan dengan opsi terdengar serupa yang membingungkan
--sub-skala-oleh-jendela adalah bahwa --sub-skala-dengan-jendela masih skala dengan
perkiraan ukuran jendela, sementara opsi lainnya menonaktifkan penskalaan ini.

Hanya memengaruhi subtitle teks biasa (atau ASS jika --penggantian gaya pantat disetel tinggi
cukup).

--ass-scale-with-window=
Seperti --sub-skala-dengan-jendela, tetapi hanya memengaruhi subtitle dalam format ASS. Suka
--sub-skala, ini dapat merusak subtitle ASS.

Standar: tidak.

--font tertanam, --tidak ada font yang disematkan
Gunakan font yang disematkan dalam file container Matroska dan skrip ASS (default: diaktifkan).
Font ini dapat digunakan untuk rendering subtitle SSA/ASS.

--sub-pos=<0-100>
Tentukan posisi subtitle di layar. Nilainya adalah posisi vertikal
subjudul dalam % tinggi layar.

CATATAN:
Ini juga memengaruhi subtitle ASS, dan dapat menyebabkan subtitle yang salah
rendering. Gunakan dengan hati-hati, atau gunakan --sub-teks-margin-y sebagai gantinya.

--sub-kecepatan=<0.1-10.0>
Kalikan stempel waktu acara subtitle dengan nilai yang diberikan. Dapat digunakan untuk memperbaiki
kecepatan pemutaran untuk format subtitle berbasis bingkai. Hanya memengaruhi subtitle teks.

Example

--sub-kecepatan=25/23.976` memainkan subtitle berbasis bingkai yang telah dimuat
dengan asumsi framerate 23.976 pada 25 FPS.

--ass-force-style=<[Gaya.]Param=Nilai[,...]>
Ganti beberapa parameter info gaya atau skrip.

contoh

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

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

CATATAN:
Menggunakan opsi ini dapat menyebabkan rendering subtitle yang salah.

--ss-hinting=
Setel jenis petunjuk font. dapat:

tak satupun tidak ada petunjuk (default)

cahaya Autohinter FreeType, mode ringan

normal Autohinter Tipe Bebas, mode normal

asli font petunjuk asli

peringatan

Mengaktifkan petunjuk dapat menyebabkan teks yang salah posisi (dalam situasi ini
seharusnya cocok dengan latar belakang video), atau mengurangi kelancaran
animasi dengan beberapa skrip ASS yang ditulis dengan buruk. Disarankan untuk tidak
gunakan opsi ini, kecuali benar-benar diperlukan.

--ass-line-spasi=
Tetapkan nilai spasi baris untuk perender SSA/ASS.

--pembentuk pantat=
Atur mesin tata letak teks yang digunakan oleh libass.

sederhana hanya menggunakan Fribidi, cepat, tidak menerjemahkan beberapa bahasa dengan benar

kompleks
menggunakan HarfBuzz, lebih lambat, dukungan bahasa yang lebih luas

kompleks adalah default. Jika libass belum dikompilasi terhadap HarfBuzz, libass
diam-diam kembali ke sederhana.

--ass-styles=
Muat semua gaya SSA/ASS yang ditemukan dalam file yang ditentukan dan gunakan untuk merender teks
sub judul. Sintaks file persis seperti [V4 Gaya] / [V4+ Gaya]
bagian SSA/ASS.

CATATAN:
Menggunakan opsi ini dapat menyebabkan rendering subtitle yang salah.

--ass-style-override=
Kontrol apakah penggantian gaya pengguna harus diterapkan.

iya nih Terapkan semua --pantat-* opsi penggantian gaya. Mengubah default untuk apa saja
dari opsi ini dapat menyebabkan rendering subtitle yang salah (default).

tanda 'like' iya nih, tapi terapkan --sub-skala hanya untuk tanda-tanda

tidak Render subtitle seperti yang dipaksakan oleh skrip subtitle.

kekuatan Cobalah untuk memaksakan gaya font seperti yang didefinisikan oleh --sub-teks-* pilihan. Bisa
istirahat rendering dengan mudah.

--ass-force-margin
Memungkinkan penempatan judul atas dan subjudul dalam batas hitam saat tersedia,
jika subtitle dalam format ASS.

Standar: tidak.

--sub-penggunaan-margin
Memungkinkan penempatan judul atas dan subjudul dalam batas hitam saat tersedia,
jika subtitle dalam format teks biasa (atau ASS jika --penggantian gaya pantat diatur
cukup tinggi).

Standar: ya.

Berganti nama dari --ass-use-margin. Untuk menempatkan subtitle ASS di perbatasan juga (seperti
opsi lama melakukannya), juga tambahkan --ass-force-margin.

--ass-vsfilter-aspect-compat=
Regangkan subtitle SSA/ASS saat memutar video anamorphic untuk kompatibilitas dengan
perilaku VSFilter tradisional. Sakelar ini tidak berpengaruh saat video disimpan
dengan piksel persegi.

Perender secara historis paling sering digunakan untuk format subjudul SSA/ASS,
VSFilter, memiliki perilaku yang dipertanyakan yang mengakibatkan subtitle juga diregangkan
jika video disimpan dalam format anamorfik yang memerlukan penskalaan untuk ditampilkan.
Perilaku ini biasanya tidak diinginkan dan versi VSFilter yang lebih baru mungkin berperilaku
berbeda. Namun, banyak skrip yang ada mengimbangi peregangan dengan
memodifikasi hal-hal dalam arah yang berlawanan. Jadi, jika skrip seperti itu ditampilkan
"dengan benar", mereka tidak akan muncul sebagaimana dimaksud. Sakelar ini memungkinkan emulasi dari
perilaku VSFilter lama (tidak diinginkan tetapi diharapkan oleh banyak skrip yang ada).

Diaktifkan secara default.

--ass-vsfilter-blur-compat=
Skala \mengaburkan tag berdasarkan resolusi video alih-alih resolusi skrip (diaktifkan oleh
bawaan). Ini adalah bug di VSFilter, yang menurut beberapa orang, tidak dapat diperbaiki lagi
atas nama kompatibilitas.

Perhatikan bahwa ini menggunakan resolusi video sebenarnya untuk menghitung skala offset
faktor, bukan apa yang digunakan rantai filter video atau output video.

--ass-vsfilter-color-compat=
Mangle warna seperti (xy-)vsfilter do (default: basic). Secara historis, VSFilter adalah
tidak menyadari ruang warna. Ini tidak masalah selama ruang warna yang digunakan untuk SD
video (BT.601) digunakan. Tetapi ketika semuanya beralih ke HD (BT.709), VSFilter adalah
masih mengonversi warna RGB ke BT.601, merendernya ke dalam bingkai video, dan
menangani bingkai ke output video, yang akan menggunakan BT.709 untuk konversi ke
RGB. Hasilnya adalah warna subtitle yang hancur. Kemudian, peretasan buruk ditambahkan di atas
format ASS untuk mengontrol bagaimana warna akan dihancurkan.

dasar Tangani hanya BT.601->BT.709 mangling, jika subtitle tampaknya menunjukkan bahwa
ini diperlukan (default).

penuh Tangani sepenuhnya YCbCr Matriks header dengan semua ruang warna video yang didukung oleh
libas dan mpv. Ini dapat menyebabkan kerusakan parah dalam kasus sudut dan tidak
sangat dibutuhkan untuk kompatibilitas (semoga), itulah sebabnya ini tidak
standar.

kekuatan-601
Paksa BT.601->BT.709 mangling, terlepas dari judul subtitle atau warna video
ruang.

tidak Nonaktifkan mangling warna sepenuhnya. Semua warna adalah RGB.

Memilih apa pun selain tidak akan membuat warna subtitle tergantung pada video
ruang warna, dan misalnya secara teori tidak mungkin menggunakan kembali skrip subtitle
dengan file video lain. Itu --penggantian gaya pantat opsi tidak memengaruhi bagaimana ini
opsi ditafsirkan.

--stretch-dvd-subs=
Regangkan subtitle DVD saat memutar video anamorphic untuk tampilan font yang lebih baik
DVD yang dikuasai dengan buruk. Sakelar ini tidak berpengaruh saat video disimpan dengan kotak
piksel - yang untuk input DVD tidak dapat terjadi.

Banyak studio cenderung menggunakan font bitmap yang dirancang untuk piksel persegi saat menulis
DVD, menyebabkan font terlihat melebar saat diputar di pemutar DVD. Pilihan ini
memperbaikinya, namun dengan kemungkinan ketidakselarasan beberapa subtitle (mis
terjemahan).

Dinonaktifkan secara default.

--stretch-image-subs-to-screen=
Regangkan DVD dan subtitle gambar lainnya ke layar, mengabaikan margin video.
Ini memiliki efek yang sama seperti --sub-penggunaan-margin untuk teks teks, kecuali bahwa
teks itu sendiri akan diregangkan, tidak hanya direposisi saja. (Setidaknya secara umum
tidak dapat dihindari, karena bitmap gambar secara teori dapat terdiri dari satu bitmap
menutupi seluruh layar, dan pemain tidak akan tahu di mana tepatnya bagian teks
terletak.)

Opsi ini tidak menampilkan subtitle dengan benar. Gunakan dengan hati-hati.

Dinonaktifkan secara default.

--bawah pantat, --no-sub-keledai
Render subtitle ASS secara asli (diaktifkan secara default).

If --no-sub-keledai ditentukan, semua tag dan deklarasi gaya dihapus dan
diabaikan pada tampilan. Penyaji subtitle menggunakan gaya font seperti yang ditentukan oleh
--sub-teks- opsi sebagai gantinya.

CATATAN:
Menggunakan --no-sub-keledai dapat menyebabkan rendering yang salah atau benar-benar rusak dari
subtitle ASS/SSA. Terkadang berguna untuk mengesampingkan gaya secara paksa
subtitle ASS, tetapi harus dihindari secara umum.

CATATAN:
Coba gunakan --ass-style-override=kekuatan sebagai gantinya.

--sub-otomatis= , --tanpa-sub-otomatis
Muat file subtitle tambahan yang cocok dengan nama file video. Parameter menentukan
bagaimana file subtitle eksternal dicocokkan. tepat diaktifkan secara default.

tidak Jangan memuat file subtitle eksternal secara otomatis.

tepat Muat nama file media dengan ekstensi file subtitle (default).

kabur Muat semua subs yang berisi nama file media.

semua Muat semua kapal selam dalam arus dan --sub-jalur direktori.

--sub-kode halaman=
Jika sistem Anda mendukung iconv(3), Anda dapat menggunakan opsi ini untuk menentukan subtitle
halaman kode. Secara default, uchardet akan digunakan untuk menebak charset. Jika mpv tidak
dikompilasi dengan uchardet, enca akan digunakan. Jika mpv dikompilasi dengan keduanya
uchardet atau enca, UTF-8:UTF-8-RUSAK adalah default, yang berarti akan mencoba
gunakan UTF-8, jika tidak UTF-8-RUSAK halaman kode semu (lihat di bawah).

Nilai default untuk opsi ini adalah mobil, yang efek aktualnya bergantung pada apakah
ENCA dikompilasi.

peringatan

Jika Anda memaksakan rangkaian karakter, bahkan subtitle yang dikenal sebagai UTF-8 akan
dikodekan ulang, yang mungkin bukan yang Anda harapkan. Halaman kode awalan dengan
utf8: jika Anda ingin halaman kode digunakan hanya jika inputnya tidak valid
UTF-8.

contoh

· --sub-halaman kode=utf8:latin2 Gunakan Latin 2 jika inputnya bukan UTF-8.

· --sub-halaman kode=cp1250 Selalu paksa pengodean ulang ke cp1250.

Halaman kode semu UTF-8-RUSAK digunakan secara internal. Ketika itu adalah halaman kode,
subtitle ditafsirkan sebagai UTF-8 dengan "Latin 1" sebagai pengganti untuk byte yang
bukan urutan UTF-8 yang valid. iconv tidak pernah terlibat dalam mode ini.

Jika pemutar dikompilasi dengan dukungan ENCA, Anda dapat mengontrolnya dengan yang berikut:
sintaksis:

--sub-codepage=enca: : halaman kode>

Bahasa ditentukan menggunakan kode dua huruf untuk membantu ENCA mendeteksi halaman kode
secara otomatis. Jika kode bahasa yang dimasukkan tidak valid, mpv akan mengeluh dan mendaftar
bahasa yang valid. (Namun perhatikan bahwa daftar ini hanya akan dicetak ketika
kode konversi sebenarnya disebut, misalnya saat memuat subtitle eksternal).
Halaman kode cadangan digunakan jika deteksi otomatis gagal. Jika tidak ada fallback yang ditentukan,
UTF-8-RUSAK digunakan.

contoh

· --sub-codepage=enca:pl:cp1250 tebak penyandiannya, dengan asumsi subtitlenya adalah
Polandia, kembali ke cp1250

· --sub-codepage=enca:pl tebak pengkodean untuk bahasa Polandia, kembali ke UTF-8.

· --sub-halaman kode=enca coba deteksi universal, kembali ke UTF-8.

Jika pemutar dikompilasi dengan dukungan libguess, Anda dapat menggunakannya dengan:

--sub-codepage=tebak: : halaman kode>

libguess selalu membutuhkan bahasa. Tidak ada mode deteksi universal. Menggunakan
--sub-codepage=tebak:bantuan untuk mendapatkan daftar bahasa yang tunduk pada peringatan yang sama dengan
dengan ENCA di atas.

Jika pemutar dikompilasi dengan dukungan uchardet, Anda dapat menggunakannya dengan:

--sub-codepage=ucardet

Mode ini tidak menggunakan bahasa atau halaman kode fallback.

--sub-fix-waktu, --tidak ada waktu sub-perbaikan
Secara default, waktu subtitle disesuaikan untuk menghilangkan celah kecil atau tumpang tindih antara
subtitle (jika perbedaannya lebih kecil dari 210 ms, celah atau tumpang tindihnya adalah
DIHAPUS).

--sub-paksa-saja
Hanya tampilkan subtitle paksa untuk streaming subtitle DVD yang dipilih oleh mis
--slang.

--sub-fps=
Tentukan kecepatan bingkai file subtitle (default: video fps). Mempengaruhi teks
subtitle saja.

CATATAN:
> video fps mempercepat subtitle untuk file subtitle berbasis bingkai dan
memperlambat mereka untuk yang berbasis waktu.

Juga lihat --sub-kecepatan .

--sub-gauss=<0.0-3.0>
Terapkan Gaussian blur ke subtitle gambar (default: 0). Ini dapat membantu membuat pixelated
DVD/Vobsubs terlihat lebih bagus. Nilai selain 0 juga beralih ke subtitle perangkat lunak
penskalaan. Mungkin lambat.

CATATAN:
Tidak pernah diterapkan pada subtitle teks.

--sub-abu-abu
Ubah subtitle gambar menjadi skala abu-abu. Dapat membantu membuat DVD/Vobsubs kuning terlihat
Lebih bagus

CATATAN:
Tidak pernah diterapkan pada subtitle teks.

--sub-jalur=
Tentukan direktori tambahan untuk mencari subtitel yang cocok dengan video. beberapa
direktori dapat dipisahkan dengan ":" (";" di Windows). Jalur bisa relatif atau
mutlak. Jalur relatif ditafsirkan relatif terhadap direktori file video.

Example

Berasumsi bahwa /path/ke/video/video.avi dimainkan dan
--sub-paths=sub:subtitle:/tmp/subs ditentukan, mpv mencari
file subtitle di direktori ini:

· /jalan/ke/video/

· /path/ke/video/sub/

· /path/ke/video/subtitel/

· /tmp/subs/

· NS di bawah subdirektori konfigurasi (biasanya ~/.config/mpv/sub/)

--sub-visibilitas, --tidak ada sub-visibilitas
Dapat digunakan untuk menonaktifkan tampilan subtitle, tetapi tetap memilih dan mendekodekannya.

--sub-jelas-saat-mencari
(Tidak jelas, jarang berguna.) Dapat digunakan untuk memutar file mkv yang rusak dengan duplikat
Bidang BacaOrder. ReadOrder adalah bidang pertama dalam subtitle ASS bergaya Matroska
paket. Itu harus unik, dan libass menggunakannya untuk menghilangkan
duplikat. Opsi ini menonaktifkan caching subtitle di seluruh pencarian, jadi setelah pencarian
libass tidak dapat menghilangkan paket subtitle dengan ReadOrder yang sama dengan paket sebelumnya.

Jendela
--judul=
Mengatur judul jendela. Ini digunakan untuk jendela video, dan jika mungkin, juga menyetel
judul aliran audio.

Properti diperluas. (Melihat Milik Perluasan.)

PERINGATAN:
Ada bahaya ini menyebabkan penggunaan CPU yang signifikan, tergantung pada
properti yang digunakan. Mengubah judul jendela sering kali merupakan operasi yang lambat, dan jika
judul berubah setiap frame, pemutaran bisa rusak.

--layar=
Dalam konfigurasi multi-monitor (yaitu satu desktop yang mencakup banyak)
ditampilkan), opsi ini memberi tahu mpv layar mana untuk menampilkan video.

Catatan (X11)

Opsi ini tidak berfungsi dengan baik dengan semua pengelola jendela. Dalam ini
kasus, Anda dapat mencoba menggunakan --geometri untuk memposisikan jendela secara eksplisit.
Mungkin juga pengelola jendela menyediakan fitur asli untuk
mengontrol layar mana yang harus digunakan oleh aplikasi windows.

Lihat juga --fs-layar.

--layar penuh, --fs
Pemutaran layar penuh.

--fs-screen=
Dalam konfigurasi multi-monitor (yaitu satu desktop yang mencakup banyak)
ditampilkan), opsi ini memberi tahu mpv layar mana yang akan digunakan layar penuh. Jika kegagalan is
asalkan mpv akan mundur dalam menggunakan perilaku tergantung pada apa yang pengguna
disediakan dengan layar .

Catatan (X11)

Opsi ini hanya berfungsi dengan baik dengan pengelola jendela yang
memahami EWMH _NET_WM_FULLSCREEN_MONITORS petunjuk.

Catatan (OS X)

semua tidak bekerja pada OS X dan akan berperilaku seperti arus.

Lihat juga --layar.

--fs-layar gelap
OS X saja. Matikan tampilan lain saat menggunakan layar penuh.

--tetap buka=
Jangan berhenti saat memutar atau mencari di luar akhir file, dan ada
bukan file berikutnya yang akan diputar (dan --lingkaran tidak digunakan). Sebagai gantinya, jeda pemutar.
Saat mencoba mencari di luar akhir file, pemain akan mencoba mencari ke
bingkai terakhir.

Argumen berikut dapat diberikan:

tidak Jika file saat ini berakhir, buka file berikutnya atau akhiri. (Bawaan.)

iya nih Jangan hentikan jika file saat ini adalah entri daftar putar terakhir. Setara
untuk --tetap buka tanpa argumen.

selalu Seperti iya nih, tetapi juga berlaku untuk file sebelum entri daftar putar terakhir. Ini
berarti pemutaran tidak akan pernah secara otomatis maju ke file berikutnya.

CATATAN:
Opsi ini tidak dihormati saat menggunakan --frame. Secara eksplisit melompat ke
file berikutnya jika pengikatan menggunakan kekuatan akan menghentikan pemutaran juga.

Juga, jika terjadi kesalahan atau keadaan yang tidak biasa, pemain tetap dapat keluar.

Sejak mpv 0.6.0, ini tidak berhenti jika ada file berikutnya di daftar putar, atau
daftar putar dilingkari. Kira-kira, ini akan berhenti ketika pemain biasanya
keluar, tetapi dalam praktiknya ada kasus sudut di mana hal ini tidak terjadi (mis
mpv --tetap buka file.mkv / dev / null akan memutar file.mkv secara normal, lalu gagal dibuka
/ dev / null, lalu keluar). (Dalam mpv 0.8.0, selalu diperkenalkan, yang mengembalikan yang lama
perilaku.)

--force-window=
Buat jendela output video meskipun tidak ada video. Ini bisa berguna ketika
berpura-pura bahwa mpv adalah aplikasi GUI. Saat ini, jendela selalu memiliki ukuran
640x480, dan tunduk pada --geometri, --paskan otomatis, dan opsi serupa.

PERINGATAN:
Jendela dibuat hanya setelah inisialisasi (untuk memastikan jendela default
penempatan masih berfungsi jika ukuran video berbeda dari --force-jendela
ukuran jendela default). Ini bisa menjadi masalah jika inisialisasi tidak berhasil
sempurna, seperti saat membuka URL dengan koneksi jaringan yang buruk, atau membuka
file video rusak. Itu Segera mode dapat digunakan untuk membuat jendela selalu
saat program dimulai, tetapi ini dapat menyebabkan masalah lain.

--di atas
Membuat jendela pemutar tetap berada di atas jendela lainnya.

Di Windows, jika digabungkan dengan mode layar penuh, ini menyebabkan mpv diperlakukan sebagai
jendela layar penuh eksklusif yang melewati Desktop Window Manager.

--berbatasan, --tidak ada batasan
Putar video dengan bingkai jendela dan dekorasi. Karena ini aktif secara default, gunakan
--tidak ada batasan untuk menonaktifkan dekorasi jendela standar.

--di-semua-ruang kerja
(Khusus X11) Menampilkan jendela video di semua desktop virtual.

--geometri=<[P[xH]][+-x+-y]>, --geometri=
Sesuaikan posisi atau ukuran jendela awal. W dan H mengatur ukuran jendela dalam piksel.
x dan y atur posisi jendela, diukur dalam piksel dari sudut kiri atas
layar ke sudut kiri atas gambar yang sedang ditampilkan. Jika tanda persentase
(%) diberikan setelah argumen, itu mengubah nilai menjadi persentase layar
ukuran ke arah itu. Posisi ditentukan mirip dengan X11 standar
--geometri format opsi, di mana misalnya +10-50 berarti "tempatkan 10 piksel dari kiri
batas dan 50 piksel dari batas bawah" dan "--20+-10" berarti "tempatkan 20 piksel
di luar kanan dan 10 piksel di luar batas atas".

Jika jendela eksternal ditentukan menggunakan --lebar opsi, opsi ini diabaikan.

Koordinat relatif terhadap layar yang diberikan dengan --layar untuk keluaran videonya
driver yang mendukung penuh --layar.

CATATAN:
Umumnya hanya didukung oleh GUI VOs. Diabaikan untuk pengkodean.

Catatan (X11)

Opsi ini tidak berfungsi dengan baik dengan semua pengelola jendela.

contoh

50:40 Tempatkan jendela pada x=50, y=40.

50%: 50%
Menempatkan jendela di tengah layar.

100%: 100%
Tempatkan jendela di sudut kanan bawah layar.

50% Mengatur lebar jendela menjadi setengah lebar layar. Ketinggian jendela diatur begitu
bahwa jendela memiliki rasio aspek video.

50%x50%
Memaksa lebar dan tinggi jendela menjadi setengah lebar dan tinggi layar.
Akan menampilkan batas hitam untuk mengimbangi rasio aspek video (dengan
sebagian besar VO dan tanpa --tidak-jaga-jaga).

50%+10+10
Setel jendela menjadi setengah lebar layar, dan posisikan 10 piksel
di bawah/kiri pojok kiri atas layar.

Lihat juga --paskan otomatis dan --autofit-lebih besar untuk memasang jendela ke dalam ukuran tertentu
tanpa mengubah rasio aspek.

--autofit=<[L[xH]]>
Atur ukuran jendela awal ke ukuran maksimum yang ditentukan oleh WxH, tanpa mengubah
rasio aspek jendela. Ukuran diukur dalam piksel, atau jika angka adalah
diikuti dengan tanda persentase (%), dalam persen dari ukuran layar.

Opsi ini tidak pernah mengubah rasio aspek jendela. Jika rasio aspek
ketidakcocokan, ukuran jendela dikurangi sampai sesuai dengan ukuran yang ditentukan.

Posisi jendela tidak diperhitungkan, juga tidak diubah oleh opsi ini (the
window manager masih dapat menempatkan jendela secara berbeda tergantung pada ukuran). Menggunakan
--geometri untuk mengubah posisi jendela. Efeknya diterapkan setelah ini
.

Lihat --geometri untuk detail bagaimana ini ditangani dengan pengaturan multi-monitor.

penggunaan --autofit-lebih besar alih-alih jika Anda hanya ingin membatasi ukuran maksimum
jendela, daripada selalu memaksakan ukuran jendela.

penggunaan --geometri jika Anda ingin memaksa lebar dan tinggi jendela ke tertentu
ukuran.

CATATAN:
Umumnya hanya didukung oleh GUI VOs. Diabaikan untuk pengkodean.

contoh

70% Jadikan lebar jendela 70% dari ukuran layar, dengan menjaga rasio aspek.

1000 Atur lebar jendela ke 1000 piksel, pertahankan rasio aspek.

70%: 60%
Buat jendela sebesar mungkin, tanpa lebih dari 70% dari
lebar layar, atau lebih tinggi dari 60% tinggi layar.

--autofit-larger=<[W[xH]]>
Opsi ini berperilaku persis seperti --paskan otomatis, kecuali ukuran jendela hanya diubah
jika jendela akan lebih besar dari ukuran yang ditentukan.

Example

90%x80%
Jika video lebih besar dari 90% lebar layar atau 80% layar
tinggi, buat jendela lebih kecil hingga lebarnya 90% dari
layar, atau tingginya 80% dari layar.

--autofit-smaller=<[L[xH]]>
Opsi ini berperilaku persis seperti --paskan otomatis, kecuali bahwa ia menetapkan ukuran minimum
jendela (seperti --autofit-lebih besar menetapkan maksimum).

Example

500x500
Buat jendela dengan lebar minimal 500 piksel dan tinggi 500 piksel (tergantung
pada rasio aspek video, lebar atau tinggi akan lebih besar dari 500 in
agar rasio aspek tetap sama).

--skala jendela=
Ubah ukuran jendela video menjadi kelipatan (atau pecahan) dari ukuran video. Pilihan ini
diterapkan sebelumnya --paskan otomatis dan opsi lain diterapkan (sehingga mereka menimpa ini
pilihan).

Sebagai contoh, --skala jendela = 0.5 akan menampilkan jendela dengan ukuran setengah video.

--kursor-autohide=
Membuat kursor mouse secara otomatis bersembunyi setelah jumlah milidetik yang diberikan. tidak akan
nonaktifkan sembunyikan otomatis kursor. selalu berarti kursor akan tetap tersembunyi.

--kursor-autohide-fs-saja
Jika opsi ini diberikan, kursor selalu terlihat dalam mode berjendela. Di
mode layar penuh, kursor ditampilkan atau disembunyikan sesuai dengan --kursor-sembunyikan otomatis.

--tidak-tetap-vo, --memperbaiki-vo
--tidak-tetap-vo memaksa penutupan dan pembukaan kembali jendela video untuk banyak file
(satu (tidak) inisialisasi untuk setiap file).

--force-rgba-osd-rendering
Ubah cara beberapa keluaran video merender OSD dan teks terjemahan. Ini tidak
mengubah tampilan subtitle dan hanya memiliki implikasi kinerja. Untuk VO
yang mendukung rendering ASS asli (seperti vdpau, terbuka, langsung3d), ini bisa menjadi
sedikit lebih cepat atau lebih lambat, tergantung pada driver GPU dan perangkat keras. Untuk VO lainnya,
ini hanya membuat rendering lebih lambat.

--posisi-jendela-kekuatan
Pindahkan jendela output video mpv secara paksa ke lokasi default kapan pun ada
perubahan parameter video, aliran video atau file. Ini dulunya default
perilaku. Saat ini hanya memengaruhi VO X11.

--detak jantung-cmd=
Perintah yang dijalankan setiap 30 detik selama pemutaran melalui sistem() - yaitu menggunakan
kerang. Waktu antar perintah dapat disesuaikan dengan
--denyut-interval pilihan. Perintah tidak dijalankan saat pemutaran dijeda.

CATATAN:
mpv menggunakan perintah ini tanpa pemeriksaan apa pun. Adalah tanggung jawab Anda untuk memastikan
itu tidak menyebabkan masalah keamanan (misalnya pastikan untuk menggunakan jalur lengkap jika "." adalah
di jalur Anda seperti di Windows). Ini juga hanya berfungsi saat memutar video (yaitu tidak
dengan --tanpa-video tetapi bekerja dengan -vo=batal).

Ini dapat "disalahgunakan" untuk menonaktifkan screensaver yang tidak mendukung X API yang tepat
(Lihat juga --stop-penghemat layar). Jika menurut Anda ini terlalu rumit, tanyakan kepada penulisnya
program screensaver untuk mendukung X API yang tepat. Perhatikan bahwa
--stop-penghemat layar tidak mempengaruhi kode detak jantung sama sekali.

Contoh untuk xscreensaver

mpv --heartbeat-cmd="xscreensaver-command -menonaktifkan" fillet

Contoh untuk screensaver GNOME

mpv --heartbeat-cmd="gnome-screensaver-command -P" fillet

--detak jantung-interval=
Waktu antara --detak jantung-cmd pemanggilan dalam hitungan detik (default: 30).

CATATAN:
Ini tidak mempengaruhi operasi screensaver normal dengan cara apapun.

--tanpa-keepaspect, --keepaspek
--tidak-jaga-jaga akan selalu meregangkan video ke ukuran jendela, dan akan menonaktifkan
petunjuk window manager yang memaksa rasio aspek jendela. (Diabaikan dalam layar penuh
mode.)

--tidak ada-menjaga jendela, --keepaspect-jendela
--keepaspect-jendela (default) akan mengunci ukuran jendela ke aspek video.
--tidak ada-menjaga jendela-jendela menonaktifkan perilaku ini, dan sebagai gantinya akan menambahkan bilah hitam jika
aspek jendela dan aspek video tidak cocok. Apakah ini benar-benar berfungsi tergantung pada
bagian belakang VO. (Diabaikan dalam mode layar penuh.)

--monitoraspect=
Atur rasio aspek monitor atau layar TV Anda. Nilai 0 menonaktifkan yang sebelumnya
pengaturan (misalnya dalam file konfigurasi). Menggantikan --monitorpixelaspect pengaturan jika
diaktifkan.

Lihat juga --monitorpixelaspect dan --aspek-video.

contoh

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

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

--monitorpixelaspect=
Atur aspek satu piksel monitor atau layar TV Anda (default: 1). Sebuah nilai
dari 1 berarti piksel persegi (benar untuk (hampir?) semua LCD). Lihat juga --monitoraspek
dan --aspek-video.

--stop-penghemat layar, --tanpa henti-screensaver
Matikan screensaver (atau screen blanker dan mekanisme serupa) saat startup dan
menyalakannya lagi saat keluar (default: ya). Screensaver selalu diaktifkan kembali saat
pemain dijeda.

Ini tidak didukung pada semua keluaran atau platform video. Terkadang itu
diimplementasikan, tetapi tidak berfungsi (sering terjadi pada GNOME). Anda mungkin bisa
kerjakan ini menggunakan --detak jantung-cmd sebagai gantinya.

--lebar=
Ini memberitahu mpv untuk melampirkan ke jendela yang ada. Jika VO dipilih yang mendukung
opsi ini, itu akan menggunakan jendela itu untuk output video. mpv akan menskalakan video ke
ukuran jendela ini, dan akan menambahkan bilah hitam untuk mengimbangi jika rasio aspek
dari videonya berbeda.

Pada X11, ID diinterpretasikan sebagai Jendela di X11. Tidak seperti MPlayer/mplayer2, mpv
selalu membuat jendelanya sendiri, dan menetapkan jendela lebar sebagai induk. Jendela akan
selalu diubah ukurannya untuk menutupi jendela induk sepenuhnya. Nilai 0 ditafsirkan
khusus, dan mpv akan menggambar langsung di jendela root.

Pada win32, ID ditafsirkan sebagai HWND. Berikan itu sebagai nilai yang diberikan kepada intptr_t. mpv
akan membuat jendelanya sendiri, dan mengatur jendela wid sebagai induk, seperti dengan X11.

Pada OSX/Cocoa, ID diinterpretasikan sebagai Tampilan NS*. Berikan itu sebagai nilai yang diberikan kepada intptr_t.
mpv akan membuat sub-tampilannya sendiri. Karena OSX tidak mendukung penyematan jendela dari
proses asing, ini hanya berfungsi dengan libmpv, dan akan macet saat digunakan dari
garis komando.

--tanpa-jendela-menyeret
Jangan pindahkan jendela saat mengkliknya dan menggerakkan penunjuk tetikus.

--x11-nama
Tetapkan nama kelas jendela untuk metode keluaran video berbasis X11.

--x11-netwm=
(Khusus X11) Mengontrol penggunaan fitur protokol NetWM.

Ini mungkin atau mungkin tidak membantu dengan pengelola jendela yang rusak. Ini memberikan beberapa
fungsionalitas yang diimplementasikan oleh yang sekarang dihapus --fstype pilihan. Sebenarnya,
tidak diketahui oleh pengembang sejauh mana opsi ini diperlukan, jadi
umpan balik dipersilahkan.

Secara khusus, iya nih akan memaksa penggunaan dukungan layar penuh NetWM, meskipun tidak
diiklankan oleh WM. Ini bisa berguna untuk WM yang sengaja rusak, seperti
XMonad. (XMonad seharusnya tidak mengiklankan dukungan layar penuh, karena Flash menggunakan
dia. Rupanya, aplikasi yang ingin tetap menggunakan layar penuh seharusnya
abaikan petunjuk dukungan NetWM, atau berikan solusi. Malu pada XMonad untuk
sengaja melanggar protokol X (seolah-olah X belum cukup buruk).

Secara default, dukungan NetWM terdeteksi secara otomatis (mobil).

Opsi ini mungkin akan dihapus di masa mendatang.

--x11-bypass-compositor=
Jika diatur ke iya nih (default), lalu minta compositor untuk membatalkan pengalihan jendela mpv. Ini
menggunakan _NET_WM_BYPASS_COMPOSITOR petunjuk.

Cakram Devices
--cdrom-perangkat=
Tentukan perangkat CD-ROM (default: /dev/cdrom).

--dvd-device=
Tentukan perangkat DVD atau nama file .iso (default: /dev/dvd). Anda juga dapat menentukan
direktori yang berisi file yang sebelumnya disalin langsung dari DVD (dengan mis
salinan vob).

Example

mpv DVD:// --dvd-device=/path/ke/dvd/

--bluray-perangkat=
(Hanya Blu-ray) Tentukan lokasi disk Blu-ray. Harus berupa direktori dengan Blu-ray
struktur.

Example

mpv tidur:// --bluray-device=/path/ke/bd/

--bluray-angle=
Beberapa disk Blu-ray berisi pemandangan yang dapat dilihat dari berbagai sudut. Ini
opsi memberi tahu mpv sudut mana yang akan digunakan (default: 1).

--cdda-...
Opsi ini dapat digunakan untuk menyetel fitur membaca Audio CD dari mpv.

--cdda-kecepatan=
Atur kecepatan putar CD.

--cdda-paranoia=<0-2>
Setel tingkat paranoia. Nilai selain 0 tampaknya merusak pemutaran apa pun kecuali
trek pertama.

0 nonaktifkan pemeriksaan (default)

1 pemeriksaan tumpang tindih saja

2 koreksi dan verifikasi data lengkap

--cdda-sektor-ukuran=
Setel ukuran baca atom.

--cdda-overlap=
Paksa pencarian tumpang tindih minimum selama verifikasi untuk sektor.

--cdda-toc-bias
Asumsikan bahwa offset awal track 1 seperti yang dilaporkan dalam TOC adalah
dialamatkan sebagai LBA 0. Beberapa disk memerlukan ini untuk mendapatkan batas trek dengan benar.

--cdda-toc-offset=
Add sektor ke nilai yang dilaporkan saat menangani trek. Mungkin
negatif.

--cdda-skip=
(Tidak pernah) menerima rekonstruksi data yang tidak sempurna.

--cdda-cdtext=
Cetak teks CD. Ini dinonaktifkan secara default, karena merusak kinerja dengan
Drive CD-ROM untuk alasan yang tidak diketahui.

--kecepatan dvd=
Cobalah untuk membatasi kecepatan DVD (default: 0, tidak ada perubahan). Kecepatan dasar DVD adalah 1385 kB/s, jadi
Drive 8x dapat membaca dengan kecepatan hingga 11080 kB/s. Kecepatan yang lebih lambat membuat drive lebih banyak
diam. Untuk menonton DVD, 2700 kB/s harus tenang dan cukup cepat. mpv mengatur ulang
kecepatan ke nilai default drive saat ditutup. Nilai setidaknya 100 kecepatan rata-rata dalam
kB/s. Nilai kurang dari 100 berarti kelipatan 1385 kB/s, yaitu --kecepatan-dvd=8 memilih
11080 kB/dtk.

CATATAN:
Anda memerlukan akses tulis ke perangkat DVD untuk mengubah kecepatan.

--dvd-angle=
Beberapa DVD berisi adegan yang dapat dilihat dari berbagai sudut. Pilihan ini
memberi tahu mpv sudut mana yang akan digunakan (default: 1).

Equalizer
--kecerahan=<-100-100>
Sesuaikan kecerahan sinyal video (default: 0). Tidak didukung oleh semua video
driver keluaran.

--kontras=<-100-100>
Sesuaikan kontras sinyal video (default: 0). Tidak didukung oleh semua video
driver keluaran.

--saturasi=<-100-100>
Sesuaikan saturasi sinyal video (default: 0). Anda bisa mendapatkan skala abu-abu
keluaran dengan opsi ini. Tidak didukung oleh semua driver keluaran video.

--gamma=<-100-100>
Sesuaikan gamma sinyal video (default: 0). Tidak didukung oleh semua video
driver keluaran.

--hue=<-100-100>
Sesuaikan rona sinyal video (default: 0). Anda bisa mendapatkan negatif berwarna dari
gambar dengan opsi ini. Tidak didukung oleh semua driver keluaran video.

Demuxer
--demuxer=<[+]nama>
Jenis demuxer paksa. Gunakan '+' sebelum nama untuk memaksanya; ini akan melewatkan beberapa
cek. Berikan nama demuxer seperti yang dicetak oleh --demuxer=bantuan.

--demuxer-lavf-analyzeduration=
Panjang maksimum dalam detik untuk menganalisis properti aliran.

--demuxer-lavf-probescore=<1-100>
Skor penyelidikan libavformat minimum yang diperlukan. Nilai yang lebih rendah akan membutuhkan lebih sedikit data
dimuat (membuat streaming mulai lebih cepat), tetapi membuat deteksi format file kurang dapat diandalkan.
Dapat digunakan untuk memaksa demuxer libavformat yang terdeteksi secara otomatis, bahkan jika libavformat
menganggap deteksi tidak cukup andal. (Bawaan: 26.)

--demuxer-lavf-allow-mimetype=
Izinkan penurunan format dari tipe HTTP MIME (default: yes). Setel ini ke no in
case memainkan sesuatu dari HTTP secara misterius gagal, meskipun file yang sama berfungsi
dari disk lokal.

Ini default untuk mengurangi latensi saat membuka aliran HTTP.

--demuxer-lavf-format=
Paksa demuxer libavformat tertentu.

--demuxer-lavf-hacks=
Secara default, beberapa format akan ditangani secara berbeda dari format lain dengan
secara eksplisit memeriksa mereka. Sebagian besar dari ini mengkompensasi aneh atau tidak sempurna
perilaku dari demuxer libavformat. Lewat tidak menonaktifkan ini. Untuk debugging dan
pengujian saja.

--demuxer-lavf-genpts-mode=
Mode untuk menurunkan nilai PTS paket yang hilang dari paket DTS. lavf memungkinkan
libavformat tuan-tuan . tidak menonaktifkannya. Ini dulu diaktifkan secara default,
tetapi kemudian dianggap tidak diperlukan lagi. Mengaktifkan ini mungkin membantu dengan
masalah cap waktu, atau memperburuknya.

--demuxer-lavf-o= = [, = [,...]]
Berikan AVOptions ke libavformat demuxer.

Catatan, tambalan untuk membuat o= tidak dibutuhkan dan berikan semua opsi yang tidak diketahui melalui
Sistem AVOption diterima. Daftar lengkap AVOptions dapat ditemukan di FFmpeg
manual. Perhatikan bahwa beberapa opsi mungkin bertentangan dengan opsi mpv.

Example

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

--demuxer-lavf-probesize=
Jumlah maksimum data untuk diselidiki selama fase deteksi. Dalam kasus MPEG-TS
nilai ini menunjukkan jumlah maksimum paket TS untuk dipindai.

--demuxer-lavf-buffersize=
Ukuran buffer baca aliran yang dialokasikan untuk libavformat dalam byte (default: 32768).
Menurunkan ukuran dapat menurunkan latensi. Perhatikan bahwa libavformat mungkin mengalokasikan ulang
buffer secara internal, atau tidak sepenuhnya menggunakan semuanya.

--demuxer-lavf-cryptokey=
Kunci enkripsi yang harus digunakan oleh demuxer. Ini adalah data biner mentah dari kuncinya
diubah menjadi string heksadesimal.

--demuxer-mkv-subtitle-preroll, --mkv-subtitle-pra-putar
Berusaha lebih keras untuk menampilkan subtitle lunak yang disematkan saat mencari di suatu tempat. Biasanya, itu bisa
kebetulan subtitle pada target pencarian tidak ditampilkan karena beberapa wadah
format file yang dirancang. Subtitle hanya muncul jika mencari sebelum atau tepatnya
ke posisi subtitle pertama kali muncul. Lebih buruk lagi, subtitle sering
waktunya untuk muncul dalam jumlah yang sangat kecil sebelum bingkai video terkait, sehingga
mencari ke bingkai video biasanya tidak melakukan demux subtitle pada posisi itu.

Mengaktifkan opsi ini membuat demuxer mulai membaca data sedikit sebelum pencarian
target, sehingga subtitle muncul dengan benar. Perhatikan bahwa ini membuat pencarian lebih lambat,
dan tidak dijamin selalu berhasil. Ini hanya berfungsi jika subtitlenya cukup dekat
ke target pencarian.

Bekerja dengan demuxer Matroska internal saja. Selalu diaktifkan untuk absolut dan
hr-seeks, dan opsi ini mengubah perilaku hanya dengan pencarian relatif atau tidak tepat.

Anda dapat menggunakan --demuxer-mkv-subtitle-preroll-detik opsi untuk menentukan berapa banyak data
demuxer harus membaca terlebih dahulu untuk menemukan paket subtitle yang mungkin
tumpang tindih. Menyetel ini ke 0 akan menonaktifkan mekanisme pra-putar ini secara efektif. Pengaturan
nilai yang sangat besar dapat membuat pencarian menjadi sangat lambat, dan nilai yang sangat besar akan
benar-benar membaca ulang seluruh file dari awal untuk mencari target pada setiap pencarian - pencarian
bisa menjadi lebih lambat menjelang akhir file. Detailnya berantakan, dan nilainya
sebenarnya dibulatkan ke bawah ke cluster dengan keyframe video sebelumnya.

Beberapa file, terutama file yang di-mux dengan versi mkvmerge yang lebih baru, memiliki informasi
tertanam yang dapat digunakan untuk menentukan paket subtitle apa yang tumpang tindih dengan pencarian
target. Dalam kasus ini, mpv akan mengurangi jumlah data yang dibaca seminimal mungkin.
(Meskipun masih akan membaca semua data antara cluster yang berisi yang pertama
menginginkan paket subtitle, dan target pencarian.)

Lihat juga --jam-mencari-demuxer-offset pilihan. Opsi ini dapat mencapai efek yang sama,
tetapi hanya jika hr-seek aktif. Ini bekerja dengan demuxer apa pun, tetapi membuat banyak pencarian
lebih lambat, karena harus memecahkan kode data audio dan video alih-alih hanya melewatkannya.

--mkv-subtitle-pra-putar adalah alias yang tidak digunakan lagi.

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

--demuxer-mkv-probe-video-duration=
Saat membuka file, cari sampai akhir, dan periksa stempel waktu apa yang terakhir
paket video memiliki, dan melaporkannya sebagai durasi file. Ini benar-benar untuk
kompatibilitas dengan Haali saja. Dalam mode ini, kemungkinan pembukaannya adalah
lebih lambat (terutama saat memutar melalui http), atau perilaku dengan file yang rusak adalah
jauh lebih buruk. Jadi jangan gunakan opsi ini.

iya nih mode hanya menggunakan indeks dan membaca sejumlah kecil blok dari akhir
dari file. Itu penuh mode sebenarnya melintasi seluruh file dan dapat membuat
perkiraan yang andal bahkan tanpa kehadiran indeks (seperti file parsial).

--demuxer-rawaudio-channels=
Jumlah saluran (atau tata letak saluran) jika --demuxer=rawaudio digunakan (standar:
stereo).

--demuxer-rawaudio-format=
Contoh format untuk --demuxer=rawaudio (default: s16le). Menggunakan
--demuxer-rawaudio-format=bantuan untuk mendapatkan daftar semua format.

--demuxer-rawaudio-rate=
Tingkat sampel untuk --demuxer=rawaudio (default: 44kHz).

--demuxer-rawvideo-fps=
Nilai dalam bingkai per detik untuk --demuxer=video mentah (standar: 25.0).

--demuxer-rawvideo-w= , --demuxer-rawvideo-h=
Dimensi gambar dalam piksel untuk --demuxer=video mentah.

Example

Mainkan sampel YUV mentah:

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

--demuxer-rawvideo-format=
Ruang warna (fourcc) dalam hex atau string untuk --demuxer=video mentah (bawaan: YV12).

--demuxer-rawvideo-mp-format=
Ruang warna menurut format video internal untuk --demuxer=video mentah. Menggunakan
--demuxer-rawvideo-mp-format=bantuan untuk daftar kemungkinan format.

--demuxer-rawvideo-codec=
Atur codec video alih-alih memilih codec rawvideo saat menggunakan
--demuxer=video mentah. Ini menggunakan nilai yang sama dengan nama codec di --vd (tapi memang
tidak menerima nama dekoder).

--demuxer-rawvideo-size=
Ukuran bingkai dalam byte saat menggunakan --demuxer=video mentah.

--demuxer-max-packets= , --demuxer-max-bytes=
Ini mengontrol seberapa banyak demuxer diizinkan untuk buffer ke depan. Demuxer akan
biasanya mencoba membaca ke depan sebanyak yang diperlukan, atau sebanyak yang diminta dengan
--demuxer-readahead-detik. itu --demuxer-max-... opsi dapat digunakan untuk membatasi
pembacaan maksimum. Ini membatasi readahead yang berlebihan jika ada file yang rusak atau
pemutaran tidak sinkron. Demuxer akan berhenti membaca paket tambahan segera setelahnya
dari batas tercapai. (Batasnya masih bisa sedikit dilampaui karena
alasan teknis.)

Tetapkan batas ini lebih tinggi jika Anda mendapatkan peringatan overflow antrian paket, dan Anda berpikir
pemutaran normal akan dimungkinkan dengan antrian paket yang lebih besar.

Lihat --daftar-opsi untuk default dan rentang nilai.

--demuxer-utas=
Jalankan demuxer di utas terpisah, dan biarkan ia mengambil sejumlah
paket (default: ya). Mengaktifkan ini dapat menghasilkan pemutaran yang lebih lancar, tetapi aktif
sisi lain dapat menambahkan penundaan untuk mencari atau melacak perpindahan.

--demuxer-readahead-secs=
If --demuxer-utas diaktifkan, ini mengontrol seberapa banyak demuxer harus buffer
maju dalam hitungan detik (default: 1). Selama tidak ada paket yang memiliki perbedaan cap waktu
lebih tinggi dari jumlah readahead relatif terhadap paket terakhir yang dikembalikan ke
decoder, demuxer terus membaca.

Perhatikan bahwa --cache-detik opsi akan menimpa nilai ini jika cache diaktifkan,
dan nilainya lebih besar.

(Nilai ini cenderung kabur, karena banyak format file tidak menyimpan linier
stempel waktu.)

--force-seekable=
Jika pemain berpikir bahwa media tidak dapat dicari (misalnya bermain dari pipa, atau
ini adalah aliran http dengan server yang tidak mendukung permintaan jangkauan), mencari kemauan
dinonaktifkan. Opsi ini dapat mengaktifkannya secara paksa. Untuk pencarian di dalam cache,
ada peluang bagus untuk sukses.

Memasukkan
--pengulangan kunci asli
Gunakan pengaturan sistem untuk penundaan dan kecepatan pengulangan tombol, alih-alih --input-ar-delay dan
--masukan-ar-rate. (Apakah ini berlaku tergantung pada backend VO dan cara menanganinya
masukan papan ketik. Tidak berlaku untuk input terminal.)

--input-ar-delay
Penundaan dalam milidetik sebelum kita mulai mengulang kunci secara otomatis (0 untuk menonaktifkan).

--masukan-ar-rate
Jumlah penekanan tombol untuk menghasilkan per detik pada pengulangan otomatis.

--input-conf=
Tentukan file konfigurasi input selain lokasi default di mpv
direktori konfigurasi (biasanya ~/.config/mpv/input.conf).

--tidak ada-input-pengikatan-default
Nonaktifkan binding kunci mpv default (bawaan).

--masukan-cmdlist
Mencetak semua perintah yang dapat diikat ke kunci.

--input-doubleclick-time=
Waktu dalam milidetik untuk mengenali dua penekanan tombol berturut-turut sebagai klik dua kali
(standar: 300).

--masukan-keylist
Mencetak semua kunci yang dapat diikat ke perintah.

--input-key-fifo-size=<2-65000>
Tentukan ukuran FIFO yang menyangga peristiwa penting (default: 7). Jika terlalu
kecil beberapa peristiwa mungkin hilang. Kerugian utama mengaturnya menjadi sangat besar
nilainya adalah jika Anda menahan tombol yang memicu beberapa perintah yang sangat lambat, maka
pemain mungkin tidak responsif saat memproses semua perintah yang antri.

--masukan-tes
Modus uji masukan. Alih-alih menjalankan perintah pada penekanan tombol, mpv akan menampilkan
kunci dan perintah terikat pada OSD. Harus digunakan dengan video dummy, dan
cara normal untuk keluar dari pemutar tidak akan berfungsi (ikatan kunci yang biasanya berhenti akan
ditampilkan di OSD saja, sama seperti pengikatan lainnya). Melihat INPUT.CONF.

--input-file=
Baca perintah dari file yang diberikan. Sebagian besar berguna dengan FIFO. Sejak mpv 0.7.0 juga
memahami perintah JSON (lihat JSON IPC), tetapi Anda tidak bisa mendapatkan balasan atau acara. Menggunakan
--masukan-unix-soket untuk sesuatu yang dua arah. Pada MS Windows, perintah JSON adalah
tidak tersedia.

Ini juga dapat menentukan deskriptor file langsung dengan fd://N (khusus UNIX). Di dalam
kasus, balasan JSON akan ditulis jika FD dapat ditulis.

CATATAN:
Ketika file yang diberikan adalah FIFO mpv membuka kedua ujungnya, sehingga Anda dapat melakukan beberapa gema
"mencari 10 " > mp_pipe dan pipa akan tetap berlaku.

--terminal masukan, --tanpa-input-terminal
--tanpa-input-terminal mencegah pemain membaca peristiwa penting dari standar
memasukkan. Berguna saat membaca data dari input standar. Ini diaktifkan secara otomatis
ketika - ditemukan pada baris perintah. Ada situasi di mana Anda harus mengaturnya
secara manual, misalnya jika Anda membuka /dev/stdin (atau yang setara di sistem Anda), gunakan stdin
dalam daftar putar atau berniat untuk membaca dari stdin nanti melalui file beban atau daftar beban
perintah budak.

--input-unix-socket=
Aktifkan dukungan IPC dan buat soket pendengar di jalur yang diberikan.

Lihat JSON IPC untuk rincian.

Tidak tersedia di MS Windows.

--input-appleremote=
(Khusus OS X) Mengaktifkan/menonaktifkan dukungan Apple Remote. Diaktifkan secara default (kecuali untuk
libmpv).

--masukan-kursor, --tanpa-input-kursor
Izinkan mpv untuk menerima peristiwa penunjuk yang dilaporkan oleh driver keluaran video. Diperlukan
untuk menggunakan OSC, atau untuk memilih tombol dalam menu DVD. Dukungan tergantung pada VO
digunakan.

--input-media-keys=
(Khusus OS X) Mengaktifkan/menonaktifkan dukungan tombol media. Diaktifkan secara default (kecuali untuk
libmpv).

--input-kanan-alt-gr, --no-input-kanan-alt-gr
(Hanya Kakao dan Windows) Gunakan tombol Alt kanan sebagai Alt Gr untuk menghasilkan spesial
karakter. Jika dinonaktifkan, hitung Alt kanan sebagai kunci pengubah Alt. Diaktifkan oleh
standar.

--input-vo-keyboard=
Nonaktifkan semua input keyboard untuk VO yang tidak dapat berpartisipasi dalam keyboard yang tepat
pengiriman masukan. Mungkin tidak mempengaruhi semua VO. Umumnya berguna untuk menyematkan saja.

Pada X11, sub-jendela dengan input yang diaktifkan mengambil semua input keyboard selama itu
1. anak dari jendela terfokus, dan 2. mouse berada di dalam sub-jendela. Itu
dapat mencuri semua input keyboard dari aplikasi yang menyematkan jendela mpv,
dan di sisi lain, jendela mpv tidak akan menerima input jika mouse berada di luar
dari jendela mpv, meskipun mpv memiliki fokus. Toolkit modern mengatasi ini
perilaku X11 yang aneh, tetapi secara naif menyematkan jendela asing merusaknya.

Satu-satunya cara untuk menangani ini secara wajar adalah menggunakan protokol XEmbed, yang
dirancang untuk memecahkan masalah-masalah ini. GTK menyediakan Soket Gtk, yang mendukung XEmbed. Qt
tampaknya tidak memberikan apa pun yang berfungsi di versi yang lebih baru.

Jika penyemat mendukung XEmbed, input harus bekerja dengan pengaturan default dan dengan
opsi ini dinonaktifkan. Perhatikan bahwa input-default-binding dinonaktifkan secara default di
libmpv juga - itu harus diaktifkan jika Anda ingin binding kunci default mpv.

(Opsi ini diubah namanya dari --masukan-x11-keyboard.)

--input-app-events=
(Khusus OS X) Mengaktifkan/menonaktifkan aktivitas keyboard lebar aplikasi sehingga keyboard
pintasan dapat diproses tanpa jendela. Diaktifkan secara default (kecuali untuk
libmpv).

OSD
--osc, --tidak-osc
Apakah akan memuat pengontrol di layar (default: ya).

--tanpa-osd-bar, --osd-bar
Nonaktifkan tampilan bilah OSD. Ini akan membuat beberapa hal (seperti mencari) menggunakan OSD
pesan teks alih-alih bilah.

Anda dapat mengonfigurasi ini berdasarkan per-perintah di input.conf menggunakan osd- awalan,
melihat Memasukkan Command awalan. Jika Anda ingin menonaktifkan OSD sepenuhnya, gunakan
--tingkat osd=0.

--osd-durasi=
Atur durasi pesan OSD dalam ms (default: 1000).

--osd-font= , --sub-teks-font=
Tentukan font yang akan digunakan untuk OSD dan untuk subtitle yang tidak menentukan sendiri a
font tertentu. Standarnya adalah sans-serif.

contoh

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

· --osd-font='MS Komik Tanpa'

CATATAN:
--sub-teks-font opsi (dan sebagian besar lainnya --sub-teks- pilihan) diabaikan ketika
Subtitle ASS dirender, kecuali jika --no-sub-keledai opsi ditentukan.

Ini digunakan untuk mendukung pola fontconfig. Dimulai dengan libass 0.13.0, ini
berhenti bekerja.

--osd-font-size= , --sub-text-font-size=
Tentukan ukuran font OSD/sub. Satuannya adalah ukuran dalam piksel yang diskalakan di jendela
tinggi 720. Ukuran piksel sebenarnya diskalakan dengan tinggi jendela: jika
tinggi jendela lebih besar atau lebih kecil dari 720, ukuran sebenarnya dari teks meningkat
atau juga berkurang.

Standar: 55.

--osd-msg1=
Tampilkan string ini sebagai pesan pada OSD dengan OSD level 1 (terlihat secara default). Itu
pesan akan terlihat secara default, dan selama tidak ada pesan lain yang menutupinya, dan
Level OSD tidak berubah (lihat --tingkat-osd). Memperluas properti; melihat Milik
Perluasan.

--osd-msg2=
Mirip dengan --osd-pesan1, tetapi untuk OSD level 2. Jika ini adalah string kosong (default),
kemudian waktu pemutaran ditampilkan.

--osd-msg3=
Mirip dengan --osd-pesan1, tetapi untuk OSD level 3. Jika ini adalah string kosong (default),
kemudian waktu pemutaran, durasi, dan beberapa informasi lainnya ditampilkan.

Ini juga digunakan untuk tampilkan_kemajuan perintah (secara default dipetakan ke P), atau dalam
beberapa kasus non-default saat mencari.

--osd-status-pesan adalah setara warisan (tetapi dengan perbedaan kecil).

--osd-status-msg=
Tampilkan string khusus selama pemutaran alih-alih teks status standar. Ini
menimpa teks status yang digunakan untuk --tingkat osd=3, saat menggunakan tampilkan_kemajuan
perintah (secara default dipetakan ke P), atau dalam beberapa kasus non-default saat mencari.
Memperluas properti. Melihat Milik Perluasan.

Opsi ini telah diganti dengan --osd-pesan3. Satu-satunya perbedaan adalah ini
opsi secara implisit termasuk ${osd-sym-cc}. Opsi ini diabaikan jika --osd-pesan3 is
tidak kosong.

--osd-playing-msg=
Tampilkan pesan di OSD saat pemutaran dimulai. String diperluas untuk properti,
misalnya --osd-playing-msg='file: ${namafile}' akan menampilkan pesan File: diikuti oleh
spasi dan nama file yang sedang diputar.

Lihat Milik Perluasan.

--osd-bar-align-x=<-1-1>
Posisi bilah OSD. -1 paling kiri, 0 di tengah, 1 paling kanan. pecahan
nilai (seperti 0.5) diperbolehkan.

--osd-bar-align-y=<-1-1>
Posisi bilah OSD. -1 di atas, 0 di tengah, 1 di bawah. Nilai pecahan
(seperti 0.5) diperbolehkan.

--osd-bar-w=<1-100>
Lebar bilah OSD, dalam persentase lebar layar (default: 75). Sebuah nilai dari
50 berarti bilahnya setengah lebar layar.

--osd-bar-h=<0.1-50>
Tinggi bilah OSD, dalam persentase tinggi layar (default: 3.125).

--osd-back-color= , --sub-text-back-color=
Lihat --osd-warna. Warna yang digunakan untuk OSD/latar belakang subteks.

--osd-blur=<0..20.0>, --sub-text-blur=<0..20.0>
Faktor blur Gaussian. 0 berarti tidak ada blur yang diterapkan (default).

--osd-bold= , --sub-teks-tebal=
Format teks dengan huruf tebal.

--osd-border-color= , --sub-text-border-color=
Lihat --osd-warna. Warna yang digunakan untuk batas font OSD/sub.

CATATAN:
diabaikan ketika --osd-kembali-warna/--sub-teks-kembali-warna ditentukan (atau lebih
persis: ketika opsi itu tidak disetel ke sepenuhnya transparan).

--osd-border-size= , --sub-text-border-size=
Ukuran batas font OSD/sub dalam piksel yang diskalakan (lihat --osd-font-ukuran untuk lebih jelasnya).
Nilai 0 menonaktifkan batas.

Standar: 3.

--osd-warna= , --sub-teks-warna=
Tentukan warna yang digunakan untuk subtitle teks OSD/tanpa gaya.

Warna ditentukan dalam bentuk r/g/b, di mana setiap komponen warna ditentukan
sebagai angka dalam kisaran 0.0 hingga 1.0. Ini juga memungkinkan untuk menentukan transparansi
dengan menggunakan r/g/b/a, di mana nilai alfa 0 berarti sepenuhnya transparan, dan 1.0 berarti
buram. Jika komponen alfa tidak diberikan, warnanya 100% buram.

Melewati satu nomor ke opsi menyetel OSD menjadi abu-abu, dan formulir abu-abu/a
memungkinkan Anda menentukan alpha tambahan.

contoh

· --osd-warna=1.0/0.0/0.0 atur OSD ke merah buram

· --osd-warna=1.0/0.0/0.0/0.75 atur OSD ke merah buram dengan alfa 75%

· --osd-warna = 0.5/0.75 atur OSD ke 50% abu-abu dengan 75% alpha

Atau, warna dapat ditentukan sebagai triplet heksagonal RGB dalam bentuk #RRGGBB,
di mana setiap grup 2 digit menyatakan nilai warna dalam rentang 0 (00) ke 255 (FF).
Sebagai contoh, # FF0000 berwarna merah. Ini mirip dengan warna web. Alfa diberikan dengan
#AARRGGBB.

contoh

· --osd-color='#FF0000' atur OSD ke merah buram

· --osd-color='#C0808080' atur OSD ke 50% abu-abu dengan 75% alpha

--osd-fraksi
Tampilkan waktu OSD dengan sepersekian detik (dalam presisi milidetik). Berguna untuk melihat
stempel waktu yang tepat dari bingkai video.

--osd-level=<0-3>
Menentukan mode mana OSD harus memulai.

0 OSD sepenuhnya dinonaktifkan (hanya subtitle)

1 diaktifkan (hanya muncul pada interaksi pengguna)

2 diaktifkan + waktu saat ini terlihat secara default

3 diaktifkan + --osd-status-pesan (waktu dan status saat ini secara default)

--osd-margin-x= , --sub-teks-margin-x=
Margin layar kiri dan kanan untuk OSD/subs dalam piksel yang diskalakan (lihat --osd-font-ukuran
untuk lebih jelasnya).

Opsi ini menentukan jarak OSD ke kiri, serta di mana
jarak dari batas kanan teks OSD yang panjang akan terputus.

Standar: 25.

--osd-margin-y= , --sub-teks-margin-y=
Margin layar atas dan bawah untuk OSD/subs dalam piksel yang diskalakan (lihat --osd-font-ukuran
untuk lebih jelasnya).

Opsi ini menentukan margin vertikal OSD. Ini juga digunakan untuk
subtitle teks tanpa gaya. Jika Anda hanya ingin menaikkan posisi subtitle vertikal,
menggunakan --sub-pos.

Standar: 22.

--osd-align-x= , --sub-teks-align-x=...
Kontrol ke sudut mana layar OSD atau teks terjemahan harus disejajarkan
(bawaan: pusat untuk kapal selam, meninggalkan untuk OSD).

Tidak pernah diterapkan pada subtitle ASS, kecuali di --no-sub-keledai mode. Demikian juga, ini
tidak berlaku untuk subtitle gambar.

--osd-align-y= --sub-teks-align-y=...
Posisi vertikal (default: dasar untuk kapal selam, puncak untuk OSD). Detail lihat
--osd-sejajarkan-x.

--osd-skala=
Pengganda ukuran font OSD, dikalikan dengan --osd-font-ukuran nilai.

--osd-scale-by-window=
Apakah akan menskalakan OSD dengan ukuran jendela (default: ya). Jika ini dinonaktifkan,
--osd-font-ukuran dan opsi OSD lainnya yang menggunakan piksel yang diskalakan selalu aktual
piksel. Efeknya adalah mengubah ukuran jendela tidak akan mengubah ukuran font OSD.

--osd-shadow-color= , --sub-teks-bayangan-warna=
Lihat --osd-warna. Warna yang digunakan untuk OSD/bayangan subteks.

--osd-shadow-offset= , --sub-text-shadow-offset=
Pergeseran bayangan OSD/sub teks dalam piksel berskala (lihat --osd-font-ukuran untuk
rincian). Nilai 0 menonaktifkan bayangan.

Standar: 0.

--osd-spasi= , --sub-text-spasi=
Spasi font OSD/sub horizontal dalam piksel yang diskalakan (lihat --osd-font-ukuran untuk lebih jelasnya).
Nilai ini ditambahkan ke spasi huruf normal. Nilai negatif diperbolehkan.

Standar: 0.

screenshot
--screenshot-format=
Atur jenis file gambar yang digunakan untuk menyimpan tangkapan layar.

Pilihan yang tersedia:

png PNG

ppm PPM

pgm PGM

pgmyuv PGM dengan format piksel YV12

tga HARTA

jpg JPEG (bawaan)

jpeg JPEG (sama seperti jpg, tetapi dengan akhiran file .jpeg)

--screenshot-tag-colorspace=
Tandai tangkapan layar dengan ruang warna yang sesuai.

Perhatikan bahwa tidak semua format didukung.

Default: tidak.

--screenshot-high-bit-depth=
Jika memungkinkan, tulis tangkapan layar dengan sedikit kedalaman yang mirip dengan video sumber
(standar: ya). Ini menarik khususnya untuk PNG, karena terkadang
memicu penulisan PNG 16 bit dengan ukuran file besar.

--screenshot-template=
Tentukan template nama file yang digunakan untuk menyimpan tangkapan layar. Template menentukan
nama file tanpa ekstensi file, dan dapat berisi penentu format, yang akan menjadi
diganti saat mengambil tangkapan layar. Secara default templatenya adalah tembakan mpv%n, yang
menghasilkan nama file seperti mpv-shot0012.png misalnya.

Templat dapat dimulai dengan jalur relatif atau absolut, untuk menentukan a
lokasi direktori tempat tangkapan layar harus disimpan.

Jika nama file tangkapan layar terakhir menunjuk ke file yang sudah ada, file tersebut akan
tidak ditimpa. Tangkapan layar tidak akan disimpan, atau jika template
mengandung %n, disimpan menggunakan nama file berbeda yang baru dibuat.

Penentu format yang diizinkan:

%[#][0X]n
Nomor urut, diisi dengan nol hingga panjang X (default: 04). Misalnya
melewati format %04n akan menghasilkan 0012 pada tangkapan layar ke-12. Nomor
bertambah setiap kali tangkapan layar diambil atau jika file sudah
ada. Panjangnya X harus dalam kisaran 0-9. Dengan tanda # opsional, mpv
akan menggunakan nomor terendah yang tersedia. Misalnya, jika Anda mengambil tiga
tangkapan layar--0001, 0002, 0003--dan hapus dua yang pertama, dua berikutnya
tangkapan layar tidak akan menjadi 0004 dan 0005, tetapi 0001 dan 0002 lagi.

%f Nama file dari video yang sedang diputar.

%F Sama dengan %f, tetapi hapus ekstensi file, termasuk titik.

%x Jalur direktori dari video yang sedang diputar. Jika videonya tidak ada di
sistem file (tetapi misalnya http://), ini diperluas ke string kosong.

%X{kebalikan}
Sama dengan %x, tetapi jika file video tidak ada di sistem file, kembalikan
string mundur di dalam {...}.

%p Waktu pemutaran saat ini, dalam format yang sama seperti yang digunakan di OSD. Hasilnya adalah
string berbentuk "HH:MM:SS". Misalnya, jika video pada saat itu
posisi 5 menit 34 detik, %p akan diganti dengan "00:05:34".

%P Mirip dengan %p, tetapi diperpanjang dengan waktu pemutaran dalam milidetik. Dia
diformat sebagai "HH:MM:SS.mmm", dengan "mmm" menjadi bagian milidetik dari
waktu pemutaran.

CATATAN:
Ini adalah cara sederhana untuk mendapatkan stempel waktu per frame yang unik. (Bingkai
angka akan lebih intuitif, tetapi tidak mudah diterapkan karena
format wadah biasanya menggunakan cap waktu untuk mengidentifikasi bingkai.)

%wX Tentukan waktu pemutaran saat ini menggunakan format string X. %p adalah seperti
%wH:%wM:%wS, dan %P adalah seperti %wH:%wM:%wS.%wT.

Sah format penentu:

%wH jam (diisi dengan 0 hingga dua digit)

% apa jam (tidak empuk)

%wM menit (00-59)

%wm total menit (termasuk jam, tidak seperti %wM)

%wS detik (00-59)

%ws total detik (termasuk jam dan menit)

%wf 'like' %ws, tetapi sebagai pelampung

% berat milidetik (000-999)

%tX Tentukan tanggal/waktu lokal saat ini menggunakan format X. format ini
specifier menggunakan UNIX waktu-waktu() berfungsi secara internal, dan menyisipkan
hasil melewati "%X" ke waktu luang. Sebagai contoh, % tm akan memasukkan nomor
bulan berjalan sebagai nomor. Anda harus menggunakan banyak %tX penentu untuk
buat string tanggal/waktu penuh.

%{menopang[:fallback teks]}
Masukkan nilai properti slave 'prop'. Misalnya %{nama file} adalah sama
as %f. Jika properti tidak ada atau tidak tersedia, teks kesalahan adalah
dimasukkan, kecuali jika fallback ditentukan.

%% Diganti dengan % karakter itu sendiri.

--screenshot-direktori=
Simpan tangkapan layar di direktori ini. Jalur ini digabungkan dengan nama file
dihasilkan oleh --screenshot-templat. Jika nama file template sudah mutlak,
direktori diabaikan.

Jika direktori tidak ada, itu dibuat pada tangkapan layar pertama. Jika memang
bukan direktori, kesalahan dihasilkan saat mencoba menulis tangkapan layar.

Opsi ini tidak disetel secara default, dan dengan demikian akan menulis tangkapan layar ke direktori
dari mana mpv dimulai. Dalam mode pseudo-gui (lihat SEMU GUI MODE), ini disetel
ke desktop.

--screenshot-jpeg-quality=<0-100>
Atur tingkat kualitas JPEG. Lebih tinggi berarti kualitas yang lebih baik. Standarnya adalah 90.

--screenshot-jpeg-source-chroma=
Tulis file JPEG dengan subsampling chroma yang sama dengan video (default: yes). Jika
dinonaktifkan, default libjpeg digunakan.

--screenshot-png-compression=<0-9>
Atur tingkat kompresi PNG. Lebih tinggi berarti kompresi yang lebih baik. Ini akan mempengaruhi
ukuran file dari file tangkapan layar tertulis dan waktu yang diperlukan untuk menulis
tangkapan layar. Kompresi yang terlalu tinggi mungkin membutuhkan waktu CPU yang cukup untuk menginterupsi
pemutaran. Standarnya adalah 7.

--screenshot-png-filter=<0-5>
Atur filter yang diterapkan sebelum kompresi PNG. 0 tidak ada, 1 adalah "sub", 2 adalah "naik",
3 adalah "rata-rata", 4 adalah "Paeth", dan 5 adalah "campuran". Hal ini mempengaruhi tingkat
kompresi yang dapat dicapai. Untuk sebagian besar gambar, "campuran" mencapai yang terbaik
rasio kompresi, maka itu adalah default.

Perangkat lunak Scaler
--sws-scaler=
Tentukan algoritme penskala perangkat lunak yang akan digunakan dengan --vf=skala. Ini juga mempengaruhi
driver output video yang tidak memiliki akselerasi perangkat keras, mis x11. Lihat juga
--vf=skala.

Untuk mendapatkan daftar scaler yang tersedia, jalankan --sws-scaler=bantuan.

Default: bikubik.

--sws-lgb=<0-100>
Perangkat lunak scaler Gaussian blur filter (luma). Melihat --sws-scaler.

--sws-cgb=<0-100>
Perangkat lunak scaler Gaussian blur filter (chroma). Melihat --sws-scaler.

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

--sws-cs=<-100-100>
Software scaler mempertajam filter (chroma). Melihat --sws-scaler.

--sws-chs=
Pergeseran horizontal chroma scaler perangkat lunak. Melihat --sws-scaler.

--sws-cvs=
Pemindahan vertikal chroma scaler perangkat lunak. Melihat --sws-scaler.

terminal
--diam
Jadikan keluaran konsol kurang bertele-tele; khususnya, mencegah garis status (yaitu AV:
3.4 (00:00:03.37) / 5320.6 ...) tidak ditampilkan. Sangat berguna saat lambat
terminal atau yang rusak yang tidak menangani pengangkutan kembali dengan benar (mis \r).

Juga lihat --sepi banget dan --tingkat-pesan.

--sepi banget
Tampilkan lebih sedikit output dan pesan status dibandingkan dengan --diam.

--tanpa terminal, --terminal
Nonaktifkan penggunaan terminal dan stdin/stdout/stderr. Ini benar-benar diam
setiap keluaran pesan.

Berbeda --sepi banget, ini juga menonaktifkan input dan inisialisasi terminal.

--tidak ada-pesan-warna
Nonaktifkan keluaran konsol berwarna-warni pada terminal.

--msg-level=
Kontrol verbositas secara langsung untuk setiap modul. Itu semua modul mengubah verbositas dari
semua modul tidak secara eksplisit ditentukan pada baris perintah.

Jalankan mpv dengan --msg-level=semua=lacak untuk melihat semua pesan keluaran mpv. Anda dapat menggunakan
nama modul dicetak dalam output (diawali dengan setiap baris di [...]) untuk membatasi
output ke modul yang menarik.

CATATAN:
Beberapa pesan dicetak sebelum baris perintah diuraikan dan oleh karena itu
tidak terpengaruh oleh --tingkat-pesan. Untuk mengontrol pesan-pesan ini, Anda harus menggunakan
MPV_VERBOSE variabel lingkungan; Lihat LINGKUNGAN VARIABEL untuk rincian.

Level yang tersedia:

tidak keheningan total

fatal hanya pesan fatal

kesalahan pesan kesalahan

memperingatkan pesan peringatan

Info pesan informasi

status pesan status (default)

v pesan bertele-tele

men-debug pesan debug

jejak pesan debug yang sangat bising

--istilah-osd, --tidak ada istilah-osd, --term-osd=kekuatan
Tampilkan pesan OSD di konsol saat tidak ada output video yang tersedia. Diaktifkan oleh
standar.

kekuatan mengaktifkan OSD terminal bahkan jika jendela video dibuat.

--istilah-osd-bar, --no-istilah-osd-bar
Aktifkan pencetakan bilah kemajuan di bawah baris status pada terminal. (Dinonaktifkan oleh
bawaan.)

--term-osd-bar-chars=
menyesuaikan --term-osd-bar fitur. String diharapkan terdiri dari 5
karakter (mulai, spasi kiri, indikator posisi, spasi kanan, akhir). Kamu dapat memakai
Karakter Unicode, tetapi perhatikan bahwa karakter lebar ganda tidak akan diperlakukan
benar.

Default: [-+-].

--term-playing-msg=
Cetak string setelah memulai pemutaran. String diperluas untuk properti,
misalnya --term-playing-msg='file: ${namafile}' akan mencetak string File: diikuti oleh
spasi dan nama file yang sedang diputar.

Lihat Milik Perluasan.

--term-status-msg=
Cetak string khusus selama pemutaran alih-alih garis status standar.
Memperluas properti. Melihat Milik Perluasan.

--msg-modul
Tambahkan nama modul ke setiap pesan konsol.

--waktu-pesan
Tambahkan informasi waktu ke setiap pesan konsol.

TV
--televisi-...
Opsi ini menyetel berbagai properti modul pengambilan TV. Untuk menonton TV
dengan mpv, gunakan televisi:// or televisi:// atau bahkan televisi:// (Lihat
Option saluran TV untuk nama saluran di bawah) sebagai URL media. Anda juga bisa menggunakan
televisi:/// untuk mulai menonton video dari input komposit atau S-Video (lihat
Option memasukkan untuk lebih jelasnya).

--tv-perangkat=
Tentukan perangkat TV (default: / dev / video0).

--tv-channel=
Setel penyetel ke saluran.

--tidak-tv-audio
tidak ada suara

--tv-automute=<0-255> (v4l dan v4l2 saja)
Jika kekuatan sinyal yang dilaporkan oleh perangkat kurang dari nilai ini, audio dan video akan
dibungkam. Dalam kebanyakan kasus, automute=100 sudah cukup. Defaultnya adalah 0 (otomatis
dengan disabilitas).

--tv-driver=
Lihat --tv=driver=bantuan untuk daftar driver input TV yang dikompilasi. tersedia: boneka,
v4l2 (default: deteksi otomatis)

--tv-input=
Tentukan input (default: 0 (TV), lihat output konsol untuk input yang tersedia).

--tv-freq=
Tentukan frekuensi untuk menyetel tuner (mis. 511.250). Tidak kompatibel dengan
parameter saluran.

--tv-outfmt=
Tentukan format output tuner dengan nilai preset yang didukung oleh V4L
driver (YV12, UYVY, YUY2, I420) atau format arbitrer yang diberikan sebagai nilai hex.

--lebar-tv=
lebar jendela keluaran

--tinggi tv=
tinggi jendela keluaran

--tv-fps=
framerate di mana untuk menangkap video (frame per detik)

--tv-buffersize=
ukuran maksimum buffer pengambilan dalam megabita (default: dinamis)

--tv-norma=
Lihat keluaran konsol untuk daftar semua norma yang tersedia, juga lihat norma
pilihan di bawah ini.

--tv-normid= (v4l2 saja)
Menyetel norma TV ke ID numerik yang diberikan. Norma TV tergantung pada kartu pengambilan.
Lihat keluaran konsol untuk daftar norma TV yang tersedia.

--tv-chanlist=
tersedia: argentina, australia, china-bcast, eropa-timur, eropa-barat, perancis,
irlandia, italia, japan-bcast, jepang-kabel, selandia baru, rusia, afrika selatan,
us-bcast, us-kabel, us-kabel-hrc

--saluran-tv= - [= ], - [= ],...
Tetapkan nama untuk saluran.

CATATAN:
Jika adalah bilangan bulat yang lebih besar dari 1000, itu akan diperlakukan sebagai frekuensi (dalam
kHz) daripada nama saluran dari tabel frekuensi. Gunakan _ untuk spasi dalam nama
(atau mainkan dengan mengutip ;-)). Nama saluran kemudian akan ditulis menggunakan OSD,
dan perintah budak tv_step_channel, tv_set_channel dan tv_saluran_terakhir akan
dapat digunakan untuk remote control. Tidak kompatibel dengan frekuensi parameter.

CATATAN:
Nomor saluran kemudian akan menjadi posisi dalam daftar 'saluran', mulai
dengan 1.

contoh

televisi://1, televisi://TV1, tv_set_channel 1, tv_set_channel TV1

--tv-[brightness|contrast|hue|saturation]=<-100-100>
Atur equalizer gambar pada kartu.

--tv-audiorate=
Setel laju sampel audio input.

--tv-forceaudio
Tangkap audio meskipun tidak ada sumber audio yang dilaporkan oleh v4l.

--tv-alsa
Tangkap dari ALSA.

--tv-amode=<0-3>
Pilih mode audio:

0 mono

1 stereo

2 bahasa 1

3 bahasa 2

--tv-forcechan=<1-2>
Secara default, jumlah saluran audio yang direkam ditentukan secara otomatis oleh
menanyakan mode audio dari kartu TV. Opsi ini memungkinkan pemaksaan stereo/mono
merekam terlepas dari opsi amode dan nilai yang dikembalikan oleh v4l. Ini bisa
digunakan untuk pemecahan masalah ketika kartu TV tidak dapat melaporkan audio saat ini
mode.

--tv-perangkat=
Setel perangkat audio. seharusnya /dev/xxx untuk OSS dan ID perangkat keras untuk ALSA.
Anda harus mengganti ':' dengan '.' dalam ID perangkat keras untuk ALSA.

--tv-audioid=
Pilih output audio dari kartu pengambilan, jika memiliki lebih dari satu.

--tv-[volume|bass|treble|balance]=<0-100>
Opsi ini mengatur parameter mixer pada kartu pengambilan video. Mereka akan
tidak berpengaruh, jika kartu Anda tidak memilikinya. Untuk v4l2 50 peta ke default
nilai kontrol, seperti yang dilaporkan oleh pengemudi.

--tv-gain=<0-100>
Atur kontrol penguatan untuk perangkat video (biasanya webcam) ke nilai yang diinginkan dan
matikan kontrol otomatis. Nilai 0 memungkinkan kontrol otomatis. Jika ini
opsi dihilangkan, kontrol gain tidak akan diubah.

--tv-immediatemode=
Nilai 0 berarti menangkap dan menyangga audio dan video secara bersamaan. Nilai 1
(default) berarti melakukan pengambilan video saja dan membiarkan audio melalui loopback
kabel dari kartu TV ke kartu suara.

--tv-mjpeg
Gunakan kompresi MJPEG perangkat keras (jika kartu mendukungnya). Saat menggunakan opsi ini,
Anda tidak perlu menentukan lebar dan tinggi jendela keluaran, karena mpv
akan menentukannya secara otomatis dari nilai penipisan (lihat di bawah).

--tv-decimation=<1|2|4>
pilih ukuran gambar yang akan dikompresi oleh perangkat keras MJPEG
kompresi:

1 ukuran penuh

· 704x576 Kawan

· 704x480 NTSC

2 ukuran sedang

· 352x288 Kawan

· 352x240 NTSC

4 ukuran kecil

· 176x144 Kawan

· 176x120 NTSC

--kualitas tv=<0-100>
Pilih kualitas kompresi JPEG (<60 disarankan untuk ukuran penuh).

--tv-scan-mulai otomatis
Mulai pemindaian saluran segera setelah pengaktifan (default: dinonaktifkan).

--tv-scan-period=<0.1-2.0>
Tentukan penundaan dalam detik sebelum beralih ke saluran berikutnya (default: 0.5). Lebih rendah
nilai akan menyebabkan pemindaian lebih cepat, tetapi dapat mendeteksi saluran TV yang tidak aktif sebagai aktif.

--tv-scan-threshold=<1-100>
Nilai ambang batas untuk kekuatan sinyal (dalam persen), seperti yang dilaporkan oleh perangkat
(standar: 50). Kekuatan sinyal yang lebih tinggi dari nilai ini akan menunjukkan bahwa
saluran pemindaian saat ini aktif.

Cache
--cache=
Atur ukuran cache dalam kilobyte, nonaktifkan dengan tidak, atau aktifkan secara otomatis
itu jika diperlukan dengan mobil (bawaan: mobil). Dengan mobil, cache biasanya akan
diaktifkan untuk aliran jaringan, menggunakan ukuran yang ditetapkan oleh --cache-default. Dengan iya nih, yang
cache akan selalu diaktifkan dengan ukuran yang disetel oleh --cache-default (kecuali jika
aliran tidak dapat di-cache, atau --cache-default menonaktifkan caching).

Mungkin berguna saat memutar file dari media lambat, tetapi bisa juga negatif
efek, terutama dengan format file yang membutuhkan banyak pencarian, seperti MP4.

Perhatikan bahwa setengah ukuran cache akan digunakan untuk memungkinkan pencarian cepat kembali. Ini juga
alasan mengapa cache penuh biasanya tidak dilaporkan sebagai 100% penuh. Isi cache
tampilan tidak termasuk bagian dari cache yang disediakan untuk pencarian kembali. Itu
persentase maksimum aktual biasanya akan menjadi rasio antara readahead dan
ukuran penyangga belakang.

--cache-default=
Atur ukuran cache dalam kilobyte (default: 75000 KB). Menggunakan tidak tidak akan
secara otomatis mengaktifkan cache, misalnya saat memutar dari aliran jaringan. Perhatikan bahwa
menggunakan --cache akan selalu menimpa opsi ini.

--cache-initial=
Pemutaran akan dimulai ketika cache telah diisi dengan kilobyte sebanyak ini
data (bawaan: 0).

--cache-seek-min=
Jika pencarian harus dilakukan untuk posisi di dalam dari ukuran cache dari
posisi saat ini, mpv akan menunggu cache diisi ke posisi ini
daripada melakukan pencarian aliran (default: 500).

Ini penting untuk small forward seek. Dengan aliran lambat (terutama aliran HTTP)
ada tradeoff antara melewatkan data antara posisi saat ini dan mencari
tujuan, atau melakukan pencarian yang sebenarnya. Tergantung pada situasinya, salah satu dari
ini mungkin lebih lambat daripada metode lainnya. Opsi ini memungkinkan kontrol atas ini.

--cache-backbuffer=
Ukuran cache back buffer (default: 75000 KB). Ini akan menambah total cache
ukuran, dan memesan jumlah untuk mencari kembali. Jumlah yang dipesan tidak akan
digunakan untuk readahead, dan sebagai gantinya menyimpan data yang sudah dibaca untuk memungkinkan pencarian cepat
kembali.

--cache-file=
Buat file cache pada sistem file.

Ada dua cara untuk menggunakan ini:

1. Melewati jalur (nama file). File akan selalu ditimpa. Ketika
cache umum diaktifkan, cache file ini akan digunakan untuk menyimpan apa pun yang dibaca
dari aliran sumber.

Ini akan selalu menimpa file cache, dan Anda tidak dapat menggunakan cache yang ada
file untuk melanjutkan pemutaran streaming. (Secara teknis, mpv bahkan tidak akan tahu yang mana
blok dalam file valid dan mana yang tidak.)

File yang dihasilkan belum tentu berisi semua data dari aliran sumber.
Misalnya, jika Anda mencari, bagian yang dilewati tidak pernah dibaca dan
akibatnya tidak ditulis ke cache. Bagian yang dilewati terisi
dengan nol. Ini berarti bahwa file cache tidak selalu sesuai dengan a
unduhan penuh aliran sumber.

Kedua masalah ini dapat diperbaiki jika ada minat pengguna.

PERINGATAN:
Menyebabkan kerusakan acak saat digunakan dengan bab yang dipesan atau dengan
--file audio.

2. Melewati string tmp. Ini tidak akan ditafsirkan sebagai nama file. Sebagai gantinya, sebuah
file sementara tak terlihat dibuat. Itu tergantung pada perpustakaan C Anda di mana ini
file dibuat (biasanya / tmp /), dan apakah nama file terlihat ( file tmp()
fungsi yang digunakan). Pada beberapa sistem, penghapusan otomatis file cache mungkin
tidak dijamin.

Jika Anda ingin menggunakan cache file, mode ini disarankan, karena tidak
pecahkan bab yang dipesan atau --file audio. Mode ini membuka beberapa aliran cache,
dan menggunakan file yang sama untuk mereka jelas bentrok.

Juga lihat --cache-file-ukuran.

--cache-file-size=
Ukuran maksimum file yang dibuat dengan --file-cache. Untuk akses baca di atas ini
ukuran, cache sama sekali tidak digunakan.

Ingatlah bahwa beberapa kasus penggunaan, seperti memainkan bab yang diurutkan dengan cache diaktifkan,
benar-benar akan membuat beberapa file cache, yang masing-masing akan menggunakan hingga sebanyak ini
ruang disk.

(Bawaan: 1048576, 1 GB.)

--tanpa cache
Matikan cache aliran input. Melihat --cache.

--cache-secs=
Berapa detik audio/video yang akan diambil jika cache aktif. Ini menimpa
itu --demuxer-readahead-detik opsi jika dan hanya jika cache diaktifkan dan
nilainya lebih besar. (Bawaan: 10.)

--cache-jeda, --tidak ada-cache-jeda
Apakah pemutar harus secara otomatis berhenti saat cache hampir habis, dan membatalkan jeda
sekali lagi data tersedia ("buffering").

jaringan
--agen-pengguna=
penggunaan sebagai agen pengguna untuk streaming HTTP.

--kue, --tanpa-kue
Mendukung cookie saat membuat permintaan HTTP. Dinonaktifkan secara default.

--cookies-file=
Baca cookie HTTP dari . File diasumsikan dalam format Netscape.

--http-header-fields=
Setel bidang HTTP khusus saat mengakses aliran HTTP.

Example

mpv --http-header-fields='Field1: value1','Field2: value2' \
http://localhost: 1234

Akan menghasilkan permintaan HTTP:

GET / HTTP / 1.0
Tuan rumah: localhost:1234
Agen-Pengguna: MPlayer
Es-MetaData: 1
Bidang1: nilai1
Bidang2: nilai2
Koneksi: tutup

--tls-ca-file=
File database otoritas sertifikat untuk digunakan dengan TLS. (Diam-diam gagal dengan yang lebih tua
Versi FFmpeg atau Libav.)

--tls-verifikasi
Verifikasi sertifikat rekan saat menggunakan TLS (mis. dengan https://...). (Diam-diam gagal
dengan versi FFmpeg atau Libav yang lebih lama.)

--tls-cert-file
File yang berisi sertifikat untuk digunakan dalam jabat tangan dengan rekan.

--tls-kunci-file
File yang berisi kunci pribadi untuk sertifikat.

--perujuk=
Tentukan jalur perujuk atau URL untuk permintaan HTTP.

--waktu habis jaringan=
Tentukan batas waktu jaringan dalam hitungan detik. Ini mempengaruhi setidaknya HTTP. yang spesial
nilai 0 (default) menggunakan default FFmpeg/Libav. Jika protokol digunakan yang tidak
tidak mendukung batas waktu, opsi ini diabaikan secara diam-diam.

--rtsp-transport=
Pilih metode transportasi RTSP (default: tcp). Ini memilih jaringan yang mendasarinya
transportasi saat bermain rtsp://... URL. Nilai lavf meninggalkan keputusan untuk
format libav

--hls-bitrate= >
Jika aliran HLS diputar, opsi ini mengontrol aliran apa yang dipilih oleh
bawaan. Opsi ini memungkinkan parameter berikut:

tidak Jangan melakukan sesuatu yang istimewa. Biasanya, ini hanya akan memilih yang pertama
aliran audio/video yang dapat ditemukan.

menit Pilih streaming dengan bitrate terendah.

max Sama, tetapi bitrate tertinggi. (Bawaan.)

Selain itu, jika opsinya adalah angka, aliran dengan tingkat tertinggi sama atau
di bawah nilai opsi dipilih.

Bitrate yang digunakan dikirim oleh server, dan tidak ada jaminan itu benar-benar
berarti.

DVB
--dvbin-card=<1-4>
Menentukan menggunakan nomor kartu 1-4 (default: 1).

--dvbin-file=
Menginstruksikan mpv untuk membaca daftar saluran dari . Defaultnya ada di mpv
direktori konfigurasi (biasanya ~/.config/mpv) dengan nama file
channel.conf.{sat,ter,cbl,atsc} (berdasarkan jenis kartu Anda) atau saluran.conf sebagai
Resort terakhir. Untuk kartu DVB-S/2, daftar saluran format VDR 1.7.x direkomendasikan sebagai
memungkinkan penyetelan ke saluran DVB-S2, mengaktifkan subtitle dan mendekode PMT (yang
sebagian besar meningkatkan demuxing). Daftar saluran format mplayer klasik masih
didukung (tanpa peningkatan ini), dan untuk jenis kartu lainnya, hanya VDR . terbatas
format dukungan daftar saluran diimplementasikan (tambalan selamat datang). Untuk saluran dengan
peralihan PID dinamis atau tidak lengkap saluran.conf, --dvbin-transponder penuh atau itu
PID ajaib 8192 direkomendasikan

--dvbin-timeout=<1-30>
Jumlah detik maksimum untuk menunggu saat mencoba menyetel frekuensi sebelum menyerah
(standar: 30).

--dvbin-full-transponder=
Tidak menerapkan filter pada PID program, hanya menyetel frekuensi dan melewatkan transponder penuh
untuk demuxer. Ini berguna untuk merekam beberapa program pada satu transponder, atau
untuk mengatasi masalah di saluran.conf. Disarankan juga untuk menggunakan ini untuk
saluran yang mengalihkan PID saat itu juga, misalnya untuk berita regional.

Default: tidak

bermacam-macam
--display-tags=tag1,tag2,...
Atur daftar tag yang harus ditampilkan di terminal. Tag yang ada di
list, tetapi tidak ada dalam file yang diputar, tidak akan ditampilkan. Jika suatu nilai berakhir
dengan *, semua tag dicocokkan dengan awalan (meskipun tidak ada globbing umum). Hanya
lewat * dasarnya penyaringan.

Defaultnya mencakup daftar tag yang umum, panggil mpv dengan --daftar-opsi untuk melihatnya.

--mc=
Koreksi sinkronisasi AV maksimum per frame (dalam detik)

--sinkronisasi otomatis=
Menyesuaikan sinkronisasi A/V secara bertahap berdasarkan pengukuran penundaan audio. Menentukan
--sinkronisasi otomatis=0, defaultnya, akan menyebabkan pengaturan waktu bingkai didasarkan sepenuhnya pada audio
pengukuran penundaan. Menentukan --sinkronisasi otomatis=1 akan melakukan hal yang sama, tetapi akan secara halus
mengubah algoritma koreksi A/V. Framerate video yang tidak merata dalam video yang
bermain baik dengan --tidak ada suara sering dapat dibantu dengan menyetel ini ke nilai integer
lebih besar dari 1. Semakin tinggi nilainya, semakin dekat waktunya dengan --tidak ada suara.
Mencoba --sinkronisasi otomatis=30 untuk memuluskan masalah dengan driver suara yang tidak diimplementasikan
pengukuran penundaan audio yang sempurna. Dengan nilai ini, jika offset sinkronisasi A/V besar
terjadi, mereka hanya akan memakan waktu sekitar 1 atau 2 detik untuk diselesaikan. Keterlambatan ini
waktu reaksi untuk offset A/V yang tiba-tiba harus menjadi satu-satunya efek samping dari memutar ini
opsi aktif, untuk semua driver suara.

--video-sinkronisasi=
Bagaimana pemutar menyinkronkan audio dan video.

Mode dimulai dengan pajangan coba keluarkan bingkai video sepenuhnya
secara sinkron ke tampilan, menggunakan kecepatan refresh vertikal tampilan yang terdeteksi sebagai
petunjuk seberapa cepat frame akan ditampilkan rata-rata. Mode ini mengubah kecepatan video
sedikit agar sesuai dengan tampilan. Melihat --video-sinkronisasi-... pilihan untuk fine tuning. Itu
ketahanan mode ini selanjutnya dikurangi dengan membuat beberapa asumsi ideal,
yang mungkin tidak selalu berlaku dalam kenyataan. Perilaku dapat bergantung pada VO dan
driver video dan audio sistem. File media harus menggunakan framerate konstan.
Bagian-bijaksana VFR mungkin bekerja dengan baik dengan beberapa format wadah (tetapi tidak misalnya mkv).
Jika kode sinkronisasi mendeteksi desinkronisasi A/V yang parah, atau kecepatan bingkai tidak dapat dideteksi,
pemain secara otomatis kembali ke audio mode untuk beberapa waktu atau permanen.

Mode dengan desinkronisasi dalam nama mereka jangan mencoba untuk menjaga sinkronisasi audio/video.
Mereka akan perlahan (atau cepat) desync, sampai misalnya pencarian berikutnya terjadi. Mode ini
dimaksudkan untuk pengujian, bukan penggunaan yang serius.

audio Waktu bingkai video ke audio. Ini adalah mode yang paling kuat, karena pemain
tidak harus mengasumsikan apa pun tentang bagaimana tampilan berperilaku. Itu
kerugiannya adalah dapat menyebabkan penurunan atau pengulangan bingkai sesekali. Jika
audio dinonaktifkan, ini menggunakan jam sistem. Ini adalah mode default.

tampilan-sampel
Sampel ulang audio agar sesuai dengan video. Mode ini juga akan mencoba menyesuaikan audio
kecepatan untuk mengkompensasi drift lainnya. (Ini berarti akan memutar audio di
kecepatan yang berbeda sesekali untuk mengurangi perbedaan A/V.)

tampilan-contoh-vdrop
Sampel ulang audio agar sesuai dengan video. Jatuhkan bingkai video untuk mengimbangi
melayang.

tampilan-resample-desync
Seperti mode sebelumnya, tetapi tidak ada kompensasi A/V.

tampilan-vdrop
Jatuhkan atau ulangi bingkai video untuk mengompensasi desinkronisasi video. (Walaupun itu
harus memiliki efek yang sama dengan audio, implementasinya sangat
berbeda.)

tampilan-adrop
Jatuhkan atau ulangi data audio untuk mengimbangi desinkronisasi video. Melihat
--sinkronisasi video-ukuran drop. Mode ini akan menyebabkan artefak audio yang parah jika
kecepatan refresh monitor nyata terlalu berbeda dari kecepatan yang dilaporkan atau dipaksakan.

tampilan-desinkronisasi
Sinkronkan video untuk ditampilkan, dan biarkan audio diputar sendiri.

desinkronisasi Sinkronkan video sesuai dengan jam sistem, dan biarkan audio diputar sendiri.

--video-sync-max-video-change=
Perbedaan kecepatan maksimum dalam persen yang diterapkan pada video dengan
--video-sync=tampilan-... (bawaan: 1). Mode sinkronisasi tampilan akan dinonaktifkan jika
monitor dan cara refresh video tidak cocok dalam rentang yang diberikan. Ini mencoba
kelipatan juga: memutar video 30 fps pada layar 60 Hz akan menduplikasi setiap
bingkai kedua. Memutar video 24 fps pada layar 60 Hz akan memutar video dalam in
2-3-2-3-... pola.

Pengaturan default tidak cukup longgar untuk mempercepat video 23.976 fps menjadi 25 fps.
Kami menganggap perubahan nada terlalu ekstrem untuk memungkinkan perilaku ini secara default. Mengatur
opsi ini ke nilai 5 untuk mengaktifkannya.

Perhatikan bahwa di --video-sync=tampilkan ulang sampel mode, kecepatan audio juga akan
diubah sedikit jika perlu untuk sinkronisasi A/V. Melihat
--sinkronisasi video-maks-perubahan audio.

--video-sync-max-audio-change=
Maksimum tambahan perbedaan kecepatan dalam persen yang diterapkan ke audio dengan
--video-sync=tampilan-... (default: 0.125). Biasanya, pemutar memutar audio di
kecepatan videonya. Tetapi jika perbedaan antara posisi audio dan video adalah
terlalu tinggi, misalnya karena drift atau kesalahan waktu lainnya, itu akan mencoba untuk mempercepat atau
memperlambat audio dengan faktor tambahan ini. Nilai yang terlalu rendah dapat menyebabkan bingkai video
jatuh atau berulang jika desinkronisasi A/V tidak dapat dikompensasi, nilai terlalu tinggi
dapat menyebabkan penurunan bingkai yang kacau karena audio "overshooting" dan skipping
beberapa bingkai video sebelum logika sinkronisasi dapat bereaksi.

--video-sync-adrop-size=
Untuk --video-sync=tampilan-adrop mode. Mode ini menggandakan/menjatuhkan data audio ke
menjaga audio tetap sinkron dengan video. Untuk menghindari artefak audio pada jitter (yang akan
menambah/menghapus sampel setiap saat), ini dilakukan dalam unit yang relatif besar, tetap,
dikendalikan oleh opsi ini. Satuannya adalah detik.

--mf-fps=
Framerate digunakan saat decoding dari beberapa file PNG atau JPEG dengan mf:// (bawaan:
1).

--mf-type=
Masukkan jenis file untuk mf:// (tersedia: jpeg, png, tga, sgi). Secara default, ini adalah
ditebak dari ekstensi file.

--stream-capture=
Memungkinkan pengambilan aliran utama (bukan trek audio tambahan atau jenis . lainnya)
stream) ke dalam file yang diberikan. Menangkap juga dapat dimulai dan dihentikan dengan mengubah
nama file dengan tangkapan arus milik budak. Umumnya ini tidak akan
menghasilkan hasil yang dapat digunakan untuk apa pun selain MPEG atau aliran mentah, kecuali menangkap
termasuk header file dan tidak terganggu. Perhatikan bahwa, karena cache
latensi, data yang diambil mungkin mulai dan berakhir agak tertunda dibandingkan dengan apa yang Anda
lihat ditampilkan.

File tujuan selalu ditambahkan. (Sebelum mpv 0.8.0, file tersebut
ditimpa.)

--stream-dump=
Sama dengan --stream-tangkap, tetapi jangan memulai pemutaran. Sebaliknya, seluruh file adalah
dibuang.

--stream-lavf-o=opt1=nilai1,opt2=nilai2,...
Setel AVOptions pada aliran yang dibuka dengan format libav. Opsi yang tidak diketahui atau salah eja adalah
diam-diam diabaikan. (Mereka disebutkan dalam output terminal dalam mode verbose, yaitu
--v. Secara umum kami tidak dapat mencetak kesalahan, karena opsi lain seperti misalnya pengguna
agen tidak tersedia dengan semua protokol, dan kesalahan pencetakan untuk opsi yang tidak diketahui
akan menjadi terlalu berisik.)

--vo-mmcss-profile=
(Khusus Windows.) Setel profil MMCSS untuk utas penyaji video (default:
Putar).

--prioritas=
(Khusus Windows.) Atur prioritas proses untuk mpv sesuai dengan yang telah ditentukan
prioritas tersedia di bawah Windows.

Nilai yang mungkin dari : idle|di bawah normal|normal|di atas normal|tinggi|realtime

PERINGATAN:
Menggunakan prioritas waktu nyata dapat menyebabkan penguncian sistem.

--force-media-title=
Paksa isi judul media properti untuk nilai ini. Berguna untuk skrip
yang ingin menetapkan judul, tanpa mengesampingkan pengaturan pengguna di --judul.

AUDIO KELUARAN DRIVERS

Driver output audio adalah antarmuka ke fasilitas output audio yang berbeda. Sintaksnya adalah:

--ao=
Tentukan daftar prioritas driver output audio yang akan digunakan.

Jika daftar memiliki tanda ',', mpv akan kembali ke driver yang tidak ada dalam daftar.
Subopsi adalah opsional dan sebagian besar dapat dihilangkan.

Anda juga dapat mengatur default untuk setiap driver. Default diterapkan sebelum normal
parameter pengemudi.

--ao-default=
Tetapkan default untuk setiap driver.

CATATAN:
Lihat --ao=tolong untuk daftar driver output audio yang dikompilasi. Supir --ao=alsa is
disukai. --ao=pulsa lebih disukai pada sistem di mana PulseAudio digunakan. Di Windows,
--ao=wasapi lebih disukai, meskipun kadang-kadang dapat menyebabkan masalah, dalam hal ini
--ao=suara seharusnya digunakan. Pada sistem BSD, --ao=oss or --ao=sndio` dapat bekerja (
terakhir menjadi eksperimental). Pada sistem OS X, gunakan --ao=coreaudio.

contoh

· --ao=alsa,oss, Coba driver ALSA, lalu driver OSS, lalu yang lain.

· --ao=alsa:resample=yes:device=[plughw:0,3] Mari ALSA sampel ulang dan set
nama perangkat sebagai kartu pertama, perangkat keempat.

Driver output audio yang tersedia adalah:

juga (Linux saja)
Pengemudi keluaran audio ALSA

perangkat=
Menyetel nama perangkat. Untuk keluaran ac3 melalui S/PDIF, gunakan "iec958" atau "spidif"
perangkat, kecuali Anda benar-benar tahu cara mengaturnya dengan benar.

sampel ulang = ya
Aktifkan plugin resampling ALSA. (Ini dinonaktifkan secara default, karena beberapa
driver melaporkan penundaan audio yang salah dalam beberapa kasus.)

perangkat mixer=
Atur perangkat mixer yang digunakan dengan --tidak-softvol (bawaan: kegagalan).

nama-pencampur =
Tetapkan nama elemen mixer (default: Menguasai). Ini contohnya PCM
or Menguasai.

indeks-pencampur=
Atur indeks saluran mixer (default: 0). Perhatikan keluaran dari
"pengaduk kontrol", maka indeks adalah angka yang mengikuti nama
elemen.

tidak disisipkan
Izinkan output format non-interleaved (jika dekoder audio menggunakan ini
format). Saat ini dinonaktifkan secara default, karena beberapa plugin ALSA yang populer
benar-benar rusak dengan format non-interleaved.

abaikan-chmap
Jangan membaca atau mengatur peta saluran perangkat ALSA - hanya minta
jumlah saluran yang diperlukan, lalu berikan audio apa adanya. Ini
opsi kemungkinan besar tidak boleh digunakan. Ini dapat berguna untuk debugging, atau
untuk pengaturan statis dengan konfigurasi ALSA yang dirancang khusus (dalam hal ini
jika Anda harus selalu memaksakan tata letak yang sama dengan --saluran-audio, atau itu
hanya akan berfungsi untuk file yang menggunakan tata letak implisit ke perangkat ALSA Anda).

CATATAN:
MPlayer dan mplayer2 mengharuskan Anda mengganti ',' dengan '.' dan ':' dengan
'=' dalam nama perangkat ALSA. mpv tidak melakukan ini lagi. Sebagai gantinya, kutip
nama perangkat:
--ao=alsa:perangkat=[plug:surround50]

Perhatikan bahwa [ dan ] cukup kutip nama perangkat. Dengan beberapa shell (seperti zsh),
anda harus mengutip string opsi untuk mencegah Shell menafsirkan
kurung alih-alih meneruskannya ke mpv.

Sebenarnya, Anda harus menggunakan --perangkat audio pilihan, alih-alih mengatur
perangkat secara langsung.

PERINGATAN:
Penanganan audio multichannel/surround berubah di mpv 0.8.0 dari perilaku
di MPlayer/mplayer2 dan versi mpv yang lebih lama.

Perilaku lama adalah bahwa pemutar selalu di-downmix ke stereo secara default. Itu
--saluran-audio (Atau --saluran sebelum itu) opsi harus disetel untuk mendapatkan
audio multisaluran. Kemudian memutar stereo akan menggunakan kegagalan perangkat (yang
biasanya memungkinkan beberapa program untuk memutar audio secara bersamaan melalui dmix),
saat memainkan apa pun dengan lebih banyak saluran akan membuka salah satu perangkat keras
perangkat, misalnya melalui mengelilingi51 alias (biasanya dengan akses eksklusif).
Apakah pemain akan menggunakan akses eksklusif atau tidak akan tergantung pada file
sedang dimainkan.

Perilaku baru sejak mpv 0.8.0 selalu mengaktifkan audio multisaluran, yaitu
--audio-channels=otomatis adalah default. Namun, karena ALSA tidak menyediakan cara yang baik
untuk memutar audio multisaluran dengan cara non-eksklusif (tanpa memblokir
aplikasi dari menggunakan audio), pemutar dibatasi pada kemampuan
itu kegagalan perangkat secara default, yang berarti hanya mendukung stereo dan mono (at
paling tidak dengan konfigurasi ALSA tipikal saat ini). Tetapi jika perangkat keras adalah
dipilih, maka audio multisaluran biasanya akan berfungsi.

Singkat cerita: jika Anda ingin audio multichannel dengan ALSA, gunakan --perangkat audio
untuk memilih perangkat (gunakan --audio-device=bantuan untuk mendapatkan daftar semua perangkat dan
nama mpv mereka).

Anda juga bisa mencoba menggunakan itu campur aduk Plugin. Pengaturan ini memungkinkan audio multisaluran
pada kegagalan perangkat dengan upmixing otomatis dengan akses bersama, jadi mainkan
audio stereo dan multisaluran secara bersamaan akan berfungsi seperti yang diharapkan.

Pusat Pengemudi keluaran audio OSS


Mengatur perangkat output audio (default: /dev/dsp).


Mengatur perangkat mixer audio (default: /dev/pencampur).


Mengatur saluran mixer audio (default: pcm). Nilai valid lainnya termasuk jilid,
pcm, line. Untuk daftar lengkap opsi, cari SOUND_DEVICE_NAMES in
/usr/include/linux/soundcard.h.

dongkrak JACK (Jack Audio Connection Kit) driver output audio

pelabuhan=
Menghubungkan ke port dengan nama yang diberikan (default: port fisik).

nama=
Nama klien yang diteruskan ke JACK (default: mpv). Berguna jika Anda ingin
memiliki koneksi tertentu yang dibuat secara otomatis.

(tidak-) mulai otomatis
Secara otomatis memulai jackd jika perlu (default: dinonaktifkan). Perhatikan bahwa ini
cenderung tidak dapat diandalkan dan akan membanjiri stdout dengan pesan server.

(tidak terhubung
Secara otomatis membuat koneksi ke port output (default: diaktifkan). Kapan
diaktifkan, jumlah maksimum saluran keluaran akan dibatasi pada jumlah
port output yang tersedia.

std-channel-layout=waveext|apa saja
Pilih tata letak saluran standar (default: waveext). JACK sendiri tidak memiliki
gagasan tata letak saluran (yaitu menetapkan speaker mana saluran yang diberikan
seharusnya dipetakan ke) - itu hanya membutuhkan apa pun yang dihasilkan aplikasi, dan
mengalihkannya ke apa pun yang ditentukan pengguna. Ini berarti pengguna dan
aplikasi bertanggung jawab menangani tata letak saluran. gelombangext kegunaan
Urutan WAVE_FORMAT_EXTENSIBLE, yang meskipun didefinisikan oleh
Microsoft, adalah standar pada banyak sistem. Nilai Apa pun membuat JACK menerima
apa pun yang berasal dari rantai filter audio, terlepas dari tata letak saluran dan
tanpa pemesanan ulang. Mode ini mungkin tidak terlalu berguna, selain untuk
debugging atau ketika digunakan dengan pengaturan tetap.

com.coreaudio (Mac OS X saja)
Driver output audio Mac OS X asli menggunakan AudioUnits dan suara CoreAudio
Server.

Secara otomatis dialihkan ke coreaudio_eksklusif saat memutar format terkompresi.

ubah-format-fisik=
Ubah format fisik menjadi yang mirip dengan format audio yang diminta
(standar: tidak). Ini memiliki keuntungan bahwa output audio multisaluran akan
benar-benar bekerja. Kerugiannya adalah itu akan mengubah audio seluruh sistem
pengaturan. Ini sama dengan mengubah dibentuk pengaturan di Audio
Devices dialog di Audio MIDI Pengaturan kegunaan. Perhatikan bahwa ini tidak
efek pengaturan speaker yang dipilih.

eksklusif
Gunakan akses mode eksklusif. Ini hanya mengarahkan ke coreaudio_eksklusif, tapi
harus lebih disukai daripada menggunakan AO itu secara langsung.

coreaudio_eksklusif (Mac OS X saja)
Driver output audio Mac OS X asli menggunakan akses perangkat langsung dan mode eksklusif
(melewati server suara).

terbuka Driver output audio OpenAL eksperimental

CATATAN:
Driver ini tidak terlalu berguna. Memutar audio multi-saluran dengannya lambat.

nadi Driver keluaran audio PulseAudio

[ ][: tenggelam>]
Tentukan host dan output sink opsional untuk digunakan. kosong rangkaian
menggunakan koneksi lokal, "localhost" menggunakan transfer jaringan (kemungkinan besar tidak
apa maumu).

buffer=<1-2000|asli>
Atur ukuran buffer audio dalam milidetik. Nilai yang lebih tinggi menyangga lebih banyak data,
dan memiliki kemungkinan buffer underruns yang lebih rendah. Nilai yang lebih kecil membuat
aliran audio bereaksi lebih cepat, misalnya terhadap perubahan kecepatan pemutaran. Standar: 250.

latency-hacks=
Aktifkan peretasan untuk mengatasi bug waktu PulseAudio (default: tidak). Jika diaktifkan,
mpv akan melakukan perhitungan latensi yang rumit sendiri. Jika dinonaktifkan, itu akan
gunakan PulseAudio secara otomatis memperbarui informasi waktu. Nonaktifkan ini
mungkin membantu dengan misalnya audio jaringan atau beberapa plugin, sambil mengaktifkannya
mungkin membantu dalam beberapa situasi yang tidak diketahui (dulu diperlukan untuk menjadi baik
perilaku pada versi PulseAudio lama).

Jika Anda memiliki video yang gagap saat menggunakan pulsa, coba aktifkan opsi ini.
(Atau sebagai alternatif, coba perbarui PulseAudio.)

suara (jendela saja)
Driver keluaran audio DirectX DirectSound

CATATAN:
Driver ini untuk kompatibilitas dengan sistem lama.

perangkat=
Mengatur nomor perangkat yang akan digunakan. Memutar file dengan -v akan menampilkan daftar
perangkat yang tersedia.

ukuran buffer =
Ukuran buffer DirectSound dalam milidetik (default: 200).

sdl Driver keluaran audio SDL 1.2+. Harus bekerja pada platform apa pun yang didukung oleh SDL 1.2, tetapi
mungkin memerlukan SDL_AUDIODRIVER variabel lingkungan harus diatur dengan tepat untuk
sistem anda.

CATATAN:
Driver ini untuk kompatibilitas dengan lingkungan yang sangat asing, seperti
sistem di mana tidak ada driver lain yang tersedia.

buflen=
Menyetel panjang buffer audio dalam hitungan detik. Digunakan hanya sebagai petunjuk oleh suara
sistem. Memutar file dengan -v akan menunjukkan yang diminta dan diperoleh tepat
ukuran buffer. Nilai 0 memilih default sistem suara.

bufcnt=
Menyetel jumlah buffer audio tambahan dalam mpv. Biasanya tidak perlu diubah.

nol Tidak menghasilkan output audio tetapi mempertahankan kecepatan pemutaran video. Menggunakan --ao=null:belum waktunya
untuk benchmarking.

tanpa batas waktu
Jangan mensimulasikan pengaturan waktu perangkat audio yang sempurna. Ini berarti penguraian kode audio
akan berjalan secepat mungkin, alih-alih mengatur waktu ke jam sistem.

penyangga Panjang buffer simulasi dalam hitungan detik.

ledakan
Simulasi ukuran potongan dalam sampel.

kecepatan Kecepatan pemutaran audio simulasi sebagai pengganda. Biasanya, perangkat audio asli
tidak akan berjalan secepat jam sistem. Ini akan menyimpang hanya
sedikit, dan opsi ini membantu mensimulasikan ini.

Latensi
Latensi perangkat yang disimulasikan. Ini adalah tambahan untuk EOF.

rusak-eof
Simulasikan driver audio yang rusak, yang selalu menambahkan latensi perangkat tetap ke
posisi pemutaran audio yang dilaporkan.

rusak-tunda
Simulasikan driver audio yang rusak, yang tidak melaporkan latensi dengan benar.

tata letak saluran
Jika tidak kosong, ini adalah , daftar tata letak saluran yang terpisah yang diizinkan oleh AO.
Ini dapat digunakan untuk menguji pemilihan tata letak saluran.

pcm Output audio penulis file PCM/WAVE mentah

(tanpa-)waveheader
Sertakan atau jangan sertakan tajuk WAVE (default: disertakan). Kapan tidak?
disertakan, PCM mentah akan dihasilkan.

berkas=
Tulis suara ke alih-alih default audiodump.wav. Jika
tanpa gelombang ditentukan, defaultnya adalah audiodump.pcm.

(tidak-)tambahkan
Tambahkan ke file, alih-alih menimpanya. Selalu gunakan ini dengan
tanpa gelombang pilihan - dengan kepala gelombang itu rusak, karena akan menulis
Header WAVE setiap kali file dibuka.

bulat Output audio ke daemon RSound

CATATAN:
Sama sekali tidak berguna, kecuali jika Anda berniat menjalankan RSound. Jangan bingung dengan
RoarAudio, yang merupakan sesuatu yang sama sekali berbeda.

tuan rumah =
Atur alamat server (default: localhost). Bisa berupa jaringan
nama host untuk koneksi TCP atau jalur soket domain Unix yang dimulai dengan '/'.

pelabuhan=
Atur port TCP yang digunakan untuk menghubungkan ke server (default: 12345). Bukan
digunakan jika menghubungkan ke soket domain Unix.

sndio Output audio ke sistem suara sndio OpenBSD

CATATAN:
Eksperimental. Ada bug dan masalah yang diketahui.

(Catatan: hanya mendukung tata letak saluran mono, stereo, 4.0, 5.1 dan 7.1.)

perangkat=
perangkat sndio yang akan digunakan (default: $ PERANGKAT AUDIODE, hal. snd0).

wasapi Output audio ke Windows Audio Session API.

eksklusif
Meminta eksklusif, akses perangkat keras langsung. Menurut definisi mencegah suara
pemutaran program lain sampai mpv keluar.

perangkat=
Menggunakan titik akhir yang diminta alih-alih titik akhir audio default sistem.
Baik nomor urut (0,1,2,...) dan GUID String valid; GUID
string dijamin tidak akan berubah kecuali driver di uninstall.

Juga mendukung pencarian perangkat aktif dengan nama yang dapat dibaca manusia. Jika lebih dari
satu perangkat cocok dengan namanya, menolak memuatnya.

Opsi ini sebagian besar tidak digunakan lagi demi yang lebih umum
--perangkat audio pilihan. Yang mengatakan, --audio-device=bantuan akan memberikan daftar
GUID perangkat yang valid (diawali dengan wasapi/), serta dapat dibaca manusia
nama, yang seharusnya berfungsi di sini.

VIDEO KELUARAN DRIVERS

Driver output video adalah antarmuka ke fasilitas output video yang berbeda. Sintaksnya adalah:

--vo=
Tentukan daftar prioritas driver output video yang akan digunakan.

Jika daftar memiliki tanda ',', mpv akan kembali ke driver yang tidak ada dalam daftar.
Subopsi adalah opsional dan sebagian besar dapat dihilangkan.

Anda juga dapat mengatur default untuk setiap driver. Default diterapkan sebelum normal
parameter pengemudi.

--vo-default=
Tetapkan default untuk setiap driver.

CATATAN:
Lihat --vo=bantuan untuk daftar driver output video yang dikompilasi.

Driver keluaran yang direkomendasikan adalah --vo=openl-hq. Semua driver lain adalah untuk
kompatibilitas atau tujuan khusus. Secara default, --vo=terbuka digunakan, tetapi jika itu muncul
tidak berfungsi, itu mundur ke driver lain (dalam urutan yang sama seperti yang tercantum oleh --vo=bantuan).

Driver keluaran video yang tersedia adalah:

xv (X11 saja)
Menggunakan ekstensi XVideo untuk mengaktifkan tampilan akselerasi perangkat keras. Ini yang paling
VO pada X yang kompatibel, tetapi mungkin berkualitas rendah, dan memiliki masalah dengan OSD dan subtitle
tampilan.

CATATAN:
Driver ini untuk kompatibilitas dengan sistem lama.

adaptor=
Pilih adaptor XVideo tertentu (periksa hasil xvinfo).

pelabuhan=
Pilih port XVideo tertentu.

ck =
Pilih sumber dari mana kunci warna diambil (default: skr).

pantat Default mengambil kunci warna yang saat ini diatur di Xv.

menggunakan Gunakan tetapi jangan atur tombol warna dari mpv (gunakan tombol --tombol warna Option
untuk mengubahnya).

set Sama seperti penggunaan tetapi juga mengatur tombol warna yang disediakan.

ck-metode=
Menyetel metode menggambar kunci warna (default: man).

pria Gambar tombol warna secara manual (mengurangi kedipan dalam beberapa kasus).

bg Atur tombol warna sebagai latar belakang jendela.

mobil Biarkan Xv menggambar kunci warna.

tombol warna=
Mengubah tombol warna ke nilai RGB pilihan Anda. 0x000000 berwarna hitam dan
0xffffff putih.

tombol tanpa warna
Menonaktifkan penguncian warna.

penyangga =
Jumlah buffer gambar yang akan digunakan untuk ringbuffer internal (default: 2).
Meningkatkan ini akan menggunakan lebih banyak memori, tetapi mungkin membantu dengan server X tidak
merespons cukup cepat jika FPS video mendekati atau lebih tinggi dari
menampilkan kecepatan refresh.

x11 (X11 saja)
Driver output video memori bersama tanpa akselerasi perangkat keras yang berfungsi kapan pun
X11 hadir.

CATATAN:
Ini hanya fallback, dan tidak boleh digunakan secara normal.

vdpau (X11 saja)
Menggunakan antarmuka VDPAU untuk menampilkan dan secara opsional juga mendekode video. Perangkat keras
decoding digunakan dengan --hwdec=vdpau.

CATATAN:
Versi mpv sebelumnya (dan MPlayer, mplayer2) menyediakan sub-opsi untuk disetel
pasca-pemrosesan vdpau, seperti deint, mempertajam, mencela, kroma-deint, menarik,
penskalaan terbaik. Sub-opsi ini tidak digunakan lagi, dan Anda harus menggunakan vdpaupp
filter video sebagai gantinya.

pertajam=<-1-1>
(Tidak digunakan lagi. Lihat catatan tentang vdpaupp.)

Untuk nilai positif, terapkan algoritme penajaman ke video, untuk negatif
nilai algoritma kabur (default: 0).

denoise=<0-1>
(Tidak digunakan lagi. Lihat catatan tentang vdpaupp.)

Terapkan algoritme pengurangan noise ke video (default: 0; tidak ada noise
pengurangan).

deint=<-4-4>
(Tidak digunakan lagi. Lihat catatan tentang vdpaupp.)

Pilih mode deinterlacing (default: 0). Dalam versi yang lebih lama (serta
MPlayer/mplayer2) Anda dapat menggunakan opsi ini untuk mengaktifkan deinterlacing. Ini
tidak berfungsi lagi, dan deinterlacing diaktifkan dengan salah satu dari d kunci (oleh
default dipetakan ke perintah siklus deinterlace), atau --deinterlace
pilihan. Juga, untuk memilih mode deint default, Anda harus menggunakan sesuatu
'like' --vf-defaults=vdpaupp:deint-mode=temporal alih-alih sub-opsi ini.

0 Pilih vdpaupp default filter video, yang sesuai dengan 3.

1 Tampilkan hanya bidang pertama.

2 Bob melepaskan ikatannya.

3 Deinterlacing temporal adaptif gerak. Dapat menyebabkan desinkronisasi A/V dengan
perangkat keras video lambat dan/atau resolusi tinggi.

4 Deinterlacing temporal adaptif gerak dengan spasial yang dipandu tepi
interpolasi. Membutuhkan perangkat keras video yang cepat.

kroma-deint
(Tidak digunakan lagi. Lihat catatan tentang vdpaupp.)

Membuat deinterlacers temporal beroperasi baik pada luma dan chroma (default). Menggunakan
no-chroma-deint untuk hanya menggunakan luma dan mempercepat deinterlacing tingkat lanjut.
Berguna dengan memori video yang lambat.

menarik (Tidak digunakan lagi. Lihat catatan tentang vdpaupp.)

Coba terapkan telecine terbalik, perlu deinterlacing temporal adaptif gerak.

hqscaling=<0-9>
(Tidak digunakan lagi. Lihat catatan tentang vdpaupp.)

0 Gunakan penskalaan VDPAU default (default).

1-9 Terapkan penskalaan VDPAU berkualitas tinggi (membutuhkan perangkat keras yang mumpuni).

fps =
Ganti nilai kecepatan refresh tampilan yang terdeteksi secara otomatis (nilai diperlukan untuk
framedrop untuk memungkinkan kecepatan pemutaran video lebih tinggi daripada kecepatan refresh tampilan,
dan untuk penyesuaian waktu bingkai yang sadar vsync). Default 0 berarti gunakan
nilai yang terdeteksi secara otomatis. Nilai positif diinterpretasikan sebagai kecepatan refresh dalam Hz
dan menimpa nilai yang terdeteksi secara otomatis. Nilai negatif menonaktifkan semua waktu
penyesuaian dan logika framedrop.

deteksi komposit
Implementasi VDPAU NVIDIA saat ini berperilaku agak berbeda di bawah a
compositing window manager dan tidak memberikan frame timing yang akurat
informasi. Dengan mengaktifkan opsi ini, pemain mencoba mendeteksi apakah a
pengomposisian window manager aktif. Jika salah satu terdeteksi, pemain
menonaktifkan penyesuaian waktu seolah-olah pengguna telah menentukan fps = -1 (seperti mereka
akan didasarkan pada input yang salah). Ini berarti waktunya agak kurang
akurat daripada tanpa pengomposisian, tetapi dengan perilaku mode gabungan dari
driver NVIDIA, tidak ada batas kecepatan pemutaran keras bahkan tanpa
logika yang dinonaktifkan. Diaktifkan secara default, gunakan tanpa-komposit-deteksi untuk menonaktifkan.

antrian_jendela= dan antrian_fs=
Gunakan fungsionalitas antrian presentasi VDPAU untuk mengantre bingkai video mendatang
perubahan paling banyak beberapa milidetik sebelumnya (default: 50). Lihat di bawah
untuk informasi tambahan.

output_surfaces=<2-15>
Alokasikan banyak permukaan keluaran ini untuk menampilkan bingkai video (default: 3). Melihat
di bawah ini untuk informasi tambahan.

colorkey=<#RRGGBB|#AARRGGBB>
Mengatur warna latar belakang antrian presentasi VDPAU, yang dalam praktiknya adalah
colorkey digunakan jika VDPAU beroperasi dalam mode overlay (default: #020507, beberapa
bayangan hitam). Jika komponen alfa dari nilai ini adalah 0, default
Tombol warna VDPAU akan digunakan sebagai gantinya (yang biasanya berwarna hijau).

kekuatan-yuv
Jangan pernah menerima masukan RGBA. Ini berarti mpv akan memasukkan filter untuk dikonversi ke a
Format YUV sebelum VO. Terkadang berguna untuk memaksa ketersediaan tertentu
Fitur khusus YUV, seperti equalizer video atau deinterlacing.

Menggunakan fungsionalitas antrian bingkai VDPAU yang dikendalikan oleh opsi waktu antrian
membuat waktu flip bingkai mpv kurang sensitif terhadap beban CPU sistem dan memungkinkan mpv untuk
mulai decoding frame berikutnya sedikit lebih awal, yang dapat mengurangi jitter yang disebabkan
oleh frame slow-to-decode individu. Namun, driver grafis NVIDIA dapat membuat
perilaku jendela lain seperti jendela bergerak berombak jika VDPAU menggunakan antrian blit
(terutama terjadi jika Anda mengaktifkan ekstensi komposit) dan fitur ini adalah
aktif. Jika ini terjadi pada sistem Anda dan mengganggu Anda, maka Anda dapat mengatur
nilai waktu antrian ke 0 untuk menonaktifkan fitur ini. Pengaturan untuk digunakan di jendela dan
mode layar penuh terpisah karena seharusnya tidak ada alasan untuk menonaktifkan ini untuk
mode layar penuh (karena masalah driver tidak akan memengaruhi video itu sendiri).

Anda dapat mengantri lebih banyak frame ke depan dengan meningkatkan nilai waktu antrean dan
keluaran_permukaan count (untuk memastikan permukaan yang cukup untuk menyangga video untuk waktu tertentu
ke depan, Anda memerlukan setidaknya permukaan sebanyak video yang memiliki bingkai selama waktu itu,
ditambah dua). Ini dapat membantu membuat video lebih halus dalam beberapa kasus. Kelemahan utama
adalah peningkatan persyaratan RAM video untuk permukaan dan respons tampilan yang lebih lambat
untuk perintah pengguna (perubahan tampilan hanya terlihat beberapa saat setelah mereka
antri). Implementasi driver grafis mungkin juga memiliki batasan pada panjang
waktu antrian maksimum atau jumlah permukaan antrian yang bekerja dengan baik atau tidak sama sekali.

direct3d_shaders (jendela saja)
Driver keluaran video yang menggunakan antarmuka Direct3D.

CATATAN:
Driver ini untuk kompatibilitas dengan sistem yang tidak menyediakan OpenGL
driver.

lebih suka-peregangan
penggunaan IDirect3DDevice9::StretchRect atas metode lain jika memungkinkan.

nonaktifkan-peregangan
Jangan pernah merender video menggunakan IDirect3DDevice9::StretchRect.

nonaktifkan-tekstur
Jangan pernah merender video menggunakan rendering tekstur D3D. Rendering dengan tekstur
+ shader akan tetap diizinkan. Menambahkan menonaktifkan-shader untuk sepenuhnya menonaktifkan
rendering video dengan tekstur.

menonaktifkan-shader
Jangan pernah menggunakan shader saat merender video.

hanya-8bit
Jangan pernah merender video YUV dengan lebih dari 8 bit per komponen. Menggunakan bendera ini
akan memaksa konversi perangkat lunak ke 8-bit.

nonaktifkan-tekstur-selaras
Biasanya ukuran tekstur selalu disejajarkan dengan 16. Dengan opsi ini diaktifkan,
tekstur video akan selalu memiliki ukuran yang sama persis dengan video
itu sendiri.

Opsi debug. Ini mungkin salah, mungkin dihapus di masa mendatang, mungkin
crash, dapat menyebabkan penurunan kecepatan, dll. Hubungi pengembang jika Anda benar-benar membutuhkannya
ini untuk kinerja atau operasi yang tepat.

kekuatan-kekuatan-dari-2
Selalu paksa tekstur ke kekuatan 2, bahkan jika perangkat melaporkan
ukuran tekstur non-power-of-2 seperti yang didukung.

tekstur-memori=
Hanya mempengaruhi pengoperasian dengan shader/texturing diaktifkan, dan (E)OSD. Mungkin
nilai:

kegagalan (Default)
penggunaan D3DPOOL_DEFAULT, Dengan D3DPOOL_SYSTEMMEM tekstur untuk mengunci. Jika
pengemudi mendukung D3DDEVCAPS_TEXTURESYSTEMMEMORY, D3DPOOL_SYSTEMMEM
digunakan secara langsung.

default-kolam
penggunaan D3DPOOL_DEFAULT. (Suka kegagalan, tetapi jangan pernah menggunakan tekstur bayangan.)

default-kolam-bayangan
penggunaan D3DPOOL_DEFAULT, Dengan D3DPOOL_SYSTEMMEM tekstur untuk mengunci.
(Suka kegagalan, tapi selalu paksakan tekstur bayangan.)

berhasil
penggunaan D3DPOOL_MANAGED.

menggaruk
penggunaan D3DPOOL_SCRATCH, Dengan D3DPOOL_SYSTEMMEM tekstur untuk mengunci.

tukar-buang
penggunaan D3DSWAPEFFECT_DISCARD, yang mungkin lebih cepat. Mungkin lebih lambat juga, karena
itu harus(?) menghapus setiap frame.

persis-backbuffer
Selalu ubah ukuran backbuffer ke ukuran jendela.

langsung3d (jendela saja)
Sama dengan direct3d_shaders, tetapi dengan opsi nonaktifkan-tekstur dan menonaktifkan-shader
dipaksa.

CATATAN:
Driver ini untuk kompatibilitas dengan sistem lama.

terbuka Driver keluaran video OpenGL. Ini mendukung metode penskalaan yang diperluas, dithering, dan
manajemen warna.

Secara default, ia mencoba menggunakan pengaturan cepat dan gagal-aman. Gunakan alias bukagl-hq untuk
gunakan driver ini dengan default yang disetel ke rendering berkualitas tinggi.

Membutuhkan setidaknya OpenGL 2.1.

Beberapa fitur hanya tersedia dengan driver grafis berkemampuan OpenGL 3 (atau jika
ekstensi yang diperlukan tersedia).

OpenGL ES 2.0 dan 3.0 juga didukung.

Decoding perangkat keras melalui OpenGL-interop didukung sampai tingkat tertentu. Perhatikan bahwa di
mode ini, beberapa kasus sudut mungkin tidak ditangani dengan baik, dan ruang warna
konversi dan upsampling kroma umumnya ada di tangan dekoder perangkat keras
Lebah.

terbuka menggunakan FBO secara default. Terkadang Anda dapat mencapai kualitas yang lebih baik atau
kinerja dengan mengubah format fbo sub pilihan untuk rgb16f, rgb32f or Jakarta. Diketahui
masalah termasuk Mesa/Intel tidak menerima rgb16, Mesa terkadang tidak dikompilasi
dengan dukungan tekstur float, dan beberapa pengaturan OS X menjadi sangat lambat dengan rgb16 tapi
cepat dengan rgb32f. Jika Anda memiliki masalah, Anda juga dapat mencoba melewati mode bodoh=ya
sub-opsi.

mode bodoh=
Mode ini sangat dibatasi, dan akan menonaktifkan sebagian besar OpenGL
fitur. Ini termasuk scaler berkualitas tinggi dan shader khusus!

Ini ditujukan untuk perangkat keras yang tidak mendukung FBO (termasuk GLES,
yang tidak mendukungnya secara memadai), atau untuk mendapatkan lebih banyak kinerja dari
perangkat keras yang buruk atau lama.

Mode ini dipaksakan secara otomatis jika diperlukan, dan opsi ini sebagian besar
berguna untuk debugging. Ini juga diaktifkan secara otomatis jika tidak ada yang menggunakan
fitur yang membutuhkan FBO.

Opsi ini mungkin akan dihapus secara diam-diam di masa mendatang.

skala =

bilinear
Pemfilteran tekstur perangkat keras bilinear (tercepat, kualitas sangat rendah). Ini
default untuk alasan kompatibilitas.

spline36
Kualitas dan kecepatan menengah. Ini adalah default saat menggunakan bukagl-hq.

lanczos
Penskalaan Lanczos. Memberikan kualitas dan kecepatan menengah. Umumnya lebih buruk dari
spline36, tetapi menghasilkan gambar yang sedikit lebih tajam yang bagus untuk
beberapa jenis konten. Jumlah ketukan dapat dikontrol dengan
skala-radius, tetapi sebaiknya dibiarkan tidak berubah.

Filter ini sesuai dengan yang lama lanczos3 alias jika radius default
digunakan, sedangkan lanczos2 sesuai dengan radius 2.

(Filter ini adalah alias untuk tulus-menyingkap tulus)

ewa_lanczos
Penskalaan Lanczos rata-rata tertimbang elips. Juga dikenal sebagai Jinc.
Relatif lambat, tetapi kualitasnya sangat bagus. Jari-jari dapat dikontrol dengan
skala-radius. Meningkatkan radius membuat filter lebih tajam tetapi menambahkan
lebih banyak dering.

(Filter ini adalah alias untuk sial-menyingkap sial)

ewa_lanczossharp
Versi ewa_lanczos yang sedikit dipertajam, telah dikonfigurasi sebelumnya untuk menggunakan
radius dan parameter ideal. Jika perangkat keras Anda dapat menjalankannya, ini mungkin
apa yang harus Anda gunakan secara default.

mitchell
Mitchell-Netravali. Itu B dan C parameter dapat diatur dengan skala-param1
dan skala-param2. Filter ini sangat bagus dalam downscaling (lihat skala).

sampel berlebih
Versi tetangga terdekat yang (secara naif) melakukan oversampling piksel, sehingga
piksel tepi yang tumpang tindih diinterpolasi secara linier alih-alih dibulatkan.
Ini pada dasarnya menghilangkan ketidaksempurnaan kecil dan artefak
disebabkan oleh interpolasi tetangga terdekat, dengan imbalan menambahkan beberapa
mengaburkan. Filter ini bagus dalam interpolasi temporal, dan juga dikenal sebagai
"gerakan halus" (lihat skala t).

adat Shader khusus yang ditentukan pengguna (lihat skala-shader).

Ada beberapa filter lagi, tetapi kebanyakan tidak begitu berguna. Untuk daftar lengkap,
lulus membantu sebagai nilai, misalnya:

mpv --vo=opengl:skala=bantuan

skala-param1= , skala-param2=
Setel parameter filter. Diabaikan jika filter tidak dapat disetel. Saat ini,
ini mempengaruhi parameter filter berikut:

bcspline
Parameter spline (B dan C). Default ke 0.5 untuk keduanya.

gaussian
Parameter skala (t). Meningkatkan ini membuat hasilnya lebih kabur.
Default ke 1.

sampel berlebih
Jarak minimum ke tepi sebelum interpolasi digunakan. Pengaturan
ini ke 0 akan selalu menginterpolasi tepi, sedangkan mengaturnya ke 0.5
tidak akan pernah diinterpolasi, sehingga berperilaku seolah-olah terdekat biasa
algoritma tetangga digunakan. Default ke 0.0.

skala-kabur=
Faktor penskalaan kernel (juga dikenal sebagai faktor blur). Penurunan ini membuat
hasilnya lebih tajam, meningkatkannya membuatnya lebih buram (default 0). Jika diatur ke
0, faktor blur pilihan kernel digunakan. Perhatikan bahwa pengaturan ini juga
rendah (mis. 0.5) mengarah pada hasil yang buruk. Biasanya disarankan untuk tetap berpegang pada
nilai antara 0.8 dan 1.2.

skala-jari-jari =
Atur radius untuk filter yang tercantum di bawah, harus berupa angka mengambang antara 0.5 dan
16.0. Default ke radius pilihan filter jika tidak ditentukan.
tulus dan turunannya, sial dan turunannya, gaussian, kotak dan segi tiga

Perhatikan bahwa tergantung pada detail implementasi filter dan penskalaan video
rasio, radius yang sebenarnya digunakan mungkin berbeda (kemungkinan besar
ditingkatkan sedikit).

skala-antiring=
Mengatur kekuatan antiringing. Ini mencoba menghilangkan dering, tetapi bisa
memperkenalkan artefak lain dalam proses. Harus berupa angka float antara 0.0
dan 1.0. Nilai default 0.0 menonaktifkan antiringing sepenuhnya.

Perhatikan bahwa ini tidak memengaruhi filter khusus bilinear dan bicubic_fast.

skala-jendela=
(Hanya pengguna tingkat lanjut) Pilih fungsi windowing kustom untuk kernel.
Default ke jendela pilihan filter jika tidak disetel. Menggunakan skala-jendela=bantuan untuk
dapatkan daftar fungsi windowing yang didukung.

skala-wparam=
(Hanya pengguna tingkat lanjut) Konfigurasikan parameter untuk fungsi jendela yang diberikan
by skala-jendela. Diabaikan jika jendela tidak dapat disetel. Saat ini, ini
mempengaruhi parameter jendela berikut:

kaiser Parameter jendela (alfa). Default ke 6.33.

orang kulit hitam
Parameter jendela (alfa). Default ke 0.16.

gaussian
Parameter skala (t). Meningkatkan ini membuat jendela lebih lebar.
Default ke 1.

scaler-lut-size=<4..10>
Atur ukuran tekstur pencarian untuk kernel scaler (default: 6). Itu
ukuran tekstur sebenarnya adalah 2^N untuk nilai opsi N. Jadi pencarian
tekstur dengan pengaturan default menggunakan 64 sampel.

Semua bobot diinterpolasi secara bilinear dari sampel tersebut, sehingga meningkat
ukuran tabel pencarian dapat meningkatkan akurasi scaler.

scaler-resize-only
Nonaktifkan scaler jika gambar video tidak diubah ukurannya. Dalam hal itu, bilinear
digunakan sebagai gantinya apa pun yang diatur dengan skala. Bilinear akan mereproduksi
sumber gambar dengan sempurna jika tidak ada penskalaan yang dilakukan. Perhatikan bahwa opsi ini
tidak pernah mempengaruhi skala c.

pbo Aktifkan penggunaan PBO. Ini sedikit lebih cepat, tetapi terkadang dapat menyebabkan
korupsi gambar sporadis dan sementara (secara teori, karena reupload tidak
coba lagi ketika gagal), dan mungkin benar-benar memicu jalur yang lebih lambat dengan
driver yang tidak mendukung PBO dengan benar.

kedalaman gentar =
Atur kedalaman target gentar ke N. Default: no.

tidak Nonaktifkan semua dithering yang dilakukan oleh mpv.

mobil Seleksi otomatis. Jika kedalaman bit keluaran tidak dapat dideteksi, 8 bit
per komponen diasumsikan.

8 Gentar untuk output 8 bit.

Perhatikan bahwa kedalaman perangkat tampilan video yang terhubung tidak dapat
terdeteksi. Seringkali, panel LCD akan melakukan dithering sendiri, yang bertentangan
dengan terbuka's dithering dan mengarah ke output jelek.

gentar-ukuran-buah=<2-8>
Atur ukuran matriks gentar (default: 6). Ukuran sebenarnya dari
matriks adalah (2^T) x (2^T) untuk nilai opsi N, jadi nilai 6 memberikan a
ukuran 64x64. Matriks dihasilkan pada saat startup, dan matriks besar
bisa memakan waktu agak lama untuk menghitung (detik).

Digunakan dalam gentar = buah modus saja.

gentar =
Pilih algoritma dithering (default: buah). (Biasanya, gentar-kedalaman
opsi mengontrol apakah dithering diaktifkan.)

keragu-raguan sementara
Aktifkan dithering temporal. (Hanya aktif jika dithering diaktifkan secara umum.)
Ini mengubah antara 8 pola dithering yang berbeda pada setiap frame dengan mengubah
orientasi matriks dithering ubin. Sayangnya, ini dapat menyebabkan
berkedip pada layar LCD, karena ini memiliki waktu reaksi yang tinggi.

temporal-dither-period=<1-128>
Menentukan seberapa sering pola dithering diperbarui ketika keragu-raguan sementara
sedang digunakan. 1 (default) akan diperbarui di setiap bingkai video, 2 di setiap
bingkai lain, dll.

men-debug Periksa kesalahan OpenGL, yaitu panggilan glGetError(). Juga minta debug OpenGL
konteks (yang tidak melakukan apa pun dengan driver grafis saat ini)
menulis).

interpolasi
Kurangi kegagapan yang disebabkan oleh ketidakcocokan dalam fps video dan penyegaran tampilan
rate (juga dikenal sebagai judder).

PERINGATAN:
Ini membutuhkan pengaturan --sinkronisasi video pilihan untuk salah satu pajangan
mode, atau akan dinonaktifkan secara diam-diam. Ini tidak diperlukan sebelum mpv
0.14.0.

Ini pada dasarnya mencoba untuk menginterpolasi frame yang hilang dengan berbelit-belit
video di sepanjang sumbu temporal. Filter yang digunakan dapat dikontrol menggunakan
itu skala t pengaturan.

Perhatikan bahwa ini bergantung pada vsync untuk bekerja, lihat interval pertukaran keahlian yang lebih
informasi.

swapinterval=
Interval dalam bingkai yang ditampilkan antara dua buffer swap. 1 setara dengan
aktifkan VSYNC, 0 untuk menonaktifkan VSYNC. Default ke 1 jika tidak ditentukan.

Perhatikan bahwa ini tergantung pada dukungan vsync OpenGL yang tepat. Pada beberapa platform dan
driver, ini hanya berfungsi dengan andal saat dalam mode layar penuh. Mungkin juga
memerlukan peretasan khusus pengemudi jika menggunakan banyak monitor, untuk memastikan mpv
disinkronkan ke yang benar. Penggabungan pengelola jendela juga dapat menyebabkan buruk
hasil, seperti informasi FPS tampilan yang hilang atau salah (lihat
--tampilan-fps).

skala d=
Seperti skala, tetapi terapkan filter ini pada penurunan skala. Jika opsi ini
tidak disetel, filter tersirat oleh skala akan diterapkan.

skala =
As skala, tetapi untuk menginterpolasi informasi kroma. Jika gambar tidak
subsampel, opsi ini diabaikan sepenuhnya.

tskala =
Filter yang digunakan untuk interpolasi sumbu temporal (bingkai). Hanya ini
digunakan jika interpolasi diaktifkan. Satu-satunya pilihan yang valid untuk skala t adalah
filter konvolusi yang dapat dipisahkan (gunakan tscale=bantuan untuk mendapatkan daftar). Standarnya
is mitchell.

Perhatikan bahwa radius filter maksimum yang didukung saat ini adalah 3, karena
batasan jumlah tekstur video yang dapat dimuat
secara bersamaan.

tscale-penjepit
Jepit skala t rentang nilai kernel filter ke [0-1]. Ini mengurangi
artefak dering berlebihan di domain temporal (yang biasanya bermanifestasi
diri mereka sebagai kilatan pendek atau pinggiran hitam, sebagian besar di sekitar tepi yang bergerak)
dengan imbalan berpotensi menambahkan lebih banyak blur.

radius skala-d, radius-skala, radius-tscale, dan sebagainya
Setel parameter filter untuk skala, skala c dan skala t, Masing-masing.

Lihat opsi yang sesuai untuk skala.

penskalaan linier
Skala dalam cahaya linier. Seharusnya hanya digunakan dengan format fbo yang memiliki di
presisi minimal 16 bit.

benar-penurunan skala
Saat menggunakan filter berbasis konvolusi, perpanjang ukuran filter saat
penurunan skala. Meningkatkan kualitas, tetapi mengurangi kinerja saat melakukan downscaling.

Ini akan bekerja sedikit kurang optimal untuk video anamorphic (tapi tetap saja
lebih baik daripada tanpanya) karena akan memperpanjang ukuran agar hanya cocok dengan
lebih ringan dari faktor skala antara sumbu.

skala awal =
Opsi ini menyediakan filter berbasis non-konvolusi untuk peningkatan skala. Ini
filter mengubah ukuran video ke beberapa ukuran aslinya (semua saat ini
prescaler yang didukung hanya dapat melakukan penggandaan gambar dalam satu lintasan).
Umumnya filter berbasis konvolusi lain (skalator utama) akan diterapkan
setelah prescaler untuk mencocokkan ukuran tampilan target.

tak satupun Nonaktifkan semua prescaler. Ini adalah default.

superxbr
Prescaler yang relatif cepat awalnya dikembangkan untuk seni piksel.

Beberapa parameter dapat disetel dengan superxbr-ketajaman dan
superxbr-tepi-kekuatan Pilihan.

nnedi3 Deinterlacer berbasis jaringan saraf tiruan, yang dapat digunakan untuk
gambar kelas atas.

Sangat lambat dan membutuhkan kartu grafis kelas menengah atau atas baru-baru ini untuk
berjalan dengan lancar (per 2015).

Perhatikan bahwa semua filter di atas dirancang (atau diimplementasikan) untuk diproses
luma plane saja dan mungkin tidak akan berfungsi sebagaimana mestinya untuk video dalam format RGB.

prescale-pass=<1..5>
Jumlah operan untuk menerapkan prescaler (defaultnya adalah 1). Mengaturnya
ke 2 akan melakukan upscaling 4x.

prescale-downscaling-threshold=<0..32>
Opsi ini mencegah penggunaan prescaler yang "berlebihan", yang dapat disebabkan oleh
salah konfigurasi, atau pengguna mencoba memutar video dengan ukuran yang jauh lebih besar. Dengan
opsi ini, pengguna dapat menentukan rasio penurunan skala maksimal yang diizinkan di keduanya
dimensi. Untuk memenuhinya, jumlah operan untuk prescaler adalah
dikurangi, dan jika perlu, prescaler juga dapat dinonaktifkan.

Nilai defaultnya adalah 2.0, dan seharusnya bisa mencegah yang paling terlihat
penggunaan prescaler yang tidak masuk akal. Sebagian besar pengguna mungkin ingin menyetelnya ke a
nilai yang lebih kecil antara 1.0 dan 1.5 untuk kinerja yang lebih baik.

Nilai kurang dari 1.0 akan menonaktifkan pemeriksaan.

nnedi3-neurons=<16|32|64|128>
Tentukan neuron untuk nnedi3 prescaling (defaultnya adalah 32). Rendering
waktu diharapkan linier dengan jumlah neuron.

nnedi3-window=<8x4|8x6>
Tentukan ukuran jendela lokal untuk pengambilan sampel di nnedi3 prescaling (default
menjadi 8x4). Itu 8x6 jendela menghasilkan gambar yang lebih tajam, tetapi juga lebih lambat.

nnedi3-upload=
Tentukan cara mengunggah bobot NN ke GPU. Tergantung pada kartu grafis,
driver, kompiler shader, dan pengaturan nnedi3, kedua metode bisa lebih cepat atau
lebih lambat.

ubo Unggah bobot ini melalui objek buffer seragam. Ini adalah default.
(membutuhkan OpenGL 3.1 / GLES 3.0)

shader Kode keras semua bobot ke dalam kode sumber shader. (memerlukan
OpenGL 3.3 / GLES 3.0)

pra-shader = , post-shader= , skala-shader=
Shader fragmen GLSL khusus.

pra-shader (Daftar)
Ini diterapkan setelah konversi ke RGB dan sebelum linearisasi
dan peningkatan. Beroperasi pada RGB non-linear (sama seperti input). Ini
tempat terbaik untuk meletakkan hal-hal seperti mempertajam filter.

skala-shader
Ini digunakan sebagai ganti scale/cscale ketika opsi tersebut disetel ke
adat. Ruang warna tempat ia beroperasi bergantung pada nilai
penskalaan linier dan peningkatan sigmoid, jadi tidak ada asumsi yang seharusnya
dibuat di sini.

post-shader (Daftar)
Ini diterapkan setelah peningkatan dan pencampuran subtitle (ketika
campuran-subtitel diaktifkan), tetapi sebelum manajemen warna. beroperasi
pada RGB linier jika penskalaan linier berlaku, jika tidak, non-linear
RGB. Ini adalah tempat terbaik untuk transformasi ruang warna (mis.
pemetaan saturasi).

File-file ini harus mendefinisikan fungsi dengan tanda tangan berikut:

sampel vec4 (sampler2D tex, vec2 pos, vec2 tex_size)

Arti dari parameter adalah sebagai berikut:

sampel2D tex
Tekstur sumber untuk shader.

vec2 pos
Posisi yang akan dijadikan sampel, dalam ruang koordinat [0-1].

vec2 ukuran_teks
Ukuran tekstur, dalam piksel. Ini mungkin berbeda dari image_size,
misalnya. untuk konten subsampel atau untuk post-shader.

Selain parameter ini, seragam berikut juga berlaku secara global
tersedia:

mengapung acak
Angka acak dalam rentang [0-1], berbeda per bingkai.

int bingkai
Hitungan sederhana bingkai yang dirender, bertambah satu per bingkai dan
tidak pernah me-reset (terlepas dari pencarian).

vec2 ukuran gambar
Ukuran dalam piksel dari gambar masukan.

Misalnya, shader yang membalikkan warna bisa terlihat seperti ini:

sampel vec4 (sampler2D tex, vec2 pos, vec2 tex_size)
{
vec4 warna = tekstur(tex, pos);
kembali vec4(1.0 - color.rgb, color.a);
}

debanding Aktifkan algoritma debanding. Ini sangat mengurangi jumlah terlihat
pita, pemblokiran, dan artefak kuantisasi lainnya, dengan harga yang sangat mahal
sedikit mengaburkan beberapa detail terbaik. Dalam praktiknya, ini hampir
selalu ada peningkatan - satu-satunya alasan untuk menonaktifkannya adalah untuk
kinerja.

deband-iterasi=<1>
Jumlah langkah pelepasan pita yang harus dilakukan per sampel. Setiap langkah berkurang sedikit
lebih banyak pita, tetapi membutuhkan waktu untuk menghitung. Perhatikan bahwa kekuatan setiap langkah
jatuh dengan sangat cepat, sehingga angka yang tinggi (>4) praktis tidak berguna.
(Bawaan 1)

deband-threshold=<0..4096>
Ambang batas filter debanding. Angka yang lebih tinggi meningkatkan
kekuatan debanding secara dramatis tetapi semakin mengurangi detail gambar.
(Bawaan 64)

rentang-deband=<1>
Jari-jari awal filter debanding. Jari-jari meningkat secara linier untuk
setiap iterasi. Radius yang lebih tinggi akan menemukan lebih banyak gradien, tetapi radius yang lebih rendah
akan halus lebih agresif. (Bawaan 16)

Jika Anda meningkatkan deband-iterasi, Anda mungkin harus mengurangi ini menjadi
mengimbangi.

deband-grain=<0..4096>
Tambahkan beberapa noise ekstra pada gambar. Ini secara signifikan membantu menutupi
artefak kuantisasi yang tersisa. Angka yang lebih tinggi menambah lebih banyak suara. (Bawaan
48)

peningkatan sigmoid
Saat meningkatkan skala, gunakan transformasi warna sigmoidal untuk menghindari penekanan dering
artefak. Ini juga menyiratkan penskalaan linier.

pusat sigmoid
Pusat kurva sigmoid digunakan untuk peningkatan sigmoid, harus menjadi pelampung
antara 0.0 dan 1.0. Default ke 0.75 jika tidak ditentukan.

lereng sigmoid
Kemiringan kurva sigmoid digunakan untuk peningkatan sigmoid, harus menjadi pelampung
antara 1.0 dan 20.0. Default ke 6.5 jika tidak ditentukan.

mempertajam =
Jika disetel ke nilai selain 0, aktifkan filter penyamaran tidak tajam. Positif
nilai akan mempertajam gambar (tetapi menambahkan lebih banyak dering dan aliasing). Negatif
nilai akan mengaburkan gambar. Jika GPU Anda cukup kuat, pertimbangkan
alternatif seperti ewa_lanczossharp filter skala, atau skala-kabur
sub-opsi.

(Fitur ini adalah pengganti yang lama mempertajam3 dan mempertajam5 scaler.)

bahasa inggris
Memanggil glSelesai() sebelum dan sesudah menukar buffer (default: dinonaktifkan).
Lebih lambat, tetapi mungkin membantu mendapatkan hasil yang lebih baik saat melakukan framedrop. Bisa
benar-benar merusak kinerja. Detailnya sepenuhnya bergantung pada OpenGL
sopir.

tungguvsync
Memanggil glXTungguVideoSyncSGI setelah setiap pertukaran buffer (default: dinonaktifkan). Ini
mungkin atau mungkin tidak membantu dengan akurasi waktu video dan penurunan bingkai. Itu mungkin
bahwa ini membuat output video lebih lambat, atau tidak berpengaruh sama sekali.

X11/GLX saja.

vsync-pagar=
Sinkronkan CPU ke frame ke-N sebelumnya menggunakan GL_ARB_sinkronisasi perpanjangan. SEBUAH
nilai 0 menonaktifkan perilaku ini (default). Nilai 1 berarti akan
menyinkronkan ke bingkai saat ini setelah merendernya. Suka bahasa inggris dan
tungguvsync, ini dapat menurunkan atau merusak kinerja. Kelebihannya bisa
rentang beberapa frame, dan secara efektif membatasi jumlah frame GPU
antrian di depan (yang juga memiliki pengaruh pada vsync).

dwmflush=
Panggilan DwmFlush setelah menukar buffer pada Windows (default: auto). Juga
set Interval Tukar(0) untuk mengabaikan waktu OpenGL. Nilainya adalah: tidak ada (dinonaktifkan),
berjendela (hanya dalam mode berjendela), ya (juga dalam layar penuh).

Nilai mobil akan mencoba untuk menentukan apakah compositor aktif, dan
panggilan DwmFlush hanya jika tampaknya.

Ini dapat membantu mendapatkan interval bingkai yang lebih konsisten, terutama dengan
klip fps tinggi - yang mungkin juga mengurangi bingkai yang terjatuh. Biasanya nilai
of berjendela seharusnya cukup karena layar penuh dapat melewati DWM.

Windows saja.

sw Lanjutkan meskipun perender perangkat lunak terdeteksi.

bagian belakang =
Nilai mobil (default) memilih backend windowing. Anda juga bisa
lulus membantu untuk mendapatkan daftar lengkap yang dikompilasi di backend (diurutkan berdasarkan
pesanan autoprobe).

mobil pilih otomatis (default)

kakao Kakao/OS X

menang Win32/WGL

sudut Direct3D11 melalui ANGLE lapisan terjemahan OpenGL ES. Ini
mendukung hampir semuanya menang backend tidak, kecuali profil ICC,
masukan video kedalaman bit tinggi, dan nnedi3 penskala.

dxinterop (eksperimental)
Win32, menggunakan WGL untuk rendering dan Direct3D 9Ex untuk presentasi.
Bekerja pada Nvidia dan AMD saja.

x11 X11/GLX

Wayland
Wayland/EGL

drm-egl
DRM/EGL

x11egl X11/EGL

es=
Pilih apakah akan menggunakan GLES:

iya nih Cobalah untuk memilih ES daripada Desktop GL

tidak Cobalah untuk memilih GL desktop daripada ES

mobil Gunakan default untuk setiap backend (default)

format fbo=
Memilih format internal tekstur yang digunakan untuk FBO. Formatnya bisa
mempengaruhi kinerja dan kualitas output video. fmt dapat menjadi salah satu dari:
rgb, rgba, rgb8, rgb10, rgb10_a2, rgb16, rgb16f, rgb32f, rgba12, rgba16,
rgba16f, rgba32f. Bawaan: mobil, yang dipetakan ke rgba16 di desktop GL, dan
rgb10_a2 di GLES (mis. ANGLE).

gamma=<0.1..2.0>
Tetapkan nilai gamma (default: 1.0). Jika gamma disesuaikan dengan cara lain (seperti
pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. --gamma opsi atau ikatan kunci dan gamma properti), nilai
dikalikan dengan nilai gamma lainnya.

Nilai yang disarankan berdasarkan kecerahan lingkungan:

1.0 Terang terang (default)

0.9 Sedikit redup

0.8 Ruangan gelap gulita

gamma-otomatis
Secara otomatis mengoreksi nilai gamma tergantung pada pencahayaan sekitar
kondisi (menambahkan gamma boost untuk ruangan gelap).

Dengan pencahayaan sekitar 64lux, mpv akan memilih nilai gamma 1.0 (tidak ada
boost), dan sedikit meningkatkan boost hingga 0.8 untuk 16lux.

CATATAN: Hanya diimplementasikan pada OS X.

target-prim=
Menentukan tampilan utama. Warna video akan disesuaikan dengan ini
ruang warna jika perlu. Nilai yang valid adalah:

mobil Nonaktifkan adaptasi apa pun (default)

bt.470m
ITU-R BT.470 M

bt.601-525
ITU-R BT.601 (sistem SD 525 baris, misalnya NTSC), SMPTE 170M/240M

bt.601-625
ITU-R BT.601 (sistem SD 625 baris, misalnya PAL/SECAM), ITU-R BT.470 B/G

bt.709 ITU-R BT.709 (HD), IEC 61966-2-4 (sRGB), SMPTE RP177 Lampiran B

bt.2020
ITU-R BT.2020 (UHD)

apel RGB apel

adobe AdobeRGB (1998)

foto profil
ProFoto RGB (ROMM)

ci1931
CIE 1931 RGB (jangan dikelirukan dengan CIE XYZ)

target-trc=
Menentukan karakteristik transfer (gamma) tampilan. Warna video
akan disesuaikan dengan kurva ini. Nilai yang valid adalah:

mobil Nonaktifkan adaptasi apa pun (default)

bt.1886
Kurva ITU-R BT.1886, tanpa penurunan kecerahan (sekitar 1.961)

srgb IEC 61966-2-4 (sRGB)

linear Output cahaya linier

gamma1.8
Kurva daya murni (gamma 1.8), juga digunakan untuk Apple RGB

gamma2.2
Kurva daya murni (gamma 2.2)

gamma2.8
Kurva daya murni (gamma 2.8), juga digunakan untuk BT.470-BG

foto profil
ProFoto RGB (ROMM)

icc-profil=
Muat profil ICC dan gunakan untuk mengubah RGB linier ke output layar.
Membutuhkan dukungan LittleCMS 2 yang dikompilasi. Opsi ini mengesampingkan
target-prim, target-trc dan ic-profil-otomatis Pilihan.

ic-profil-otomatis
Secara otomatis memilih profil tampilan ICC yang saat ini ditentukan oleh
pengaturan tampilan sistem operasi.

CATATAN: Pada Windows, profil default harus berupa profil ICC. profil WCS
tidak didukung.

icc-cache-dir=
Simpan dan muat LUT 3D yang dibuat dari profil ICC di direktori ini.
Ini dapat digunakan untuk mempercepat pemuatan, karena LittleCMS 2 dapat memakan waktu cukup lama untuk
membuat LUT 3D. Perhatikan bahwa file-file ini berisi LUT yang tidak terkompresi. Milik mereka
ukuran tergantung pada 3dlut-ukuran, dan bisa sangat besar.

CATATAN: Ini tidak dibersihkan secara otomatis, begitu lama, file cache yang tidak digunakan mungkin
bertahan tanpa batas.

icc-niat=
Menentukan maksud ICC yang digunakan untuk transformasi warna (saat menggunakan
icc-profil).

0 perseptual

1 kolorimetri relatif (default)

2 kejenuhan

3 kolorimetri mutlak

3dlut-ukuran= x x
Ukuran LUT 3D yang dihasilkan dari profil ICC di setiap dimensi.
Standarnya adalah 128x256x64. Ukuran harus pangkat dua, dan paling banyak 512.

campuran-subtitel=
Padukan subtitle langsung ke bingkai video yang ditingkatkan, sebelum interpolasi
dan/atau manajemen warna (default: tidak). Mengaktifkan ini menyebabkan subtitle menjadi
dipengaruhi oleh icc-profil, target-prim, target-trc, interpolasi, gamma dan
pasca-shader. Ini juga meningkatkan kinerja subtitle saat menggunakan
interpolasi.

Kelemahan dari mengaktifkan ini adalah membatasi subtitle ke yang terlihat
bagian dari video, jadi Anda tidak dapat memiliki subtitle di margin hitam
di bawah video (misalnya).

If video dipilih, perilakunya mirip dengan iya nih, tetapi kapal selam ditarik di
resolusi asli video, dan diskalakan bersama dengan video.

PERINGATAN:
Ini mengubah cara warna subtitle ditangani. Biasanya, subtitle
warna diasumsikan dalam sRGB dan warna dikelola seperti itu. Mengaktifkan ini
membuat mereka diperlakukan seperti berada di ruang warna video. Ini
bagus jika Anda ingin hal-hal seperti tanda ASS softsubbed untuk mencocokkan video
warna, tetapi dapat menyebabkan subtitle SRT atau sejenisnya terlihat sedikit tidak aktif.

alfa =
Memutuskan apa yang harus dilakukan jika input memiliki komponen alpha (default: blend).

campuran Padukan bingkai dengan latar belakang hitam.

iya nih Cobalah untuk membuat framebuffer dengan komponen alpha. Ini hanya membuat
masuk akal jika video berisi informasi alfa (yang sangat
langka). Mungkin tidak didukung di semua platform. Jika alpha framebuffers
tidak tersedia, diam-diam jatuh kembali pada framebuffer normal. Catatan
bahwa jika Anda mengatur format fbo opsi ke nilai non-default, a
format dengan alfa harus ditentukan, atau ini tidak akan berfungsi.

tidak Abaikan komponen alfa.

persegi panjang-tekstur
Paksa penggunaan tekstur persegi panjang (default: tidak). Biasanya ini tidak seharusnya
keuntungan apapun atas tekstur normal. Perhatikan bahwa decoding perangkat keras menimpa
bendera ini.

latar belakang=
Warna yang digunakan untuk menggambar bagian dari jendela mpv yang tidak tercakup oleh video. Lihat
--osd-warna pilihan bagaimana warna didefinisikan.

bukagl-hq
Sama dengan terbuka, tetapi dengan pengaturan default untuk rendering berkualitas tinggi.

Ini sama dengan:

--vo=opengl:scale=spline36:cscale=spline36:dscale=mitchell:dither-kedalaman=auto:koreksi-downscaling:sigmoid-upscaling:pbo:deband:es=no

Perhatikan bahwa beberapa LCD yang lebih murah melakukan dithering yang sangat mengganggu terbuka's
kebingungan. Menonaktifkan dithering dengan kedalaman gentar = tidak membantu.

sdl SDL 2.0+ Render driver output video, tergantung pada sistem dengan atau tanpa perangkat keras
percepatan. Harus bekerja pada semua platform yang didukung oleh SDL 2.0. Untuk penyetelan, lihat
ke salinan file Anda SDL_petunjuk.h.

CATATAN:
Driver ini untuk kompatibilitas dengan sistem yang tidak menyediakan grafik yang tepat
driver, atau yang hanya mendukung GLES.

sw Lanjutkan meskipun perender perangkat lunak terdeteksi.

beralih-mode
Instruksikan SDL untuk mengganti mode video monitor saat menggunakan layar penuh.

vaapi Driver output video Intel VA API dengan dukungan untuk decoding perangkat keras. Perhatikan bahwa
sama sekali tidak ada alasan untuk menggunakan ini, selain ingin menggunakan perangkat keras
decoding untuk menghemat daya pada laptop, atau mungkin mencegah video robek dengan beberapa
pengaturan.

CATATAN:
Driver ini untuk kompatibilitas dengan sistem jelek. Anda dapat menggunakan perangkat keras vaapi
decoding dengan --vo=terbuka juga.

penskalaan =

kegagalan
Default driver (default mpv juga).

cepat Cepat, tapi kualitas rendah.

hq Penskalaan kualitas tinggi bergantung pada driver yang tidak ditentukan, lambat.

nthe tidak linier anamorphic skala

mode-deint=
Pilih algoritma deinterlacing. Perhatikan bahwa secara default deinterlacing adalah
awalnya selalu mati, dan perlu diaktifkan dengan d kunci (kunci default
mengikat untuk siklus deinterlace).

Opsi ini tidak berlaku jika libva mendukung pemrosesan pos video (vpp). Di
kasus ini, default untuk mode-deint is tidak, dan mengaktifkan deinterlacing melalui
interaksi pengguna menggunakan metode yang disebutkan di atas sebenarnya menyisipkan
vavpp penyaring video. Jika vpp sebenarnya tidak didukung dengan libva backend
saat digunakan, Anda dapat menggunakan opsi ini untuk mengaktifkan deinterlacing berbasis VO secara paksa.

tidak Jangan izinkan deinterlacing (default untuk libva yang lebih baru).

lapangan pertama
Tampilkan hanya bidang pertama (lewat --dominan-bidang).

bob bob deinterlacing (default untuk libva yang lebih lama).

scaled-osd=
Jika diaktifkan, maka OSD dirender pada resolusi video dan diskalakan ke
resolusi tampilan. Secara default, ini dinonaktifkan, dan OSD ditampilkan di
resolusi tampilan jika driver mendukungnya.

nol Tidak menghasilkan output video. Berguna untuk pembandingan.

Biasanya, lebih baik menonaktifkan video dengan --tanpa-video sebagai gantinya.

fps =
Simulasikan tampilan FPS. Ini secara artifisial membatasi berapa banyak frame VO
menerima per detik.

Caca Driver output video seni ASCII berwarna yang bekerja pada konsol teks.

CATATAN:
Sopir ini adalah lelucon.

gambar Keluarkan setiap bingkai ke dalam file gambar di direktori saat ini. Setiap file mengambil
nomor bingkai diisi dengan nol di depan sebagai nama.

format=
Pilih format file gambar.

jpg File JPEG, ekstensi .jpg. (Bawaan.)

jpeg File JPEG, ekstensi .jpeg.

png file PNG.

ppm Format bitmap portabel.

pgm Format peta abu-abu portabel.

pgmyuv Format peta abu-abu portabel, menggunakan format piksel YV12.

tga TGA Truevision.

png-kompresi=<0-9>
Faktor kompresi PNG (kecepatan vs ukuran file tradeoff) (default: 7)

png-filter=<0-5>
Filter diterapkan sebelum kompresi PNG (0 = tidak ada; 1 = sub; 2 = naik; 3 =
rata-rata; 4 = Paeth; 5 = campuran) (default: 5)

jpeg-kualitas=<0-100>
Faktor kualitas JPEG (default: 90)

(tidak-)jpeg-progresif
Tentukan JPEG standar atau progresif (default: tidak).

(tidak-)jpeg-baseline
Tentukan penggunaan JPEG baseline atau tidak (default: yes).

jpeg-optimize=<0-100>
Faktor pengoptimalan JPEG (default: 100)

jpeg-halus=<0-100>
faktor halus (default: 0)

jpeg-dpi=<1->
JPEG DPI (standar: 72)

keluar =
Tentukan direktori untuk menyimpan file gambar (default: ./).

Wayland (Tanah Jalan saja)
Wayland membagikan output video memori sebagai cadangan untuk terbuka.

CATATAN:
Driver ini untuk kompatibilitas dengan sistem yang tidak menyediakan OpenGL yang berfungsi
driver.

alfa Gunakan format buffer yang mendukung video dan gambar dengan informasi alfa

rgb565 Gunakan RGB565 sebagai format buffer. Format ini diimplementasikan pada sebagian besar platform,
terutama pada embedded yang jauh lebih efisien daripada RGB8888.

penyangga rangkap tiga
Gunakan 3 buffer alih-alih 2. Ini dapat menghasilkan pemutaran yang lebih lancar, tetapi gunakan
lebih banyak memori.

opengl-cb
Untuk digunakan dengan penyematan OpenGL langsung libmpv; tidak berguna dalam konteks lain. (Lihat
.)

Ini juga mendukung banyak subopsi yang terbuka VO memiliki. Lari mpv
--vo=opengl-cb:bantuan untuk daftar.

Ini juga mendukung vo_cmdline perintah.

rpi (Frambos pi)
Output video asli pada Raspberry Pi menggunakan MMAL API.

tampilan=
Pilih nomor tampilan tempat hamparan video akan ditampilkan
(standar: 0).

lapisan =
Pilih lapisan dispmanx tempat hamparan video akan ditampilkan
(default: -10). Perhatikan bahwa mpv juga akan menggunakan 2 lapisan di atas yang dipilih
layer, untuk menangani latar belakang jendela dan OSD. Render video yang sebenarnya akan
terjadi pada lapisan di atas lapisan yang dipilih.

latar belakang=
Apakah akan membuat latar belakang hitam di belakang video (default: tidak).
Biasanya lebih baik untuk membunuh framebuffer konsol sebagai gantinya, yang memberikan
kinerja yang lebih baik.

osd=
Diaktifkan secara default. Jika dinonaktifkan dengan tidak, tidak ada lapisan OSD yang dibuat. Ini juga
berarti tidak akan ada subtitle yang diberikan.

drm (Langsung Rendering manager)
Driver output video menggunakan Pengaturan Mode Kernel / Manajer Rendering Langsung. Sebaiknya
digunakan ketika seseorang tidak ingin menginstal lingkungan grafis lengkap (mis
X). Tidak mendukung akselerasi perangkat keras (jika Anda membutuhkan ini, periksa drm-egl
backend untuk terbuka VO).

konektor =
Pilih konektor yang akan digunakan (biasanya ini adalah monitor.) Jika diatur ke -1, mpv
membuat output pada konektor pertama yang tersedia. (bawaan: -1)

devpath=
Jalur ke perangkat kartu grafis. (default: /dev/dri/card0)

modus =
ID Mode yang akan digunakan (resolusi, kedalaman bit, dan kecepatan bingkai). (bawaan: 0)

AUDIO FILTER

Filter audio memungkinkan Anda untuk memodifikasi aliran audio dan propertinya. Sintaksnya adalah:

--af=
Siapkan rangkaian filter audio.

CATATAN:
Untuk mendapatkan daftar lengkap filter audio yang tersedia, lihat --af=membantu.

Juga, perlu diingat bahwa sebagian besar filter aktual tersedia melalui lavfi pembungkus, yang
memberi Anda akses ke sebagian besar filter libavfilter. Ini mencakup semua filter yang memiliki
telah porting dari MPlayer ke libavfilter.

Anda juga dapat mengatur default untuk setiap filter. Default diterapkan sebelum normal
parameter filter.

--af-default=
Tetapkan default untuk setiap filter.

Filter audio dikelola dalam daftar. Ada beberapa perintah untuk mengelola daftar filter:

--af-tambah=
Menambahkan filter yang diberikan sebagai argumen ke daftar filter.

--af-pre=
Menambahkan filter yang diberikan sebagai argumen ke daftar filter.

--af-del=
Menghapus filter pada indeks yang diberikan. Angka indeks mulai dari 0, negatif
nomor alamat akhir daftar (-1 adalah yang terakhir).

--af-clr
Benar-benar mengosongkan daftar filter.

Filter yang tersedia adalah:

lavrresample[=opsi1:opsi2:...]
Filter ini menggunakan libavresample (atau libswresample, tergantung pada build) untuk mengubah
laju sampel, format sampel, atau tata letak saluran aliran audio. Filter ini adalah
diaktifkan secara otomatis jika output audio tidak mendukung konfigurasi audio
dari file yang sedang diputar.

Ini hanya mendukung format contoh berikut: u8, s16, s32, float.

ukuran filter=
Panjang filter sehubungan dengan laju pengambilan sampel yang lebih rendah. (bawaan: 16)

pergeseran fasa =
Log2 dari jumlah entri polifase. (..., 10->1024, 11->2048, 12->4096,
...) (default: 10->1024)

batas =
Frekuensi cutoff (0.0-1.0), set default tergantung pada panjang filter.

linear Jika diatur maka filter akan diinterpolasi secara linier di antara entri polifase.
(default: tidak)

tidak-melepaskan
Jangan lepaskan jika format/kecepatan/saluran audio input dan output cocok. (Jika kamu
hanya ingin mengatur default untuk filter ini yang akan digunakan bahkan oleh
contoh lavrresample yang dimasukkan secara otomatis, Anda harus memilih pengaturan
mereka dengan --af-defaults=sampel lavr:....)

normalisasi=
Apakah akan menormalkan saat me-remix tata letak saluran (default: ya). Ini
misalnya diterapkan saat downmixing surround audio ke stereo. Keuntungannya adalah
ini menjamin bahwa tidak ada kliping yang bisa terjadi. Sayangnya, ini juga bisa
menyebabkan tingkat volume yang terlalu rendah. Apakah Anda mengaktifkan atau menonaktifkan ini
intinya soal selera, tapi defaultnya menggunakan pilihan yang lebih aman.

o =
Setel AVOptions pada SwrContext atau AVAudioResampleContext. Ini seharusnya
didokumentasikan oleh FFmpeg atau Libav.

lavcac3enc[=tospdif[:kecepatan bit[:minch]]]
Encode audio multi-channel ke AC-3 saat runtime menggunakan libavcodec. Mendukung 16-bit
format input native-endian, maksimum 6 saluran. Outputnya adalah big-endian ketika
mengeluarkan aliran AC-3 mentah, native-endian saat mengeluarkan ke S/PDIF. Jika masukan
sample rate tidak 48 kHz, 44.1 kHz atau 32 kHz, itu akan disampel ulang menjadi 48 kHz.

tospdif=
Keluarkan aliran AC-3 mentah jika tidak, output ke S/PDIF untuk pass-through if iya nih
(bawaan).

kecepatan bit =
Bitrate digunakan untuk aliran AC-3. Atur ke 384 untuk mendapatkan 384 kbps.

Standarnya adalah 640. Beberapa receiver mungkin tidak dapat menangani ini.

Nilai yang valid: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320,
384, 448, 512, 576, 640.

Nilai khusus mobil memilih bitrate default berdasarkan saluran input
jumlah:

1ch 96

2ch 192

3ch 224

4ch 384

5ch 448

6ch 448

minch =
Jika nomor saluran input kurang dari , filter akan terlepas
sendiri (default: 3).

penyeimbang=g1:g2:g3:...:g10
Equalizer grafis 10 oktaf band, diimplementasikan menggunakan 10 filter band-pass IIR. Ini
berarti itu berfungsi terlepas dari jenis audio apa yang sedang diputar. Itu
frekuensi pusat untuk 10 band adalah:

┌─ans───┬───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
Tidak. frekuensi
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
0 31.25 Hz
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
1 62.50 Hz
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
2 125.00 Hz
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
3 250.00 Hz
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
4 500.00 Hz
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
5 1.00 kHz
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
6 2.00 kHz
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
7 4.00 kHz
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
8 8.00 kHz
├─ans───┼───── teks─ XNUMX Chilan XNUMXX XNUMX Ch
9 16.00 kHz
└─ans───┴───── teks─ XNUMX Chilan XNUMXX XNUMX Ch

Jika laju sampel suara yang dimainkan lebih rendah dari frekuensi tengah untuk
pita frekuensi, maka pita itu akan dinonaktifkan. Bug yang diketahui dengan filter ini adalah
bahwa karakteristik pita paling atas tidak sepenuhnya simetris jika
sample rate dekat dengan frekuensi tengah pita itu. Masalah ini bisa
bekerja dengan upsampling suara menggunakan filter resampling sebelum mencapai
penyaring ini.

: : :...:
angka floating point yang mewakili penguatan dalam dB untuk setiap pita frekuensi
(-12-12)

Example

mpv --af=equalizer=11:11:10:5:0:-12:0:5:12:12 media.avi
Akan memperkuat suara di wilayah frekuensi atas dan bawah sementara
membatalkannya hampir sepenuhnya sekitar 1 kHz.

saluran=nch[:rute]
Dapat digunakan untuk menambah, menghapus, merutekan, dan menyalin saluran audio. Jika hanya
diberikan, perutean default digunakan. Ini bekerja sebagai berikut: Jika jumlah output
saluran lebih besar dari jumlah saluran input, saluran kosong dimasukkan
(kecuali saat mencampur dari mono ke stereo; kemudian saluran mono diduplikasi). Jika
jumlah saluran keluaran lebih kecil dari jumlah saluran masukan,
saluran yang melebihi akan dipotong.

jumlah saluran keluaran (1-8)


Daftar , rute terpisah, dalam bentuk dari1-ke1,dari2-ke2,.... Setiap pasang
menentukan tempat untuk merutekan setiap saluran. Paling banyak ada 8 rute. Tanpa
argumen ini, perutean default digunakan. Sejak , juga digunakan untuk memisahkan
filter, Anda harus mengutip argumen ini dengan [...] atau serupa.

contoh

mpv --af=channels=4:[0-1,1-0,2-2,3-3] media.avi
Akan mengubah jumlah saluran menjadi 4 dan mengatur 4 rute yang bertukar
saluran 0 dan saluran 1 dan biarkan saluran 2 dan 3 tetap utuh. Perhatikan itu
jika media yang berisi dua saluran diputar ulang, saluran 2 dan 3 akan
berisi keheningan tetapi 0 dan 1 masih akan ditukar.

mpv --af=channels=6:[0-0,0-1,0-2,0-3] media.avi
Akan mengubah jumlah saluran menjadi 6 dan mengatur 4 rute yang menyalin
saluran 0 ke saluran 0 sampai 3. Saluran 4 dan 5 akan berisi keheningan.

CATATAN:
Anda mungkin sebaiknya tidak menggunakan filter ini. Jika Anda ingin mengubah output
tata letak saluran, coba format filter, yang dapat membuat mpv otomatis naik- dan
tata letak saluran standar downmix.

format=format:srate:saluran:out-format:out-srate:out-channel
Tidak melakukan konversi format itu sendiri. Sebaliknya, itu dapat menyebabkan sistem filter
masukkan filter konversi yang diperlukan sebelum atau sesudah filter ini jika diperlukan. Dia
terutama berguna untuk mengontrol format audio yang masuk ke filter lain. Ke
tentukan format untuk output audio, lihat --format-audio, --audio-sampel, dan
--saluran-audio. Filter ini mampu memaksa format tertentu, sedangkan
--audio-* dapat ditimpa oleh ao berdasarkan kompatibilitas keluaran.

Semua parameter adalah opsional. 3 parameter pertama membatasi filter
menerima sebagai masukan. Oleh karena itu mereka akan menyebabkan filter konversi dimasukkan
sebelum yang satu ini. Itu di luar- parameter memberi tahu filter atau output audio berikut:
filter ini bagaimana menafsirkan data tanpa benar-benar melakukan konversi. Pengaturan
ini mungkin hanya akan merusak barang-barang kecuali Anda benar-benar tahu Anda menginginkan ini untuk beberapa orang
alasan, seperti menguji atau menangani media yang rusak.


Paksa konversi ke format ini. Menggunakan --af=format=format=bantuan untuk mendapatkan daftar
dari format yang valid.


Paksa konversi ke laju sampel tertentu. Nilainya adalah bilangan bulat, 48000
misalnya.


Memaksa pencampuran ke tata letak saluran tertentu. Lihat --saluran-audio pilihan untuk
nilai-nilai yang mungkin.







CATATAN: filter ini dulu bernama kekuatan. Yang tua format filter digunakan untuk melakukan
konversi itu sendiri, tidak seperti ini yang memungkinkan sistem filter menangani
konversi.

volume[= [:...]]
Menerapkan kontrol volume perangkat lunak. Gunakan filter ini dengan hati-hati karena dapat
mengurangi sinyal untuk rasio kebisingan suara. Dalam kebanyakan kasus, yang terbaik adalah menggunakan
Menguasai kontrol volume kartu suara Anda atau kenop volume pada amplifier Anda.

CATATAN: Filter ini tidak masuk kembali dan oleh karena itu hanya dapat diaktifkan sekali untuk setiap
aliran audio.


Setel penguatan yang diinginkan dalam dB untuk semua saluran dalam aliran dari -200 dB hingga
+60 dB, di mana -200 dB mematikan suara sepenuhnya dan +60 dB sama dengan penguatan
1000 (standar: 0).

replaygain-track
Sesuaikan penguatan volume sesuai dengan nilai perolehan ulang track-gain yang disimpan di
metadata filenya.

album replaygain
Seperti replaygain-track, tetapi menggunakan nilai album-gain sebagai gantinya.

replaygain-preamp
Penguatan pra-amplifikasi dalam dB untuk diterapkan pada penguatan penguatan replay yang dipilih
(standar: 0).

replaygain-clip=ya|tidak
Cegah kliping yang disebabkan oleh replaygain dengan secara otomatis menurunkan gain
(bawaan). Menggunakan replaygain-clip=tidak untuk menonaktifkan ini.

replaygain-fallback
Keuntungan dalam dB untuk diterapkan jika file tidak memiliki tag gain replay. Pilihan ini adalah
selalu diterapkan jika logika replaygain entah bagaimana tidak aktif. Jika ini adalah
diterapkan, tidak ada opsi pemutaran ulang lainnya yang diterapkan.

klip lunak
Mengaktifkan kliping lembut. Kliping lembut dapat membuat suara lebih halus jika sangat
digunakan tingkat volume tinggi. Aktifkan opsi ini jika rentang dinamis dari
pengeras suara sangat rendah.

PERINGATAN: Fitur ini menciptakan distorsi dan harus dianggap sebagai yang terakhir
resor.

s16 Paksa format sampel S16 jika disetel. Kualitas lebih rendah, tetapi mungkin lebih cepat di beberapa
situasi.

Lepaskan Hapus filter jika volume tidak berubah pada waktu konfigurasi filter audio.
Berguna dengan replaygain: jika file saat ini tidak memiliki tag replaygain, maka
filter akan dihapus jika opsi ini diaktifkan. (Jika --softvol=ya digunakan
dan kontrol volume pemutar digunakan selama pemutaran, volume yang berbeda
filter akan dimasukkan.)

Example

mpv --af=volume=10.1 media.avi
Akan memperkuat suara sebesar 10.1 dB dan hard-clip jika level suaranya
terlalu tinggi.

panci=n:[ ]
Mencampur saluran secara sewenang-wenang. Pada dasarnya kombinasi volume dan saluran
filter yang bisa digunakan untuk down-mix banyak channel menjadi hanya sedikit, misal stereo to
mono, atau memvariasikan "lebar" speaker tengah dalam sistem suara surround. Ini
filter sulit digunakan, dan akan membutuhkan beberapa penyesuaian sebelum hasil yang diinginkan adalah
diperoleh. Jumlah opsi untuk filter ini tergantung pada jumlah output
saluran. Contoh cara downmix file enam saluran menjadi dua saluran dengan ini
filter dapat ditemukan di bagian contoh di dekat bagian akhir.

Jumlah saluran keluaran (1-8).


Sebuah daftar nilai [L00,L01,L02,...,L10,L11,L12,...,Ln0,Ln1,Ln2,...], Di mana
setiap elemen Lijo berarti berapa banyak saluran input i dicampur menjadi output
saluran j (kisaran 0-1). Jadi pada prinsipnya Anda pertama-tama memiliki n angka yang mengatakan apa
hubungannya dengan saluran input pertama, kemudian n angka yang bekerja pada yang kedua
saluran input dll. Jika Anda tidak menentukan angka apa pun untuk beberapa input
saluran, 0 diasumsikan. Perhatikan bahwa nilai-nilai dipisahkan oleh ,, Yang
sudah digunakan oleh parser opsi untuk memisahkan filter. Inilah mengapa Anda harus
mengutip daftar nilai dengan [...] atau serupa.

contoh

mpv --af=pan=1:[0.5,0.5] media.avi
Akan downmix dari stereo ke mono.

mpv --af=pan=3:[1,0,0.5,0,1,0.5] media.avi
Akan memberikan output 3 saluran yang meninggalkan saluran 0 dan 1 utuh, dan campur
saluran 0 dan 1 ke saluran keluaran 2 (yang dapat dikirim ke a
subwoofer misalnya).

CATATAN:
Jika Anda hanya ingin memaksa remix ke tata letak saluran keluaran tertentu, itu adalah
lebih mudah menggunakan format Saring. Sebagai contoh, mpv '--af=format=saluran=5.1'
'--saluran audio=5.1' akan selalu memaksa remixing audio ke 5.1 dan mengeluarkannya
seperti ini.

tunda[=[ch1,ch2,...]]
Menunda suara ke pengeras suara sedemikian rupa sehingga suara dari yang berbeda
saluran tiba di posisi mendengarkan secara bersamaan. Ini hanya berguna jika Anda
memiliki lebih dari 2 pengeras suara.

[ch1,ch2,...]
Keterlambatan dalam ms yang harus dikenakan pada setiap saluran (floating point
angka antara 0 dan 1000).

Untuk menghitung penundaan yang diperlukan untuk saluran yang berbeda, lakukan hal berikut:

1. Ukur jarak ke pengeras suara dalam meter sehubungan dengan pendengaran Anda
posisi, memberi Anda jarak s1 hingga s5 (untuk sistem 5.1). Tidak ada
titik kompensasi untuk subwoofer (Anda tidak akan mendengar perbedaannya
pokoknya).

2. Kurangi jarak s1 ke s5 dari jarak maksimum, yaitu s [i] = maks -
s[saya]; i = 1 ... 5.

3. Hitung penundaan yang diperlukan dalam ms as d[saya] = 1000*s[i]/342; i = 1 ... 5.

Example

mpv --af=penundaan=[10.5,10.5,0,0,7,0] media.avi
Akan menunda depan kiri dan kanan sebesar 10.5 ms, dua saluran belakang dan
subwoofer sebesar 0 ms dan saluran tengah sebesar 7 ms.

drc[=metode:target]
Menerapkan kompresi rentang dinamis. Ini memaksimalkan volume dengan mengompresi
rentang dinamis sinyal audio. (Sebelumnya disebut volnorm.)


Mengatur metode yang digunakan.

1 Gunakan satu sampel untuk menghaluskan variasi melalui standar
rata-rata tertimbang atas sampel sebelumnya (default).

2 Gunakan beberapa sampel untuk menghaluskan variasi melalui standar
rata-rata tertimbang atas sampel masa lalu.


Menetapkan amplitudo target sebagai pecahan maksimum untuk jenis sampel
(standar: 0.25).

CATATAN:
Filter ini dapat menyebabkan distorsi dengan sinyal audio yang sangat besar
rentang dinamis.

scaletempo[=opsi1:opsi2:...]
Menskalakan tempo audio tanpa mengubah nada, secara opsional disinkronkan dengan kecepatan pemutaran
(bawaan).

Ini bekerja dengan memutar 'stride' ms audio pada kecepatan normal kemudian mengkonsumsi
'stride*scale' ms dari input audio. Ini menyatukan langkah dengan memadukan
'tumpang tindih'% langkah dengan audio mengikuti langkah sebelumnya. Ini opsional
melakukan analisis statistik singkat pada ms audio 'pencarian' berikutnya untuk menentukan
posisi tumpang tindih terbaik.

skala =
Jumlah nominal untuk skala tempo. Timbangan jumlah ini selain kecepatan.
(bawaan: 1.0)

langkah =
Panjangnya dalam milidetik untuk menghasilkan setiap langkah. Nilai yang terlalu tinggi akan menyebabkan
lompatan yang terlihat pada jumlah skala tinggi dan gema pada jumlah skala rendah.
Nilai yang sangat rendah akan mengubah nada. Meningkatkan meningkatkan kinerja. (bawaan:
60)

tumpang tindih =
Persentase langkah untuk tumpang tindih. Penurunan meningkatkan kinerja. (bawaan:
.20)

cari=
Panjang dalam milidetik untuk mencari posisi tumpang tindih terbaik. menurun
meningkatkan kinerja sangat. Pada sistem yang lambat, Anda mungkin ingin mengatur
ini sangat rendah. (bawaan: 14)

kecepatan =
Atur respons terhadap perubahan kecepatan.

waktu Skala tempo sinkron dengan kecepatan (default).

nada Membalikkan efek filter. Menskalakan nada tanpa mengubah tempo. Menambahkan
ini untukmu masukan.conf untuk melangkah dengan semi-nada musik:

[ kecepatan kalikan 0.9438743126816935
] kecepatan kalikan 1.059463094352953

PERINGATAN:
Kehilangan sinkronisasi dengan video.

kedua Skala tempo dan nada.

tak satupun Abaikan perubahan kecepatan.

contoh

mpv --af=tempo skala --kecepatan = 1.2 media.ogg
Akan memutar media pada kecepatan normal 1.2x, dengan audio pada nada normal.
Mengubah kecepatan pemutaran akan mengubah tempo audio agar sesuai.

mpv --af=scaletempo=skala=1.2:kecepatan=tidak ada --kecepatan = 1.2 media.ogg
Akan memutar media pada kecepatan normal 1.2x, dengan audio pada nada normal, tapi
mengubah kecepatan pemutaran tidak akan berpengaruh pada tempo audio.

mpv --af=scaletempo=langkah=30:tumpang tindih=.50:pencarian=10 media.ogg
Akan men-tweak parameter kualitas dan kinerja.

mpv --af=format=float,tempo skala media.ogg
Akan membuat scaletempo menggunakan kode float. Mungkin lebih cepat di beberapa platform.

mpv --af=scaletempo=skala=1.2:kecepatan=pitch audio.ogg
Akan memutar media pada kecepatan normal 1.2x, dengan audio pada nada normal.
Mengubah kecepatan pemutaran akan mengubah nada, meninggalkan tempo audio pada 1.2x.

gelang karet
Koreksi nada berkualitas tinggi dengan librubberband. Ini dapat digunakan sebagai pengganti
skalatempo, dan akan digunakan untuk menyesuaikan nada audio saat diputar dengan kecepatan berbeda
dari normal.

Filter ini memiliki sejumlah sub-opsi. Anda dapat mencantumkannya dengan mpv
--af=karet=bantuan. Ini juga akan menampilkan nilai default untuk setiap opsi. Itu
opsi tidak didokumentasikan di sini, karena hanya diteruskan ke librubberband.
Lihat dokumentasi librubberband untuk mempelajari apa yang dilakukan setiap opsi:
http://breakfastquay.com/rubberband/code-doc/classRubberBand_1_1RubberBandStretcher.html
(Pemetaan nama dan nilai sub-pilihan filter karet gelang mpv dengan yang
librubberband mengikuti pola sederhana: "Pilihan" + Nama + Nilai.)

lavfi=grafik
Filter audio menggunakan libavfilter FFmpeg.


grafik Libavfilter. Lihat lavfi filter video untuk detailnya - sintaks grafiknya adalah
sama.

PERINGATAN:
Jangan lupa untuk mengutip grafik libavfilter seperti yang dijelaskan dalam video lavfi
bagian penyaring.

o =
Opsi AV

VIDEO FILTER

Filter video memungkinkan Anda untuk mengubah aliran video dan propertinya. Sintaksnya adalah:

--vf=
Siapkan rangkaian filter video.

Anda juga dapat mengatur default untuk setiap filter. Default diterapkan sebelum normal
parameter filter.

--vf-default=
Tetapkan default untuk setiap filter.

CATATAN:
Untuk mendapatkan daftar lengkap filter video yang tersedia, lihat --vf=bantuan.

Juga, perlu diingat bahwa sebagian besar filter aktual tersedia melalui lavfi pembungkus, yang
memberi Anda akses ke sebagian besar filter libavfilter. Ini mencakup semua filter yang memiliki
telah porting dari MPlayer ke libavfilter.

Filter video dikelola dalam daftar. Ada beberapa perintah untuk mengelola daftar filter.

--vf-tambah=
Menambahkan filter yang diberikan sebagai argumen ke daftar filter.

--vf-pra=
Menambahkan filter yang diberikan sebagai argumen ke daftar filter.

--vf-del=
Menghapus filter pada indeks yang diberikan. Angka indeks mulai dari 0, negatif
nomor alamat akhir daftar (-1 adalah yang terakhir).

--vf-clr
Benar-benar mengosongkan daftar filter.

Dengan filter yang mendukungnya, Anda dapat mengakses parameter berdasarkan namanya.

--vf= =bantuan
Mencetak nama parameter dan rentang nilai parameter untuk filter tertentu.

--vf=
Menetapkan parameter bernama ke nilai yang diberikan. Gunakan hidup dan mati atau ya dan tidak untuk menyetel tanda
parameter.

Filter yang tersedia adalah:

potong[=w:h:x:y]
Pangkas bagian tertentu dari gambar dan buang sisanya. Berguna untuk menghilangkan hitam
band dari video layar lebar.

,
Lebar dan tinggi yang dipangkas, default ke lebar dan tinggi asli.

,
Posisi gambar yang dipotong, default ke tengah.

perluas[=w:h:x:y:aspek:bulat]
Memperluas (bukan menskalakan) resolusi video ke nilai yang diberikan dan menempatkan yang tidak diskalakan
asli pada koordinat x, y.

,
Lebar, tinggi yang diperluas (default: lebar asli, tinggi). Nilai negatif untuk
w dan h diperlakukan sebagai offset ke ukuran aslinya.

Example

perluas=0:-50:0:0
Menambahkan batas 50 piksel ke bagian bawah gambar.

,
posisi gambar asli pada gambar yang diperluas (default: tengah)


Perluas agar sesuai dengan aspek alih-alih resolusi (default: 0).

Example

luaskan=800::::4/3
Perluas hingga 800x600, kecuali sumbernya beresolusi lebih tinggi, dalam
kasus yang diperluas untuk mengisi aspek 4/3.


Bulatkan ke atas untuk membuat lebar dan tinggi habis dibagi (bawaan: 1).

penerjunan Membalik gambar terbalik.

cermin Mencerminkan gambar pada sumbu Y.

putar[=0|90|180|270]
Memutar gambar dengan kelipatan 90 derajat searah jarum jam.

skala[=w:h:param:param2:chr-drop:noup:arnd
Menskalakan gambar dengan software scaler (lambat) dan menampilkan warna YUV<->RGB
konversi ruang (lihat juga --sws).

Semua parameter adalah opsional.

:
skala lebar/tinggi (default: lebar/tinggi asli)

0 skala d_width/d_height

-1 lebar/tinggi asli

-2 Hitung w/h menggunakan dimensi lain dan aspek yang diskalakan sebelumnya
rasio.

-3 Hitung w/jam menggunakan dimensi lain dan aspek aslinya
rasio.

-(n+8) Seperti -n di atas, tetapi membulatkan dimensi ke kelipatan terdekat dari
16.

[: ] (Lihat juga --sws)
Atur beberapa parameter penskalaan tergantung pada jenis scaler yang dipilih dengan
--sws:

--sws=2 (bicubic): B (kabur) dan C (dering)
0.00:0.60 default
0.00:0.75 "bicubic presisi" VirtualDub
0.00:0.50 Spline Catmull-Rom
0.33:0.33 Spline Mitchell-Netravali
1.00:0.00 kubik B-spline

--sws=7 (Gaussian): ketajaman (0 (lunak) - 100 (tajam))

--sws=9 (Lanczos): panjang filter (1-10)


melewatkan kroma

0 Gunakan semua jalur input yang tersedia untuk chroma (default).

1 Gunakan hanya setiap 2. baris input untuk chroma.

2 Gunakan hanya setiap 4. baris input untuk chroma.

3 Gunakan hanya setiap 8. baris input untuk chroma.

Larang upscaling melewati dimensi asli.

0 Izinkan peningkatan (default).

1 Larang peningkatan jika satu dimensi melebihi nilai aslinya.

2 Larang peningkatan jika kedua dimensi melebihi nilai aslinya.

Pembulatan akurat untuk scaler vertikal, yang mungkin lebih cepat atau lebih lambat
daripada pembulatan default.

tidak Nonaktifkan pembulatan akurat (default).

iya nih Aktifkan pembulatan akurat.

dsize[=w:h:aspek-metode:r:aspek]
Mengubah ukuran/aspek tampilan yang diinginkan pada titik sembarang dalam rantai filter.
Aspek dapat diberikan sebagai pecahan (4/3) atau bilangan floating point (1.33).
Atau, Anda dapat menentukan lebar dan tinggi tampilan yang diinginkan. Catatan
yang dilakukan filter ini tidak melakukan penskalaan sendiri; itu hanya memengaruhi penskala selanjutnya
(perangkat lunak atau perangkat keras) akan dilakukan saat penskalaan otomatis ke aspek yang benar.

,
Lebar dan tinggi tampilan baru.

Bisa juga nilai-nilai khusus ini:

0 lebar dan tinggi tampilan asli

-1 lebar dan tinggi video asli (default)

-2 Hitung w/h menggunakan dimensi lain dan tampilan aslinya
rasio aspek.

-3 Hitung w/h menggunakan dimensi lain dan aspek video asli
rasio.

Example

ukuran=800:-2
Menentukan resolusi tampilan 800x600 untuk video aspek 4/3,
atau 800x450 untuk video aspek 16/9.


Memodifikasi lebar dan tinggi sesuai dengan rasio aspek asli.

-1 Abaikan rasio aspek asli (default).

0 Pertahankan rasio aspek tampilan dengan menggunakan dan sebagai resolusi maksimum.

1 Pertahankan rasio aspek tampilan dengan menggunakan dan sebagai resolusi minimum.

2 Pertahankan rasio aspek video dengan menggunakan dan sebagai resolusi maksimum.

3 Pertahankan rasio aspek video dengan menggunakan dan sebagai resolusi minimum.

Example

ukuran=800:600:0
Menentukan resolusi tampilan paling banyak 800x600, atau lebih kecil, dalam
untuk menjaga aspek.

Bulatkan ke atas untuk membuat lebar dan tinggi habis dibagi (standar: 1).


Paksa rasio aspek.

format=fmt= :matriks warna= :...
Membatasi ruang warna untuk filter berikutnya tanpa melakukan konversi apa pun. Menggunakan
bersama-sama dengan filter skala untuk konversi nyata.

CATATAN:
Untuk daftar format yang tersedia, lihat format=fmt=bantuan.

Nama format, misalnya rgb15, bgr24, 420p, dll. (default: jangan diubah).


Nama format yang harus diganti untuk output. Jika mereka tidak memiliki
byte yang sama per piksel dan subsamplimg kroma, itu akan gagal.


Mengontrol konversi ruang warna YUV ke RGB saat memutar video. Ada
berbagai standar. Biasanya, BT.601 harus digunakan untuk video SD, dan BT.709
untuk video HD. (Ini dilakukan secara default.) Menggunakan hasil ruang warna yang salah
dalam warna sedikit di bawah atau di atas jenuh dan bergeser.

Opsi ini tidak selalu didukung. Output video yang berbeda menyediakan
berbagai tingkat dukungan. Itu terbuka dan vdpau driver keluaran video
biasanya menawarkan dukungan penuh. Itu xv output dapat mengatur ruang warna jika
driver video sistem mendukungnya, tetapi tidak pada level input dan output. Itu skala
filter video dapat mengonfigurasi ruang warna dan level input, tetapi hanya jika
format output adalah RGB (jika driver output video mendukung output RGB, Anda
bisa memaksa ini dengan -vf skala, format = rgba).

Jika opsi ini disetel ke mobil (yang merupakan default), warna video
bendera luar angkasa akan digunakan. Jika bendera itu tidak disetel, ruang warna akan menjadi
dipilih secara otomatis. Ini dilakukan dengan menggunakan heuristik sederhana yang mencoba
untuk membedakan video SD dan HD. Jika video lebih besar dari 1279x576 piksel,
BT.709 (HD) akan digunakan; jika tidak, BT.601 (SD) dipilih.

Ruang warna yang tersedia adalah:

mobil pemilihan otomatis (default)

bt.601 ITU-R BT.601 (SD)

bt.709 ITU-R BT.709 (HD)

bt.2020-ncl
ITU-R BT.2020 sistem pencahayaan non-konstan

bt.2020-kl
ITU-R BT.2020 sistem pencahayaan konstan

smte-240m
SMPTE-240M


Tingkat warna YUV digunakan dengan konversi YUV ke RGB. Pilihan ini hanya
diperlukan saat memutar file rusak yang tidak mengikuti warna standar
tingkat atau yang ditandai salah. Jika video tidak menentukan warnanya
jangkauan, diasumsikan sebagai jangkauan terbatas.

Batasan yang sama dengan menerapkan.

Rentang warna yang tersedia adalah:

mobil pemilihan otomatis (rentang biasanya terbatas) (default)

terbatas
rentang terbatas (16-235 untuk luma, 16-240 untuk chroma)

penuh jangkauan penuh (0-255 untuk luma dan chroma)


RGB primer file sumber dikodekan dengan. Biasanya ini harus
atur di header file, tetapi saat memutar file yang rusak atau salah tag, ini
dapat digunakan untuk mengesampingkan pengaturan.

Opsi ini hanya memengaruhi driver output video yang menampilkan warna
manajemen, misalnya terbuka pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. target-prim or icc-profil
subopsi ditetapkan.

Jika opsi ini disetel ke mobil (yang merupakan default), video
bendera primer akan digunakan. Jika bendera itu tidak disetel, ruang warna akan
dipilih secara otomatis, menggunakan heuristik berikut: Jika
ditetapkan atau ditentukan sebagai BT.2020 atau BT.709,
primer yang sesuai digunakan. Jika tidak, jika tinggi video adalah
tepatnya 576 (PAL), BT.601-625 digunakan. Jika persis 480 atau 486 (NTSC),
BT.601-525 digunakan. Jika resolusi video adalah hal lain, BT.709 adalah
bekas.

Primer yang tersedia adalah:

mobil pemilihan otomatis (default)

bt.601-525
ITU-R BT.601 (SD) sistem 525-baris (NTSC, SMPTE-C)

bt.601-625
ITU-R BT.601 (SD) sistem 625-baris (PAL, SECAM)

bt.709 ITU-R BT.709 (HD) (primer yang sama dengan sRGB)

bt.2020
ITU-R BT.2020 (UHD)

apel RGB apel

adobe AdobeRGB (1998)

foto profil
ProFoto RGB (ROMM)

ci1931
CIE 1931 RGB


Fungsi gamma file sumber dikodekan dengan. Biasanya ini harus
diatur di header file, tetapi saat memutar file yang rusak atau salah tag
ini dapat digunakan untuk mengesampingkan pengaturan.

Opsi ini hanya memengaruhi driver output video yang menampilkan warna
manajemen.

Jika opsi ini disetel ke mobil (yang merupakan default), gamma akan
diatur ke BT.1886 untuk konten YCbCr, sRGB untuk konten RGB dan Linear
untuk konten XYZ.

Fungsi gamma yang tersedia adalah:

mobil pemilihan otomatis (default)

bt.1886
ITU-R BT.1886 (perkiraan kurva BT.601/BT.709/BT.2020)

srgb IEC 61966-2-4 (sRGB)

linear Cahaya linier

gamma1.8
Kurva daya murni (gamma 1.8)

gamma2.2
Kurva daya murni (gamma 2.2)

gamma2.8
Kurva daya murni (gamma 2.8)

foto profil
Kurva ProPhoto RGB (ROMM)


Atur mode stereo di mana video dianggap dikodekan. Lakukan hal yang sama
nilai-nilai sebagai --mode-video-stereo .


Atur mode stereo video yang akan ditampilkan. Mengambil nilai yang sama
sebagai --mode-video-stereo .


Atur rotasi video yang diasumsikan dikodekan dalam derajat. Itu
nilai khusus -1 menggunakan format masukan.

,
Mengatur ukuran tampilan. Perhatikan bahwa mengatur ukuran tampilan sedemikian rupa sehingga video
diskalakan di kedua arah alih-alih hanya mengubah rasio aspek adalah sebuah
detail implementasi, dan mungkin berubah nanti.

Atur rasio aspek tampilan bingkai video. Ini adalah pelampung, tetapi nilai
seperti [16: 9] bisa lewat juga ([...] untuk mengutip untuk mencegah opsi
parser dari menafsirkan : karakter).

format[=fmt]
Membatasi ruang warna untuk filter berikutnya tanpa melakukan konversi apa pun. Tidak seperti
filter format, ini akan memungkinkan ruang warna apa pun kecuali yang Anda tentukan.

CATATAN:
Untuk daftar format yang tersedia, lihat noformat=fmt=bantuan.

Nama format, misalnya rgb15, bgr24, 420p, dll. (default: 420p).

lavfi=grafik[:sws-flags[:o=opts]]
Filter video menggunakan libavfilter FFmpeg.


String grafik libavfilter. Filter harus memiliki satu pad input video
dan satu pad keluaran video.

Lihat https://ffmpeg.org/ffmpeg-filters.html untuk sintaks dan filter yang tersedia.

PERINGATAN:
Jika Anda ingin menggunakan sintaks filter lengkap dengan opsi ini, Anda harus
kutip grafik filter untuk mencegah sintaks dan filter mpv
sintaks grafik dari bentrokan.

contoh

-vf lavfi=[gradfun=20:30, vflip]
kelulusan filter dengan parameter yang tidak masuk akal, diikuti oleh a vflip
Saring. (Ini menunjukkan bagaimana libavfilter mengambil grafik dan bukan
hanya satu filter.) String grafik filter dikutip dengan [
dan ]. Ini tidak memerlukan kutipan tambahan atau melarikan diri dengan beberapa
shell (seperti bash), sementara yang lain (seperti zsh) memerlukan tambahan "
kutipan di sekitar string opsi.

'--vf=lavfi="gradfun=20:30,vflip"'
Sama seperti sebelumnya, tetapi menggunakan kutipan yang seharusnya aman untuk semua
kerang. bagian luar ' kutipan pastikan cangkangnya tidak
menghapus " kutipan yang dibutuhkan oleh mpv.

'--vf=lavfi=graph="gradfun=radius=30:kekuatan=20,vflip"'
Sama seperti sebelumnya, tetapi menggunakan parameter bernama untuk semuanya.


Jika libavfilter menyisipkan filter untuk konversi format piksel, opsi ini
memberikan flag yang harus diteruskan ke libswscale. Opsi ini numerik
dan mengambil kombinasi yang sedikit bijaksana dari SWS_ bendera.

Lihat http://git.videolan.org/?p=ffmpeg.git;a=gumpalan;f=libswscale/swscale.h.

Setel opsi AVFilterGraph. Ini harus didokumentasikan oleh FFmpeg.

Example

'--vf=lavfi=yadif:o="utas=2,jenis_utas=irisan"'
memaksa konfigurasi threading tertentu.

persamaan[=gamma:kontras:kecerahan:saturasi:rg:gg:bg:berat]
Equalizer perangkat lunak yang menggunakan tabel pencarian (lambat), memungkinkan koreksi gamma dalam
Selain kecerahan sederhana dan penyesuaian kontras. Parameter diberikan sebagai
nilai titik mengambang.

<0.1-10>
nilai gamma awal (default: 1.0)

<-2-2> kontras awal, di mana nilai negatif menghasilkan gambar negatif (default:
1.0)

<-1-1> kecerahan awal (default: 0.0)

<0-3> saturasi awal (default: 1.0)

<0.1-10>
nilai gamma untuk komponen merah (default: 1.0)

<0.1-10>
nilai gamma untuk komponen hijau (default: 1.0)

<0.1-10>
nilai gamma untuk komponen biru (default: 1.0)

<0-1> Parameter bobot dapat digunakan untuk mengurangi efek nilai gamma yang tinggi
pada area gambar yang cerah, mis. menjaganya agar tidak terlalu diperkuat dan adil
putih polos. Nilai 0.0 mengubah koreksi gamma sepenuhnya
sementara 1.0 membiarkannya dengan kekuatan penuhnya (default: 1.0).

tarik[=jl:jr:jt:jb:sb:mp]
Filter pulldown reversal (telecine terbalik), mampu menangani campuran
hard-telecine, 24000/1001 fps progresif, dan konten progresif 30000/1001 fps.
menarik filter memanfaatkan konteks masa depan dalam membuat keputusannya. Dia
stateless dalam arti bahwa itu tidak mengunci pola untuk diikuti, tapi itu
alih-alih menantikan bidang berikut untuk mengidentifikasi kecocokan dan
membangun kembali frame progresif.

jl, jr, jt, dan jb
Opsi ini mengatur jumlah "sampah" untuk diabaikan di kiri, kanan, atas,
dan bawah gambar, masing-masing. Kiri/kanan dalam satuan 8 piksel,
sedangkan atas/bawah dalam satuan 2 baris. Defaultnya adalah 8 piksel pada masing-masing
side.

sb (ketat istirahat)
Menyetel opsi ini ke 1 akan mengurangi kemungkinan menarik menghasilkan
bingkai yang kadang-kadang tidak cocok, tetapi juga dapat menyebabkan terlalu banyak
frame yang akan dijatuhkan selama urutan gerakan tinggi. Sebaliknya, mengaturnya
ke -1 akan membuat menarik mencocokkan bidang dengan lebih mudah. Ini dapat membantu pemrosesan
video di mana ada sedikit buram di antara bidang, tetapi juga dapat menyebabkan
ada frame interlaced dalam output.

mp (metrik pesawat)
Opsi ini dapat disetel ke u or v untuk menggunakan bidang kroma alih-alih luma
pesawat untuk melakukan menarikperhitungan. Ini dapat meningkatkan akurasi pada sangat
bahan sumber bersih, tetapi kemungkinan besar akan menurunkan akurasi, terutama jika
ada chroma noise (efek pelangi) atau video skala abu-abu. utama
tujuan pengaturan mp ke bidang chroma adalah untuk mengurangi beban CPU dan membuat
pullup dapat digunakan secara realtime pada mesin yang lambat.

yadif=[mode:hanya interlaced]
Namun filter deinterlacing lainnya



bingkai Keluarkan 1 bingkai untuk setiap bingkai.

bidang Keluarkan 1 bingkai untuk setiap bidang.

bingkai-nospasial
Seperti bingkai tetapi melewatkan pemeriksaan jalinan spasial.

bidang-nospasial
Seperti bidang tetapi melewatkan pemeriksaan jalinan spasial.



tidak Deinterlace semua frame (default).

iya nih Hanya bingkai deinterlace yang ditandai sebagai interlaced (default jika filter ini
dimasukkan melalui deinterlace Properti).

Filter ini, secara otomatis dimasukkan saat menggunakan d kunci (atau kunci lain yang
matikan deinterlace properti atau saat menggunakan --deinterlace beralih), dengan asumsi
output video tidak memiliki dukungan deinterlacing asli.

Jika Anda hanya ingin mengatur mode default, masukkan filter ini dan opsinya ke dalam
--vf-default sebagai gantinya, dan aktifkan deinterlacing dengan d or --deinterlace.

Perhatikan juga bahwa d kuncinya cukup bodoh untuk memasukkan deinterlacer dua kali ketika
memasukkan yadif dengan --vf, jadi disarankan menggunakan metode di atas.

sub=[=margin bawah:margin atas]
Memindahkan rendering subtitle ke titik sembarang dalam rantai filter, atau memaksa
rendering subtitle dalam filter video sebagai lawan menggunakan OSD output video
Dukungan.


Menambahkan pita hitam di bagian bawah bingkai. Penyaji SSA/ASS dapat menempatkan
subtitle di sana (dengan --sub-penggunaan-margin).


Pita hitam di bagian atas untuk toptitles (dengan --sub-penggunaan-margin).

contoh

--vf=sub,persamaan
Memindahkan sub rendering sebelum filter persamaan. Ini akan menempatkan kedua subtitle
warna dan video di bawah pengaruh pengaturan equalizer video.

stereo3d[=masuk:keluar]
Stereo3d mengkonversi antara format gambar stereoskopik yang berbeda.

Format input gambar stereoskopik. Nilai yang mungkin:

sbsl or side_by_side_left_first
berdampingan sejajar (mata kiri kiri, mata kanan kanan)

sbsr or side_by_side_right_first
mata juling berdampingan (mata kanan kiri, mata kiri kanan)

abl or atas_bawah_kiri_pertama
atas-bawah (mata kiri di atas, mata kanan di bawah)

April or atas_bawah_kanan_pertama
atas-bawah (mata kanan di atas, mata kiri di bawah)

ab2l or atas_bawah_setengah_tinggi_kiri_pertama
atas-bawah dengan resolusi setengah tinggi (mata kiri di atas, mata kanan
bawah)

ab2r or atas_bawah_setengah_tinggi_kanan_pertama
atas-bawah dengan resolusi setengah tinggi (mata kanan atas, mata kiri
bawah)

Format gambar stereoskopik keluaran. Nilai yang mungkin adalah semua input
format serta:

busur or anaglyph_red_cyan_gray
anaglyph red/cyan grey (filter merah di mata kiri, filter cyan di kanan
mata)

lengkungan or anaglyph_red_cyan_half_color
anaglyph red/cyan setengah warna (filter merah di mata kiri, filter cyan
pada mata kanan)

busur or anaglyph_red_cyan_color
anaglyph red/cyan color (filter merah di mata kiri, filter cyan di kanan
mata)

arcd or anaglyph_red_cyan_dubois
warna anaglyph merah/sian dioptimalkan dengan proyeksi kuadrat terkecil
dari Dubois (filter merah di mata kiri, filter cyan di mata kanan)

agg or anaglyph_green_magenta_gray
anaglyph hijau/abu-abu magenta (filter hijau di mata kiri, filter magenta
pada mata kanan)

agm or anaglyph_green_magenta_half_color
anaglyph hijau/magenta setengah warna (filter hijau di mata kiri,
filter magenta di mata kanan)

agmc or anaglyph_green_magenta_color
anaglyph hijau/berwarna magenta (filter hijau di mata kiri, magenta
filter pada mata kanan)

aybg or anaglyph_kuning_biru_abu-abu
anaglyph kuning/biru abu-abu (filter kuning pada mata kiri, filter biru pada
mata kanan)

ayb or anaglyph_kuning_biru_setengah_warna
anaglyph kuning/biru setengah warna (filter kuning di mata kiri, biru
filter pada mata kanan)

aybc or anaglyph_kuning_biru_warna
anaglyph berwarna kuning/biru (filter kuning di mata kiri, filter biru
pada mata kanan)

irl or interleave_rows_left_first
Baris interleaved (mata kiri memiliki baris atas, mata kanan dimulai pada baris berikutnya)

ir or interleave_rows_right_first
Baris yang disisipkan (mata kanan memiliki baris atas, mata kiri dimulai pada baris berikutnya)

ml or mono_kiri
keluaran mono (hanya mata kiri)

mr or mono_kanan
keluaran mono (hanya mata kanan)

gradfun[=kekuatan[:jari-jari|:ukuran= ]]
Perbaiki artefak pita yang terkadang dimasukkan ke daerah yang hampir rata dengan
pemotongan ke kedalaman warna 8-bit. Interpolasi gradien yang harus pergi ke mana
band, dan gentar mereka.


Jumlah maksimum yang digunakan filter untuk mengubah satu piksel apa pun. Juga
ambang batas untuk mendeteksi daerah yang hampir datar (default: 1.5).


Lingkungan agar sesuai dengan gradien. Radius yang lebih besar membuat lebih halus
gradien, tetapi juga mencegah filter memodifikasi piksel mendekati detail
wilayah (default: dinonaktifkan).

ukuran filter dalam persen dari ukuran diagonal gambar. Ini digunakan untuk
menghitung ukuran radius akhir (default: 1).

dlopen=dll[:a0[:a1[:a2[:a3]]]]
Memuat perpustakaan eksternal untuk memfilter gambar. Antarmuka perpustakaan adalah
vf_dlopen antarmuka yang ditentukan menggunakan libmpcodecs/vf_dlopen.h.

PERINGATAN:
Filter ini tidak digunakan lagi.

dll=
Tentukan perpustakaan yang akan dimuat. Ini mungkin memerlukan jalur sistem file lengkap di
beberapa kasus. Argumen ini diperlukan.

a0=
Tentukan parameter pertama yang akan diteruskan ke perpustakaan.

a1=
Tentukan parameter kedua untuk diteruskan ke perpustakaan.

a2=
Tentukan parameter ketiga untuk diteruskan ke perpustakaan.

a3=
Tentukan parameter keempat untuk diteruskan ke perpustakaan.

vapoursynth=file:buffered-frames:concurrent-frames
Memuat skrip filter VapourSynth. Ini ditujukan untuk pemrosesan streaming: mpv
sebenarnya menyediakan filter sumber, alih-alih menggunakan video asli VapourSynth
sumber. Sumber mpv akan menjawab permintaan bingkai hanya dalam jendela kecil
frame (ukuran jendela ini dikontrol dengan buffered-frame parameter),
dan permintaan di luar itu akan mengembalikan kesalahan. Karena itu, Anda tidak dapat menggunakan sepenuhnya
kekuatan VapourSynth, tetapi Anda dapat menggunakan filter tertentu.

Jika Anda hanya ingin memutar video yang dihasilkan oleh VapourSynth (yaitu menggunakan video asli
sumber video VapourSynth), lebih baik digunakan vspipe dan FIFO untuk memberi makan video
ke mpv. Hal yang sama berlaku jika skrip filter memerlukan akses bingkai acak (lihat
buffered-frame parameter).

Filter ini bersifat eksperimental. Jika ternyata berfungsi dengan baik dan digunakan, itu
akan di-porting ke libavfilter. Jika tidak, itu hanya akan dihapus.

fillet Nama file dari sumber skrip. Saat ini, ini selalu merupakan skrip python.
Variabel video_in diatur ke sumber video mpv, dan diharapkan
bahwa skrip membaca video darinya. (Jika tidak, mpv tidak akan memecahkan kode video,
dan antrian paket video akan meluap, pada akhirnya mengarah ke audio yang
dihentikan.) Skrip juga diharapkan melewati stempel waktu menggunakan
_DurasiNum dan _DurasiDen properti bingkai.

Contoh:

impor vaoursynth sebagai vs
inti = vs.get_core()
inti.std.AddBorders(video_in, 10, 10, 20, 20).set_output()

PERINGATAN:
Script akan dimuat ulang pada setiap pencarian. Ini dilakukan untuk mengatur ulang
filter dengan benar pada diskontinuitas.

buffered-frame
Jumlah maksimum bingkai video yang didekodekan yang harus disangga sebelum
filter (default: 4). Ini menentukan jumlah maksimum bingkai skrip
dapat meminta mundur. Misalnya jika buffered-frame = 5, dan skripnya saja
meminta bingkai 15, masih dapat meminta bingkai 10, tetapi bingkai 9 tidak
tersedia lagi. Jika meminta frame 30, mpv akan memecahkan kode 15 frame lagi,
dan simpan hanya frame 25-30.

Jumlah sebenarnya dari frame buffer juga tergantung pada nilai dari
bingkai-bersamaan pilihan. Saat ini, kedua nilai opsi dikalikan menjadi
mendapatkan ukuran buffer akhir.

(Biasanya, filter sumber VapourSynth harus menyediakan akses acak, tetapi mpv
dibuat untuk pemutaran, dan tidak menyediakan akses acak yang persis bingkai. Itu
cara kerja filter video ini adalah kompromi untuk membuat filter sederhana berfungsi
omong-omong.)

bingkai-bersamaan
Jumlah frame yang harus diminta secara paralel. tingkat
konkurensi tergantung pada filter dan seberapa cepat mpv dapat memecahkan kode video ke
memberi makan filter. Nilai ini mungkin harus sebanding dengan jumlah
core pada mesin Anda. Sebagian besar waktu, membuatnya lebih tinggi dari jumlah core
sebenarnya bisa membuatnya lebih lambat.

Secara default, ini menggunakan nilai khusus mobil, yang menyetel opsi ke
jumlah inti CPU logis yang terdeteksi.

Variabel berikut didefinisikan oleh mpv:

video_in
Sumber video mpv sebagai klip vapoursynth. Perhatikan bahwa ini tidak memiliki panjang yang ditetapkan,
yang membingungkan banyak filter. Menggunakan Memangkas pada klip dengan panjang dummy yang tinggi
dapat mengubahnya menjadi klip yang terbatas.

video_in_dw, video_in_dh
Ukuran tampilan video. Dapat berbeda dari ukuran video jika video
tidak menggunakan piksel persegi (misalnya DVD).

kontainer_fps
Nilai FPS seperti yang dilaporkan oleh file header. Nilai ini bisa salah atau seluruhnya
rusak (misalnya 0 atau NaN). Bahkan jika nilainya benar, jika filter lain
mengubah FPS nyata (dengan menjatuhkan atau memasukkan bingkai), nilai ini
variabel mungkin tidak berguna. Perhatikan bahwa --fps opsi baris perintah
menimpa nilai ini.

Berguna untuk beberapa filter yang bersikeras memiliki FPS.

tampilan_fps
Kecepatan refresh tampilan saat ini. Perhatikan bahwa nilai ini bisa 0.

vaoursynth-malas
Sama seperti vaoursynth, tetapi tidak memuat skrip Python. Sebagai gantinya, backend khusus
menggunakan Lua dan API VapourSynth mentah digunakan. Sintaksnya sangat berbeda,
dan sama sekali tidak ada fitur kenyamanan yang disediakan. Tidak ada pemeriksaan tipe
baik, dan Anda dapat memicu kerusakan.

Contoh:

video_out = panggilan("morpho", "Buka", {klip = video_in})

Variabel khusus video_in adalah sumber video mpv, sedangkan variabel khusus
video_out digunakan untuk membaca video dari. Argumen pertama adalah plugin (ditanyakan dengan
dapatkanPluginByNs), yang ke-2 adalah nama filter, dan argumen ke-3 adalah tabel dengan
argumen. Argumen posisi tidak didukung. Jenisnya harus cocok
tepat. Karena Lua sangat buruk dan tidak dapat membedakan bilangan bulat dan float, bilangan bulat
argumen harus diawali dengan i_, dalam hal ini awalan dihilangkan dan
argumen dilemparkan ke bilangan bulat. Haruskah nama argumen dimulai dengan i_, kamu adalah
kurang beruntung.

Klip (VSNodeRef) dilewatkan sebagai data pengguna ringan, jadi cobalah untuk melewatkan yang lain
tipe userdata akan mengakibatkan crash keras.

vavpp Pemrosesan posting video VA-AP-API. Bekerja dengan --vo=vaapi dan --vo=terbuka saja.
Saat ini deinterlace. Filter ini secara otomatis dimasukkan jika deinterlacing adalah
diminta (baik menggunakan d kunci, secara default dipetakan ke perintah siklus
deinterlace, Atau --deinterlace pilihan).

deint=
Pilih algoritma deinterlacing.

tidak Jangan lakukan deinterlacing.

lapangan pertama
Tampilkan hanya bidang pertama (lewat --dominan-bidang).

bob bob deinterlacing (default).

menenun, adaptif gerak, gerak-kompensasi
Algoritma deinterlacing tingkat lanjut. Apakah ini benar-benar berfungsi?
tergantung pada perangkat keras GPU, driver GPU, bug driver, dan mpv
bug.



tidak Deinterlace semua frame.

iya nih Hanya bingkai deinterlace yang ditandai sebagai interlaced (default).

vdpaupp
Pemrosesan posting video VDPAU. Bekerja dengan --vo=vdpau dan --vo=terbuka hanya. Ini
filter dimasukkan secara otomatis jika deinterlacing diminta (baik menggunakan d
kunci, secara default dipetakan ke perintah siklus deinterlace, Atau --deinterlace
pilihan). Saat mengaktifkan deinterlacing, itu selalu lebih disukai daripada perangkat lunak
filter deinterlacer jika vdpau VO digunakan, dan juga jika terbuka digunakan dan
decoding perangkat keras diaktifkan setidaknya sekali (yaitu vdpau dimuat).

pertajam=<-1-1>
Untuk nilai positif, terapkan algoritme penajaman ke video, untuk negatif
nilai algoritma kabur (default: 0).

denoise=<0-1>
Terapkan algoritme pengurangan noise ke video (default: 0; tidak ada noise
pengurangan).

deint=
Apakah deinterlacing diaktifkan (default: tidak). Jika diaktifkan, itu akan menggunakan
mode dipilih dengan mode-deint.

mode-deint=
Pilih mode deinterlacing (default: temporal). Semua mode menghormati
--dominan-bidang.

Perhatikan bahwa saat ini ada mekanisme yang memungkinkan vdpau VO untuk berubah
itu mode-deint dari dimasukkan secara otomatis vdpaupp filter. Untuk menghindari kebingungan, ini
disarankan untuk tidak menggunakan --vo=vdpau subopsi yang terkait dengan penyaringan.

lapangan pertama
Tampilkan hanya bidang pertama.

bob Bob melepaskan ikatannya.

sementara
Deinterlacing temporal adaptif gerak. Dapat menyebabkan desinkronisasi A/V dengan
perangkat keras video lambat dan/atau resolusi tinggi.

temporal-spasial
Deinterlacing temporal adaptif gerak dengan spasial yang dipandu tepi
interpolasi. Membutuhkan perangkat keras video yang cepat.

kroma-deint
Membuat deinterlacers temporal beroperasi baik pada luma dan chroma (default). Menggunakan
no-chroma-deint untuk hanya menggunakan luma dan mempercepat deinterlacing tingkat lanjut.
Berguna dengan memori video yang lambat.

menarik Coba terapkan telecine terbalik, perlu deinterlacing temporal adaptif gerak.

interlaced-only=
If iya nih (default), hanya bingkai deinterlace yang ditandai sebagai interlaced.

hqscaling=<0-9>

0 Gunakan penskalaan VDPAU default (default).

1-9 Terapkan penskalaan VDPAU berkualitas tinggi (membutuhkan perangkat keras yang mumpuni).

vdpaurb
Video VDPAU dibaca kembali. Bekerja dengan --vo=vdpau dan --vo=terbuka hanya. Filter ini
akan membaca kembali frame yang didekode oleh VDPAU sehingga filter lain yang tidak
biasanya kompatibel dengan VDPAU, dapat digunakan seperti biasa. Filter ini harus
ditentukan sebelumnya vdpaupp dalam rantai filter jika vdpaupp digunakan.

penyangga =
Penyangga bingkai dalam rantai filter. Filter ini mungkin sangat tidak berguna,
kecuali untuk debugging. (Perhatikan bahwa ini tidak akan membantu menghaluskan latensi dengan
decoding, karena filter tidak akan pernah menampilkan bingkai jika buffer tidak penuh,
kecuali di EOF.)

pengkodean

Anda dapat mengkodekan file dari satu format/codec ke format lain menggunakan fasilitas ini.

--o=
Mengaktifkan mode penyandian dan menentukan nama file keluaran.

--dari=
Menentukan format output (mengganti deteksi otomatis dengan ekstensi nama file dari
file yang ditentukan oleh -o). Ini bisa berupa daftar format yang mungkin dipisahkan koma
untuk mencoba. Melihat --of=bantuan untuk daftar lengkap format yang didukung.

--ofopts=
Menentukan opsi format output untuk libavformat. Melihat --ofopts=bantuan untuk penuh
daftar opsi yang didukung.

Opsi dikelola dalam daftar. Ada beberapa perintah untuk mengelola daftar opsi.

--ofopts-add=
Menambahkan opsi yang diberikan sebagai argumen ke daftar opsi.

--ofopts-pre=
Menambahkan opsi yang diberikan sebagai argumen ke daftar opsi.

--ofopts-del=
Menghapus opsi pada indeks yang diberikan. Angka indeks mulai dari 0, negatif
nomor alamat akhir daftar (-1 adalah yang terakhir).

--ofopts-clr
Benar-benar mengosongkan daftar opsi.

--ofps= nilai>
Menentukan basis waktu format output (default: 24000). Nilai rendah seperti 25 batas
fps video dengan menjatuhkan bingkai.

--oautofps
Menyetel basis waktu format output ke kecepatan bingkai yang ditebak dari video input
(mensimulasikan perilaku MEncoder, berguna untuk AVI; dapat menyebabkan penurunan bingkai). Perhatikan bahwa
tidak semua codec dan tidak semua format mendukung pengkodean VFR, dan beberapa di antaranya memiliki
bug ketika bitrate target ditentukan - gunakan --ofps or --oautofps untuk memaksa CFR
pengkodean dalam kasus ini.

--omaxfps= nilai>
Menentukan jarak minimum frame yang berdekatan (default: 0, yang berarti tidak disetel).
Konten dengan kecepatan bingkai yang lebih rendah tidak disesuaikan kembali dengan kecepatan bingkai ini; konten lebih tinggi
frame rate dihancurkan menjadi frame rate ini.

--oharddup
Jika diatur, frame rate yang diberikan oleh --ofps dicapai bukan dengan melewatkan kode waktu, tetapi
dengan menduplikasi frame (mode frame rate konstan).

--oneeverdrop
Jika diatur, bingkai tidak pernah dijatuhkan. Sebagai gantinya, kode waktu video disesuaikan kembali ke
selalu meningkat. Ini dapat menyebabkan desinkronisasi AV; untuk menyiasatinya, gunakan a
basis waktu fps tinggi menggunakan --ofps dan benar-benar menghindari --oautofps.

--oac=
Menentukan codec audio keluaran. Ini bisa menjadi daftar kemungkinan yang dipisahkan koma
codec untuk mencoba. Melihat --oac=bantuan untuk daftar lengkap codec yang didukung.

--oaoffset=
Menggeser data audio menurut waktu yang ditentukan (dalam detik) dengan menambahkan/menghapus sampel di
memulai.

--oacopts=
Menentukan opsi codec audio keluaran untuk libavcodec. Melihat --oacopts=bantuan untuk
daftar lengkap opsi yang didukung.

Example

--oac=libmp3lame --oakopt=b=128000
memilih penyandian MP128 3 kbps.

Opsi dikelola dalam daftar. Ada beberapa perintah untuk mengelola daftar opsi.

--oacopts-add=
Menambahkan opsi yang diberikan sebagai argumen ke daftar opsi.

--oacopts-pre=
Menambahkan opsi yang diberikan sebagai argumen ke daftar opsi.

--oacopts-del=
Menghapus opsi pada indeks yang diberikan. Angka indeks mulai dari 0, negatif
nomor alamat akhir daftar (-1 adalah yang terakhir).

--oacopts-clr
Benar-benar mengosongkan daftar opsi.

--oapertama
Paksa aliran audio untuk menjadi aliran pertama di output. Secara default
pesanan tidak ditentukan.

--ovc=
Menentukan codec video keluaran. Ini bisa menjadi daftar kemungkinan yang dipisahkan koma
codec untuk mencoba. Melihat --ovc=bantuan untuk daftar lengkap codec yang didukung.

--ovoffset=
Menggeser data video dengan waktu tertentu (dalam detik) dengan menggeser nilai poin.

--ovkop
Menentukan opsi codec video output untuk libavcodec. Lihat --ovcopts=help untuk
daftar lengkap opsi yang didukung.

contoh

"--ovc=mpeg4 --ovcopts=qscale=5"
memilih skala quantizer konstan 5 untuk pengkodean MPEG-4.

"--ovc=libx264 --ovcopts=crf=23"
memilih faktor kualitas VBR 23 untuk pengkodean H.264.

Opsi dikelola dalam daftar. Ada beberapa perintah untuk mengelola daftar opsi.

--ovcopts-add=
Menambahkan opsi yang diberikan sebagai argumen ke daftar opsi.

--ovcopts-pre=
Menambahkan opsi yang diberikan sebagai argumen ke daftar opsi.

--ovcopts-del=
Menghapus opsi pada indeks yang diberikan. Angka indeks mulai dari 0, negatif
nomor alamat akhir daftar (-1 adalah yang terakhir).

--ovcopts-clr
Benar-benar mengosongkan daftar opsi.

--ovpertama
Paksa aliran video untuk menjadi aliran pertama dalam output. Secara default
pesanan tidak ditentukan.

--copyt
Menyalin poin masukan ke video keluaran (tidak didukung oleh beberapa wadah keluaran
format, misalnya AVI). Diskontinuitas masih tetap. Secara default, poin audio disetel
untuk waktu pemutaran dan poin video disinkronkan agar sesuai dengan poin audio, karena beberapa output
format tidak mendukung apa pun.

--orawt
Menyalin poin masukan ke video keluaran (tidak didukung oleh beberapa wadah keluaran
format, misalnya AVI). Dalam mode ini, diskontinuitas tidak tetap dan semua titik adalah
melewati apa adanya. Jangan pernah mencari mundur atau menggunakan beberapa file input dalam hal ini
mode!

--tidak ada-ometadata
Menonaktifkan penyalinan metadata dari file input ke file output saat penyandian (yang
diaktifkan secara default).

COMMAND INTERFACE

Inti mpv dapat dikontrol dengan perintah dan properti. Beberapa cara untuk berinteraksi
dengan pemain menggunakannya: ikatan kunci (masukan.conf), OSD (menampilkan informasi dengan
properties), JSON IPC, API klien (libmpv), dan mode budak klasik.

masukan.conf
File input.conf terdiri dari daftar ikatan kunci, misalnya:

s tangkapan layar # ambil tangkapan layar dengan tombol s
KIRI mencari 15 # memetakan tombol panah kiri untuk mencari maju 15 detik

Setiap baris memetakan kunci ke perintah input. Kunci ditentukan dengan nilai literalnya
(huruf besar jika digabungkan dengan perubahan), atau nama untuk kunci khusus. Sebagai contoh, a peta ke
itu a kunci tanpa shift, dan A peta ke a dengan pergeseran.

File terletak di direktori konfigurasi mpv (biasanya di
~/.config/mpv/input.conf tergantung platformnya). Binding default didefinisikan di sini:

https://github.com/mpv-player/mpv/blob/master/etc/input.conf

Daftar kunci khusus dapat diperoleh dengan
mpv --masukan-keylist

Secara umum, kunci dapat dikombinasikan dengan perubahan, Ctrl dan lain:

ctrl+q berhenti

mpv dapat dimulai dalam mode uji input, yang menampilkan ikatan kunci dan perintah
mereka terikat pada OSD, alih-alih menjalankan perintah:

mpv --input-test --force-window --idle

(Hanya menutup jendela akan membuat mpv keluar, menekan tombol normal hanya akan menampilkan
mengikat, bahkan jika dipetakan untuk berhenti.)

Umum Memasukkan perintah Sintaksis
[Shift+][Ctrl+][Alt+][Meta+] [{ }] [ ] ( )* [;
]

Perhatikan bahwa secara default, tombol Alt kanan dapat digunakan untuk membuat karakter khusus, dan dengan demikian
tidak terdaftar sebagai pengubah. Pilihan --no-input-kanan-alt-gr mengubah perilaku ini.

Baris baru selalu memulai penjilidan baru. # memulai komentar (di luar string yang dikutip
argumen). Untuk mengikat perintah ke # kunci, TAJAM dapat digunakan.

adalah karakter literal yang dihasilkan kunci (karakter ASCII atau Unicode), atau a
nama simbolis (seperti yang dicetak oleh --masukan-keylist).

(diperkuat dengan { dan }) adalah bagian input untuk perintah ini.

Argumen dipisahkan oleh spasi. Ini berlaku bahkan untuk argumen string. Untuk ini
alasan, argumen string harus dikutip dengan ". Di dalam kutipan, pelarian gaya-C bisa menjadi
bekas.

Anda dapat mengikat beberapa perintah ke satu kunci. Sebagai contoh:
a show-text "perintah 1" ; tampilkan teks "perintah 2"

Anda juga dapat mengikat perintah ke urutan kunci:
abc show-text "perintah dijalankan setelah a, b, c telah ditekan"

(Ini tidak ditampilkan dalam sintaks perintah umum.)

If a or ab or b sudah terikat, ini akan menjalankan perintah pertama yang cocok, dan
perintah multi-kunci tidak akan pernah dipanggil. Kunci perantara dapat dipetakan ulang ke mengabaikan in
untuk menghindari masalah ini. Jumlah maksimum tombol (non-pengubah) untuk kombinasi adalah
saat ini 4.

Daftar of Memasukkan Perintah
mengabaikan Gunakan ini untuk "memblokir" kunci yang seharusnya tidak terikat, dan tidak melakukan apa pun. Berguna untuk
menonaktifkan binding default, tanpa menonaktifkan semua binding dengan
--tidak ada-input-pengikatan-default.

mencari [relatif|mutlak|persen absolut|persen relatif|tepat|kerangka kunci]
Ubah posisi pemutaran. Secara default, mencari dengan jumlah detik relatif.

Argumen kedua terdiri dari flag yang mengontrol mode pencarian:

relatif (Default)
Carilah relatif terhadap posisi saat ini (nilai negatif mencari mundur).

mutlak
Carilah waktu tertentu.

persen mutlak
Carilah posisi persen tertentu.

relatif-persen
Carilah relatif terhadap posisi saat ini dalam persen.

keyframes
Selalu mulai ulang pemutaran pada batas bingkai utama (cepat).

tepat Selalu lakukan pencarian tepat/jam/tepat (lambat).

Beberapa bendera dapat digabungkan, misalnya: absolut+keyframe.

Secara default, keyframes digunakan untuk pencarian relatif, dan tepat digunakan untuk mutlak
mencari.

Sebelum mpv 0.9, keyframes dan tepat bendera harus diteruskan sebagai parameter ke-3
(pada dasarnya menggunakan spasi alih-alih +). Parameter ke-3 masih diuraikan, tetapi adalah
dianggap usang.

pencarian kembali [mode]
Membatalkan mencari perintah, dan beberapa perintah lain yang mencari (tetapi tidak harus semua
dari mereka). Memanggil perintah ini sekali akan melompat ke posisi pemutaran sebelum
mencari. Menyebutnya untuk kedua kalinya membatalkan pencarian kembali perintah itu sendiri. Ini hanya
bekerja dalam satu file.

Argumen pertama adalah opsional, dan dapat mengubah perilaku:

tanda Tandai posisi waktu saat ini. Biasa berikutnya pencarian kembali perintah akan
mencari kembali ke titik ini, tidak peduli berapa banyak pencarian terjadi sejak terakhir kali.

Menggunakannya tanpa argumen apa pun memberi Anda perilaku default.

bingkai-langkah
Mainkan satu frame, lalu jeda. Tidak melakukan apa pun dengan pemutaran audio saja.

bingkai-belakang-langkah
Kembali satu frame, lalu jeda. Perhatikan bahwa ini bisa sangat lambat (mencoba menjadi
tepat, tidak cepat), dan terkadang gagal berperilaku seperti yang diharapkan. Seberapa baik ini bekerja?
tergantung pada apakah pencarian yang tepat bekerja dengan benar (mis
--jam-mencari-demuxer-offset pilihan). Filter video atau pasca-pemrosesan video lainnya yang
memodifikasi waktu frame (misalnya deinterlacing) biasanya harus bekerja, tetapi mungkin membuat
mundur diam-diam berperilaku tidak benar dalam kasus sudut. Menggunakan
--hr-seek-framedrop=tidak akan membantu, meskipun mungkin membuat pencarian yang tepat lebih lambat.

Ini tidak bekerja dengan pemutaran audio saja.

set
Tetapkan properti yang diberikan ke nilai yang diberikan.

menambahkan [ ]
Tambahkan nilai yang diberikan ke properti. Pada overflow atau underflow, klem properti
secara maksimal. Jika dihilangkan, asumsikan 1.

siklus [atas|bawah]
Siklus properti yang diberikan. up dan turun mengatur arah siklus. Saat melimpah, atur
properti kembali ke minimum, pada underflow set ke maksimum. Jika up or turun is
dihilangkan, asumsikan up.

mengalikan
Mengalikan nilai properti dengan faktor numerik.

screenshot [subtitel|video|jendela|- [tunggal|setiap bingkai]]
Ambil tangkapan layar.

Argumen pertama:

(Default)
Simpan gambar video, dalam resolusi aslinya, dan dengan subtitle. Beberapa
output video mungkin masih menyertakan OSD dalam output di bawah tertentu
keadaan.


Seperti sub judul, tetapi biasanya tanpa OSD atau subtitle. Perilaku yang tepat
tergantung pada output video yang dipilih.


Simpan konten jendela mpv. Biasanya diskalakan, dengan OSD dan
sub judul. Perilaku yang tepat tergantung pada output video yang dipilih, dan jika
tidak ada dukungan yang tersedia, ini akan bertindak seperti video.


Ambil tangkapan layar setiap bingkai. Keluarkan perintah ini lagi untuk berhenti mengambil
screenshot. Perhatikan bahwa Anda harus menonaktifkan penurunan bingkai saat menggunakan ini
mode - atau Anda mungkin menerima gambar duplikat jika ada bingkai
menjatuhkan. Bendera ini dapat digabungkan dengan bendera lainnya, mis
video+setiap bingkai.

tangkapan layar-ke-file [subtitel|video|jendela]
Ambil tangkapan layar dan simpan ke file tertentu. Format filenya adalah
ditebak oleh ekstensi (dan --format-tangkapan layar diabaikan - perilaku ketika
ekstensi tidak ada atau tidak dikenal bersifat arbitrer).

Argumen kedua seperti argumen pertama untuk screenshot.

Jika file sudah ada, itu akan ditimpa.

Seperti semua parameter perintah input, nama file tunduk pada perluasan properti sebagai
dijelaskan dalam Milik Perluasan.

daftar putar-berikutnya [lemah|kekuatan]
Buka entri berikutnya di daftar putar.

lemah (Default)
Jika file terakhir di daftar putar sedang diputar, jangan lakukan apa pun.

kekuatan Hentikan pemutaran jika tidak ada lagi file di daftar putar.

daftar putar-sebelumnya [lemah|kekuatan]
Buka entri sebelumnya di daftar putar.

lemah (Default)
Jika file pertama di daftar putar sedang diputar, jangan lakukan apa pun.

kekuatan Hentikan pemutaran jika file pertama sedang diputar.

memuat file [ganti|tambahkan|tambahkan-putar [pilihan]]
Muat file yang diberikan dan mainkan.

Argumen kedua:

(Default)
Hentikan pemutaran file saat ini, dan segera putar file baru.


Tambahkan file ke daftar putar.


Tambahkan file, dan jika tidak ada yang sedang diputar, mulailah pemutaran.
(Selalu dimulai dengan file yang ditambahkan, meskipun daftar putar tidak kosong
sebelum menjalankan perintah ini.)

Argumen ketiga adalah daftar opsi dan nilai yang harus disetel saat
file sedang diputar. Ini adalah bentuk opt1=nilai1,opt2=nilai2,... Tidak semua pilihan bisa
diubah dengan cara ini. Beberapa opsi memerlukan restart pemain.

daftar beban [ganti|tambahkan]
Muat file daftar putar yang diberikan (seperti --daftar putar).

daftar putar-jelas
Hapus daftar putar, kecuali file yang sedang diputar.

daftar putar-hapus saat ini|
Hapus entri daftar putar pada indeks yang diberikan. Nilai indeks mulai menghitung dengan 0.
Nilai khusus arus menghapus entri saat ini. Perhatikan bahwa menghapus arus
entri juga menghentikan pemutaran dan mulai memutar entri berikutnya.

daftar putar-pindah
Pindahkan entri daftar putar di indeks1, sehingga menggantikan entri indeks2.
(Secara paradoks, entri daftar putar yang dipindahkan tidak akan memiliki nilai indeks index2 setelah
bergerak jika indeks1 lebih rendah dari indeks2, karena indeks2 mengacu pada entri target,
bukan indeks yang akan dimiliki entri setelah pindah.)

daftar putar-acak
Acak daftar putar. Ini mirip dengan apa yang dilakukan di awal jika --mengacak
opsi digunakan.

menjalankan Command argumen1 argumen2 ...
Jalankan perintah yang diberikan. Tidak seperti di MPlayer/mplayer2 dan versi mpv sebelumnya
(0.2.x dan yang lebih lama), ini tidak memanggil shell. Sebaliknya, perintah dijalankan
langsung, dengan setiap argumen diteruskan secara terpisah. Setiap argumen diperluas seperti di
Milik Perluasan. Perhatikan bahwa ada batas statis (pada tulisan ini) 9
argumen (batas ini dapat dinaikkan sesuai permintaan).

Program dijalankan secara terpisah. mpv tidak menunggu sampai perintahnya adalah
selesai, tetapi melanjutkan pemutaran tepat setelah memunculkannya.

Untuk mendapatkan perilaku lama, gunakan / Bin / sh dan -c sebagai dua argumen pertama.

Example

menjalankan "/ Bin / sh" "-C" "gema ${judul} > /tmp/bermain"

Ini bukan contoh yang sangat baik, karena tidak menangani
melarikan diri, dan file yang disiapkan secara khusus mungkin memungkinkan penyerang untuk
menjalankan perintah shell sewenang-wenang. Disarankan untuk menulis kecil
skrip shell, dan sebut itu dengan menjalankan.

berhenti [ ]
Keluar dari pemain. Jika argumen diberikan, itu digunakan sebagai kode keluar proses.

berhenti-tonton-nanti [ ]
Keluar dari pemutar, dan simpan posisi pemutaran saat ini. Memutar file itu nanti akan mencari
ke posisi sebelumnya saat start. Argumen (opsional) persis seperti di
berhenti perintah.

sub-tambahkan [ [ [ ]]]
Muat file subtitle yang diberikan. Ini dipilih sebagai subtitle saat ini setelah memuat.

bendera args adalah salah satu dari nilai berikut:


Pilih subtitle segera.


Jangan pilih subtitle. (Atau dalam beberapa situasi khusus, biarkan default
mekanisme pemilihan aliran memutuskan.)


Pilih subjudul. Jika subtitle dengan nama file yang sama telah ditambahkan,
yang dipilih, alih-alih memuat entri duplikat. (Pada kasus ini,
judul/bahasa diabaikan, dan jika diubah sejak dimuat, ini
perubahan tidak akan tercermin.)

judul argumen menyetel judul trek di UI.

lang argumen mengatur bahasa trek, dan juga dapat memengaruhi pemilihan aliran
dengan bendera mulai mobil.

sub-hapus [ ]
Hapus trek subtitle yang diberikan. jika id argumen tidak ada, hapus arus
melacak. (Berfungsi pada file subtitle eksternal saja.)

isi ulang [ ]
Muat ulang trek subtitle yang diberikan. jika id argumen tidak ada, muat ulang arus
melacak. (Berfungsi pada file subtitle eksternal saja.)

Ini bekerja dengan membongkar dan menambahkan kembali trek subtitle.

sub-langkah
Ubah waktu subtitle sedemikian rupa, sehingga acara subtitle setelah berikutnya subtitle
acara ditampilkan. bisa negatif untuk melangkah mundur.

sub-pencarian
Cari ke subtitle berikutnya (lewati set ke 1) atau sebelumnya (lewati set ke -1). Ini
mirip dengan sub-langkah, kecuali bahwa ia mencari video dan audio alih-alih menyesuaikan
penundaan subtitle.

Untuk subtitle yang disematkan (seperti dengan Matroska), ini hanya berfungsi dengan acara subtitle
yang telah ditampilkan, atau berada dalam rentang prefetch yang pendek.

osd [ ]
Alihkan tingkat OSD. Jika ditentukan, atur mode OSD (lihat --tingkat-osd untuk
nilai yang valid).

teks-cetak
Cetak teks ke stdout. String dapat berisi properti (lihat Milik Perluasan).

teks pertunjukan [ |- [ ]]
Tampilkan teks pada OSD. String dapat berisi properti, yang diperluas sebagai
dijelaskan dalam Milik Perluasan. Ini dapat digunakan untuk menunjukkan waktu pemutaran, nama file,
dan seterusnya.


Waktu dalam ms untuk menampilkan pesan. Secara default, ia menggunakan nilai yang sama
as --osd-durasi.


Level OSD minimum untuk menampilkan teks di (lihat --tingkat-osd).

pertunjukan-kemajuan
Tampilkan bilah kemajuan, waktu yang telah berlalu, dan total durasi file di
OSD.

tulis-tonton-nanti-config
Tulis file konfigurasi resume yang berhenti-tonton-nanti perintah menulis, tetapi lanjutkan
pemutaran secara normal.

berhenti Hentikan pemutaran dan hapus daftar putar. Dengan pengaturan default, ini pada dasarnya seperti
berhenti. Berguna untuk API klien: pemutaran dapat dihentikan tanpa menghentikan
pemain.

mouse [ [tunggal|ganda]]
Kirim acara mouse dengan koordinat yang diberikan (, ).

Argumen kedua:


Jumlah tombol dari tombol mouse yang diklik. Ini harus menjadi salah satu dari 0-19. Jika
dihilangkan, hanya posisinya yang akan diperbarui.

Argumen ketiga:

(Default)
Acara mouse mewakili satu klik biasa.


Acara mouse mewakili klik dua kali.

penekanan tombol
Kirim acara utama melalui pengendali input mpv, memicu perilaku apa pun
dikonfigurasi untuk kunci itu. nama_kunci menggunakan masukan.conf skema penamaan untuk kunci dan
pengubah. Berguna untuk API klien: peristiwa utama dapat dikirim ke libmpv untuk ditangani
secara internal.

kunci bawah
Mirip dengan penekanan tombol, tetapi menetapkan KUNCI KE BAWAH bendera sehingga jika kunci terikat ke a
perintah berulang, itu akan dijalankan berulang kali dengan waktu pengulangan kunci mpv sampai
itu keyup perintah disebut.

keyup [ ]
Mengatur KUNCI flag, menghentikan perilaku berulang yang telah dipicu.
nama_kunci adalah opsional. Jika nama_kunci tidak diberikan atau merupakan string kosong, KUNCI akan
diatur pada semua kunci. Jika tidak, KUNCI hanya akan diatur pada kunci yang ditentukan oleh
nama_kunci.

audio-tambahkan [ [ [ ]]]
Muat file audio yang diberikan. Melihat sub-tambahkan perintah.

hapus audio [ ]
Hapus trek audio yang diberikan. Melihat sub-hapus perintah.

isi ulang audio [ ]
Muat ulang trek audio yang diberikan. Melihat isi ulang perintah.

pindai ulang-eksternal-file [ ]
Pindai ulang file eksternal sesuai dengan saat ini --sub-otomatis dan --audio-file-otomatis
pengaturan. Ini dapat digunakan untuk memuat file eksternal secara otomatis setelah file telah dimuat.

mode argumen adalah salah satu dari berikut ini:

(Default)
Pilih streaming audio dan subtitle default, yang biasanya memilih
file eksternal dengan preferensi tertinggi. (Pelaksanaannya tidak sempurna,
dan dapat ditingkatkan berdasarkan permintaan.)


Jangan ubah pilihan trek saat ini.

Memasukkan Perintah bahwa adalah Mungkin Subjek untuk Perubahan
af set|tambah|beralih|del|clr filter1=param,filter2,...
Ubah rantai filter audio. Melihat vf perintah.

vf set|tambah|beralih|del|clr filter1=param,filter2,...
Ubah rantai filter video.

Argumen pertama memutuskan apa yang terjadi:

set Timpa rantai filter sebelumnya dengan yang baru.

menambahkan Tambahkan rantai filter baru ke yang sebelumnya.

toggle Periksa apakah filter yang diberikan (dengan parameter yang tepat) sudah ada di
rantai video. Jika ya, lepaskan filter. Jika tidak, tambahkan filter. (Jika beberapa
filter diteruskan ke perintah, ini dilakukan untuk setiap filter.)

itu Hapus filter yang diberikan dari rantai video. Berbeda dengan kasus lainnya,
parameter kedua adalah daftar nama filter atau bilangan bulat yang dipisahkan koma
indeks. 0 akan menunjukkan filter pertama. Indeks negatif dimulai dari
filter terakhir, dan -1 menunjukkan filter terakhir.

kl Hapus semua filter. Perhatikan bahwa seperti sub-perintah lainnya, ini tidak
mengontrol filter yang dimasukkan secara otomatis.

Anda dapat menetapkan label untuk difilter dengan mengawalinya dengan @nama: (dimana nama adalah
pengenal arbitrer yang dipilih pengguna). Label dapat digunakan untuk merujuk ke filter berdasarkan nama
di semua perintah modifikasi rantai filter. Untuk menambahkan, menggunakan yang sudah digunakan
label akan menggantikan filter yang ada.

vf perintah menunjukkan daftar filter yang diminta pada OSD setelah mengubah
rantai penyaring. Ini kira-kira setara dengan teks pertunjukan ${vf}. Catat itu
filter yang dimasukkan secara otomatis untuk konversi format tidak ditampilkan dalam daftar, hanya apa
telah diminta oleh pengguna.

Biasanya, perintah akan memeriksa apakah rantai video dibuat ulang
berhasil, dan akan membatalkan operasi pada kegagalan. Jika perintah dijalankan sebelumnya
video dikonfigurasi (dapat terjadi jika perintah dijalankan segera setelah membuka a
file dan sebelum bingkai video diterjemahkan), pemeriksaan ini tidak dapat dijalankan. Kemudian bisa
terjadi bahwa membuat rantai video gagal.

Contoh untuk input.conf

· a vf set penerjunan putar video terbalik di a kunci

· b vf set "" hapus semua filter video aktif b

· c vf toggle lavfi=gradfun aktifkan debanding c

nilai-siklus ["!membalik"] ...
Siklus melalui daftar nilai. Setiap doa dari perintah akan mengatur yang diberikan
properti ke nilai berikutnya dalam daftar. Perintah mempertahankan penghitung internal
nilai mana yang harus dipilih selanjutnya, dan yang awalnya 0. Ini diatur ulang ke 0 setelah yang terakhir
nilai tercapai.

Penghitung internal dikaitkan menggunakan nama properti dan daftar nilai. Jika
beberapa perintah (terikat ke kunci yang berbeda) menggunakan nama dan daftar nilai yang sama, mereka
akan berbagi penghitung internal.

Argumen khusus !membalik dapat digunakan untuk memutar daftar nilai secara terbalik.
Dibandingkan dengan perintah yang hanya mencantumkan nilai secara terbalik, perintah ini akan
benar-benar berbagi penghitung internal dengan pengikatan kunci siklus maju (selama
karena sisa argumennya sama).

Perhatikan bahwa ada batas statis (pada tulisan ini) 10 argumen (batas ini
dapat dinaikkan sesuai permintaan).

aktifkan-bagian [bendera]
Aktifkan semua ikatan kunci di bagian input bernama.

Bagian input yang diaktifkan membentuk tumpukan. Binding di bagian di atas
tumpukan lebih disukai daripada bagian bawah. Perintah ini menempatkan bagian di atas
tumpukan. Jika bagian itu sudah ada di tumpukan, itu dihapus secara implisit
sebelumnya. (Bagian tidak boleh berada di tumpukan lebih dari sekali.)

bendera parameter dapat berupa kombinasi (dipisahkan oleh +) dari bendera berikut:


Semua bagian diaktifkan sebelum bagian yang baru diaktifkan dinonaktifkan. Mereka
akan diaktifkan kembali segera setelah semua bagian eksklusif di atasnya dihapus.
Dengan kata lain, bagian baru membayangi semua bagian sebelumnya.


Fitur ini tidak dapat digunakan melalui API publik.


Sama.

nonaktifkan-bagian
Nonaktifkan bagian input bernama. Membatalkan aktifkan-bagian.

tentukan-bagian [default|dipaksa]
Buat bagian input bernama, atau ganti konten input yang sudah ada
bagian. NS isi parameter menggunakan sintaks yang sama dengan masukan.conf berkas (kecuali
bahwa menggunakan sintaks bagian di dalamnya tidak diperbolehkan), termasuk kebutuhan untuk memisahkan
binding dengan karakter baris baru.

Jika isi parameter adalah string kosong, bagian tersebut dihapus.

Bagian dengan nama kegagalan adalah bagian input normal.

Secara umum, bagian input harus diaktifkan dengan aktifkan-bagian perintah, atau
mereka diabaikan.

Parameter terakhir memiliki arti sebagai berikut:

(Juga bekas if parameter dihilangkan)
Gunakan pengikatan kunci yang ditentukan oleh bagian ini hanya jika pengguna belum melakukannya
ikat kunci ini ke sebuah perintah.


Selalu ikat kunci. (Bagian input yang diaktifkan baru-baru ini
menang jika ada ambiguitas.)

overlay-tambahkan
Tambahkan hamparan OSD yang bersumber dari data mentah. Ini mungkin berguna untuk skrip dan
aplikasi yang mengontrol mpv, dan yang ingin menampilkan hal-hal di atas video
jendela.

Hamparan biasanya ditampilkan dalam resolusi layar, tetapi dengan beberapa VO,
resolusi dikurangi dengan video. Anda dapat membaca lebar-osd dan
tinggi osd properti. Setidaknya dengan --vo-xv dan video anamorfik (seperti DVD),
osd-par harus dibaca juga, dan overlay harus diberi kompensasi aspek.
(Arah masa depan: mungkin mpv harus menangani beberapa hal ini
secara otomatis, tetapi sulit untuk menentukan di mana harus menarik garis.)

id adalah bilangan bulat antara 0 dan 63 yang mengidentifikasi elemen hamparan. IDnya bisa
digunakan untuk menambahkan beberapa bagian overlay, perbarui bagian dengan menggunakan perintah ini dengan
ID yang sudah ada, atau untuk menghapus bagian dengan overlay-hapus. Menggunakan sebelumnya
ID yang tidak digunakan akan menambahkan overlay baru, sedangkan menggunakan kembali ID akan memperbaruinya. (Masa depan
arah: harus ada sesuatu untuk memastikan program yang berbeda ingin
buat overlay tidak bertentangan satu sama lain, jika itu diperlukan.)

x dan y tentukan posisi di mana OSD harus ditampilkan.

fillet menentukan file dari mana data gambar mentah dibaca. Itu bisa berupa angka
Deskriptor file UNIX diawali dengan @ (misalnya @4), atau nama file. File akan menjadi
dipetakan ke dalam memori dengan peta(). Beberapa VO akan meneruskan penunjuk yang dipetakan langsung ke
menampilkan API (misalnya opengl atau vdpau), jadi tidak ada penyalinan sebenarnya yang terlibat. Memotong
file sumber saat overlay aktif akan membuat pemutar macet. Anda seharusnya tidak
ubah data saat overlay aktif, karena data pada dasarnya
diakses pada titik acak. Sebagai gantinya, hubungi overlay-tambahkan lagi (sebaiknya dengan
wilayah memori yang berbeda untuk mencegah robek).

Dimungkinkan juga untuk melewatkan alamat memori mentah untuk digunakan sebagai memori bitmap dengan:
meneruskan alamat memori sebagai bilangan bulat yang diawali dengan an & karakter. melewati
hal yang salah di sini akan crash pemain. Mode ini mungkin berguna untuk digunakan dengan
libmpv. Itu mengimbangi parameter hanya ditambahkan ke alamat memori (karena mpv
0.8.0, diabaikan sebelumnya).

mengimbangi adalah offset byte dari piksel pertama dalam file sumber. (Sekarang
implementasi selalu mmap seluruh file dari posisi 0 hingga akhir
gambar, sehingga offset besar harus dihindari. Sebelum mpv 0.8.0, offsetnya adalah
benar-benar diteruskan langsung ke mmap, tetapi diubah untuk membuatnya lebih mudah.)

fmt adalah string yang mengidentifikasi format gambar. Saat ini, hanya bgra didefinisikan. Ini
format memiliki 4 byte per piksel, dengan 8 bit per komponen. Paling tidak signifikan 8
bit berwarna biru, dan 8 bit yang paling signifikan adalah alfa (dalam little endian, the
komponennya adalah BGRA, dengan B sebagai byte pertama). Ini menggunakan alfa yang dikalikan sebelumnya: setiap
komponen warna sudah dikalikan dengan komponen alpha. Ini berarti
nilai numerik setiap komponen sama dengan atau lebih kecil dari komponen alfa.
(Melanggar aturan ini akan menghasilkan hasil yang berbeda dengan VO yang berbeda: numerik
luapan yang dihasilkan dari pencampuran nilai alfa yang rusak dianggap sebagai sesuatu yang
seharusnya tidak terjadi, dan akibatnya implementasi tidak memastikan bahwa Anda mendapatkan
perilaku yang dapat diprediksi dalam kasus ini.)

w, h, dan langkah menentukan ukuran overlay. w adalah lebar yang terlihat dari
tumpang tindih, sedangkan langkah memberikan lebar dalam byte dalam memori. Dalam kasus sederhana, dan
pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. bgra format, langkah == 4 * w. Secara umum, jumlah total memori yang diakses
is langkah * h. (Secara teknis, ukuran minimumnya adalah langkah * (h - 1) + w * 4,
tetapi untuk kesederhanaan, pemain akan mengakses semua langkah * h byte.)

peringatan

Saat memperbarui overlay, Anda harus menyiapkan memori bersama kedua
region (mis. gunakan parameter offset) dan tambahkan ini sebagai overlay,
daripada menggunakan kembali memori yang sama setiap saat. Jika tidak, Anda mungkin mendapatkan
setara dengan merobek, ketika aplikasi dan mpv Anda menulis/membaca
penyangga sekaligus. Juga, perlu diingat bahwa mpv mungkin mengakses dan
overlay memori secara acak setiap kali merasa perlu untuk melakukannya, untuk
contoh saat menggambar ulang layar.

overlay-hapus
Hapus overlay yang ditambahkan dengan overlay-tambahkan dan identitas yang sama. Tidak melakukan apa-apa jika tidak
overlay dengan ID ini ada.

pesan-skrip ...
Kirim pesan ke semua klien, dan berikan daftar argumen berikut. Apa
arti pesan ini, berapa banyak argumen yang diperlukan, dan apa arti argumen itu
sepenuhnya kepada penerima dan pengirim. Setiap klien menerima pesan, jadi
hati-hati dengan bentrokan nama (atau gunakan skrip_pesan_ke).

script-pesan-ke ...
Sama dengan skrip_pesan, tetapi kirimkan hanya ke klien bernama . Setiap klien
(script dll) memiliki nama yang unik. Misalnya, skrip Lua bisa mendapatkan namanya melalui
mp.get_script_name().

pengikatan naskah
Panggil pengikatan kunci yang disediakan skrip. Ini dapat digunakan untuk memetakan kembali ikatan kunci
disediakan oleh skrip Lua eksternal.

Argumen adalah nama pengikatan.

Secara opsional dapat diawali dengan nama skrip, menggunakan / sebagai pemisah,
misalnya pengikatan_skrip nama skrip/nama pengikatan.

Untuk kelengkapannya, berikut cara kerja perintah ini secara internal. Detailnya bisa
berubah setiap saat. Pada setiap peristiwa kunci yang cocok, skrip_pesan_ke or skrip_pesan is
dipanggil (tergantung pada apakah nama skrip disertakan), di mana argumen pertama
adalah string pengikatan kunci, argumen kedua adalah nama pengikatan, dan
argumen ketiga adalah status kunci sebagai string. Keadaan kunci terdiri dari sejumlah
surat. Huruf pertama adalah salah satu dari d (tombol ditekan), u (sudah diterbitkan), r
(kunci masih turun, dan diulang; hanya jika pengulangan tombol diaktifkan untuk ini
mengikat), p (tombol ditekan; terjadi jika naik/turun tidak dapat dilacak). Kedua
surat apakah acara tersebut berasal dari mouse, baik m (tombol mouse) atau -
(sesuatu yang lain).

ab-loop
Siklus melalui status loop AB. Perintah pertama akan mengatur A titik (
ab-loop-a Properti); yang kedua B poin, dan yang ketiga akan menghapus kedua poin.

vo-cmdline
Setel ulang sub-opsi dari VO saat ini. Saat ini bekerja dengan terbuka (Termasuk
bukagl-hq). Argumennya adalah string sub-opsi yang biasanya diteruskan ke VO pada
garis komando. Tidak semua sub-opsi dapat diatur, tetapi yang dapat diatur ulang
bahkan jika mereka tidak muncul dalam argumen. Perintah ini mungkin diubah atau
dihapus di masa depan.

drop-buffer
Jatuhkan buffer audio/video/demuxer, dan mulai ulang dari yang baru. Mungkin membantu dengan
aliran yang tidak dapat dicari yang tidak sinkron. Perintah ini mungkin diubah atau
dihapus di masa depan.

screenshot-mentah [subtitel|video|jendela]
Kembalikan tangkapan layar di memori. Ini hanya dapat digunakan melalui API klien. Itu
MPV_FORMAT_NODE_MAP yang dikembalikan oleh perintah ini memiliki w, h, langkah bidang disetel ke
isi yang jelas. SEBUAH format bidang diatur ke bgr0 secara default. Format ini adalah
terorganisir sebagai B8G8R8X8 (dimana B adalah LSB). Isi paddingnya X is
tidak terdefinisi. Itu data bidang bertipe MPV_FORMAT_BYTE_ARRAY dengan gambar yang sebenarnya
data. Gambar dibebaskan segera setelah simpul hasil dibebaskan.

Perintah tidak berdokumen: tv-saluran terakhir (hanya TV/DVB), isi ulang (eksperimental/internal).

kait
Kait adalah peristiwa sinkron antara inti pemain dan skrip atau serupa. Ini berlaku untuk
klien API (termasuk antarmuka skrip Lua). Biasanya, acara seharusnya
asinkron, dan API kait menyediakan cara yang canggung dan tidak jelas untuk menangani peristiwa yang
memerlukan koordinasi yang lebih ketat. Tidak ada jaminan stabilitas API yang dibuat. Tidak mengikuti
protokol justru bisa membuat pemain membeku secara acak. Pada dasarnya, tidak ada yang boleh menggunakan
API ini.

Ada dua perintah khusus yang terlibat. Juga, klien harus mendengarkan pesan klien
(MPV_EVENT_CLIENT_MESSAGE di API C).

kait-tambahkan
Berlangganan ke kait yang diidentifikasi oleh argumen pertama (pada dasarnya, nama
peristiwa). Itu id argumen adalah bilangan bulat arbitrer yang dipilih oleh pengguna. prioritas is
digunakan untuk mengurutkan semua penangan kait secara global di semua klien. Setiap klien dapat
daftarkan beberapa penangan kait (bahkan untuk nama kait yang sama). Begitu kailnya
terdaftar, tidak dapat dibatalkan.

Ketika peristiwa tertentu terjadi, semua penangan terdaftar dijalankan secara serial. Ini menggunakan
protokol yang harus diikuti setiap klien secara eksplisit. Saat handler kail dijalankan, a
pesan klien (MPV_EVENT_CLIENT_MESSAGE) dikirim ke klien yang terdaftar
kait. Pesan ini memiliki argumen berikut:

1. tali hook_run

2. itu id argumen hook didaftarkan sebagai string (ini dapat digunakan untuk
menangani dengan benar beberapa kait yang didaftarkan oleh klien yang sama, selama id
argumen unik di klien)

3. sesuatu yang tidak terdefinisi, digunakan oleh mekanisme hook untuk melacak eksekusi hook
(saat ini, ini adalah nama kait, tetapi ini mungkin berubah tanpa peringatan)

Setelah menerima pesan ini, klien dapat menangani acara tersebut. Saat melakukan ini,
inti pemain masih akan bereaksi terhadap permintaan, tetapi pemutaran biasanya akan dihentikan.

Ketika klien selesai, itu harus melanjutkan eksekusi hook inti dengan menjalankan
kait-ack perintah.

kait-ack
Jalankan kait berikutnya dalam rantai kait global. Argumennya adalah argumen ke-3 dari
pesan klien yang memulai eksekusi kait untuk klien saat ini.

Kait berikut saat ini didefinisikan:

di_load
Dipanggil ketika sebuah file akan dibuka, sebelum sesuatu benar-benar dilakukan. Sebagai contoh,
Anda bisa membaca dan menulis stream-buka-nama file properti untuk mengarahkan ulang URL ke
sesuatu yang lain (pertimbangkan dukungan untuk situs streaming yang jarang memberi pengguna
URL media langsung), atau Anda dapat mengatur opsi per file dengan mengatur properti
file-lokal-opsi/ nama>. Pemain akan menunggu sampai semua hook dijalankan.

di_unload
Jalankan sebelum menutup file, dan sebelum benar-benar menghapus inisialisasi semuanya. Ini bukan
mungkin untuk melanjutkan pemutaran dalam keadaan ini.

Memasukkan perintah Awalan
Awalan ini ditempatkan di antara nama kunci dan perintah yang sebenarnya. Beberapa awalan bisa
ditentukan. Mereka dipisahkan oleh spasi.

osd-otomatis (Default)
Gunakan perilaku default untuk perintah ini.

tanpa-osd Jangan gunakan OSD apa pun untuk perintah ini.

bilah osd
Jika memungkinkan, tunjukkan bilah dengan perintah ini. Perintah pencarian akan menunjukkan kemajuan
bar, perintah perubahan properti mungkin menunjukkan nilai yang baru disetel.

osd-pesan
Jika memungkinkan, tampilkan pesan OSD dengan perintah ini. Cari perintah tunjukkan arus
waktu pemutaran, perintah perubahan properti menunjukkan nilai yang baru disetel sebagai teks.

osd-pesan-bar
Gabungkan osd-bar dan osd-msg.

mentah Jangan memperluas properti dalam argumen string. (Suka "${nama-properti}".)

memperluas-properti (Default)
Semua argumen string diperluas seperti yang dijelaskan dalam Milik Perluasan.

berulang
Untuk beberapa perintah, menekan tombol tidak akan menjalankan perintah berulang kali. Ini
kekuatan awalan memungkinkan pengulangan kunci dalam hal apa pun.

Semua awalan osd masih ditimpa oleh global --tingkat-osd pengaturan.

Memasukkan bagian
Bagian input mengelompokkan sekumpulan binding, dan mengaktifkan atau menonaktifkannya sekaligus. Di
masukan.conf, setiap pengikatan kunci ditugaskan ke bagian input, daripada benar-benar memiliki
bagian teks eksplisit.

Juga lihat aktifkan_bagian dan nonaktifkan_bagian perintah.

Binding yang telah ditentukan sebelumnya:

kegagalan
Binding tanpa bagian input secara implisit ditetapkan ke bagian ini. Dia
diaktifkan secara default selama pemutaran normal.

menyandi Bagian yang aktif dalam mode encoding. Ini diaktifkan secara eksklusif, sehingga
ikatan di kegagalan bagian diabaikan.

Properties
Properti digunakan untuk mengatur opsi mpv selama runtime, atau untuk menanyakan informasi arbitrer.
Mereka dapat dimanipulasi dengan set/menambahkan/siklus perintah, dan diambil dengan teks pertunjukan, atau
hal lain yang menggunakan ekspansi properti. (Melihat Milik Perluasan.)

Nama properti dianotasi dengan RW untuk menunjukkan apakah properti tersebut umumnya
dapat ditulis.

Jika opsi direferensikan, properti biasanya akan mengambil/mengembalikan nilai yang sama persis
sebagai pilihan. Dalam kasus ini, properti hanyalah cara untuk mengubah opsi saat runtime.

Milik daftar
tingkat osd (RW)
Lihat --tingkat-osd.

skala osd (RW)
Pengganda ukuran font OSD, lihat --skala-osd.

lingkaran (RW)
Lihat --lingkaran.

file-loop (RW)
Lihat --loop-file (menggunakan iya nih/tidak).

kecepatan (RW)
Lihat --kecepatan.

koreksi kecepatan audio, video-kecepatan-koreksi
Faktor dikalikan dengan kecepatan di mana pemain mencoba untuk memutar file. Biasanya
itu persis 1. (Mode sinkronisasi tampilan akan membuat ini berguna.)

Pemformatan OSD akan menampilkannya dalam bentuk + 1.23456%, dengan bilangan (mentah
- 1) * 100 untuk nilai properti mentah yang diberikan.

tampilan-sinkronisasi-aktif
Kembalikan apakah --video-sync=tampilan sebenarnya aktif.

nama file
File yang sedang diputar, dengan jalur dilucuti. Jika ini adalah URL, coba batalkan persen
pengkodean juga. (Hasilnya belum tentu benar, tetapi terlihat lebih baik untuk
tujuan tampilan. Menggunakan path properti untuk mendapatkan nama file yang tidak dimodifikasi.)

ukuran file
Panjang dalam byte dari file/aliran sumber. (Ini sama dengan ${aliran-akhir}. Forum
bab yang dipesan dan semacamnya, ukuran segmen yang sedang diputar dikembalikan.)

perkiraan-frame-count
Jumlah total frame dalam file saat ini.

CATATAN:
Ini hanya perkiraan. (Ini dihitung dari dua kuantitas yang tidak dapat diandalkan: fps dan
panjang aliran.)

estimasi-frame-number
Jumlah bingkai saat ini dalam aliran saat ini.

CATATAN:
Ini hanya perkiraan. (Ini dihitung dari dua kuantitas yang tidak dapat diandalkan: fps dan
mungkin stempel waktu yang dibulatkan.)

path Jalur lengkap dari file yang sedang diputar. Biasanya ini adalah string yang persis sama dengan Anda
meneruskan baris perintah mpv atau memuat file perintah, bahkan jika itu jalur relatif.
Jika Anda mengharapkan jalur absolut, Anda harus menentukannya sendiri, misalnya
dengan menggunakan direktori kerja milik.

judul media
Jika file yang sedang diputar memiliki judul tag, gunakan itu.

Jika tidak, jika jenis medianya adalah DVD, kembalikan ID volume DVD.

Jika tidak, kembalikan nama file milik.

format file
Nama simbolis dari format file. Dalam beberapa kasus, ini adalah daftar yang dipisahkan koma dari
nama format, misalnya mp4 adalah mov,mp4,m4a,3gp,3g2,mj2 (daftarnya mungkin bertambah di masa mendatang
untuk format apa pun).

demuxer
Nama demuxer saat ini. (Ini tidak berguna.)

jalur-arus
Nama file (path lengkap) dari nama file lapisan aliran. (Ini mungkin tidak berguna. Itu
sepertinya ini bisa berbeda dari path hanya ketika menggunakan misalnya bab yang dipesan.)

aliran-pos (RW)
Posisi byte mentah dalam aliran sumber.

akhir aliran
Posisi akhir mentah dalam byte dalam aliran sumber.

lamanya
Durasi file saat ini dalam hitungan detik. Jika durasinya tidak diketahui, properti
tidak tersedia. Perhatikan bahwa durasi file tidak selalu diketahui secara pasti, jadi ini
sebuah perkiraan.

Ini menggantikan panjangnya property, yang tidak digunakan lagi setelah rilis mpv 0.9.
(Semantiknya sama.)

sinkronisasi otomatis Perbedaan sinkronisasi A/V terakhir. Tidak tersedia jika audio atau video dinonaktifkan.

total-avsync-perubahan
Koreksi sinkronisasi AV total selesai. Tidak tersedia jika audio atau video dinonaktifkan.

jumlah bingkai jatuh
Bingkai video dijatuhkan oleh dekoder, karena video terlalu jauh di belakang audio (saat menggunakan
--framedrop=dekoder). Terkadang, ini mungkin bertambah dalam situasi lain, misalnya:
ketika paket video rusak, atau decoder tidak mengikuti aturan biasa.
Tidak tersedia jika video dinonaktifkan.

vo-drop-frame-count
Bingkai dijatuhkan oleh VO (saat menggunakan --framedrop=vo).

salah-waktu-frame-count
Jumlah bingkai video yang tidak diatur waktunya dengan benar dalam mode sinkronisasi tampilan untuk
demi menjaga sinkronisasi A/V. Ini tidak termasuk keadaan eksternal, seperti:
rendering video terlalu lambat atau driver grafis entah bagaimana melewatkan vsync. Dia
tidak termasuk kesalahan pembulatan baik (yang dapat terjadi terutama dengan buruk
stempel waktu sumber). Misalnya, menggunakan tampilan-desinkronisasi mode seharusnya tidak pernah berubah
nilai ini dari 0.

rasio-vsync
Untuk berapa banyak vsyncs sebuah frame ditampilkan rata-rata. Ini tersedia jika
sinkronisasi tampilan hanya aktif. Untuk video 30 FPS pada layar 60 Hz, ini akan menjadi 2.
Ini adalah rata-rata bergerak dari apa yang sebenarnya telah dijadwalkan, jadi 24 FPS pada 60 Hz
tidak akan pernah tetap tepat pada 2.5, tetapi jitter tergantung pada frame terakhir yang ditampilkan.

vo-penundaan-frame-count
Perkiraan jumlah bingkai tertunda karena keadaan eksternal dalam sinkronisasi tampilan
mode. Perhatikan bahwa secara umum, mpv harus menebak bahwa ini terjadi, dan tebakannya
bisa tidak akurat.

persen-pos (RW)
Posisi dalam file saat ini (0-100). Keuntungan menggunakan ini daripada
menghitungnya dari properti lain adalah bahwa itu benar-benar kembali ke estimasi
posisi pemutaran dari posisi byte, jika durasi file tidak diketahui.

pos waktu (RW)
Posisi dalam file saat ini dalam hitungan detik.

waktu-mulai
Tidak digunakan lagi. Selalu mengembalikan 0. Sebelum mpv 0.14, ini digunakan untuk mengembalikan waktu mulai
dari file (dapat mempengaruhi misalnya aliran transportasi). Melihat --rebase-mulai-waktu .

Waktu yang tersisa
Panjang file yang tersisa dalam hitungan detik. Perhatikan bahwa durasi file tidak selalu
diketahui secara pasti, jadi ini adalah perkiraan.

waktu bermain-sisa
Waktu yang tersisa diskalakan oleh arus kecepatan.

waktu pemutaran (RW)
Posisikan dalam file saat ini dalam hitungan detik. Tidak seperti pos waktu, waktu dijepit ke
jangkauan file. (Durasi file yang tidak akurat, dll., dapat membuatnya keluar dari jangkauan.
Juga membantu ketika pengguna mencoba mencari di luar file, sebagai target pencarian
waktu dianggap sebagai posisi saat ini selama pencarian.)

bab (RW)
Nomor bab saat ini. Jumlah bab pertama adalah 0.

edisi (RW)
Nomor edisi MKV saat ini. Menyetel properti ini ke nilai yang berbeda akan dimulai ulang
pemutaran. Jumlah edisi pertama adalah 0.

disc-judul
Jumlah judul BD/DVD.

Ini memiliki sejumlah sub-properti. Mengganti N dengan indeks edisi berbasis 0.

disc-judul/jumlah
Jumlah judul.

disc-judul/id
ID judul sebagai bilangan bulat. Saat ini, ini sama dengan indeks judul.

disc-judul/panjang
Panjang dalam detik. Dapat tidak tersedia dalam beberapa kasus (saat ini)
hanya berfungsi untuk libdvdnav).

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (untuk setiap edisi)
"id" MPV_FORMAT_INT64
"panjang" MPV_FORMAT_DOUBLE

disk-judul-daftar
Daftar judul BD/DVD.

disc-judul (RW)
Nomor judul BD/DVD saat ini. Menulis hanya berfungsi untuk DVD: // dan tidur:// (Dan
alias untuk ini).

bab
Jumlah bab.

Edisi
Jumlah edisi MKV.

daftar edisi
Daftar edisi, entri saat ini ditandai. Saat ini, nilai properti mentah adalah
tak berguna.

Ini memiliki sejumlah sub-properti. Mengganti N dengan indeks edisi berbasis 0.

daftar edisi/hitungan
Jumlah edisi. Jika tidak ada edisi, ini bisa menjadi 0 atau 1 (1 jika
ada edisi dummy yang tidak berguna).

daftar-edisi/T/id
ID Edisi sebagai bilangan bulat. Gunakan ini untuk mengatur edisi Properti. Saat ini,
ini sama dengan indeks edisi.

daftar edisi/N/default
iya nih jika ini adalah edisi default, tidak jika tidak.

daftar edisi/N/judul
Judul edisi seperti yang disimpan dalam file. Tidak selalu tersedia.

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (untuk setiap edisi)
"id" MPV_FORMAT_INT64
"judul" MPV_FORMAT_STRING
"default" MPV_FORMAT_FLAG

ab-loop-a, ab-loop-b (RW)
Setel/dapatkan poin loop AB. Lihat opsi yang sesuai dan ab_loop perintah. Itu
nilai khusus tidak pada salah satu properti ini menonaktifkan perulangan.

sudut (RW)
Sudut DVD saat ini.

metadata
Pasangan kunci/nilai metadata.

Jika properti diakses dengan Lua's mp.get_properti_native, ini mengembalikan tabel
dengan pemetaan kunci metadata ke nilai metadata. Jika diakses dengan klien
API, ini mengembalikan MPV_FORMAT_NODE_MAP, dengan pemetaan kunci tag ke nilai tag.

Untuk OSD, ia mengembalikan daftar yang diformat. Mencoba mengambil properti ini sebagai mentah
tali tidak berfungsi.

Ini memiliki sejumlah sub-properti:

metadata/dengan kunci/
Nilai entri metadata .

metadata/daftar/jumlah
Jumlah entri metadata.

metadata/daftar/N/kunci
Nama kunci entri metadata ke-N. (Entri pertama adalah 0).

metadata/daftar/N/nilai
Nilai entri metadata ke-N.

metadata/
Versi lama dari metadata/dengan kunci/. Penggunaan tidak disarankan, karena
string kunci metadata dapat bertentangan dengan sub-properti lainnya.

Tata letak properti ini mungkin dapat berubah. Saran dipersilahkan bagaimana
persis properti ini harus bekerja.

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_MAP
(nilai kunci dan string untuk setiap entri metadata)

metadata terfilter
Seperti metadata, tetapi hanya mencakup bidang yang tercantum di --display-tag pilihan. Ini
adalah kumpulan tag yang sama yang dicetak ke terminal.

bab-metadata
Metadata bab saat ini. Bekerja mirip dengan metadata Properti. Hal ini juga memungkinkan
metode akses yang sama (menggunakan sub-properti).

Metadata per-bab sangat jarang. Biasanya, hanya nama bab (judul) ditetapkan.

Untuk mengakses informasi lain, seperti bab awal, lihat daftar bab milik.

vf-metadata/
Metadata ditambahkan oleh filter video. Diakses oleh label filter, yang jika tidak
ditentukan secara eksplisit menggunakan @filter-label: sintaks, akan menjadi NN.

Bekerja mirip dengan metadata Properti. Ini memungkinkan metode akses yang sama (menggunakan
sub-properti).

Contoh dari jenis metadata ini adalah parameter pemotongan yang ditambahkan oleh
--vf=lavfi=deteksi tanaman.

af-metadata/
Setara dengan vf-metadata/, tetapi untuk filter audio.

berhenti sebentar (RW)
Jeda status. Ini biasanya iya nih or tidak. Lihat --berhenti sebentar.

siaga Pengembalian iya nih jika tidak ada file yang dimuat, tetapi pemain tetap berada di sekitar karena
--menganggur .

inti-idle
Pengembalian iya nih jika inti pemutaran dijeda, jika tidak tidak. Ini bisa berbeda
berhenti sebentar dalam situasi khusus, seperti ketika pemain berhenti sendiri karena rendah
cache jaringan.

Ini juga kembali iya nih jika pemutaran dimulai ulang atau jika tidak ada yang diputar sama sekali. Di
kata lain, itu hanya tidak jika benar-benar ada pemutaran video. (Perilaku sejak mpv
0.7.0.)

Cache Status pengisian cache jaringan (0-100.0).

ukuran cache (RW)
Ukuran cache jaringan dalam KB. Ini mirip dengan --cache. Ini memungkinkan untuk mengatur cache
ukuran saat runtime. Saat ini, tidak mungkin untuk mengaktifkan atau menonaktifkan cache di
runtime menggunakan properti ini, hanya untuk mengubah ukuran cache yang ada.

Ini tidak termasuk ukuran backbuffer (berubah setelah mpv 0.10.0).

Perhatikan bahwa ini mencoba untuk menjaga isi cache sejauh mungkin. Untuk membuat ini
lebih mudah, kode pengubahan ukuran cache akan mengalokasikan cache baru sementara cache lama adalah
masih dialokasikan.

Jangan gunakan ini saat memutar DVD atau Blu-ray.

bebas cache (R)
Total ukuran cache gratis dalam KB.

cache-digunakan (R)
Total ukuran cache yang digunakan dalam KB.

cache-idle (R)
Pengembalian iya nih jika cache idle, artinya cache terisi sebanyak
mungkin, dan saat ini tidak membaca lebih banyak data.

demuxer-cache-durasi
Perkiraan durasi video buffer di demuxer, dalam detik. Dugaannya adalah
sangat tidak dapat diandalkan, dan seringkali properti tidak akan tersedia sama sekali, bahkan jika data
adalah buffer.

waktu demuxer-cache
Perkiraan waktu video buffer di demuxer, dalam detik. Sama dengan
demuxer-cache-durasi tetapi mengembalikan stempel waktu terakhir dari data buffer di demuxer.

demuxer-cache-idle
Pengembalian iya nih jika demuxer idle, yang berarti cache demuxer diisi ke
jumlah yang diminta, dan saat ini tidak membaca lebih banyak data.

dijeda-untuk-cache
Pengembalian iya nih saat pemutaran dijeda karena menunggu cache.

cache-buffering-status
Kembalikan persentase (0-100) dari status pengisian cache hingga pemain mau
batalkan jeda (terkait dengan dijeda-untuk-cache).

berhasil dicapai
Pengembalian iya nih jika akhir pemutaran tercapai, tidak jika tidak. Perhatikan bahwa ini biasanya
menarik hanya jika --tetap buka diaktifkan, karena jika tidak, pemain akan
segera putar file berikutnya (atau keluar atau masuk ke mode siaga), dan dalam kasus ini
berhasil dicapai properti secara logis akan dihapus segera setelah disetel.

pencarian
Pengembalian iya nih jika pemain sedang mencari, atau mencoba memulai kembali
pemutaran. (Mungkin itu kembali iya nih saat file dimuat, atau ketika
beralih segmen bab yang dipesan. Ini karena kode dasar yang sama adalah
digunakan untuk mencari dan menyinkronkan ulang.)

jam-mencari (RW)
Lihat --jam-mencari.

volume (RW)
Volume saat ini (lihat --volume untuk lebih jelasnya).

bergerak (RW)
Status bisu saat ini (iya nih/tidak).

penundaan audio (RW)
Lihat --penundaan audio.

codec audio
Codec audio dipilih untuk decoding.

audio-codec-nama
Kodek audio.

audio-param
Format audio sebagai output oleh decoder audio. Ini memiliki sejumlah sub-properti:

audio-params/format
Format sampel sebagai string. Ini menggunakan nama yang sama seperti yang digunakan di lainnya
tempat mpv.

audio-params/sampel
Tingkat sampel

audio-params/saluran
Tata letak saluran sebagai string. Ini mirip dengan apa yang --saluran-audio
menerima.

audio-params/jam-saluran
As saluran, tetapi alih-alih tata letak aktual yang mungkin samar yang dikirim ke
perangkat audio, kembalikan bentuk yang mudah-mudahan lebih dapat dibaca manusia. (Biasanya hanya
audio-out-params/jam-saluran masuk akal.)

audio-params/jumlah-saluran
Jumlah saluran audio. Ini berlebihan untuk saluran bidang yang dijelaskan
atas.

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_MAP
"format" MPV_FORMAT_STRING
"sampel" MPV_FORMAT_INT64
"saluran" MPV_FORMAT_STRING
"jumlah saluran" MPV_FORMAT_INT64
"saluran jam" MPV_FORMAT_STRING

parameter audio-out
Sama dengan audio-param, tetapi format data yang ditulis ke API audio.

bantuan (RW)
Trek audio saat ini (mirip dengan --bantuan).

audio (RW)
Alias ​​untuk bantuan.

menyeimbangkan (RW)
Keseimbangan saluran audio. (Implementasi fitur ini agak aneh. It
tidak mengubah volume setiap saluran, tetapi menyiapkan matriks pan untuk bercampur
saluran kiri dan kanan.)

fullscreen (RW)
Lihat --layar penuh.

deinterlace (RW)
Lihat --deinterlace.

dominasi bidang (RW)
Lihat --dominan-bidang

matriks warna (R)
Pengalihan ke video-params/colormatrix. Parameter ini (serta yang serupa) dapat
ditimpa dengan format penyaring video.

rentang input matriks warna (R)
Lihat matriks warna.

video-output-level (RW)
Lihat --video-output-level,

colormatrix-primer (R)
Lihat matriks warna.

di atas (RW)
Lihat --di atas.

batas (RW)
Lihat --berbatasan.

di-semua-ruang kerja (RW)
Lihat --di-semua-ruang kerja. Unsetting mungkin tidak bekerja pada semua WM.

bingkai (RW)
Lihat --bingkaijatuh.

gamma (RW)
Lihat --gamma.

kecerahan (RW)
Lihat --kecerahan.

kontras (RW)
Lihat --kontras.

kejenuhan (RW)
Lihat --kejenuhan.

warna (RW)
Lihat --warna.

hwdec (RW)
mencerminkan --hwdec .

Menulis ke sana dapat mengubah dekoder perangkat keras yang saat ini digunakan, jika memungkinkan.
(Secara internal, pemain dapat menginisialisasi ulang dekoder, dan akan melakukan pencarian untuk
segarkan video dengan benar.) Anda dapat menonton properti hwdec lainnya untuk melihat
apakah ini berhasil.

Tidak seperti di mpv 0.9.x dan sebelumnya, ini tidak mengembalikan perangkat keras yang sedang aktif
dekoder.

hwdec-aktif
Pengembalian iya nih or tidak, tergantung pada apakah semua jenis decoding perangkat keras benar-benar ada
digunakan.

hwdec-terdeteksi
Jika decoding perangkat lunak aktif, ini akan mengembalikan dekoder perangkat keras yang digunakan.
Jika tidak, itu akan kembali tidak, atau jika berlaku, perangkat keras yang dimuat saat ini
penguraian kode API. Ini hanya diketahui setelah VO dibuka (dan mungkin nanti). Dengan
beberapa VO (seperti terbuka), ini tidak pernah diketahui sebelumnya, tetapi hanya ketika decoder
mencoba untuk membuat decoder hw berhasil. Juga, bagaimana decoder dengan -salinan
akhiran akan kembali tidak sementara tidak ada video yang sedang diterjemahkan. Semua ini mencerminkan bagaimana
mendeteksi decoder hw terdeteksi dan digunakan secara internal di mpv.

panscan (RW)
Lihat --panscan.

format video
Format video sebagai string.

codec video
Codec video dipilih untuk decoding.

lebar, tinggi
Ukuran video. Ini menggunakan ukuran video sebagai decode, atau jika tidak ada bingkai video yang
belum didekodekan, wadah (mungkin salah) menunjukkan ukuran.

param video
Parameter video, sebagai keluaran oleh dekoder (dengan penggantian seperti aspek dll.
terapan). Ini memiliki sejumlah sub-properti:

param video/format piksel
Format piksel sebagai string. Ini menggunakan nama yang sama seperti yang digunakan di tempat lain
dari mpv.

video-params/rata-rata-bpp
Rata-rata bit per piksel sebagai bilangan bulat. Format planar subsampel menggunakan yang berbeda
resolusi, itulah alasan mengapa nilai ini terkadang bisa ganjil atau
membingungkan. Dapat tidak tersedia dengan beberapa format.

video-params/kedalaman bidang
Kedalaman bit untuk setiap komponen warna sebagai bilangan bulat. Ini hanya diekspos untuk
format planar atau komponen tunggal, dan tidak tersedia untuk format lain.

video-params/w, video-params/jam
Ukuran video sebagai bilangan bulat, tanpa koreksi aspek yang diterapkan.

video-param/dw, video-params/dh
Ukuran video sebagai bilangan bulat, diskalakan untuk rasio aspek yang benar.

video-params/aspek
Tampilkan rasio aspek sebagai float.

video-param/par
Rasio aspek piksel.

video-params/colormatrix
Colormatrix digunakan sebagai string. (Nilai yang tepat dapat berubah.)

video-params/tingkat warna
Tingkat warna sebagai string. (Nilai yang tepat dapat berubah.)

video-params/primer
Primer digunakan sebagai string. (Nilai yang tepat dapat berubah.)

video-params/gamma
Fungsi gamma digunakan sebagai string. (Nilai yang tepat dapat berubah.)

param video/lokasi chrome
Lokasi kroma sebagai string. (Nilai yang tepat dapat berubah.)

video-params/putar
Rotasi tampilan yang dimaksudkan dalam derajat (searah jarum jam).

video-param/stereo-in
Sumber file stereo mode 3D. (Melihat --mode-video-stereo pilihan.)

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_MAP
"format piksel" MPV_FORMAT_STRING
"w" MPV_FORMAT_INT64
"h" MPV_FORMAT_INT64
"dw" MPV_FORMAT_INT64
"dh" MPV_FORMAT_INT64
"aspek" MPV_FORMAT_DOUBLE
"setara" MPV_FORMAT_DOUBLE
"matriks warna" MPV_FORMAT_STRING
"tingkat warna" MPV_FORMAT_STRING
"primer" MPV_FORMAT_STRING
"lokasi kroma" MPV_FORMAT_STRING
"putar" MPV_FORMAT_INT64
"stereo-in" MPV_FORMAT_STRING

lebar, tinggi
Ukuran tampilan video. Ini adalah ukuran video setelah filter dan penskalaan aspek
telah diterapkan. Ukuran jendela video sebenarnya masih bisa berbeda dari ini, misalnya
jika pengguna mengubah ukuran jendela video secara manual.

Ini memiliki nilai yang sama dengan video-out-params/dw dan video-keluar-params/dh.

parameter video-out
Sama dengan param video, tetapi setelah filter video diterapkan. Jika tidak ada
filter video yang digunakan, ini akan berisi nilai yang sama dengan param video. Catat itu
ini masih belum tentu apa yang digunakan jendela video, karena pengguna dapat mengubah
ukuran jendela, dan semua VO nyata melakukan penskalaan mereka sendiri secara independen dari
rantai penyaring.

Memiliki sub-properti yang sama dengan param video.

info-bingkai-video
Informasi perkiraan dari frame saat ini. Perhatikan bahwa jika salah satu dari ini digunakan pada
OSD, informasinya mungkin hilang beberapa bingkai karena menggambar ulang dan bingkai OSD
tampilan agak terputus, dan Anda mungkin harus menjeda dan memaksa a
menggambar ulang

Sub-properti:

video-frame-info/gambar-jenis info-bingkai-video/interlaced info-bingkai-video/tff
video-frame-info/ulangi

fps FPS kontainer. Ini dapat dengan mudah mengandung nilai-nilai palsu. Untuk video yang menggunakan modern
format wadah atau codec video, ini akan sering salah.

perkiraan-vf-fps
Perkiraan/pengukuran FPS dari output rantai filter video. (Jika tidak ada filter yang digunakan,
ini sesuai dengan keluaran dekoder.) Ini menggunakan rata-rata dari 10 frame sebelumnya
durasi untuk menghitung FPS. Ini akan menjadi tidak akurat jika frame-dropping terlibat
(seperti ketika framedrop diaktifkan secara eksplisit, atau setelah pencarian yang tepat). File
dengan stempel waktu yang tidak tepat (seperti Matroska) dapat menyebabkan hasil yang tidak stabil.

skala jendela (RW)
Pengganda ukuran jendela. Mengatur ini akan mengubah ukuran jendela video ke nilai
terkandung dalam lebar dan tinggi dikalikan dengan nilai yang ditetapkan dengan properti ini.
Pengaturan 1 akan mengubah ukuran ke ukuran video asli (atau tepatnya, ukuran video
keluaran filter). 2 akan mengatur ukuran ganda, 0.5 setengah ukuran.

jendela-diminimalkan
Kembalikan apakah jendela video diperkecil atau tidak.

nama tampilan
Nama tampilan yang dicakup oleh jendela mpv. Pada X11, ini adalah xrandr
nama (LVDS1, HDMI1, DP1, VGA1, dll.).

tampilan-fps (RW)
Kecepatan refresh tampilan saat ini. Saat ini, ini adalah FPS terendah dari semua
tampilan yang dicakup oleh video, seperti yang diambil oleh API sistem yang mendasarinya (mis
xrandr pada X11). Ini bukan FPS yang diukur. Itu belum tentu tersedia di semua
platform. Perhatikan bahwa salah satu fakta yang tercantum dapat berubah kapan saja tanpa peringatan.

perkiraan-tampilan-fps
Hanya tersedia jika mode sinkronisasi tampilan (seperti yang dipilih oleh --sinkronisasi video) aktif.
Mengembalikan tingkat aktual di mana penyegaran tampilan tampaknya terjadi, diukur dengan
waktu sistem.

vsync-jitter
Perkiraan faktor deviasi dari durasi vsync.

aspek video (RW)
Aspek video, lihat --aspek-video.

lebar osd, tinggi osd
Lebar OSD yang terakhir diketahui (bisa 0). Ini diperlukan jika Anda ingin menggunakan hamparan_tambahkan
memerintah. Ini memberi Anda ukuran OSD yang sebenarnya, yang bisa berbeda dari jendela
ukuran dalam beberapa kasus.

osd-par
Aspek piksel tampilan OSD yang terakhir diketahui (bisa 0).

Vid (RW)
Trek video saat ini (mirip dengan --vid).

video (RW)
Alias ​​untuk Vid.

video-penyelarasan-x, video-align-y (RW)
Lihat --video-sejajarkan-x dan --video-sejajarkan-y.

video-pan-x, video-pan-y (RW)
Lihat --video-pan-x dan --video-pan-y.

zoom video (RW)
Lihat --video-zoom.

video-tidak diskalakan (W)
Lihat --video-tidak diskalakan.

program (W)
Ganti program TS (hanya tulis).

sid (RW)
Trek subtitle saat ini (mirip dengan --sid).

sisi sekunder (RW)
Trek subtitle sekunder (lihat --sisi-sekunder).

di bawah (RW)
Alias ​​untuk sid.

sub-penundaan (RW)
Lihat --sub-penundaan.

sub-pos (RW)
Lihat --sub-pos.

sub-visibilitas (RW)
Lihat --sub-visibilitas.

sub-paksa saja (RW)
Lihat --sub-paksa-saja.

sub-skala (RW)
Pengganda ukuran font subtitle.

pantat-kekuatan-margin (RW)
Lihat --ass-force-margin.

sub-penggunaan-margin (RW)
Lihat --sub-penggunaan-margin.

ass-vsfilter-aspect-compat (RW)
Lihat --ass-vsfilter-aspect-compat.

penggantian gaya pantat (RW)
Lihat --penggantian gaya pantat.

tangkapan arus (RW)
Nama file, lihat --stream-tangkap. Pengaturan ini akan mulai menangkap menggunakan yang diberikan
nama file. Menyetelnya ke string kosong akan menghentikannya.

kecerahan tv, kontras tv, saturasi tv, warna TV (RW)
hal-hal TV.

daftar putar-pos (RW)
Posisi saat ini di daftar putar. Entri pertama ada di posisi 0. Menulis ke
properti akan memulai kembali pemutaran pada entri tertulis.

daftar putar-hitungan
Jumlah entri daftar putar total.

playlist
Daftar putar, entri saat ini ditandai. Saat ini, nilai properti mentah tidak berguna.

Ini memiliki sejumlah sub-properti. Mengganti N dengan entri daftar putar berbasis 0
indeks.

daftar putar/hitung
Jumlah entri daftar putar (sama dengan daftar putar-hitungan).

daftar putar/N/nama file
Nama file entri ke-N.

daftar putar/N/saat ini, daftar putar/T/bermain
iya nih jika entri ini sedang diputar (atau sedang dimuat). Tidak tersedia atau tidak
jika tidak. Saat mengubah file, arus dan bermain bisa berbeda,
karena file yang sedang diputar belum dibongkar; pada kasus ini,
arus mengacu pada pilihan baru. (Sejak mpv 0.7.0.)

daftar putar/N/judul
Nama entri ke-N. Hanya tersedia jika file daftar putar berisi seperti
bidang, dan hanya jika pengurai mpv mendukungnya untuk format daftar putar yang diberikan.

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (untuk setiap entri daftar putar)
"nama file" MPV_FORMAT_STRING
MPV_FORMAT_FLAG "saat ini" (mungkin tidak ada; sejak mpv 0.7.0)
"memutar" MPV_FORMAT_FLAG (sama)
"judul" MPV_FORMAT_STRING (opsional)

Daftar lagu
Daftar audio/video/sub trek, entri saat ini ditandai. Saat ini, properti mentah
nilai tidak berguna.

Ini memiliki sejumlah sub-properti. Mengganti N dengan indeks trek berbasis 0.

daftar lagu/hitungan
Jumlah trek.

daftar lagu/T/id
ID seperti yang digunakan untuk -sid/--bantuan/--vid. Ini unik dalam trek
jenis yang sama (sub/audio/video), tetapi sebaliknya tidak.

daftar lagu/N/jenis
String yang menjelaskan jenis media. Satu dari audio, video, di bawah.

daftar lagu/N/src-id
Track ID seperti yang digunakan dalam file sumber. Tidak selalu tersedia.

daftar lagu/N/judul
Lacak judul seperti yang disimpan dalam file. Tidak selalu tersedia.

daftar lagu/N/lang
Lacak bahasa seperti yang diidentifikasi oleh file. Tidak selalu tersedia.

daftar lagu/N/saluran audio
Untuk trek audio, jumlah saluran audio dalam aliran audio. Bukan
selalu akurat (tergantung pada petunjuk wadah). Tidak selalu tersedia.

daftar lagu/N/albumart
iya nih jika ini adalah trek video yang terdiri dari satu gambar, tidak or
tidak tersedia sebaliknya. Ini digunakan untuk trek video yang benar-benar
gambar terlampir dalam file audio.

daftar lagu/N/default
iya nih jika trek memiliki bendera default yang disetel dalam file, tidak jika tidak.

daftar lagu/N/dipaksa
iya nih jika trek memiliki bendera paksa yang diatur dalam file, tidak jika tidak.

daftar lagu/N/codec
Nama codec yang digunakan oleh lagu ini, misalnya h264. Tidak tersedia di beberapa
kasus langka.

daftar lagu/N/eksternal
iya nih jika trek adalah file eksternal, tidak jika tidak. Ini diatur untuk terpisah
file subtitle.

daftar lagu/N/nama file eksternal
Nama file jika trek berasal dari file eksternal, sebaliknya tidak tersedia.

daftar lagu/N/dipilih
iya nih jika trek saat ini diterjemahkan, tidak jika tidak.

daftar lagu/N/ff-indeks
Indeks aliran seperti yang biasanya digunakan oleh utilitas FFmpeg. Perhatikan bahwa ini bisa
berpotensi salah jika demuxer selain libavformat (--demuxer=lavf) aku s
digunakan. Untuk file mkv, indeks biasanya akan cocok meskipun default
(builtin) demuxer digunakan, tetapi tidak ada jaminan keras.

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (untuk setiap trek)
"id" MPV_FORMAT_INT64
"ketik" MPV_FORMAT_STRING
"src-id" MPV_FORMAT_INT64
"judul" MPV_FORMAT_STRING
"lang" MPV_FORMAT_STRING
"saluran audio" MPV_FORMAT_INT64
"albumart" MPV_FORMAT_FLAG
"default" MPV_FORMAT_FLAG
"dipaksa" MPV_FORMAT_FLAG
MPV_FORMAT_FLAG "eksternal"
"nama file-eksternal" MPV_FORMAT_STRING
"codec" MPV_FORMAT_STRING

daftar bab
Daftar bab, entri saat ini ditandai. Saat ini, nilai properti mentah adalah
tak berguna.

Ini memiliki sejumlah sub-properti. Mengganti N dengan indeks bab berbasis 0.

daftar bab/hitungan
Jumlah bab.

daftar bab/N/judul
Judul bab seperti yang disimpan dalam file. Tidak selalu tersedia.

daftar bab/N/waktu
Waktu mulai bab dalam hitungan detik sebagai float.

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (untuk setiap bab)
"judul" MPV_FORMAT_STRING
"waktu" MPV_FORMAT_DOUBLE

af (RW)
Lihat --af dan af perintah.

vf (RW)
Lihat --vf dan vf perintah.

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (untuk setiap entri filter)
"nama" MPV_FORMAT_STRING
"label" MPV_FORMAT_STRING [opsional]
"params" MPV_FORMAT_NODE_MAP [opsional]
"kunci" MPV_FORMAT_STRING
"nilai" MPV_FORMAT_STRING

Anda juga dapat menulis properti menggunakan format ini.

putar video (RW)
Lihat --video-putar .

bisa dicari
Kembalikan apakah secara umum mungkin untuk mencari di file saat ini.

dapat dicari sebagian
Pengembalian iya nih jika file saat ini dianggap dapat dicari, tetapi hanya karena cache
aktif. Ini berarti pencarian kerabat kecil mungkin baik-baik saja, tetapi pencarian yang lebih besar mungkin gagal
omong-omong. Apakah pencarian akan berhasil atau tidak umumnya tidak diketahui sebelumnya.

Jika properti ini mengembalikan nilai true, bisa dicari juga akan kembali benar.

pemutaran-aborsi
Kembalikan apakah pemutaran dihentikan atau akan dihentikan. (Berguna dalam ketidakjelasan
situasi seperti selama di_load pemrosesan kait, ketika pengguna dapat menghentikan pemutaran,
tetapi skrip harus secara eksplisit mengakhiri pemrosesan.)

kursor-sembunyikan otomatis (RW)
Lihat --kursor-sembunyikan otomatis. Mengatur ini ke nilai baru akan selalu memperbarui kursor,
dan reset timer internal.

osd-sym-cc
Menyisipkan simbol OSD saat ini sebagai kode kontrol OSD buram (cc). Ini masuk akal
hanya dengan teks pertunjukan perintah atau opsi yang mengatur pesan OSD. Kontrol
kode adalah implementasi khusus dan tidak berguna untuk hal lain.

osd-ass-cc
${osd-ass-cc/0} menonaktifkan pelolosan urutan teks ASS di OSD, ${osd-ass-cc/1}
memungkinkannya lagi. Secara default, urutan ASS diloloskan untuk menghindari kecelakaan
pemformatan, dan properti ini dapat menonaktifkan perilaku ini. Perhatikan bahwa properti
mengembalikan kode kontrol OSD buram, yang hanya masuk akal untuk teks pertunjukan Command
atau opsi yang mengatur pesan OSD.

Example

· --osd-status-msg='Ini is ${osd-ass-cc/0}{\\b1}tebal teks'

· teks pertunjukan "Ini is ${osd-ass-cc/0}{\b1}tebal teks"

Tag override ASS apa pun yang dipahami oleh libass dapat digunakan.

Perhatikan bahwa Anda harus melarikan diri dari \ karakter, karena string diproses untuk C
escape sequence sebelum meneruskannya ke kode OSD.

Daftar tag dapat ditemukan di sini: http://docs.aegisub.org/latest/ASS_Tags/

dikonfigurasi secara vo
Kembalikan apakah VO sudah dikonfigurasi sekarang. Biasanya ini sesuai dengan apakah
jendela video terlihat. jika --force-jendela opsi digunakan, ini biasanya
selalu kembali iya nih.

kecepatan bit video, bitrate audio, sub-bitrate
Nilai bitrate dihitung pada tingkat paket. Ini bekerja dengan membagi ukuran bit
semua paket antara dua keyframe berdasarkan jarak stempel waktu presentasinya.
(Ini menggunakan stempel waktu yang disimpan dalam file, jadi misalnya kecepatan pemutaran tidak
mempengaruhi nilai yang dikembalikan.) Secara khusus, bitrate video hanya akan diperbarui
per keyframe, dan tunjukkan bitrate "masa lalu". Untuk membuat properti lebih ramah UI,
pembaruan properti ini dibatasi dengan cara tertentu.

Satuannya adalah bit per detik. Pemformatan OSD mengubah nilai ini dalam kilobit (atau
megabit, jika sesuai), yang dapat dicegah dengan menggunakan nilai properti mentah,
misalnya dengan ${=kecepatan bit video}.

Perhatikan bahwa keakuratan properti ini dipengaruhi oleh beberapa faktor. jika
demuxer yang mendasari menulis ulang paket pada demuxing (dilakukan untuk beberapa format file),
bitrate mungkin sedikit mati. Jika cap waktu buruk atau gelisah (seperti di
Matroska), bahkan aliran bitrate yang konstan mungkin menunjukkan bitrate yang berfluktuasi.

Bagaimana tepatnya nilai-nilai ini dihitung dapat berubah di masa mendatang.

Di versi mpv sebelumnya, properti ini mengembalikan tebakan statis (tapi buruk)
menggunakan metode yang sama sekali berbeda.

paket-video-bitrate, paket-audio-bitrate, paket-sub-bitrate
Properti lama dan tidak digunakan lagi untuk bitrate video, kecepatan bit audio, sub-bitrate. Mereka
berperilaku persis sama, tetapi mengembalikan nilai dalam kilobit. Juga, mereka tidak punya
Pemformatan OSD, meskipun hal yang sama dapat dicapai dengan mis ${=kecepatan bit video}.

Properti ini tidak boleh digunakan lagi.

audio-perangkat-daftar
Kembalikan daftar perangkat audio yang ditemukan. Ini sebagian besar untuk digunakan dengan klien
API, dan mencerminkan apa --audio-device=bantuan dengan pemain baris perintah kembali.

Saat menanyakan properti dengan API klien menggunakan MPV_FORMAT_NODE, atau dengan Lua
mp.get_properti_native, ini akan mengembalikan mpv_node dengan konten berikut:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (untuk setiap entri perangkat)
"nama" MPV_FORMAT_STRING
"deskripsi" MPV_FORMAT_STRING

nama adalah apa yang harus diteruskan ke --perangkat audio pilihan (dan seringkali agak
ID khusus API audio samar), sementara deskripsi adalah teks bentuk bebas yang dapat dibaca manusia.
Deskripsi adalah string kosong jika tidak ada yang diterima.

Entri khusus dengan nama yang ditetapkan ke mobil memilih driver output audio default
dan perangkat default.

Properti dapat diawasi dengan mekanisme observasi properti di klien
API dan dalam skrip Lua. (Secara teknis, pemberitahuan perubahan diaktifkan pertama kali
properti ini dibaca.)

perangkat audio (RW)
Setel perangkat audio. Ini langsung membaca/menulis --perangkat audio pilihan, tapi pada
akses tulis, output audio akan dijadwalkan untuk dimuat ulang.

Menulis properti ini saat tidak ada output audio yang aktif tidak akan diaktifkan secara otomatis
audio. (Hal ini juga berlaku jika audio dinonaktifkan karena
kegagalan inisialisasi ulang setelah akses tulis sebelumnya ke perangkat audio.)

Properti ini juga tidak memberi tahu Anda perangkat audio mana yang benar-benar digunakan.

Bagaimana detail ini ditangani dapat berubah di masa mendatang.

saat ini-vo
Driver keluaran video saat ini (nama seperti yang digunakan dengan --vo).

saat ini-ao
Driver output audio saat ini (nama seperti yang digunakan dengan --ao).

audio-out-detected-perangkat
Kembalikan perangkat audio yang dipilih oleh driver AO (hanya diterapkan untuk beberapa
driver: saat ini saja com.coreaudio).

direktori kerja
Kembalikan direktori kerja proses mpv. Dapat bermanfaat bagi pengguna JSON IPC,
karena pemain baris perintah biasanya bekerja dengan jalur relatif.

daftar protokol
Daftar awalan protokol yang berpotensi dikenali oleh pemain. Mereka dikembalikan
tanpa tertinggal :/ / akhiran (yang masih selalu diperlukan). Dalam beberapa kasus,
protokol tidak akan benar-benar didukung (pertimbangkan https jika ffmpeg tidak dikompilasi
dengan dukungan TLS).

versi mpv
Kembalikan versi mpv/string hak cipta. Tergantung pada bagaimana biner dibangun, itu
mungkin berisi versi rilis, atau hanya hash git.

mpv-konfigurasi
Kembalikan argumen konfigurasi yang diteruskan ke sistem build (biasanya
jalan ./melambai mengkonfigurasi ... dipanggil).

pilihan/ (RW)
Akses baca-saja ke nilai opsi --. Sebagian besar opsi dapat diubah di
runtime dengan menulis ke properti ini. Perhatikan bahwa banyak opsi memerlukan memuat ulang
file agar perubahan diterapkan. Jika ada properti yang setara, pilih pengaturan
properti sebagai gantinya.

file-lokal-opsi/
Mirip dengan pilihan/, tetapi saat menyetel opsi melalui properti ini,
opsi diatur ulang ke nilai lamanya setelah file saat ini berhenti diputar. Mencoba
untuk menulis opsi saat tidak ada file yang diputar (atau sedang dimuat) menghasilkan
kesalahan.

(Perhatikan bahwa jika opsi ditandai sebagai file-local, genap pilihan/ akan mengakses
nilai lokal, dan tua nilai, yang akan dikembalikan pada akhir pemutaran, tidak bisa
dibaca atau ditulis hingga akhir pemutaran.)

info-pilihan/
Informasi per opsi tambahan.

Ini memiliki sejumlah sub-properti. Mengganti dengan nama tingkat atas
pilihan. Tidak ada jaminan stabilitas yang diberikan pada salah satu dari sub-properti ini - mereka
dapat berubah secara radikal dalam fitur.

info-pilihan/ /nama
Mengembalikan nama opsi.

info-pilihan/ /Tipe
Kembalikan nama jenis opsi, seperti String or Bilangan bulat. Untuk banyak
jenis kompleks, ini tidak terlalu akurat.

info-pilihan/ /set-from-commandline
Pengembalian iya nih jika opsi disetel dari baris perintah mpv, tidak jika tidak.
Untuk apa ini diatur jika opsinya misalnya diubah saat runtime dibiarkan
undefined (artinya bisa berubah di masa depan).

info-pilihan/ /set-lokal
Pengembalian iya nih jika opsi disetel per-file. Ini adalah kasus dengan
profil yang dimuat secara otomatis, konfigurasi direktori file, dan kasus lainnya. Itu berarti
nilai opsi akan dikembalikan ke nilai sebelum pemutaran dimulai ketika
pemutaran berakhir.

info-pilihan/ /nilai-default
Nilai default opsi. Mungkin tidak selalu tersedia.

info-pilihan/ / menit, info-pilihan/ /maks
Nilai minimum dan maksimum bilangan bulat yang diizinkan untuk opsi. Hanya tersedia jika
pilihannya numerik, dan minimum/maksimum telah diatur secara internal.
Mungkin juga hanya satu yang diatur.

info-pilihan/ /pilihan
Jika opsi adalah pilihan pilihan, pilihan yang mungkin. Pilihan yang
bilangan bulat mungkin atau mungkin tidak termasuk (mereka dapat tersirat oleh menit dan max).
Perhatikan bahwa opsi yang berperilaku seperti opsi pilihan, tetapi tidak aktual
pilihan pilihan internal, mungkin tidak memiliki info ini tersedia.

daftar-properti
Kembalikan daftar properti tingkat atas.

Milik Perluasan
Semua argumen string untuk memasukkan perintah serta opsi tertentu (seperti
--istilah-bermain-pesan) tunduk pada perluasan properti. Perhatikan bahwa ekspansi properti tidak
tidak bekerja di tempat di mana misalnya parameter numerik diharapkan. (Misalnya, menambahkan
perintah tidak melakukan ekspansi properti. Itu set perintah adalah pengecualian dan bukan jenderal
aturan.)

Contoh untuk input.conf

i teks pertunjukan Filename: ${namafile}
menunjukkan nama file dari file saat ini saat menekan tombol i kunci

Dalam masukan.conf, ekspansi properti dapat dihambat dengan menempatkan mentah awalan di depan
dari perintah.

Ekspansi berikut didukung:

${NAMA}
Memperluas ke nilai properti NAMA. Jika pengambilan properti gagal, perluas
ke string kesalahan. (Menggunakan ${NAMA:} dengan jejak : untuk memperluas ke string kosong
sebagai gantinya.) Jika NAMA diawali dengan =, perluas ke nilai mentah properti (lihat
bagian di bawah).

${NAMA:STR}
Memperluas ke nilai properti NAMA, atau STR jika properti tidak bisa
diambil. STR diperluas secara rekursif.

${?NAMA:STR}
Perluas ke STR (secara rekursif) jika properti NAMA tersedia.

${!NAMA:STR}
Perluas ke STR (secara rekursif) jika properti NAMA tidak dapat diambil kembali.

${?NAMA==NILAI:STR}
Perluas ke STR (secara rekursif) jika properti NAMA mengembang menjadi string yang sama dengan
NILAI. Anda dapat awalan NAMA dengan = untuk membandingkan nilai mentah suatu properti
(lihat bagian di bawah). Jika properti tidak tersedia, atau kesalahan lain terjadi saat
mengambilnya, nilainya tidak pernah dianggap sama. Perhatikan bahwa NILAI tidak bisa mengandung
salah satu karakter : or }. Juga, mungkin saja melarikan diri dengan " or % mungkin
ditambahkan di masa mendatang, jika diperlukan.

${!NAMA==NILAI:STR}
Sama halnya dengan ? varian, tapi STR diperluas jika nilainya tidak sama. (Menggunakan
semantik yang sama dengan ?.)

$$ Perluas ke $.

$} Perluas ke }. (Untuk menghasilkan karakter ini di dalam ekspansi rekursif.)

$> Nonaktifkan perluasan properti dan penanganan khusus $ untuk sisa tali.

Di tempat-tempat di mana perluasan properti diizinkan, pelarian gaya-C juga sering diterima.
Contoh:

· \n menjadi karakter baris baru

· \\ berkembang menjadi \

Mentah dan Diformat Properties
Biasanya, properti diformat sebagai teks yang dapat dibaca manusia, dimaksudkan untuk ditampilkan di OSD atau
di terminal. Dimungkinkan untuk mengambil nilai (mentah) yang tidak diformat dari properti dengan
awalan namanya dengan =. Nilai mentah ini dapat diuraikan oleh program lain dan mengikuti
konvensi yang sama dengan opsi yang terkait dengan properti.

contoh

· ${pos-waktu} berkembang menjadi 00:14:23 (jika posisi playback pada 14 menit 23 detik)

· ${=pos-waktu} berkembang menjadi 863.4 (waktu yang sama, ditambah 400 milidetik - milidetik adalah
biasanya tidak ditampilkan dalam kasus yang diformat)

Terkadang, perbedaan jumlah informasi yang dibawa oleh properti mentah dan yang diformat
nilai bisa agak besar. Dalam beberapa kasus, nilai mentah memiliki lebih banyak informasi, seperti lebih tinggi
presisi dari detik dengan pos waktu. Terkadang sebaliknya, mis bantuan menunjukkan
judul dan bahasa trek dalam huruf besar yang diformat, tetapi hanya nomor trek jika mentah.

ON LAYAR CONTROLLER

On Screen Controller (singkat: OSC) adalah GUI minimal yang terintegrasi dengan mpv untuk menawarkan dasar
pengendalian tikus. Hal ini dimaksudkan untuk membuat interaksi lebih mudah bagi pengguna baru dan untuk
memungkinkan pencarian yang tepat dan langsung.

OSC diaktifkan secara default jika mpv dikompilasi dengan dukungan Lua. Itu bisa dinonaktifkan
seluruhnya menggunakan --osc=tidak .

Menggunakan itu OSC
Secara default, OSC akan muncul setiap kali mouse dipindahkan ke dalam jendela pemutar dan
akan bersembunyi jika mouse tidak dipindahkan ke luar OSC selama 0.5 detik atau jika mouse keluar
jendela.

Antarmuka
+------------------+-----------+------------------ --+
| daftar putar sebelumnya | judul | daftar putar berikutnya |
+-------+------+---+--+------+-+----+------+------ --+
| audio | lewati | cari | | cari | lewati | penuh |
+-------+ kembali | kembali | bermain | frwd | frwd | layar |
| sub | | | | | | |
+-------+------+------+------+------+------+------ --+
| bilah pencarian |
+----------------+--------------+----------------- --+
| waktu berlalu | status tembolok | waktu yang tersisa |
+----------------+--------------+----------------- --+

playlist prev

┌─ans───── Chasan XNUMX Choll XNUMX Choll XNUMXX XNUMX Chocanding "" "" "" XNUMXirim XNUMXirim XNUMXans XNUMXansans XNUMX Chosansans XNUMX Chosans XNUMX Chosansans XNUMX XNUMX Chsans XNUMX Chs Chsmook XNUMXook XNUMX Chs XNUMXook XNUMX Ch
klik kiri putar file sebelumnya di daftar putar
├─ans───── Chasan XNUMX Choll XNUMX Choll XNUMXX XNUMX Chocanding "" "" "" XNUMXirim XNUMXirim XNUMXans XNUMXansans XNUMX Chosansans XNUMX Chosans XNUMX Chosansans XNUMX XNUMX Chsans XNUMX Chs Chsmook XNUMXook XNUMX Chs XNUMXook XNUMX Ch
shift+L-klik tampilkan daftar putar
└─ans───── Chasan XNUMX Choll XNUMX Choll XNUMXX XNUMX Chocanding "" "" "" XNUMXirim XNUMXirim XNUMXans XNUMXansans XNUMX Chosansans XNUMX Chosans XNUMX Chosansans XNUMX XNUMX Chsans XNUMX Chs Chsmook XNUMXook XNUMX Chs XNUMXook XNUMX Ch

judul
Menampilkan judul media atau nama file saat ini

┌─ans───── Chasan XNUMX Choll XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Chack XNUMX Chack XNUMX Chs Chsmocans Choll XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX Chos XNUMXX XNUMX Choll XNUMX Chos XNUMXX XNUMX Chosansansans XNUMX XNUMXs XNUMX Chsans XNUMX Chss XNUMX Chack XNUMX Chss XNUMX Ch
klik kiri tampilkan posisi daftar putar dan
panjang dan judul lengkap
├─ans───── Chasan XNUMX Choll XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Chack XNUMX Chack XNUMX Chs Chsmocans Choll XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX Chos XNUMXX XNUMX Choll XNUMX Chos XNUMXX XNUMX Chosansansans XNUMX XNUMXs XNUMX Chsans XNUMX Chss XNUMX Chack XNUMX Chss XNUMX Ch
klik kanan tampilkan nama file
└─ans───── Chasan XNUMX Choll XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Chack XNUMX Chack XNUMX Chs Chsmocans Choll XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX Chos XNUMXX XNUMX Choll XNUMX Chos XNUMXX XNUMX Chosansansans XNUMX XNUMXs XNUMX Chsans XNUMX Chss XNUMX Chack XNUMX Chss XNUMX Ch

playlist berikutnya

┌────── teks acoran───X chambatan uracebookans XNUMX. ilangan ilangan harga> ilangan ilangan acam Phalisasi urans XNUMXansansansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX balik Mis kata─ans──ampilan ─┐
klik kiri putar file berikutnya dalam daftar putar
├────── teks acoran───X chambatan uracebookans XNUMX. ilangan ilangan harga> ilangan ilangan acam Phalisasi urans XNUMXansansansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX balik Mis kata─ans──ampilan ─┤
shift+L-klik tampilkan daftar putar
└────── teks acoran───X chambatan uracebookans XNUMX. ilangan ilangan harga> ilangan ilangan acam Phalisasi olak anding kor Astrekan "XNUMXirim XNUMXans XNUMXansansans XNUMX uman q Aitar XNUMXans XNUMX Chsansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX uman qoran

audio dan di bawah
Menampilkan trek yang dipilih dan jumlah trek yang tersedia

┌──────────────┬────────────────────────────────── ┐
klik kiri siklus audio/sub trek ke depan
├──────────────┼────────────────────────────────── ┤
klik kanan siklus audio/sub trek mundur
├──────────────┼────────────────────────────────── ┤
shift+L-klik tampilkan audio/sub trek yang tersedia
└──────────────┴────────────────────────────────── ┘

melewatkan kembali

┌──────────────┬────────────────────────────────── ┐
klik kiri pergi ke awal bab /
bab sebelumnya
├──────────────┼────────────────────────────────── ┤
shift+L-klik tampilkan bab
└──────────────┴────────────────────────────────── ┘

mencari kembali

┌─ans──── tekstariran────── Chasan XNUMX Choll XNUMXX XNUMXX XNUMX Choll XNUMX Chack XNUMXX XNUMX Chack XNUMX Chack XNUMX Chososansans XNUMX Chsans XNUMX Chss XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXs Janater - ─┐
klik kiri lewati mundur 5 detik
├─ans──── tekstariran────── Chasan XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Chack XNUMX Chack XNUMX Chsmocansansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXsisten harga ┤
klik kanan lewati mundur 30 detik
├─ans──── tekstariran────── Chasan XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Chack XNUMX Chack XNUMX Chsmocansansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXsisten harga ┤
shift-L-klik lewati kembali 1 bingkai
└─ans──── tekstariran────── Chasan XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Chack XNUMX Chack XNUMX Chsmocansansansans XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXsisten harga ┘

bermain

┌────── Chasan XNUMXirim XNUMXirim "" "tolasanasanaskanaskanirim tolasanasanasanasanaskan tolasanasanaskan XNUMXirimirim" XNUMXirim XNUMXansansansansans poto──ans XNUMX. Miss─┐
klik kiri toggle play/pause
└────── Chasan XNUMXirim XNUMXirim "" "tolasanasanaskanaskanirim tolasanasanasanasanaskan tolasanasanaskan XNUMXirimirim" XNUMXirim XNUMXansansansansans poto──ans XNUMX. Miss─┘

mencari Frwd

┌─ans──── tekstariran──── tekstariranatal XNUMX. Missacam "" "" ""irim tolasan XNUMXirim XNUMXirim XNUMX unjuk olak ilangan─ans──── XNUMX Chsansansans pirimsIL
klik kiri lewati maju 10 detik
├─ans──── tekstariran──── tekstariranatal XNUMX. Missacam "" "" ""irim tolasan XNUMXirim XNUMXirim XNUMX unjuk olak ilangan─ans──── XNUMX Chsansansans pirimsIL
klik kanan lewati maju 60 detik
├─ans──── tekstariran──── tekstariranatal XNUMX. Missacam "" "" ""irim tolasan XNUMXirim XNUMXirim XNUMX unjuk olak ilangan─ans──── XNUMX Chsansansans pirimsIL
shift-L-klik lewati 1 frame
└─ans──── tekstariran──── tekstariranatal XNUMX. Missacam "" "" ""irim tolasan XNUMXirim XNUMXirim XNUMX unjuk olak ilangan─ans──── XNUMX Chsansansans pirimsIL

melewatkan Frwd

┌───────────────┬─────────────────────┐
klik kiri pergi ke bab berikutnya
├───────────────┼─────────────────────┤
shift+L-klik tampilkan bab
└───────────────┴─────────────────────┘

fullscreen

┌────── Chasan XNUMXirim XNUMXirim "" "tolasanasanaskanaskanirim tolasanasanasanasanaskan tolasanasanaskan XNUMXirimirim" XNUMXirim XNUMXansansansansans poto──ans XNUMX. Miss─┐
klik kiri alihkan layar penuh
└────── Chasan XNUMXirim XNUMXirim "" "tolasanasanaskanaskanirim tolasanasanasanasanaskan tolasanasanaskan XNUMXirimirim" XNUMXirim XNUMXansansansansans poto──ans XNUMX. Miss─┘

bar pencarian
Menunjukkan posisi pemutaran saat ini dan posisi bab

┌─ans───── Chasan XNUMX XNUMX XNUMX Choll XNUMX Choll XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMX Chs XNUMX XNUMX XNUMX XNUMX Chss XNUMX Chexans XNUMX Ch
klik kiri cari posisi
└─ans───── Chasan XNUMX XNUMX XNUMX Choll XNUMX Choll XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMX Chs XNUMX XNUMX XNUMX XNUMX Chss XNUMX Chexans XNUMX Ch

waktu Lulus
Menunjukkan stempel waktu posisi pemutaran saat ini

┌─ans───── Chasan XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Ch XNUMX Ch XNUMX Chs Chsmoc XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMXX XNUMX Choc XNUMXX XNUMX Ch XNUMX Chos XNUMXX XNUMX Chocansansansansans potacksistemstariranyayayayayayayayayayayaANyaANyayayayayayayayayayayayayayayayayayayayaikaya .esinggisi saya pel kompl
klik kiri beralih menampilkan kode waktu dengan
milidetik
└─ans───── Chasan XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Ch XNUMX Ch XNUMX Chs Chsmoc XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMXX XNUMX Choc XNUMXX XNUMX Ch XNUMX Chos XNUMXX XNUMX Chocansansansansans potacksistemstariranyayayayayayayayayayayaANyaANyayayayayayayayayayayayayayayayayayayayaikaya .esinggisi saya pel kompl

Cache status
Menunjukkan status pengisian cache saat ini (hanya terlihat saat di bawah 45%)

waktu yang tersisa
Menunjukkan stempel waktu waktu pemutaran yang tersisa

┌─ans───── Chasan XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Ch XNUMX Ch XNUMX Chs Chsmoc XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMXX XNUMX Choc XNUMXX XNUMX Ch XNUMX Chos XNUMXX XNUMX Chocansansansansans potacksistemstariranyayayayayayayayayayayaANyaANyayayayayayayayayayayayayayayayayayayayaikaya .esinggisi saya pel kompl
klik kiri beralih antara total dan
waktu yang tersisa
└─ans───── Chasan XNUMX Choll XNUMXX XNUMX Choll XNUMXX XNUMX Ch XNUMX Ch XNUMX Chs Chsmoc XNUMXX XNUMX Ch XNUMX Ch XNUMXX XNUMX Choc XNUMXX XNUMX Choc XNUMXX XNUMX Ch XNUMX Chos XNUMXX XNUMX Chocansansansansans potacksistemstariranyayayayayayayayayayayaANyaANyayayayayayayayayayayayayayayayayayayayaikaya .esinggisi saya pel kompl

kunci Bindings
Binding kunci ini aktif secara default jika tidak ada lagi yang terikat ke kunci ini.
Dalam kasus tabrakan, fungsi perlu diikat ke kunci yang berbeda. Lihat Naskah
Perintah bagian.

┌─ans───┬───── tekstariran "" "" bingonggol padr --s───ans─ Chocandingansansansansans XNUMX XNUMX Choll XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXss pulangs Miss─ XNUMX - ─┐
del Sembunyikan OSC secara permanen sampai
mpv dimulai ulang.
└─ans───┴───── tekstariran "" "" bingonggol padr --s───ans─ Chocandingansansansansans XNUMX XNUMX Choll XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXss pulangs Miss─ XNUMX - ─┘

konfigurasi
OSC menawarkan konfigurasi terbatas melalui file konfigurasi lua-settings/osc.conf ditempatkan di
dir pengguna mpv dan melalui --script-memilih opsi baris perintah. Pilihan yang disediakan melalui
baris perintah akan menimpanya dari file konfigurasi.

config Sintaksis
File konfigurasi harus benar-benar mengikuti sintaks berikut:

#ini adalah komentar
opsiA=nilai1
opsiB=nilai2

# hanya dapat digunakan di awal baris dan mungkin tidak ada spasi di sekitar = or
di tempat lain.

Garis komando Sintaksis
Untuk menghindari tabrakan dengan skrip lain, semua opsi harus diawali dengan osc-.

Contoh:

--script-opts=osc-optionA=nilai1, osc-optionB=nilai2

dikonfigurasi Opsi
jendela pamer
Standar: ya
Aktifkan OSC saat berjendela

layar penuh
Standar: ya
Aktifkan OSC saat layar penuh

jendela skala
Standar: 1.0
Faktor skala OSC saat berjendela

layar penuh skala
Standar: 1.0
Faktor skala OSC saat layar penuh

scaleforcedwindow
Standar: 2.0
Faktor skala OSC saat dirender pada jendela paksa (dummy)

skala video
Standar: ya
Skala OSC dengan video
tidak mencoba menjaga agar ukuran OSC tetap konstan selama ukuran jendela memungkinkan

valign
Standar: 0.8
Perataan vertikal, -1 (atas) hingga 1 (bawah)

tenang
Standar: 0.0
Perataan horizontal, -1 (kiri) hingga 1 (kanan)

boxalpha
Standar: 80
Alfa dari kotak latar belakang, 0 (buram) hingga 255 (sepenuhnya transparan)

waktu persembunyian
Standar: 500
Durasi dalam ms hingga OSC bersembunyi jika tidak ada gerakan mouse, nilai negatif
menonaktifkan sembunyikan otomatis

memudar
Standar: 200
Durasi fade out dalam ms, 0 = tidak ada fade

zona mati
Standar: 0
Ukuran zona mati. Deadzone adalah area yang membuat mouse beraksi
seperti meninggalkan jendela. Pergerakan di sana tidak akan membuat OSC muncul dan
itu akan segera bersembunyi jika mouse memasukinya. Zona mati dimulai
di perbatasan jendela yang berlawanan dengan OSC dan ukurannya mengontrol seberapa banyak
dari jendela itu akan span. Nilai antara 0 dan 1.

minmousemove
Standar: 3
Jumlah piksel minimum yang harus dipindahkan mouse di antara kutu untuk membuatnya
OSC muncul

tata ruang
Standar: kotak
Tata letak untuk OSC. Saat ini tersedia adalah: box, slimbox,
batang bawah dan batang atas.

mencari gaya bar
Bawaan: penggeser
Menyetel gaya bilah pencarian, penggeser (penanda berlian) atau bilah (pengisian)

total waktu
Standar: tidak
Tampilkan total waktu alih-alih waktu yang tersisa

waktu
Standar: tidak
Tampilkan kode waktu dengan milidetik

Naskah Perintah
Skrip OSC mendengarkan perintah skrip tertentu. Perintah-perintah ini dapat terikat dalam masukan.conf,
atau dikirim oleh skrip lain.

aktifkan-osc
Urungkan nonaktifkan-osc atau efek dari itu kunci.

nonaktifkan-osc
Sembunyikan OSC secara permanen. Ini juga yang itu kunci tidak.

osc-pesan
Tampilkan pesan di layar menggunakan OSC. Argumen pertama adalah pesannya, kedua
durasi dalam detik.

Example

Anda bisa memasukkan ini ke dalam masukan.conf untuk menyembunyikan OSC dengan a kunci dan untuk menyembunyikannya dengan b:

script_message menonaktifkan-osc
b script_message aktifkan-osc

LUA SKRIPSI

mpv dapat memuat skrip Lua. Skrip diteruskan ke --naskah pilihan, atau ditemukan di script
subdirektori dari direktori konfigurasi mpv (biasanya ~/.config/mpv/scripts/) akan
dimuat pada awal program. mpv juga menambahkan script subdirektori ke akhir Lua's
path sehingga Anda dapat mengimpor skrip dari sana juga. Karena ditambahkan di akhir, jangan beri nama
skrip yang ingin Anda impor sama dengan pustaka Lua karena skrip tersebut akan dibayangi oleh
Mereka.

mpv menyediakan modul bawaan mp, yang berisi fungsi untuk mengirim perintah ke mpv
inti dan untuk mengambil informasi tentang status pemutaran, pengaturan pengguna, informasi file,
dan seterusnya.

Skrip ini dapat digunakan untuk mengontrol mpv dengan cara yang mirip dengan mode budak. Secara teknis,
Kode Lua menggunakan API klien secara internal.

Example
Skrip yang keluar dari mode layar penuh saat pemutar dijeda:

fungsi on_pause_change(nama, nilai)
jika nilai == benar maka
mp.set_property("layar penuh", "tidak")
akhir
akhir
mp.observe_property("pause", "bool", on_pause_change)

Rincian on itu naskah inisialisasi dan siklus hidup
Skrip Anda akan dimuat oleh pemain saat program dimulai dari script konfigurasi
subdirektori, atau dari jalur yang ditentukan dengan --naskah pilihan. Beberapa skrip dimuat
secara internal (seperti --osc). Setiap skrip berjalan di utasnya sendiri. Skrip Anda pertama kali dijalankan "sebagai
is", dan setelah selesai, loop peristiwa dimasukkan. Loop peristiwa ini akan mengirimkan
acara yang diterima oleh mpv dan hubungi pengendali acara Anda sendiri yang telah Anda daftarkan
mp.register_event, atau penghitung waktu ditambahkan dengan mp.add_timeout atau serupa.

Ketika pemain berhenti, semua skrip akan diminta untuk dihentikan. Ini terjadi melalui penutupan
event, yang secara default akan membuat event loop kembali. Jika skrip Anda masuk ke
loop tak berujung, mpv mungkin akan berperilaku baik selama pemutaran (kecuali pemainnya
ditangguhkan, lihat mp.menangguhkan), tetapi tidak akan berhenti saat berhenti, karena sedang menunggu
naskah Anda.

Secara internal, kode C akan memanggil fungsi Lua mp_event_loop setelah memuat Lua
naskah. Fungsi ini biasanya ditentukan oleh pendahuluan default yang dimuat sebelum skrip Anda
(Lihat player/lua/defaults.lua di sumber mpv). Loop acara akan menunggu acara dan
acara pengiriman terdaftar dengan mp.register_event. Ini juga akan menangani penghitung waktu yang ditambahkan dengan
mp.add_timeout dan sejenisnya (dengan menunggu dengan batas waktu).

Sejak mpv 0.6.0, pemain akan menunggu hingga skrip terisi penuh sebelum melanjutkan
operasi normal. Pemain menganggap skrip sudah terisi penuh segera setelah dimulai
menunggu acara mpv (atau keluar). Dalam prakteknya ini berarti pemain akan kurang lebih
gantung sampai skrip kembali dari potongan utama (dan mp_event_loop disebut), atau
panggilan skrip mp_event_loop or mp.dispatch_events secara langsung. Ini dilakukan untuk membuatnya
memungkinkan skrip untuk sepenuhnya mengatur event handler, dll. sebelum pemutaran benar-benar dimulai.
Dalam versi mpv yang lebih lama, ini terjadi secara tidak sinkron.

mp fungsi
mp modul sudah dimuat sebelumnya, meskipun dapat dimuat secara manual dengan membutuhkan 'mp'. Itu
menyediakan API klien inti.

mp.perintah(string)
Jalankan perintah yang diberikan. Ini mirip dengan perintah yang digunakan di input.conf. Melihat
Daftar of Memasukkan Perintah.

Secara default, ini akan menampilkan sesuatu di OSD (tergantung pada perintah), seolah-olah
itu digunakan dalam masukan.conf. Lihat Memasukkan perintah Awalan bagaimana mempengaruhi penggunaan OSD
per perintah.

Pengembalian benar pada kesuksesan, atau nol, kesalahan pada kesalahan.

mp.perintahv(arg1, argumen2, ...)
Mirip dengan mp.command, tetapi berikan setiap argumen perintah sebagai parameter terpisah. Ini
memiliki keuntungan bahwa Anda tidak perlu peduli tentang mengutip dan melarikan diri di beberapa
Kasus.

Contoh:

mp.command("loadfile " .. nama file .. " tambahkan")
mp.commandv("loadfile", nama file, "tambahkan")

Kedua perintah ini setara, kecuali bahwa versi pertama rusak jika
nama file berisi spasi atau karakter khusus tertentu.

Perhatikan bahwa properti adalah tidak diperluas. Anda dapat menggunakan keduanya mp.command, yang
memperluas-properti awalan, atau mp.get_properti keluarga fungsi.

Berbeda mp.command, ini juga tidak akan menggunakan OSD secara default (kecuali untuk beberapa
perintah khusus OSD).

mp.command_native(tabel [, def])
Mirip dengan mp.commandv, tetapi berikan daftar argumen sebagai tabel. Ini memiliki keuntungan
bahwa setidaknya dalam beberapa kasus, argumen dapat diteruskan sebagai tipe asli.

Mengembalikan tabel hasil pada keberhasilan (biasanya kosong), atau pasti, kesalahan pada kesalahan. def is
parameter kedua yang disediakan untuk fungsi, dan nihil jika tidak ada.

mp.get_property(nama [, def])
Kembalikan nilai properti yang diberikan sebagai string. Ini adalah properti yang sama dengan
digunakan di input.conf. Melihat Properties untuk daftar properti. String yang dikembalikan adalah
diformat mirip dengan ${=nama} (Lihat Milik Perluasan).

Mengembalikan string pada keberhasilan, atau pasti, kesalahan pada kesalahan. def adalah parameter kedua
disediakan untuk fungsi, dan nihil jika tidak ada.

mp.get_property_osd(nama [, def])
Mirip dengan mp.get_properti, tetapi kembalikan nilai properti yang diformat untuk OSD. Ini
adalah string yang sama dengan yang dicetak dengan ${nama} ketika digunakan di input.conf.

Mengembalikan string pada keberhasilan, atau pasti, kesalahan pada kesalahan. def adalah parameter kedua
disediakan untuk fungsi, dan merupakan string kosong jika tidak ada. Tidak seperti
dapatkan_properti(), menetapkan nilai balik ke variabel akan selalu menghasilkan a
String.

mp.get_property_bool(nama [, def])
Mirip dengan mp.get_properti, tetapi kembalikan nilai properti sebagai Boolean.

Mengembalikan Boolean pada keberhasilan, atau pasti, kesalahan pada kesalahan.

mp.get_property_number(nama [, def])
Mirip dengan mp.get_properti, tetapi kembalikan nilai properti sebagai angka.

Perhatikan bahwa sementara Lua tidak membedakan antara integer dan float, internal mpv
melakukan. Fungsi ini hanya meminta float ganda dari mpv, dan mpv biasanya akan
mengonversi nilai properti integer menjadi float.

Mengembalikan angka pada keberhasilan, atau pasti, kesalahan pada kesalahan.

mp.get_property_native(nama [, def])
Mirip dengan mp.get_properti, tetapi kembalikan nilai properti menggunakan tipe Lua terbaik
untuk properti. Sebagian besar waktu, ini akan mengembalikan string, Boolean, atau angka. Beberapa
properti (misalnya daftar bab) dikembalikan sebagai tabel.

Mengembalikan nilai keberhasilan, atau pasti, kesalahan pada kesalahan. Perhatikan bahwa nol mungkin a
mungkin, nilai yang valid juga dalam beberapa kasus sudut.

mp.set_property(nama, nilai)
Setel properti yang diberikan ke nilai string yang diberikan. Melihat mp.get_properti dan
Properties untuk informasi lebih lanjut tentang properti.

Mengembalikan nilai true pada kesuksesan, atau nol, kesalahan pada kesalahan.

mp.set_property_bool(nama, nilai)
Mirip dengan mp.set_properti, tetapi tetapkan properti yang diberikan ke nilai Boolean yang diberikan.

mp.set_property_number(nama, nilai)
Mirip dengan mp.set_properti, tetapi atur properti yang diberikan ke nilai numerik yang diberikan.

Perhatikan bahwa sementara Lua tidak membedakan antara integer dan float, internal mpv
melakukan. Fungsi ini akan menguji apakah bilangan tersebut dapat direpresentasikan sebagai bilangan bulat, dan
jika demikian, itu akan meneruskan nilai integer ke mpv, jika tidak, float ganda.

mp.set_property_native(nama, nilai)
Mirip dengan mp.set_properti, tetapi atur properti yang diberikan menggunakan tipe aslinya.

Karena ada beberapa tipe data yang tidak dapat direpresentasikan secara asli di Lua, ini
mungkin tidak selalu bekerja seperti yang diharapkan. Misalnya, sementara pembungkus Lua dapat melakukan beberapa
tebakan untuk memutuskan apakah tabel Lua adalah larik atau peta, ini akan gagal dengan
meja kosong. Juga, tidak banyak properti yang masuk akal untuk digunakan
ini, bukannya set_properti, set_properti_bool, set_properti_nomor. Untuk ini
alasan, fungsi ini mungkin harus dihindari untuk saat ini, kecuali untuk properti
yang menggunakan tabel secara asli.

mp.get_time()
Kembalikan waktu internal mpv saat ini dalam hitungan detik sebagai angka. Ini pada dasarnya adalah
waktu sistem, dengan offset sewenang-wenang.

mp.add_key_binding(kunci, nama|fn [, fn [,bendera]])
Daftarkan panggilan balik untuk dijalankan pada pengikatan kunci. Ikatan akan dipetakan ke
diberikan kunci, yang merupakan string yang menjelaskan kunci fisik. Ini menggunakan kunci yang sama
nama seperti di input.conf, dan juga memungkinkan kombinasi (mis ctrl+a).

Setelah memanggil fungsi ini, penekanan tombol akan menyebabkan fungsi fn disebut
(kecuali jika pengguna memetakan ulang kunci dengan pengikatan lain).

nama argumen harus berupa string simbolis pendek. Ini memungkinkan pengguna untuk memetakan kembali
pengikatan kunci melalui input.conf menggunakan skrip_pesan perintah, dan nama
ikatan kunci (lihat di bawah untuk contoh). Nama harus unik di antara yang lain
binding dalam skrip yang sama - jika tidak, binding sebelumnya dengan nama yang sama akan
ditimpa. Anda dapat menghilangkan nama, dalam hal ini nama acak dihasilkan
secara internal.

Argumen terakhir digunakan untuk flag opsional. Ini adalah meja, yang dapat memiliki
entri berikut:

berulang
Jika diatur ke benar, memungkinkan pengulangan kunci untuk pengikatan khusus ini.

kompleks
Jika diatur ke benar, kemudian fn dipanggil pada acara tombol naik dan turun (juga
sebagai pengulangan kunci, jika diaktifkan), dengan argumen pertama berupa tabel. Ini
meja memiliki peristiwa entri, yang diatur ke salah satu string turun,
ulangi, up or pers (yang terakhir jika tombol atas/bawah tidak dapat dilacak). Dia
lebih lanjut memiliki is_mouse entri, yang memberi tahu apakah peristiwa itu disebabkan
oleh tombol mouse.

Secara internal, ikatan kunci dikirim melalui skrip_pesan_ke or pengikatan_skrip
perintah masukan dan mp.register_script_message.

Mencoba memetakan beberapa perintah ke kunci pada dasarnya akan lebih memilih pengikatan acak,
sedangkan binding lainnya tidak dipanggil. Dijamin bahwa pengguna ditentukan
binding di input.conf pusat lebih disukai daripada binding yang ditambahkan dengan ini
fungsi (tapi lihat mp.add_forced_key_binding).

Contoh:

fungsi something_handler()
print("tombol telah ditekan")
akhir
mp.add_key_binding("x", "sesuatu", sesuatu_handler)

Ini akan mencetak pesan itu kunci adalah ditekan ketika x ditekan.

Pengguna dapat memetakan kembali ikatan kunci ini. Kemudian pengguna harus memasukkan yang berikut ini ke dalam
input.conf-nya untuk memetakan kembali perintah ke y kunci:

y script_binding sesuatu

Ini akan mencetak pesan ketika kunci y ditekan. (x akan tetap bekerja, kecuali
pengguna memetakannya kembali.)

Anda juga dapat secara eksplisit mengirim pesan ke skrip bernama saja. Asumsikan di atas
skrip menggunakan nama file fooscript.lua:

y script_binding fooscript.sesuatu

mp.add_forced_key_binding(...)
Ini bekerja hampir sama dengan mp.add_key_binding, tetapi mendaftarkan pengikatan kunci di
cara yang akan menimpa binding kustom pengguna di input.conf-nya.
(mp.add_key_binding hanya menimpa binding kunci default, tetapi tidak dengan
masukan pengguna.conf.)

mp.remove_key_binding(nama)
Hapus ikatan kunci yang ditambahkan dengan mp.add_key_binding or mp.add_forced_key_binding.
Gunakan nama yang sama seperti yang Anda gunakan saat menambahkan binding. Tidak mungkin untuk menghapus
binding yang namanya Anda hilangkan.

mp.register_event(nama, fn)
Panggil fungsi tertentu ketika suatu peristiwa terjadi. Nama acara adalah string, dan
fungsi fn adalah nilai fungsi Lua.

Beberapa peristiwa memiliki data terkait. Ini dimasukkan ke dalam tabel Lua dan diteruskan sebagai
argumen untuk fn. Tabel Lua secara default berisi a nama bidang, yang merupakan string
berisi nama acara. Jika acara memiliki kesalahan yang terkait, kesalahan bidang adalah
set ke string yang menjelaskan kesalahan, pada keberhasilan itu tidak disetel.

Jika beberapa fungsi terdaftar untuk acara yang sama, mereka dijalankan di
urutan pendaftaran, yang fungsi terdaftar pertama berjalan sebelum semua
yang lain.

Mengembalikan nilai true jika peristiwa seperti itu ada, false jika tidak.

Lihat Kegiatan dan Daftar of peristiwa untuk rincian.

mp.unregister_event(fn)
membuka mp.register_event(..., fn). Ini menghapus semua event handler yang sama dengan
itu fn parameter. Ini menggunakan Lua biasa == perbandingan, jadi berhati-hatilah saat bertransaksi
dengan penutupan.

mp.observe_property(nama, jenis, fn)
Perhatikan properti untuk perubahan. Jika properti nama diubah, maka fungsinya
fn(nama) akan dipanggil. mengetik dapat nol, atau disetel ke salah satu dari tak satupun, asli, bool,
string, atau jumlah. tak satupun sama dengan nol. Untuk semua nilai lainnya, nilai baru dari
properti akan diteruskan sebagai argumen kedua untuk fn, Menggunakan mp.get_properti_
untuk mengambilnya. Ini berarti jika mengetik adalah contohnya string, fn secara kasar disebut sebagai
in fn(nama, mp.get_property_string(nama)).

Jika memungkinkan, acara perubahan digabungkan. Jika sebuah properti diubah beberapa kali
berturut-turut, hanya perubahan terakhir yang memicu fungsi perubahan. (Perilaku yang tepat
tergantung pada waktu dan hal-hal lain.)

Dalam beberapa kasus, fungsi tidak dipanggil bahkan jika properti berubah. Apakah
ini bisa terjadi tergantung pada properti.

Jika mengetik is tak satupun or nol, peristiwa perubahan properti sporadis dimungkinkan. Ini
berarti fungsi perubahan fn dapat dipanggil bahkan jika properti tidak benar-benar
berubah.

mp.unobserve_property(fn)
membuka mp.amati_properti(..., fn). Ini menghapus semua penangan properti yang
sama dengan fn parameter. Ini menggunakan Lua biasa == perbandingan, jadi berhati-hatilah saat
berurusan dengan penutupan.

mp.add_timeout(detik, fn)
Panggil fungsi yang diberikan fn ketika jumlah detik yang diberikan telah berlalu. Perhatikan bahwa
jumlah detik bisa pecahan. Untuk saat ini, resolusi pengatur waktu mungkin seperti
serendah 50 ms, meskipun ini akan ditingkatkan di masa mendatang.

Ini adalah pengatur waktu sekali pakai: itu akan dihapus saat diaktifkan.

Mengembalikan objek pengatur waktu. Melihat mp.add_periodic_timer untuk rincian.

mp.add_periodic_timer(detik, fn)
Panggil fungsi yang diberikan secara berkala. Ini seperti mp.add_timeout, tapi pengatur waktunya adalah
ditambahkan kembali setelah fungsi fn dijalankan.

Pengembalian a Timer obyek. Timer obyek menyediakan itu berikut metode:

berhenti() Nonaktifkan pengatur waktu. Tidak melakukan apa-apa jika pengatur waktu sudah dinonaktifkan.
Ini akan mengingat waktu yang telah berlalu saat ini ketika berhenti, sehingga
melanjutkan() dasarnya unpause timer.

membunuh() Nonaktifkan pengatur waktu. Mengatur ulang waktu yang telah berlalu. melanjutkan() akan memulai ulang
Timer.

melanjutkan()
Mulai ulang pengatur waktu. Jika pengatur waktu dinonaktifkan dengan berhenti(), ini akan
dilanjutkan pada saat dihentikan. Jika pengatur waktu dinonaktifkan dengan
membunuh(), atau jika itu adalah timer sekali tembak yang sebelumnya diaktifkan (ditambahkan dengan
tambah_waktu habis()), ini akan memulai penghitung waktu dari awal, menggunakan
batas waktu yang awalnya dikonfigurasi.

batas waktu (RW)
Bidang ini berisi periode waktu tunggu saat ini. Nilai ini tidak
diperbarui seiring berjalannya waktu. Ini hanya digunakan untuk menghitung ketika
timer harus menyala berikutnya ketika timer berakhir.

Jika Anda menulis ini, Anda dapat menelepon t: bunuh() ; t:lanjutkan() untuk mengatur ulang
batas waktu saat ini ke yang baru. (t:berhenti() tidak akan menggunakan batas waktu baru.)

oneshot (RW)
Apakah pengatur waktu itu periodik (palsu) atau menyala sekali saja (benar). Ini
nilai digunakan ketika penghitung waktu berakhir (tetapi sebelum panggilan balik penghitung waktu
fungsi fn dijalankan).

Perhatikan bahwa ini adalah metode, dan Anda harus memanggilnya menggunakan : alih-alih . (Lihat
untuk http://www.lua.org/manual/5.2/manual.html#3.4.9 .)

Contoh:

detik = 0
pengatur waktu = mp.add_periodic_timer(1, fungsi()
print("dipanggil setiap detik")
# hentikan setelah 10 detik
detik = detik + 1
jika detik >= 10 maka
pengatur waktu: bunuh ()
akhir
akhir)

mp.get_opt(kunci)
Kembalikan pengaturan dari --script-memilih pilihan. Terserah pengguna dan skrip
bagaimana mekanisme ini digunakan. Saat ini, semua skrip dapat mengakses ini secara merata, jadi Anda
harus berhati-hati terhadap benturan.

mp.get_script_name()
Kembalikan nama skrip saat ini. Nama biasanya dibuat dari nama file
skrip, dengan direktori dan ekstensi file dihapus. Jika ada beberapa skrip
yang akan memiliki nama yang sama, itu dibuat unik dengan menambahkan nomor.

Example

Naskah /path/ke/fooscript.lua menjadi skrip foo.

mp.osd_message(teks [,durasi])
Tampilkan pesan OSD di layar. lamanya dalam hitungan detik, dan bersifat opsional (menggunakan
--osd-durasi secara default).

Advanced mp fungsi
Ini juga tinggal di mp modul, tetapi didokumentasikan secara terpisah karena hanya berguna dalam
situasi khusus.

mp.menangguhkan()
Tangguhkan loop utama mpv. Ada penjelasan panjang lebar tentang ini di C API
fungsi mpv_suspend(). Singkatnya, ini mencegah pemain menampilkan yang berikutnya
bingkai video, sehingga Anda tidak terhalang saat mencoba mengakses pemutar.

Ini secara otomatis dipanggil oleh event handler.

mp.resume()
Batalkan satu mp.menangguhkan() panggilan. mp.menangguhkan() menambah penghitung internal, dan
mp.resume() menguranginya. Ketika 0 tercapai, pemain sebenarnya dilanjutkan.

mp.resume_all()
Ini mengatur ulang penghitung penundaan internal dan melanjutkan pemutar. (Ini seperti menelepon
mp.resume() sampai pemain benar-benar dilanjutkan.)

Anda mungkin ingin memanggil ini jika Anda akan melakukan sesuatu yang membutuhkan waktu lama,
tetapi tidak benar-benar membutuhkan akses ke pemutar (seperti operasi jaringan). Perhatikan bahwa
Anda masih dapat mengakses pemutar kapan saja.

mp.get_wakeup_pipe()
Panggilan mpv_get_wakeup_pipe() dan mengembalikan ujung baca dari pipa bangun. (Melihat
klien.h untuk detail.)

mp.get_next_timeout()
Kembalikan waktu relatif dalam detik ketika pengatur waktu berikutnya (mp.add_timeout dan
serupa) kedaluwarsa. Jika tidak ada pengatur waktu, kembalikan nol.

mp.dispatch_events([izinkan_tunggu])
Ini dapat digunakan untuk menjalankan loop acara khusus. Jika Anda ingin memiliki kontrol langsung apa
skrip Lua melakukannya (alih-alih dipanggil oleh loop acara default), Anda dapat
atur variabel global mp_event_loop ke fungsi Anda sendiri yang menjalankan loop acara.
Dari loop acara Anda, Anda harus menelepon mp.dispatch_events() untuk dequeue dan pengiriman
acara mpv.

Jika izinkan_tunggu parameter disetel ke benar, fungsi akan memblokir hingga berikutnya
acara diterima atau penghitung waktu berikutnya berakhir. Jika tidak (dan ini adalah default
behavior), ia kembali segera setelah loop acara dikosongkan. Ini kuat
direkomendasikan untuk digunakan mp.get_next_timeout() dan mp.get_wakeup_pipe() jika kamu
tertarik dengan pemberitahuan yang berfungsi dengan baik tentang acara baru dan pengatur waktu yang berfungsi.

Fungsi ini memanggil mp.menangguhkan() dan mp.resume_all() dengan dirinya sendiri.

mp.enable_messages(tingkat)
Atur level log minimum yang akan diterima oleh output pesan mpv. Pesan-pesan ini
biasanya dicetak ke terminal. Dengan memanggil fungsi ini, Anda dapat mengatur
level log minimum pesan yang harus diterima dengan log-pesan peristiwa.
Lihat deskripsi acara ini untuk detailnya. Levelnya adalah string, lihat pesan.log
untuk level log yang diizinkan.

mp.register_script_message(nama, fn)
Ini adalah pembantu untuk dikirim skrip_pesan or skrip_pesan_ke panggilan ke Lua
fungsi. fn disebut jika skrip_pesan or skrip_pesan_ke (dengan skrip ini sebagai
tujuan) dijalankan dengan nama sebagai parameter pertama. Parameter lainnya dilewatkan
untuk fn. Jika pesan dengan nama yang diberikan sudah terdaftar, itu akan ditimpa.

Digunakan oleh mp.add_key_binding, jadi berhati-hatilah dengan tabrakan nama.

mp.unregister_script_message(nama)
Batalkan pendaftaran sebelumnya dengan mp.register_script_message. Tidak melakukan apa-apa jika
nama tidak terdaftar.

mp.msg fungsi
Modul ini memungkinkan keluaran pesan ke terminal, dan dapat dimuat dengan membutuhkan
'mp.msg'.

msg.log(tingkat, ...)
Parameter level adalah prioritas pesan. Ini adalah string dan salah satunya fatal, kesalahan,
memperingatkan, Info, v, men-debug. Pengaturan pengguna akan menentukan pesan mana yang
akan terlihat. Biasanya, semua pesan terlihat, kecuali v dan men-debug.

Parameter setelah itu semua dikonversi ke string. Spasi dimasukkan ke
memisahkan beberapa parameter.

Anda tidak perlu menambahkan baris baru.

pesan.fatal(...), pesan.kesalahan(...), msg.peringatkan(...), pesan.info(...), pesan.verbose(...),
pesan.debug(...)
Semua ini adalah jalan pintas dan setara dengan yang sesuai msg.log(tingkat, ...)
panggilan.

mp.options fungsi
mpv dilengkapi dengan modul bawaan untuk mengelola opsi dari file konfigurasi dan baris perintah.
Yang harus Anda lakukan adalah menyediakan tabel dengan opsi default ke fungsi read_options.
Fungsi akan menimpa nilai default dengan nilai yang ditemukan di file konfigurasi dan
baris perintah (dalam urutan itu).

options.read_options(tabel [, pengenal])
A tabel dengan pasangan nilai kunci. Jenis nilai default penting untuk
mengonversi nilai yang dibaca dari file konfigurasi atau baris perintah kembali. Jangan gunakan
nol sebagai nilai default!

identifier digunakan untuk mengidentifikasi file konfigurasi dan opsi baris perintah.
Ini perlu unik untuk menghindari tabrakan dengan skrip lain. Default untuk
mp.get_script_name().

Contoh implementasi:

memerlukan 'mp.options'
opsi lokal = {
opsiA = "nilai defaultA",
opsiB = -0.5,
pilihanC = benar,
}
read_options(options, "myscript")
cetak(options.optionA)

File konfigurasi akan disimpan di lua-settings/identifier.conf di folder pengguna mpv.
Baris komentar dapat dimulai dengan # dan spasi tidak boleh dihapus. Nilai Boolean akan
diwakili dengan ya/tidak.

Contoh konfigurasi:

# komentar
optionA=Halo Dunia
opsiB=9999
pilihanC=tidak

Opsi baris perintah dibaca dari --script-memilih parameter. Untuk menghindari tabrakan, semua
kunci harus diawali dengan pengenal-.

Contoh baris perintah:

--script-opts=myscript-optionA=UJI,script-optionB=0,script-optionC=ya

mp.utils Pilihan
Modul bawaan ini menyediakan fungsi pembantu umum untuk Lua, dan secara tegas berbicara
tidak ada hubungannya dengan mpv atau pemutaran video/audio. Mereka disediakan untuk kenyamanan. Paling
mengkompensasi perpustakaan standar Lua yang langka.

Berhati-hatilah bahwa salah satu dari fungsi ini mungkin hilang kapan saja. Mereka tidak sepenuhnya menjadi bagian
dari API yang dijamin.

utils.getcwd()
Mengembalikan direktori tempat mpv diluncurkan. Pada kesalahan, nol, kesalahan dikembalikan.

utils.readdir(jalur [, Saring])
Hitung semua entri di jalur yang diberikan pada sistem file, dan kembalikan sebagai
Himpunan. Setiap entri adalah entri direktori (tanpa jalur). Daftar tidak disortir
(dalam urutan apa pun sistem operasi mengembalikannya).

Jika menyaring argumen diberikan, itu harus salah satu dari string berikut:

arsip Daftar file biasa saja. Ini tidak termasuk direktori, file khusus (seperti
file perangkat UNIX atau FIFO), dan symlink mati. Ini termasuk symlink UNIX
ke file biasa.

dirs Daftar direktori saja, atau symlink ke direktori. . dan .. tidak
disertakan.

normal Sertakan hasil keduanya arsip dan dirs. (Ini adalah default.)

semua Daftar semua entri, bahkan file perangkat, symlink mati, FIFO, dan . dan
.. entri.

Pada kesalahan, nol, kesalahan dikembalikan.

utils.split_path(jalur)
Pisahkan jalur menjadi komponen direktori dan komponen nama file, dan kembalikan. Itu
nilai pengembalian pertama selalu direktori. Nilai pengembalian kedua adalah trailing
bagian dari jalan, entri direktori.

utils.join_path(p1, hal2)
Kembalikan rangkaian 2 jalur. Mencoba menjadi pintar. Misalnya, jika `p2 is
jalur absolut, p2 dikembalikan tanpa perubahan.

utils.subproses(t)
Menjalankan proses eksternal dan menunggu sampai keluar. Mengembalikan status proses dan
keluaran yang ditangkap.

Parameter t adalah sebuah meja. Fungsi membaca entri berikut:

args Array string. Entri array pertama adalah yang dapat dieksekusi. Ini bisa jadi
baik jalur absolut, atau nama file tanpa komponen jalur, di mana
kasus PATH variabel lingkungan digunakan untuk menyelesaikan executable. Itu
elemen array lainnya dilewatkan sebagai argumen baris perintah.

dapat dibatalkan
Opsional. Jika diatur ke benar (default), maka jika pengguna menghentikan pemutaran atau
pergi ke file berikutnya saat proses sedang berjalan, prosesnya akan
terbunuh.

ukuran_maks
Opsional. Ukuran maksimum dalam byte data yang dapat diambil dari
stdout. (Bawaan: 16 MB.)

Fungsi mengembalikan tabel sebagai hasil dengan entri berikut:

status Status keluar mentah dari proses. Ini akan menjadi negatif pada kesalahan.

stdout Aliran keluaran yang ditangkap sebagai string, terbatas pada ukuran_maks.

kesalahan nol pada kesuksesan. string terbunuh jika proses dihentikan dalam
cara yang tidak biasa. string init jika proses tidak dapat dimulai.

Di Windows, terbunuh hanya dikembalikan ketika proses telah dimatikan oleh
mpv sebagai hasil dari dapat dibatalkan sedang diatur ke benar.

dibunuh_oleh_kita
Mulai benar jika proses telah dimatikan oleh mpv sebagai akibat dari
dapat dibatalkan sedang diatur ke benar.

Dalam semua kasus, mp.resume_all() secara implisit disebut.

utils.parse_json(str [, jejak])
Mem-parsing argumen string yang diberikan sebagai JSON, dan mengembalikannya sebagai tabel Lua. Pada kesalahan,
Pengembalian nol, kesalahan. (Saat ini, kesalahan hanya pembacaan string kesalahan, karena ada
tidak ada pelaporan kesalahan berbutir halus dalam bentuk apa pun.)

Nilai yang dikembalikan menggunakan konvensi serupa sebagai mp.get_property_native() untuk
membedakan objek kosong dan array.

Jika jejak parameternya adalah benar (atau nilai apa pun yang sama dengan benar), lalu mengikuti
teks non-spasi ditoleransi oleh fungsi, dan teks tambahan dikembalikan
sebagai nilai pengembalian ke-3. (Nilai pengembalian ke-3 selalu ada, tetapi dengan jejak atur, tidak
kesalahan dimunculkan.)

utils.format_json(v)
Format tabel Lua (atau nilai) yang diberikan sebagai string JSON dan kembalikan. Pada kesalahan,
Pengembalian nol, kesalahan. (Kesalahan biasanya hanya terjadi pada tipe nilai yang tidak sesuai dengan
JSON.)

Nilai argumen menggunakan konvensi serupa sebagai mp.set_property_native() untuk
membedakan objek kosong dan array.

utils.to_string(v)
Ubah nilai yang diberikan menjadi string. Memformat tabel dan isinya. Ini tidak
melakukan sesuatu yang istimewa; itu hanya diperlukan karena Lua mengerikan.

Kegiatan
Acara adalah pemberitahuan dari inti pemain ke skrip. Anda dapat mendaftarkan event handler
dengan mp.register_event.

Perhatikan bahwa semua skrip (dan bagian lain dari pemutar) menerima acara secara setara, dan ada
tidak ada yang namanya memblokir skrip lain dari menerima acara.

Contoh:

fungsi my_fn(acara)
print("mulai pemutaran!")
akhir

mp.register_event("file-loaded", my_fn)

Daftar of peristiwa
file awal
Terjadi tepat sebelum file baru dimuat. Ketika Anda menerima ini, pemainnya adalah
memuat file (atau mungkin sudah selesai dengan itu).

file akhir
Terjadi setelah file dibongkar. Biasanya, pemain akan memuat file berikutnya
segera, atau keluar jika ini adalah file terakhir.

Acara tersebut memiliki alasan bidang, yang mengambil salah satu dari nilai berikut:

eof Berkas telah berakhir. Ini dapat (tetapi tidak harus) menyertakan file yang tidak lengkap
atau koneksi jaringan yang rusak dalam keadaan tertentu.

berhenti Pemutaran diakhiri dengan perintah.

berhenti Pemutaran diakhiri dengan mengirimkan perintah quit.

kesalahan Terjadi kesalahan. Dalam hal ini, kesalahan bidang hadir dengan kesalahan
String.

redirect
Terjadi dengan daftar putar dan sejenisnya. Detail lihat MPV_END_FILE_REASON_REDIRECT
di C.API.

tidak dikenal
Tidak dikenal. Biasanya tidak terjadi, kecuali Lua API tidak sinkron dengan
C.API. (Demikian juga, bisa jadi skrip Anda mendapatkan string alasan yang
belum ada pada saat skrip Anda ditulis.)

dimuat file
Terjadi setelah file dimuat dan mulai diputar.

mencari Terjadi pada pencarian. (Ini mungkin termasuk kasus ketika pemain mencari secara internal,
bahkan tanpa interaksi pengguna. Ini termasuk misalnya perubahan segmen saat bermain
memerintahkan bab file Matroska.)

pemutaran-restart
Mulai pemutaran setelah pencarian atau setelah file dimuat.

siaga Mode siaga dimasukkan. Ini terjadi saat pemutaran berakhir, dan pemutar dimulai
dengan --menganggur or --force-jendela. Mode ini secara implisit berakhir ketika file awal or
penutupan peristiwa terjadi.

tick Dipanggil setelah bingkai video ditampilkan. Ini adalah peretasan, dan Anda harus menghindari
menggunakannya. Gunakan penghitung waktu sebagai gantinya dan mungkin tonton acara yang menjeda/membatalkan jeda untuk menghindari
membuang-buang CPU saat pemutar dijeda.

penutupan
Dikirim saat pemain berhenti, dan skrip harus dihentikan. Biasanya ditangani
secara otomatis. Melihat Rincian on itu naskah inisialisasi dan siklus hidup.

log-pesan
Menerima pesan diaktifkan dengan mp.enable_messages. Data pesan terkandung dalam
tabel dilewatkan sebagai parameter pertama ke event handler. Tabel tersebut berisi, dalam
Selain bidang acara default, bidang berikut:

awalan Awalan modul, mengidentifikasi pengirim pesan. Inilah yang
pemain terminal menempatkan di depan teks pesan saat menggunakan --v pilihan,
dan juga apa yang digunakan untuk --tingkat-pesan.

tingkat Tingkat log sebagai string. Melihat pesan.log untuk kemungkinan nama level log. Catatan
bahwa versi mpv yang lebih baru mungkin menambahkan level baru atau menghapus (tidak didokumentasikan)
yang sudah ada.

teks Pesan lognya. Teks akan diakhiri dengan karakter baris baru. Terkadang itu
dapat berisi beberapa baris.

Ingatlah bahwa pesan-pesan ini dimaksudkan sebagai petunjuk bagi manusia. Anda tidak harus
menguraikannya, dan awalan/tingkat/teks pesan dapat berubah sewaktu-waktu.

dapatkan-properti-balasan
Tidak berdokumen (tidak berguna untuk skrip Lua).

set-properti-balasan
Tidak berdokumen (tidak berguna untuk skrip Lua).

perintah-balasan
Tidak berdokumen (tidak berguna untuk skrip Lua).

pesan-klien
Tidak berdokumen (digunakan secara internal).

konfigurasi ulang video
Terjadi pada output video atau konfigurasi ulang filter.

konfigurasi ulang audio
Terjadi pada output audio atau konfigurasi ulang filter.

Peristiwa berikut juga terjadi, tetapi tidak digunakan lagi: trek-berubah, track-switch,
berhenti sebentar, batalkan jeda, pembaruan metadata, perubahan bab. Menggunakan mp.observe_property() sebagai gantinya.

ekstrak
Ini mendokumentasikan fitur eksperimental, atau fitur yang "terlalu istimewa" untuk menjamin a
antarmuka yang stabil.

mp.add_hook(ketik, prioritas, fn)
Tambahkan panggilan balik kait untuk mengetik (string yang mengidentifikasi jenis kait tertentu). Ini
kait memungkinkan pemain untuk memanggil fungsi skrip dan menunggu hasilnya
(biasanya, antarmuka skrip Lua tidak sinkron dari sudut pandang
inti pemain). prioritas adalah bilangan bulat arbitrer yang memungkinkan pemesanan di antara kait
dari jenis yang sama. Menggunakan nilai 50 direkomendasikan sebagai nilai default netral. fn is
fungsi yang akan dipanggil selama eksekusi hook.

Lihat kait untuk kait yang ada saat ini dan apa yang mereka lakukan - hanya daftar kait yang ada
menarik; menangani eksekusi hook dilakukan oleh fungsi skrip Lua
otomatis.

JSON IPC

mpv dapat dikontrol oleh program eksternal menggunakan protokol IPC berbasis JSON. Bisa jadi
diaktifkan dengan menentukan jalur ke soket unix menggunakan opsi --masukan-unix-soket.
Klien dapat terhubung ke soket ini dan mengirim perintah ke pemutar atau menerima acara dari
.

PERINGATAN:
Ini tidak dimaksudkan sebagai protokol jaringan yang aman. Secara eksplisit tidak aman: di sana
tidak ada otentikasi, tidak ada enkripsi, dan perintah itu sendiri juga tidak aman. Untuk
contoh, itu menjalankan perintah terbuka, yang dapat menjalankan perintah sistem sewenang-wenang. Itu
use-case mengendalikan pemain secara lokal. Ini tidak berbeda dengan MPlayer
protokol budak.

Socat contoh
Anda dapat menggunakan socat alat untuk mengirim perintah (dan menerima balasan) dari shell. Asumsi
mpv dimulai dengan:

file mpv.mkv --input-unix-socket=/tmp/mpvsocket

Kemudian Anda dapat mengontrolnya menggunakan socat:

> echo '{ "perintah": ["get_property", "waktu pemutaran"] }' | socat - /tmp/mpvsocket
{"data":190.482000,"error":"berhasil"}

Dalam hal ini, socat menyalin data antara stdin/stdout dan koneksi soket mpv.

Lihat --menganggur opsi bagaimana membuat mpv mulai tanpa segera keluar atau memutar file.

Anda juga dapat mengirim perintah teks saja gaya input.conf:

> echo 'show_text ${waktu pemutaran}' | socat - /tmp/mpvsocket

Tetapi Anda tidak akan mendapatkan balasan melalui soket. (Perintah khusus ini menunjukkan pemutaran
waktu pada OSD pemain.)

Protokol
Klien dapat menjalankan perintah pada pemutar dengan mengirimkan pesan JSON dalam bentuk berikut:

{ "perintah": ["nama_perintah", "param1", "param2", ...] }

dimana nama_perintah adalah nama perintah yang akan dieksekusi, diikuti dengan daftar
parameter. Parameter harus diformat sebagai nilai JSON asli (bilangan bulat, string,
boolean, ...). Setiap pesan harus diakhiri dengan \n. Selain itu, \n tidak harus muncul
di mana saja di dalam pesan. Dalam praktiknya, ini berarti bahwa pesan harus diperkecil
sebelum dikirim ke mpv.

mpv kemudian akan mengirim kembali balasan yang menunjukkan apakah perintah dijalankan dengan benar, dan
bidang tambahan yang menyimpan data pengembalian khusus perintah (bisa juga nol).

{ "kesalahan": "berhasil", "data": null }

mpv juga akan mengirim acara ke klien dengan pesan JSON dalam bentuk berikut:

{ "acara": "nama_acara" }

dimana nama_acara adalah nama acaranya. Bidang khusus acara tambahan juga dapat
hadiah. Melihat Daftar of peristiwa untuk daftar semua acara yang didukung.

Karena peristiwa dapat terjadi kapan saja, terkadang sulit untuk menentukan yang mana
respon berjalan dengan perintah yang mana. Perintah dapat secara opsional menyertakan a permintaan_id yang, jika
disediakan dalam permintaan perintah, akan disalin kata demi kata ke dalam respons. mpv tidak
menafsirkan permintaan_id dengan cara apapun; itu semata-mata untuk penggunaan pemohon.

Misalnya, permintaan ini:

{ "command": ["get_property", "time-pos"], "request_id": 100 }

Akan menghasilkan respons ini:

{ "kesalahan": "berhasil", "data": 1.468135, "request_id": 100 }

Semua perintah, balasan, dan acara dipisahkan satu sama lain dengan jeda baris
karakter (\n).

Jika karakter pertama (setelah melewati spasi) bukan {, perintahnya adalah
ditafsirkan sebagai perintah teks non-JSON, seperti yang digunakan di input.conf (atau
mpv_command_string() di API klien). Selain itu, baris yang dimulai dengan # dan kosong
garis diabaikan.

Saat ini, 0 byte yang disematkan mengakhiri baris saat ini, tetapi Anda tidak boleh mengandalkan ini.

Perintah
Selain perintah yang dijelaskan dalam Daftar of Memasukkan Perintah, beberapa perintah tambahan
juga dapat digunakan sebagai bagian dari protokol:

Nama Klien
Kembalikan nama klien sebagai string. Ini adalah string ipc-N dengan N menjadi
bilangan bulat.

dapatkan_time_us
Kembalikan waktu internal mpv saat ini dalam mikrodetik sebagai angka. Ini pada dasarnya
waktu sistem, dengan offset sewenang-wenang.

dapatkan_properti
Mengembalikan nilai dari properti yang diberikan. Nilai akan dikirim di bidang data
pesan ulang.

Contoh:

{ "perintah": ["get_property", "volume"] }
{ "data": 50.0, "kesalahan": "berhasil" }

dapatkan_properti_string
Seperti dapatkan_properti, tetapi data yang dihasilkan akan selalu berupa string.

Contoh:

{ "perintah": ["get_property_string", "volume"] }
{ "data": "50.000000", "kesalahan": "berhasil" }

set_properti
Tetapkan properti yang diberikan ke nilai yang diberikan. Melihat Properties untuk informasi lebih lanjut
tentang properti.

Contoh:

{ "perintah": ["set_property", "pause", true] }
{ "kesalahan": "berhasil" }

set_properti_string
Seperti set_properti, tetapi nilai argumen harus diteruskan sebagai string.

Contoh:

{ "perintah": ["set_property_string", "jeda", "ya"] }
{ "kesalahan": "berhasil" }

amati_properti
Perhatikan properti untuk perubahan. Jika sifat yang diberikan diubah, maka kejadian dari
mengetik perubahan properti akan dihasilkan

Contoh:

{ "perintah": ["observe_property", 1, "volume"] }
{ "kesalahan": "berhasil" }
{ "event": "property-change", "id": 1, "data": 52.0, "name": "volume" }

amati_properti_string
Seperti amati_properti, tetapi data yang dihasilkan akan selalu berupa string.

Contoh:

{ "perintah": ["observe_property_string", 1, "volume"] }
{ "kesalahan": "berhasil" }
{ "event": "property-change", "id": 1, "data": "52.000000", "name": "volume" }

unobserve_property
membuka amati_properti or amati_properti_string. Ini membutuhkan id numerik
diteruskan ke perintah observasi sebagai argumen.

Contoh:

{ "perintah": ["unobserve_property", 1] }
{ "kesalahan": "berhasil" }

permintaan_log_pesan
Aktifkan keluaran pesan log mpv. Mereka akan diterima sebagai acara. Parameternya
untuk perintah ini adalah level-log (lihat mpv_request_log_messages fungsi C.API).

Keluaran pesan log dimaksudkan hanya untuk manusia (kebanyakan untuk debugging). Mencoba untuk
mengambil informasi dengan menguraikan pesan-pesan ini hanya akan menyebabkan kerusakan dengan
rilis mpv masa depan. Sebagai gantinya, buat permintaan fitur, dan minta acara yang tepat
yang mengembalikan informasi yang Anda butuhkan.

aktifkan_acara, nonaktifkan_event
Mengaktifkan atau menonaktifkan acara bernama. Mencerminkan mpv_request_event fungsi C.API.
Jika string semua digunakan sebagai ganti nama acara, semua acara diaktifkan atau
dengan disabilitas.

Secara default, sebagian besar acara diaktifkan, dan perintah ini tidak banyak digunakan.

menangguhkan
Tangguhkan loop utama mpv. Ada penjelasan panjang lebar tentang ini di C API
fungsi mpv_suspend(). Singkatnya, ini mencegah pemain menampilkan yang berikutnya
bingkai video, sehingga Anda tidak terhalang saat mencoba mengakses pemutar.

lanjut Batalkan satu menangguhkan panggilan. menangguhkan menambah penghitung internal, dan lanjut
menguranginya. Ketika 0 tercapai, pemain sebenarnya dilanjutkan.

dapatkan_versi
Mengembalikan versi API klien yang disediakan oleh C API dari instance mpv jarak jauh. (Juga
melihat DOCS/client-api-changes.rst.)

UTF-8
Biasanya, semua string dalam UTF-8. Terkadang bisa terjadi bahwa string ada di beberapa
pengkodean rusak (sering terjadi dengan tag file dan semacamnya, dan nama file di banyak Unix adalah
tidak harus dalam UTF-8 juga). Ini berarti mpv terkadang mengirimkan JSON yang tidak valid. Jika
itu masalah untuk pengurai aplikasi klien, itu harus menyaring data mentah untuk
urutan UTF-8 tidak valid dan lakukan penggantian yang diinginkan, sebelum memasukkan data ke
pengurai JSON-nya.

mpv tidak akan mencoba membuat UTF-8 yang tidak valid dengan urutan escape yang rusak.

CHANGELOG

Tidak ada changelog nyata, tetapi Anda dapat melihat hal-hal berikut:

· Log perubahan rilis, yang harus berisi sebagian besar perubahan yang terlihat oleh pengguna, termasuk yang baru
fitur dan perbaikan bug:

https://github.com/mpv-player/mpv/releases

· Log git, yang merupakan changelog "asli"

· Berkas mplayer-perubahan. pertama dalam DOCS sub direktori pada repositori git, yang digunakan
untuk menggantikan bagian ini. Ini mendokumentasikan beberapa perubahan yang terjadi sejak mplayer2
bercabang dari MPlayer.

MENYEBABKAN KE LAIN PROGRAM (LIBMPV)

mpv dapat disematkan ke program lain sebagai backend pemutaran video/audio. Direkomendasikan
cara untuk melakukannya adalah menggunakan libmpv. Melihat libmpv/client.h dalam repositori kode sumber mpv. Ini
menyediakan API C. Binding untuk bahasa lain mungkin tersedia (lihat wiki).

LINGKUNGAN VARIABEL

Ada sejumlah variabel lingkungan yang dapat digunakan untuk mengontrol perilaku
mpv.

RUMAH, XDG_CONFIG_HOME
Digunakan untuk menentukan direktori konfigurasi mpv. Jika XDG_CONFIG_HOME tidak diatur,
$HOME/.config/mpv digunakan.

$HOME/.mpv selalu ditambahkan ke daftar jalur pencarian konfigurasi dengan yang lebih rendah
prioritas.

XDG_CONFIG_DIRS
Jika disetel, direktori konfigurasi sistem gaya XDG akan digunakan. Jika tidak, UNIX
Konvensi (KAWASAN/etc/mpv/) digunakan.

JANGKA Digunakan untuk menentukan tipe terminal.

MPV_HOME
Direktori tempat mpv mencari pengaturan pengguna. Mengganti HOME, dan mpv akan mencoba
muat file konfigurasi sebagai $MPV_HOME/mpv.conf.

MPV_VERBOSE (Lihat juga -v dan --tingkat-pesan)
Atur tingkat verbositas awal di semua modul pesan (default: 0). Ini adalah
bilangan bulat, dan verbositas yang dihasilkan sesuai dengan jumlah --v Pilihan
diteruskan ke baris perintah.

MPV_LEAK_LAPORAN
Jika diatur ke 1, aktifkan pelaporan kebocoran talloc internal. Perhatikan bahwa ini dapat menyebabkan
masalah dengan multithreading, jadi hanya pengembang yang harus menggunakan ini.

LADSPA_PATH
Menentukan jalur pencarian untuk plugin LADSPA. Jika tidak disetel, jalur yang sepenuhnya memenuhi syarat
nama harus digunakan.

DISPLAY
Nama tampilan X11 standar untuk digunakan.

FFmpeg/Libav:
Pustaka ini mengakses berbagai variabel lingkungan. Namun, mereka tidak
didokumentasikan secara terpusat, dan mendokumentasikannya bukanlah tugas kami. Oleh karena itu, daftar ini adalah
tidak lengkap.

Variabel lingkungan yang terkenal:

http_proxy
URL ke proxy untuk http:// dan https:// URL.

no_proxy
Daftar pola domain yang tidak boleh menggunakan proxy. Daftar entri adalah
dipisahkan oleh ,. Pola dapat mencakup: *.

libdvdcss:

DVDCSS_CACHE
Tentukan direktori tempat menyimpan nilai kunci judul. Ini akan mempercepat
penguraian DVD yang ada di cache. Itu DVDCSS_CACHE direktori adalah
dibuat jika tidak ada, dan subdirektori dibuat dengan nama
Judul DVD atau tanggal pembuatan. Jika DVDCSS_CACHE tidak disetel atau kosong,
libdvdcss akan menggunakan nilai default yaitu ${HOME}/.dvdcss/ di bawah Unix
dan direktori data aplikasi roaming (% APPDATA%) di bawah Windows. Itu
nilai khusus "mati" menonaktifkan caching.

DVDCSS_METHOD
Menyetel metode autentikasi dan dekripsi yang akan digunakan libdvdcss untuk
membaca cakram acak. Bisa menjadi salah satu judul, kunci or cakram.

kunci adalah metode default. libdvdcss akan menggunakan satu set pemutar yang dihitung
kunci untuk mencoba dan mendapatkan kunci disk. Ini bisa gagal jika drive tidak
mengenali salah satu tombol pemain.

cakram adalah metode mundur ketika kunci gagal. Alih-alih menggunakan pemain
kunci, libdvdcss akan memecahkan kunci disk menggunakan kekuatan kasar
algoritma. Proses ini intensif CPU dan membutuhkan memori 64 MB
untuk menyimpan data sementara.

judul adalah mundur ketika semua metode lain gagal. Itu tidak bergantung
pada pertukaran kunci dengan drive DVD, melainkan menggunakan serangan kripto
untuk menebak kunci judul. Pada kasus yang jarang terjadi, ini mungkin gagal karena ada
tidak cukup data terenkripsi pada disk untuk melakukan statistik
menyerang, tetapi di sisi lain itu adalah satu-satunya cara untuk mendekripsi DVD
disimpan di hard disk, atau DVD dengan wilayah yang salah pada RPC2
mengemudi.

DVDCSS_RAW_DEVICE
Tentukan perangkat mentah yang akan digunakan. Penggunaan yang tepat akan tergantung pada operasi Anda
sistem, utilitas Linux untuk mengatur perangkat mentah adalah mentah(8) misalnya.
Harap dicatat bahwa pada sebagian besar sistem operasi, menggunakan perangkat mentah memerlukan
buffer yang sangat selaras: Linux membutuhkan penyelarasan 2048 byte (yang merupakan
ukuran sektor DVD).

DVDCSS_VERBOSE
Menyetel tingkat verbositas libdvdcss.

0 Tidak mengeluarkan pesan sama sekali.

1 Menampilkan pesan kesalahan ke stderr.

2 Menampilkan pesan kesalahan dan pesan debug ke stderr.

DVDREAD_NOKEYS
Lewati pengambilan semua kunci saat startup. Saat ini dinonaktifkan.

HOME FIXME: Dokumentasikan ini.

EXIT KODE

Biasanya mpv mengembalikan 0 sebagai kode keluar setelah menyelesaikan pemutaran dengan sukses. Jika kesalahan
terjadi, kode keluar berikut dapat dikembalikan:

1 Kesalahan saat menginisialisasi mpv. Ini juga dikembalikan jika opsi yang tidak diketahui diteruskan ke
mpv.

2 File yang diteruskan ke mpv tidak dapat diputar. Ini agak kabur: saat ini,
pemutaran file dianggap berhasil jika inisialisasi sebagian besar
berhasil, bahkan jika pemutaran gagal segera setelah inisialisasi.

3 Ada beberapa file yang bisa diputar, dan ada beberapa file yang tidak bisa (menggunakan
definisi sukses dari atas).

4 Keluar karena sinyal, Ctrl+c di jendela VO (secara default), atau dari default
keluar dari ikatan kunci dalam mode penyandian.

Perhatikan bahwa keluar dari pemain secara manual akan selalu mengarah ke kode keluar 0, mengesampingkan
kode keluar yang akan dikembalikan secara normal. Juga berhenti perintah input dapat mengambil jalan keluar
kode: dalam hal ini, kode keluar itu dikembalikan.

Gunakan mpv online menggunakan layanan onworks.net