mpv

プログラム：

NAME

mpv-メディアプレーヤー

SYNOPSIS

mpv [オプション] [ファイル| URL |プレイリスト|-]
mpv [オプション]ファイル

DESCRIPTION

mpv MPlayerとmplayer2をベースにしたメディアプレーヤーです。 多種多様なビデオをサポートします
ファイル形式、オーディオおよびビデオコーデック、および字幕タイプ。 特別な入力URLタイプは
ディスクファイル以外のさまざまなソースからの入力を読み取ることができます。 応じて
プラットフォームでは、さまざまなビデオおよびオーディオ出力方法がサポートされています。

すぐに使い始めるための使用例は、このマニュアルページの最後にあります。

インタラクティブ CONTROL

mpvには、完全に構成可能なコマンド駆動型の制御レイヤーがあり、mpvを制御できます。
キーボード、マウス、またはリモートコントロールを使用する（LIRCサポートはありません-リモートを次のように構成します）
代わりに入力デバイス）。

ジョブの設定方法については、 - 入力- それをカスタマイズする方法のオプション。

キーボード 管理
LEFT および RIGHT
後方/前方に5秒間シークします。 Shift +矢印は、1秒の正確なシークを実行します（を参照）
--hr-シーク).

UP および ダウン
前方/後方に1分間シークします。 Shift +矢印は、5秒の正確なシークを実行します（を参照）
--hr-シーク).

Ctrl + LEFT および Ctrl + Right
前/次の字幕を探します。 いくつかの制限があり、機能しない可能性があります
いつも; 見る サブシーク

[ および ]
現在の再生速度を10％増減します。

{ および }
現在の再生速度を半分またはXNUMX倍にします。

BackSpaceキー
再生速度を通常にリセットします。

< および >
プレイリストを前後に移動します。

ENTER プレイリストを進めます。

p / SPACE
一時停止（もう一度押すと一時停止が解除されます）。

. 踏み出す。 XNUMX回押すと一時停止し、連続して押すたびにXNUMXフレーム再生されます
その後、再び一時停止モードに入ります。

, 後退します。 XNUMX回押すと一時停止し、連続して押すたびにXNUMX回再生されます
フレームを逆にしてから、再び一時停止モードに入ります。

q 再生を停止して終了します。

Q いいね q、ただし、現在の再生位置を保存します。 後で同じファイルを再生すると
可能であれば、古い再生位置から再開します。

/ および *
音量を下げる/上げます。

9 および 0
音量を下げる/上げます。

m ミュート音。

_ 利用可能なビデオトラックを循環します。

# 利用可能なオーディオトラックを循環します。

f フルスクリーンを切り替えます（「 --fs).

ESC フルスクリーンモードを終了します。

T ステイオントップを切り替えます（も参照してください） --上に).

w および e
パンアンドスキャン範囲を縮小/拡大します。

o （また、 P)
OSDにプログレスバー、経過時間、合計時間を表示します。

O OSD状態を通常と再生時間/期間の間で切り替えます。

v 字幕の表示を切り替えます。

j および J
利用可能な字幕を循環します。

x および z
字幕の遅延を+/- 0.1秒調整します。

l ABループポイントを設定/クリアします。 見る アブループ 詳細についてはコマンド。

L 無限ループを切り替えます。

Ctrlキー + および Ctrlキー -
オーディオ遅延を+/- 0.1秒調整します。

u SSA / ASS字幕にスタイルオーバーライドを適用しないことと、オーバーライドすることを切り替えます
それらは通常の字幕スタイルでほぼ完全に。 見る --ass-style-override の
より詳しい情報。

V 字幕VSFilterアスペクト互換モードを切り替えます。 見る
--ass-vsfilter-aspect-compat 詳細はこちら

r および t
字幕を上下に移動します。

s スクリーンショットを撮ります。

S 字幕なしでスクリーンショットを撮ります。 （これが機能するかどうかはVOドライバーによって異なります
サポート。）

Ctrlキー s ウィンドウに表示されているスクリーンショットを撮ります（字幕、OSD、拡大縮小されたビデオを含む）。

I OSDにファイル名を表示します。

PGUP および PGD​​WN
前/次の章の最初に進んでください。 ほとんどの場合、「前の」は
実際には、現在の章の最初に移動します。 見る --章シークしきい値.

Shift + PGUP および Shift + PGDWN
10分ずつ後方または前方にシークします。 （これは、PGUP / PGDWNにマップされていました
Shiftなし。）

d デインターレーサーをアクティブ化/非アクティブ化します。

A サイクルアスペクト比のオーバーライド。

（以下のキーは、をサポートするビデオ出力を使用する場合にのみ有効です。
対応する調整、またはソフトウェアイコライザー（--vf = eq））

1 および 2
コントラストを調整します。

3 および 4
明るさを調整します。

5 および 6
ガンマを調整します。

7 および 8
彩度を調整します。

Altキー+ 0 （と コマンド+0 on OSX）
ビデオウィンドウのサイズを元のサイズの半分に変更します。

Altキー+ 1 （と コマンド+1 on OSX）
ビデオウィンドウのサイズを元のサイズに変更します。

Altキー+ 2 （と コマンド+2 on OSX）
ビデオウィンドウのサイズを元のサイズのXNUMX倍に変更します。

command + f （OSX のみ）
フルスクリーンを切り替えます（「 --fs).

command + [ および command + ] （OSX のみ）
ビデオウィンドウのアルファを設定します。

（以下のキーは、マルチメディアキーを備えたキーボードを使用している場合に有効です。）

PAUSE 一時停止する。

STOP 再生を停止して終了します。

PREVIOUS および NEXT
後方/前方に1分間シークします。

（以下のキーは、TVまたはDVB入力サポートを使用してコンパイルした場合にのみ有効です。）

h および k
前/次のチャンネルを選択します。

マウス 管理
(Comma Separated Values) ボタンをクリックして、各々のジョブ実行の詳細（開始/停止時間、変数値など）のCSVファイルをダウンロードします。 3 および (Comma Separated Values) ボタンをクリックして、各々のジョブ実行の詳細（開始/停止時間、変数値など）のCSVファイルをダウンロードします。 4
後方/前方に1分間シークします。

(Comma Separated Values) ボタンをクリックして、各々のジョブ実行の詳細（開始/停止時間、変数値など）のCSVファイルをダウンロードします。 5 および (Comma Separated Values) ボタンをクリックして、各々のジョブ実行の詳細（開始/停止時間、変数値など）のCSVファイルをダウンロードします。 6
音量を下げる/上げます。

USAGE

あらゆる フラグ オプションには フラグなし 対応するもの、例えば、 --fs オプションがある
--no-fs. --fs = yes と同じです --fs, --fs = no と同じです。 --no-fs.

オプションがとしてマークされている場合 （XXX のみ）、それはと組み合わせてのみ機能します XXX オプション
または XXX でコンパイルされます。

逃げる スペース および その他 特別 文字
シェルは、mpvに渡す引数を部分的に解析してマングルすることに注意してください。
たとえば、オプションとファイル名を引用符またはエスケープする必要がある場合があります。
mpv "ファイル名 　 space.mkv " --title = "ウィンドウ タイトル"

サブオプションパーサーが含まれる場合は、さらに複雑になります。 サブオプションパーサーは
複数のオプションをXNUMXつの文字列にまとめ、それらをコンポーネントに一度に渡すのではなく、
コマンドラインのレベルで複数のオプションを使用します。

サブオプションパーサーは、次の文字列を引用できます " および [...]。 さらに、特別なものがあります
引用の形式 ％n％ 以下で説明します。

例えば、 OpenGLの VOは複数のオプションを選択できます。
mpv test.mkv --vo = opengl：scale = lanczos：icc-profile = file.icc、xv

これは合格です scale = lanczos および icc-profile = file.icc 〜へ OpenGLの、およびも指定します xv as
フォールバックVO。 icc-profileパスにスペースまたは次のような文字が含まれている場合 , or :、あなたが必要です
それらを引用するには：
mpv '--vo = opengl：icc-profile = "file 　 space.icc "、xv '

シェルは実際にコマンドラインに渡された文字列からいくつかの引用符を取り除く可能性があるため、
例では、文字列をXNUMX回引用し、mpvが " 引用。

当学校区の [...] 引用符の形式は、すべてをラップします [ および ]。 シェルで便利です
引数の途中でこれらの文字を解釈しないでください（bashなど）。 これらの引用
バランスが取れている（mpv 0.9.0以降）： [ および ] ネストし、引用は最後に終了します ]
一致するものがありません [ 文字列内。 （例えば、 [a [b] c] 結果は a [b] c.)

固定長の引用符の構文は、外部のスクリプトおよびプログラムで使用することを目的としています。

それはで始まります % 次の形式があります。

％n％string_of_length_n

例

mpv --ao = pcm：file =％10％C：test.wav test.avi

またはスクリプトで：

mpv --ao = pcm：file =％ `expr 長さ "$ NAME" `％" $ NAME " test.avi

クライアントAPIに渡されるサブオプションも、エスケープの対象になります。 使用する
mpv_set_option_string（） 通過するのとまったく同じです --name = data コマンドラインに（ただし
文字列のシェル処理なし）。 一部のオプションは、より多くの値の受け渡しをサポートしています
フラットストリングの代わりに構造化された方法であり、サブオプションの解析の混乱を回避できます。 にとって
例、 --vf サポート MPV_FORMAT_NODE、サブオプションをネストされたデータとして渡すことができます
マップと配列の構造。 （（--vo この事実はですが、同じようにこれをサポートしています
文書化されていません。）

パス
任意のパスとファイル名をmpvに渡すときは、注意が必要です。 例えば、
で始まるパス - オプションとして解釈されます。 同様に、パスに
シーケンス :/ /、その前の文字列は、プロトコルプレフィックスとして解釈される可能性がありますが
:/ / 正当なUNIXパスの一部にすることができます。 任意のパスの問題を回避するには、次のことを行う必要があります
mpvに渡される絶対パスがで始まることを確認してください /、および相対パス ./.

名 - それ自体はstdinとして解釈され、mpvがコンソールコントロールを無効にします。
（これにより、stdinにパイプされたデータの再生に適しています。）

サブオプションに渡されるパスの場合、エスケープする必要があるため、状況はさらに複雑になります。
特殊文字。 これを回避するために、パスを追加でラップすることができます
固定長構文、例： ％n％string_of_length_n （上記を参照）。

一部のmpvオプションは、で始まるパスを解釈します ~。 現在、プレフィックス ~~ / に展開します
mpv構成ディレクトリ（通常は 〜/ .config / mpv /). ~/ ユーザーの自宅に拡張
ディレクトリ。 （末尾 / 常に必要です。）次のパスもあります。

┌──────────────┬────────────────────────────────┐
│名前│意味│
└──────────────┴────────────────────────────────┘

│~~ home / │と同じ ~~ / │
├──────────────┼────────────────────────────────┤
│~~グローバル/ │グローバル設定パス（│の場合）
││利用可能（win32にはない）│
├──────────────┼────────────────────────────────┤
│~~ osxbundle / │OSXバンドルリソースパス│
││（OSXのみ）│
├──────────────┼────────────────────────────────┤
│~~デスクトップ/ │デスクトップへのパス（win32、│
││OSX）│
└──────────────┴────────────────────────────────┘

ファイルごと オプション
複数のファイルを再生する場合、コマンドラインで指定されたオプションは通常すべてに影響します
ファイル。 例：

mpv --a ファイル 1.mkv --b ファイル 2.mkv --c

┌─────┬───────┐
│ファイル│アクティブなオプション│
§─────┼───────┤
│file1.mkv│ - NS - NS - NS │
§─────┼───────┤
│file2.mkv│ - NS - NS - NS │
━─────┴───────┘

（これはMPlayerやmplayer2とは異なります。）

また、実行時に（入力コマンドを介して）オプションが変更された場合、それらは次の場合にリセットされません。
新しいファイルが再生されます。

ファイルごとにオプションを変更すると便利な場合があります。 これは、を追加することで実現できます。
特別なファイルごとのマーカー -{ および -}。 （一部のシェルではこれらをエスケープする必要があることに注意してください。）
例：

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

┌──────────┬──────────────────────────┐
│ファイル│アクティブなオプション│
├──────────┼──────────────────────────┤
│file1.mkv│ - NS - NS - NS │
├──────────┼──────────────────────────┤
│file2.mkv│ - NS - NS - NS - NS - NS --e │
├──────────┼──────────────────────────┤
│file3.mkv│ - NS - NS - NS - NS - NS --e │
├──────────┼──────────────────────────┤
│file4.mkv│ - NS - NS - NS │
└──────────┴──────────────────────────┘

さらに、実行時に変更されたファイルローカルオプションは、現在のファイルがリセットされるとリセットされます。
再生を停止します。 オプションの場合 - NS 再生中に変更されます ファイル2.mkv、次の場合にリセットされます
に進む ファイル3.mkv。 これは、ファイルローカルオプションにのみ影響します。 オプション - NS 決してない
ここでリセットします。

CONFIGURATION ファイル

位置の特定 および 構文
mpvが実行されるたびに読み取られる構成ファイルにすべてのオプションを入れることができます
走る。 システム全体の設定ファイル「mpv.conf」は設定ディレクトリにあります
（例えば / etc / mpv or / usr / local / etc / mpv）、ユーザー固有のものは 〜/ .config / mpv / mpv.conf.
詳細とプラットフォームの詳細（特にWindowsパス）については、 ファイル のセクションから無料でダウンロードできます。

ユーザー固有のオプションは、システム全体のオプションおよびコマンドラインで指定されたオプションを上書きします
どちらかをオーバーライドします。 構成ファイルの構文は次のとおりです。 option = value。 後のすべて
# コメントと見なされます。 値なしで機能するオプションは、値を設定することで有効にできます
〜へ はい に設定して無効にします いいえ。 サブオプションもこの方法で指定できます。

構成ファイルの例

＃デフォルトでopenglビデオ出力を使用します。
vo = opengl
＃スペースを含めることができるテキストには引用符を使用します。
status-msg = "時間：$ {time-pos}"

逃げる スペース および 特別 文字
これは、コマンドラインオプションの場合と同じように行われます。 シェルはここには含まれていませんが、オプション
スペースなどの特定の文字が含まれている場合でも、値全体を引用符で囲む必要があります。 A
構成エントリは次のように引用できます "、および固定長構文（％n％） 言及された
前。 これは、引用符で囲まれた文字列の正確な内容をコマンドラインとして渡すようなものです。
オプション。 Cスタイルのエスケープは現在、このレベルでは解釈されませんが、一部のエスケープは解釈されません。
オプションはこれを手動で行います。 （これは混乱であり、おそらくある時点で変更する必要があります。）

パッティング Command LINE オプション に 　 　 File
ほとんどすべてのコマンドラインオプションを構成ファイルに入れることができます。 ここに小さな
ガイド：

┌──────────────────┬────────────────────────┐
│オプション│設定ファイルエントリ│
├──────────────────┼────────────────────────┤
│- 国旗 │ フラグ │
├──────────────────┼────────────────────────┤
│-選択する ヴァル │ opt = val │
├──────────────────┼────────────────────────┤
│--opt = val │ opt = val │
├──────────────────┼────────────────────────┤
│-選択する "もっている スペース」 │ opt = "は スペース」 │
└──────────────────┴────────────────────────┘

ファイル固有 　
ファイル固有の構成ファイルを作成することもできます。 構成が必要な場合
'video.avi'という名前のファイルのファイル、 'video.avi.conf'という名前のファイルを作成します。
その中のファイル固有のオプションとそれを入れます 〜/ .config / mpv /。 置くこともできます
再生するファイルと同じディレクトリにある構成ファイル。 どちらも設定する必要があります
　 --use-filedir-conf オプション（コマンドラインまたはグローバル構成ファイルのいずれか）。
同じディレクトリにファイル固有の構成ファイルが見つかった場合、ファイル固有の構成ファイルはありません
構成はからロードされます 〜/ .config / mpv。 また、 --use-filedir-conf オプション
ディレクトリ固有の構成ファイルを有効にします。 このため、mpvは最初に
再生されたファイルと同じディレクトリからのmpv.confは、
ファイル固有の構成。

対応プロファイル
さまざまな構成での作業を容易にするために、プロファイルをで定義できます。
構成ファイル。 プロファイルは、角かっこで囲まれた名前で始まります。例： [私のプロフィール].
以下のすべてのオプションは、プロファイルの一部になります。 説明（ --profile = help)
で定義することができます プロファイル-説明 オプション。 プロファイルを終了するには、別のプロファイルを開始するか、
プロファイル名 デフォルト 通常のオプションを続行します。

プロファイルを含むmpv設定ファイルの例

＃通常のトップレベルオプション
fullscreen = yes

＃-profile = big-cacheで有効にできるプロファイル
[ビッグキャッシュ]
cache = 123400
demuxer-readahead-secs = 20

[スロー]
profile-desc = "いくつかのプロファイル名"
vo = opengl：scale = ewa_lanczos：scale-radius = 16

[速い]
vo = vdpau

＃プロファイルを再度使用すると、プロファイルが拡張されます
[スロー]
framedrop = no
＃他のプロファイルを含めることもできます
profile = big-cache

自動応答オプション プロファイル
一部のプロファイルは自動的にロードされます。 次の例はこれを示しています。

自動プロファイル読み込み

[vo.vdpau]
＃ハードウェアデコードを使用する
hwdec = vdpau

【プロトコル.DVD】
profile-desc = "dvd：//ストリームのプロファイル"
alang = en

[拡張子.flv]
profile-desc = ".flvファイルのプロファイル"
vf = flip

[あおアルサ]
device = spdif

プロファイル名はスキーマに従います タイプ名、タイプは vo 値を一致させるには
--vo オプションがに設定されている、 ao の --あお, 使用中の入出力プロトコルについて（を参照）
--list-プロトコル）、及び 現在再生されているパスの延長用
ファイル（ ファイル形式）。

この機能は非常に制限されており、他の自動プロファイルはありません。

取る スクリーンショットは

現在再生されているファイルのスクリーンショットは、「スクリーンショット」入力モードを使用して撮影できます
コマンド。デフォルトでは、 s 鍵。 名前の付いたファイル ショットNNNN.jpg に保存されます
作業ディレクトリ。最初に使用可能な番号を使用します。ファイルは上書きされません。

スクリーンショットには通常、ビデオの最後にスケーリングされていないビデオコンテンツが含まれています
フィルターチェーンと字幕。 デフォルトでは、 S 字幕なしのスクリーンショットを撮りますが s
字幕が含まれています。

MPlayerとは異なり、 スクリーンショット ビデオフィルターは必要ありません。 このフィルターは決してありませんでした
mpvで必要であり、削除されました。

ターミナル ステータス LINE

再生中、mpvは端末の再生状態を表示します。 何かのように見えます
このような：
AV： 00:03:12 / 00:24:25 （13％）を AV： -0.000

ステータス行は、 --term-status-msg オプションを選択します。

以下は、ステータス行に表示される可能性のあるもののリストです。 入力プロパティ、
同じ情報を手動で取得するために使用できるものもリストされています。

· AV： or V: （ビデオのみ）または A: （音声のみ）

・現在の時刻位置 HH：MM：SS フォーマット （再生時間 プロパティ）

・ファイルの合計期間（不明な場合は存在しません）（長さ プロパティ）

・再生速度、例： `` x2.0``。 速度が正常でない場合にのみ表示されます。 これは
実際の速度ではなく、ユーザーが要求した速度（通常、これらは同じである必要があります。
再生が遅すぎます）。 （（スピード プロパティ。)

・再生率、例： （13％）を。 ファイルのどれだけが再生されたか。 通常は
再生位置と継続時間から計算されますが、他の方法にフォールバックできます
（バイト位置のように）これらが利用できない場合。 （（パーセント位置 プロパティ。)

・オーディオ/ビデオ同期として AV： 0.000。 これがオーディオとビデオの違いです
時間。 通常は0または0に近いはずです。成長している場合は、
再生の問題。 （（avsync プロパティ。)

・合計A / V同期の変更、例： ct： -0.417。 通常は見えません。 ある場合は表示できます
オーディオが「欠落」しているか、十分なフレームがドロップされない可能性があります。 通常、これは
問題。 （（総 avsync 変更 プロパティ。)

・エンコーディング状態 {...}、エンコーディングモードでのみ表示されます。

・同期状態を表示します。 表示同期がアクティブな場合（ディスプレイ同期アクティブ プロパティ）、これは表示されます
DS： 2.500/13、ここで、最初の数値はビデオフレームあたりのvsyncの平均数です（例：
2.5 24Hz画面で60Hzビデオを再生する場合）、比率が調整されない場合、ジッターが発生する可能性があります
四捨五入するか、フレームのタイミングがずれています（垂直同期比）、およびXNUMX番目の数
時間がかかりすぎたvsyncの推定数（vo-遅延フレーム数 財産）。 The
後者はヒューリスティックです。これを確実に判断することは一般的に不可能だからです。

・ドロップされたフレーム、例： ドロップ： 4。 カウントが0でない場合にのみ表示されます。
ビデオのフレームレートがディスプレイのフレームレートよりも高い場合、またはビデオのレンダリングが遅すぎる場合。
また、「しゃっくり」やビデオフレームを表示できなかった場合にもインクリメントできます。
時間。 （（vo-drop-frame-count プロパティ。）デコーダがフレームをドロップする場合、
デコーダーがドロップしたフレームもディスプレイに追加されます。例： ドロップ： 4/34。 この
デコーダフレームのドロップが有効になっている場合にのみ発生します --フレームドロップ オプション。
(ドロップフレームカウント プロパティ。)

・キャッシュの状態、例： キャッシュ： 2秒+ 134KB。 ストリームキャッシュが有効になっている場合に表示されます。 最初
値は、デマルチプレクサにバッファリングされたビデオの量を秒単位で示し、XNUMX番目の値は
ショー 追加の キロバイト単位でストリームキャッシュにバッファリングされたデータ。 （（デマルチプレクサーキャッシュ期間
および キャッシュ使用 プロパティ。）

プロトコル

http://..., https://, ...
多くのネットワークプロトコルがサポートされていますが、プロトコルプレフィックスは常に
指定。 mpvは、ファイル名が実際にネットワークであるかどうかを推測しようとはしません
住所。 プロトコルプレフィックスは常に必要です。

すべてのプレフィックスがここに記載されているわけではないことに注意してください。 文書化されていないプレフィックスは次のいずれかです
文書化されたプロトコルへのエイリアス、または実装されたプロトコルへの単なるリダイレクト
FFmpegで文書化されています。

- stdinからデータを再生します。

smb：// PATH
Samba共有からのパスを再生します。

bd：// [タイトル] [/デバイス] --bluray-device = PATH
ブルーレイディスクを再生します。 現在、これはISOファイルを受け入れません。 代わりに、あなたはしなければなりません
ISOファイルをファイルシステムとしてマウントし、ポイントします -- ブルーレイデバイス マウントされた
ディレクトリを直接。

dvd：// [title | [starttitle] -endtitle] [/ device] --dvd-device = PATH
DVDを再生します。 DVDメニューはサポートされていません。 タイトルが指定されていない場合、最長のタイトルは
自動選択。

dvdnav：// の古いエイリアスです DVD：// まったく同じことをします。

dvdread：// ...：
古いlibdvdreadコードを使用してDVDを再生します。 これはMPlayerと古いmpvのものです
に使用するバージョン DVD：//。 使用はお勧めしません。 互換性のためにのみ提供されています
と移行のため。

tv：// [チャンネル] [/ input_id] - テレビ-...
V4L経由のアナログTV。 ウェブカメラにも役立ちます。 （Linuxのみ。）

pvr：// --pvr-..。
PVR。 （Linuxのみ。）

dvb：// [cardnumber @] channel --dvbin-..。
DVB経由のデジタルTV。 （Linuxのみ。）

mf：// [filemask | @listfile] --mf-..。
一連の画像をビデオとして再生します。

cdda：// track [-endtrack] [：speed] [/ device] --cdrom-device = PATH --cdda-..。
CDを再生します。

lavf：//..。
任意のFFmpeg / Libavlibavformatプロトコルにアクセスします。 基本的に、これは文字列を渡しました
後に // libavformatに直接。

av：// type：options
これは、libavdevice入力を使用することを目的としています。 type libavdevicedemuxerです
名前、および オプション デマルチプレクサに渡される（疑似）ファイル名です。

たとえば、 mpv av：// lavfi：mandelbrot libavfilterラッパーを利用します
libavdeviceに含まれており、 マンデルブロ 生成するソースフィルター
入力データ。

avdevice：// エイリアスです。

ファイルパス
URLとしてのローカルパス。 いくつかの特別なユースケースで役立つ場合があります。 ご了承ください パス
それ自体はXNUMX分のXNUMXから始める必要があります / パスを絶対パスにします。

fd：// 123
指定されたUNIXFD（たとえば123）からデータを読み取ります。 これは配管データに似ています
経由でstdinに -、ただし、任意のファイル記述子を使用できます。 正しく動作しません
MSWindowsの場合。

edl：// [edl 仕様 as in edl-mpv.rst]
複数のファイルの一部をつなぎ合わせて再生します。

ヌル：//
空のファイルをシミュレートします。

メモリ：//データ
データ ソースデータとしての一部。

擬似 GUI モード

mpvには、OSC（ON SCREEN CONTROLLER）、これは完全ではありません
GUIであり、そうすることを意図したものではありません。 ただし、予想されるGUIの動作の欠如を補うために、
mpvは、場合によっては、GUIのように動作するようにいくつかの設定を変更して開始します。
モード。

現在、これは次の場合にのみ発生します。

・使用を開始した場合 mpv.デスクトップ Linux上のファイル（たとえば、メニューまたはファイルから開始）
デスクトップ環境によって提供される関連付け）

・Windowsのexplorer.exeから開始した場合（技術的には、Windowsで開始した場合、および
stdout / stderr / stdinハンドルはすべて設定されていません）

・手動で追加 --profile = pseudo-gui コマンドラインへ

このモードは暗黙的に追加します --profile = pseudo-gui コマンドラインに、 疑似GUI
次の内容で事前定義されているプロファイル：

[疑似GUI]
terminal = no
force-window = yes
アイドル= XNUMX回
スクリーンショット-ディレクトリ= ~~ desktop /

これは、mpvconfigファイルの形式に従います。 疑似GUIモードをカスタマイズするには、
自分の 疑似GUI あなたのプロフィール mpv.conf。 このプロファイルは、デフォルトのプロファイルを拡張します。
上書きするのではなく。

プロファイルは常に他の設定を上書きします mpv.conf.

OPTIONS

トラック 選択
--alang =
使用する音声言語の優先リストを指定します。 さまざまなコンテナ形式
異なる言語コードを使用します。 DVDはISO639-1文字の言語コードを使用します。
Matroska、MPEG-TS、NUTはISO 639-2のXNUMX文字の言語コードを使用し、OGMは
自由形式の識別子。 も参照してください - 援助.

例

mpv DVD：// 1 --alang = hu、en
DVDでハンガリー語のトラックを選択し、英語にフォールバックします
ハンガリー語が利用できない場合。

mpv --alang = jpn たとえば .mkv
マトロスカファイルを日本語で再生します。

--slang =
使用する字幕言語の優先リストを指定します。 さまざまなコンテナ形式
異なる言語コードを使用します。 DVDはISO639-1文字の言語コードを使用します。
MatroskaはISO639-2のXNUMX文字の言語コードを使用し、OGMは自由形式を使用します
識別子。 も参照してください --シド.

例

· mpv DVD：// 1 --slang = hu、en DVDのハンガリー語字幕トラックを選択し、
ハンガリー語が利用できない場合は英語にフォールバックします。

· mpv --slang = jpn たとえば .mkv 日本語字幕付きのMatroskaファイルを再生します。

--aid =
オーディオトラックを選択します。 オート デフォルトを選択し、 いいえ オーディオを無効にします。 も参照してください --アラン.
mpvは通常、再生を開始するときに端末で使用可能なオーディオトラックを印刷します
ファイルの。

--sid =
で指定された字幕ストリームを表示します . オート デフォルトを選択し、 いいえ
字幕を無効にします。

参照 - スラング, --サブなし.

--vid =
ビデオチャンネルを選択します。 オート デフォルトを選択し、 いいえ ビデオを無効にします。

--ff-aid = 、 --ff-sid = 、 --ff-vid =
FFmpegストリームインデックスでオーディオ/字幕/ビデオストリームを選択します。 FFmpegストリーム
インデックスは比較的任意ですが、他のソフトウェアと対話するときに役立ちます
FFmpegを使用する（検討する ffprobe).

外部トラックを使用することに注意してください（ -サブファイル および同様のオプション）、
IDが重複するストリームになります。 この場合、順序の最初のストリームは
選択された。

--edition =
（Matroskaファイルのみ）使用するエディション（章のセット）を指定します。ここで、0は
初め。 に設定されている場合 オート （デフォルト）、mpvは次のように宣言された最初のエディションを選択します
デフォルト、またはデフォルトがない場合は、最初のエディションが定義されます。

Playback 管理
--start = 時間>
与えられた時間位置を求めます。

絶対時間の一般的な形式は次のとおりです。 [[hh：] mm：] ss [.ms]。 時間が与えられれば
プレフィックス付き + or -、シークはファイルの最初または最後から相対的です。
（mpv 0.14以降、ファイルの先頭は常に0と見なされます。）

pp％ パーセント位置pp（0-100）を求めます。

#c 章番号cを求めています。 （章は1から始まります。）

例

--start = + 56、 --start = + 00：56
開始時間+56秒をシークします。

--start = -56、 --start = -00：56
終了時刻をシークします-56秒。

--start = 01:10:00
1時間10分を求めます。

-開始= 50％
ファイルの真ん中にシークします。

--start = 30 --end = 40
30秒をシークし、10秒再生して、終了します。

--start = -3：20 -長さ= 10
ファイルの終わりの3分20秒前にシークし、10を再生します
秒、および終了します。

--start = '＃2' --end = '＃4'
第2章と第3章を再生し、終了します。

--end =
与えられた絶対時間で停止します。 つかいます - 長さ 時間が相対的である必要がある場合
- 始める。 見る - 始める 有効なオプション値と例について。

-長さ= 時間>
開始時間に対して一定の時間後に停止します。 見る - 始める 有効なオプションの場合
値と例。

--rebase-start-time =
ファイルの開始時刻をに移動するかどうか 00:00:00 （デフォルト：はい）。 これは少ないです
トランスポートストリームなど、ランダムなタイムスタンプで開始するファイルには扱いにくいです。 の上
一方、タイムスタンプのリセットがある場合、結果として生じる動作はかなり
変。 このため、そしてあなたが実際に本物に興味がある場合
タイムスタンプ、この動作はで無効にすることができます いいえ.

-速度= <0.01-100>
パラメータとして指定された係数で再生を遅くしたり速くしたりします。

If --オーディオピッチ補正 （デフォルトでオン）が使用され、より高速で再生されます
通常より自動的に挿入します スケールテンポ オーディオフィルター。

--loop =
再生をループします N 回数。 の値 1 XNUMX回再生します（デフォルト）、 2 XNUMX回など
infファイル 永遠を意味します。 いいえ と同じです。 1 ループを無効にします。 複数のファイルがある場合
コマンドラインで指定すると、プレイリスト全体がループします。

当学校区の 力 モードは次のようなものです infファイル、ただし、されているプレイリストエントリをスキップしません
失敗としてマークされます。 これは、プレーヤーがファイルをループしようとしてCPU時間を浪費する可能性があることを意味します
それは存在しません。 しかし、それは非常に悪い状況でウェブラジオを再生するのに役立つかもしれません
ネットワークの状態。

- 一時停止
一時停止状態でプレーヤーを起動します。

- シャッフル
ランダムな順序でファイルを再生します。

--chapter =
再生を開始するチャプターを指定します。 オプションで、終了するチャプターを指定します
で遊んでいます。 も参照してください - 始める.

--playlist-pos =
再生を開始する内部プレイリストのファイルを設定します。 インデックスは
整数。0は最初のファイルを意味します。 値 いいえ の選択を意味します
再生するエントリは、再生再開メカニズムに委ねられます（デフォルト）。 エントリの場合
指定されたインデックスが存在しない場合、動作は指定されておらず、で変更される可能性があります
将来のmpvバージョン。 プレイリストにさらにプレイリストが含まれている場合も同様です
（合理的な動作を期待しないでください）。 プレイリストファイルをmpvに渡すと機能するはずです
ただし、このオプションを使用します。 例えば mpv プレイリスト.m3u --playlist-pos = 123 として動作します
期待される限り プレイリスト.m3u それ以上のプレイリストにはリンクしません。

-プレイリスト=
プレイリストファイルに従ってファイルを再生します（いくつかの一般的な形式をサポートします。形式がない場合
が検出されると、改行文字で区切られたファイルのリストとして扱われます。
XMLプレイリスト形式はサポートされていないことに注意してください。）

このオプションなしでプレイリストを直接再生できますが、このオプションは
実施されている可能性のあるセキュリティメカニズムを無効にします。 あなたもこれが必要かもしれません
プレーンテキストファイルをプレイリストとしてロードするオプション。

警告：
mpvがプレイリストファイルを使用する方法 -プレイリスト 悪意を持って安全ではありません
構築されたファイル。 このようなファイルは、有害なアクションを引き起こす可能性があります。 これは
すべてのmpvおよびMPlayerバージョンの場合ですが、残念ながらこの事実はうまくいきませんでした
以前に文書化されており、一部の人々は誤って
-プレイリスト 信頼できないソースで。 使用禁止 -プレイリスト ランダムインターネットで
信頼できないソースまたはファイル！

プレイリストには、ローカルファイルなどの他のプロトコルを使用したエントリを含めることができます。
（最も深刻な）、のような特別なプロトコル avdevice：//、本質的に
安全でない。

--chapter-merge-threshold =
ほぼ連続して順序付けられたチャプターパーツをミリ秒単位でマージするためのしきい値
（デフォルト：100）。 順序付けられたチャプターを持つ一部のMatroskaファイルには、不正確なチャプターがあります
タイムスタンプを終了し、XNUMXつの章の終わりとの始まりの間に小さなギャップを引き起こします
それらが一致する必要がある次のもの。 XNUMXつの再生部分の終わりが未満の場合
次のしきい値の開始から離れて指定されたしきい値その後、ビデオを再生し続ける
通常、シークを行う代わりに、チャプターを変更します。

--chapter-seek-threshold =
後進チャプターが含まれるチャプターの先頭からの秒単位の距離
シークは前の章に進みます（デフォルト：5.0）。 このしきい値を超えると、
後方チャプターシークは、代わりに現在のチャプターの先頭に移動します。 A
負の値は、常に前の章に戻ることを意味します。

--hr-seek =
キーフレームに限定されない正確なシークをいつ使用するかを選択します。 そのようなシーク
前のキーフレームからターゲット位置までのビデオをデコードする必要があります。
デコードのパフォーマンスによっては、時間がかかる場合があります。 一部のビデオ形式では、
正確なシークは無効になっています。 このオプションは、使用するデフォルトの選択肢を選択します
求める; キーの定義でそのデフォルトを明示的にオーバーライドすることが可能です
バインディングおよびスレーブモードコマンド。

いいえ 正確なシークは絶対に使用しないでください。

絶対の
シークがファイル内の絶対位置にある場合は、正確なシークを使用します。
チャプターシークとしてですが、デフォルトの動作のような相対シークではありません
矢印キー（デフォルト）。

はい 可能な限り正確なシークを使用してください。

常に と同じ はい （互換性のため）。

--hr-seek-demuxer-offset =
このオプションは、正確なシークを実行できない場合を回避するために存在します（ --hr-シーク)
一部のファイル形式のデマルチプレクサのバグまたは制限が原因で発生します。 いくつかのdemuxers
指定されたターゲット位置の前にキーフレームをシークできず、後で移動します
代わりに位置。 このオプションの値は、指定されたタイムスタンプから差し引かれます
demuxerに。 したがって、このオプションを1.5に設定し、正確なシークを実行しようとすると、
60秒、デマルチプレクサは58.5の時間をシークするように指示されます。これにより、
誤って60秒より後の時間になる可能性があります。 の欠点
このオプションを設定すると、ビデオ間のビデオが遅くなるため、正確なシークが遅くなります。
以前のデマルチプレクサ位置と実際のターゲットが不必要にデコードされる可能性があります。

--hr-seek-framedrop =
これらのフレームが前にある場合は、ビデオデコーダがシーク中にフレームをドロップできるようにします
ターゲットを探します。 これを有効にすると、正確なシークが高速になりますが、
タイムスタンプを変更したり、新しいフレームを追加したりするビデオフィルターは、正確に導くことができます
ターゲットフレームをスキップしようとしています。 これは、例えば、フレームのバックステッピングを壊す可能性があります
インターレース解除が有効になっています。

デフォルト： はい

--index =
ファイルの検索方法を制御します。 インデックスがファイルにない場合は、
デフォルトではオンザフライでビルドされるため、これを変更する必要はありません。 しかし、それはかもしれません
いくつかの壊れたファイルを助けます。

デフォルト
ファイルにインデックスがある場合はインデックスを使用し、不足している場合はインデックスを作成します

作り直す
ファイルのインデックスを読み取ったり使用したりしないでください

注:
このオプションは、基盤となるメディアがシークをサポートしている場合にのみ機能します（つまり、
stdin、pipeなど）。

--load-unsafe-プレイリスト
安全でないと見なされるプレイリストからURLをロードします（デフォルト：no）。 これも
特別なプロトコルや通常のファイルを参照しないもの。 ローカルファイルと
一方、HTTPリンクは常に安全であると見なされます。

注意してください -プレイリスト 常にすべてのエントリをロードするため、代わりにそれを使用します
本当にこの機能が必要です。

--loop-file =
XNUMXつのファイルをN回ループします。 infファイル 永遠を意味します、 いいえ 通常の再生を意味します。 にとって
互換性、 --ループファイル および --loop-file = yes も受け入れられ、同じです
as --loop-file = inf.

との違い - ループ これはプレイリストをループせず、ファイルだけをループするということです
自体。 プレイリストに含まれるファイルがXNUMXつだけの場合、XNUMXつのファイルの違い
オプションは、このオプションがファイルをリロードする代わりに、ループでシークを実行することです。

--ab-loop-a = 、 --ab-loop-b =
ループポイントを設定します。 再生が合格した場合 b タイムスタンプ、それは a
タイムスタンプ。 過去を求めて b ポイントはループしません（これは意図的なものです）。 The
ループポイントは、対応するプロパティを使用して実行時に調整できます。 も参照してください
ab_loop

-注文済み-章、 -注文なし-章
デフォルトで有効になっています。 Matroskaで注文したチャプターのサポートを無効にします。 mpvはしません
他のファイルからビデオセグメントをロードまたは検索し、すべてを無視します
メインファイルに指定されたチャプター順序。

--ordered-chapters-files =
指定されたファイルをプレイリストとしてロードし、それに含まれるファイルを次のように使用しようとします
順序付けられたチャプターを使用するMatroskaファイルを開くときの参照ファイル。 この
同じものをスキャンすることにより、参照ファイルをロードするための通常のメカニズムをオーバーライドします
メインファイルが置かれているディレクトリ。

ローカルにない順序付けられたチャプターファイルをロードするのに便利です
ファイルシステム、または参照されるファイルが異なるディレクトリにある場合。

注：プレイリストは、ファイル名がで区切られたテキストファイルのように単純なものにすることができます。
改行。

--chapters-file =
にあるチャプターメタデータを使用する代わりに、このファイルからチャプターをロードします
メインファイル。

--sstep =
スキップすべてのフレームの数秒後。

注:
無し --hr-シーク、スキップするとキーフレームにスナップします。

--stop-playback-on-init-failure =
オーディオまたはビデオのいずれかが初期化に失敗した場合は、再生を停止します。 現在、デフォルト
行動は いいえ コマンドラインプレーヤー用ですが、 はい libmpvの場合。 と いいえ、再生
いずれかが失敗した場合、ビデオのみまたはオーディオのみのモードで続行します。 これはしません
オーディオのみまたはビデオのみのファイルの再生に影響します。

（AFCプログラム） 行動
- 助けて オプションの簡単な要約を表示します。

-v 詳細レベルをインクリメントします。各レベルにXNUMXつのレベルがあります。 -v コマンドラインで見つかりました。

- バージョン、 -V
バージョン文字列を出力して終了します。

--no-config
デフォルトの構成ファイルをロードしないでください。 これにより、両方のロードが防止されます
ユーザーレベルおよびシステム全体 mpv.conf および 入力.conf ファイル。 その他の構成ファイル
再生ファイルの再開など、同様にブロックされます。

注:
次のようなコマンドラインオプションによって明示的に要求されたファイル - 含む or
--use-filedir-conf、は引き続きロードされます。

また見てください --config-dir.

--リストオプション
使用可能なすべてのオプションを印刷します。

--リストのプロパティ
使用可能なプロパティのリストを印刷します。

--list-プロトコル
サポートされているプロトコルのリストを印刷します。

--log-file =
指定された書き込みパスを開き、ログメッセージを出力します。 既存のファイルは
切り捨てられます。 ログレベルは常にに対応します -v、端末に関係なく
詳細レベル。

--config-dir =
別の構成ディレクトリを強制します。 これが設定されている場合、指定されたディレクトリは
構成ファイルのロードに使用され、他のすべての構成ディレクトリは
無視されます。 これは、グローバルmpv構成ディレクトリとユーザーごとを意味します
ディレクトリは無視され、環境変数を介してオーバーライドされます（MPV_HOME）は
また無視されます。

なお、 --no-config オプションはこのオプションよりも優先されます。

--終了時に位置を保存
終了時に常に現在の再生位置を保存します。 このファイルを再度再生すると
後で、プレーヤーは開始時に古い再生位置を探します。 これはしません
終了以外の方法でファイルの再生が停止した場合に発生します。 にとって
たとえば、プレイリストの次のファイルに移動しても、位置は保存されません。
次にファイルを再生するときに、最初から再生を開始します。

この動作はデフォルトで無効になっていますが、終了するといつでも利用できます。
Shift + Qのプレーヤー。

--dump-stats =
指定されたファイルに特定の統計を書き込みます。 ファイルを開くと切り捨てられます。 The
ファイルには、それぞれにタイムスタンプが付いた生のサンプルが含まれます。 このファイルを
読み取り可能、スクリプト ツール/統計-conv.py 使用できます（現在表示されています
グラフとして）。

このオプションは、デバッグにのみ役立ちます。

--idle =
再生するファイルがない場合に終了するのではなく、mpvをアイドル状態で待機させます。 多くの場合
入力コマンドでmpvを制御できるスレーブモードで役立ちます。

かつて 開始時にのみアイドル状態になり、最初のプレイリストが
再生が終了しました。

--include =
デフォルトの後に解析する構成ファイルを指定します。

--load-scripts =
に設定した場合 いいえ、からスクリプトを自動ロードしないでください スクリプト 構成サブディレクトリ
（通常は 〜/ .config / mpv / scripts /）。 （ディフォルト： はい)

--script =
Luaスクリプトをロードします。 複数のスクリプトをカンマで区切ることでロードできます
(,).

--script-opts = key1 = value1、key2 = value2、..。
スクリプトのオプションを設定します。 スクリプトは、キーでオプションを照会できます。 オプションを使用する場合
オプション値のセマンティクスは、ロードされたスクリプトに完全に依存します。
スクリプトによって要求されていない値は無視されます。

-マージ-ファイル
mpvに渡されたすべてのファイルがXNUMXつの大きなファイルに連結されているように見せかけます。 この
内部でタイムライン/ EDLサポートを使用します。 これは順序付けられたチャプターでは機能しないことに注意してください
ファイル。

--再開なし再生
から再生位置を復元しないでください 後で見る 構成サブディレクトリ
（通常は 〜/ .config / mpv / watch_later /）。 見る quit_watch_later 入力コマンド。

--profile =
指定されたプロファイルを使用し、 --profile = help 定義されたプロファイルのリストを表示します。

--reset-on-next-file =
通常、mpvは、次のファイルを再生するときにすべての設定を保持しようとします。
再生中にユーザーが変更した場合でも、プレイリスト。 （この動作は
MPlayerの反対で、次に起動するときにすべての設定をリセットしようとします
ファイル。）

デフォルト：何もリセットしません。

これは、このオプションで変更できます。 それはオプションのリストを受け入れます、そしてmpvは
再生開始時にこれらのオプションの値を初期値にリセットします。 ザ
初期値は、デフォルト値、または構成ファイルまたはコマンドで設定された値のいずれかです。
ライン。

場合によっては、これが期待どおりに機能しないことがあります。 例えば、 - 音量 のみとなります
設定ファイルまたはコマンドラインで明示的に設定されている場合はリセットします。

特別な名前 を できるだけ多くのオプションをリセットします。

例

· --reset-on-next-file = pause 次のファイルに切り替えるときに一時停止モードをリセットします。

· --reset-on-next-file = fullscreen、speed フルスクリーンと再生速度をリセットする
再生中に変更された場合の設定。

· --reset-on-next-file = all 中に変更されたすべての設定をリセットしてみてください
再生。

--watch-later-config にファイル名を書き込む
後で見る構成ファイルの前に、それらが参照するファイルの名前を付けます。 この
単にファイルの上部にコメントとして書き込まれます。

警告：
このオプションはプライバシーに配慮した情報を公開する可能性があるため、
デフォルト。

--watch-later-config のパスを無視する
後で見る機能を使用するときは、パスを無視します（つまり、ファイル名のみを使用します）。

--show-profile =
プロファイルの説明と内容を表示します。

--use-filedir-conf
次のファイルと同じディレクトリでファイル固有の構成ファイルを探します。
再生されています。 見る ファイル固有 　 .

警告：
信頼できないメディアから再生すると危険な場合があります。

--ytdl、 --no-ytdl
youtube-dlフックスクリプトを有効にします。 入力URLを確認し、
ウェブサイトにあるビデオ。 これは、
スクリプトにちなんで名付けられたもの。 これには、最新バージョンのyoutube-dlが必要です。
システムにインストールされます。 （クライアントAPI /の場合を除いて、デフォルトで有効になっています
libmpvが使用されます。）

スクリプトがURLで何もできない場合、スクリプトは何もしません。

--ytdl-format =
youtube-dlに直接渡されるビデオフォーマット/品質。 可能な値は次のとおりです。
Webサイトとビデオに固有で、特定のURLに対して使用可能な形式は次のとおりです。
コマンドで見つかりました youtube-dl --リスト形式 URL。 youtube-dlを見る
利用可能なエイリアスのドキュメント。 （デフォルト：youtube-dlのデフォルト、現在
bestvideo + bestaudio / best)

--ytdl-raw-options = = [、 = [、...]]
任意のオプションをyoutube-dlに渡します。 パラメータと引数は、として渡す必要があります
キーと値のペア。 引数のないオプションには、 =.

健全性チェックがないため、問題が発生する可能性があります（つまり、無効なパスを渡す）
youtube-dlへのパラメータ）。

例

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

動画
--vo =
使用するビデオ出力ドライバの優先順位リストを指定します。 インタラクティブに使用するには、
通常、使用するものをXNUMXつ指定しますが、構成ファイルでは、
フォールバックのリストを指定することは理にかなっているかもしれません。 見る VIDEO 出力 DRIVERS 詳細については
および使用可能なドライバーの説明。

--vd = <[+ |-] family1：（* | decode1）、[+ |-] family2：（* | decode2）、... [-]>
ファミリに応じて、使用するビデオデコーダの優先リストを指定します。
名前。 見る - 広告 詳細については。 これらのオプションは両方とも同じ構文を使用し、
セマンティクス; 唯一の違いは、それらが異なるコーデックリストで動作することです。

注:
詳細はこちら： --vd = help 利用可能なデコーダーの完全なリストについては。

--vf =
ビデオストリームに適用するビデオフィルターのリストを指定します。 見る VIDEO FILTERS の
使用可能なフィルターの詳細と説明。 オプションのバリエーション --vf-追加,
--vf-pre, --vf-デル および --vf-clr 以前に指定されたリストを変更するために存在しますが、
通常の使用ではこれらは必要ありません。

-ビデオなし
ビデオを再生しないでください。 一部のデマルチプレクサでは、これが機能しない場合があります。 そのような場合は、試すことができます
--vo = null を代わりにお使いください。

mpvは、メディアがyoutube-dlでストリーミングされている場合にのみ、オーディオのダウンロードを試みます。
帯域幅を節約できるからです。 これは、ytdl_formatを次のように設定することによって行われます。
ytdl_hook.luaスクリプトの「bestaudio / best」。

-時間制限なし
ビデオフレームを出力するときはスリープしないでください。 一緒に使用するとベンチマークに役立ちます
--no-audio。

--framedrop =
低速のシステムでA / V同期を維持するために一部のフレームの表示をスキップするか、高再生
フレームレートの上限があるビデオ出力のフレームレートビデオ。

引数はdropメソッドを選択し、次のいずれかになります。

フレームドロップを無効にします。

ビデオ出力にレイトフレームをドロップします（デフォルト）。 これはまだデコードしてフィルタリングします
すべてのフレームですが、VOではレンダリングされません。 表示を照会しようとします
FPS（X11のみ、マルチモニターシステムでは正しくない）、または無限を想定
それが失敗した場合はFPSを表示します。 ドロップはターミナルステータスラインに表示されます
as D: 分野。 デコーダーが遅すぎる場合、理論的にはすべてのフレームが
ドロップされる（すべてのフレームが遅すぎるため）-これを回避するには、フレームドロップ
実効フレームレートが10FPS未満の場合は停止します。


古いデコーダーベースのフレームドロップモード。 （これはと同じです --framedrop = yes in
mpv 0.5.x以前。）これは、フレームをスキップするようにデコーダーに指示します（フレームがない場合）
将来のフレームをデコードするために必要です）。 遅いシステムには役立つかもしれませんが、
見られない途切れ途切れの出力を生成したり、ディスプレイを完全にフリーズさせたりします。
推奨されません。 The --vd-lavc-framedrop オプションは、どのフレームにするかを制御します
ドロップ。


両方のモードを有効にします。 推奨されません。

注:
--vo = vdpau のための独自のコードがあります vo フレームドロップモード。 わずかな違い
他のVOも可能です。

--display-fps =
で使用するディスプレイFPSを設定します --video-sync = display- * モード。 デフォルトでは
検出された値が使用されます（X11のみ、マルチモニターシステムでは正しくありません）。 で保つ
間違った値を設定すると（少し間違っていても）ビデオが台無しになる可能性があることに注意してください
再生。

--hwdec =
可能であれば、使用する必要があるハードウェアビデオデコードAPIを指定します。 どうにか
ハードウェアデコードが実際に行われるのは、ビデオコーデックによって異なります。 ハードウェアデコードの場合
不可能な場合、mpvはソフトウェアのデコードにフォールバックします。

次のいずれかになります。

いいえ 常にソフトウェアデコードを使用します（デフォルト）

オート 下記参照

vdpau 必要 --vo = vdpau or --vo = opengl （Linuxのみ）

ヴァーピ 必要 --vo = opengl or --vo = vaapi （Linuxのみ）

vaapi-コピー
ビデオをシステムRAMにコピーして戻します（LinuxとIntel GPUのみ）

ビデオツールボックス
必要 --vo = opengl （OS X 10.8以降のみ）

dxva2-コピー
ビデオをシステムRAMにコピーして戻す（Windowsのみ）

RPI 必要 --vo = rpi （Raspberry Piのみ-利用可能な場合はデフォルト）

オート 最初に利用可能なものを使用してハードウェアデコードを自動的に有効にしようとします
方法。 これは、使用しているVOによって異なります。 たとえば、使用していない場合
--vo = vdpau or --vo = opengl、vdpauデコードが有効になることはありません。 また、
最初に見つかった方法は実際には機能せず、常にソフトウェアにフォールバックします
次の方法を試す代わりに、デコードします（一部のLinuxシステムでは問題になる可能性があります）。

当学校区の ヴァーピ モード、と一緒に使用する場合 --vo = opengl、Mesa 11が必要で、おそらく機能します
IntelGPUのみ。 また、opengl EGLバックエンド（自動的に使用される）も必要です
可能な場合は）。 古いGLXバックエンドを強制的に試すこともできます
--vo = opengl：backend = x11、しかしvaapi / GLX相互運用はより遅いと言われています
vaapi-コピー.

当学校区の vaapi-コピー モードを使用すると、任意のVOでvaapiを使用できます。 これはコピーするので
デコードされたビデオをシステムRAMに戻すと、効率が低下する可能性があります。 ヴァーピ モード。

注:
このスイッチを使用する場合でも、ハードウェアデコードは一部のコーデックに対してのみ実行されます。
詳細はこちら： --hwdec-コーデック より多くのコーデックのハードウェアデコードを有効にします。

--hwdec-preload =
これは、 OpenGLの および opengl-cb ハードウェアデコードを作成するためのVO
OpenGL相互運用コンテキストですが、実際にはハードウェアデコード自体を有効にしません
（ --hwdec します）。

に設定した場合 いいえ （デフォルト）、 --hwdec オプションが使用されます。

OpenGLの、設定されている場合、オンデマンドで相互運用コンテキストを作成しませんが、VOが
作成しました。

opengl-cb、設定されている場合、OpenGLコンテキストが
作成した。 以来 opengl-cb オンデマンドの読み込みがないため、ハードウェアを有効にすることができます
一時的に設定する必要なしに、実行時にデコードします hwdec オプション
OpenGLコンテキストの初期化中 mpv_opengl_cb_init_gl（）.

--videotoolbox-format =
によって使用される内部ピクセル形式を設定します --hwdec = videotoolbox OSXで。 の選択
フォーマットはパフォーマンスに大きく影響する可能性があります。 一方、ありません
特定のハードウェアに最適なフォーマットを検出するための良い方法のようです。 nv12
デフォルトでは、最新のハードウェアでより適切に機能しますが、 uyvy422 のための方が良いようです
古いハードウェア。 RGB0 も動作します。

--panscan = <0.0-1.0>
パンアンドスキャン機能を有効にします（たとえば、16：9ビデオの側面をトリミングして作成します）
黒い帯のない4：3ディスプレイに適合します）。 範囲は画像の量を制御します
トリミングされます。 すべてのビデオ出力ドライバで動作するとは限りません。

--video-aspect =
アスペクト情報が正しくないか欠落している場合に備えて、ビデオのアスペクト比を上書きします。
再生中のファイル。 も参照してください --ビデオアスペクトなし.

XNUMXつの値には特別な意味があります。

0 アスペクト比の処理を無効にし、ビデオに正方形のピクセルがあるふりをします

-1 ビデオストリームまたはコンテナアスペクトを使用する（デフォルト）

ただし、これらの特別な値の処理は将来変更される可能性があることに注意してください。

例

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

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

--ビデオアスペクトなし
ビデオファイルのアスペクト比情報を無視し、ビデオに正方形があると想定します
ピクセル。 も参照してください -ビデオアスペクト.

--video-aspect-method =
これにより、デフォルトのビデオアスペクト決定方法が設定されます（アスペクトが_not_の場合）
でユーザーによってオーバーライドされます -ビデオアスペクト その他）。

ハイブリッド コンテナのアスペクト比を優先します。 ビットストリームアスペクトが切り替わる場合
途中で、ビットストリームの側面を優先するように切り替えます。 これがデフォルトです
mpvおよびmplayer2での動作。

コンテナ
コンテナのアスペクト比を厳密に優先します。 これは明らかにデフォルトです
少なくともMatroskaではVLCでの動作。

ビットストリーム
ビットストリームアスペクトを除いて、ビットストリームアスペクト比を厳密に優先します
比率が設定されていません。 これは明らかにXBMC / kodiのデフォルトの動作です。
少なくともMatroskaでは。

通常、これを設定しないでください。 試してみてください コンテナ および ビットストリーム あなたなら選択肢
mpvでアスペクト比が間違っているが、
他のプレイヤー。

-ビデオ-スケールなし
ビデオのスケーリングを無効にします。 ウィンドウがビデオよりも大きい場合、黒いバー
追加されます。 それ以外の場合、ビデオはトリミングされます。 ビデオはまだ影響を受ける可能性があります
他の - ビデオ-... オプション。 （しかし、すべてではありません。たとえば、 --ビデオズーム 何もしない
このオプションが有効になっている場合。）

ビデオとモニターの側面は無視されます。 アスペクト補正は
ビデオをXまたはY方向に拡大縮小する必要がありますが、このオプションは無効になります
スケーリング、すべてのアスペクト補正を無効にします。

ビデオがスケーリングされていない場合でも、スケーラーアルゴリズムが使用される可能性があることに注意してください。
たとえば、これは彩度変換に影響を与える可能性があります。

このオプションは、 --ノーキープアスペクト オプションが使用されます。

--video-pan-x = 、 --video-pan-y =
表示されたビデオ長方形を指定された値だけXまたはY方向に移動します。 ザ
単位は、拡大縮小されたビデオのサイズの何分のXNUMXかです（パーツであってもフルサイズ）
パンスキャンまたは他のオプションのため、ビデオの一部は表示されません）。

たとえば、1280x720のビデオを1680x1050の画面にフルスクリーンで表示すると
--video-pan-x = -0.1 ビデオを左に168ピクセル移動します（128ピクセルになります）
ソースビデオの非表示）。

このオプションは、 --ノーキープアスペクト オプションが使用されます。

--video-rotate = <0-360 | no>
ビデオを時計回りに度単位で回転させます。 現在、90°ステップのみをサポートしています。 もしも いいえ
が指定されている場合、ファイルに回転メタデータがある場合でも、ビデオは回転されません。 （
回転値が回転メタデータに追加されます。これは、値を意味します 0 でしょう
回転メタデータに従ってビデオを回転します。）

--video-stereo-mode =
ステレオ3D出力モードを設定します（デフォルト： モノ）。 これは、
Stereo3d 変換フィルター。

疑似モード いいえ 自動変換を完全に無効にします。

モード モノ へのエイリアスです ml、2Dの左側のフレームを指します。 これは
デフォルト。これは、mpvがマングルではなく3Dで2D映画を表示しようとすることを意味します
消費を目的としない3D画像（左右のフレームの表示など）
並べてなど）。

　 --video-stereo-mode = help 使用可能なすべてのモードを一覧表示します。 に確認してください Stereo3d
ドキュメントをフィルタリングして、名前の意味を確認します。 一部の名前は参照していることに注意してください
でサポートされていないモード Stereo3d -これらのモードはファイルに表示できますが、表示できません
mpvによって適切に処理されます。

--video-zoom =
ビデオ表示の倍率を所定の値で調整します。 単位は分数です
（スケーリングされた）ウィンドウビデオサイズの。

たとえば、1280x720ウィンドウに表示される1280x720ビデオの場合、 --video-zoom = -0.1
ビデオをX方向に128ピクセル、Y方向に72ピクセル小さくします。
方向。

このオプションは、 --ノーキープアスペクト オプションが使用されます。

--video-align-x = <-1-1>、 --video-align-y = <-1-1>
通常はパッドに追加される黒い境界線内でビデオの長方形を移動します
ビデオと画面のアスペクト比が異なる場合は、ビデオと画面の比率。
--video-align-y = -1 ビデオを画面の上部に移動します（境界線を残します）
下部のみ）、の値 0 中央に配置し（デフォルト）、値は 1 置くだろう
画面下部のビデオ。

ビデオと画面のアスペクトが完全に一致する場合、これらのオプションは何もしません。

このオプションは、 --ノーキープアスペクト オプションが使用されます。

-正しい-pts、 -- 正しい点がありません
-- 正しい点がありません mpvを、ビデオタイミングが以下を使用して決定されるモードに切り替えます。
固定フレームレート値（いずれかを使用して --fps オプション、またはファイル情報の使用）。
時々、タイムスタンプが非常に壊れているファイルは、これでいくらかうまく再生できます
モード。 ビデオフィルター、字幕レンダリング、オーディオ同期は次のようになります。
このモードでは完全に壊れています。

--fps =
ビデオのフレームレートを上書きします。 元の値が間違っているか欠落している場合に役立ちます。

注:
で働く -- 正しい点がありません モードのみ。

-インターレース解除=
インターレースを有効または無効にします（デフォルト：auto、通常はnoを意味します）。 インターレース
ビデオは、速い動きで見える醜い櫛のようなアーティファクトを示しています。 有効化
これは通常、ビデオのインターレース解除のためにyadifビデオフィルターを挿入します。
サポートされている場合、ビデオ出力にインターレース解除を適用させます。

これは、 インターレース解除 入力プロパティ（通常はにマップされます d).

オート 技術です。 厳密に言えば、このオプションのデフォルトは
インターレース解除は無効ですが、 オート ケースが必要な場合 ヤディフ に追加されました
手動でフィルターチェーン --vf。 次に、コアはインターレース解除を無効にするべきではありません
なぜなら -インターレース解除 設定されていません。

--field-dominance =
インターレースコンテンツの最初のフィールドを設定します。 XNUMX倍のデインターレーサーに便利です
フレームレート： --vf = yadif = field および --vo = vdpau：deint.

オート （デフォルト）デコーダーが適切な情報をエクスポートしない場合、
フォールバック top （最初にトップフィールド）。

top トップフィールドファースト

ボトム 一番下のフィールドが最初

注:
どちらかを設定する top or ボトム すべてのフレームにインターレースのフラグが立てられます。

--frames =
最初にのみ再生/変換 ビデオフレーム、そして終了します。

--frames = 0 ファイルをロードしますが、再生を初期化する前にすぐに終了します。
（いくつかのファイルプロパティを決定したいだけのスクリプトに役立つかもしれません。）

音声のみの再生の場合、0より大きい値を指定すると、すぐに再生が終了します。
初期化後。 値0は、ビデオと同様に機能します。

--video-output-levels =
YUVからRGBへの変換で使用されるRGBカラーレベル。 通常、次のような出力デバイス
PCモニターは、フルレンジのカラーレベルを使用します。 ただし、一部のテレビやビデオモニター
スタジオのRGBレベルを期待します。 スタジオを期待するデバイスにフルレンジ出力を提供する
レベル入力の結果、黒と白が押しつぶされ、逆に薄暗い灰色の黒になります。
と薄暗い白。

すべてのVOがこのオプションをサポートしているわけではありません。 黙って無視する人もいます。

使用可能な色の範囲は次のとおりです。

オート 自動選択（全範囲に等しい）（デフォルト）

限られました
限られた範囲（コンポーネントあたり16〜235）、スタジオレベル

フル フルレンジ（コンポーネントあたり0〜255）、PCレベル

注:
代わりに、グラフィックドライバの色範囲オプションを使用することをお勧めします。
にアクセスできるようにしています。

--hwdec-codecs =
コーデックの特定のリストに対してのみハードウェアデコードを許可します。 特別な価値 を
常にすべてのコーデックを許可します。

許可されたコーデックのリストは、 mpv --vd = help。 プレフィックスを削除します。例：
lavc：h264 つかいます h264.

デフォルトでは、これはに設定されています h264、vc1、wmv3、hevc、mpeg2video。 ハードウェアに注意してください
のような加速特殊コーデック h264_vdpau もう関連性がなく、実際には
この形式でLibavから削除されました。

これは通常、コーデックが次のように報告される壊れたGPUでのみ必要です。
サポートされていますが、デコードは解決するよりも多くの問題を引き起こします。

例

mpv --hwdec = vdpau --vo = vdpau --hwdec-codecs = h264、mpeg2video
h264およびmpeg2に対してのみvdpauデコードを有効にします。

--vd-lavc-check-hw-profile =
ハードウェアデコーダープロファイルを確認します（デフォルト：yes）。 もしも いいえ が設定され、の最高のプロファイル
ハードウェアデコーダーが無条件に選択され、
ビデオのプロファイルはそれよりも高いです。 結果はおそらく壊れています
デコードしますが、検出または報告されたプロファイルが何らかの形である場合にも役立つ可能性があります
間違っている。

--vd-lavc-software-fallback =
ハードウェアアクセラレーションデコーダーが失敗した場合のソフトウェアデコードへのフォールバック（デフォルト：
3）。 これが数値の場合、Nフレームのデコードに失敗するとフォールバックがトリガーされます
続けて。 1はと同等です はい.

--vd-lavc-bitexact
すべてのデコードステップ（コーデックテスト用）では、ビット精度のアルゴリズムのみを使用してください。

--vd-lavc-fast （MPEG-2、 MPEG-4、 および H.264 のみ）
フォーマット仕様に準拠していない最適化を有効にし、
より単純な逆量子化、より単純な動きなどの問題を引き起こす可能性があります
補償、デフォルトの量子化行列の使用を想定、YUV 4：2：0を想定
損傷したビットストリームを検出するために、いくつかのチェックをスキップします。

--vd-lavc-o = = [、 = [、...]]
AVOptionsをlibavcodecデコーダーに渡します。 注、を作成するためのパッチ o= 不要で
AVOptionシステムを介してすべての未知のオプションを渡すことは大歓迎です。 の完全なリスト
AVOptionsはFFmpegのマニュアルに記載されています。

以前は直接オプションであったいくつかのオプションは、このメカニズムで設定できます。
バグ, グレー, わかります, ec, ビズム, スキップトップ （だった st), スキップボトム （だった sb), debug.

例

--vd-lavc-o = debug = pict

--vd-lavc-show-all =
壊れた/破損したフレームも表示します（デフォルト：no）。 このオプションがnoに設定されている場合、
libavcodecは、最初のキーフレームの前にデコードされたフレームを出力しません
デコードされたか、破損していると認識されたフレーム。

--vd-lavc-skiploopfilter = （H.264 のみ）
H.264デコード中にループフィルター（別名デブロッキング）をスキップします。 フィルタリングされたので
フレームは、依存フレームをデコードするための参照として使用されることになっています。これには、
たとえばMPEG-2ビデオで非ブロック化を行わない場合よりも品質に悪影響を及ぼします。 しかしで
少なくとも高ビットレートのHDTVの場合、これはほとんど見えない大きなスピードアップを提供します
品質の低下。

次のいずれかになります。

なし スキップしないでください。

デフォルト
無駄な処理手順をスキップします（たとえば、AVIの0サイズのパケット）。

非参照 参照されていない（つまり、他のデコードに使用されていない）フレームをスキップする
フレームの場合、エラーは「蓄積」できません）。

ビディール Bフレームをスキップします。

ノンキー キーフレームを除くすべてのフレームをスキップします。

を すべてのフレームをスキップします。

--vd-lavc-skipidct = （MPEG-1 / 2 のみ）
IDCTステップをスキップします。 これにより、ほとんどすべての場合に品質が大幅に低下します（を参照）。
使用可能なスキップ値のskiploopfilter）。

--vd-lavc-skipframe =
フレームのデコードを完全にスキップします。 大幅なスピードアップですが、動きがぎくしゃくし、時には
不良アーティファクト（使用可能なスキップ値についてはskiploopfilterを参照してください）。

--vd-lavc-framedrop =
で使用されるフレームドロップモードを設定します --フレームドロップ （使用可能なスキップについては、skiploopfilterを参照してください
値）。

--vd-lavc-threads =
デコードに使用するスレッドの数。 スレッドが実際にサポートされているかどうか
コーデックに依存します（デフォルト：0）。 0は、マシン上のコアの数を自動検出することを意味します
最大16まで使用できます。16を超えるスレッドを手動で設定できます。

オーディオ
--audio-pitch-correction =
これが有効になっている場合（デフォルト）、通常とは異なる速度で再生します
自動的に挿入します スケールテンポ オーディオフィルター。 詳しくはオーディオフィルターをご覧ください
のセクションから無料でダウンロードできます。

--audio-device =
指定されたオーディオデバイスを使用します。 これは、オーディオ出力名で構成されます。 アルサ,
続い /、その後にオーディオ出力固有のデバイス名が続きます。

オーディオデバイスを一覧表示できます --audio-device = help。 デバイス名を出力します
引用符で囲み、その後に説明を続けます。 デバイス名はあなたが渡さなければならないものです
　 - オーディオ装置 オプションを選択します。

このオプションのデフォルト値は オート、ですべてのオーディオ出力を試行します
デフォルトのデバイスでの優先順位。

多くのAOには デバイス デバイスの選択を上書きするサブオプション
このオプションの（ただし、オーディオ出力の選択ではありません）。 同様に、AOを強制する
--あお のオーディオ出力選択を上書きします - オーディオ装置 （ただし、デバイスではありません
選択）。

現在、ほとんどのAOには実装されていません。

--audio-fallback-to-null =
オーディオデバイスを開くことができない場合は、次のように動作します --ao = null 与えられた。 これは便利です
と組み合わせて - オーディオ装置：選択した場合にエラーを発生させる代わりに
デバイスが存在しない場合、クライアントAPIユーザー（またはLuaスクリプト）が再生を許可する可能性があります
通常どおり続行し、 現在の青 および オーディオデバイスリスト プロパティへ
続行する方法について高レベルの決定を行います。

--ao =
使用するオーディオ出力ドライバの優先順位リストを指定します。 インタラクティブに使用する場合
通常、使用するものをXNUMXつ指定しますが、構成ファイルでは、
フォールバックのリストは理にかなっているかもしれません。 見る AUDIO 出力 DRIVERS 詳細と
利用可能なドライバーの説明。

--af =
オーディオストリームに適用するオーディオフィルターのリストを指定します。 見る AUDIO FILTERS の
使用可能なフィルターの詳細と説明。 オプションのバリエーション --af-追加,
--af プレ, --af-del および --af-clr 以前に指定されたリストを変更するために存在しますが、
通常の使用ではこれらは必要ありません。

--audio-spdif =
圧縮オーディオパススルーを使用する必要があるコーデックのリスト。 これは動作します
従来のS / PDIFとHDMIの両方に対応。

可能なコーデックは ac3, dts, dts-hd。 複数のコーデックを指定できます
それらを ,. dts 低ビットレートのDTSコアを指しますが、 dts-hd を指します
DTS MA（レシーバーとOSのサポートは異なります）。 どちらかのみを使用する必要があります dts or dts-hd
（両方が指定されている場合、および dts 最初に来るのは dts 使用されます）。

一般に、 spdif でリストされている家族 --ad = help でサポートされています
理論。

警告

これを使用する理由はあまりありません。 HDMIは非圧縮をサポートします
マルチチャネルPCM、およびmpvは、FFmpegを介したロスレスDTS-HDデコードをサポートします
libdcadecラッパー。

--ad = <[+ |-] family1：（* | decode1）、[+ |-] family2：（* | decode2）、... [-]>
ファミリに応じて、使用するオーディオデコーダの優先リストを指定します。
デコーダー名。 のようなエントリ 家族：* 指定されたファミリのすべてのデコーダに優先順位を付けます。
使用するデコーダーを決定するとき、オーディオに一致する最初のデコーダー
フォーマットが選択されています。 それが利用できない場合は、次のデコーダーが使用されます。 最後に、それ
によって明示的に選択または拒否されていない他のすべてのデコーダーを試行します
オプションを選択します。

- リストの最後にあるのは、
- 広告 リスト。 + エントリの前にあると、デコーダが強制されます。 これらの両方はすべきではありません
通常のデコーダーの自動選択が機能しないため、通常は使用されます。

- エントリの前にあると、デコーダの選択が無効になります。

例

--ad = lavc：mp3float
FFmpeg / Libavを優先する mp3フロート 他のすべてのMP3デコーダーよりもデコーダー。

--ad = spdif：ac3、lavc：*
FFmpeg / LibavよりもspdifAC3を常に優先します。

--ad = help
使用可能なすべてのデコーダーを一覧表示します。

警告

圧縮オーディオパススルー（SPDIF / HDMI経由のAC3およびDTS）の有効化
このオプションは非推奨です。 つかいます --audio-spdif を代わりにお使いください。

-ボリューム=
起動ボリュームを設定します。 0は無音を意味し、100は音量が下がらないことを意味します。
増幅。 -1（デフォルト）の値は音量を変更しません。 も参照してください
--softvol.

注:
これは、mpv0.9のリリース後に変更されました。 その前は、100は実際には
最大音量。 同時に、ボリュームスケールが立方体になっているので、古い
とにかく、値は新しい値と一致しません。

--audio-delay =
秒単位のオーディオ遅延（正または負のフロート値）。 正の値の遅延
オーディオと負の値はビデオを遅らせます。

-音声なし
音を出さないでください。

-ミュート=
起動時のオーディオミュートステータスを設定します。 オート （デフォルト）ミュート状態は変更されません。 また
- 音量.

--softvol =
オーディオ出力ドライバーのボリュームコントロールを使用するか、
内部mpvボリュームフィルター。

いいえ オーディオドライバーコントロールを好む、絶対にある場合にのみボリュームフィルターを使用する
必要とされる

はい 常にボリュームフィルターを使用してください

オート オーディオドライバーがシステムミキサーを使用する場合は、ボリュームフィルターを優先します（デフォルト）

の意図 オート mpv内からシステムミキサー設定を変更しないようにすることです
デフォルト設定で。 mpvはビデオプレーヤーであり、ミキサーパネルではありません。 もう一方の
一方、ミキサーコントロールは、PulseAudioのようなサウンドサーバーで有効になっています。
アプリケーションごとのボリューム。

--audio-demuxer = <[+] name>
使用する場合は、このオーディオデマルチプレクサタイプを使用してください -オーディオファイル。 名前の前に「+」を使用して
それを強制します。 これにより、一部のチェックがスキップされます。 によって印刷されたようにデマルチプレクサの名前を付けます
--audio-demuxer = help.

--ad-lavc-ac3drc =
AC-3オーディオストリームのダイナミックレンジ圧縮レベルを選択します。 　
0から1の範囲のfloat値。ここで、0は圧縮なしを意味します（これは
デフォルト）および1は完全な圧縮を意味します（大きなパッセージをより静かにし、その逆にします）
逆）。 6までの値も受け入れられますが、純粋に実験的なものです。 このオプション
AC-3ストリームに必要な範囲圧縮が含まれている場合にのみ効果を示します
情報を表示します。

標準では、DRCはデフォルトで有効になっていますが、mpv（およびその他のいくつか）が有効になっています。
プレーヤー）より良いオーディオ品質のためにこれを無視してください。

--ad-lavc-downmix =
デコーダーにオーディオチャンネルのダウンミキシングを要求するかどうか（デフォルト：yes）。 いくつかの
AC-3、AAC、DTSなどのデコーダーは、デコード時にオーディオをリミックスできます。 要求された番号
出力チャネルの数は、 -オーディオチャネル オプション。 遊ぶのに便利
ステレオシステムでオーディオをサラウンドします。

--ad-lavc-threads = <0-16>
デコードに使用するスレッドの数。 スレッドが実際にサポートされているかどうか
コーデックに依存します。 この記事の執筆時点では、一部のロスレスコーデックでのみサポートされています。
0は、マシン上のコアの数を自動検出し、それを最大まで使用することを意味します
16の（デフォルト：1）。

--ad-lavc-o = = [、 = [、...]]
AVOptionsをlibavcodecデコーダーに渡します。 o =を不要にするパッチに注意してください
AVOptionシステムを介してすべての未知のオプションを渡すことは大歓迎です。 の完全なリスト
AVOptionsはFFmpegのマニュアルに記載されています。

--ad-spdif-dtshd = 、 --dtshd、 --no-dtshd
DTSが通過する場合は、DTS-HDを使用します。

警告

これとパススルーの有効化 - 広告 使用を優先して非推奨になりました
--audio-spdif = dts-hd.

--audio-channels =
オーディオ出力のチャンネルレイアウトをリクエストします（デフォルト：auto）。 これはAOに
指定されたチャネルレイアウトでデバイスを開きます。 これを受け入れるのはAO次第です
レイアウト、またはフォールバックを選択するか、要求されたレイアウトがそうでない場合はエラーになります
。

当学校区の -オーディオチャネル オプションは、チャネル番号または明示的なチャネルのいずれかを取ります
レイアウト。 チャンネル番号はデフォルトのレイアウトを参照します。たとえば、2チャンネルはステレオを参照します。
6は5.1を指します。

詳細はこちら： --audio-channels = help 定義されたデフォルトレイアウトの出力。 これはまたリストします
任意のチャネルレイアウトを表現するために使用できるスピーカー名（例：
フロリダルフェ は 2.1 です）。

デフォルトは --audio-channels = auto、入力を使用してオーディオを再生しようとします
ファイルのチャネルレイアウト。 （より正確には、オーディオフィルターチェーンの出力。）
(空の の廃止されたエイリアスとして受け入れられています オート.)

これにより、デコーダーからのチャネルレイアウトも要求されます。 デコーダーがしない場合
レイアウトをサポートすると、ネイティブチャネルレイアウトにフォールバックします。 （あなたは使用することができます
--ad-lavc-downmix = no デコーダーが常にネイティブレイアウトを出力するようにします。）注
一部のデコーダーのみがオーディオのリミックスをサポートしていること。 AC-3、AACまたは
DTSオーディオ。

メディアファイル（つまりデコーダー）のチャネルレイアウトとAOのチャネルの場合
レイアウトが一致しない場合、mpvは変換フィルターを挿入しようとします。

警告

使い方 オート HDMI経由でオーディオを使用する場合に問題が発生する可能性があります。 OSは
通常、HDMIを経由できるすべてのチャネルレイアウトを報告します。
受信機はそれらをサポートしていません。 受信者がサポートされていないチャネルを取得した場合
レイアウト、追加のドロップなど、ランダムなことが発生する可能性があります
チャネル、またはノイズを追加します。

--audio-display =
このオプションをに設定する 添付ファイル （デフォルト）画像の添付ファイルを表示します（例：
アルバムカバーアート）オーディオファイルを再生するとき。 最初に見つかった画像が表示されます。
追加の画像はビデオトラックとして利用できます。

このオプションをに設定する いいえ オーディオの再生時にビデオの表示を完全に無効にします
ファイル。

このオプションは、通常のビデオトラックを含むファイルには影響しません。

--audio-file =
ビデオを見ながら、外部ファイルからオーディオを再生します。 このオプションを使用するたびに
新しいオーディオトラックを追加します。 詳細はどのように似ています -サブファイル 作品。

--audio-format =
オーディオフィルターレイヤーからサウンドへの出力に使用するサンプルフォーマットを選択します
カード。 その値 採用できるのは、以下の説明に記載されています
形式でアーカイブしたプロジェクトを保存します． オーディオフィルター。

--audio-samplerate =
使用する出力サンプルレートを選択します（もちろん、サウンドカードには制限があります
これ）。 選択したサンプル周波数が現在のサンプル周波数と異なる場合
メディアの場合、lavrresampleオーディオフィルターはオーディオフィルターレイヤーに挿入されます
違いを補うために。

--gapless-audio =
の時点で沈黙や混乱なしに連続したオーディオファイルを再生してみてください
ファイルの変更。 ディフォルト： 弱い.

いいえ ギャップレスオーディオを無効にします。

はい オーディオデバイスは、最初のパラメータに従って選択されたパラメータを使用して開かれます
ファイルが再生され、ギャップレス再生のために開いたままになります。 これは、
たとえば、最初のファイルのサンプルレートは低く、次のファイルは
同じ低いサンプルレートにリサンプリングされ、サウンドが低下する可能性があります
品質。 異なるパラメータでファイルを再生する場合は、オプションの使用を検討してください
など --オーディオサンプルレート および --オーディオ形式 何を明示的に選択するか
共有出力形式はになります。

弱い 通常、オーディオデバイスは開いたままになります（最初の形式を使用）
で初期化）。 デコーダーの出力が変化するオーディオフォーマットの場合、オーディオ
デバイスが閉じられ、再度開かれます。 これは、通常、ギャップがなくなることを意味します
同じ設定を使用してエンコードされたファイルを含むオーディオですが、そうではない可能性があります
他の場合はギャップレス。 （とは異なり はい、心配する必要はありません
非常に低品質の出力形式を設定する最初のファイルのようなコーナーケース、
それに続く高品質のファイルの再生を台無しにします。）

注:
この機能は簡単な方法で実装され、オーディオ出力デバイスに依存しています
あるファイルから別のファイルに移動しながら再生を継続するためのバッファリング。 もしも
新しいファイルの再生は、たとえば、から再生されるため、ゆっくりと開始されます。
リモートネットワークの場所、またはキャッシュ設定を指定したため
最初のキャッシュフィルに時間がかかると、バッファリングされたオーディオが不足する可能性があります
新しいファイルの再生を開始する前に。

--initial-audio-sync、 --no-initial-audio-sync
ビデオファイルを開始するとき、またはシークなどのイベントの後に、mpvはデフォルトで
オーディオストリームを変更して、ビデオと同じタイムスタンプから開始するようにします。
最初に無音を挿入するか、最初のサンプルを切り取ります。 無効化
このオプションにより、プレーヤーは古いmpvバージョンと同じように動作します：ビデオとオーディオ
開始タイムスタンプが異なっていても、両方ともすぐに開始され、その後ビデオ
後で正しい同期に到達するために、必要に応じてタイミングが徐々に調整されます。

--softvol-max = <100.0-1000.0>
最大増幅レベルをパーセントで設定します（デフォルト：130）。 130の値は
通常の約XNUMX倍の音量に調整できます。

--audio-file-auto = 、 --no-audio-file-auto
ビデオファイル名に一致する追加のオーディオファイルをロードします。 パラメータは次のように指定します
外部オーディオファイルの照合方法。 正確な デフォルトで有効になっています。

いいえ 外部オーディオファイルを自動的にロードしないでください。

正確な オーディオファイル拡張子（デフォルト）でメディアファイル名をロードします。

ファジー メディアファイル名を含むすべてのオーディオファイルをロードします。

を 現在のディレクトリにあるすべてのオーディオファイルをロードします。

--audio-client-name =
プレーヤーがオーディオAPIに報告するアプリケーション名。 必要に応じて便利です
別のオーディオプロファイルを強制する（PulseAudioなど）、または独自のプロファイルを設定する
libmpvを使用する場合のアプリケーション名。

--volume-restore-data =
再生履歴書で使用するために内部的に使用されます（例： quit_watch_later）。 復元
softvolだけでなくさまざまなAOが持つ可能性があるため、値は慎重に行う必要があります
値の範囲が異なり、音量を設定する場合は音量を復元したくない
システム全体に変更します。 通常のオプション（ - 音量）常に設定します
音量。 このオプションは、より安全な方法でボリュームを復元するために追加されました（
音量を設定するために使用される方法）、一般的には役に立ちません。 そのセマンティクスは
mpvに対してプライベートと見なされます。

使用禁止。

--audio-buffer =
音声出力の最小バッファを設定します。 オーディオデバイスは実際に
必要に応じて、より大きなバッファ。 デバイスがより小さなバッファを作成する場合、追加
オーディオは追加のソフトウェアバッファにバッファリングされます。

これを大きくすると、ソフトボリュームや他のフィルターの反応が遅くなります。
再生速度の変更に関する追加の問題、およびオーディオ形式でのプレーヤーのブロック
変更します。 バッファが小さいと、オーディオのドロップアウトが発生する可能性があります。

このオプションは、テストにのみ使用してください。 デフォルト以外の値が役立つ場合
重要なことに、mpv開発者に連絡する必要があります。

デフォルト：0.2（200ミリ秒）。

字幕
--サブなし
ファイルのロード時に字幕を選択しないでください。

--sub-demuxer = <[+] name>
の字幕デマルチプレクサタイプを強制する -サブファイル。 によって印刷されたようにデマルチプレクサの名前を付けます
--sub-demuxer = help.

--sub-delay =
字幕を遅らせる 秒。 負の値になる可能性があります。

--sub-file = subtitlefile
外部字幕のリストに字幕ファイルを追加します。

あなたが使用している場合 -サブファイル デフォルトでは、この字幕ファイルはXNUMX回だけ表示されます。

If -サブファイル 複数回使用する場合は、使用する字幕をで切り替えることができます
字幕トラックを循環させることによるランタイム。 一度にXNUMXつの字幕を表示することが可能です。
つかいます --シド 最初の字幕インデックスを選択するには、 -- セカンダリ SID を選択する
XNUMX番目のインデックス。 （インデックスは、端末出力の後に印刷されます。 --sid = 会場は
ストリームのリスト。）

--secondary-sid =
セカンダリ字幕ストリームを選択します。 これはに似ています --シド。 二次的な場合
字幕が選択されている場合、それはトップタイトルとしてレンダリングされます（つまり、
画面）通常の字幕と一緒に、XNUMXつの字幕をレンダリングする方法を提供します
一度に。

この機能に関連するいくつかの注意事項があります。 たとえば、ビットマップ字幕
常に通常の位置でレンダリングされるため、ビットマップ字幕を次のように選択します
二次字幕は重複する字幕になります。 二次字幕は
ビデオが無効になっている場合、端末に表示されることはありません。

注:
セカンダリでは、フォーマットタグのスタイリングと解釈が無効になっています
字幕。 内部的には、 --サブアスなし を取り除くために使用されます
スタイリング。

注:
メイン字幕ストリームに字幕を表示するフォーマットタグが含まれている場合
画面上部では、XNUMX番目の字幕と重なっています。 に
これを防ぐために、あなたは使うことができます --サブアスなし メイン字幕のスタイリングを無効にするには
ストリーム。

--sub-scale = <0-100>
テキスト字幕のフォントサイズを考慮します（デフォルト：1）。

注:
これはASS字幕にも影響し、誤った字幕につながる可能性があります
レンダリング。 注意して使用するか、使用してください --サブテキストのフォントサイズ を代わりにお使いください。

--sub-scale-by-window =
ウィンドウサイズで字幕を拡大縮小するかどうか（デフォルト：yes）。 これが
無効にすると、ウィンドウサイズを変更しても、字幕のフォントサイズは変更されません。

いいね -サブスケール、これはASS字幕を壊す可能性があります。

--sub-scale-with-window =
ビデオではなく、ウィンドウを基準にした字幕のフォントサイズを作成します。 これは
ビデオが隠蔽されていなくても、常に同じフォントサイズが必要な場合に便利です。
ウィンドウが完全に表示されます。たとえば、画面のアスペクトとウィンドウのアスペクトが一致しないためです（およびプレーヤー
黒いバーを追加します）。

デフォルト：はい。

このオプションの名前は間違っています。 紛らわしいほど似たサウンドオプションとの違い
-- ウィンドウごとのサブスケール つまり --サブスケールウィズウィンドウ まだ
おおよそのウィンドウサイズですが、他のオプションはこのスケーリングを無効にします。

プレーンテキストの字幕にのみ影響します（または、ASSの場合はASSに影響します --ass-style-override 高く設定されています
足りる）。

--ass-scale-with-window =
いいね --サブスケールウィズウィンドウ、ただし、ASS形式の字幕にのみ影響します。 好き
-サブスケール、これはASS字幕を壊す可能性があります。

デフォルト：いいえ。

--embeddedfonts、 --埋め込みフォントなし
MatroskaコンテナファイルとASSスクリプトに埋め込まれたフォントを使用します（デフォルト：有効）。
これらのフォントは、SSA / ASS字幕レンダリングに使用できます。

--sub-pos = <0-100>
画面上の字幕の位置を指定します。 値は垂直位置です
画面の高さの％での字幕の。

注:
これはASS字幕にも影響し、誤った字幕につながる可能性があります
レンダリング。 注意して使用するか、使用してください --サブテキストマージン-y を代わりにお使いください。

--sub-speed = <0.1-10.0>
字幕イベントのタイムスタンプに指定された値を掛けます。 修正に使用できます
フレームベースの字幕フォーマットの再生速度。 テキスト字幕にのみ影響します。

例

--sub-speed = 25 / 23.976` ロードされたフレームベースの字幕を再生します
23.976FPSで25のフレームレートを想定しています。

--ass-force-style = <[Style。] Param = Value [、...]>
一部のスタイルまたはスクリプト情報パラメーターをオーバーライドします。

例

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

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

注:
このオプションを使用すると、字幕のレンダリングが正しくなくなる可能性があります。

--ass-hinting =
フォントヒンティングの種類を設定します。 することができます：

なし ヒントなし（デフォルト）

光 FreeTypeオートヒンター、ライトモード

通常の FreeType自動ヒンター、通常モード

ネイティブ フォントネイティブヒント

警告

ヒントを有効にすると、テキストの位置が間違ってしまう可能性があります（状況によっては
ビデオの背景と一致するはずです）、またはの滑らかさを減らします
いくつかの不適切に作成されたASSスクリプトを使用したアニメーション。 しないことをお勧めします
本当に必要な場合を除いて、このオプションを使用してください。

--ass-line-spacing =
SSA / ASSレンダラーの行間隔の値を設定します。

--ass-shaper =
libassが使用するテキストレイアウトエンジンを設定します。

シンプルな Fribidiのみを使用し、高速で、一部の言語を正しくレンダリングしません

複雑な
HarfBuzzを使用し、より遅く、より広い言語サポート

複雑な デフォルトです。 libassがHarfBuzzに対してコンパイルされていない場合、libass
静かにに戻ります シンプルな.

--ass-styles =
指定されたファイルで見つかったすべてのSSA / ASSスタイルをロードし、それらをテキストのレンダリングに使用します
字幕。 ファイルの構文は、 【V4 スタイル] / [V4 + スタイル]
SSA / ASSのセクション。

注:
このオプションを使用すると、字幕のレンダリングが正しくなくなる可能性があります。

--ass-style-override =
ユーザースタイルのオーバーライドを適用するかどうかを制御します。

はい すべてを適用します -お尻-* スタイルオーバーライドオプション。 のデフォルトを変更する
これらのオプションのうち、誤った字幕レンダリングにつながる可能性があります（デフォルト）。

サインフ ような はい、ただし適用 -サブスケール 標識のみ

いいえ 字幕スクリプトによって強制されるように字幕をレンダリングします。

力 によって定義されたフォントスタイルを強制してみてください -サブテキスト-* オプション。 できる
レンダリングを簡単に中断します。

--お尻の力マージン
トップタイトルとサブタイトルが利用可能な場合、それらを黒い境界線に配置できるようにします。
字幕がASS形式の場合。

デフォルト：いいえ。

-- サブ使用マージン
トップタイトルとサブタイトルが利用可能な場合、それらを黒い境界線に配置できるようにします。
字幕がプレーンテキスト形式の場合（またはASSの場合） --ass-style-override 設定されている
十分に高いです）。

デフォルト：はい。

から名前が変更されました --ass-use-margins。 ASS字幕を境界線にも配置するには（
古いオプションはしました）、また追加します --お尻の力マージン.

--ass-vsfilter-aspect-compat =
アナモルフィックビデオを再生するときにSSA / ASS字幕を拡大して、
従来のVSFilterの動作。 このスイッチは、ビデオが保存されているときは効果がありません
正方形のピクセルで。

SSA / ASS字幕フォーマットに歴史的に最も一般的に使用されているレンダラー、
VSFilterは、字幕も引き伸ばされるという疑わしい動作をしていました
ビデオがアナモルフィック形式で保存されていて、表示にスケーリングが必要な場合。
この動作は通常望ましくなく、新しいバージョンのVSFilterが動作する可能性があります
別の方法で。 ただし、既存のスクリプトの多くは、
反対方向に物事を変更します。 したがって、そのようなスクリプトが表示された場合
「正しく」、意図したとおりに表示されません。 このスイッチは、
古いVSFilterの動作（望ましくありませんが、多くの既存のスクリプトで予期されています）。

デフォルトで有効になっています。

--ass-vsfilter-blur-compat =
規模 \ blur スクリプト解像度ではなくビデオ解像度によるタグ（
ディフォルト）。 これはVSFilterのバグであり、一部の人によると、これ以上修正することはできません。
互換性の名の下に。

これは、オフセットスケールの計算に実際のビデオ解像度を使用することに注意してください
ビデオフィルターチェーンやビデオ出力が使用するものではなく、ファクター。

--ass-vsfilter-color-compat =
（xy-）vsfilterのようなマングルカラー（デフォルト：基本）。 歴史的に、VSFilterは
色空間を認識しません。 SDに使用されている色空間であれば問題ありませんでした
ビデオ（BT.601）が使用されました。 しかし、すべてがHD（BT.709）に切り替わったとき、VSFilterは
RGBカラーをBT.601に変換し、ビデオフレームにレンダリングし、
フレームをビデオ出力に処理しました。ビデオ出力は、BT.709を使用して変換します。
RGB。 その結果、字幕の色が崩れました。 後で、悪いハックが上に追加されました
ASS形式を使用して、色をどのようにマングルするかを制御します。

基本 字幕がそれを示しているように見える場合は、BT.601-> BT.709マングリングのみを処理します
これは必須です（デフォルト）。

フル 完全に処理する YCbCr マトリックス によってサポートされるすべてのビデオ色空間を持つヘッダー
libassとmpv。 これはコーナーケースでひどい破損につながる可能性があり、そうではありません
互換性のために厳密に必要です（うまくいけば）、これがそうではない理由です
デフォルト。

力-601
字幕ヘッダーやビデオの色に関係なく、BT.601-> BT.709のマングリングを強制します
スペース。

いいえ カラーマングリングを完全に無効にします。 すべての色はRGBです。

それ以外のものを選択する いいえ 字幕の色はビデオに依存します
色空間。たとえば、理論的には字幕スクリプトを再利用することはできません。
別のビデオファイルで。 The --ass-style-override オプションはこれに影響しません
オプションが解釈されます。

--stretch-dvd-subs =
アナモルフィックビデオを再生するときにDVD字幕をストレッチして、フォントの見栄えを良くする
よくマスターされていないDVD。 ビデオが正方形で保存されている場合、このスイッチは効果がありません
ピクセル-DVD入力の場合はそうではありません。

多くのスタジオは、オーサリング時に正方形ピクセル用に設計されたビットマップフォントを使用する傾向があります
DVD。DVDプレーヤーでの再生時にフォントが引き伸ばされたように見えます。 このオプション
それらを修正しますが、一部の字幕の位置がずれる可能性があります（例：記号
翻訳）。

デフォルトでは無効です。

--stretch-image-subs-to-screen =
ビデオの余白を無視して、DVDやその他の画像の字幕を画面に拡大します。
これはと同様の効果があります -- サブ使用マージン テキスト字幕の場合、ただし
テキスト自体は、再配置されるだけでなく、引き伸ばされます。 （少なくとも一般的には
画像ビットマップは理論的には単一のビットマップで構成できるため、避けられません。
画面全体をカバーし、プレーヤーはテキスト部分が正確にどこにあるかわかりません
あります。）

このオプションでは、字幕が正しく表示されません。 注意して使用してください。

デフォルトでは無効です。

-サブアス、 --サブアスなし
ASS字幕をネイティブにレンダリングします（デフォルトで有効になっています）。

If --サブアスなし が指定されている場合、すべてのタグとスタイル宣言が削除され、
表示では無視されます。 字幕レンダラーは、で指定されたフォントスタイルを使用します
-サブテキスト- 代わりにオプション。

注:
使い方 --サブアスなし のレンダリングが正しくないか、完全に壊れている可能性があります
ASS / SSA字幕。 スタイリングを強制的にオーバーライドすると便利な場合があります
ASS字幕の、しかし一般的に避けるべきです。

注:
使用してみてください --ass-style-override = force を代わりにお使いください。

--sub-auto = 、 --サブオートなし
ビデオファイル名に一致する追加の字幕ファイルをロードします。 パラメータは次のように指定します
外部字幕ファイルの照合方法。 正確な デフォルトで有効になっています。

いいえ 外部字幕ファイルを自動的にロードしないでください。

正確な 字幕ファイル拡張子（デフォルト）でメディアファイル名をロードします。

ファジー メディアファイル名を含むすべてのサブをロードします。

を 現在のすべての潜水艦をロードし、 -サブパス ディレクトリ。

--sub-codepage =
システムがサポートしている場合 iconv(3)、このオプションを使用して字幕を指定できます
コードページ。 デフォルトでは、文字セットを推測するためにuchardetが使用されます。 mpvがない場合
uchardetでコンパイルすると、encaが使用されます。 mpvがどちらもコンパイルされていない場合
uchardetもencaも UTF-8：UTF-8-壊れた はデフォルトです。つまり、
UTF-8を使用します。それ以外の場合は、 UTF-8-壊れた 疑似コードページ（以下を参照）。

このオプションのデフォルト値は オート、その実際の効果は
ENCAがコンパイルされます。

警告

文字セットを強制すると、UTF-8であることがわかっている字幕でも
再コーディングされますが、これはおそらくあなたが期待するものではありません。 コードページの前に
utf8： 入力が有効でない場合にのみコードページを使用する場合
UTF-8。

例

· --sub-codepage = utf8：latin2 入力がUTF-2でない場合は、Latin8を使用します。

· --sub-codepage = cp1250 常にcp1250への再コーディングを強制します。

疑似コードページ UTF-8-壊れた 内部で使用されます。 コードページの場合、
字幕はUTF-8として解釈され、「ラテン1」はバイトのフォールバックとして解釈されます。
無効なUTF-8シーケンス。 iconvがこのモードに関与することはありません。

プレーヤーがENCAサポートを使用してコンパイルされている場合は、次の方法でプレーヤーを制御できます。
構文：

--sub-codepage = enca： ： コードページ>

ENCAがコードページを検出できるように、言語はXNUMX文字のコードを使用して指定されます
自動的。 無効な言語コードが入力された場合、mpvは文句を言ってリストします
有効な言語。 （ただし、このリストは、
変換コードは、たとえば外部字幕をロードするときに実際に呼び出されます）。
自動検出が失敗した場合は、フォールバックコードページが使用されます。 フォールバックが指定されていない場合、
UTF-8-壊れた 使用されている。

例

· --sub-codepage = enca：pl：cp1250 字幕が
ポーランド語、cp1250にフォールバック

· --sub-codepage = enca：pl ポーランド語のエンコーディングを推測し、UTF-8にフォールバックします。

· --sub-codepage = enca ユニバーサル検出を試して、UTF-8にフォールバックします。

プレーヤーがlibguessをサポートしてコンパイルされている場合は、次のコマンドで使用できます。

--sub-codepage = guess： ： コードページ>

libguessには常に言語が必要です。 ユニバーサル検出モードはありません。 つかいます
--sub-codepage = guess：help と同じ警告の対象となる言語のリストを取得するには
上記のENCAを使用します。

プレーヤーがuchardetサポートを使用してコンパイルされている場合は、次のコマンドで使用できます。

--sub-codepage = uchardet

このモードでは、言語やフォールバックコードページは使用されません。

--sub-fix-timing、 --サブフィックスタイミングなし
デフォルトでは、字幕のタイミングは、間の小さなギャップやオーバーラップを削除するように調整されています
字幕（差が210ミリ秒未満の場合、ギャップまたはオーバーラップは
NS）。

--サブ強制のみ
たとえばによって選択されたDVD字幕ストリームの強制字幕のみを表示します
- スラング.

--sub-fps =
字幕ファイルのフレームレートを指定します（デフォルト：video fps）。 テキストに影響します
字幕のみ。

注:
> video fpsは、フレームベースの字幕ファイルの字幕を高速化し、
時間ベースのもののためにそれらを遅くします。

また見てください -サブスピード オプションを選択します。

--sub-gauss = <0.0-3.0>
画像の字幕にガウスぼかしを適用します（デフォルト：0）。 これは、ピクセル化するのに役立ちます
DVD / Vobsubsは見栄えがします。 0以外の値もソフトウェア字幕に切り替わります
スケーリング。 遅いかもしれません。

注:
テキスト字幕には適用されません。

-サブグレー
画像の字幕をグレースケールに変換します。 黄色のDVD / Vobsubsの外観を作成するのに役立ちます
より良い。

注:
テキスト字幕には適用されません。

--sub-paths =
ビデオに一致する字幕を検索するための追加のディレクトリを指定します。 多数
ディレクトリは「：」（Windowsでは「;」）で区切ることができます。 パスは相対パスまたは相対パスにすることができます
絶対。 相対パスは、ビデオファイルディレクトリを基準にして解釈されます。

例

仮定して /パス/to/video/video.avi 再生され、
--sub-paths = sub：subtitles：/ tmp / subs が指定されている場合、mpvは
これらのディレクトリの字幕ファイル：

· / path / to / video /

· / path / to / video / sub /

· / path / to / video / subtitles /

· / tmp / subs /

・ NS 以下 構成サブディレクトリ（通常は 〜/ .config / mpv / sub /)

-サブ可視性、 --サブ可視性なし
字幕の表示を無効にするために使用できますが、それでも字幕を選択してデコードします。

--サブクリアオンシーク
（あいまいで、ほとんど役に立ちません。）壊れたmkvファイルを重複して再生するために使用できます
ReadOrderフィールド。 ReadOrderは、MatroskaスタイルのASSサブタイトルの最初のフィールドです
パケット。 それはユニークでなければならず、libassはそれを使用して迅速に排除します
重複します。 このオプションは、シーク間での字幕のキャッシュを無効にするため、シーク後
libassは、以前のパケットと同じReadOrderを持つサブタイトルパケットを削除できません。

ウィンドウ
--title =
ウィンドウのタイトルを設定します。 これはビデオウィンドウに使用され、可能であればセットも使用されます
オーディオストリームのタイトル。

プロパティが展開されます。 （見る プロパティ 拡張.)

警告：
これにより、CPU使用率が高くなる危険性があります。
使用されるプロパティ。 ウィンドウタイトルの変更は、多くの場合、時間がかかる操作です。
タイトルはフレームごとに変わるため、再生が台無しになる可能性があります。

--screen =
マルチモニター構成（つまり、複数にまたがる単一のデスクトップ）
表示）、このオプションは、ビデオを表示する画面をmpvに指示します。

注（X11）

このオプションは、すべてのウィンドウマネージャーで正しく機能するわけではありません。 これらの中で
場合、あなたは使用してみることができます -ジオメトリ ウィンドウを明示的に配置します。
ウィンドウマネージャがネイティブ機能を提供することも可能です
アプリケーションウィンドウが使用する画面を制御します。

参照 --fs-screen.

- 全画面表示、 --fs
フルスクリーン再生。

--fs-screen =
マルチモニター構成（つまり、複数にまたがる単一のデスクトップ）
ディスプレイ）、このオプションはmpvにフルスクリーンにする画面を指示します。 もしも デフォルト is
提供されたmpvは、ユーザーの動作に応じて動作の使用にフォールバックします
で提供 screen オプションを選択します。

注（X11）

このオプションは、ウィンドウマネージャーでのみ正しく機能します。
EWMHを理解する _NET_WM_FULLSCREEN_MONITORS ヒント。

注（OS X）

を OS Xでは動作せず、次のように動作します 現在.

参照 - 画面.

--fs-ブラックアウト画面
OSXのみ。 フルスクリーンにするときは、他のディスプレイを黒く塗りつぶしてください。

--keep-open =
ファイルの終わりを超えて再生またはシークするときに終了しないでください。
次に再生されるファイルではありません（および - ループ 使用されません）。 代わりに、プレーヤーを一時停止します。
ファイルの終わりを超えてシークしようとすると、プレーヤーはシークしようとします
最後のフレーム。

次の引数を指定できます。

いいえ 現在のファイルが終了した場合は、次のファイルに移動するか、終了してください。 （ディフォルト。）

はい 現在のファイルが最後のプレイリストエントリである場合は、終了しないでください。 同等
〜へ -開いたままにする 引数なし。

常に いいね はい、ただし、最後のプレイリストエントリより前のファイルにも適用されます。 この
つまり、再生が自動的に次のファイルに進むことはありません。

注:
このオプションは、使用時に尊重されません -フレーム。 明示的にスキップして
バインディングが使用する場合は次のファイル 力 再生も終了します。

また、エラーや異常な状況が発生した場合、プレーヤーはとにかく終了することができます。

mpv 0.6.0以降、プレイリストに次のファイルがある場合、または
プレイリストがループしています。 およそ、これはプレイヤーが通常のときに一時停止します
終了しますが、実際にはそうではないコーナーケースがあります（例：
mpv -開いたままにする ファイル.mkv / dev / null file.mkvを正常に再生し、その後開くことができません
/ dev / null、次に終了します）。 （mpv 0.8.0では、 常に 古いものを復元するが導入されました
行動。）

--force-window =
ビデオがない場合でも、ビデオ出力ウィンドウを作成します。 これは、次の場合に役立ちます。
mpvがGUIアプリケーションであるふりをします。 現在、ウィンドウのサイズは常に
640x480、および対象 -ジオメトリ, --自動調整、および同様のオプション。

警告：
ウィンドウは初期化後にのみ作成されます（デフォルトのウィンドウを確認するため）
ビデオサイズが -- 強制ウィンドウ
デフォルトのウィンドウサイズ）。 初期化が機能しない場合、これは問題になる可能性があります
ネットワーク接続が悪いURLを開いたり、開いたりする場合など、完全に
壊れたビデオファイル。 ザ 即時の モードを使用して、常にウィンドウを作成できます
プログラムの開始時に、しかしこれは他の問題を引き起こす可能性があります。

--上に
プレーヤーウィンドウを他のウィンドウの上に置いたままにします。

Windowsでは、フルスクリーンモードと組み合わせると、mpvは次のように扱われます。
デスクトップウィンドウマネージャーをバイパスする専用のフルスクリーンウィンドウ。

- 国境、 - 境界はない
ウィンドウの境界線と装飾を使用してビデオを再生します。 これはデフォルトでオンになっているため、
- 境界はない 標準のウィンドウ装飾を無効にします。

--すべてのワークスペース上
（X11のみ）すべての仮想デスクトップにビデオウィンドウを表示します。

--geometry = <[W [xH]] [+ -x + -y]>、 --geometry =
初期ウィンドウの位置またはサイズを調整します。 W および H ウィンドウサイズをピクセル単位で設定します。
x および y ウィンドウの位置を設定します。これは、の左上隅からピクセル単位で測定されます。
表示されている画像の左上隅に画面が表示されます。 パーセント記号の場合
(%）引数の後に指定すると、値が画面のパーセンテージに変換されます
その方向のサイズ。 位置は標準のX11と同様に指定されます
-ジオメトリ オプション形式。たとえば、+ 10-50は「左から10ピクセル配置」を意味します。
境界線と下の境界線から50ピクセル」および「-20 + -10」は「20ピクセルを配置する」を意味します
右を超えて、上部の境界を超えて10ピクセル」。

外部ウィンドウがを使用して指定されている場合 --幅 オプションの場合、このオプションは無視されます。

座標は、で指定された画面を基準にしています - 画面 ビデオ出力用
完全にサポートするドライバー - 画面.

注:
通常、GUIVOでのみサポートされます。 エンコーディングでは無視されます。

注（X11）

このオプションは、すべてのウィンドウマネージャーで正しく機能するわけではありません。

例

50:40 ウィンドウをx = 50、y = 40に配置します。

50％：50％
画面の中央にウィンドウを配置します。

100％：100％
画面の右下隅にウィンドウを配置します。

50% ウィンドウ幅を画面幅の半分に設定します。 窓の高さが設定されているので
ウィンドウのアスペクト比がビデオであること。

50％x50％
ウィンドウの幅と高さを画面の幅と高さの半分に強制します。
ビデオのアスペクト比を補正するために黒い境界線が表示されます（
ほとんどのVOとなし --ノーキープアスペクト).

50％+ 10 + 10
ウィンドウを画面幅の半分に設定し、10ピクセルの位置に配置します
画面の左上隅の下/左。

参照 --自動調整 および --autofit-大きい ウィンドウを特定のサイズに合わせるため
アスペクト比を変更せずに。

--autofit = <[W [xH]]>
初期ウィンドウサイズをで指定された最大サイズに設定します 幅x高さ、変更せずに
ウィンドウのアスペクト比。 サイズはピクセル単位で測定されます。
パーセント記号が続きます（%）、画面サイズのパーセント単位。

このオプションは、ウィンドウのアスペクト比を変更することはありません。 アスペクト比の場合
不一致の場合、ウィンドウのサイズは、指定されたサイズに収まるまで縮小されます。

ウィンドウの位置は考慮されません。また、このオプションによって変更されることもありません（
ウィンドウマネージャは、サイズに応じてウィンドウの配置が異なる場合があります）。 つかいます
-ジオメトリ ウィンドウの位置を変更します。 この後、その効果が適用されます
オプションを選択します。

詳細はこちら： -ジオメトリ マルチモニター設定でこれがどのように処理されるかについての詳細。

　 --autofit-大きい 代わりに、最大サイズを制限したいだけの場合
常にウィンドウサイズを強制するのではなく、ウィンドウ。

　 -ジオメトリ ウィンドウの幅と高さの両方を特定の値に強制する場合
サイズ。

注:
通常、GUIVOでのみサポートされます。 エンコーディングでは無視されます。

例

70% アスペクト比を維持しながら、ウィンドウ幅を画面サイズの70％にします。

1000 アスペクト比を維持しながら、ウィンドウ幅を1000ピクセルに設定します。

70％：60％
ウィンドウの70％を超えないように、ウィンドウをできるだけ大きくします。
画面の幅、または画面の高さの60％以上。

--autofit-larger = <[W [xH]]>
このオプションは、まったく同じように動作します --自動調整、ウィンドウサイズのみが変更されることを除いて
ウィンドウが指定されたサイズよりも大きくなる場合。

例

90％x80％
ビデオが画面幅の90％または画面の80％より大きい場合
高さ、幅が90％になるまでウィンドウを小さくします
画面、またはその高さが画面の 80% です。

--autofit-smaller=<[W[xH]]>
このオプションは、まったく同じように動作します --自動調整の最小サイズを設定することを除いて、
ウィンドウ（同じように --autofit-大きい 最大値を設定します)。

例

500x500
ウィンドウを幅 500 ピクセル以上、高さ 500 ピクセル以上にします (
ビデオの縦横比では、幅または高さが 500 を超えます。
アスペクト比を同じに保つため）。

--window-scale=
ビデオ ウィンドウのサイズをビデオ サイズの倍数 (または分数) に変更します。 このオプション
前に適用されます --自動調整 および他のオプションが適用されます（したがって、これをオーバーライドします
オプション）。

たとえば、 --window-scale=0.5 ビデオサイズの半分でウィンドウを表示します。

--cursor-autohide=
指定されたミリ秒後にマウスカーソルを自動的に非表示にします。 いいえ 意志
カーソルの自動非表示を無効にします。 常に カーソルが非表示のままであることを意味します。

--cursor-autohide-fs-only
このオプションを指定すると、カーソルは常にウィンドウ モードで表示されます。 の
全画面表示モードでは、カーソルが表示または非表示になります。 --カーソル-自動非表示.

--固定されていないvo, --fixed-vo
--no-fixed-vo 複数のファイルのビデオ ウィンドウを強制的に閉じて再度開く
(ファイルごとに XNUMX つの (非) 初期化)。

--force-rgba-osd-rendering
一部のビデオ出力が OSD とテキスト 字幕をレンダリングする方法を変更します。 これはしません
字幕の外観を変更し、パフォーマンスに影響するだけです。 VO の場合
ネイティブ ASS レンダリングをサポートします ( vdpau, OpenGLの, direct3d）、これは
GPU ドライバーとハードウェアに応じて、わずかに速くなったり遅くなったりします。 その他の VO については、
これはレンダリングを遅くするだけです。

--強制ウィンドウ位置
mpv のビデオ出力ウィンドウを強制的にデフォルトの場所に移動します。
ビデオ パラメータ、ビデオ ストリーム、またはファイルの変更。 これは以前はデフォルトでした
行動。 現在、X11 VO のみに影響します。

--heartbeat-cmd=
再生中に 30 秒ごとに実行されるコマンド システム（） -つまり、
シェル。 コマンド間の時間は、
--ハートビート間隔 オプション。 再生が一時停止している間は、コマンドは実行されません。

注:
mpv はこのコマンドをチェックせずに使用します。 確実にするのはあなたの責任です
セキュリティ上の問題は発生しません (たとえば、「.」が
Windowsのようにあなたのパスに）。 また、ビデオの再生時にのみ機能します (つまり、
　 -ビデオなし しかし、 -vo=ヌル).

これは、適切なXAPIをサポートしていないスクリーンセーバーを無効にするために「誤用」される可能性があります
（も参照してください --stop-スクリーンセーバー）。 これが難しすぎると思うなら、作者に聞いてください
適切な X API をサポートするためのスクリーンセーバー プログラムの。 注意してください
--stop-スクリーンセーバー ハートビート コードにはまったく影響しません。

xscreensaver の例

mpv --heartbeat-cmd="xscreensaver-command -無効にする」 file

GNOME スクリーンセーバーの例

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

--ハートビート間隔=
間の時間 --ハートビート-cmd 秒単位の呼び出し (デフォルト: 30)。

注:
これは、通常のスクリーンセーバーの操作にはまったく影響しません。

--維持しない、 --見守ってください
--ノーキープアスペクト 常にビデオをウィンドウ サイズに引き延ばし、
ウィンドウ マネージャーは、ウィンドウの縦横比を強制するヒントを示します。 (フルスクリーンでは無視されます
モード。）

--キープアスペクトウィンドウなし、 --キープアスペクトウィンドウ
--キープアスペクトウィンドウ (デフォルト) は、ウィンドウ サイズをビデオ アスペクトに固定します。
--キープアスペクトウィンドウなし この動作を無効にし、代わりに黒いバーを追加します
ウィンドウのアスペクトとビデオのアスペクトが一致しません。 これが実際に機能するかどうかは、
VO バックエンド。 (全画面モードでは無視されます。)

--monitoraspect=
モニターまたはテレビ画面の縦横比を設定します。 値 0 は、以前の
設定 (例: 構成ファイル)。 をオーバーライドします --モニターピクセルアスペクト 設定する場合
有効になりました。

参照 --モニターピクセルアスペクト および -ビデオアスペクト.

例

· --モニターアスペクト=4:3 or --monitoraspect=1.3333

· --モニターアスペクト=16:9 or --monitoraspect=1.7777

--monitorpixelaspect=
モニターまたはテレビ画面の単一ピクセルのアスペクトを設定します (デフォルト: 1)。 価値
1 の場合は、正方形のピクセルを意味します ((ほぼ?) すべての LCD で正しい)。 こちらもご覧ください --モニターアスペクト
および -ビデオアスペクト.

--停止スクリーンセーバー、 --no-stop-スクリーンセーバー
起動時にスクリーンセーバー (またはスクリーン ブランカーや同様のメカニズム) をオフにし、
終了時に再び有効にします (デフォルト: yes)。 次の場合、スクリーンセーバーは常に再度有効になります。
プレーヤーが一時停止します。

これは、すべてのビデオ出力またはプラットフォームでサポートされているわけではありません。 時々そうです
実装されていますが、動作しません (GNOME でよく発生します)。 あなたはできるかもしれません
を使用してこれを回避します --ハートビート-cmd を代わりにお使いください。

--wid=
これは mpv に既存のウィンドウにアタッチするように指示します。 をサポートする VO が選択されている場合
このオプションを選択すると、そのウィンドウがビデオ出力に使用されます。 mpv はビデオを次のようにスケーリングします。
このウィンドウのサイズ。縦横比が
動画の内容が異なります。

X11 では、ID は ウィンドウ X11で。 MPlayer/mplayer2 とは異なり、mpv
常に独自のウィンドウを作成し、wid ウィンドウを親として設定します。 ウィンドウは
親ウィンドウを完全に覆うように常にサイズ変更されます。 値 0 解釈される
特に、mpv はルート ウィンドウに直接描画します。

win32 では、ID は次のように解釈されます。 黄褐色. 値キャストとして渡します intptr_t。 MPV
X11 のように、独自のウィンドウを作成し、wid ウィンドウを親として設定します。

OSX/Cocoa では、ID は次のように解釈されます。 NSビュー*. 値キャストとして渡します intptr_t.
mpv は独自のサブビューを作成します。 OSXはウィンドウの埋め込みをサポートしていないため
これは libmpv でのみ機能し、外部プロセスから使用するとクラッシュします。
コマンドライン。

--ウィンドウのドラッグなし
ウィンドウをクリックしてマウス ポインタを移動するときは、ウィンドウを移動しないでください。

--x11-名前
X11 ベースのビデオ出力メソッドのウィンドウ クラス名を設定します。

--x11-netwm=
(X11 のみ) NetWM プロトコル機能の使用を制御します。

これは、壊れたウィンドウ マネージャーで役立つ場合とそうでない場合があります。 これにより、いくつかの
現在削除されている によって実装された機能 --fstype オプション。 実際、
このオプションがどの程度必要であったかは、開発者にはわかりません。
フィードバックは大歓迎です。

具体的には、 はい そうでない場合でも、NetWMフルスクリーンサポートの使用を強制します
WMで宣伝。 これは、意図的に壊れた WM の場合に役立ちます。
Xモナド。 (XMonad はおそらくフルスクリーン サポートを宣伝していません。
それ。 どうやら、とにかくフルスクリーンを使用したいアプリケーションは、
NetWM サポートのヒントを無視するか、回避策を提供してください。 XMonadの恥
故意に X プロトコルを破る (X が十分に悪くないかのように)。

デフォルトでは、NetWM サポートは自動検出されます (オート).

このオプションは将来削除される可能性があります。

--x11-bypass-compositor=
に設定した場合 はい (デフォルト)、コンポジターに mpv ウィンドウのリダイレクトを解除するように依頼します。 これ
使用 _NET_WM_BYPASS_COMPOSITOR ヒント。

ディスク Devices
--cdrom-device=
CD-ROM デバイスを指定します (デフォルト: / dev / cdrom).

--dvd-device=
DVD デバイスまたは .iso ファイル名を指定します (デフォルト: / dev / dvd）。 指定することもできます
以前に DVD から直接コピーしたファイルを含むディレクトリ (たとえば
vobcopy）。

例

mpv DVD：// --dvd-device=/パス/to/dvd/

--bluray-device=
(Blu-ray のみ) Blu-ray ディスクの場所を指定します。 Blu-ray のあるディレクトリである必要があります
構造。

例

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

--ブルーレイアングル=
一部の Blu-ray ディスクには、複数の角度から表示できるシーンが含まれています。 これ
オプションは、使用する角度を mpv に指示します (デフォルト: 1)。

--cdda-..。
これらのオプションは、mpv の CD オーディオ読み取り機能を調整するために使用できます。

--cdda-speed=
CDの回転速度を設定します。

--cdda-paranoia=<0-2>
パラノイア レベルを設定します。 0 以外の値を指定すると、
最初のトラック。

0 チェックを無効にする (デフォルト)

1 重複チェックのみ

2 完全なデータ修正と検証

--cdda-sector-size=
アトミック読み取りサイズを設定します。

--cdda-overlap=
検証中に最小オーバーラップ検索を強制しますセクター。

--cdda-toc-バイアス
TOCで報告されているトラック1の開始オフセットは次のようになります。
LBA 0 としてアドレス指定されます。一部のディスクでは、トラック境界を正しく取得するためにこれが必要です。

--cdda-toc-offset=
追加 セクタを、トラックのアドレス指定時に報告される値に変更します。 多分
負。

--cdda-skip=
（決して）不完全なデータ再構成を受け入れないでください。

--cdda-cdtext=
CD テキストを印刷します。 これは、パフォーマンスが低下するため、デフォルトでは無効になっています。
原因不明の CD-ROM ドライブ。

--dvd-speed=
DVD の速度を制限してみてください (デフォルト: 0、変更なし)。 DVD の基本速度は 1385 kB/s なので、
8x ドライブは、最大 11080 kB/s の速度で読み取ることができます。 速度が遅いほど、ドライブがより多くなります
静かな。 DVD を見るには、2700 kB/s で十分静かで高速です。 mpv は
ドライブを閉じると、速度がデフォルト値に戻ります。 少なくとも 100 の平均速度の値
kB/秒。 100 未満の値は、1385 kB/s の倍数を意味します。 --DVD 速度=8 選択する
11080kB/秒。

注:
速度を変更するには、DVDデバイスへの書き込みアクセスが必要です。

--dvd-angle=
一部の DVD には、複数の角度から表示できるシーンが含まれています。 このオプション
使用する角度を mpv に指示します (デフォルト: 1)。

イコライザ
--brightness=<-100-100>
ビデオ信号の明るさを調整します（デフォルト：0）。 すべての動画でサポートされているわけではありません
出力ドライバー。

--contrast=<-100-100>
ビデオ信号のコントラストを調整します（デフォルト：0）。 すべての動画でサポートされているわけではありません
出力ドライバー。

--saturation=<-100-100>
ビデオ信号の彩度を調整します（デフォルト：0）。 グレースケールを取得できます
このオプションで出力します。 すべてのビデオ出力ドライバーでサポートされているわけではありません。

--ガンマ=<-100-100>
ビデオ信号のガンマを調整します（デフォルト：0）。 すべての動画でサポートされているわけではありません
出力ドライバー。

--hue=<-100-100>
ビデオ信号の色相を調整します（デフォルト：0）。 あなたはの色のネガを得ることができます
このオプションを使用した画像。 すべてのビデオ出力ドライバーでサポートされているわけではありません。

デミュクサー
--demuxer=<[+]名前>
強制デマルチプレクサ タイプ。 強制するには、名前の前に「+」を使用します。 これはいくつかをスキップします
チェックします。 で印刷されたデマルチプレクサ名を付けます --demuxer=ヘルプ.

--demuxer-lavf-analyzeduration=
ストリーム プロパティを分析する最大秒数。

--demuxer-lavf-probescore=<1-100>
最低限必要な libavformat プローブ スコア。 値が小さいほど、必要なデータが少なくなります。
ロードされます (ストリームの開始が速くなります) が、ファイル形式の検出の信頼性が低くなります。
自動検出された libavformat デマルチプレクサーを強制するために使用できます。
は、検出の信頼性が十分ではないと考えています。 (デフォルト: 26)

--demuxer-lavf-allow-mimetype=
HTTP MIME タイプからのフォーマットの導出を許可します (デフォルト: yes)。 これを no に設定します
同じファイルが機能していても、HTTP からの再生が不思議なことに失敗するケース
ローカルディスクから。

これは、HTTP ストリームを開く際の待ち時間を短縮するためのデフォルトです。

--demuxer-lavf-format=
特定の libavformat デマルチプレクサーを強制します。

--demuxer-lavf-hacks=
デフォルトでは、一部の形式は他の形式とは異なる方法で処理されます。
それらを明示的にチェックします。 これらのほとんどは、奇妙または不完全なものを補います
libavformat デマルチプレクサーからの動作。 通過 いいえ これらを無効にします。 デバッグ用および
テストのみ。

--demuxer-lavf-genpts-mode=
パケット DTS から欠落パケット PTS 値を導出するためのモード。 ラフ 可能
libavformat の ジェントス オプションを選択します。 いいえ 無効にします。 これはデフォルトで有効になっていましたが、
しかし、それはもう必要ないと見なされました。 これを有効にすると、
タイムスタンプの問題、またはそれらを悪化させる。

--demuxer-lavf-o= = [、 = [、...]]
AVOptions を libavformat demuxer に渡します。

注意、パッチを作成する o= 不要であり、すべての不明なオプションを
AVOption システムは大歓迎です。 AVOptions の完全なリストは、FFmpeg にあります。
マニュアル。 一部のオプションは mpv オプションと競合する可能性があることに注意してください。

例

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

--demuxer-lavf-probesize=
検出フェーズ中にプローブするデータの最大量。 MPEG-TSの場合
この値は、スキャンする TS パケットの最大数を識別します。

--demuxer-lavf-buffersize=
libavformat に割り当てられたストリーム読み取りバッファーのサイズ (バイト単位) (デフォルト: 32768)。
サイズを小さくすると、レイテンシが低下する可能性があります。 libavformat は、
内部でバッファリングするか、すべてを完全に使用しないでください。

--demuxer-lavf-cryptokey=
デマルチプレクサが使用する暗号化キー。 これは、キーの生のバイナリ データです。
XNUMX 進文字列に変換されます。

--demuxer-mkv-字幕-プリロール、 --mkv-字幕-プリロール
どこかを検索するときに、埋め込まれたソフト サブタイトルを表示するように努力してください。 通常、それはできます
一部のコンテナが原因で、シーク ターゲットのサブタイトルが表示されないことがあります。
ファイル形式が設計されています。 字幕は、前または正確にシークした場合にのみ表示されます
字幕が最初に現れる位置まで。 さらに悪いことに、字幕はしばしば
関連付けられたビデオ フレームの前に非常にわずかに表示されるように調整されているため、
通常、ビデオ フレームをシークしても、その位置で字幕が分離されません。

このオプションを有効にすると、デマルチプレクサはシークの少し前にデータの読み取りを開始します
字幕が正しく表示されるようにします。 これにより、シークが遅くなることに注意してください。
常に動作することを保証するものではありません。 サブタイトルが十分に近い場合にのみ機能します
シーク対象に。

内部の Matroska デマルチプレクサーのみで動作します。 絶対および
hr-seeks であり、このオプションは相対または不正確なシークのみで動作を変更します。

あなたが使用することができます --demuxer-mkv-subtitle-preroll-secs データ量を指定するオプション
デマルチプレクサは、可能性のある字幕パケットを見つけるために、せいぜい先読みする必要があります。
重なります。 これを 0 に設定すると、このプリロール メカニズムが効果的に無効になります。 設定
値が非常に大きいと、シークが非常に遅くなる可能性があり、値が非常に大きいと、
シークごとに最初からシーク ターゲットまでファイル全体を完全に再読み取りします - シーク
ファイルの終わりに向かって遅くなる可能性があります。 詳細が乱雑で、価値がある
実際には、前のビデオ キーフレームのクラスターに切り捨てられます。

一部のファイル、特に新しい mkvmerge バージョンで多重化されたファイルには、情報があります。
どの字幕パケットがシークとオーバーラップするかを判断するために使用できる埋め込み
目標。 このような場合、mpv は読み取られるデータの量を最小限に抑えます。
(それでも読みますが を 最初のデータを含むクラスタ間のデータ
必要な字幕パケットとシーク ターゲット)。

参照 --hr-seek-demuxer-offset オプション。 このオプションは、同様の効果を達成できます。
ただし、hr-seek がアクティブな場合のみ。 任意のデマルチプレクサで動作しますが、多くのシークを行います
オーディオとビデオのデータをスキップするのではなくデコードする必要があるため、遅くなります。

--mkv-字幕-プリロール 非推奨のエイリアスです。

--demuxer-mkv-subtitle-preroll-secs=
詳細はこちら： --demuxer-mkv-subtitle-preroll.

--demuxer-mkv-probe-video-duration=
ファイルを開くときは、ファイルの最後までシークし、最後のタイムスタンプを確認します
ビデオ パケットに含まれており、それをファイルの長さとして報告します。 これは厳密に
Haali のみとの互換性。 このモードでは、オープニングが
遅くなる (特に http で再生する場合)、または壊れたファイルでの動作が遅くなる
ずっと悪いです。 したがって、このオプションは使用しないでください。

当学校区の はい モードは単にインデックスを使用し、最後から少数のブロックを読み取ります
ファイルの。 の フル モードは実際にファイル全体をトラバースし、
インデックスが存在しなくても信頼できる推定 (部分的なファイルなど)。

--demuxer-rawaudio-channels=
チャネル数 (またはチャネル レイアウト) --demuxer=rawaudio が使用されます (デフォルト:
ステレオ）。

--demuxer-rawaudio-format=
のサンプル形式 --demuxer=rawaudio (デフォルト: s16le)。 使用する
--demuxer-rawaudio-format=ヘルプ すべてのフォーマットのリストを取得します。

--demuxer-rawaudio-rate=
のサンプルレート --demuxer=rawaudio (デフォルト: 44 kHz)。

--demuxer-rawvideo-fps=
の XNUMX 秒あたりのフレーム数 --demuxer=rawvideo （デフォルト：25.0）。

--demuxer-rawvideo-w= 、 --demuxer-rawvideo-h=
のピクセル単位の画像寸法 --demuxer=rawvideo.

例

生の YUV サンプルを再生します。

mpv サンプル-720x576.yuv --demuxer=rawvideo \
--demuxer-rawvideo-w=720 --demuxer-rawvideo-h=576

--demuxer-rawvideo-format=
XNUMX 進数または文字列の色空間 (fourcc) --demuxer=rawvideo （ディフォルト： YV12).

--demuxer-rawvideo-mp-format=
の内部ビデオ形式別の色空間 --demuxer=rawvideo。 使用
--demuxer-rawvideo-mp-format=ヘルプ 可能な形式のリストについては。

--demuxer-rawvideo-codec=
使用時に rawvideo コーデックを選択する代わりに、ビデオ コーデックを設定します。
--demuxer=rawvideo. これは、コーデック名と同じ値を使用します --vd （しかし、それはします
デコーダー名は受け付けません)。

--demuxer-rawvideo-size=
使用時のフレーム サイズ (バイト) --demuxer=rawvideo.

--demuxer-max-packets= 、 --demuxer-max-bytes=
これは、demuxer が先にバッファできる量を制御します。 デマルチプレクサは
通常、必要なだけ先読みを試みるか、
--demuxer-readhead-secsを選択します。 --demuxer-max-... オプションを使用して制限できます
最大先読み。 これにより、壊れたファイルや
非同期再生。 demuxer は、次のパケットの読み取りを停止します。
の限界に達しています。 (制限は、
技術的な理由)

パケット キューのオーバーフロー警告が表示された場合は、これらの制限を高く設定してください。
通常の再生は、より大きなパケット キューで可能になります。

詳細はこちら： --リストオプション デフォルトと値の範囲。

--demuxer-thread=
デマルチプレクサを別のスレッドで実行し、一定量のプリフェッチを許可します。
パケット (デフォルト: yes)。 これを有効にすると、再生がスムーズになる場合がありますが、
もう一方の手は、シークまたはトラックの切り替えに遅延を追加する可能性があります。

--demuxer-readhead-secs=
If --demuxer スレッド が有効になっている場合、デマルチプレクサがバッファする量を制御します
秒単位で進みます (デフォルト: 1)。 パケットにタイムスタンプの違いがない限り
に返された最後のパケットに関連する先読み量よりも大きい
デマルチプレクサーは読み取りを続けます。

なお、 --キャッシュ秒 キャッシュが有効な場合、オプションはこの値を上書きします。
となり、値が大きくなります。

(多くのファイル形式は線形を保存しないため、この値はあいまいになる傾向があります
タイムスタンプ。)

--force-seekable=
メディアがシーク可能ではないとプレイヤーが判断した場合 (例: パイプからの再生、または
範囲リクエストをサポートしていないサーバーの http ストリームです)、
無効になります。 このオプションは、強制的に有効にすることができます。 キャッシュ内のシークの場合、
成功する可能性は十分にあります。

入力
--ネイティブキーリピート
代わりに、キーリピートの遅延と速度のシステム設定を使用します。 --入力-ar-遅延 および
--input-ar-rate. (これが適用されるかどうかは、VO バックエンドとその処理方法によって異なります
キーボード入力。 端末入力には適用されません。)

--入力-ar-遅延
キーの自動リピートを開始するまでのミリ秒単位の遅延（無効にする場合は0）。

--input-ar-rate
自動リピートでXNUMX秒間に生成するキー押下の数。

--input-conf=
mpv のデフォルトの場所以外の入力構成ファイルを指定します
構成ディレクトリ (通常は ~/.config/mpv/input.conf).

--no-input-default-bindings
mpv のデフォルト (組み込み) キーバインディングを無効にします。

--input-cmdlist
キーにバインドできるすべてのコマンドを出力します。

--input-doubleclick-time=
XNUMX回の連続したボタンの押下をダブルクリックとして認識するためのミリ秒単位の時間
（デフォルト：300）。

--入力キーリスト
コマンドにバインドできるすべてのキーを出力します。

--input-key-fifo-size=<2-65000>
キー イベントをバッファリングする FIFO のサイズを指定します (デフォルト: 7)。 あまりにも
小さないくつかのイベントが失われる可能性があります。 非常に大きな値に設定することの主な欠点
値は、特に遅いコマンドをトリガーするキーを押したままにすると、
キューに入れられたすべてのコマンドを処理している間、プレーヤーが応答しなくなる可能性があります。

-- 入力テスト
入力テストモード。 キーを押してコマンドを実行する代わりに、mpv は
OSD 上のキーとバインドされたコマンド。 ダミービデオで使用する必要があり、
プレーヤーを終了する通常の方法は機能しません (通常終了するキー バインディングは
他のバインディングと同様に、OSD のみに表示されます)。 見る 入力.CONF.

--input-file=
指定されたファイルからコマンドを読み取ります。 ほとんどの場合、FIFO で役立ちます。 mpv 0.7.0以降も
JSON コマンドを理解します ( JSONの IPC)、しかし、返信やイベントを取得することはできません。 使用する
--input-unix-ソケット 双方向の何かのために。 MS Windows では、JSON コマンドは
利用できません。

これは、直接ファイル記述子を指定することもできます fd://N (UNIX のみ)。 この中で
この場合、FD が書き込み可能であれば、JSON 応答が書き込まれます。

注:
指定されたファイルが FIFO mpv の場合、両端が開くため、いくつかの操作を実行できます。 echo
"求める 10 " > mp_パイプ パイプは有効なままです。

-- 入力端子、 --入力端子なし
--入力端子なし プレーヤーが標準から主要なイベントを読み取れないようにする
入力。 標準入力からデータを読み取るときに便利です。 これは自動的に有効になります
いつ - コマンドラインにあります。 設定しないといけない場面もある
手動で、たとえば開いた場合 / dev / stdin （またはシステム上の同等のもの）、標準入力を使用
プレイリストで、またはロードファイルまたはロードリストを介して後で標準入力から読み取る予定
スレーブ コマンド。

--input-unix-socket=
IPC サポートを有効にし、指定されたパスでリッスン ソケットを作成します。

詳細はこちら： JSONの IPC より詳細をご確認いただけます。

MS Windows では使用できません。

--input-appleremote=
(OS X のみ) Apple Remote サポートを有効/無効にします。 デフォルトで有効になっています (
libmpv)。

-- 入力カーソル, --入力カーソルなし
mpv が、ビデオ出力ドライバーによって報告されたポインター イベントを受信できるようにします。 必要
OSC を使用したり、DVD メニューのボタンを選択したりします。 サポートはVOに依存します
使用中で。

--input-media-keys=
(OS X のみ) メディア キーのサポートを有効/無効にします。 デフォルトで有効になっています (
libmpv)。

--input-right-alt-gr, --no-input-right-alt-gr
(Cocoa と Windows のみ) 右の Alt キーを Alt Gr として使用して、特殊な操作を生成します。
文字。 無効にすると、右側の Alt が Alt 修飾キーとしてカウントされます。 によって有効にされました
デフォルト。

--input-vo-keyboard=
適切なキーボードに参加できない VO のすべてのキーボード入力を無効にします
入力ディスパッチ。 すべての VO に影響するわけではありません。 通常、埋め込みのみに役立ちます。

X11 では、入力が有効になっているサブウィンドウは、キーボード入力が有効である限り、すべてのキーボード入力を取得します。
1. フォーカスされたウィンドウの子、および 2. マウスがサブウィンドウ内にある。 の
mpv ウィンドウを埋め込んでいるアプリケーションからすべてのキーボード入力を盗むことができます。
一方、マウスが外側にある場合、mpvウィンドウは入力を受け取りません
mpv にフォーカスがあっても、mpv ウィンドウの最新のツールキットはこれを回避します
奇妙な X11 の動作ですが、単純に外部ウィンドウを埋め込むと壊れます。

これを合理的に処理する唯一の方法は、XEmbed プロトコルを使用することです。
これらの問題を解決するために設計されました。 GTK が提供する Gtkソケット、XEmbed をサポートします。 Qt
新しいバージョンで機能するものは何も提供していないようです。

エンベダーが XEmbed をサポートしている場合、入力はデフォルト設定と
このオプションは無効になっています。 ご了承ください 入力デフォルトバインディング ではデフォルトで無効になっています
libmpv も - mpv のデフォルトのキーバインディングが必要な場合は有効にする必要があります。

(このオプションは から名前が変更されました。 --input-x11-キーボード.)

--input-app-events=
(OS X のみ) アプリケーション全体のキーボード イベントを有効/無効にして、キーボードが
ショートカットは、ウィンドウなしで処理できます。 デフォルトで有効になっています (
libmpv)。

OSD
--osc、 --OSCなし
オンスクリーン コントローラをロードするかどうか (デフォルト: yes)。

--OSD バーなし、 --osd-バー
OSD バーの表示を無効にします。 これにより、（シークなどの）いくつかのものが OSD を使用するようになります
バーの代わりにテキスト メッセージ。

これは、input.conf でコマンドごとに設定できます。 OSD- プレフィックス、
入力 command プレフィックス. OSD を完全に無効にする場合は、
--osd-レベル=0.

--osd-duration=
OSDメッセージの期間をミリ秒単位で設定します（デフォルト：1000）。

--osd-font= 、 --sub-text-font=
OSD に使用するフォントと、それ自体が指定されていない字幕に使用するフォントを指定します。
特定のフォント。 デフォルトは サンセリフ体.

例

· --osd-font='ビットストリーム Vera サンズ

· --osd-font='MS コミック サンズ

注:
当学校区の --サブテキストフォント オプション (および他のほとんどの -サブテキスト- options) は無視されます。
ASS 字幕はレンダリングされます。 --サブアスなし オプションが指定されています。

これは、以前は fontconfig パターンをサポートしていました。 libass 0.13.0 から、これは
動作を停止。

--osd-font-size= 、 --sub-text-font-size=
OSD/サブフォントのサイズを指定します。 単位は、ウィンドウでスケーリングされたピクセルのサイズです
高さ 720。実際の​​ピクセル サイズは、ウィンドウの高さでスケーリングされます。
ウィンドウの高さが 720 より大きくても小さくても、テキストの実際のサイズが大きくなります
または同様に減少します。

デフォルト：55。

--osd-msg1=
この文字列を OSD レベル 1 の OSD にメッセージとして表示します (デフォルトで表示)。 の
メッセージはデフォルトで表示され、他のメッセージがそれを覆っていない限り、
OSD レベルは変更されません ( --osd レベル）。 プロパティを展開します。 見る プロパティ
拡張.

--osd-msg2=
と同様 --osd-msg1、ただし OSD レベル 2 の場合。これが空の文字列の場合 (デフォルト)、
再生時間が表示されます。

--osd-msg3=
と同様 --osd-msg1、ただし OSD レベル 3 の場合。これが空の文字列の場合 (デフォルト)、
次に、再生時間、継続時間、およびその他の情報が表示されます。

これは、 show_progress コマンド (デフォルトでは P）、または
シーク時のデフォルト以外のケース。

--osd-ステータス-メッセージ 従来の同等物です (ただし、わずかな違いがあります)。

--osd-status-msg=
再生中に、標準のステータス テキストの代わりにカスタム文字列を表示します。 これ
に使用されるステータス テキストを上書きします --osd-レベル=3、を使用する場合 show_progress
コマンド (デフォルトでは P）、またはシーク時のデフォルト以外の場合。
プロパティを展開します。 見る プロパティ 拡張.

このオプションは --osd-msg3。 唯一の違いはこれ
オプションは暗黙的に含む ${osd-sym-cc}. 次の場合、このオプションは無視されます。 --osd-msg3 is
空ではない。

--osd-playing-msg=
再生開始時に OSD にメッセージを表示します。 プロパティの文字列が展開され、
マシン情報の記入> という構文でなければなりません。例えば、 --osd-playing-msg='ファイル: ${ファイル名}' メッセージが表示されます ファイル： 続い
スペースと現在再生中のファイル名。

詳細はこちら： プロパティ 拡張.

--osd-bar-align-x=<-1-1>
OSD バーの位置。 -1 は左端、0 は中央、1 は右端です。 分数
値 (0.5 など) を使用できます。

--osd-bar-align-y=<-1-1>
OSD バーの位置。 -1 は上、0 は中央、1 は下です。 小数値
(0.5 など) が許可されます。

--osd-bar-w=<1-100>
OSD バーの幅 (画面幅のパーセンテージ) (デフォルト: 75)。 の値
50 は、バーが画面の半分の幅であることを意味します。

--osd-bar-h=<0.1-50>
OSD バーの高さ (画面の高さに対するパーセンテージ) (デフォルト: 3.125)。

--osd-back-color= 、 --sub-text-back-color=
詳細はこちら： --OSD-カラー. OSD/サブテキストの背景に使用される色。

--osd-blur=<0..20.0>, --sub-text-blur=<0..20.0>
ガウスぼかし係数。 0 は、ぼかしが適用されていないことを意味します (デフォルト)。

--osd-太字= 、 --sub-text-bold=
テキストを太字にフォーマットします。

--osd-border-color= 、 --sub-text-border-color=
詳細はこちら： --OSD-カラー. OSD/サブフォントの枠線に使用する色。

注:
無視される場合 --osd-バックカラー/--サブテキストのバックカラー が指定されている (またはそれ以上
正確には、そのオプションが完全に透明に設定されていない場合)。

--osd-border-size= 、 --sub-text-border-size=
スケーリングされたピクセル単位の OSD/サブ フォントの境界線のサイズ (を参照) --osd-フォントサイズ 詳細については）。
値 0 は境界線を無効にします。

デフォルト：3。

--osd-color= 、 --sub-text-color=
OSD/スタイルなしテキストの字幕に使用する色を指定します。

色はフォームで指定 r / g / b、各色成分が指定されている
0.0 から 1.0 の範囲の数値として。 透明度指定も可能
使用して、 r/g/b/a、ここで、アルファ値 0 は完全に透明であることを意味し、1.0 は完全に透明であることを意味します
不透明。 アルファ コンポーネントが指定されていない場合、色は 100% 不透明になります。

オプションに単一の数値を渡すと、OSD がグレーに設定され、フォームが グレー/a
さらにアルファを指定できます。

例

· --osd-color=1.0/0.0/0.0 OSD を不透明な赤に設定する

· --osd-color=1.0/0.0/0.0/0.75 OSD を 75% アルファの不透明な赤に設定します

· --osd-color=0.5/0.75 OSD を 50% グレー、75% アルファに設定

または、色を次の形式で RGB XNUMX 進数トリプレットとして指定することもできます。 #RRGGBB,
各 2 桁のグループは、範囲 0 の色の値を表します (00）から255（FF).
たとえば、 ＃FF0000 赤い。 これは Web の色に似ています。 アルファは
#AARRGGBB.

例

· --osd-color='#FF0000' OSD を不透明な赤に設定する

· --osd-color='#C0808080' OSD を 50% グレー、75% アルファに設定

--osd-分数
OSD 時間を秒単位で表示します (ミリ秒の精度)。 見ると便利
ビデオ フレームの正確なタイムスタンプ。

--osd-level=<0-3>
OSDを開始するモードを指定します。

0 OSD 完全無効 (字幕のみ)

1 有効 (ユーザー インタラクションでのみ表示)

2 有効 + デフォルトで表示される現在の時刻

3 有効 + --osd-ステータス-メッセージ (デフォルトでは現在の時刻とステータス)

--osd-margin-x= 、 --sub-text-margin-x=
スケーリングされたピクセル単位の OSD/サブの左右の画面余白 (を参照) --osd-フォントサイズ
詳細については）。

このオプションは、OSD の左への距離を指定します。
右端から離れると長い OSD テキストが壊れます。

デフォルト：25。

--osd-margin-y= 、 --sub-text-margin-y=
スケーリングされたピクセル単位の OSD/サブ画面の上下の画面マージン (を参照) --osd-フォントサイズ
詳細については）。

このオプションは、OSD の垂直マージンを指定します。 これはまたのために使用されます
スタイルのないテキスト字幕。 縦字幕の位置だけ上げたい場合は、
つかいます --サブポジション.

デフォルト：22。

--osd-align-x= 、 --sub-text-align-x=...
OSD またはテキスト字幕を画面のどの隅に揃えるかを制御します
（ディフォルト： センター サブ用に、 左 OSD 用)。

以下を除き、ASS 字幕には適用されません。 --サブアスなし モード。 同様に、これは
画像字幕には適用されません。

--osd-align-y= --sub-text-align-y=...
垂直位置 (デフォルト: ボトム サブ用に、 top OSD 用)。 詳細はこちら
--osd-align-x.

--osd-scale=
OSD フォント サイズ乗数、乗算 --osd-フォントサイズ の値です。

--osd-scale-by-window=
ウィンドウ サイズで OSD をスケーリングするかどうか (デフォルト: yes)。 これが無効になっている場合、
--osd-フォントサイズ スケーリングされたピクセルを使用するその他の OSD オプションは、常に実際の
ピクセル。 つまり、ウィンドウ サイズを変更しても OSD フォント サイズは変更されません。

--osd-shadow-color= 、 --sub-text-shadow-color=
詳細はこちら： --OSD-カラー. OSD/サブテキストの影に使用される色。

--osd-shadow-offset= 、 --sub-text-shadow-offset=
スケーリングされたピクセルでの OSD/サブテキストの影の変位 (を参照) --osd-フォントサイズ の
詳細）。 値 0 は影を無効にします。

デフォルト：0。

--osd-spacing= 、 --sub-text-spacing=
スケーリングされたピクセル単位の水平 OSD/サブフォント間隔 (を参照) --osd-フォントサイズ 詳細については）。
この値は、通常の文字間隔に追加されます。 負の値を使用できます。

デフォルト：0。

スクリーンショット
--スクリーンショット形式=
スクリーンショットの保存に使用する画像ファイルの種類を設定します。

利用可能な選択肢：

PNG PNG

ppmの PPM

pgm PGM

pgmyuv YV12 ピクセル形式の PGM

TGA タルガ

JPG JPEG (デフォルト)

JPEG JPEG (jpg と同じですが、拡張子が .jpeg のファイル)

--screenshot-tag-colorspace=
適切な色空間でスクリーンショットにタグを付けます。

すべての形式がサポートされているわけではないことに注意してください。

デフォルト： いいえ.

--screenshot-high-bit-depth=
可能であれば、ソース ビデオと同様のビット深度でスクリーンショットを作成します
(デフォルト: はい)。 これは特に PNG にとって興味深いものです。
巨大なファイル サイズの 16 ビット PNG の書き込みをトリガーします。

--screenshot-template=
スクリーンショットの保存に使用するファイル名テンプレートを指定します。 テンプレートは、
ファイル拡張子なしのファイル名であり、フォーマット指定子を含めることができます。
スクリーンショットを撮るときに置き換えられます。 デフォルトでは、テンプレートは MPV ショット%n、その
次のようなファイル名になります mpv-shot0012.png 例えば。

テンプレートは、相対パスまたは絶対パスで開始して、
スクリーンショットを保存するディレクトリの場所。

最終的なスクリーンショットのファイル名が既存のファイルを指している場合、そのファイルは
上書きされません。 スクリーンショットは保存されないか、テンプレートが
含まれています %n、新しく生成された別のファイル名を使用して保存されます。

許可されているフォーマット指定子:

%[#][0X]n
長さ X になるまでゼロが埋め込まれたシーケンス番号 (デフォルト: 04)。 例えば
フォーマットを渡す ％04n 降伏します 0012 12枚目のスクリーンショット。 数字
スクリーンショットが撮影されるたびに、またはファイルが既に作成されている場合に増分されます
存在します。 長さ X 0 ～ 9 の範囲でなければなりません。 オプションの # 記号を使用すると、mpv
利用可能な最小の番号が使用されます。 例えば、XNUMXつ取ると
スクリーンショット -- 0001、0002、0003 -- 最初の XNUMX つと次の XNUMX つを削除します
スクリーンショットは 0004 と 0005 ではなく、0001 と 0002 になります。

%f 現在再生中の動画のファイル名。

%F と同じ %f、ただし、ドットを含むファイル拡張子を削除します。

%x 現在再生中の動画のディレクトリ パス。 ビデオが
ファイルシステム（ただし、たとえば http://)、これは空の文字列に展開されます。

%X{フォールバック}
と同じ %xを返しますが、ビデオ ファイルがファイル システムにない場合は、
内部のフォールバック文字列 {...}.

%p OSD で使用されているものと同じ形式の現在の再生時間。 結果は
「HH:MM:SS」形式の文字列。 たとえば、ビデオが当時のものである場合
5分34秒位、 %p 「00:05:34」に置き換えられます。

%P そして %p、ただし、ミリ秒単位の再生時間で拡張されます。 それは
"HH:MM:SS.mmm" の形式で、"mmm" はミリ秒の部分です。
再生時間。

注:
これは、フレームごとの一意のタイムスタンプを取得する簡単な方法です。 （フレーム
数値の方が直感的ですが、実装が容易ではありません。
コンテナ形式は通常、タイムスタンプを使用してフレームを識別します。)

%wX フォーマット文字列を使用して現在の再生時間を指定します X. %p のようなものです
%wH:%wM:%wS, %P のようなものです %wH:%wM:%wS.%wT.

有効な 形式でアーカイブしたプロジェクトを保存します． 指定子：

%wH 時間 (0 から XNUMX 桁で埋められます)

%w 時間 (パディングなし)

%wM 分 (00-59)

%wm 合計分 (時間も含まれます。 %wM)

%wS 秒 (00-59)

%ws 合計秒数 (時間と分を含む)

%wf ような %ws、しかしフロートとして

%wT ミリ秒 (000-999)

%tX 形式を使用して現在のローカル日付/時刻を指定します。 X。 このフォーマット
指定子は UNIX を使用します strftime（） 関数を内部的に挿入し、
"%X" を渡した結果 ストラフタイム。 例えば、 ％tm 番号を挿入します
現在の月の数として。 複数使う必要がある %tX への指定子
完全な日付/時刻文字列を作成します。

%{prop[:フォールバック 文章]}
スレーブ プロパティ「prop」の値を挿入します。 例えば ％{ファイル名} 同じです
as %f. プロパティが存在しないか利用できない場合は、エラー テキストが表示されます。
フォールバックが指定されていない限り、挿入されます。

%% に置き換えられました % キャラクター自体。

--screenshot-directory=
スクリーンショットをこのディレクトリに保存します。 このパスはファイル名と結合されます
によって生成されます -- スクリーンショット テンプレート. テンプレートのファイル名がすでに絶対的な場合、
ディレクトリは無視されます。

ディレクトリが存在しない場合は、最初のスクリーンショットで作成されます。 もしそれが
ディレクトリではなく、スクリーンショットを書き込もうとするとエラーが発生します。

このオプションはデフォルトでは設定されていないため、スクリーンショットをディレクトリに書き込みます
そこから mpv が開始されました。 疑似 GUI モード (を参照) 擬似 GUI モード）、これが設定されています
デスクトップに。

--screenshot-jpeg-quality=<0-100>
JPEG 品質レベルを設定します。 高いほど品質が良いことを意味します。 デフォルトは 90 です。

--screenshot-jpeg-source-chroma=
ビデオと同じ彩度サブサンプリングで JPEG ファイルを書き込みます (デフォルト: yes)。 もしも
無効にすると、libjpeg のデフォルトが使用されます。

--screenshot-png-compression=<0-9>
PNG 圧縮レベルを設定します。 高いほど圧縮率が高くなります。 これは影響します
書き込まれたスクリーンショット ファイルのファイル サイズと、
スクリーンショット。 圧縮率が高すぎると、中断するのに十分な CPU 時間が占有される可能性があります
再生。 デフォルトは 7 です。

--screenshot-png-filter=<0-5>
PNG 圧縮の前に適用されるフィルターを設定します。 0 はなし、1 は「サブ」、2 は「アップ」、
3は「普通」、4は「ペイス」、5は「混合」です。 これはのレベルに影響します
達成できる圧縮。 ほとんどの画像では、「混合」が最適です。
圧縮率なので、これがデフォルトです。

ソフトウェア スケーラー
--sws-scaler=
使用するソフトウェア スケーラー アルゴリズムを指定します。 --vf=スケール. これも影響します
ハードウェア アクセラレーションを欠くビデオ出力ドライバ。 x11。 参照
--vf=スケール.

利用可能なスケーラーのリストを取得するには、次を実行します --sws-scaler=ヘルプ.

デフォルト： バイキュービック.

--sws-lgb=<0-100>
ソフトウェア スケーラー ガウスぼかしフィルター (輝度)。 見る --sws-スケーラー.

--sws-cgb=<0-100>
ソフトウェア スケーラー ガウスぼかしフィルター (彩度)。 見る --sws-スケーラー.

--sws-ls=<-100-100>
ソフトウェア スケーラー シャープ フィルター (輝度)。 見る --sws-スケーラー.

--sws-cs=<-100-100>
ソフトウェア スケーラー シャープ フィルター (彩度)。 見る --sws-スケーラー.

--sws-chs=
ソフトウェア スケーラー クロマ水平シフト。 見る --sws-スケーラー.

--sws-cvs=
ソフトウェア スケーラー クロマ垂直シフト。 見る --sws-スケーラー.

ターミナル
- 静かな
コンソール出力の冗長性を減らします。 特に、ステータス行 (つまり、AV:
3.4 (00:00:03.37) / 5320.6 ...) が表示されなくなりました。 低速で特に有用
改行を適切に処理しない端末または破損した端末 (つまり、 \r).

また見てください -本当に静か および --msg レベル.

-本当に静か
よりもさらに少ない出力およびステータスメッセージを表示します - 静かな.

--端末なし、 - ターミナル
端末と stdin/stdout/stderr の使用を無効にします。 これで完全に沈黙する
任意のメッセージ出力。

取消 -本当に静か、これにより、入力と端末の初期化も無効になります。

--no-msg-color
端末でのカラフルなコンソール出力を無効にします。

--msg-level=
各モジュールの冗長性を直接制御します。 の を モジュールはの冗長性を変更します
コマンドラインで明示的に指定されていないすべてのモジュール。

でmpvを実行します --msg-level=all=トレース すべてのメッセージ mpv 出力を表示します。 を使用できます。
出力に出力されるモジュール名 (各行の前に付けられます) [...]) を制限する
興味深いモジュールへの出力。

注:
一部のメッセージは、コマンドラインが解析される前に出力されるため、
影響を受けない --msg レベル. これらのメッセージを制御するには、
MPV_VERBOSE 環境変数; 見る ENVIRONMENT 変数 より詳細をご確認いただけます。

利用可能なレベル：

いいえ 完全な沈黙

致命的な 致命的なメッセージのみ

エラー エラーメッセージ

警告する 警告メッセージ

info 情報メッセージ

status ステータス メッセージ (デフォルト)

v 冗長なメッセージ

debug デバッグメッセージ

トレース 非常にノイズの多いデバッグ メッセージ

--term-osd、 --無期OSD、 --term-osd=強制
ビデオ出力が利用できない場合、コンソールに OSD メッセージを表示します。 によって有効にされました
デフォルト。

力 ビデオ ウィンドウが作成されている場合でも、ターミナル OSD を有効にします。

--term-osd-bar、 --no-term-osd-bar
ターミナルのステータス ラインの下にプログレス バーを表示できるようにします。 (によって無効化
デフォルト。）

--term-osd-bar-chars=
カスタマイズする --term-osd-bar 特徴。 文字列は 5 で構成されると予想されます
文字 (開始、左スペース、位置指示子、右スペース、終了)。 使用できます
Unicode 文字。ただし、全角文字は処理されないことに注意してください
正しく

デフォルト： [-+-].

--term-playing-msg=
再生開始後に文字列を出力します。 プロパティの文字列が展開され、
マシン情報の記入> という構文でなければなりません。例えば、 --term-playing-msg='ファイル: ${ファイル名}' 文字列を出力します ファイル： 続い
スペースと現在再生中のファイル名。

詳細はこちら： プロパティ 拡張.

--term-status-msg=
標準のステータス行の代わりに、再生中にカスタム文字列を出力します。
プロパティを展開します。 見る プロパティ 拡張.

--msg-モジュール
モジュール名を各コンソール メッセージの先頭に追加します。

--メッセージ時間
各コンソール メッセージの先頭にタイミング情報を追加します。

TV
- テレビ-...
これらのオプションは、TV キャプチャ モジュールのさまざまなプロパティを調整します。 テレビ視聴用
mpv で、使用 テレビ：// or テレビ：// あるいは テレビ：// （参照してください
オプション テレビチャンネル の チャンネル名 以下) メディア URL として。 使用することもできます
テレビ：/// コンポジットまたは S ビデオ入力からビデオの視聴を開始するには (
オプション 詳細については）。

--tv デバイス =
TV デバイスを指定します (デフォルト: / dev / video0).

--tv-channel=
チューナーをに設定チャネル。

--テレビオーディオなし
音が出ない

--tv-automute=<0-255> (v4l および v4l2 のみ）
デバイスによって報告された信号強度がこの値未満の場合、オーディオとビデオは
ミュートされます。 ほとんどの場合、automute=100 で十分です。 デフォルトは 0 (自動ミュート
無効）。

--tv-driver=
詳細はこちら： --tv=ドライバー=ヘルプ コンパイル済み TV 入力ドライバーのリストについては、 利用可能: ダミー,
v4l2 (デフォルト: 自動検出)

--tv-input=
入力を指定します（デフォルト：0（TV）、使用可能な入力についてはコンソール出力を参照してください）。

--tv-freq=
チューナーを設定する周波数を指定します (例: 511.250)。 と互換性がありません
チャネル パラメータ。

--tv-outfmt=
V4Lがサポートするプリセット値でチューナーの出力フォーマットを指定
ドライバー (YV12、UYVY、YUY2、I420) または XNUMX 進数値として指定された任意の形式。

--テレビの幅=
出力ウィンドウ幅

--テレビの高さ=
出力ウィンドウの高さ

--tv-fps=
ビデオをキャプチャするフレームレート（XNUMX秒あたりのフレーム数）

--tv-buffersize=
キャプチャバッファの最大サイズ（メガバイト単位）（デフォルト：動的）

--tv-norm=
利用可能なすべてのノルムのリストについては、コンソール出力を参照してください。 正常
以下のオプション。

--tv-normid= (v4l2 のみ）
TV ノルムを指定された数値 ID に設定します。 TV 規格は、キャプチャ カードによって異なります。
利用可能な TV 基準のリストについては、コンソール出力を参照してください。

--tv-chanlist=
利用可能: アルゼンチン、オーストラリア、中国-bcast、ヨーロッパ-東、ヨーロッパ-西、フランス、
アイルランド、イタリア、ジャパン・ブキャスト、ジャパン・ケーブル、ニュージーランド、ロシア、南アフリカ、
us-bcast、us-cable、us-cable-hrc

--tv-channels= - [= ]、 - [= ]、...
チャネルの名前を設定します。

注:
もしもが 1000 より大きい整数の場合、頻度として扱われます (
kHz) 周波数テーブルからのチャネル名ではなく。 名前のスペースには _ を使用します
（または引用で遊んでください;-)）。 チャンネル名は、OSD を使用して書き込まれます。
およびスレーブコマンド テレビステップチャンネル, テレビセットチャンネル および テレビ最後のチャンネル 意志
リモコンに使える。 と互換性がありません 周波数 パラメータに一致する最初のデバイスのリモートコントロール URL を返します。

注:
チャンネル番号は、「チャンネル」リストの最初の位置になります。
1で。

例

テレビ://1, テレビ://TV1, テレビセットチャンネル 1, テレビセットチャンネル TV1

--tv-[明るさ|コントラスト|色相|彩度]=<-100-100>
カードにイメージイコライザーを設定します。

--tv-audiorate=
入力オーディオのサンプルレートを設定します。

--tv-forceaudio
v4lによって報告されたオーディオソースがない場合でも、オーディオをキャプチャします。

--tv-alsa
ALSAからキャプチャします。

--tv-amode=<0-3>
オーディオモードを選択します。

0 モノ

1 ステレオ

2 言語1

3 言語2

--tv-forcechan=<1-2>
デフォルトでは、録音されたオーディオ チャンネルの数は、
TV カードからオーディオ モードを問い合わせます。 このオプションにより、ステレオ/モノラルを強制できます
amode オプションと v4l によって返される値に関係なく記録します。 これは
TV カードが現在のオーディオを報告できない場合のトラブルシューティングに使用します。
モード。

--tv-adevice=
オーディオデバイスを設定します。 する必要があります /dev/xxx OSS の場合は ID、ALSA の場合はハードウェア ID。
「:」は「.」に置き換える必要があります。 ALSA のハードウェア ID に。

--tv-audioid=
キャプチャカードに複数ある場合は、キャプチャカードのオーディオ出力を選択します。

--tv-[音量|低音|高音|バランス]=<0-100>
これらのオプションは、ビデオ キャプチャ カードのミキサーのパラメーターを設定します。 彼らはするだろう
あなたのカードに効果がない場合、効果はありません。 v4l2 の場合、50 がデフォルトにマップされます
ドライバーによって報告される、コントロールの値。

--tv-gain=<0-100>
ビデオ デバイス (通常は Web カメラ) のゲイン コントロールを目的の値に設定し、
自動制御をオフにします。 値 0 は、自動制御を有効にします。 これなら
オプションを省略した場合、ゲイン コントロールは変更されません。

--tv-immediatemode=
値 0 は、オーディオとビデオを一緒にキャプチャしてバッファリングすることを意味します。 値 1
(デフォルト) ビデオ キャプチャのみを行い、オーディオをループバックさせることを意味します。
TVカードからサウンドカードへのケーブル。

--tv-mjpeg
ハードウェア MJPEG 圧縮を使用します (カードがサポートしている場合)。 このオプションを使用すると、
出力ウィンドウの幅と高さを指定する必要はありません。
デシメーション値から自動的に決定されます (以下を参照)。

--tv-decimation=<1|2|4>
ハードウェアMJPEGによって圧縮される画像のサイズを選択します
圧縮：

1 原寸大

· 704x576 PAL

· 704x480 NTSC

2 ミディアムサイズ

· 352x288 PAL

· 352x240 NTSC

4 小さいサイズ

· 176x144 PAL

· 176x120 NTSC

--tv-quality=<0-100>
JPEG 圧縮の品質を選択します (フル サイズの場合は < 60 を推奨)。

--tv-scan-autostart
起動直後にチャンネルスキャンを開始します（デフォルト：無効）。

--tv-scan-period=<0.1-2.0>
次のチャネルに切り替えるまでの遅延を秒単位で指定します (デフォルト: 0.5)。 低い
値を指定するとスキャンが高速になりますが、非アクティブな TV チャンネルがアクティブとして検出される可能性があります。

--tv-scan-threshold=<1-100>
デバイスによって報告される信号強度のしきい値 (パーセント)
(デフォルト: 50)。 この値より高い信号強度は、
現在スキャン中のチャネルはアクティブです。

キャッシュ
--キャッシュ=
キャッシュのサイズをキロバイト単位で設定し、無効にします いいえ、または自動的に有効にする
必要に応じて オート （ディフォルト： オート） あり オート、キャッシュは通常
によって設定されたサイズを使用して、ネットワーク ストリームに対して有効にします。 --キャッシュデフォルト はい
キャッシュは、によって設定されたサイズで常に有効になります --キャッシュデフォルト (
ストリームをキャッシュできない、または --キャッシュデフォルト キャッシュを無効にします)。

遅いメディアからファイルを再生する場合に役立つ場合がありますが、マイナスになることもあります
特に、MP4 などの多くのシークを必要とするファイル形式では効果がありません。

高速シークバックを可能にするために、キャッシュサイズの半分が使用されることに注意してください。 これもまた
フル キャッシュが通常 100% フルとして報告されない理由。 キャッシュフィル
表示には、シークバック用に予約されたキャッシュの部分は含まれません。 の
実際の最大パーセンテージは通常、先読みと
バックバッファのサイズ。

--cache-default=
キャッシュのサイズをキロバイト単位で設定します (デフォルト: 75000 KB)。 使用する いいえ ないでしょう
ネットワーク ストリームから再生する場合などに、キャッシュを自動的に有効にします。 ご了承ください
- キャッシュ は常にこのオプションをオーバーライドします。

--cache-initial=
キャッシュがこの数キロバイトのファイルでいっぱいになると、再生が開始されます。
データ (デフォルト: 0)。

--cache-seek-min=
内の位置にシークする場合 からのキャッシュ サイズの
現在の位置、mpv はキャッシュがこの位置にいっぱいになるのを待ちます。
ストリーム シークを実行するよりも (デフォルト: 500)。

これは、スモール フォワード シークの場合に重要です。 低速ストリーム (特に HTTP ストリーム) の場合
現在の位置とシークの間でデータをスキップすることの間にはトレードオフがあります
宛先、または実際のシークの実行。 状況に応じて、
これらは、他の方法よりも遅くなる可能性があります。 このオプションを使用すると、これを制御できます。

--cache-backbuffer=
キャッシュ バック バッファのサイズ (デフォルト: 75000 KB)。 これは合計キャッシュに追加されます
サイズ、およびシークバック用に予約された量。 予約金額はありません
先読みに使用され、代わりに既に読み取られたデータを保持して高速シークを有効にします
バック。

--キャッシュファイル=
ファイルシステムにキャッシュ ファイルを作成します。

これには、次の XNUMX つの使用方法があります。

1. パス (ファイル名) を渡す。 ファイルは常に上書きされます。 とき
一般的なキャッシュが有効になっている場合、このファイル キャッシュは、読み取られたものを格納するために使用されます
ソースストリームから。

これは常にキャッシュ ファイルを上書きし、既存のキャッシュは使用できません。
ファイルを使用してストリームの再生を再開します。 (技術的には、mpv はどちらが
ファイル内のブロックは有効で、どれが無効です。)

結果のファイルには、ソース ストリームのすべてのデータが含まれているとは限りません。
たとえば、シークすると、読み飛ばされた部分は決して読み取られず、
したがって、キャッシュに書き込まれません。 スキップされた部分が埋めら​​れます
ゼロ付き。 これは、キャッシュ ファイルが必ずしも対応していないことを意味します。
ソース ストリームの完全なダウンロード。

ユーザーの関心があれば、これらの問題は両方とも改善される可能性があります。

警告：
順序付けられた章または
-オーディオファイル.

2.文字列を渡す TMP. これはファイル名として解釈されません。 代わりに、
非表示の一時ファイルが作成されます。 これがどこにあるかは、C ライブラリによって異なります。
ファイルが作成されます (通常は / tmp /)、およびファイル名が表示されるかどうか ( tmpfile（）
関数が使用されます)。 一部のシステムでは、キャッシュ ファイルの自動削除が
保証されません。

ファイル キャッシュを使用する場合は、このモードをお勧めします。
順序付けられた章を分割するか、 -オーディオファイル. これらのモードは、複数のキャッシュ ストリームを開きます。
それらに同じファイルを使用すると、明らかに衝突します。

また見てください --キャッシュファイルサイズ.

--cache-file-size=
で作成されるファイルの最大サイズ -キャッシュファイル. これを超える読み取りアクセスの場合
サイズ、キャッシュは単に使用されません。

キャッシュを有効にして順番にチャプターを再生するなど、一部のユースケースでは、
実際には複数のキャッシュ ファイルが作成され、それぞれが最大でこの量を使用します。
ディスクスペース。

(デフォルト: 1048576、1 GB。)

-キャッシュなし
入力ストリームのキャッシュをオフにします。 見る - キャッシュ.

--cache-secs=
キャッシュがアクティブな場合にオーディオ/ビデオをプリフェッチする秒数。 これはオーバーライドします
　 --demuxer-readhead-secs キャッシュが有効で、
値が大きくなります。 (デフォルト: 10)

--キャッシュ一時停止、 --no-cache-pause
キャッシュが少なくなったときにプレーヤーを自動的に一時停止し、一時停止を解除するかどうか
もう一度データが利用可能になります (「バッファリング」)。

ネットワーク
--user-agent=
　 HTTP ストリーミングのユーザー エージェントとして。

- クッキー、 --Cookieなし
HTTP リクエストを行うときに Cookie をサポートします。 デフォルトでは無効です。

--cookies-file=
から HTTP Cookie を読み取ります. ファイルは Netscape 形式であると想定されます。

--http-header-fields=
HTTPストリームにアクセスするときにカスタムHTTPフィールドを設定します。

例

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

HTTPリクエストを生成します：

GET / HTTP / 1.0
ホスト：localhost：1234
ユーザーエージェント：MPlayer
Icy-メタデータ：1
フィールド1：value1
フィールド2：value2
接続：閉じる

--tls-ca-file=
TLS で使用する認証局データベース ファイル。 (古いもので黙って失敗する
FFmpeg または Libav バージョン。)

--tls-検証
TLS を使用するときにピア証明書を検証します (例: https://...）。 (黙って失敗する
古い FFmpeg または Libav バージョンでは。)

--tls-cert-file
ピアとのハンドシェイクで使用する証明書を含むファイル。

--tls キーファイル
証明書の秘密鍵を含むファイル。

--リファラー=
HTTPリクエストのリファラーパスまたはURLを指定します。

--network-timeout=
ネットワークのタイムアウトを秒単位で指定します。 これは、少なくとも HTTP に影響します。 特別な
値 0 (デフォルト) は、FFmpeg/Libav のデフォルトを使用します。 プロトコルが使用されている場合
タイムアウトをサポートしていないため、このオプションは黙って無視されます。

--rtsp-トランスポート=
RTSP 転送方法を選択します (デフォルト: tcp)。 これにより、基盤となるネットワークが選択されます
遊ぶときの持ち運び rtsp://... URL。 値 ラフ 決定を任せる
libav形式。

--hls-ビットレート= >
HLS ストリームが再生される場合、このオプションは、どのストリームが選択されるかを制御します。
デフォルト。 このオプションでは、次のパラメーターを使用できます。

いいえ 特別なことはしないでください。 通常、これは単に最初のものを選択します
見つけることができるオーディオ/ビデオストリーム。

分 ビットレートが最も低いストリームを選択します。

マックス 同じですが、最高のビットレートです。 （デフォルト。）

さらに、オプションが数値の場合、最高レートが等しいストリームまたは
下のオプション値が選択されています。

使用されるビットレートはサーバーから送信されたものであり、実際のビットレートであるという保証はありません
意味のある。

DVB
--dvbin-card=<1-4>
カード番号1〜4を使用して指定します（デフォルト：1）。

--dvbin-file=
チャンネルリストを読み取るように mpv に指示します . デフォルトはmpvにあります
構成ディレクトリ (通常は 〜/ .config / mpv) ファイル名
チャンネル.conf.{sat、ter、cbl、atsc} （カードの種類に基づく）または チャンネル.conf として
最後の手段。 DVB-S/2 カードの場合、VDR 1.7.x 形式のチャンネル リストが推奨されます。
これにより、DVB-S2 チャンネルへのチューニング、字幕の有効化、PMT のデコードが可能になります (
デミックスが大幅に改善されます)。 従来の mplayer 形式のチャンネル リストは引き続き
サポート (これらの改善なし)、およびその他のカード タイプの場合は、限られた VDR のみ
フォーマット チャネル リストのサポートが実装されました (パッチを歓迎します)。 チャンネルの場合
動的 PID 切り替えまたは不完全 チャンネル.conf, --dvbin-full-トランスポンダー または
魔法のPID 8192 お勧めします。

--dvbin-timeout=<1-30>
周波数の調整を試みるときにあきらめるまで待機する最大秒数
（デフォルト：30）。

--dvbin-full-transponder=
プログラム PID にフィルターを適用せず、周波数のみに同調し、完全なトランスポンダーを通過させる
デマルチプレクサへ。 これは、XNUMX つのトランスポンダに複数の番組を録画する場合に便利です。
の問題を回避するには チャンネル.conf. こんな用途にもオススメです
オンザフライで PID を切り替えるチャンネル (地域ニュースなど)。

デフォルト： いいえ

その他
--display-tags=タグ1,タグ2,...
端末に表示するタグのリストを設定します。 にあるタグ
リストに表示されますが、再生されたファイルに存在しない場合は表示されません。 値が終了した場合
　 *、すべてのタグはプレフィックスによって一致します (ただし、一般的なグロビングはありません)。 ただ
通過 * 基本的にフィルタリング。

デフォルトにはタグの共通リストが含まれており、mpv を次のように呼び出します。 --リストオプション それを見るために。

--mc=
フレームあたりの最大 AV 同期補正 (秒単位)

--autosync=
オーディオ遅延測定に基づいて、A / V同期を徐々に調整します。 指定する
--autosync=0デフォルトの は、フレーム タイミングが完全にオーディオに基づくようにします。
遅延測定。 指定する --autosync=1 同じことをしますが、微妙に
A/V 補正アルゴリズムを変更します。 ビデオの不均一なビデオ フレームレート。
とうまくいく -音声なし 多くの場合、これを整数値に設定することで解決できます
1より大きい値。値が大きいほど、タイミングが近づきます。 -音声なし.
意図に基づいて、適切なメッセージを適切なユーザーに適切なタイミングで --autosync=30 実装していないサウンドドライバーの問題を解決する
完璧なオーディオ遅延測定。 この値では、A/V 同期オフセットが大きい場合
発生しても、落ち着くまでに約 1 ～ 2 秒しかかかりません。 この遅延
突然の A/V オフセットに対する反応時間は、これを回すことの唯一の副作用です。
オプションをオンにすると、すべてのサウンド ドライバーが対象になります。

--video-sync=
プレーヤーがオーディオとビデオを同期する方法。

で始まるモード ディスプレイ ビデオフレームを完全に出力しようとする
検出されたディスプレイの垂直リフレッシュ レートを
平均してフレームが表示される速度を示します。 これらのモードはビデオ速度を変更します
ディスプレイに合わせます。 見る --ビデオ同期-... 微調整のためのオプション。 の
このモードの堅牢性は、いくつかの理想化された仮定を行うことによってさらに低下します。
現実には必ずしも当てはまらないかもしれません。 動作は VO と
システムのビデオおよびオーディオ ドライバー。 メディア ファイルは一定のフレームレートを使用する必要があります。
セクション単位の VFR は、一部のコンテナー形式でも機能する場合があります (ただし、mkv などは機能しません)。
同期コードが深刻な A/V 非同期を検出した場合、またはフレームレートを検出できない場合、
プレーヤーは自動的に オーディオ しばらくの間または永続的にモード。

のモード 非同期 その名前では、オーディオとビデオの同期を維持しようとはしません。
たとえば、次のシークが発生するまで、それらはゆっくりと (または急速に) 非同期になります。 これらのモード
テスト用であり、深刻な使用ではありません。

オーディオ ビデオ フレームをオーディオに合わせます。 これは最も堅牢なモードです。
ディスプレイの動作について何も想定する必要はありません。 の
欠点は、時折フレームの欠落や繰り返しが発生する可能性があることです。 もしも
オーディオが無効になっている場合、これはシステム クロックを使用します。 これがデフォルトのモードです。

表示-再サンプル
ビデオに合わせてオーディオをリサンプリングします。 このモードでは、オーディオの調整も試行されます
他のドリフトを補償する速度。 (これは、オーディオを次の場所で再生することを意味します。
A/V の差を減らすために、時々速度を変えてください。)

表示-リサンプル-vdrop
ビデオに合わせてオーディオをリサンプリングします。 ビデオ フレームをドロップして補正する
ドリフト。

表示-再サンプル-非同期
前のモードと同様ですが、A/V 補正はありません。

ディスプレイ-vdrop
ビデオ フレームをドロップまたは繰り返して、ビデオの非同期化を補正します。 (といっても
と同じ効果があるはずです オーディオ、実装は非常に
異なる。）

ディスプレイドロップ
ビデオの非同期化を補うために、オーディオ データを削除または繰り返します。 見る
--video-sync-adrop-size. このモードでは、重度のオーディオ アーティファクトが発生します。
実際のモニターのリフレッシュ レートが、報告されたレートまたは強制されたレートと大きく異なります。

ディスプレイ非同期
ビデオをディスプレイに同期し、オーディオを単独で再生します。

非同期 システム クロックに従ってビデオを同期し、オーディオを単独で再生します。

--video-sync-max-video-change=
のビデオに適用されるパーセント単位の最大速度差
--video-sync=ディスプレイ-... (デフォルト: 1)。 次の場合、表示同期モードは無効になります。
モニターとビデオの更新方法が、指定された範囲内で一致しません。 しようとする
倍数も同様です。30 Hz の画面で 60 fps のビデオを再生すると、すべての間隔で複製されます。
24 番目のフレーム。 60 Hz の画面で XNUMX fps のビデオを再生すると、ビデオは
2-3-2-3-...のパターン。

デフォルト設定は、23.976 fps のビデオを 25 fps にスピードアップするほど緩くはありません。
デフォルトでこの動作を許可するには、ピッチの変更が極端すぎると考えています。 設定
このオプションを 5 それを有効にします。

なお、 --video-sync=表示リサンプル モード、オーディオ速度はさらに
A/V 同期に必要な場合は、わずかに変更する必要があります。 見る
--video-sync-max-audio-change.

--video-sync-max-audio-change=
最大 追加の オーディオに適用されるパーセント単位の速度差
--video-sync=ディスプレイ-... (デフォルト: 0.125)。 通常、プレーヤーはオーディオを再生します。
動画の速さ。 しかし、オーディオとビデオの位置の違いが
ドリフトやその他のタイミングエラーが原因で高すぎると、スピードアップまたは
この追加の要素によってオーディオを遅くします。 値が低すぎると、ビデオ フレームが発生する可能性があります
A/V 同期ずれを補正できない場合はドロップまたは繰り返し、値が高すぎます
オーディオの「オーバーシュート」とスキップにより、無秩序なフレーム ドロップが発生する可能性があります。
同期ロジックが反応する前に、複数のビデオ フレーム。

--video-sync-adrop-size=
　 --video-sync=display-adrop モード。 このモードは、オーディオ データを複製/ドロップします。
オーディオとビデオの同期を維持します。 ジッターによるオーディオ アーティファクトを回避するには (これにより、
サンプルを常に追加/削除します)、これは比較的大きな固定単位で行われます。
このオプションによって制御されます。 単位は秒です。

--mf-fps=
で複数の PNG または JPEG ファイルからデコードするときに使用されるフレームレート mf:// （ディフォルト：
1）。

--mf-type=
の入力ファイルの種類 mf:// (利用可能: jpeg、png、tga、sgi)。 デフォルトでは、これは
ファイル拡張子から推測。

--ストリームキャプチャ=
プライマリストリームのキャプチャを許可します（追加のオーディオトラックやその他の種類のオーディオトラックではありません）
ストリーム) を指定されたファイルに挿入します。 変更することでキャプチャを開始および停止することもできます
を含むファイル名 ストリームキャプチャ 奴隷財産。 通常、これは行われません
キャプチャしない限り、MPEG または raw ストリーム以外で使用可能な結果を​​生成します。
ファイルヘッダーが含まれ、中断されません。 キャッシュがあるので注意
レイテンシ、キャプチャされたデータは、実際のデータよりも多少遅れて開始および終了する場合があります。
を参照してください。

宛先ファイルは常に追加されます。 (mpv 0.8.0 より前では、ファイルは
上書きされます。）

--ストリームダンプ=
と同じ --ストリームキャプチャ、再生を開始しないでください。 代わりに、ファイル全体が
ダンプされました。

--stream-lavf-o=opt1=値1,opt2=値2,...
libavformat で開いたストリームに AVOptions を設定します。 不明またはスペルミスのあるオプションは
黙って無視。 (それらは詳細モードの端末出力に記載されています。つまり、
--v. 一般に、たとえば user などの他のオプションがあるため、エラーを出力できません。
エージェントはすべてのプロトコルで使用できるわけではなく、不明なオプションの印刷エラー
うるさくなりすぎます。）

--vo-mmcss-profile=
(Windows のみ。) ビデオ レンダラー スレッドの MMCSS プロファイルを設定します (デフォルト:
Playback).

--優先度=
(Windows のみ。) 定義済みに従って mpv のプロセス優先度を設定します。
Windows で利用可能な優先順位。

の可能な値 : アイドル状態|通常以下|通常|通常以上|高|リアルタイム

警告：
リアルタイム優先度を使用すると、システムがロックアップする可能性があります。

--force-media-title=
の内容を強制する メディアタイトル プロパティをこの値に変更します。 スクリプトに便利
ユーザーの設定を上書きせずにタイトルを設定したい - 題名.

AUDIO 出力 DRIVERS

オーディオ出力ドライバは、さまざまなオーディオ出力機能へのインターフェイスです。 構文は次のとおりです。

--ao =
使用するオーディオ出力ドライバーの優先順位リストを指定します。

リストの末尾に「,」がある場合、mpv はリストに含まれていないドライバーにフォールバックします。
サブオプションはオプションであり、ほとんど省略できます。

各ドライバーのデフォルトを設定することもできます。 デフォルトは通常の前に適用されます
ドライバーのパラメーター。

--ao-デフォルト=
各ドライバーのデフォルトを設定します。

注:
詳細はこちら： --ao=ヘルプ コンパイル済みのオーディオ出力ドライバーのリストについては、 ドライバ --ao=アルサ is
優先。 --ao=パルス PulseAudio が使用されているシステムでは優先されます。 Windows では、
--ao=ワサピ が推奨されますが、場合によっては問題が発生する可能性があります。
--ao=dサウンド 使用すべきです。 BSD システムでは、 --ao=oss or --ao=sndio` 動作する可能性があります (
後者は実験的なものです）。 OS X システムでは、次を使用します。 --ao=コアオーディオ.

例

· --ao=アルサ、オス、 ALSAドライバー、次にOSSドライバー、次にその他を試してください。

· --ao=alsa:resample=yes:device=[plughw:0,3] ALSA にリサンプリングさせ、
device-name を最初のカード、XNUMX 番目のデバイスとして指定します。

使用可能なオーディオ出力ドライバは次のとおりです。

アルサ （Linux のみ）
ALSA オーディオ出力ドライバー

デバイス=
デバイス名を設定します。 S/PDIF 経由の ac3 出力には、「iec958」または「spdif」を使用します。
あなたが本当にそれを正しく設定する方法を知らない限り、デバイス。

リサンプル=はい
ALSA リサンプリング プラグインを有効にします。 (これはデフォルトで無効になっています。
ドライバーは、場合によっては誤ったオーディオ遅延を報告します)。

ミキサーデバイス=
で使用するミキサーデバイスを設定します --no-softvol （ディフォルト： デフォルト).

ミキサー名=
ミキサー要素の名前を設定します (デフォルト: Master）。 これは例えば PCM
or Master.

ミキサーインデックス=
ミキサー チャンネルのインデックスを設定します (デフォルト: 0)。 の出力を検討してください
"ミキサー コントロール"の場合、インデックスは名前の後に続く番号です
要素。

インターリーブされていない
インターリーブされていない形式の出力を許可する (オーディオ デコーダーがこれを使用する場合)
フォーマット）。 現在、一部の一般的な ALSA プラグインはデフォルトで無効になっています。
インターリーブされていない形式では完全に壊れています。

無視-chmap
ALSA デバイスのチャネル マップを読み取ったり設定したりしないでください。
必要な数のチャンネルを作成し、オーディオをそのまま渡します。 これ
ほとんどの場合、オプションは使用しないでください。 デバッグに役立ちます。
特別に設計された ALSA 構成を使用した静的セットアップ用 (この
常に同じレイアウトを強制する必要がある場合 -オーディオチャネル、またはそれ
ALSA デバイスに暗黙的なレイアウトを使用するファイルに対してのみ機能します)。

注:
MPlayer と mplayer2 では、「,」を「.」に置き換える必要がありました。 および任意の「:」
ALSA デバイス名の「=」。 mpv はこれを行わなくなりました。 代わりに、
装置名：
--ao=alsa:device=[プラグ:surround50]

なお、 [ および ] デバイス名を引用するだけです。 一部のシェル (zsh など) では、
シェルがオプション文字列を解釈しないようにするには、オプション文字列を引用符で囲む必要があります。
それらを mpv に渡す代わりに括弧を使用します。

実際には、 - オーディオ装置 オプションを設定する代わりに、
直接デバイス。

警告：
mpv 0.8.0 での動作からマルチチャンネル/サラウンド オーディオの処理が変更されました。
MPlayer/mplayer2 および古いバージョンの mpv で。

以前の動作では、プレーヤーはデフォルトで常にステレオにダウンミックスされていました。 の
-オーディオチャネル （または -チャネル その前に）取得するにはオプションを設定する必要がありました
マルチチャンネルオーディオ。 次に、ステレオを再生すると、 デフォルト デバイス（どの
通常、複数のプログラムが dmix を介して同時にオーディオを再生できるようにします)、
より多くのチャンネルで何かを再生すると、ハードウェアのXNUMXつが開きます
たとえば、 サラウンド51 エイリアス (通常は排他的アクセス)。
プレーヤーが排他アクセスを使用するかどうかは、ファイルによって異なります
再生されています。

mpv 0.8.0 以降の新しい動作では、常にマルチチャンネル オーディオが有効になります。
--audio-channels = auto がデフォルトです。 ただし、ALSA は良い方法を提供しないため、
非排他的な方法でマルチチャンネル オーディオを再生する (他のブロックなしで)
アプリケーションがオーディオを使用できないようにする)、プレーヤーは次の機能に制限されます。
　 デフォルト つまり、ステレオとモノのみをサポートします (
少なくとも現在の典型的な ALSA 構成では)。 しかし、ハードウェアデバイスが
選択すると、通常、マルチチャンネル オーディオが機能します。

簡単に言うと、ALSA を使用したマルチチャンネル オーディオが必要な場合は、 - オーディオ装置
デバイスを選択します (使用 --audio-device = help すべてのデバイスのリストを取得し、
彼らの mpv 名)。

また試してみることもできます 　 アップミックス プラグイン. この設定により、マルチチャンネル オーディオが有効になります
デフォルト 共有アクセスを使用した自動アップミックスを備えたデバイス、再生中
ステレオ オーディオとマルチチャンネル オーディオを同時に使用すると、期待どおりに動作します。

センター OSSオーディオ出力ドライバー


オーディオ出力デバイスを設定します (デフォルト: / dev / dsp).


オーディオ ミキサー デバイスを設定します (デフォルト: / dev / Mixer).


オーディオ ミキサー チャンネルを設定します (デフォルト: pcm）。 その他の有効な値は次のとおりです。 vol、
pcm、 ライン. オプションの完全なリストについては、 SOUND_DEVICE_NAMES in
/usr/include/linux/soundcard.h.

ジャック JACK (Jack Audio Connection Kit) オーディオ出力ドライバ

ポート=
指定された名前のポートに接続します（デフォルト：物理ポート）。

名前=
JACK に渡されるクライアント名 (デフォルト: mpv）。 したい場合に便利です。
特定の接続を自動的に確立します。

(なし) 自動起動
必要に応じて自動的にジャックを開始します（デフォルト：無効）。 これに注意してください
信頼性に欠ける傾向があり、stdout がサーバー メッセージでフラッディングされます。

(無)接続
出力ポートへの接続を自動的に作成します（デフォルト：有効）。 いつ
有効にすると、出力チャネルの最大数は数に制限されます
利用可能な出力ポート。

std-channel-layout=waveext|任意
標準のチャンネル レイアウトを選択します (デフォルト: waveext)。 JACK自体はありません
チャンネル レイアウトの概念 (つまり、特定のチャンネルにどのスピーカーを割り当てるか)
にマップすることになっている) - アプリケーションが出力するものは何でも受け取り、
ユーザーが定義したものに再ルーティングします。 これは、ユーザーと
アプリケーションは、チャネル レイアウトの処理を担当します。 波線 使用されます
WAVE_FORMAT_EXTENSIBLE オーダー。
Microsoft は、多くのシステムの標準です。 値 どれか ジャックに受け入れさせる
チャンネルのレイアウトや
並べ替えなし。 このモードは、次の場合を除いて、おそらくあまり役​​に立ちません。
デバッグまたは固定セットアップで使用する場合。

コアオーディオ （マック OS X のみ）
AudioUnits と CoreAudio サウンドを使用するネイティブ Mac OS X オーディオ出力ドライバー
サーバー。

に自動的にリダイレクトします coreaudio_exclusive 圧縮フォーマットを再生するとき。

物理フォーマットの変更=
物理フォーマットを要求された音声フォーマットに似たものに変更します
(デフォルト: いいえ)。 これには、マルチチャンネル オーディオ出力が
実際に動作します。 欠点は、システム全体のオーディオが変更されることです
設定。 これは、 フォーマット の設定 オーディオ
Devices のダイアログ オーディオ MIDI 効用。 これはそうではないことに注意してください
選択したスピーカー設定に影響を与えます。

排他的な
排他モード アクセスを使用します。 これは単にリダイレクトします coreaudio_exclusive、 だけど
その AO を直接使用するよりも優先する必要があります。

coreaudio_exclusive （マック OS X のみ）
直接デバイス アクセスと排他モードを使用するネイティブ Mac OS X オーディオ出力ドライバー
(サウンドサーバーをバイパスします)。

オープン 実験的なOpenALオーディオ出力ドライバー

注:
このドライバーはあまり役に立ちません。 マルチチャンネル オーディオの再生が遅い。

パルス PulseAudioオーディオ出力ドライバー

[ ][: シンク>]
使用するホストとオプションで出力シンクを指定します。 空っぽストリング
ローカル接続を使用し、「localhost」はネットワーク転送を使用します（ほとんどの場合、そうではありません）
あなたが欲しいもの）。

buffer=<1-2000|ネイティブ>
オーディオ バッファ サイズをミリ秒単位で設定します。 値が大きいほど、より多くのデータがバッファされます。
バッファ アンダーランの可能性が低くなります。 値が小さいほど
オーディオ ストリームは、再生速度の変更などにより速く反応します。 デフォルト: 250。

レイテンシーハック=
PulseAudio のタイミング バグを回避するためのハックを有効にします (デフォルト: no)。 有効にすると、
mpv は独自に精巧なレイテンシ計算を行います。 無効にすると、
PulseAudio を使用すると、タイミング情報が自動的に更新されます。 これを無効にする
有効にすると、ネットワークオーディオや一部のプラグインなどで役立つ場合があります
いくつかの未知の状況で役立つ可能性があります（以前は、うまくいくために必要でした
PulseAudio の古いバージョンでの動作)。

パルスを使用しているときにビデオが途切れる場合は、このオプションを有効にしてみてください。
(または、PulseAudio を更新してみてください。)

音が鳴る （Windows のみ）
DirectXDirectSoundオーディオ出力ドライバー

注:
このドライバーは、古いシステムとの互換性を保つためのものです。

デバイス=
使用するデバイス番号を設定します。 でファイルを再生する -v のリストが表示されます
利用可能なデバイス。

バッファサイズ=
ミリ秒単位の DirectSound バッファ サイズ (デフォルト: 200)。

SDL SDL 1.2+ オーディオ出力ドライバー。 SDL 1.2 でサポートされているすべてのプラットフォームで動作するはずですが、
が必要な場合があります SDL_AUDIODRIVER 環境変数を適切に設定する
あなたのシステム。

注:
このドライバーは、
他のドライバが利用できないシステム。

buflen=
オーディオ バッファの長さを秒単位で設定します。 音によるヒントとしてのみ使用されます
システム。 でファイルを再生する -v 要求され、取得された正確な
バッファサイズ。 値 0 はサウンド システムのデフォルトを選択します。

bufcnt=
mpv の余分なオーディオ バッファの数を設定します。 通常は変更する必要はありません。

ヌル オーディオ出力を生成しませんが、ビデオの再生速度を維持します。 使用する --ao=null:時間指定なし
ベンチマーク用。

時限のない
完全なオーディオ デバイスのタイミングをシミュレートしないでください。 これは、オーディオデコードを意味します
システムクロックに合わせるのではなく、できるだけ速く進みます。

バッファ シミュレートされたバッファーの長さ (秒単位)。

激発
サンプルでシミュレートされたチャンク サイズ。

スピード 乗数としてシミュレートされたオーディオ再生速度。 通常、実際のオーディオ デバイス
システムクロックとまったく同じ速度にはなりません。 ほんの少しずれます
このオプションは、これをシミュレートするのに役立ちます。

待ち時間
シミュレートされたデバイス レイテンシ。 これは EOF に追加されます。

壊れた eof
壊れたオーディオ ドライバーをシミュレートします。これにより、固定のデバイス レイテンシが常に追加されます。
報告されたオーディオ再生位置。

壊れた遅延
遅延を正しく報告しない壊れたオーディオ ドライバーをシミュレートします。

チャネル レイアウト
空でない場合、これは , AO が許可するチャネル レイアウトの個別のリスト。
これは、チャネル レイアウトの選択をテストするために使用できます。

pcm Raw PCM/WAVE ファイルライター音声出力

(なし)ウェーブヘッダー
WAVE ヘッダーを含めるか含めないか (デフォルト: 含めます)。 そうでないとき
含まれている、生のPCMが生成されます。

file =
に音を書き込む デフォルトの代わりに オーディオダンプ.wav。 場合
ノーウェーブヘッダー が指定されている場合、デフォルトは オーディオダンプ.pcm.

(いいえ)追加
ファイルを上書きするのではなく、ファイルに追加します。 常にこれを
ノーウェーブヘッダー オプション - あり ウェーブヘッダー それは壊れています。
ファイルを開くたびに WAVE ヘッダーが表示されます。

音 RSound デーモンへのオーディオ出力

注:
RSound を実行するつもりがない限り、まったく役に立ちません。 と混同しないでください
RoarAudio、これはまったく別のものです。

ホスト=
サーバーのアドレスを設定します (デフォルト: localhost)。 ネットワークのいずれかになります
TCP 接続のホスト名、または「/」で始まる Unix ドメイン ソケット パス。

ポート=
サーバーへの接続に使用する TCP ポートを設定します (デフォルト: 12345)。 いいえ
Unix ドメインソケットに接続する場合に使用されます。

スンディオ OpenBSD sndio サウンドシステムへのオーディオ出力

注:
実験的。 既知のバグと問題があります。

(注: モノ、ステレオ、4.0、5.1、および 7.1 チャンネル レイアウトのみをサポートします。)

デバイス=
使用する sndio デバイス (デフォルト: $オーディオデバイス、それぞれ。 snd0).

ワサピ Windows オーディオ セッション API へのオーディオ出力。

排他的な
排他的な直接ハードウェア アクセスを要求します。 定義上、音を防ぎます
mpv が終了するまで、他のプログラムの再生。

デバイス=
システムのデフォルトのオーディオ エンドポイントの代わりに、要求されたエンドポイントを使用します。
序数 (0,1,2、XNUMX、XNUMX、...) と GUID 文字列の両方が有効です。 GUID
string は、ドライバーがアンインストールされない限り変更されないことが保証されています。

人間が読める名前によるアクティブなデバイスの検索もサポートします。 以上の場合
XNUMX つのデバイスが名前に一致し、ロードを拒否します。

このオプションは、より一般的な
- オーディオ装置 オプション。 そうは言っても、 --audio-device = help のリストを提供します
有効なデバイス GUID (接頭辞 ワサピ/）、および人間が読める形式
ここで機能するはずの名前。

VIDEO 出力 DRIVERS

ビデオ出力ドライバは、さまざまなビデオ出力機能へのインターフェイスです。 構文は次のとおりです。

--vo =
使用するビデオ出力ドライバーの優先順位リストを指定します。

リストの末尾に「,」がある場合、mpv はリストに含まれていないドライバーにフォールバックします。
サブオプションはオプションであり、ほとんど省略できます。

各ドライバーのデフォルトを設定することもできます。 デフォルトは通常の前に適用されます
ドライバーのパラメーター。

--vo-defaults=
各ドライバーのデフォルトを設定します。

注:
詳細はこちら： --vo=ヘルプ コンパイル済みのビデオ出力ドライバーのリストについては、

推奨出力ドライバは --vo=opengl-hq. 他のすべてのドライバーは
互換性または特別な目的。 デフォルトでは、 --vo = opengl が使用されていますが、それが表示された場合
動作しない場合は、他のドライバーにフォールバックします (リストされているのと同じ順序で) --vo=ヘルプ).

使用可能なビデオ出力ドライバーは次のとおりです。

xv （X11 のみ）
XVideo 拡張機能を使用して、ハードウェア アクセラレーションによる表示を有効にします。 これが一番
X の VO と互換性がありますが、品質が低い可能性があり、OSD と字幕に問題があります
ディスプレイ。

注:
このドライバーは、古いシステムとの互換性を保つためのものです。

アダプター=
特定の XVideo アダプターを選択します (xvinfo の結果を確認してください)。

ポート=
特定のXVideoポートを選択します。

ck =
カラーキーの取得元を選択します (デフォルト: cur)。

尻 デフォルトでは、Xv で現在設定されているカラー キーが使用されます。

つかいます mpv からのカラー キーを使用しますが、設定しないでください ( --カラーキー オプション
それを変更するには）。

セッションに 使用方法と同じですが、指定されたカラー キーも設定します。

ck-method =
カラーキーの描画方法を設定します (デフォルト: man)。

man カラーキーを手動で描画します (場合によってはちらつきを減らします)。

bg ウィンドウの背景としてカラー キーを設定します。

オート Xv にカラー キーを描画させます。

カラーキー=
カラー キーを選択した RGB 値に変更します。 0x000000 黒であり、
0xffffff 白です。

カラーキーなし
カラーキーイングを無効にします。

バッファ=
内部リングバッファに使用する画像バッファの数 (デフォルト: 2)。
これを増やすとより多くのメモリが使用されますが、X サーバーが
ビデオ FPS が
リフレッシュレートを表示します。

x11 （X11 のみ）
いつでも動作するハードウェアアクセラレーションなしの共有メモリビデオ出力ドライバ
X11が存在します。

注:
これはフォールバックのみであり、通常は使用しないでください。

vdpau （X11 のみ）
VDPAU インターフェイスを使用してビデオを表示し、オプションでデコードも行います。 ハードウェア
デコードは --hwdec = vdpau.

注:
mpv (および MPlayer、mplayer2) の以前のバージョンでは、調整するサブオプションが提供されていました。
vdpau の後処理など ディント, 研ぐ, ノイズ, 彩度, プルアップ,
HQスケーリング. これらのサブオプションは非推奨です。 vdpaupp
代わりにビデオ フィルターを使用します。

研ぎ=<-1-1>
(非推奨。 についての注意を参照してください。 vdpaupp.)

正の値の場合は、ビデオにシャープ化アルゴリズムを適用し、負の場合は
ぼかしアルゴリズムの値 (デフォルト: 0)。

denoise = <0-1>
(非推奨。 についての注意を参照してください。 vdpaupp.)

ビデオにノイズ削減アルゴリズムを適用します (デフォルト: 0; ノイズなし)
割引）。

deint=<-4-4>
(非推奨。 についての注意を参照してください。 vdpaupp.)

デインターレース モードを選択します (デフォルト: 0)。 古いバージョンでは (および
MPlayer/mplayer2) では、このオプションを使用してインターレース解除を有効にすることができます。 これ
は機能しなくなり、インターレース解除は次のいずれかで有効になります d キー（
コマンドにマッピングされたデフォルト サイクル インターレース解除）、 または -インターレース解除
オプション。 また、デフォルトのdeintモードを選択するには、何かを使用する必要があります
ような --vf-defaults=vdpaupp:deint-mode=temporal このサブオプションの代わりに。

0 選ぶ vdpaupp 3 に対応するビデオ フィルタのデフォルト。

1 最初のフィールドのみを表示します。

2 ボブのインターレース解除。

3 動きに適応した一時的なインターレース解除。 との A/V 非同期化につながる可能性があります
ビデオハードウェアが遅いか、解像度が高い。

4 エッジ ガイド付き空間を使用したモーション アダプティブ テンポラル デインターレース
補間。 高速なビデオ ハードウェアが必要です。

彩度
(非推奨。 についての注意を参照してください。 vdpaupp.)

ルミナンスとクロマの両方でテンポラル デインターレーサーを動作させます (デフォルト)。 使用する
no-chroma-deint を使用して輝度のみを使用し、高度なインターレース解除を高速化します。
遅いビデオメモリで便利です。

プルアップ (非推奨。 についての注意を参照してください。 vdpaupp.)

逆テレシネを適用してみてください。動きに適応した一時的なインターレース解除が必要です。

hqscaling=<0-9>
(非推奨。 についての注意を参照してください。 vdpaupp.)

0 デフォルトの VDPAU スケーリングを使用します (デフォルト)。

1-9 高品質の VDPAU スケーリングを適用します (対応するハードウェアが必要です)。

fps=
自動検出されたディスプレイのリフレッシュ レート値をオーバーライドします (この値は、
ディスプレイのリフレッシュ レートよりも高いビデオ再生レートを許可する framedrop
および vsync 対応のフレーム タイミング調整用)。 デフォルト 0 は使用を意味します
自動検出された値。 正の値は Hz 単位のリフレッシュ レートとして解釈されます
自動検出された値をオーバーライドします。 負の値はすべてのタイミングを無効にします
調整とフレーム ドロップ ロジック。

コンポジット検出
NVIDIA の現在の VDPAU 実装は、環境下では多少異なる動作をします。
ウィンドウマネージャーを合成し、正確なフレームタイミングを提供しません
情報。 このオプションを有効にすると、プレーヤーは、
合成ウィンドウ マネージャがアクティブです。 検出された場合、プレイヤーは
ユーザーが指定したかのようにタイミング調整を無効にします fps=-1 （彼らのように
誤った入力に基づいている可能性があります)。 これは、タイミングがやや少ないことを意味します
合成しない場合よりも正確ですが、合成モードの動作により
NVIDIA ドライバーがなくても、ハードな再生速度制限はありません。
無効化されたロジック。 デフォルトで有効になっています。 コンポジット検出なし 無効にします。

queuetime_windowed= および queuetime_fs=
VDPAU のプレゼンテーション キュー機能を使用して、将来のビデオ フレームをキューに入れる
最大でこのミリ秒前に変更されます (デフォルト: 50)。 下記参照
追加情報について。

output_surfaces=<2-15>
ビデオ フレームを表示するために、この多くの出力サーフェスを割り当てます (デフォルト: 3)。 見る
（以下）をご覧ください。

colorkey=<#RRGGBB|#AARRGGBB>
VDPAU プレゼンテーション キューの背景色を設定します。
VDPAU がオーバーレイ モードで動作する場合に使用されるカラーキー (デフォルト: #020507、いくつかの
黒の色合い）。 この値のアルファ コンポーネントが 0 の場合、デフォルトは
代わりに VDPAU カラーキーが使用されます (通常は緑です)。

強制yuv
RGBA 入力を受け付けません。 これは、mpv がフィルターを挿入して変換することを意味します。
VO の前の YUV 形式。 特定のアベイラビリティを強制するのに役立つ場合があります
ビデオ イコライザーやインターレース解除などの YUV のみの機能。

queuetime オプションによって制御される VDPAU フレーム キューイング機能の使用
mpv のフレーム フリップ タイミングがシステム CPU 負荷の影響を受けにくくなり、mpv が
次のフレームのデコードを少し早く開始します。これにより、発生するジッターを減らすことができます
個々のデコードが遅いフレームによって。 ただし、NVIDIA グラフィックス ドライバーを使用すると、
VDPAU がブリット キューを使用している場合、ウィンドウの動きが途切れるなど、その他のウィンドウの動作
（主に、複合拡張機能を有効にしている場合に発生します）この機能は
アクティブ。 これがシステムで発生し、それが気になる場合は、
この機能を無効にするには、queuetime 値を 0 に設定します。 ウィンドウと
フルスクリーンモードは別のものです。これを無効にする理由はないはずです。
フルスクリーン モード (ドライバーの問題はビデオ自体には影響しないため)。

queuetime 値と
出力サーフェス count (特定の時間ビデオをバッファリングするのに十分なサーフェスを確保するため)
その間、少なくともビデオのフレーム数と同じ数のサーフェスが必要です。
プラスXNUMX）。 これにより、場合によってはビデオがよりスムーズになります。 主な欠点
サーフェスのビデオ RAM 要件が増加し、ディスプレイの応答が遅くなります。
ユーザーコマンドへ (表示の変更は、変更後しばらくしてから表示されるようになります)
待機中）。 グラフィックス ドライバーの実装には、
正常に機能する、またはまったく機能しない最大キュー時間またはキューに入れられたサーフェスの数。

direct3d_shaders （Windows のみ）
Direct3D インターフェイスを使用するビデオ出力ドライバー。

注:
このドライバーは、適切な OpenGL を提供しないシステムとの互換性のためのものです。
ドライバー。

優先-stretchrect
　 IDirect3DDevice9 :: StretchRect 可能であれば、他の方法よりも。

無効-stretchrect
を使用してビデオをレンダリングしないでください IDirect3DDevice9 :: StretchRect.

テクスチャを無効にする
D3D テクスチャ レンダリングを使用してビデオをレンダリングしないでください。 テクスチャを使用したレンダリング
+ シェーダーは引き続き許可されます。 追加 シェーダーを無効にする 完全に無効にする
テクスチャを使用したビデオ レンダリング。

シェーダーを無効にする
ビデオをレンダリングするときは、シェーダーを使用しないでください。

8ビットのみ
コンポーネントあたり 8 ビットを超える YUV ビデオをレンダリングしないでください。 このフラグの使用
ソフトウェアで強制的に 8 ビットに変換します。

ディセーブル テクスチャ アライン
通常、テクスチャ サイズは常に 16 に揃えられます。このオプションを有効にすると、
ビデオ テクスチャは、常にビデオとまったく同じサイズになります。
そのもの。

デバッグ オプション。 これらは正しくない可能性があり、将来削除される可能性があります。
実際に必要な場合は、開発者に連絡してください。
これらのパフォーマンスまたは適切な操作のために。

2 の累乗の力
デバイスが報告した場合でも、テクスチャを常に 2 の累乗にします。
サポートされている 2 のべき乗でないテクスチャ サイズ。

texture-memory=
シェーダー/テクスチャリングが有効で、(E)OSD を使用した操作にのみ影響します。 可能
値：

デフォルト （デフォルト）
　 D3DPOOL_DEFAULTと D3DPOOL_SYSTEMMEM ロック用のテクスチャ。 もしも
ドライバーはサポートします D3DDEVCAPS_TEXTURESYSTEMMEMORY, D3DPOOL_SYSTEMMEM
直接使用されます。

デフォルトプール
　 D3DPOOL_DEFAULT. （お気に入り デフォルト、ただし、シャドウ テクスチャは使用しないでください。)

デフォルトプールシャドウ
　 D3DPOOL_DEFAULTと D3DPOOL_SYSTEMMEM ロック用のテクスチャ。
（お気に入り デフォルト、しかし常にシャドウ テクスチャを強制します。)

マネージド
　 D3DPOOL_MANAGED.

スクラッチ
　 D3DPOOL_SCRATCHと D3DPOOL_SYSTEMMEM ロック用のテクスチャ。

スワップ・ディスカード
　 D3DSWAPEFFECT_DISCARD、これはより高速である可能性があります。 遅くなる可能性もあります。
すべてのフレームをクリアする必要があります(?)。

正確なバックバッファ
常にバックバッファのサイズをウィンドウ サイズに変更します。

direct3d （Windows のみ）
と同じ direct3d_shaders、しかしオプション付き テクスチャを無効にする および シェーダーを無効にする
強制。

注:
このドライバーは、古いシステムとの互換性を保つためのものです。

OpenGLの OpenGL ビデオ出力ドライバー。 拡張スケーリング方法、ディザリング、
カラーマネジメント。

デフォルトでは、高速でフェールセーフな設定を使用しようとします。 エイリアスを使用する opengl 本社 〜へ
高品質のレンダリングに設定されたデフォルトでこのドライバーを使用してください。

少なくとも OpenGL 2.1 が必要です。

一部の機能は、OpenGL 3 対応のグラフィックス ドライバーでのみ使用できます (または、
必要な拡張機能が利用可能です)。

OpenGL ES 2.0 および 3.0 もサポートされています。

OpenGL 相互運用によるハードウェア デコードは、ある程度サポートされています。 に注意してください
このモードでは、いくつかのまれなケースが適切に処理されない可能性があり、色空間
変換とクロマアップサンプリングは、通常、ハードウェアデコーダーの手にあります
API。

OpenGLの デフォルトで FBO を使用します。 場合によっては、より良い品質を達成したり、
変更によるパフォーマンス fbo 形式 サブオプション rgb16f, rgb32f or RGB。 知られている
問題には、Mesa/Intel が受け入れないことが含まれます RGB16、メサが時々コンパイルされていない
フロート テクスチャのサポートがあり、一部の OS X セットアップは非常に遅くなります。 RGB16 焙煎が極度に未発達や過発達のコーヒーにて、クロロゲン酸の味わいへの影響は強くなり、金属を思わせる味わいと乾いたマウスフィールを感じさせます。
と高速 rgb32f. 問題がある場合は、パスを試すこともできます ダムモード=はい
サブオプション。

ダムモード=
このモードは非常に制限されており、ほとんどの拡張 OpenGL が無効になります
特徴。 これには、高品質のスケーラーとカスタム シェーダーが含まれます。

FBO をサポートしていないハードウェア (GLES、
十分にサポートしていません)、またはパフォーマンスをさらに引き出すために
不良または古いハードウェア。

このモードは必要に応じて自動的に強制され、このオプションはほとんどの場合
デバッグに役立ちます。 何も使用しない場合も自動的に有効になります
FBO を必要とする機能。

このオプションは、将来サイレントに削除される可能性があります。

スケール=

バイリニア
バイリニア ハードウェア テクスチャ フィルタリング (最速、非常に低品質)。 これは
互換性の理由からデフォルトです。

スプライン36
中程度の品質と速度。 使用時のデフォルトです。 opengl 本社.

ランチョス
ランチョスのスケーリング。 中程度の品質と速度を提供します。 一般的により悪い
スプライン36、しかし、それは良いために少しシャープな画像になります
一部のコンテンツ タイプ。 タップ数は次のように制御できます
スケール半径、しかし、変更しないでおくのが最善です。

このフィルタは、古い ランチョス3 デフォルトの半径のエイリアス
が使用されますが、 ランチョス2 半径 2 に相当します。

(このフィルターは シンクウインドウ付き シンク)

ewa_lanczos
楕円加重平均ランチョス スケーリング。 別名ジンク。
比較的遅いですが、非常に高品質です。 半径はで制御できます
スケール半径. 半径を大きくするとフィルターがシャープになりますが、
さらに鳴ります。

(このフィルターは ジンクウインドウ付き ジンク)

ewa_lanczossharp
を使用するように事前設定された、ewa_lanczos のわずかにシャープなバージョン
理想的な半径とパラメーター。 ハードウェアで実行できる場合、これはおそらく
デフォルトで使用するもの。

ミッチェル
ミッチェル・ネトラヴァリ。 の B および C パラメータは次のように設定できます スケール-param1
および スケール-param2. このフィルターは、ダウンスケーリングに非常に適しています (を参照してください)。 スケール).

オーバーサンプル
(単純に) ピクセルをオーバーサンプリングする最近傍のバージョン。
エッジにオーバーラップするピクセルは、丸められるのではなく、線形に補間されます。
これにより、小さな欠陥やジャダー アーティファクトが基本的に除去されます。
いくつかの追加と引き換えに、最近傍補間によって引き起こされます
ぼかします。 このフィルターは、一時的な補間に優れており、としても知られています。
"スムーズモーション" (参照 tスケール).

カスタム ユーザー定義のカスタム シェーダ( スケールシェーダー).

他にもいくつかのフィルターがありますが、ほとんどはそれほど役に立ちません。 完全なリストについては、
パス 助けます 値として、例えば:

mpv --vo=opengl:scale=ヘルプ

スケール-param1= 、 スケール-param2=
フィルタ パラメータを設定します。 フィルターが調整可能でない場合は無視されます。 現在、
これは、次のフィルタ パラメータに影響します。

BCスプライン
スプライン パラメータ (B および C）。 両方のデフォルトは 0.5 です。

ガウス
スケール パラメータ (t）。 これを大きくすると、結果がぼやけます。
デフォルトは1です。

オーバーサンプル
補間が使用される前のエッジまでの最小距離。 設定
これを 0 に設定すると、常にエッジが補間されますが、0.5 に設定すると
補間されないため、通常の最も近いオブジェクトのように動作します。
近隣アルゴリズムが使用されました。 デフォルトは 0.0 です。

スケールぼかし=
カーネル スケーリング ファクター (ブラー ファクターとも呼ばれます)。 これを減らすと
結果はよりシャープになり、値を大きくするとぼやけます (デフォルト 0)。 に設定した場合
0、カーネルの優先ぼかし係数が使用されます。 これも設定することに注意してください
低い (例: 0.5) と悪い結果になります。 一般的には固執することをお勧めします
0.8 から 1.2 の間の値。

スケール半径=
以下にリストされているフィルターの半径を設定します。0.5 から XNUMX の間の浮動小数点数である必要があります
16.0。 指定されていない場合、フィルタの優先半径がデフォルトになります。
シンク および誘導体、 ジンク および誘導体、 ガウス, ボックス および 三角形

フィルターの実装の詳細とビデオのスケーリングに応じて、
比、実際に使用されている半径は異なる場合があります (ほとんどの場合
少し増えています。）

スケールアンチリング=
アンチリンギングの強さを設定します。 これはリンギングを除去しようとしますが、
プロセスに他のアーティファクトを導入します。 0.0 の間の浮動小数点数でなければなりません
そして1.0。 デフォルト値の 0.0 は、アンチリンギングを完全に無効にします。

これは特別なフィルターには影響しないことに注意してください バイリニア および バイキュービック_ファースト.

スケールウィンドウ=
(上級ユーザーのみ) カーネルのカスタム ウィンドウ関数を選択します。
設定されていない場合、フィルタの優先ウィンドウにデフォルト設定されます。 使用する スケール ウィンドウ = ヘルプ 〜へ
サポートされているウィンドウ関数のリストを取得します。

スケール-wparam=
(上級ユーザーのみ) 指定されたウィンドウ関数のパラメーターを構成します。
by スケール ウィンドウ. ウィンドウが調整可能でない場合は無視されます。 現在、この
次のウィンドウ パラメータに影響します。

カイザー ウィンドウ パラメーター (アルファ)。 デフォルトは 6.33 です。

黒人
ウィンドウ パラメーター (アルファ)。 デフォルトは 0.16 です。

ガウス
スケール パラメーター (t)。 これを大きくすると、ウィンドウが広くなります。
デフォルトは1です。

scaler-lut-size=<4..10>
スケーラー カーネルのルックアップ テクスチャのサイズを設定します (デフォルト: 6)。 の
テクスチャの実際のサイズは 2^N のオプション値 N. だからルックアップ
デフォルト設定のテクスチャは 64 サンプルを使用します。

すべての重みは、これらのサンプルから双一次補間されるため、
ルックアップ テーブルのサイズによって、スケーラーの精度が向上する場合があります。

スケーラーのサイズ変更のみ
ビデオ画像のサイズが変更されていない場合は、スケーラーを無効にします。 その場合、 バイリニア
で設定されているものは何でも代わりに使用されます 階段. バイリニアは
スケーリングが実行されない場合、ソース イメージは完全に復元されます。 このオプションは
影響を与えることはありません cスケール.

pbo PBO の使用を有効にします。 これはわずかに高速ですが、場合によっては
散発的かつ一時的な画像の破損 (理論的には、再アップロードはそうではないため)
失敗したときに再試行されます)、おそらく実際にはより遅いパスをトリガーします
PBO を適切にサポートしないドライバー。

ディザ深度=
ディザ ターゲット深度を N に設定します。デフォルト: いいえ。

いいえ mpv によるディザリングを無効にします。

オート 自動選択。 出力ビット深度が検出できない場合は、8 ビット
コンポーネントごとに想定されます。

8 8 ビット出力へのディザリング。

接続されたビデオ ディスプレイ デバイスの奥行きを指定できないことに注意してください。
検出されました。 多くの場合、LCD パネルは独自にディザリングを行いますが、競合します。
　 OpenGLののディザリングと醜い出力につながります。

dither-size-fruit=<2-8>
ディザ マトリックスのサイズを設定します (デフォルト: 6)。 の実際のサイズ
行列は (2^N) x (2^N) のオプション値 N、したがって、値 6 は
64x64のサイズ。 マトリックスは起動時に生成され、大きなマトリックス
計算にかなり時間がかかる場合があります (秒)。

で使われる ディザ=フルーツ モードのみ。

ディザ=
ディザリング アルゴリズムを選択します (デフォルト: フルーツ)。 (通常、 ディザ深度
オプションは、ディザリングを有効にするかどうかを制御します)。

一時的なディザ
一時ディザリングを有効にします。 (一般的にディザリングが有効になっている場合にのみアクティブになります。)
これは、変更することにより、各フレームで 8 つの異なるディザリング パターンの間で変化します。
タイル化されたディザ マトリックスの向き。 残念ながら、これはつながる可能性があります
これらは反応時間が長いため、LCD ディスプレイではちらつきが生じます。

一時的ディザ期間=<1-128>
ディザリング パターンが更新される頻度を決定します。 一時的なディザ
使用中です。 1 (デフォルト) はすべてのビデオ フレームで更新され、2 はすべてのビデオ フレームで更新されます。
その他フレームなど

debug OpenGL エラーをチェックします。つまり、呼び出します glGetError（）. OpenGL のデバッグもリクエストする
コンテキスト (現在のグラフィックス ドライバーでは何もしません)
書き込み）。

補間
ビデオの fps とディスプレイのリフレッシュの不一致によるカクつきを軽減
レート (ジャダーとも呼ばれます)。

警告：
これには、 --ビデオ同期 いずれかのオプション ディスプレイ
そうしないと、サイレント モードで無効になります。 これは mpv の前には必要ありませんでした
0.14.0.

これは基本的に、畳み込みによって欠落しているフレームを補間しようとします
時間軸に沿ったビデオ。 使用するフィルタは、次を使用して制御できます。
　 tスケール 設定。

これは vsync の動作に依存していることに注意してください。 スワップ間隔 詳細については、
情報を表示します。

swapinterval =
1 つのバッファ スワップ間の表示フレームの間隔。 XNUMX は
VSYNC を有効にし、0 で VSYNC を無効にします。 指定しない場合のデフォルトは 1 です。

これは適切な OpenGL vsync サポートに依存することに注意してください。 一部のプラットフォームでは、
ドライバーの場合、これはフルスクリーン モードの場合にのみ確実に機能します。 また、
複数のモニターを使用している場合は、mpv を確保するためにドライバー固有のハックが必要です。
正しいものに同期します。 ウィンドウマネージャーの合成も悪いことにつながる可能性があります
表示される FPS 情報が欠落しているか正しくない可能性があります (を参照)。
--display-fps).

dscale=
いいね 階段、ただし、代わりにダウンスケーリングにこれらのフィルターを適用します。 このオプションの場合
が設定されていない場合、フィルターは 階段 適用されます。

cscale=
As 階段、ただし彩度情報を補間するため。 画像がない場合
サブサンプリングされているため、このオプションは完全に無視されます。

tscale=
時間軸 (フレーム) の補間に使用されるフィルター。 これだけです
使用される場合 補間 有効になっています。 唯一の有効な選択肢 tスケール 　
分離可能な畳み込みフィルター (使用 tscale=ヘルプ リストを取得します）。 デフォルト
is ミッチェル.

現在、サポートされている最大フィルター半径は 3 であることに注意してください。
ロードできるビデオ テクスチャの数の制限
同時に。

tscale クランプ
クランプ tスケール カーネルの値の範囲を [0-1] にフィルターします。 これにより
側頭領域での過剰なリンギング アーティファクト (通常マニフェスト)
短い閃光または黒のフリンジとして、主に移動するエッジの周りに表示されます)
潜在的にぼかしを追加する代わりに。

dscale半径、 cscale半径、 tscale半径、 等々
のフィルタ パラメータを設定する スケール, cスケール および tスケールそれぞれ。

対応するオプションを参照してください 階段.

線形スケーリング
線形光でスケーリングします。 のみで使用する必要があります fbo 形式 それは
少なくとも 16 ビットの精度。

正しいダウンスケーリング
畳み込みベースのフィルターを使用する場合は、フィルター サイズを拡張します。
ダウンスケーリング。 品質は向上しますが、ダウンスケーリング中はパフォーマンスが低下します。

これは、アナモフィック ビデオでは最適とは言えません (ただし、それでも
ないよりはましです) のみに一致するようにサイズを拡張します。
軸間のスケール係数が穏やかです。

プレスケール=
このオプションは、アップスケーリング用の非畳み込みベースのフィルターを提供します。 これらは
フィルターはビデオを元のサイズの倍数にサイズ変更します (現在はすべて
サポートされているプリスケーラーは、XNUMX 回のパスでイメージの XNUMX 倍化のみを実行できます)。
通常、別のコンボリューション ベースのフィルター (メイン スケーラー) が適用されます。
プリスケーラの後、ターゲットの表示サイズに合わせます。

なし すべてのプリスケーラを無効にします。 これがデフォルトです。

スーパーxbr
もともとピクセル アート用に開発された比較的高速なプリスケーラー。

一部のパラメーターは、で調整できます superxbr-シャープネス および
superxbr-エッジ-強度 オプション。

ネディ3 に使用できる人工ニューラル ネットワーク ベースのデインターレーサー。
高級なイメージ。

非常に遅く、最近のミッドまたはハイエンドのグラフィックス カードが必要です。
スムーズに動作します（2015年現在）。

上記のすべてのフィルターは、処理するように設計 (または実装) されていることに注意してください。
ルマ プレーンのみであり、RGB 形式のビデオでは意図したとおりに機能しない可能性があります。

prescale-passes=<1..5>
プリスケーラを適用するパスの数 (デフォルトは 1)。 設定する
2 にすると、4 倍のアップスケーリングが実行されます。

prescale-downscaling-threshold=<0..32>
このオプションは、プリスケーラの「過剰な」使用を防ぎます。
設定が間違っているか、ユーザーが非常に大きなサイズのビデオを再生しようとしています。 と
このオプションでは、ユーザーは両方で許可される最大の縮小率を指定できます。
寸法。 それを満たすために、プリスケーラのパス数は
必要に応じてプリスケーラを無効にすることもできます。

デフォルト値は 2.0 で、一見ほとんどのことを防ぐことができるはずです。
プリスケーラの不当な使用。 ほとんどのユーザーは、おそらくそれを
パフォーマンスを向上させるには、1.0 から 1.5 の間の小さい値を使用します。

1.0 未満の値を指定すると、チェックが無効になります。

nnedi3-neurons=<16|32|64|128>
nnedi3 プリスケーリングのニューロンを指定します (デフォルトは 32 です)。 レンダリング
時間は、ニューロンの数に比例すると予想されます。

nnedi3-window=<8x4|8x6>
nnedi3 プリスケーリングでサンプリングするためのローカル ウィンドウのサイズを指定します (デフォルト
ようにするには 8x4）。 ザ 8x6 window はより鮮明な画像を生成しますが、速度も遅くなります。

nnedi3-アップロード=
NN の重みを GPU にアップロードする方法を指定します。 グラフィックカードによっては、
ドライバー、シェーダー コンパイラー、nnedi3 の設定、どちらの方法も高速または
もっとゆっくり。

ubo 均一なバッファ オブジェクトを介してこれらの重みをアップロードします。 これがデフォルトです。
(OpenGL 3.1 / GLES 3.0 が必要です)

シェーダ すべてのウェイトをシェーダー ソース コードにハード コードします。 （必要
OpenGL 3.3 / GLES 3.0)

プレシェーダー= 、 ポストシェーダー= 、 スケールシェーダー=
カスタム GLSL フラグメント シェーダー。

プレシェーダー （リスト）
これらは、RGB への変換後、線形化の前に適用されます。
そしてアップスケーリング。 非線形 RGB (入力と同じ) で動作します。 これは
シャープフィルターなどを配置するのに最適な場所です。

スケールシェーダー
これらのオプションがに設定されている場合、これは scale/cscale の代わりに使用されます
カスタム. それが動作する色空間は、の値に依存します
線形スケーリング および シグモイドアップスケーリング、したがって、仮定はありません
ここで作られました。

ポストシェーダー （リスト）
これらは、アップスケーリングと字幕のブレンディングの後に適用されます (
ブレンド字幕 が有効になっています)、しかしカラー管理の前に。 作動する
リニア RGB の場合 線形スケーリング が有効、そうでない場合は非線形
RGB。 これは、色空間の変換に最適な場所です (例:
彩度マッピング）。

これらのファイルは、次のシグネチャを持つ関数を定義する必要があります。

vec4 サンプル (sampler2D tex、vec2 pos、vec2 tex_size)

パラメータの意味は次のとおりです。

サンプラー2D テックス
シェーダーのソース テクスチャ。

vec2 投稿する
座標空間 [0-1] でサンプリングされる位置。

vec2 テックスサイズ
テクスチャのサイズ (ピクセル単位)。 これは、image_size とは異なる場合があります。
例えば。 サブサンプリングされたコンテンツまたはポストシェーダー用。

これらのパラメータに加えて、次のユニフォームもグローバルです。
入手可能：

フロート ランダム
[0-1] の範囲の乱数で、フレームごとに異なります。

int型 フレーム
レンダリングされたフレームの単純なカウントで、フレームごとに XNUMX ずつ増加し、
リセットすることはありません (シークに関係なく)。

vec2 画像サイズ
入力画像のピクセル単位のサイズ。

たとえば、色を反転するシェーダーは次のようになります。

vec4 サンプル (sampler2D tex、vec2 pos、vec2 tex_size)
{
vec4 color = テクスチャ(tex, pos);
return vec4(1.0 - color.rgb, color.a);
}

バンドを解除 バンド除去アルゴリズムを有効にします。 これにより、目に見える量が大幅に減少します。
バンディング、ブロッキング、およびその他の量子化アーティファクトは、非常に高価です
細部の一部をわずかにぼかします。 実際には、事実上
常に改善 - それを無効にする唯一の理由は
パフォーマンス。

deband-iterations=<1..16>
サンプルごとに実行するバンド除去ステップの数。 各ステップは少し減少します
バンディングが増えますが、計算に時間がかかります。 各ステップの強さに注意してください
非常に急速に低下するため、高い数値 (>4) は実際には役に立ちません。
（デフォルト1）

deband-threshold=<0..4096>
バンド除去フィルターのカットオフしきい値。 数字が大きいほど
バンディング強度を劇的に、しかし次第に画像の詳細を減少させます。
（デフォルト64）

deband-range=<1..64>
バンド除去フィルターの初期半径。 の場合、半径は直線的に増加します。
各反復。 半径を大きくするとグラデーションが多くなりますが、半径を小さくすると検出されます
より積極的に滑らかになります。 (デフォルト 16)

あなたが増やす場合 デバンド反復、おそらくこれをに減らす必要があります
補償。

deband-grain=<0..4096>
画像に余分なノイズを追加します。 これは隠蔽に大きく役立ちます
残りの量子化アーティファクト。 数値が大きいほどノイズが多くなります。 （デフォルト
48）

シグモイドアップスケーリング
アップスケーリングするときは、シグモイド色変換を使用してリンギングを強調しないようにします
アーティファクト。 これはまた、 線形スケーリング.

シグモイドセンター
に使用されるシグモイド曲線の中心 シグモイドアップスケーリング、フロートでなければなりません
0.0 から 1.0 の間。 指定しない場合、デフォルトは 0.75 です。

シグモイドスロープ
に使用されるシグモイド曲線の傾き シグモイドアップスケーリング、フロートでなければなりません
1.0 から 20.0 の間。 指定しない場合、デフォルトは 6.5 です。

シャープにする=
0 以外の値に設定すると、アンシャープ マスキング フィルタが有効になります。 ポジティブ
値は画像をシャープにします (ただし、リンギングとエイリアシングが追加されます)。 ネガティブ
値は画像をぼかします。 GPU が十分に強力な場合は、
のような代替 ewa_lanczossharp スケール フィルタ、または スケールぼかし
サブオプション。

(この機能は古い シャープ3 および シャープ5 スケーラー)

グリフィニッシュ
コー​​ル glFinish（） バッファーのスワップ前後 (デフォルト: 無効)。
遅くなりますが、フレームドロップを行うときに、より良い結果が得られる可能性があります。 できる
パフォーマンスを完全に台無しにします。 詳細は完全に OpenGL に依存します
ドライバ。

待機同期
コー​​ル glXWaitVideoSyncSGI 各バッファスワップの後 (デフォルト: 無効)。 これ
ビデオタイミングの精度とフレームドロップに役立つ場合とそうでない場合があります。 それが可能だ
これにより、ビデオ出力が遅くなるか、まったく影響がありません。

X11/GLXのみ。

vsync-フェンス=
を使用して、CPU を N 番目の過去のフレームに同期させます。 GL_ARB_同期 拡大。 NS
値 0 は、この動作を無効にします (デフォルト)。 値 1 は、
レンダリング後に現在のフレームに同期します。 お気に入り グリフィニッシュ および
待機同期、これによりパフォーマンスが低下または台無しになる可能性があります。 その利点は、それができることです
複数のフレームにまたがり、GPU のフレーム数を効果的に制限します。
先のキューに入れます (これは vsync にも影響します)。

dwmflush=
コー​​ル Dwmフラッシュ Windows でバッファをスワップした後 (デフォルト: auto)。 また
セット スワップ間隔(0) OpenGL タイミングを無視します。 値は次のとおりです。いいえ (無効)、
ウィンドウ化 (ウィンドウ化モードのみ)、はい (フルスクリーンでも)。

値 オート コンポジターがアクティブかどうかを判断しようとします。
呼び出し Dwmフラッシュ そう思われる場合のみ。

これは、特に次の場合に、より一貫したフレーム間隔を得るのに役立つ場合があります
高 fps クリップ - フレームの欠落も減少する可能性があります。 通常は値
of 窓付き 全画面で DWM をバイパスする可能性があるため、十分なはずです。

Windowsのみ。

sw ソフトウェア レンダラーが検出された場合でも続行します。

バックエンド=
値 オート (デフォルト) ウィンドウ バックエンドを選択します。 あなたもすることができます
パス 助けます バックエンドでコンパイルされた完全なリストを取得する (
自動プローブ順序)。

オート 自動選択 (デフォルト)

ココア ココア/OS X

win Win32/WGL

角度 OpenGL ES 変換レイヤー ANGLE を介した Direct3D11。 これ
ほぼすべてをサポート win バックエンドは、ICC プロファイルを除いて、
高ビット深度ビデオ入力、および ネディ3 プリスケーラ。

dxinterop （実験的）
Win32、レンダリングに WGL、プレゼンテーションに Direct3D 9Ex を使用。
Nvidia と AMD でのみ動作します。

x11 X11/GLX

ウェイランド
ウェイランド/EGL

drm-egl
DRM/EGL

x11egl X11/EGL

es=
GLES を使用するかどうかを選択します。

はい Desktop GL よりも ES を優先するようにしてください

いいえ ES よりもデスクトップ GL を優先するようにしてください

オート 各バックエンドにデフォルトを使用 (デフォルト)

fbo-format=
FBO に使用されるテクスチャの内部形式を選択します。 フォーマットは
ビデオ出力のパフォーマンスと品質に影響を与えます。 FMT 次のいずれかになります。
rgb、rgba、rgb8、rgb10、rgb10_a2、rgb16、rgb16f、rgb32f、rgba12、rgba16、
rgba16f、rgba32f。 デフォルト： オート、デスクトップ GL の rgba16 にマップし、
GLES の rgb10_a2 (例: ANGLE)。

ガンマ=<0.1..2.0>
ガンマ値を設定します (デフォルト: 1.0)。 ガンマが他の方法で調整されている場合 (
- ガンマ オプションまたはキーバインディングと ガンマ プロパティ)、値
他のガンマ値と乗算されます。

環境の明るさに基づく推奨値:

1.0 明るく照らす（デフォルト）

0.9 やや薄暗い

0.8 真っ暗な部屋

ガンマオート
周囲の照明に応じてガンマ値を自動的に補正します
条件 (暗い部屋にガンマ ブーストを追加)。

周囲照度が 64lux の場合、mpv は 1.0 ガンマ値を選択します (no
ブースト)、0.8lux の場合はブーストを 16 までわずかに上げます。

注: OS X でのみ実装されています。

ターゲットプリム=
ディスプレイの原色を指定します。 ビデオの色はこれに適応します
必要に応じて色空間。 有効な値は次のとおりです。

オート アダプテーションを無効にする (デフォルト)

地点470m
ITU-R BT.470M

bt.601-525
ITU-R BT.601 (NTSC などの 525 ライン SD システム)、SMPTE 170M/240M

bt.601-625
ITU-R BT.601 (PAL/SECAM などの 625 ライン SD システム)、ITU-R BT.470 B/G

bt.709 ITU-R BT.709 (HD)、IEC 61966-2-4 (sRGB)、SMPTE RP177 Annex B

bt.2020
ITU-R BT.2020 (UHD)

リンゴ アップルRGB

アドベ Adobe RGB（1998）

プロフォト
プロフォト RGB (ROMM)

cie1931
CIE 1931 RGB (CIE XYZ と混同しないでください)

ターゲット-trc=
ディスプレイの伝達特性 (ガンマ) を指定します。 ビデオの色
この曲線に合わせます。 有効な値は次のとおりです。

オート アダプテーションを無効にする (デフォルト)

bt.1886
ITU-R BT.1886 曲線、輝度低下なし (約 1.961)

SRGB IEC 61966-2-4 (sRGB)

線形 線形光出力

gamma1.8
Apple RGB にも使用される純粋なパワー カーブ (ガンマ 1.8)

gamma2.2
純粋なパワーカーブ (ガンマ 2.2)

gamma2.8
BT.2.8-BGにも使用される純粋なパワーカーブ（ガンマ470）

プロフォト
プロフォト RGB (ROMM)

icc プロファイル =
ICC プロファイルを読み込み、それを使用してリニア RGB を画面出力に変換します。
コンパイル済みの LittleCMS 2 サポートが必要です。このオプションは、
ターゲットプリム, ターゲット-trc および icc プロファイル自動 オプション。

icc プロファイル自動
によって現在指定されている ICC ディスプレイ プロファイルを自動的に選択します。
オペレーティング システムの表示設定。

注: Windows では、デフォルト プロファイルは ICC プロファイルである必要があります。 WCS プロファイル
サポートされていません。

icc-キャッシュ-dir=
ICC プロファイルから作成された 3D LUT をこのディレクトリに保存してロードします。
LittleCMS 2 は読み込みに時間がかかることがあるため、これを使用して読み込みを高速化できます。
3D LUT を作成します。 これらのファイルには、圧縮されていない LUT が含まれていることに注意してください。 彼らの
サイズは 3dlutサイズ、非常に大きくなる可能性があります。

注: これは自動的に消去されないため、古い未使用のキャッシュ ファイルが
無期限に固執します。

icc-意図=
色の変換に使用される ICC インテントを指定します (
icc プロファイル).

0 知覚的

1 相対比色 (デフォルト)

2 飽和

3 絶対比色

3dlut-size= バツバツ
各次元の ICC プロファイルから生成された 3D LUT のサイズ。
デフォルトは 128x256x64 です。 サイズは 512 のべき乗で、最大で XNUMX でなければなりません。

ブレンド字幕=
補間の前に、アップスケールされたビデオ フレームに字幕を直接ブレンドします。
および/またはカラー管理 (デフォルト: いいえ)。 これを有効にすると、字幕が
影響を受ける icc プロファイル, ターゲットプリム, ターゲット-trc, 補間, ガンマ および
ポストシェーダー. また、使用時に字幕のパフォーマンスが向上します
補間.

これを有効にすることの欠点は、字幕が表示されるものに制限されることです。
ビデオの一部であるため、字幕が黒い余白に存在することはできません
ビデオの下（たとえば）。

If ビデオ が選択されている場合、動作は次のようになります はい、しかし潜水艦はで描かれます
ビデオのネイティブ解像度であり、ビデオに合わせてスケーリングされます。

警告：
これにより、字幕の色の処理方法が変更されます。 通常、サブタイトル
色は sRGB であると想定され、色はそのように管理されます。 これを有効にする
代わりに、ビデオの色空間にあるものとして扱われます。 これは
ソフトサブされた ASS サインのようなものをビデオと一致させたい場合に適しています
色が異なりますが、SRT 字幕などはわずかにずれて見える場合があります。

アルファ=
入力にアルファ コンポーネントがある場合の処理​​を決定します (デフォルト: ブレンド)。

黒い背景に対してフレームをブレンドします。

はい アルファ コンポーネントを含むフレーム バッファを作成してみてください。 これだけで
ビデオにアルファ情報が含まれているかどうかを感知します (これは非常に重要です)。
レア）。 すべてのプラットフォームでサポートされているわけではありません。 アルファ フレームバッファの場合
利用できない場合、通常のフレームバッファに静かにフォールバックします。 ノート
あなたが設定した場合 fbo 形式 デフォルト以外の値へのオプション、
アルファ付きの形式を指定する必要があります。指定しないと機能しません。

いいえ アルファ成分を無視します。

長方形テクスチャ
長方形テクスチャの使用を強制します (デフォルト: no)。 通常、これはあるべきではありません
通常のテクスチャに対する利点。 ハードウェアのデコードはオーバーライドされることに注意してください
このフラグ。

背景=
ビデオで覆われていない mpv ウィンドウの部分を描画するために使用される色。 見る
--OSD-カラー 色を定義するオプション。

opengl 本社
と同じ OpenGLの、ただし、高品質のレンダリングのためのデフォルト設定があります。

これは次と同等です。

--vo=opengl:scale=spline36:cscale=spline36:dscale=mitchell:dither- Depth=auto:correct-downscaling:sigmoid-upscaling:pbo:deband:es=no

一部の安価な LCD ではディザリングが行われることに注意してください。 OpenGLの's
ディザリング。 でディザリングを無効にする ディザ深度=いいえ するのに役立ちます。

SDL SDL 2.0+ Render ビデオ出力ドライバー (ハードウェアの有無にかかわらずシステムに依存)
加速度。 SDL 2.0 でサポートされているすべてのプラットフォームで動作するはずです。 チューニングについては、
ファイルのコピーに SDL_ヒント.h.

注:
このドライバーは、適切なグラフィックスを提供しないシステムとの互換性のためのものです
ドライバ、または GLES のみをサポートするドライバ。

sw ソフトウェア レンダラーが検出された場合でも続行します。

スイッチモード
フルスクリーンに移行する際にモニターのビデオ モードを切り替えるように SDL に指示します。

ヴァーピ ハードウェア デコードをサポートする Intel VA API ビデオ出力ドライバー。 ご了承ください
ハードウェアを使用したい以外に、これを使用する理由はまったくありません
ラップトップの電力を節約するためのデコード、または一部のビデオのティアリングを防止する可能性があります
セットアップ。

注:
このドライバーは、くだらないシステムとの互換性のためのものです。 vaapiハードウェアを使用できます
でデコード --vo = opengl のためにペンを持つ時間も見つけています。

スケーリング=

デフォルト
ドライバーのデフォルト (mpv のデフォルトも同様)。

速いです 高速だが低品質。

hq 未指定のドライバーに依存する高品質のスケーリング、遅い。

nla 非線形 アナモフィック スケーリング

deint-mode=
インターレース解除アルゴリズムを選択します。 デフォルトではインターレース解除は
最初は常にオフであり、 d キー (デフォルトのキー
のバインディング サイクル インターレース解除).

libva がビデオ後処理 (vpp) をサポートしている場合、このオプションは適用されません。 の
この場合、デフォルト deint モード is いいえ、および経由でインターレース解除を有効にする
上記の方法を使用したユーザー操作は、実際に
ヴァヴップ ビデオフィルター。 vpp が libva バックエンドで実際にサポートされていない場合
使用中は、このオプションを使用して VO ベースのインターレース解除を強制的に有効にすることができます。

いいえ デインターレースを許可しません (新しい libva のデフォルト)。

最初のフィールド
最初のフィールドのみを表示 ( -- フィールド優勢).

ボブ bob deinterlacing (古い libva のデフォルト)。

スケーリングされた-osd=
有効にすると、OSD はビデオ解像度でレンダリングされ、スケーリングされます。
ディスプレー解像度。 デフォルトでは、これは無効になっており、OSD は次の場所でレンダリングされます。
ドライバーがサポートしている場合は解像度を表示します。

ヌル ビデオ出力を生成しません。 ベンチマークに役立ちます。

通常、ビデオを無効にすることをお勧めします -ビデオなし を代わりにお使いください。

fps =
ディスプレイ FPS をシミュレートします。 これにより、VO のフレーム数が人為的に制限されます。
毎秒受け入れます。

うんち テキストコンソールで動作するカラーASCIIアートビデオ出力ドライバ。

注:
このドライバーは冗談です。

画像 各フレームを現在のディレクトリ内の画像ファイルに出力します。 各ファイルは
名前として先行ゼロが埋め込まれたフレーム番号。

フォーマット=
画像ファイル形式を選択します。

JPG JPEG ファイル、拡張子は .jpg。 （デフォルト。）

JPEG JPEG ファイル、拡張子は .jpeg。

PNG PNGファイル。

ppmの 移植可能なビットマップ形式。

pgm 移植可能なグレーマップ形式。

pgmyuv YV12 ピクセル形式を使用したポータブル グレーマップ形式。

TGA TruevisionTGA。

png圧縮=<0-9>
PNG 圧縮係数 (速度とファイル サイズのトレードオフ) (デフォルト: 7)

png-filter=<0-5>
PNG 圧縮の前に適用されるフィルター (0 = なし、1 = サブ、2 = アップ、3 =
平均; 4 = パエス; 5 = 混合) (デフォルト: 5)

jpeg-quality=<0-100>
JPEG 品質係数 (デフォルト: 90)

(no-)jpeg-プログレッシブ
標準またはプログレッシブ JPEG を指定します (デフォルト: no)。

(no-)jpeg-ベースライン
JPEG ベースラインを使用するかどうかを指定します (デフォルト: yes)。

jpeg-optimize=<0-100>
JPEG 最適化係数 (デフォルト: 100)

jpeg-smooth=<0-100>
スムーズファクター（デフォルト：0）

jpeg-dpi=<1->
JPEG DPI (デフォルト: 72)

outdir =
画像ファイルを保存するディレクトリを指定します (デフォルト: ./).

ウェイランド (ウェイランド のみ）
フォールバックとしての Wayland 共有メモリ ビデオ出力 OpenGLの.

注:
このドライバーは、動作中の OpenGL を提供しないシステムとの互換性のためのものです。
ドライバー。

アルファ アルファ情報を含むビデオと画像をサポートするバッファ形式を使用する

RGB565 バッファ形式として RGB565 を使用します。 この形式は、ほとんどのプラットフォームで実装されています。
特に組み込みでは、RGB8888 よりもはるかに効率的です。

トリプルバッファリング
3 ではなく 2 バッファを使用します。これにより、より滑らかな再生が可能になりますが、
より多くのメモリ。

opengl-cb
libmpv 直接 OpenGL 埋め込みで使用します。 他のコンテキストでは役に立ちません。 （見る
.)

これは、サブオプションの多くもサポートします。 OpenGLの VOは持っています。 走る mpv
--vo=opengl-cb:ヘルプ リスト用。

これは、 vo_cmdline

RPI （ラズベリー 円周率)
MMAL API を使用した Raspberry Pi でのネイティブ ビデオ出力。

ディスプレイ=
ビデオ オーバーレイを表示するディスプレイ番号を選択します
（デフォルト：0）。

レイヤー=
ビデオ オーバーレイを表示する dispmanx レイヤーを選択します
(デフォルト: -10)。 mpv は、選択したレイヤーの上にある 2 つのレイヤーも使用することに注意してください。
ウィンドウの背景と OSD を処理します。 実際のビデオ レンダリングは
選択したレイヤーの上のレイヤーで発生します。

背景=
ビデオの背後に黒い背景をレンダリングするかどうか (デフォルト: no)。
通常は、代わりにコンソール フレームバッファを強制終了する方がよいため、
よりよい性能。

osd=
デフォルトで有効になっています。 で無効にした場合 いいえ、OSD レイヤーは作成されません。 これもまた
字幕がレンダリングされないことを意味します。

DRM （直接 レンダリング マネージャー）
Kernel Mode Setting / Direct Rendering Manager を使用したビデオ出力ドライバー。 したほうがいい
本格的なグラフィカル環境をインストールしたくない場合に使用します (たとえば、
バツ）。 ハードウェア アクセラレーションをサポートしていません (これが必要な場合は、 drm-egl
のバックエンド OpenGLの VO）。

コネクタ=
使用するコネクタを選択します (通常、これはモニターです)。-1 に設定すると、mpv
最初に使用可能なコネクタで出力をレンダリングします。 (デフォルト: -1)

devpath=
グラフィック カード デバイスへのパス。 (デフォルト: /dev/dri/card0)

モード=
使用するモード ID (解像度、ビット深度、およびフレーム レート)。 (デフォルト: 0)

AUDIO FILTERS

オーディオ フィルタを使用すると、オーディオ ストリームとそのプロパティを変更できます。 構文は次のとおりです。

--af =
一連のオーディオ フィルターをセットアップします。

注:
使用可能なオーディオ フィルタの完全なリストを取得するには、次を参照してください。 --af=ヘルプ.

また、ほとんどの実際のフィルターは、 ラフフィ ラッパー
libavfilter のフィルターのほとんどにアクセスできます。 これには、
MPlayer から libavfilter に移植されました。

各フィルターのデフォルトを設定することもできます。 デフォルトは通常の前に適用されます
フィルタ パラメータ。

--af-defaults=
各フィルタのデフォルトを設定します。

オーディオ フィルタはリストで管理されます。 フィルタ リストを管理するためのコマンドがいくつかあります。

--af-add=
引数として指定されたフィルターをフィルター リストに追加します。

--af-pre=
引数として指定されたフィルターをフィルター リストの先頭に追加します。

--af-del=
指定されたインデックスのフィルターを削除します。 インデックス番号は 0 から始まり、負の数
数字はリストの最後を示します (-1 が最後です)。

--af-clr
フィルタ リストを完全に空にします。

利用可能なフィルターは次のとおりです。

lavrresample[=オプション1:オプション2:...]
このフィルターは libavresample (ビルドによっては libswresample) を使用して変更します
オーディオ ストリームのサンプル レート、サンプル形式、またはチャネル レイアウト。 このフィルターは
オーディオ出力がオーディオ構成をサポートしていない場合、自動的に有効になります
再生中のファイルの

次のサンプル形式のみをサポートしています: u8、s16、s32、float。

フィルターサイズ=
低いサンプリング レートに対するフィルターの長さ。 (デフォルト: 16)

位相シフト=
ポリフェーズ エントリ数の Log2。 (...、10->1024、11->2048、12->4096、
...) (デフォルト: 10->1024)

カットオフ=
カットオフ周波数 (0.0-1.0)、フィルターの長さに応じてデフォルトが設定されます。

線形 設定されている場合、フィルタはポリフェーズ エントリ間で線形補間されます。
（デフォルト：いいえ）

切り離さない
入力と出力のオーディオ形式/レート/チャネルが一致する場合は、切り離さないでください。 （もし、あんたが
このフィルターのデフォルトを設定したいだけで、
自動的に挿入された lavrresample インスタンス、設定を優先する必要があります
彼らと --af-defaults=lavrresample:....)

正規化=
チャンネル レイアウトのリミックス時に正規化するかどうか (デフォルト: yes)。 これは
たとえば、サラウンド オーディオをステレオにダウンミックスする場合に適用されます。 利点は、
これにより、クリッピングが発生しないことが保証されます。 残念ながら、これも可能です
音量レベルが低くなりすぎます。 これを有効にするか無効にするかは、
基本的に好みの問題ですが、デフォルトではより安全な選択が使用されます。

o=
SwrContext または AVAudioResampleContext で AVOptions を設定します。 これらは
FFmpeg または Libav によって文書化されています。

lavcac3enc[=tospdif[:ビットレート[:ミンチ]]]
libavcodec を使用して、実行時にマルチチャンネル オーディオを AC-3 にエンコードします。 16 ビットをサポート
ネイティブ エンディアン入力形式、最大 6 チャネル。 次の場合、出力はビッグエンディアンです。
S/PDIF への出力時に生の AC-3 ストリーム、ネイティブ エンディアンを出力します。 入力が
サンプルレートが 48 kHz、44.1 kHz、32 kHz のいずれでもない場合、48 kHz にリサンプリングされます。

tospdif=
生の AC-3 ストリームを出力する場合 いいえ、パススルー用に S/PDIF に出力する場合 はい
（ディフォルト）。

ビットレート=
AC-3 ストリームのビットレート使用。 384 kbps を取得するには、384 に設定します。

デフォルトは 640 です。一部の受信機はこれを処理できない場合があります。

有効な値: 32、40、48、56、64、80、96、112、128、160、192、224、256、320、
384、448、512、576、640。

特別な価値 オート 入力チャネルに基づいてデフォルトのビットレートを選択します
数：

1ch 96

2ch 192

3ch 224

4ch 384

5ch 448

6ch 448

ミンチ=
入力チャンネル番号が 、フィルターが外れます
それ自体 (デフォルト: 3)。

イコライザー=g1:g2:g3:...:g10
10 IIR バンドパス フィルターを使用して実装された 10 オクターブ バンドのグラフィック イコライザー。 これ
再生中のオーディオの種類に関係なく機能することを意味します。 の
10 バンドの中心周波数は次のとおりです。

┌────┬────────┐
│No. │頻度│
§────┼────────┤
│0 │ 31.25Hz │
§────┼────────┤
│1 │ 62.50Hz │
§────┼────────┤
│2 │ 125.00Hz │
§────┼────────┤
│3 │ 250.00Hz │
§────┼────────┤
│4 │ 500.00Hz │
§────┼────────┤
│5 │ 1.00kHz │
§────┼────────┤
│6 │ 2.00kHz │
§────┼────────┤
│7 │ 4.00kHz │
§────┼────────┤
│8 │ 8.00kHz │
§────┼────────┤
│9 │ 16.00kHz │
━───┴───────┘

再生中の音のサンプルレートが再生音の中心周波数より低い場合
周波数帯域を指定すると、その帯域は無効になります。 このフィルタの既知のバグは次のとおりです。
最上位バンドの特性が完全に対称ではない場合、
サンプルレートはその帯域の中心周波数に近いです。 この問題は
サウンドが到達する前に、リサンプリング フィルターを使用してサウンドをアップサンプリングすることで回避しました。
このフィルター。

: : :...:
各周波数帯域の dB 単位のゲインを表す浮動小数点数
(-12-12)

例

mpv --af=equalizer=11:11:10:5:0:-12:0:5:12:12 メディア.avi
上下の周波数領域の音を増幅します。
1 kHz 付近でほぼ完全にキャンセルされます。

チャンネル=チャンネル[:ルート]
オーディオ チャンネルの追加、削除、ルーティング、およびコピーに使用できます。 もしも
が指定されている場合、デフォルトのルーティングが使用されます。 次のように機能します。
チャネル数が入力チャネル数より大きい場合、空のチャネルが挿入されます
(モノラルからステレオにミキシングする場合を除き、モノチャンネルが複製されます)。 もしも
出力チャネルの数が入力チャネルの数よりも少ない場合、
を超えるチャネルは切り捨てられます。

出力チャンネル数 (1-8)


一覧 , 分離されたルート、形式 1 対 1、2 対 2、.... 各ペア
各チャネルのルーティング先を定義します。 最大で 8 つのルートが存在する可能性があります。 それなし
この引数では、デフォルトのルーティングが使用されます。 以来 , 分けるのにも使われる
フィルターを使用する場合、この引数を引用符で囲む必要があります [...] または類似。

例

mpv --af=channels=4:[0-1,1-0,2-2,3-3] メディア.avi
チャネル数を 4 に変更し、スワップする 4 つのルートをセットアップします。
チャネル 0 とチャネル 1 を削除し、チャネル 2 と 3 はそのままにします。 観察する
2 つのチャネルを含むメディアを再生すると、チャネル 3 と XNUMX が再生されます。
無音を含みますが、0 と 1 はまだ入れ替わっています。

mpv --af=channels=6:[0-0,0-1,0-2,0-3] メディア.avi
チャネル数を 6 に変更し、コピーする 4 つのルートをセットアップします。
チャンネル 0 からチャンネル 0 から 3 へ。チャンネル 4 と 5 には無音が含まれます。

注:
おそらく、このフィルターは使用しないでください。 出力を変更したい場合
チャネル レイアウト、 形式でアーカイブしたプロジェクトを保存します． mpv を自動的にアップおよび
標準チャネル レイアウトをダウンミックスします。

format=フォーマット:srate:チャンネル:アウトフォーマット:アウトsrate:アウトチャンネル
形式変換自体は行いません。 むしろ、フィルターシステムが
必要に応じて、このフィルターの前後に必要な変換フィルターを挿入します。 それは
主に、他のフィルターに入るオーディオ形式を制御するのに役立ちます。 に
オーディオ出力の形式を指定します。 を参照してください --オーディオ形式, --オーディオサンプルレート,
-オーディオチャネル. このフィルターは特定の形式を強制できますが、
- オーディオ-* 出力の互換性に基づいて ao によってオーバーライドされる場合があります。

すべてのパラメーターはオプションです。 最初の 3 つのパラメーターは、フィルターの対象を制限します。
入力として受け付けます。 したがって、変換フィルターが挿入されます。
この前。 の アウト- パラメータは、次のフィルタまたはオーディオ出力を示します
このフィルターは、実際に変換を行わずにデータを解釈する方法です。 設定
あなたが本当にこれが欲しいと本当にわかっていない限り、これらはおそらく物事を壊すだけです
壊れたメディアのテストや処理などの理由。


この形式への変換を強制します。 使用する --af=フォーマット=フォーマット=ヘルプ リストを取得するには
有効な形式の。


特定のサンプルレートへの変換を強制します。 レートは整数、48000 です。
例えば。


特定のチャンネル レイアウトへのミキシングを強制します。 見る -オーディオチャネル のオプション
可能な値。







注意: このフィルターは以前は名前が付けられていました 力。 老人 形式でアーカイブしたプロジェクトを保存します． フィルター
フィルターシステムに処理させるこの変換とは異なり、変換自体
変換。

ボリューム[= [:...]]
ソフトウェア ボリューム コントロールを実装します。 このフィルタは注意して使用してください。
音の信号対雑音比を下げます。 ほとんどの場合、
Master サウンド カードのボリューム コントロールまたはアンプのボリューム ノブ。

注意: このフィルターは再入可能ではないため、毎回 XNUMX 回のみ有効にすることができます。
オーディオストリーム。


ストリーム内のすべてのチャンネルの必要なゲインを dB 単位で -200 dB から
+60 dB、-200 dB でサウンドが完全にミュートされ、+60 dB でゲインが
1000（デフォルト：0）。

リプレイゲイントラック
に格納されているトラック ゲインの再生ゲイン値に従ってボリューム ゲインを調整します。
ファイルのメタデータ。

リプレイゲインアルバム
replaygain-track と同様ですが、album-gain 値を代わりに使用します。

リプレイゲインプリアンプ
選択したリプレイゲインゲインに適用する前置増幅ゲイン (dB)
（デフォルト：0）。

replaygain-clip=はい|いいえ
ゲインを自動的に下げることで、リプレイゲインによるクリッピングを防ぎます
（デフォルト）。 使用する replaygain-clip=いいえ これを無効にします。

リプレイゲインフォールバック
ファイルにリプレイ ゲイン タグがない場合に適用する dB 単位のゲイン。 このオプションは
replaygain ロジックが何らかの形で非アクティブな場合は常に適用されます。 これが
適用され、他の replaygain オプションは適用されません。

ソフトクリップ
ソフト クリッピングをオンにします。 ソフト クリッピングは、サウンドをよりスムーズにすることができます。
高音量レベルが使用されます。 のダイナミック レンジが
ラウドスピーカーは非常に低いです。

警告: この機能は歪みを作成し、最後に考慮する必要があります。
リゾート。

s16 設定されている場合は、S16 サンプル形式を強制します。 品質は低くなりますが、一部では高速になる可能性があります
状況。

デタッチ オーディオ フィルタの設定時に音量が変更されていない場合は、フィルタを削除します。
replaygain で便利: 現在のファイルに replaygain タグがない場合、
このオプションを有効にすると、フィルタが削除されます。 （もしも --softvol=はい 使用されている
プレーヤーの音量コントロールが再生中に使用され、別の音量
フィルターが挿入されます。)

例

mpv --af=ボリューム=10.1 メディア.avi
サウンド レベルが
高すぎる。

パン=n:[ ]
チャンネルを任意にミックスします。 基本的にボリュームとチャンネルの組み合わせ
多くのチャンネルを少数のチャンネルにダウンミックスするために使用できるフィルター。
モノ、またはサラウンド サウンド システムのセンター スピーカーの「幅」を変更します。 これ
フィルターは使いにくく、目的の結果が得られるまでには多少の調整が必要です。
得られた。 このフィルタのオプションの数は、出力の数によって異なります
チャンネル。 これを使用して XNUMX チャンネルのファイルを XNUMX チャンネルにダウンミックスする方法の例
filter は、末尾近くの例のセクションにあります。

出力チャネル数 (1 ～ 8)。


値のリスト [L00,L01,L02,...,L10,L11,L12,...,Ln0,Ln1,Ln2,...]ここで、
各要素 リージ 入力チャネル i がどれだけ出力にミックスされるかを意味します
チャネル j (範囲 0 ～ 1)。 したがって、原則として、最初に何を言っているn個の数字がありますか
最初の入力チャネルを処理し、次に XNUMX 番目の入力チャネルに作用する n 個の数値
入力チャンネルなど 数値を指定しない入力がある場合
チャネル、0 が想定されます。 値が次のように区切られていることに注意してください ,ボタンの隣にある
フィルターを分離するために、オプション パーサーによって既に使用されています。 これがあなたがしなければならない理由です
値リストを引用します [...] または類似。

例

mpv --af=pan=1:[0.5,0.5] メディア.avi
ステレオからモノラルにダウンミックスします。

mpv --af=pan=3:[1,0,0.5,0,1,0.5] メディア.avi
チャンネル 3 と 0 をそのまま残して 1 チャンネル出力し、ミックスします。
チャンネル 0 と 1 を出力チャンネル 2 に送信します (これは、
サブウーファーなど）。

注:
特定の出力チャンネルレイアウトにリミックスを強制したいだけなら、
をより使いやすく 形式でアーカイブしたプロジェクトを保存します． フィルター。 例えば、 mpv '--af=フォーマット=チャネル=5.1'
'--オーディオ チャネル = 5.1' 常にオーディオを 5.1 にリミックスして出力します。
このような。

遅延[=[ch1,ch2,...]]
ラウドスピーカーへのサウンドを遅らせて、別のスピーカーからのサウンドが聞こえるようにします。
チャンネルが同時にリスニングポジションに到達します。 次の場合にのみ役立ちます。
2 つ以上のスピーカーがあります。

[ch1、ch2、...]
各チャネルに課されるミリ秒単位の遅延 (浮動小数点
0 から 1000 までの数)。

異なるチャネルに必要な遅延を計算するには、次のようにします。

1. リスニングに関連して、スピーカーまでの距離をメートル単位で測定します
これにより、距離 s1 から s5 が得られます (5.1 システムの場合)。 ありません
サブウーファーを補正するポイント (違いは聞こえません)
とにかく）。

2. 最大距離から距離 s1 から s5 を引きます。 s [i] = 最大 -
s[i]; i = 1 5 ....

3. 必要な遅延を ms で計算します。 d [i] = 1000*s[i]/342; i = 1 5 ....

例

mpv --af=遅延=[10.5,10.5,0,0,7,0] メディア.avi
フロントの左右を 10.5 ミリ秒遅らせ、リアの XNUMX つのチャンネルと
サブウーファーは 0 ミリ秒、センター チャンネルは 7 ミリ秒です。

drc[=メソッド:対象]
ダイナミック レンジ圧縮を適用します。 これにより、圧縮されたボリュームが最大化されます。
オーディオ信号のダイナミック レンジ。 （以前は ボリューム.)


使用方法を設定します。

1 単一のサンプルを使用して、標準を介して変動を平滑化します
過去のサンプルの加重平均 (デフォルト)。

2 いくつかのサンプルを使用して、標準を介して変動を平滑化します
過去のサンプルの加重平均。


ターゲット振幅をサンプル タイプの最大値の分数として設定します
（デフォルト：0.25）。

注:
このフィルターは、非常に大きなオーディオ信号で歪みを引き起こす可能性があります。
ダイナミックレンジ。

スケールテンポ[=オプション1:オプション2:...]
ピッチを変更せずにオーディオのテンポをスケーリングし、オプションで再生速度に同期します
（ディフォルト）。

これは、オーディオの「ストライド」ミリ秒を通常の速度で再生してから消費することで機能します
入力オーディオの 'stride*scale' ミリ秒。 ブレンドすることでストライドをつなぎ合わせます
前のストライドに続くオーディオとのストライドの 'overlap'%。 オプションで
決定するために、オーディオの次の「検索」ミリ秒に対して短い統計分析を実行します
重ねる位置がベスト。

スケール=
テンポをスケールする公称量。 速度に加えて、この量をスケーリングします。
（デフォルト：1.0）

ストライド=
各ストライドを出力するミリ秒単位の長さ。 値が高すぎると、
スケール量が多いとスキップが目立ち、スケール量が少ないとエコーが発生します。
非常に低い値はピッチを変更します。 増やすとパフォーマンスが向上します。 （デフォルト：
60）

オーバーラップ=
オーバーラップするストライドのパーセンテージ。 減らすとパフォーマンスが向上します。 （デフォルト：
.20）

検索=
最適なオーバーラップ位置を検索するミリ秒単位の長さ。 減少
パフォーマンスを大幅に向上させます。 遅いシステムでは、おそらく設定したいでしょう
これは非常に低いです。 (デフォルト: 14)

速度=
速度変化に対する応答を設定します。

テンポ 速度に同期してテンポをスケールします (デフォルト)。

ピッチ フィルターの効果を逆にします。 テンポを変更せずにピッチをスケーリングします。 追加
これをあなたに 入力.conf 音楽の半音単位でステップするには:

[ 乗算速度 0.9438743126816935
] 乗算速度 1.059463094352953

警告：
ビデオとの同期が失われます。

両言語で テンポとピッチの両方をスケーリングします。

なし 速度変化を無視します。

例

mpv --af=スケールテンポ --速度=1.2 メディア.ogg
メディアを通常の 1.2 倍の速度で再生し、オーディオを通常のピッチで再生します。
再生速度を変更すると、オーディオのテンポが一致するように変更されます。

mpv --af=scaletempo=scale=1.2:speed=なし --速度=1.2 メディア.ogg
メディアを通常の 1.2 倍の速度で再生し、オーディオを通常のピッチで再生しますが、
再生速度を変更しても、オーディオのテンポには影響しません。

mpv --af=scaletempo=stride=30:overlap=.50:search=10 メディア.ogg
品質とパフォーマンスのパラメーターを微調整します。

mpv --af=format=float、スケールテンポ メディア.ogg
scaletempo で float コードを使用するようにします。 一部のプラットフォームではおそらく高速です。

mpv --af=scaletempo=scale=1.2:speed=ピッチ audio.ogg
メディアを通常の 1.2 倍の速度で再生し、オーディオを通常のピッチで再生します。
再生速度を変更するとピッチが変化し、オーディオのテンポは 1.2x のままになります。

輪ゴム
librubberband による高品質のピッチ補正。 これは代わりに使用できます
スケールテンポ、異なる速度で再生するときにオーディオピッチを調整するために使用されます
ノーマルから。

このフィルターには、いくつかのサブオプションがあります。 あなたはそれらをリストすることができます mpv
--af=rubberband=ヘルプ. これにより、各オプションのデフォルト値も表示されます。 の
オプションは librubberband に渡されるだけなので、ここでは説明しません。
各オプションの機能については、librubberband のドキュメントを参照してください。
http://breakfastquay.com/rubberband/code-doc/classRubberBand_1_1RubberBandStretcher.html
(mpv ラバーバンド フィルター サブオプションの名前と値のマッピング
librubberband は単純なパターンに従います。 "オプション" + お名前 + 値.)

lavfi=グラフ
FFmpeg の libavfilter を使用してオーディオをフィルタリングします。


libavfilter グラフ。 見る ラフフィ ビデオ フィルタの詳細 - グラフの構文は次のとおりです。
同じ。

警告：
lavfi ビデオで説明されている libavfilter グラフを引用することを忘れないでください
フィルターセクション。

o=
AV オプション。

VIDEO FILTERS

ビデオ フィルタを使用すると、ビデオ ストリームとそのプロパティを変更できます。 構文は次のとおりです。

--vf =
ビデオ フィルタのチェーンをセットアップします。

各フィルターのデフォルトを設定することもできます。 デフォルトは通常の前に適用されます
フィルタ パラメータ。

--vf-defaults=
各フィルタのデフォルトを設定します。

注:
使用可能なビデオ フィルタの完全なリストを取得するには、次を参照してください。 --vf=ヘルプ.

また、ほとんどの実際のフィルターは、 ラフフィ ラッパー
libavfilter のフィルターのほとんどにアクセスできます。 これには、
MPlayer から libavfilter に移植されました。

ビデオ フィルタはリストで管理されます。 フィルタ リストを管理するためのコマンドがいくつかあります。

--vf-add=
引数として指定されたフィルターをフィルター リストに追加します。

--vf-pre=
引数として指定されたフィルターをフィルター リストの先頭に追加します。

--vf-del=
指定されたインデックスのフィルターを削除します。 インデックス番号は 0 から始まり、負の数
数字はリストの最後を示します (-1 が最後です)。

--vf-clr
フィルタ リストを完全に空にします。

それをサポートするフィルターを使用すると、名前でパラメーターにアクセスできます。

--vf= =ヘルプ
特定のフィルターのパラメーター名とパラメーター値の範囲を出力します。

--vf=
名前付きパラメーターを指定された値に設定します。 on と off または yes と no を使用してフラグを設定します
パラメーター。

利用可能なフィルターは次のとおりです。

作物[=w:h:x:y]
画像の指定された部分をトリミングし、残りを破棄します。 黒を取り除くのに便利
ワイドスクリーンビデオからのバンド。

、
トリミングされた幅と高さ。デフォルトは元の幅と高さです。

、
トリミングされた画像の位置。デフォルトは中央です。

展開[=w:h:x:y:アスペクト:ラウンド]
ビデオの解像度を指定された値に拡張 (スケーリングではなく) し、スケーリングされていないものを配置します。
座標 x、y のオリジナル。

、
拡張された幅、高さ (デフォルト: 元の幅、高さ)。 の負の値
w と h は、元のサイズに対するオフセットとして扱われます。

例

展開=0:-50:0:0
画像の下部に 50 ピクセルの境界線を追加します。

、
展開された画像上の元の画像の位置 (デフォルト: 中央)


解像度ではなく縦横比に合わせて拡張します (デフォルト: 0)。

例

展開=800::::4/3
ソースの解像度が高い場合を除き、800x600 に拡張されます。
この場合、4/3 のアスペクトを満たすように拡張されます。


幅と高さの両方を で割り切れるように切り上げます。 (デフォルト: 1)。

フリップ 画像を上下反転します。

ミラー Y 軸でイメージを鏡像化します。

回転[=0|90|180|270]
画像を時計回りに 90 度の倍数だけ回転します。

スケール[=w:h:param:param2:chr-drop:noup:arnd]
ソフトウェア スケーラー (低速) で画像をスケーリングし、YUV<->RGB カラーを実行します。
スペース変換 (参照 --sws).

すべてのパラメーターはオプションです。

:
スケーリングされた幅/高さ (デフォルト: 元の幅/高さ)

0 スケーリングされた d_width/d_height

-1 元の幅/高さ

-2 他の次元と事前にスケーリングされたアスペクトを使用して w/h を計算します
比率。

-3 他の次元と元のアスペクトを使用して w/h を計算します
比率。

-(n+8) 上記の -n と同様ですが、次数の最も近い倍数に次元を丸めます。
16.

[: ] （参照してください また --sws)
で選択したスケーラーのタイプに応じて、いくつかのスケーリング パラメータを設定します。
--sws:

--sws=2 (バイキュービック): B (ぼかし) と C (リンギング)
0.00:0.60 デフォルト
0.00:0.75 VirtualDub の「正確なバイキュービック」
0.00:0.50 Catmull-Rom スプライン
0.33:0.33 Mitchell-Netravali スプライン
1.00:0.00 XNUMX 次 B スプライン

--sws=7 (ガウス): シャープネス (0 (ソフト) - 100 (シャープ))

--sws=9 (ランチョス): フィルターの長さ (1-10)


クロマスキップ

0 色差に使用可能なすべての入力ラインを使用します (デフォルト)。

1 2. クロマにはすべての入力ラインのみを使用してください。

2 4. クロマにはすべての入力ラインのみを使用してください。

3 8. クロマにはすべての入力ラインのみを使用してください。

元のサイズを超えるアップスケーリングを禁止します。

0 アップスケーリングを許可します (デフォルト)。

1 XNUMX つのディメンションが元の値を超える場合、アップスケーリングを許可しません。

2 両方のディメンションが元の値を超える場合、アップスケーリングを許可しません。

垂直スケーラーの正確な丸め (高速または低速)
デフォルトの丸めよりも。

いいえ 正確な丸めを無効にします (デフォルト)。

はい 正確な丸めを有効にします。

dsize[=w:h:アスペクト方式:r:アスペクト]
フィルタ チェーンの任意のポイントで、目的の表示サイズ/アスペクトを変更します。
アスペクトは、分数 (4/3) または浮動小数点数 (1.33) として指定できます。
または、必要な正確な表示幅と高さを指定することもできます。 ノート
このフィルターが行うこと スケーリング自体を行います。 後のスケーラーに影響するだけです
（ソフトウェアまたはハードウェア）は、正しいアスペクトに自動スケーリングするときに行います。

、
新しいディスプレイの幅と高さ。

次の特別な値にすることもできます。

0 元の表示幅と高さ

-1 元のビデオの幅と高さ (デフォルト)

-2 他の次元と元の表示を使用して w/h を計算します
アスペクト比。

-3 他のディメンションと元のビデオのアスペクトを使用して w/h を計算します
比率。

例

dsize=800:-2
アスペクト比 800/600 のビデオに 4x3 の表示解像度を指定します。
または 800/450 アスペクト ビデオの場合は 16x9。


元の縦横比に従って幅と高さを変更します。

-1 元の縦横比を無視します (デフォルト)。

0 を使用してディスプレイの縦横比を維持する および 最大解像度として。

1 を使用してディスプレイの縦横比を維持する および 最小解像度として。

2 を使用してビデオのアスペクト比を維持する および 最大解像度として。

3 を使用してビデオのアスペクト比を維持する および 最小解像度として。

例

dsize=800:600:0
最大で 800x600 以下のディスプレイ解像度を指定します。
アスペクトを維持するために。

幅と高さの両方を で割り切れるように切り上げます。 （デフォルト：1）。


アスペクト比を強制します。

フォーマット=fmt= :カラーマトリックス= :...
変換を行わずに、次のフィルターの色空間を制限します。 使用する
実際の変換のためのスケール フィルターと一緒に。

注:
使用可能な形式のリストについては、を参照してください。 format=fmt=ヘルプ.

フォーマット名。たとえば、rgb15、bgr24、420p など (デフォルト: 変更しないでください)。


出力の代わりに使用する形式名。 持っていない場合
ピクセルあたりのバイト数と彩度のサブサンプリングが同じであると、失敗します。


ビデオの再生時に、YUV から RGB への色空間変換を制御します。 がある
さまざまな基準。 通常、SD ビデオには BT.601 を使用し、BT.709 を使用する必要があります。
HDビデオ用。 (これはデフォルトで行われます。) 誤った色空間の結果を使用する
わずかに彩度が低いまたは高い色やシフトした色で。

これらのオプションは常にサポートされているわけではありません。 さまざまなビデオ出力が提供
さまざまな程度のサポート。 の OpenGLの および vdpau ビデオ出力ドライバー
通常、完全なサポートを提供します。 の xv 次の場合、output は色空間を設定できます。
システム ビデオ ドライバはサポートしていますが、入力レベルと出力レベルはサポートしていません。 の 階段
ビデオ フィルタは色空間と入力レベルを設定できますが、
出力形式は RGB です (ビデオ出力ドライバーが RGB 出力をサポートしている場合、
これを強制することができます -vf スケール、フォーマット = rgba).

このオプションがに設定されている場合 オート (これがデフォルトです)、ビデオの色
スペース フラグが使用されます。 そのフラグが設定されていない場合、色空間は
自動的に選択されます。 これは、単純なヒューリスティックを使用して行われます。
SD ビデオと HD ビデオを区別します。 ビデオが 1279x576 ピクセルより大きい場合、
BT.709 (HD) が使用されます。 それ以外の場合は、BT.601 (SD) が選択されます。

利用可能な色空間は次のとおりです。

オート 自動選択 (デフォルト)

bt.601 ITU-R BT.601 (SD)

bt.709 ITU-R BT.709 (HD)

bt.2020-ncl
ITU-R BT.2020 非定輝度システム

bt.2020-cl
ITU-R BT.2020 定輝度システム

smpte-240m
SMPTE-240M


YUV から RGB への変換で使用される YUV カラー レベル。 このオプションは
標準色に従わない壊れたファイルを再生するときに必要
レベルまたは間違ったフラグが付けられています。 動画で色が指定されていない場合
範囲、制限された範囲と見なされます。

と同じ制限 が適用されます。

使用可能な色の範囲は次のとおりです。

オート 自動選択 (通常は制限された範囲) (デフォルト)

限られました
限られた範囲 (ルミナンスは 16 ～ 235、クロマは 16 ～ 240)

フル 全範囲 (輝度と彩度の両方で 0 ～ 255)


ソース ファイルのエンコードに使用された RGB 原色。 通常、これは
ファイル ヘッダーに設定されますが、壊れたファイルや誤ってタグ付けされたファイルを再生する場合、これは
設定をオーバーライドするために使用できます。

このオプションは、カラーを実行するビデオ出力ドライバーにのみ影響します
マネジメント、例えば OpenGLの ターゲットプリム or icc プロファイル
サブオプション セット。

このオプションがに設定されている場合 オート （これがデフォルトです）、ビデオの
プライマリ フラグが使用されます。 そのフラグが設定されていない場合、色空間は
次のヒューリスティックを使用して、自動的に選択されます。
BT.2020 または BT.709 として設定または決定されている場合、
対応する原色が使用されます。 それ以外の場合、ビデオの高さが
正確に 576​​ (PAL)、BT.601-625 が使用されます。 正確に 480 または 486 (NTSC) の場合、
BT.601～525を使用。 ビデオ解像度がそれ以外の場合、BT.709 は
中古。

使用可能な原色は次のとおりです。

オート 自動選択 (デフォルト)

bt.601-525
ITU-R BT.601 (SD) 525 回線システム (NTSC、SMPTE-C)

bt.601-625
ITU-R BT.601 (SD) 625 回線システム (PAL、SECAM)

bt.709 ITU-R BT.709 (HD) (sRGB と同じ原色)

bt.2020
ITU-R BT.2020 (UHD)

リンゴ アップルRGB

アドベ Adobe RGB（1998）

プロフォト
プロフォト RGB (ROMM)

cie1931
CIE1931RGB


ソース ファイルがエンコードされたガンマ関数。 通常、これは
ファイルヘッダーに設定されますが、壊れたファイルまたは誤ったタグのファイルを再生する場合
これは、設定をオーバーライドするために使用できます。

このオプションは、カラーを実行するビデオ出力ドライバーにのみ影響します
管理。

このオプションがに設定されている場合 オート (これがデフォルトです)、ガンマは
YCbCr コンテンツの場合は BT.1886、RGB コンテンツの場合は sRGB、Linear に設定します。
XYZ コンテンツの場合。

使用可能なガンマ関数は次のとおりです。

オート 自動選択 (デフォルト)

bt.1886
ITU-R BT.1886 (BT.601/BT.709/BT.2020 曲線の近似)

SRGB IEC 61966-2-4 (sRGB)

線形 リニアライト

gamma1.8
純粋なパワーカーブ (ガンマ 1.8)

gamma2.2
純粋なパワーカーブ (ガンマ 2.2)

gamma2.8
純粋なパワーカーブ (ガンマ 2.8)

プロフォト
ProPhoto RGB (ROMM) 曲線


ビデオがエンコードされると想定されるステレオ モードを設定します。
としての値 --ビデオステレオモード オプションを選択します。


ビデオを表示するステレオ モードを設定します。 同じ値を取る
として --ビデオステレオモード オプションを選択します。


ビデオがエンコードされると想定される回転を度単位で設定します。 の
特別な価値 -1 入力形式を使用します。

、
表示サイズを設定します。 表示サイズを設定すると、ビデオが
縦横比を変更するだけでなく、両方向にスケーリングされます
実装の詳細であり、後で変更される可能性があります。

ビデオ フレームの表示アスペクト比を設定します。 これはフロートですが、値
など [16：9] も渡すことができます（[...] オプションを防ぐために引用するため
パーサーが解釈しないようにする : キャラクター）。

noformat[=fmt]
変換を行わずに、次のフィルターの色空間を制限します。 ようではない
フォーマット フィルター。これにより、指定した色空間以外の色空間が許可されます。

注:
使用可能な形式のリストについては、を参照してください。 noformat=fmt=ヘルプ.

フォーマット名。たとえば、rgb15、bgr24、420p など (デフォルト: 420p)。

lavfi=グラフ[:sws-flags[:o=opts]]
FFmpeg の libavfilter を使用してビデオをフィルタリングします。


libavfilter グラフ文字列。 フィルタには単一のビデオ入力パッドが必要です
および単一のビデオ出力パッド。

詳細はこちら： https://ffmpeg.org/ffmpeg-filters.html 構文と利用可能なフィルターについて。

警告：
このオプションで完全なフィルター構文を使用したい場合は、
mpv の構文とフィルターを防ぐために、フィルター グラフを引用します。
衝突からのグラフ構文。

例

-vf lavfi=[gradfun=20:30,vflip]
卒業生 意味のないパラメータでフィルタし、その後に ヴフリップ
フィルター。 (これは、libavfilter がどのようにグラフを取得するかを示しています。
単一のフィルタのみです。) フィルタ グラフの文字列は、 [
および ]. これには、追加の引用やエスケープは必要ありません。
シェル (bash など)、その他 (zsh など) には追加のシェルが必要です。 "
オプション文字列を引用符で囲みます。

'--vf=lavfi="gradfun=20:30,vflip"'
前と同じですが、すべての安全な引用を使用します
シェル。 アウター ' 引用符は、シェルがそうでないことを確認します
削除する " mpv に必要な引用符。

'--vf=lavfi=graph="gradfun=radius=30:strength=20,vflip"'
前と同じですが、すべてに名前付きパラメーターを使用します。


libavfilter がピクセル形式変換用のフィルターを挿入する場合、このオプションは
libswscale に渡すフラグを指定します。 このオプションは数値です
とのビットごとの組み合わせを取ります SWS_ フラグ。

詳細はこちら： http://git.videolan.org/?p=ffmpeg.git;a=ブロブ;f=libswscale/swscale.h.

AVFilterGraph オプションを設定します。 これらはFFmpegによって文書化されるべきです。

例

'--vf=lavfi=yadif:o="threads=2,thread_type=slice"'
特定のスレッド構成を強制します。

eq[=ガンマ:コントラスト:明るさ:彩度:rg:gg:bg:weight]
ルックアップ テーブルを使用するソフトウェア イコライザー (低速)。
シンプルな明るさとコントラストの調整に加えて。 パラメータは次のように与えられます。
浮動小数点値。

<0.1-10>
初期ガンマ値 (デフォルト: 1.0)

<-2-2> 初期コントラスト。負の値は負のイメージになります (デフォルト:
1.0）

<-1-1> 初期の明るさ (デフォルト: 0.0)

<0-3> 初期彩度 (デフォルト: 1.0)

<0.1-10>
赤成分のガンマ値 (デフォルト: 1.0)

<0.1-10>
緑成分のガンマ値 (デフォルト: 1.0)

<0.1-10>
青成分のガンマ値 (デフォルト: 1.0)

<0-1> 重みパラメータを使用して、高いガンマ値の影響を軽減できます
明るい画像領域で、たとえば、それらが過増幅されないようにして、
白無地。 0.0 の値は、ガンマ補正を完全に下げます。
1.0 を指定すると、完全な強度のままになります (デフォルト: 1.0)。

プルアップ[=jl:jr:jt:jb:sb:mp]
プルダウンリバーサル（逆テレシネ）フィルター、混在対応可能
ハード テレシネ、24000/1001 fps プログレッシブ、および 30000/1001 fps プログレッシブ コンテンツ。
当学校区の プルアップ filter は、決定を下す際に将来のコンテキストを利用します。 それは
従うべきパターンにロックしないという意味でステートレスですが、
代わりに、一致を識別し、
プログレッシブ フレームを再構築します。

jl、 ジュニア、 jt、 および jb
これらのオプションは、左、右、上、および
それぞれ、画像の下部。 左右は8ピクセル単位、
top/bottom は 2 ライン単位です。 デフォルトはそれぞれ 8 ピクセルです。
サイド。

sb （厳しい 休憩）
このオプションを 1 に設定すると、 プルアップ を生成する
ときどきフレームの不一致が発生しますが、過剰な数のフレームが発生する可能性もあります
高モーション シーケンス中にドロップされるフレーム。 逆に設定すると
から -1 になります プルアップ フィールドをより簡単に一致させます。 これはの処理に役立つ場合があります
フィールド間にわずかなぼやけがあるビデオですが、
出力にインターレース フレームが含まれます。

mp （メトリック 飛行機）
このオプションは、 u or v ルマの代わりにクロマ プレーンを使用するには
するための飛行機 プルアップの計算。 これにより、非常に精度が向上する可能性があります
ソースマテリアルをきれいにしますが、精度が低下する可能性が高くなります。
彩度ノイズ (虹効果) またはグレースケール ビデオがあります。 メイン
設定の目的 mp クロマ プレーンへの変更は、CPU 負荷を軽減し、
遅いマシンでリアルタイムに使用できるプルアップ。

yadif=[モード:インターレースのみ]
さらに別のインターレース解除フィルタ



フレーム フレームごとに 1 フレームを出力します。

フィールド フィールドごとに 1 フレームを出力します。

フレーム空間
いいね フレーム ただし、空間インターレース チェックはスキップします。

フィールド空間
いいね フィールド ただし、空間インターレース チェックはスキップします。



いいえ すべてのフレームのインターレースを解除します (デフォルト)。

はい インターレースとしてマークされたインターレース解除フレームのみ (このフィルターの場合のデフォルト)
経由で挿入されます インターレース解除 プロパティ）。

このフィルターは、使用時に自動的に挿入されます。 d キー (またはその他のキー
を切り替えます インターレース解除 プロパティまたは -インターレース解除 スイッチ)、仮定
ビデオ出力には、ネイティブのインターレース解除がサポートされていません。

デフォルトモードを設定したいだけなら、このフィルターとそのオプションを
--vf-デフォルト 代わりに、デインターレースを有効にします d or -インターレース解除.

また、 d キーは、デインターレーサーを XNUMX 回挿入するほど愚かです。
yadif の挿入 --vf、上記の方法を使用することをお勧めします。

sub=[=下マージン:上マージン]
字幕のレンダリングをフィルターチェーンの任意のポイントに移動するか、強制します
ビデオ出力 OSD を使用するのではなく、ビデオ フィルターで字幕をレンダリングする
サポート。


フレームの下部に黒い帯を追加します。 SSA/ASSレンダラーは配置できます
そこに字幕（と -- サブ使用マージン).


トップタイトルの上部にある黒い帯 ( -- サブ使用マージン).

例

--vf=サブ、eq
eq フィルターの前にサブ レンダリングを移動します。 これにより、両方のサブタイトルが表示されます
ビデオイコライザー設定の影響下での色とビデオ。

ステレオ3d[=イン:アウト]
Stereo3d は、異なる立体画像フォーマット間で変換します。

入力の立体画像フォーマット。 可能な値:

sbsl or サイド・バイ・サイド・レフト・ファースト
平行に並べて（左目左、右目右）

sbsr or 横並び右ファースト
サイドバイサイドクロスアイ（右目左、左目右）

abl or 上_下_左_最初
上-下（左目が上、右目が下）

4月 or 上_下_右_最初
上-下（右目が上、左目が下）

アブ2ル or 上_下_半分の高さ_左_最初
半分の高さの解像度で上下 (左目が上、右目が上)
以下）

アブ2r or 上_下_半分の高さ_右_最初
半分の高さの解像度で上下 (右目が上、左目が上)
以下）

出力の立体画像フォーマット。 可能な値はすべて入力です
フォーマットと同様:

円弧 or アナグリフ_レッド_シアン_グレー
アナグリフ赤/シアン グレー (左目に赤フィルター、右目にシアン フィルター
目）

アーチ or アナグリフ_赤_シアン_ハーフカラー
アナグリフ 赤/シアン ハーフ カラー (左目に赤フィルター、シアン フィルター
右目に）

arcc or アナグリフ_赤_シアン_カラー
アナグリフ赤/シアン色 (左目に赤フィルター、右目にシアン フィルター
目）

アークド or アナグリフ_レッド_シアン_デュボア
最小二乗投影で最適化されたアナグリフの赤/シアン色
デュボア (左目に赤フィルター、右目にシアン フィルター)

集計 or アナグリフ_グリーン_マゼンタ_グレー
アナグリフ グリーン/マゼンタ グレー (左目にグリーン フィルター、マゼンタ フィルター)
右目に）

あー or アナグリフ_グリーン_マゼンタ_ハーフ_カラー
アナグリフ グリーン/マゼンタ ハーフ カラー (左目にグリーン フィルター、
右目のマゼンタ フィルター)

AGMC or アナグリフ_グリーン_マゼンタ_カラー
アナグリフ グリーン/マゼンタ色 (左目にグリーン フィルター、マゼンタ
右目にフィルター）

aybg or アナグリフ_イエロー_ブルー_グレー
アナグリフ イエロー/ブルー グレー (左目にイエロー フィルター、ブルー フィルターをオン)
右目）

エイブ or アナグリフ_黄_青_半色
アナグリフ イエロー/ブルー ハーフ カラー (左目にイエロー フィルター、ブルー
右目にフィルター）

aybc or アナグリフ_黄_青_色
アナグリフの黄色/青色 (左目に黄色のフィルター、青色のフィルター)
右目に）

irl or interleave_rows_left_first
インターリーブされた行 (左目は一番上の行、右目は次の行から開始)

irr or interleave_rows_right_first
インターリーブされた行 (右目が一番上の行、左目が次の行から始まる)

ml or モノ左
モノラル出力（左目のみ）

mr or モノライト
モノラル出力（右目のみ）

gradfun[=強度[:半径|:サイズ= ]]
によってほぼ平坦な領域に時々導入されるバンディングアーティファクトを修正します
8 ビットの色深度に切り捨てます。 どこに行くべきグラデーションを補間します
バンドはあり、それらをディザリングします。


フィルタが XNUMX つのピクセルを変更する最大量。 また、
ほぼ平坦な領域を検出するためのしきい値 (デフォルト: 1.5)。


グラデーションを合わせる近隣。 半径が大きいほど滑らかになります
グラデーションだけでなく、フィルターが詳細に近いピクセルを変更するのを防ぎます
リージョン (デフォルト: 無効)。

画像の対角サイズのパーセントでのフィルターのサイズ。 これは慣れている
最終的な半径サイズを計算します (デフォルト: 1)。

dlopen=dll[:a0[:a1[:a2[:a3]]]]
外部ライブラリをロードして画像をフィルタリングします。 ライブラリ インターフェイスは、
vf_dlopen を使用して指定されたインターフェイス libmpcodecs/vf_dlopen.h.

警告：
このフィルターは非推奨です。

dll=
ロードするライブラリを指定します。 これには、完全なファイル システム パスが必要になる場合があります。
ある場合。 この引数は必須です。

a0=
ライブラリに渡す最初のパラメーターを指定します。

a1=
ライブラリに渡す XNUMX 番目のパラメーターを指定します。

a2=
ライブラリに渡す XNUMX 番目のパラメーターを指定します。

a3=
ライブラリに渡す XNUMX 番目のパラメーターを指定します。

vapoursynth=ファイル:バッファリングされたフレーム:同時フレーム
VapourSynth フィルター スクリプトを読み込みます。 これはストリーミング処理を目的としています: mpv
ネイティブの VapourSynth ビデオを使用する代わりに、実際にソース フィルターを提供します。
ソース。 mpv ソースは、フレームの小さなウィンドウ内でのみフレーム リクエストに応答します。
フレーム (このウィンドウのサイズは、 バッファリングされたフレーム パラメータ）、
それ以外のリクエストはエラーを返します。 そのため、完全に使用することはできません
VapourSynth の強力な機能ですが、特定のフィルターを使用できます。

VapourSynth によって生成されたビデオを再生したいだけの場合 (つまり、ネイティブ
VapourSynth ビデオ ソース)、使用することをお勧めします VSパイプ ビデオを供給するFIFO
mpvへ。 フィルタ スクリプトがランダム フレーム アクセスを必要とする場合も同じことが当てはまります (
バッファリングされたフレーム パラメータ）。

このフィルターは実験的なものです。 それがうまく機能し、使用されていることが判明した場合は、
libavfilter に移植されます。 それ以外の場合は、単に削除されます。

file スクリプト ソースのファイル名。 現在、これは常に python スクリプトです。
変数 ビデオ入力 mpv ビデオ ソースに設定されており、期待される
スクリプトがそこからビデオを読み取ること。 (そうしないと、mpv はビデオをデコードしません。
ビデオ パケット キューがオーバーフローし、最終的にオーディオが
スクリプトは、
_DurationNum および _DurationDen フレームのプロパティ。

例：

vapoursynth を vs としてインポート
コア = vs.get_core()
core.std.AddBorders(video_in, 10, 10, 20, 20).set_output()

警告：
スクリプトはシークごとに再読み込みされます。 これは、
不連続で適切にフィルタリングします。

バッファリングされたフレーム
デコード前にバッファリングするデコード済みビデオ フレームの最大数
フィルター (デフォルト: 4)。 スクリプトの最大フレーム数を指定します。
逆方向にリクエストできます。 たとえば、 バッファーフレーム=5、そしてスクリプトだけ
フレーム 15 を要求した場合、フレーム 10 を要求できますが、フレーム 9 は要求できません。
もう利用できます。 フレーム 30 を要求すると、mpv はさらに 15 フレームをデコードします。
フレーム 25 ～ 30 のみを保持します。

バッファリングされたフレームの実際の数は、
同時フレーム オプション。 現在、両方のオプション値が乗算されます
最終的なバッファ サイズを取得します。

(通常、VapourSynth ソース フィルターはランダム アクセスを提供する必要がありますが、mpv
再生用に作成されたものであり、正確なフレームのランダム アクセスは提供しません。 の
このビデオ フィルターの仕組みは、単純なフィルターを機能させるための妥協点です。
とりあえず。）

同時フレーム
並行して要求する必要があるフレームの数。 のレベル
同時実行性は、フィルターと、mpv がビデオをデコードできる速度に依存します。
フィルターにフィードします。 この値は、おそらく
マシン上のコア。 ほとんどの場合、コアの数よりも高くなります
実際に遅くすることができます。

デフォルトでは、これは特別な値を使用します オート、オプションをに設定します
検出された論理 CPU コアの数。

次の変数は mpv によって定義されます。

ビデオ入力
vapoursynth クリップとしての mpv ビデオ ソース。 これには長さが設定されていないことに注意してください。
これは多くのフィルターを混乱させます。 使用する トリム ダミーの長さが長いクリップ
それを有限のクリップに変えることができます。

video_in_dw、 video_in_dh
ビデオの表示サイズ。 ビデオの場合、ビデオのサイズとは異なる場合があります。
正方形ピクセルを使用しません (例: DVD)。

コンテナ_fps
ファイル ヘッダーによって報告される FPS 値。 この値は間違っているか、完全に間違っている可能性があります
壊れています (例: 0 または NaN)。 値が合っていても別のフィルターだと
実際の FPS を (フレームのドロップまたは挿入によって) 変更します。この値
変数は役に立たないかもしれません。 注意してください --fps コマンドラインオプション
この値をオーバーライドします。

FPS を持つことを主張するいくつかのフィルターに役立ちます。

表示_fps
現在のディスプレイのリフレッシュ レート。 この値は 0 になる可能性があることに注意してください。

蒸気シンセレイジー
と同じ 蒸気合成、ただし Python スクリプトはロードしません。 代わりに、カスタム バックエンド
Lua を使用し、生の VapourSynth API が使用されます。 構文はまったく異なりますが、
便利な機能はまったく提供されていません。 型チェックがない
いずれかであり、クラッシュをトリガーできます。

例：

video_out = invoke("モルフォ", "開く", {clip = video_in})

特別な変数 ビデオ入力 は mpv ビデオ ソースで、特殊変数は
ビデオ出力 からビデオを読み取るために使用されます。 1 番目の引数はプラグインです (
getPluginByNs)、2 番目はフィルタ名、3 番目の引数は
引数。 位置引数はサポートされていません。 タイプが一致する必要があります
まさに。 Luaはひどい上に整数と浮動小数点数の区別がつかないので、整数
引数には接頭辞を付ける必要があります i_、この場合、プレフィックスは削除され、
引数は整数にキャストされます。 引数の名前は i_、あなたは
運が悪い。

クリップ (VSNodeRef) はライト ユーザーデータとして渡されるので、それ以外を渡そうとします。
userdata タイプはハード クラッシュを引き起こします。

ヴァヴップ VA-AP-API ビデオ ポスト プロセッシング。 で動作します --vo = vaapi および --vo = opengl のみ。
現在インターレースを解除しています。 このフィルターは、インターレース解除が有効な場合に自動的に挿入されます。
要求された ( d デフォルトでコマンドにマップされるキー サイクル
インターレース解除、または -インターレース解除 オプション）。

deint=
インターレース解除アルゴリズムを選択します。

いいえ デインターレースを実行しません。

最初のフィールド
最初のフィールドのみを表示 ( -- フィールド優勢).

ボブ bob deinterlacing (デフォルト)。

織り、 モーション適応、 動き補償
高度なインターレース解除アルゴリズム。 これらが実際に機能するかどうか
GPU ハードウェア、GPU ドライバー、ドライバーのバグ、および mpv に依存します。
バグ。



いいえ すべてのフレームをインターレース解除します。

はい インターレースとしてマークされたインターレース解除フレームのみ (デフォルト)。

vdpaupp
VDPAU ビデオ ポスト プロセッシング。 で動作します --vo = vdpau および --vo = opengl それだけ。 この
インターレース解除が要求された場合、フィルターは自動的に挿入されます ( d
デフォルトでコマンドにマップされるキー サイクル インターレース解除、または -インターレース解除
オプション）。 デインターレースを有効にすると、常にソフトウェアよりも優先されます
deinterlacer フィルタの場合 vdpau VO が使用されている場合 OpenGLの 使用され、
ハードウェア デコードが少なくとも XNUMX 回アクティブ化されました (つまり、vdpau がロードされました)。

研ぎ=<-1-1>
正の値の場合は、ビデオにシャープ化アルゴリズムを適用し、負の場合は
ぼかしアルゴリズムの値 (デフォルト: 0)。

denoise = <0-1>
ビデオにノイズ削減アルゴリズムを適用します (デフォルト: 0; ノイズなし)
割引）。

deint=
デインターレースを有効にするかどうか (デフォルト: no)。 有効にすると、
で選択したモード deint モード.

deint-mode=
デインターレース モードを選択します (デフォルト: テンポラル)。 すべてのモードが尊重
-- フィールド優勢.

現在、これを許可するメカニズムがあることに注意してください vdpau 変更するVO
　 deint モード 自動挿入の vdpaupp フィルター。 混乱を避けるために、それは
を使用しないことをお勧めします --vo = vdpau フィルタリングに関連するサブオプション。

最初のフィールド
最初のフィールドのみを表示します。

ボブ ボブのインターレース解除。

一時的な
動きに適応した一時的なインターレース解除。 との A/V 非同期化につながる可能性があります
ビデオハードウェアが遅いか、解像度が高い。

時空間
エッジ ガイド付き空間を使用したモーション アダプティブ テンポラル デインターレース
補間。 高速なビデオ ハードウェアが必要です。

彩度
ルミナンスとクロマの両方でテンポラル デインターレーサーを動作させます (デフォルト)。 使用する
no-chroma-deint を使用して輝度のみを使用し、高度なインターレース解除を高速化します。
遅いビデオメモリで便利です。

プルアップ 逆テレシネを適用してみてください。動きに適応した一時的なインターレース解除が必要です。

インターレースのみ=
If はい (デフォルト)、インターレースとしてマークされたインターレース解除フレームのみ。

hqscaling=<0-9>

0 デフォルトの VDPAU スケーリングを使用します (デフォルト)。

1-9 高品質の VDPAU スケーリングを適用します (対応するハードウェアが必要です)。

ヴドパウルブ
VDPAU ビデオ リードバック。 で動作します --vo = vdpau および --vo = opengl それだけ。 このフィルター
VDPAU によってデコードされたフレームを読み戻して、他のフィルターではなく、
通常はVDPAUと互換性があり、通常どおり使用できます。 このフィルタは
前に指定 vdpaupp フィルターチェーンで vdpaupp 使用されている。

バッファ=
バッファ フィルター チェーンのフレーム。 このフィルターはおそらくかなり役に立ちません。
デバッグを除いて。 (これは遅延を滑らかにするのに役立たないことに注意してください
バッファーがいっぱいでない場合、フィルターはフレームを出力しないため、デコードします。
EOF を除く)。

エンコーディング

この機能を使用して、あるフォーマット/コーデックから別のフォーマット/コーデックにファイルをエンコードできます。

--o=
エンコード モードを有効にし、出力ファイル名を指定します。

--of=
出力形式を指定します (ファイル名拡張子によって自動検出をオーバーライドします。
で指定されたファイル -o）。 これは、可能なフォーマットのカンマ区切りのリストにすることができます
試してみる。 見る --of=ヘルプ サポートされている形式の完全なリストについては、

--ofopts=
libavformat の出力形式オプションを指定します。 見る --ofopts=ヘルプ 完全に
サポートされているオプションのリスト。

オプションはリストで管理されます。 オプション リストを管理するためのコマンドがいくつかあります。

--ofopts-add=
引数として指定されたオプションをオプション リストに追加します。

--ofopts-pre=
引数として指定されたオプションをオプション リストの先頭に追加します。

--ofopts-del=
指定されたインデックスのオプションを削除します。 インデックス番号は 0 から始まり、負の数
数字はリストの最後を示します (-1 が最後です)。

--ofopts-clr
オプション リストを完全に空にします。

--ofps= 値>
出力フォーマットのタイムベースを指定します (デフォルト: 24000)。 25 リミットなどの低い値
フレームをドロップすることにより、ビデオの fps。

--oautofps
出力フォーマットのタイムベースを、入力ビデオの推定フレームレートに設定します
(MEncoder の動作をシミュレートします。AVI に役立ちます。フレーム ドロップが発生する場合があります)。 ご了承ください
すべてのコーデックとすべてのフォーマットが VFR エンコーディングをサポートしているわけではありません。
ターゲット ビットレートが指定されている場合のバグ - 使用 --ofps or --oautofps CFRを強制する
これらの場合のエンコーディング。

--omaxfps= 値>
隣接するフレームの最小距離を指定します (デフォルト: 0、未設定を意味します)。
低いフレーム レートのコンテンツは、このフレーム レートに再調整されません。 より高い内容
フレーム レートは、このフレーム レートにデシメートされます。

--oharddup
設定されている場合、フレームレートは --ofps タイムコードを飛ばすのではなく、
フレームを複製する (固定フレーム レート モード)。

-- ワンドロップ
設定されている場合、フレームはドロップされません。 代わりに、ビデオのタイム コードが再調整されます。
常に増加します。 ただし、これにより AV 非同期が発生する可能性があります。 これを回避するには、
使用する高 fps タイムベース --ofps そして絶対に避ける --oautofps.

--oac=
出力オーディオ コーデックを指定します。 これは、可能性のあるコンマ区切りのリストにすることができます
試すコーデック。 見る --oac=ヘルプ サポートされているコーデックの完全なリストについては、.

--oaoffset=
でサンプルを追加/削除することにより、指定された時間 (秒単位) でオーディオ データをシフトします。
開始。

--oacopts=
libavcodec の出力オーディオ コーデック オプションを指定します。 見る --oacopts=ヘルプ のために
サポートされているオプションの完全なリスト。

例

--oac=libmp3lame --oacopts=b=128000
128 kbps MP3 エンコーディングを選択します。

オプションはリストで管理されます。 オプション リストを管理するためのコマンドがいくつかあります。

--oacopts-add=
引数として指定されたオプションをオプション リストに追加します。

--oacopts-pre=
引数として指定されたオプションをオプション リストの先頭に追加します。

--oacopts-del=
指定されたインデックスのオプションを削除します。 インデックス番号は 0 から始まり、負の数
数字はリストの最後を示します (-1 が最後です)。

--oacopts-clr
オプション リストを完全に空にします。

--oafirst
オーディオ ストリームが出力の最初のストリームになるように強制します。 デフォルトでは、
順番は未定。

--ovc=
出力ビデオ コーデックを指定します。 これは、可能性のあるコンマ区切りのリストにすることができます
試すコーデック。 見る --ovc=ヘルプ サポートされているコーデックの完全なリストについては、.

--ovoffset=
pts 値をシフトすることにより、ビデオ データを指定された時間 (秒単位) だけシフトします。

--ovcopts
libavcodec の出力ビデオ コーデック オプションを指定します。 --ovcopts=help を参照してください。
サポートされているオプションの完全なリスト。

例

"--ovc=mpeg4 --ovcopts=qscale=5"
MPEG-5 エンコーディングに定数量子化スケール 4 を選択します。

"--ovc=libx264 --ovcopts=crf=23"
H.23 エンコーディングに VBR 品質係数 264 を選択します。

オプションはリストで管理されます。 オプション リストを管理するためのコマンドがいくつかあります。

--ovcopts-add=
引数として指定されたオプションをオプション リストに追加します。

--ovcopts-pre=
引数として指定されたオプションをオプション リストの先頭に追加します。

--ovcopts-del=
指定されたインデックスのオプションを削除します。 インデックス番号は 0 から始まり、負の数
数字はリストの最後を示します (-1 が最後です)。

--ovcopts-clr
オプション リストを完全に空にします。

--ovfirst
ビデオ ストリームが出力の最初のストリームになるように強制します。 デフォルトでは、
順番は未定。

--ocopyts
入力ポイントを出力ビデオにコピーします (一部の出力コンテナではサポートされていません)
AVI などの形式)。 不連続性はまだ修正されています。 デフォルトでは、音声ポイントが設定されています
一部の出力として、再生時間とビデオ ポイントがオーディオ ポイントと一致するように同期されます。
フォーマットは他のものをサポートしていません。

--orawts
入力ポイントを出力ビデオにコピーします (一部の出力コンテナではサポートされていません)
AVI などの形式)。 このモードでは、不連続点は固定されておらず、すべての点が固定されています。
そのまま通過。 この中で逆方向にシークしたり、複数の入力ファイルを使用したりしないでください
モード！

--メタデータなし
エンコード時に、入力ファイルから出力ファイルへのメタデータのコピーを無効にします (
デフォルトで有効になっています）。

COMMAND INTERFACE

mpv コアは、コマンドとプロパティで制御できます。 さまざまなやり取りの方法
プレーヤーでそれらを使用します: キーバインディング (入力.conf)、OSD (情報を表示する
プロパティ)、JSON IPC、クライアント API (libmpv)、および従来のスレーブ モード。

入力.conf
input.conf ファイルは、次のようなキー バインドのリストで構成されます。

s スクリーンショット # s キーでスクリーンショットを撮る
LEFT seek 15 # 左矢印キーを 15 秒前にシークするようにマップする

各行はキーを入力コマンドにマップします。 キーはリテラル値で指定されます
(と組み合わせる場合は大文字 シフト)、または特殊キーの名前。 例えば、 a にマップ
　 a シフトなしのキー、および A にマップ a シフト付き。

このファイルは mpv 設定ディレクトリにあります (通常は
~/.config/mpv/input.conf プラットフォームによって異なります)。 デフォルトのバインディングは次のように定義されています。

https://github.com/mpv-player/mpv/blob/master/etc/input.conf

特殊キーのリストは次のコマンドで取得できます
mpv --入力キーリスト

一般に、キーは次と組み合わせることができます シフト, Ctrlキー および 他の:

ctrl+q 終了

mpv キーバインディングとコマンドを表示する入力テストモードで開始できます
コマンドを実行する代わりに、OSD にバインドされます。

mpv --input-test --force-window --idle

(ウィンドウを閉じるだけで mpv 通常のキーを押すと、単に
quit にマップされている場合でもバインドします)。

全般 入力 Command 構文
[Shift+][Ctrl+][Alt+][メタ+] [{ }] [ ] ( )* [;
]

デフォルトでは、右の Alt キーを使用して特殊文字を作成できることに注意してください。
修飾子として登録されません。 オプション --no-input-right-alt-gr この動作を変更します。

改行は常に新しいバインドを開始します。 # コメントを開始します (引用符で囲まれた文字列の外側)
引数)。 コマンドを # キー、 シャープ に使える。

キーが生成するリテラル文字 (ASCII または Unicode 文字)、または
シンボリック名 ( --入力キーリスト).

(で補強 { および }) は、このコマンドの入力セクションです。

引数は空白で区切られます。 これは、文字列引数にも適用されます。 このため
理由、文字列引数は引用符で囲む必要があります ". 引用符内では、C スタイルのエスケープが可能です。
中古。

複数のコマンドを XNUMX つのキーにバインドできます。 例えば：
ショーテキスト「コマンド1」; 表示テキスト「コマンド 2」

コマンドを一連のキーにバインドすることもできます。
abc show-text "コマンドは、a、b、c が押された後に実行されます"

(これは、一般的なコマンド構文には示されていません。)

If a or ab or b 既にバインドされている場合、これは一致する最初のコマンドを実行し、
multi-key コマンドは呼び出されません。 中間キーは次の場所に再マッピングできます 無視する in
この問題を回避するために。 組み合わせの (非修飾子) キーの最大数は
現在4。

リスト of 入力 コマンド
無視する これを使用して、バインドを解除する必要があるキーを「ブロック」し、何もしません。 に便利
すべてのバインディングを無効にすることなく、デフォルトのバインディングを無効にする
--no-input-default-bindings.

求める [相対|絶対|絶対パーセント|相対パーセント|正確|キーフレーム]
再生位置を変更します。 デフォルトでは、相対秒単位でシークします。

XNUMX 番目の引数は、シーク モードを制御するフラグで構成されます。

相対 （デフォルト）
現在の位置を基準にしてシークします (負の値は逆方向にシークします)。

絶対の
指定された時間にシークします。

絶対パーセント
指定されたパーセント位置をシークします。

相対パーセント
現在の位置を基準にしてパーセントでシークします。

キーフレーム
常にキーフレーム境界で再生を再開します (高速)。

正確な 常に正確/時間/正確なシークを行います (遅い)。

複数のフラグを組み合わせることができます。例: 絶対+キーフレーム.

デフォルトでは、 キーフレーム 相対シークに使用され、 正確な 絶対に使用されます
求める。

mpv 0.9 より前は、 キーフレーム および 正確な フラグは 3 番目のパラメーターとして渡す必要がありました
(基本的に、代わりにスペースを使用します。 +）。 3 番目のパラメーターは引き続き解析されますが、
非推奨と見なされます。

復帰シーク [モード]
元に戻す 求める コマンド、およびシークする他のいくつかのコマンド (ただし、必ずしもすべてではありません)
そのうちの）。 このコマンドを XNUMX 回呼び出すと、その前の再生位置にジャンプします。
求める。 もう一度呼び出すと元に戻ります 復帰シーク コマンドそのもの。 これだけ
単一のファイル内で動作します。

最初の引数はオプションで、動作を変更できます。

マーク 現在の時間位置をマークします。 次の普通 復帰シーク コマンドは
前回以降のシーク回数に関係なく、この時点までシークします。

引数なしで使用すると、デフォルトの動作になります。

フレームステップ
XNUMX フレーム再生してから一時停止します。 オーディオのみの再生では何もしません。

フレームバックステップ
XNUMX フレーム戻り、一時停止します。 これは非常に遅くなる可能性があることに注意してください (
正確ですが、速くはありません)、期待どおりに動作しないことがあります。 これがどれほどうまく機能するか
正確なシークが正しく機能するかどうかによって異なります (たとえば、
--hr-seek-demuxer-offset オプション）。 ビデオ フィルタまたはその他のビデオ後処理
フレームのタイミングの変更 (インターレース解除など) は、通常は機能するはずですが、
バックステッピングは、まれなケースでサイレントに正しく動作しません。 使用する
--hr-seek-framedrop=いいえ 正確なシークが遅くなる可能性がありますが、役立つはずです。

これは、オーディオのみの再生では機能しません。

セッションに
指定されたプロパティを指定された値に設定します。

加えます [ ]
指定された値をプロパティに追加します。 オーバーフローまたはアンダーフローで、プロパティをクランプします
最大限に。 もしも は省略、想定 1.

サイクル [上|下]
指定されたプロパティを循環します。 up および ダウン サイクル方向を設定します。 オーバーフロー時に、
プロパティを最小値に戻し、アンダーフロー時に最大値に設定します。 もしも up or ダウン is
省略、想定 up.

掛ける
プロパティの値に数値係数を掛けます。

スクリーンショット [字幕|ビデオ|ウィンドウ|- [シングル|各フレーム]]
スクリーンショットを撮ります。

最初の引数:

（デフォルト）
ビデオ画像を元の解像度で字幕付きで保存します。 いくつか
ビデオ出力には、特定の条件下で出力に OSD が含まれる場合があります。
状況。

video
いいね サブタイトル、ただし通常は OSD や字幕はありません。 正確な動作
選択したビデオ出力によって異なります。


mpv ウィンドウの内容を保存します。 通常、OSD と
字幕。 正確な動作は、選択したビデオ出力によって異なります。
サポートはありません。これは次のように動作します ビデオ.


フレームごとにスクリーンショットを撮ります。 このコマンドを再度発行して、取得を停止します
スクリーンショット。 これを使用するときは、フレームドロップを無効にする必要があることに注意してください
モード - または、フレームが
落とした。 このフラグは、他のフラグと組み合わせることができます。
ビデオ+各フレーム.

スクリーンショットからファイルへ [字幕|ビデオ|ウィンドウ]
スクリーンショットを撮り、所定のファイルに保存します。 ファイルのフォーマットは
拡張子によって推測されます（および --スクリーンショット形式 は無視されます - 時の動作
拡張子がないか、不明は任意です)。

XNUMX 番目の引数は、最初の引数と同様です。 スクリーンショット.

ファイルが既に存在する場合は、上書きされます。

すべての入力コマンド パラメータと同様に、ファイル名は次のようにプロパティ展開の対象となります。
に記載 プロパティ 拡張.

プレイリスト-次 [弱い|力]
プレイリストの次のエントリに移動します。

弱い （デフォルト）
プレイリストの最後のファイルが現在再生されている場合は、何もしません。

力 プレイリストにファイルがなくなったら再生を終了します。

プレイリスト前 [弱い|力]
プレイリストの前のエントリに移動します。

弱い （デフォルト）
プレイリストの最初のファイルが現在再生されている場合は、何もしません。

力 最初のファイルが再生されている場合は、再生を終了します。

ロードファイル [置換|追加|追加再生 [オプション]]
指定されたファイルをロードして再生します。

XNUMX 番目の引数:

（デフォルト）
現在のファイルの再生を停止し、すぐに新しいファイルを再生します。


ファイルをプレイリストに追加します。


ファイルを追加し、現在何も再生されていない場合は、再生を開始します。
(プレイリストが空でなくても、常に追加されたファイルから開始します
このコマンドを実行する前に。)

XNUMX 番目の引数は、オプションと値のリストであり、
ファイルを再生しています。 それは形です opt1=値1,opt2=値2,... すべてのオプションができるわけではありません
このように変更されます。 一部のオプションでは、プレーヤーの再起動が必要です。

ロードリスト [置換|追加]
指定されたプレイリスト ファイルをロードします ( -プレイリスト).

プレイリストクリア
現在再生中のファイルを除いて、プレイリストをクリアします。

プレイリストの削除 現在|
指定されたインデックスのプレイリスト エントリを削除します。 インデックス値は 0 から数え始めます。
特別な価値 現在 現在のエントリを削除します。 現在の
エントリも再生を停止し、次のエントリの再生を開始します。

プレイリスト移動
プレイリスト エントリを index1 に移動して、エントリ index2 の場所に置きます。
(逆説的に、移動されたプレイリスト エントリには、その後のインデックス値 index2 がありません。
index1 が index2 よりも小さい場合は移動します。index2 はターゲット エントリを参照するためです。
移動後のエントリのインデックスではありません。)

プレイリストシャッフル
プレイリストをシャッフルします。 これは、 - シャッフル
オプションが使用されます。

ラン command arg1 arg2 ...
指定されたコマンドを実行します。 MPlayer/mplayer2 および以前のバージョンの mpv とは異なります
(0.2.x 以前)、これはシェルを呼び出しません。 代わりに、コマンドが実行されます
直接、各引数を個別に渡します。 各引数は次のように展開されます
プロパティ 拡張. (この記事の執筆時点で) 9 の静的制限があることに注意してください。
引数 (この制限は必要に応じて引き上げることができます)。

プログラムは切り離された方法で実行されます。 mpv は、コマンドが実行されるまで待機しません。
完了しましたが、スポーン直後に再生を続けます。

古い動作を取得するには、使用します /bin/sh および -c 最初の XNUMX つの引数として。

例

ラン "/bin/sh" "-NS" "エコー $ {タイトル} > /tmp/再生中」

これは特に良い例ではありません。
エスケープ、および特別に準備されたファイルにより、攻撃者は
任意のシェル コマンドを実行します。 小さく書くことをお勧めします
シェルスクリプトを作成し、それを次のように呼び出します ラン.

やめます [ ]
プレーヤーを終了します。 引数を指定すると、プロセスの終了コードとして使用されます。

後で見る [ ]
プレーヤーを終了し、現在の再生位置を保存します。 後でそのファイルを再生すると、
開始時に前の位置に移動します。 (オプションの) 引数は、
やめます

サブ追加 [ [ [ ]]]
指定された字幕ファイルを読み込みます。 ロード後、現在のサブタイトルとして選択されます。

当学校区の フラグ args は次のいずれかの値です。


すぐにサブタイトルを選択します。


サブタイトルを選択しないでください。 (または、いくつかの特別な状況では、デフォルト
ストリーム選択メカニズムが決定します。)


サブタイトルを選択します。 同じファイル名の字幕が既に追加されている場合、
重複するエントリをロードする代わりに、そのエントリが選択されます。 （この場合、
タイトル/言語は無視され、ロード後に変更された場合、これらは
変更は反映されません。）

当学校区の タイトル 引数は、UI でトラック タイトルを設定します。

当学校区の 長い 引数はトラックの言語を設定し、ストリームの選択にも影響を与える可能性があります
　 フラグ に設定 オート.

サブ削除 [ ]
指定された字幕トラックを削除します。 もし id 引数がありません。現在の引数を削除してください
追跡。 (外部字幕ファイルのみで動作します。)

サブリロード [ ]
指定された字幕トラックを再読み込みします。 もし id 引数がありません。現在の引数をリロードしてください
追跡。 (外部字幕ファイルのみで動作します。)

これは、字幕トラックをアンロードして再度追加することで機能します。

サブステップ
字幕のタイミングを変更して、字幕イベントが次の次の 字幕
イベントが表示されます。 後退するには負の値を指定できます。

サブシーク
次の字幕 (スキップを 1 に設定) または前の字幕 (スキップを -1 に設定) にシークします。 これ
に似ています サブステップただし、調整する代わりにビデオとオーディオを探す点が異なります
サブタイトルの遅延。

埋め込み字幕 (Matroska など) の場合、これは字幕イベントでのみ機能します。
すでに表示されているか、短いプリフェッチ範囲内にあります。

OSD [ ]
OSD レベルを切り替えます。 もしも が指定されている場合は、OSD モードを設定します (を参照)。 --osd レベル の
有効な値)。

印刷テキスト
テキストを stdout に出力します。 文字列にはプロパティを含めることができます ( プロパティ 拡張).

テキスト表示 [ |- [ ]]
OSD にテキストを表示します。 文字列には、次のように展開されるプロパティを含めることができます。
に記載 プロパティ 拡張. これは、再生時間、ファイル名、
などがあります。


メッセージを表示する時間 (ミリ秒)。 デフォルトでは、同じ値を使用します
as --osd-期間.


テキストを表示する最小 OSD レベル (を参照) --osd レベル).

進行状況を表示
プログレスバー、経過時間、およびファイルの合計時間を表示します
OSD。

write-watch-later-config
レジューム構成ファイルを書きます。 後で見る コマンドは書き込みますが、続行します
通常再生。

stop 再生を停止し、プレイリストをクリアします。 デフォルト設定では、これは基本的に次のようになります
やめます. クライアント API に役立ちます。
プレイヤー。

マウス [ [シングル|ダブル]]
指定された座標でマウス イベントを送信します (, ).

XNUMX 番目の引数:


クリックされたマウス ボタンのボタン番号。 これは 0 ～ 19 のいずれかである必要があります。 もしも
を省略すると、位置のみが更新されます。

XNUMX 番目の引数:

（デフォルト）
マウス イベントは、通常のシングル クリックを表します。


マウスイベントはダブルクリックを表します。

キープレス
mpv の入力ハンドラーを介してキー イベントを送信し、動作が何であれトリガーします。
そのキーに設定されています。 キー名 使用 入力.conf キーの命名スキームと
修飾子。 クライアント API に便利: キーイベントを libmpv に送信して処理できます
内部的に。

キーダウン
そして キープレス、しかし設定します キーダウン キーがバインドされている場合にフラグを立てる
反復可能なコマンドで、mpv のキー リピート タイミングまで反復実行されます。
　 キーアップ コマンドが呼び出されます。

キーアップ [ ]
をセットする キーアップ フラグを立て、トリガーされた繰り返しの動作を停止します。
キー名 オプションです。 もしも キー名 が指定されていないか、空の文字列です。 キーアップ なります
すべてのキーに設定します。 さもないと、 キーアップ によって指定されたキーにのみ設定されます
キー名.

オーディオ追加 [ [ [ ]]]
指定されたオーディオ ファイルを読み込みます。 見る サブ追加

オーディオ削除 [ ]
指定されたオーディオ トラックを削除します。 見る サブ削除

オーディオリロード [ ]
指定されたオーディオ トラックをリロードします。 見る サブリロード

外部ファイルの再スキャン [ ]
現在に従って外部ファイルを再スキャンします --サブオート および --オーディオファイル自動
設定。 これは、外部ファイルを自動ロードするために使用できます After ファイルがロードされました。

当学校区の モード 引数は次のいずれかです。

（デフォルト）
デフォルトのオーディオおよび字幕ストリームを選択します。これは通常、
最も優先度の高い外部ファイル。 (実装は完全ではありませんが、
リクエストに応じて改善される可能性があります。)


現在のトラック選択を変更しないでください。

入力 コマンド それ 　 ことによると 件名 〜へ 前日比
af セット|追加|トグル|デル|clr フィルター 1 = パラメータ、フィルター 2、...
オーディオ フィルター チェーンを変更します。 見る vf

vf セット|追加|トグル|デル|clr フィルター 1 = パラメータ、フィルター 2、...
ビデオ フィルター チェーンを変更します。

最初の引数は、何が起こるかを決定します:

セッションに 以前のフィルタ チェーンを新しいフィルタ チェーンで上書きします。

加えます 新しいフィルター チェーンを前のフィルター チェーンに追加します。

トグル 指定されたフィルター (正確なパラメーターを持つ) が既に
ビデオチェーン。 ある場合は、フィルターを取り外します。 いいえの場合は、フィルターを追加します。 (複数の場合
フィルタはコマンドに渡されます。これはフィルタごとに行われます。)

インクルード 指定されたフィルタをビデオ チェーンから削除します。 他の場合とは異なり、
XNUMX 番目のパラメーターは、フィルター名または整数のカンマ区切りのリストです。
インデックス。 0 は最初のフィルターを示します。 負のインデックスは
最後のフィルター、および -1 最後のフィルターを示します。

clr すべてのフィルタを削除します。 他のサブコマンドと同様に、これはそうではないことに注意してください。
自動的に挿入されたフィルターを制御します。

プレフィックスを付けることで、フィルターにラベルを割り当てることができます @名前： （どこで 名 　
ユーザーが選択した任意の識別子)。 ラベルを使用して、フィルタを名前で参照できます
すべてのフィルター チェーン変更コマンドで。 為に 加えます、すでに使用されている
label は既存のフィルターを置き換えます。

当学校区の vf コマンドは、OSD を変更した後、要求されたフィルターのリストを OSD に表示します。
フィルターチェーン。 これはおおよそ テキスト表示 ${vf}。 ご了承ください
フォーマット変換用に自動挿入されたフィルターはリストに表示されません。
ユーザーからリクエストされました。

通常、コマンドはビデオ チェーンが再作成されているかどうかを確認します。
成功し、失敗した場合は操作を元に戻します。 コマンドが前に実行された場合
ビデオが設定されている (ビデオを開いた直後にコマンドを実行した場合に発生する可能性があります)
ビデオ フレームがデコードされる前)、このチェックは実行できません。 それならできる
ビデオ チェーンの作成に失敗することがあります。

input.conf の例

· a vf セッションに フリップ でビデオを上下逆さまにします。 a キー

· b vf セッションに "" 上のすべてのビデオ フィルタを削除します b

· c vf トグル ラヴフィ=グラファン バンド除去をオンに切り替え c

サイクル値 ["！逆行する"] ...
値のリストを循環します。 コマンドを呼び出すたびに、指定された
プロパティをリストの次の値に変更します。 コマンドは内部カウンターを維持します
次に選択する値で、最初は 0 です。最後に選択すると 0 にリセットされます。
値に達します。

内部カウンターは、プロパティ名と値リストを使用して関連付けられます。 もしも
複数のコマンド (異なるキーにバインドされている) は、同じ名前と値のリストを使用します。
内部カウンターを共有します。

特別な議論 ！逆行する 値リストを逆に循環させるために使用できます。
値を逆にリストするだけのコマンドと比較すると、このコマンドは
実際には内部カウンターを順方向循環キーバインディングと共有します (限り
残りの引数は同じです)。

(この記事の執筆時点で) 10 個の引数の静的制限があることに注意してください (この制限
要求に応じて引き上げることができます)。

有効化セクション [フラグ]
名前付き入力セクションですべてのキー バインドを有効にします。

有効な入力セクションはスタックを形成します。 上部のセクションのバインディング
スタックは下のセクションよりも優先されます。 このコマンドは、セクションを
スタック。 セクションがすでにスタックにある場合は、暗黙的に削除されます
予め。 (セクションは、スタック上に複数回存在することはできません。)

当学校区の フラグ パラメータは組み合わせにすることができます（で区切られます +) 次のフラグの:


新しく有効化されたセクションより前に有効化されていたすべてのセクションが無効化されます。 彼ら
それらの上にあるすべての排他的セクションが削除されるとすぐに、再び有効になります。
つまり、新しいセクションは以前のすべてのセクションを覆い隠します。


この機能は、パブリック API では使用できません。


同じ。

無効化セクション
指定された入力セクションを無効にします。 元に戻す 有効化セクション.

定義セクション [デフォルト|強制]
名前付き入力セクションを作成するか、既存の入力の内容を置き換えます
セクション。 NS 中身 パラメータは、 入力.conf ファイル（除く
その中でセクション構文を使用することは許可されていません）、分離する必要性を含む
改行文字によるバインディング。

Status 中身 パラメータが空の文字列の場合、セクションは削除されます。

名前のあるセクション デフォルト 通常の入力セクションです。

一般に、入力セクションは 有効化セクション コマンド、または
それらは無視されます。

最後のパラメーターの意味は次のとおりです。

（また、 中古 if パラメーター 省略）
ユーザーがまだ使用していない場合にのみ、このセクションで定義されたキー バインドを使用します。
このキーをコマンドにバインドします。


常にキーをバインドします。 (最近アクティブになった入力セクション
あいまいさがある場合に勝ちます。)

オーバーレイ追加
生データをソースとする OSD オーバーレイを追加します。 これは、スクリプトや
mpv を制御し、ビデオの上に何かを表示したいアプリケーション
窓。

オーバーレイは通常、画面解像度で表示されますが、一部の VO では、
解像度はビデオの解像度に下げられます。 を読むことができます OSD幅 および
OSD 高さ プロパティ。 少なくとも --vo-xv およびアナモルフィック ビデオ (DVD など)、
OSD-パー 同様に読み取る必要があり、オーバーレイはアスペクト補正する必要があります。
(将来の方向性: たぶん mpv はこれらのことのいくつかを処理する必要があります
自動的に行われますが、線をどこに引くべきかわかりにくいです。)

id オーバーレイ要素を識別する 0 ～ 63 の整数です。 ID は
複数のオーバーレイ パーツを追加するために使用され、このコマンドを使用してパーツを更新します。
すでに存在するID、またはでパーツを削除する オーバーレイ削除. 以前の
未使用の ID は新しいオーバーレイを追加し、ID を再利用すると更新されます。 （未来
方向性：さまざまなプログラムがやりたいことを確実にするための何かがあるはずです
create overlays が互いに衝突することはありません (必要になった場合)。

x および y OSD を表示する位置を指定します。

file 生の画像データが読み込まれるファイルを指定します。 数値のいずれかです
で始まる UNIX ファイル記述子 @ （例えば @4)、またはファイル名。 ファイルは
でメモリにマップ mmap（）. 一部の VO は、マップされたポインタを直接
API (opengl や vdpau など) を表示するため、実際のコピーは必要ありません。 切り捨て
オーバーレイがアクティブなときにソース ファイルを使用すると、プレーヤーがクラッシュします。 あなたはすべきではありません
オーバーレイがアクティブな間にデータを変更します。
ランダムポイントでアクセス。 代わりに、 オーバーレイ追加 もう一度（できれば
ティアリングを防ぐための別のメモリ領域)。

ビットマップ メモリとして使用する生メモリ アドレスを渡すこともできます。
で始まる整数としてメモリーアドレスを渡します。 & キャラクター。 渡す
ここで間違っていると、プレーヤーがクラッシュします。 このモードは、
libmpv. の オフセット パラメータは単にメモリアドレスに追加されます (mpv
0.8.0、以前は無視されていました)。

オフセット ソース ファイルの最初のピクセルのバイト オフセットです。 （現在
実装では常に、位置 0 から末尾までのファイル全体を mmap します。
そのため、大きなオフセットは避ける必要があります。 mpv 0.8.0 より前では、オフセットは
実際に直接渡された mmap、より使いやすくするために変更されました。)

FMT 画像フォーマットを識別する文字列です。 現在、 ビーグラ が定義されています。 これ
形式は、4 ピクセルあたり 8 バイト、8 コンポーネントあたり XNUMX ビットです。 最下位 XNUMX
ビットは青色で、最上位の 8 ビットはアルファ (リトル エンディアンでは、
コンポーネントは BGRA で、最初のバイトは B です)。 これは事前に乗算されたアルファを使用します:
色成分はすでにアルファ成分で乗算されています。 これは、
各成分の数値はアルファ成分以下です。
(この規則に違反すると、VO が異なると結果が異なります: 数値
壊れたアルファ値のブレンドによるオーバーフローは、
その結果、実装はあなたが得ることを保証しません
この場合、予測可能な動作です。)

w, h, ストライド オーバーレイのサイズを指定します。 w の可視幅です
オーバーレイ、その間 ストライド メモリ内の幅をバイト単位で指定します。 単純な場合と、
ビーグラ フォーマット、 ストライド==4*w. 一般に、アクセスされたメモリの総量
is ストライド * h. (技術的には、最小サイズは ストライド * (h - 1) + w * 4,
ただし、簡単にするために、プレーヤーはすべてにアクセスします ストライド * h バイト。）

警告

オーバーレイを更新するときは、XNUMX つ目の共有メモリを用意する必要があります
領域 (例: オフセット パラメータを使用) をオーバーレイとして追加します。
毎回同じメモリを再利用する代わりに。 そうしないと、取得する可能性があります
アプリケーションと mpv が
同時にバッファします。 また、mpv がアクセスする可能性があることに注意してください。
そうする必要があると感じたときはいつでも、オーバーレイのメモリをランダムに。
画面を再描画する場合の例。

オーバーレイ削除
追加されたオーバーレイを削除する オーバーレイ追加 と同じID。 いいえの場合は何もしません
この ID のオーバーレイが存在します。

スクリプト メッセージ ...
すべてのクライアントにメッセージを送信し、次の引数リストを渡します。 何
このメッセージは、それが取る引数の数、および引数の意味を意味します
完全に受信者と送信者次第です。 すべてのクライアントはメッセージを受け取ります。
名前の衝突に注意してください（または script_message_to).

スクリプトメッセージ先 ...
と同じ スクリプトメッセージ、ただし、指定されたクライアントにのみ送信します . 各クライアント
(スクリプトなど) には固有の名前があります。 たとえば、Lua スクリプトは次の方法で名前を取得できます。
mp.get_script_name().

スクリプトバインディング
スクリプトが提供するキー バインドを呼び出します。 これは、キーバインディングを再マップするために使用できます
外部の Lua スクリプトによって提供されます。

引数はバインディングの名前です。

必要に応じて、スクリプトの名前を前に付けることができます。 / 区切りとして、
マシン情報の記入> という構文でなければなりません。例えば、 スクリプトバインディング スクリプト名/バインディング名.

完全を期すために、このコマンドが内部でどのように機能するかを次に示します。 詳細は
いつでも変更できます。 一致するキー イベントでは、 script_message_to or スクリプトメッセージ is
呼び出されます (スクリプト名が含まれているかどうかによって異なります)。ここで、最初の引数は
文字列です キーバインディング、XNUMX 番目の引数はバインディングの名前です。
XNUMX 番目の引数は、文字列としてのキーの状態です。 キー状態は、いくつかの
文字。 最初の文字は d (キーが押された)、 u （解放された）、 r
(キーはまだ押されていて、繰り返されました。これに対してキーの繰り返しが有効になっている場合のみ)
バインディング)、 p (キーが押されました。アップ/ダウンを追跡できない場合に発生します)。 二番目
文字 イベントがマウスから発生したかどうか m (マウスボタン) または -
（他の何か）。

アブループ
AB ループ状態を循環します。 最初のコマンドは、 A ポイント（
腹筋-a 財産）; 二番目の B ポイント、XNUMX番目は両方のポイントをクリアします。

vo-コマンドライン
現在の VO のサブオプションをリセットします。 現在、 OpenGLの （含む
opengl 本社）。 引数は、通常、VO に渡されるサブオプション文字列です。
コマンドライン。 すべてのサブオプションを設定できるわけではありませんが、リセットできるもの
それらが引数に表示されなくても。 このコマンドは変更されるか、
将来的に削除されます。

ドロップバッファ
オーディオ/ビデオ/デマルチプレクサー バッファーをドロップし、最初からやり直します。 役立つかもしれません
同期が外れているシークできないストリーム。 このコマンドは変更されるか、
将来的に削除されます。

スクリーンショット-生 [字幕|ビデオ|ウィンドウ]
メモリ内のスクリーンショットを返します。 これは、クライアント API を介してのみ使用できます。 の
このコマンドによって返される MPV_FORMAT_NODE_MAP には、 w, h, ストライド に設定されたフィールド
明らかな内容。 あ 形式でアーカイブしたプロジェクトを保存します． フィールドは bgr0 デフォルトで。 このフォーマットは
として編成 B8G8R8X8 （どこで B は LSB です)。 パディングの中身 X is
未定義。 の データ フィールドは、実際のイメージを含むタイプ MPV_FORMAT_BYTE_ARRAY です
データ。 結果ノードが解放されるとすぐにイメージが解放されます。

文書化されていないコマンド: テレビの最後のチャンネル (TV/DVB のみ)、 ao-リロード (実験的/内部)。

フック
フックは、プレーヤー コアとスクリプトなどの間の同期イベントです。 これはに適用されます
クライアント API (Lua スクリプト インターフェイスを含む)。 通常、イベントは
非同期であり、フック API は、イベントを処理するためのぎこちなくあいまいな方法を提供します。
より厳密な調整が必要です。 API の安定性は保証されません。 フォローしていません
プロトコルは正確にプレーヤーをランダムにフリーズさせる可能性があります。 基本的に誰も使わない
この API。

関連する XNUMX つの特別なコマンドがあります。 また、クライアントはクライアント メッセージをリッスンする必要があります。
(MPV_EVENT_CLIENT_MESSAGE C API で)。

フック追加
最初の引数で識別されるフックにサブスクライブします (基本的に、
イベント）。 の id 引数は、ユーザーが選択した任意の整数です。 優先順位 is
すべてのフック ハンドラーをすべてのクライアントでグローバルに並べ替えるために使用されます。 各クライアントは
複数のフック ハンドラーを登録します (同じフック名であっても)。 フックが
登録されているため、登録を解除することはできません。

特定のイベントが発生すると、登録されているすべてのハンドラーが順次実行されます。 これは
すべてのクライアントが明示的に従わなければならないプロトコル。 フック ハンドラーが実行されると、
クライアントメッセージ (MPV_EVENT_CLIENT_MESSAGE) は、登録したクライアントに送信されます
フック。 このメッセージには次の引数があります。

1.文字列 フックラン

2。 その id フックが文字列として登録された引数 (これは、
同じクライアントによって登録された複数のフックを正しく処理します。 id
引数はクライアント内で一意です)

3. フックの実行を追跡するためにフック機構によって使用される未定義のもの
(現在はフック名ですが、これは予告なく変更される可能性があります)

このメッセージを受信すると、クライアントはイベントを処理できます。 これを行っている間、
プレーヤー コアは引き続きリクエストに反応しますが、再生は通常停止します。

クライアントが完了すると、次のコマンドを実行してコアのフック実行を続行する必要があります。
フックアック

フックアック
フックのグローバル チェーンで次のフックを実行します。 引数は の 3 番目の引数です。
現在のクライアントのフック実行を開始するクライアント メッセージ。

現在、次のフックが定義されています。

オンロード
ファイルが開かれるとき、実際に何かが行われる前に呼び出されます。 例えば、
あなたは読み書きすることができます ストリームオープンファイル名 URL をリダイレクトするプロパティ
何か他のもの (ユーザーにめったに提供しないストリーミング サイトのサポートを検討してください)
ダイレクト メディア URL)、またはプロパティを設定してファイルごとのオプションを設定できます。
ファイルローカルオプション/ 名前>. プレーヤーは、すべてのフックが実行されるまで待機します。

on_unload
ファイルを閉じる前、および実際にすべてを初期化解除する前に実行します。 そうではありません
この状態で再生を再開することができます。

入力 Command 接頭辞
これらのプレフィックスは、キー名と実際のコマンドの間に配置されます。 複数のプレフィックスを使用できます
指定されます。 それらは空白で区切られています。

osd 自動 （デフォルト）
このコマンドのデフォルトの動作を使用します。

OSDなし このコマンドには OSD を使用しないでください。

OSDバー
可能であれば、このコマンドでバーを表示します。 Seek コマンドで進行状況が表示されます
バー、プロパティ変更コマンドは、新しく設定された値を表示する場合があります。

osd メッセージ
可能であれば、このコマンドで OSD メッセージを表示します。 Seek コマンドで現在の
再生時間、プロパティ変更コマンドは、新しく設定された値をテキストとして表示します。

osd-msg-バー
osd-bar と osd-msg を組み合わせます。

生 文字列引数でプロパティを展開しないでください。 （お気に入り 「${プロパティ名}」.)

拡張プロパティ （デフォルト）
で説明されているように、すべての文字列引数が展開されます。 プロパティ 拡張.

繰り返し可能
一部のコマンドでは、キーを押し続けてもコマンドが繰り返し実行されません。 これ
プレフィックスは、どのような場合でもキーの繰り返しを強制的に有効にします。

すべての osd プレフィックスは、引き続きグローバルによってオーバーライドされます。 --osd レベル 設定を行います。

入力 セクション
入力セクションはバインディングのセットをグループ化し、それらを一度に有効または無効にします。 の
入力.conf、各キーバインディングは、実際に持っているのではなく、入力セクションに割り当てられています
明示的なテキスト セクション。

また見てください 有効化セクション および 無効化セクション コマンド。

定義済みバインディング:

デフォルト
入力セクションのないバインディングは、暗黙的にこのセクションに割り当てられます。 それは
通常の再生中はデフォルトで有効になっています。

エンコード エンコード モードでアクティブなセクション。 排他的に有効になっているため、
のバインディング デフォルト セクションは無視されます。

プロパティ
プロパティは、実行時に mpv オプションを設定したり、任意の情報を照会したりするために使用されます。
それらはで操作できます セッションに/加えます/サイクル コマンド、およびで取得 テキスト表示または
プロパティ拡張を使用するその他のもの。 （見る プロパティ 拡張.)

プロパティ名には RW の注釈が付けられており、プロパティが一般的かどうかを示しています。
書き込み可能。

オプションが参照されている場合、プロパティは通常、まったく同じ値を取得/返します。
オプションとして。 このような場合、プロパティは実行時にオプションを変更する手段にすぎません。

プロパティ リスト
OSDレベル (RW)
詳細はこちら： --osd レベル.

OSDスケール (RW)
OSD フォント サイズ乗数については、を参照してください。 --osd-スケール.

ループ (RW)
詳細はこちら： - ループ.

ループファイル (RW)
詳細はこちら： --ループファイル （使用 はい/いいえ).

スピード (RW)
詳細はこちら： - 速度.

音声速度補正、 ビデオ速度補正
倍率 スピード プレーヤーがファイルを再生しようとする時点。 いつもの
正確に 1 です (表示同期モードが便利です)。

OSD フォーマットでは、次の形式で表示されます。 + 1.23456％、番号は （生
- 1) * 100 指定された生のプロパティ値に対して。

ディスプレイ同期アクティブ
返すかどうか --video-sync=ディスプレイ 実際に活動しています。

ファイル名
現在再生中のファイルで、パスが削除されています。 これが URL の場合は、パーセントを取り消してみてください
エンコードも。 (結果は必ずしも正しいとは限りませんが、
表示目的。 使用 path 変更されていないファイル名を取得するプロパティ)。

ファイルサイズ
ソース ファイル/ストリームの長さ (バイト単位)。 (これは ${ストリーム終了}。 のために
チャプターの順序など、現在再生されているセグメントのサイズが返されます。)

推定フレーム数
現在のファイルの合計フレーム数。

注:
これはあくまでも目安です。 (信頼できない XNUMX つの量から計算されます: fps と
ストリームの長さ)

推定フレーム数
現在のストリームの現在のフレームの数。

注:
これはあくまでも目安です。 (信頼できない XNUMX つの量から計算されます: fps と
丸められたタイムスタンプの可能性があります。)

path 現在再生中のファイルのフル パス。 通常、これはまったく同じ文字列です。
mpv コマンドラインまたは ロードファイル たとえそれが相対パスであっても。
絶対パスが必要な場合は、自分で決定する必要があります。たとえば、
使用して、 作業ディレクトリ プロパティ。

メディアタイトル
現在再生中のファイルに タイトル タグ、それを使用してください。

それ以外の場合、メディア タイプが DVD の場合は、DVD のボリューム ID を返します。

それ以外の場合は、 ファイル名 プロパティ。

ファイル形式
ファイル形式の記号名。 場合によっては、これはカンマ区切りのリストです。
フォーマット名、例えば mp4 は mov,mp4,m4a,3gp,3g2,mj2 （リストは将来的に増える可能性があります
任意の形式)。

デマルチプレクサ
現在のデマルチプレクサの名前。 (これは駄目です。)

ストリームパス
ストリーム レイヤー ファイル名のファイル名 (フル パス)。 (これは多分駄目です。
これはとは異なる場合があるようです path 順序付けられたチャプターなどを使用する場合のみ)。

ストリーム ポス (RW)
ソース ストリーム内の raw バイト位置。

ストリームエンド
ソース ストリーム内の生の終了位置 (バイト単位)。

デュレーション
現在のファイルの継続時間 (秒単位)。 期間が不明な場合、プロパティ
利用できません。 ファイルの長さは常に正確にわかっているわけではないことに注意してください。
見積もり。

これは、 長さ これは mpv 0.9 リリース後に廃止されました。
(セマンティクスは同じです。)

avsync 最後の A/V 同期の違い。 オーディオまたはビデオが無効になっている場合は使用できません。

総 avsync 変更
総 AV 同期修正が完了しました。 オーディオまたはビデオが無効になっている場合は使用できません。

ドロップフレームカウント
ビデオがオーディオよりもはるかに遅れているため、デコーダーによってビデオ フレームがドロップされました (
--framedrop=デコーダー）。 場合によっては、これは他の状況で増加することがあります。
ビデオ パケットが破損した場合、またはデコーダが通常のルールに従わない場合。
ビデオが無効になっている場合は使用できません。

vo-drop-frame-count
VO によってドロップされたフレーム (使用時) --framedrop=vo).

ミスタイム フレーム カウント
の表示同期モードでタイミングが正しくなかったビデオ フレームの数
A/V 同期を維持するため。 これには、次のような外部環境は含まれません。
ビデオのレンダリングが遅すぎるか、グラフィックス ドライバーが何らかの形で vsync をスキップしています。 それ
丸め誤差も含まれません (特に悪い
ソースのタイムスタンプ)。 たとえば、 ディスプレイ非同期 モードは決して変更しないでください
この値は 0 から。

垂直同期比
フレームが平均して表示される vsync の数。 これは次の場合に利用できます
display-sync はアクティブのみです。 30 Hz 画面上の 60 FPS ビデオの場合、これは 2 になります。
これは実際にスケジュールされたものの移動平均であるため、24 Hz で 60 FPS
正確に 2.5 のままになることはありませんが、表示される最後のフレームに応じてジッターします。

vo-遅延フレーム数
表示同期での外部環境による遅延の推定フレーム数
モード。 一般に、mpv はこれが起こっていることを推測しなければならないことに注意してください。
不正確になる可能性があります。

パーセント位置 (RW)
現在のファイル内の位置 (0-100)。 代わりにこれを使用する利点
他のプロパティから計算することは、適切に推定にフォールバックすることです
ファイルの長さが不明な場合は、バイト位置からの再生位置。

時間位置 (RW)
現在のファイル内の位置 (秒単位)。

時間開始
非推奨。 常に 0 を返します。mpv 0.14 より前では、これは開始時刻を返すために使用されていました。
ファイルの (トランスポート ストリームなどに影響する可能性があります)。 見る --リベース開始時間 オプションを選択します。

残り時間
ファイルの残りの長さ (秒単位)。 ファイルの継続時間は必ずしも一定ではないことに注意してください。
正確にわかっているので、これは推定値です。

残りプレイ時間
残り時間 電流でスケーリング スピード.

再生時間 (RW)
現在のファイル内の位置 (秒単位)。 ようではない 時間位置、時間はにクランプされます
ファイルの範囲。 (不正確なファイル期間などにより、範囲外になる可能性があります。
シーク ターゲットとして、ユーザーがファイルの外側をシークしようとするときにも役立ちます。
time は、シーク中の現在の位置と見なされます。)

章 (RW)
現在のチャプター番号。 最初の章の番号は 0 です。

エディション (RW)
現在の MKV のエディション番号。 このプロパティを別の値に設定すると再起動します
再生。 初版の枚数は0枚です。

ディスクタイトル
BD/DVDのタイトル数。

これにはいくつかのサブプロパティがあります。 交換 N 0 ベースのエディション インデックスを使用します。

ディスクタイトル/カウント
タイトル数。

ディスクタイトル/id
整数としてのタイトル ID。 現在、これはタイトル インデックスと同じです。

ディスクタイトル/長さ
秒単位の長さ。 多くの場合、利用できない可能性があります (現在は
libdvdnav のみで動作します)。

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (エディションごと)
「id」MPV_FORMAT_INT64
"長さ" MPV_FORMAT_DOUBLE

ディスクタイトルリスト
BD/DVDタイトル一覧です。

ディスクタイトル (RW)
現在の BD/DVD タイトル番号。 書き込みは次の場合にのみ機能します dvdnav：// および bd:// （と
これらのエイリアス)。

章
章の数。

エディション
MKV のエディション数。

エディションリスト
エディションのリスト、現在のエントリがマークされています。 現在、生のプロパティ値は
役に立たない。

これにはいくつかのサブプロパティがあります。 交換 N 0 ベースのエディション インデックスを使用します。

エディションリスト/カウント
版数。 エディションがない場合、これは 0 または 1 になります (エディションがない場合は 1)。
役に立たないダミー版があります）。

エディションリスト/N/id
整数としてのエディション ID。 これを使用して、 エディション 財産。 現在、
これは、エディション インデックスと同じです。

エディションリスト/N/default
はい これがデフォルトのエディションの場合、 いいえ さもないと。

エディションリスト/N/タイトル
ファイルに保存されている版のタイトル。 常に利用できるわけではありません。

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (エディションごと)
「id」MPV_FORMAT_INT64
「タイトル」MPV_FORMAT_STRING
「デフォルト」MPV_FORMAT_FLAG

アブループ、 ab ループ b (RW)
AB ループポイントを設定/取得します。 対応するオプションと ab_loop コマンド。 の
特別な価値 いいえ これらのプロパティのいずれかでループを無効にします。

角度 (RW)
現在の DVD アングル。


メタデータのキーと値のペア。

プロパティが Lua でアクセスされた場合 mp.get_property_native、これはテーブルを返します
メタデータ キーがメタデータ値にマッピングされます。 クライアントでアクセスする場合
API、これは MPV_FORMAT_NODE_MAP、タグキーがタグ値にマッピングされています。

OSD の場合、フォーマットされたリストを返します。 このプロパティを raw として取得しようとしています
文字列は機能しません。

これにはいくつかのサブプロパティがあります。

メタデータ/キーごと/
メタデータ エントリの値 .

メタデータ/リスト/カウント
メタデータ エントリの数。

メタデータ/リスト/N/キー
N 番目のメタデータ エントリのキー名。 （最初のエントリーは 0).

メタデータ/リスト/N/値
N 番目のメタデータ エントリの値。

メタデータ/
古いバージョンの メタデータ/キーごと/. 使用は推奨されません。
メタデータ キー文字列は、他のサブプロパティと競合する可能性があります。

このプロパティのレイアウトは変更される可能性があります。 提案は大歓迎です
まさにこのプロパティが機能するはずです。

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_MAP
(各メタデータ エントリのキーと文字列値)

フィルタリングされたメタデータ
いいね 、ただし、にリストされているフィールドのみが含まれます --表示タグ オプション。 この
端末に出力されるのと同じタグのセットです。

章メタデータ
現在の章のメタデータ。 に似た作品 財産。 また、
同じアクセス方法 (サブプロパティを使用)。

章ごとのメタデータは非常にまれです。 通常、チャプター名のみ (タイトル）が設定されます。

章の開始など、その他の情報へのアクセスについては、 チャプターリスト プロパティ。

vf-メタデータ/
ビデオ フィルタによって追加されたメタデータ。 フィルター ラベルによってアクセスされます。
を使用して明示的に指定 @フィルターラベル: 構文は、 NN.

に似た作品 財産。 同じアクセス方法を許可します (
サブプロパティ)。

この種のメタデータの例は、によって追加されたトリミング パラメータです。
--vf=lavfi=cropdetect.

af-メタデータ/
に相当 vf-メタデータ/、ただしオーディオ フィルタ用です。

一時停止 (RW)
休止状態。 これは通常 はい or いいえ。 見る - 一時停止.

アイドル 返品 はい ファイルがロードされていない場合、プレーヤーは
-アイドル オプションを選択します。

コアアイドル
返品 はい 再生コアが一時停止している場合、そうでない場合 いいえ. これは異なる場合があります
一時停止 プレーヤーが低いために一時停止するなどの特別な状況で
ネットワークキャッシュ。

これも戻ります はい 再生が再開している場合、または何も再生されていない場合。 の
言い換えれば、それだけです いいえ 実際にビデオが再生されている場合。 (mpv以降の動作
0.7.0。）

キャッシュ ネットワーク キャッシュの塗りつぶし状態 (0 ～ 100.0)。

キャッシュサイズ (RW)
KB 単位のネットワーク キャッシュ サイズ。 これは似ています - キャッシュ. これにより、キャッシュを設定できます
実行時のサイズ。 現在、キャッシュを有効または無効にすることはできません。
既存のキャッシュのサイズを変更するためだけに、このプロパティを使用するランタイム。

これにはバックバッファのサイズは含まれません (mpv 0.10.0 以降に変更)。

これにより、キャッシュの内容を可能な限り保持しようとすることに注意してください。 これを作るには
簡単に言えば、キャッシュのサイズ変更コードが新しいキャッシュを割り当て、古いキャッシュが割り当てられます。
まだ割り当てられています。

DVD や Blu-ray の再生時には使用しないでください。

キャッシュフリー （R）
空きキャッシュの合計サイズ (KB)。

キャッシュ使用 （R）
使用済みキャッシュの合計サイズ (KB)。

キャッシュアイドル （R）
返品 はい キャッシュがアイドル状態の場合は、キャッシュがいっぱいになっていることを意味します
現在、それ以上のデータを読み取っていません。

デマルチプレクサーキャッシュ期間
デマルチプレクサにバッファリングされたビデオのおおよその時間 (秒単位)。 推測は
非常に信頼性が低く、多くの場合、データがあったとしても、プロパティはまったく利用できません。
バッファリングされます。

デマルチプレクサキャッシュ時間
デマルチプレクサーでバッファリングされたビデオのおおよその時間 (秒単位)。 と同じ
デマルチプレクサーキャッシュ期間 ただし、デマルチプレクサでバッファリングされたデータの最後のタイムスタンプを返します。

デマルチプレクサキャッシュアイドル
返品 はい デマルチプレクサーがアイドル状態の場合、つまり、デマルチプレクサーのキャッシュがいっぱいになっていることを意味します。
要求された量であり、現在それ以上のデータを読み取っていません。

キャッシュのために一時停止
返品 はい キャッシュを待っているために再生が一時停止されたとき。

キャッシュバッファリング状態
プレイヤーがキャッシュを使用するまでのキャッシュ フィル ステータスのパーセンテージ (0-100) を返します。
一時停止解除 (関連 キャッシュのために一時停止).

到達した
返品 はい 再生の終わりに達した場合、 いいえ そうでなければ。 これは通常
場合にのみ興味深い -開いたままにする そうしないとプレーヤーが
すぐに次のファイルを再生します (または、アイドル モードを終了または開始します)。
到達した プロパティは、設定後すぐに論理的にクリアされます。

を求める
返品 はい プレーヤーが現在シーク中、または再起動しようとしている場合
再生。 (元に戻る可能性はあります はい ファイルのロード中、または
順序付けられたチャプター セグメントの切り替え。 これは、基になるコードが同じであるためです。
シークと再同期に使用されます。)

時間シーク (RW)
詳細はこちら： --hr-シーク.

ボリューム (RW)
現在のボリューム (参照 - 音量 詳細については）。

移動 (RW)
現在のミュート状態 (はい/いいえ).

音声遅延 (RW)
詳細はこちら： --オーディオ遅延.

オーディオコーデック
デコード用に選択されたオーディオ コーデック。

オーディオコーデック名
オーディオコーデック。

オーディオ パラメータ
オーディオ デコーダーによる出力としてのオーディオ形式。 これにはいくつかのサブプロパティがあります。

オーディオ パラメータ/フォーマット
文字列としてのサンプル形式。 これは、他のものと同じ名前を使用します。
mpvの場所。

audio-params/サンプルレート
サンプルレート。

オーディオ パラメータ/チャネル
文字列としてのチャネル レイアウト。 これは、 -オーディオチャネル
受け入れます。

オーディオパラメータ/時間チャネル
As チャンネル、しかし、おそらく不可解な実際のレイアウトがに送信される代わりに
オーディオ デバイス、できればより人間が読める形式を返します。 (通常のみ
audio-out-params/hr-channel 理にかなっています。）

audio-params/チャンネル数
音声チャネルの数。 これは、 チャンネル 説明されたフィールド
上記。

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_MAP
「フォーマット」MPV_FORMAT_STRING
「サンプルレート」MPV_FORMAT_INT64
「チャンネル」MPV_FORMAT_STRING
「チャンネル数」MPV_FORMAT_INT64
"hr-channels" MPV_FORMAT_STRING

オーディオ出力パラメータ
と同じ オーディオ パラメータですが、オーディオ API に書き込まれるデータの形式です。

援助 (RW)
現在のオーディオ トラック ( - 援助).

オーディオ (RW)
のエイリアス 援助.

(RW)
オーディオ チャンネルのバランス。 (この機能の実装はかなり奇妙です。
各チャンネルのボリュームは変更しませんが、代わりにパンマトリックスを設定してミックスします
左右のチャンネルです。)

フルスクリーン (RW)
詳細はこちら： - 全画面表示.

インターレース解除 (RW)
詳細はこちら： -インターレース解除.

フィールド支配 (RW)
詳細はこちら： -- フィールド優勢

カラーマトリックス （R）
にリダイレクトします ビデオパラメータ/カラーマトリックス. このパラメーター (および同様のパラメーター) は、
で上書きされます 形式でアーカイブしたプロジェクトを保存します． ビデオフィルター。

カラーマトリックス入力範囲 （R）
詳細はこちら： カラーマトリックス.

ビデオ出力レベル (RW)
詳細はこちら： --ビデオ出力レベル,

colormatrix-原色 （R）
詳細はこちら： カラーマトリックス.

上に (RW)
詳細はこちら： --上に.

国境 (RW)
詳細はこちら： - 国境.

すべてのワークスペース (RW)
詳細はこちら： --すべてのワークスペース上. 設定解除はすべての WM で機能するとは限りません。

フレームドロップ (RW)
詳細はこちら： --フレームドロップ.

ガンマ (RW)
詳細はこちら： - ガンマ.

明るさ (RW)
詳細はこちら： - 輝度.

コントラスト (RW)
詳細はこちら： - 対比.

飽和 (RW)
詳細はこちら： - 飽和.

色相 (RW)
詳細はこちら： -色相.

hwdec (RW)
反映します --hwdec オプションを選択します。

可能であれば、それに書き込むと、現在使用されているハードウェア デコーダが変更される場合があります。
(内部的に、プレーヤーはデコーダーを再初期化する場合があり、シークを実行します。
ビデオを適切に更新してください。) 他の hwdec プロパティを見て確認できます。
これが成功したかどうか。

mpv 0.9.x 以前とは異なり、これは現在アクティブなハードウェアを返しません。
デコーダ。

hwdec アクティブ
返品 はい or いいえ、実際に何らかのタイプのハードウェアデコードが行われているかどうかに応じて
使用しています。

hwdec 検出
ソフトウェア デコードがアクティブな場合、これは使用中のハードウェア デコーダを返します。
それ以外の場合は、次のいずれかを返します いいえ、または該当する場合は、現在ロードされているハードウェア
デコード API。 これは、VO が開かれたときにのみ認識されます (場合によっては後で)。 と
いくつかのVO（のような OpenGLの)、これは事前にはわかりませんが、デコーダが
ハードウェア デコーダの作成に成功しました。 また、ハードウェアデコーダ -コピー
接尾辞が返されます いいえ ビデオがデコードされていない間。 これはすべて、どのように反映されますか
検出 hw デコーダーが検出され、mpv で内部的に使用されます。

パンスキャン (RW)
詳細はこちら： --パンスキャン.

ビデオフォーマット
文字列としてのビデオ形式。

ビデオコーデック
デコード用に選択されたビデオ コーデック。

幅、 高さ
ビデオサイズ。 これは、デコードされたビデオのサイズを使用します。または、ビデオ フレームがない場合は、
まだデコードされていませんが、(おそらく正しくない) コンテナーはサイズを示していました。

ビデオパラメータ
デコーダーによる出力としてのビデオパラメーター (アスペクトなどのオーバーライド付き)
適用）。 これにはいくつかのサブプロパティがあります。

ビデオパラメータ/ピクセルフォーマット
文字列としてのピクセル形式。 これは、他の場所で使用されているものと同じ名前を使用しています
mpvの。

ビデオパラメータ/平均bpp
ピクセルあたりの平均ビット数 (整数)。 サブサンプリングされた平面フォーマットは異なるものを使用します
これが、この値が奇数または奇数になることがある理由です。
紛らわしい。 一部のフォーマットでは使用できない場合があります。

ビデオパラメータ/プレーン深度
各色成分のビット深度 (整数)。 これは、
平面または単一コンポーネント形式であり、他の形式では使用できません。

ビデオパラメータ/w、 ビデオパラメータ/時間
アスペクト補正が適用されていない、整数としてのビデオ サイズ。

ビデオパラメータ/dw、 ビデオパラメータ/dh
正しい縦横比にスケーリングされた整数としてのビデオ サイズ。

video-params/アスペクト
縦横比を float で表示します。

ビデオパラメータ/パー
ピクセルの縦横比。

ビデオパラメータ/カラーマトリックス
文字列として使用されているカラーマトリックス。 (正確な値は変更される可能性があります。)

ビデオパラメータ/カラーレベル
文字列としてのカラーレベル。 (正確な値は変更される可能性があります。)

ビデオパラメータ/プライマリ
文字列として使用されているプラ​​イマリ。 (正確な値は変更される可能性があります。)

video-params/ガンマ
文字列として使用されているガンマ関数。 (正確な値は変更される可能性があります。)

ビデオパラメータ/クロマロケーション
文字列としての彩度の位置。 (正確な値は変更される可能性があります。)

ビデオパラメータ/回転
意図したディスプレイの回転角度 (時計回り)。

ビデオパラメータ/ステレオ入力
ソース ファイルのステレオ 3D モード。 （見る --ビデオステレオモード オプション。）

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_MAP
「ピクセルフォーマット」MPV_FORMAT_STRING
"w" MPV_FORMAT_INT64
"h" MPV_FORMAT_INT64
"dw" MPV_FORMAT_INT64
"dh" MPV_FORMAT_INT64
"アスペクト" MPV_FORMAT_DOUBLE
"par" MPV_FORMAT_DOUBLE
「カラーマトリックス」MPV_FORMAT_STRING
「カラーレベル」MPV_FORMAT_STRING
"プライマリ" MPV_FORMAT_STRING
「クロマロケーション」MPV_FORMAT_STRING
「回転」MPV_FORMAT_INT64
「ステレオイン」 MPV_FORMAT_STRING

横幅、 高さ
動画の表示サイズ。 これは、フィルターとアスペクト スケーリングが適用された後のビデオ サイズです。
適用されました。 実際のビデオ ウィンドウ サイズは、これとは異なる場合があります。
ユーザーが手動でビデオ ウィンドウのサイズを変更した場合。

これらは次の値と同じです。 ビデオ出力パラメータ/dw および ビデオ出力パラメータ/DH.

ビデオ出力パラメータ
と同じ ビデオパラメータ、ただしビデオ フィルタが適用された後。 ない場合
使用中のビデオ フィルタ。これには次の値と同じ値が含まれます。 ビデオパラメータ。 ご了承ください
ユーザーが変更できるため、これは必ずしもビデオ ウィンドウが使用するものではありません。
ウィンドウ サイズ、およびすべての実際の VO は、ウィンドウ サイズから独立して独自のスケーリングを行います。
フィルターチェーン。

と同じサブプロパティを持つ ビデオパラメータ.

ビデオフレーム情報
現在のフレームのおおよその情報。 これらのいずれかが使用されている場合は、
OSD、OSD の再描画とフレームにより、情報が数フレームずれている可能性があります
ディスプレイが多少切断されているため、一時停止して強制的に再起動する必要がある場合があります
再描画します。

サブプロパティ:

ビデオフレーム情報/画像タイプ ビデオフレーム情報/インターレース ビデオ フレーム情報/tff
ビデオ フレーム情報/繰り返し

FPS コンテナFPS。 これには、偽の値が簡単に含まれる可能性があります。 モダンを使用した動画の場合
コンテナ フォーマットまたはビデオ コーデックの場合、これは多くの場合正しくありません。

推定 vf fps
ビデオ フィルター チェーン出力の推定/測定 FPS。 (フィルターを使用しない場合、
これはデコーダ出力に対応します。) これは過去 10 フレームの平均を使用します。
FPS を計算する期間。 フレームドロップが含まれていると不正確になります
(framedrop が明示的に有効になっている場合、または正確なシークの後など)。 ファイル
不正確なタイムスタンプ (Matroska など) を使用すると、結果が不安定になる可能性があります。

ウィンドウスケール (RW)
ウィンドウ サイズ乗数。 これを設定すると、ビデオウィンドウのサイズが値に変更されます
に含まれた 横幅 および 高さ このプロパティで設定された値で乗算されます。
設定 1 元のビデオ サイズ (正確には、ビデオのサイズ) にサイズ変更されます。
出力をフィルタします)。 2 ダブルサイズを設定し、 0.5 サイズを半分にします。

ウィンドウ最小化
ビデオ ウィンドウが最小化されているかどうかを返します。

表示名
mpv ウィンドウがカバーするディスプレイの名前。 X11 では、これらは xrandr
名前 (LVDS1、HDMI1、DP1、VGA1 など)。

ディスプレイ fps (RW)
現在のディスプレイのリフレッシュ レート。 現在、これはどのフレームよりも低い FPS です。
基礎となるシステム API (例:
X11 の xrandr)。 測定された FPS ではありません。 必ずしもすべてで利用できるわけではありません
プラットフォーム。 リストされている事実は、予告なしにいつでも変更される可能性があることに注意してください。

推定表示 fps
ディスプレイ同期モードの場合にのみ使用可能 ( --ビデオ同期） アクティブです。
によって測定された、表示のリフレッシュが発生したと思われる実際の速度を返します。
システム時刻。

vsync-ジッター
vsync 期間の推定偏差係数。

ビデオアスペクト (RW)
ビデオの側面については、を参照してください -ビデオアスペクト.

OSD幅、 OSD 高さ
最後に認識された OSD 幅 (0 の場合もあります)。 を使用する場合は、これが必要です。 overlay_add
指図。 実際の OSD サイズが表示されますが、ウィンドウとは異なる場合があります。
場合によってはサイズ。

OSD-パー
最後の既知の OSD ディスプレイ ピクセル アスペクト (0 の場合もある)。

VID (RW)
現在のビデオ トラック ( --vid).

ビデオ (RW)
のエイリアス VID.

ビデオ-アライン-x, ビデオアライン-y (RW)
詳細はこちら： --video-align-x および --video-align-y.

ビデオ・パン・エックス、 ビデオパンy (RW)
詳細はこちら： --video-pan-x および --video-pan-y.

ビデオズーム (RW)
詳細はこちら： --ビデオズーム.

スケーリングされていないビデオ （W）
詳細はこちら： -ビデオ-スケールなし.

プログラム （W）
TS プログラムを切り替えます (書き込み専用)。

sidの (RW)
現在の字幕トラック ( --シド).

セカンダリ SID (RW)
副字幕トラック (を参照) -- セカンダリ SID).

以下 (RW)
のエイリアス sidの.

サブディレイ (RW)
詳細はこちら： -- サブ遅延.

サブポジション (RW)
詳細はこちら： --サブポジション.

サブ可視性 (RW)
詳細はこちら： --サブ可視性.

サブ強制のみ (RW)
詳細はこちら： --サブ強制のみ.

サブスケール (RW)
字幕のフォント サイズ乗数。

尻力マージン (RW)
詳細はこちら： --お尻の力マージン.

サブユースマージン (RW)
詳細はこちら： -- サブ使用マージン.

ass-vsfilter-aspect-compat (RW)
詳細はこちら： --ass-vsfilter-aspect-compat.

お尻スタイルオーバーライド (RW)
詳細はこちら： --ass-style-override.

ストリームキャプチャ (RW)
ファイル名、参照 --ストリームキャプチャ. これを設定すると、指定された
ファイル名。 空の文字列に設定すると停止します。

テレビの明るさ、 テレビコントラスト、 テレビ飽和、 テレビ色相 (RW)
テレビネタ。

プレイリストの位置 (RW)
プレイリストの現在の位置。 最初のエントリは位置 0 にあります。
プロパティは、書き込まれたエントリで再生を再開します。

プレイリスト数
プレイリスト エントリの総数。

プレイリスト
プレイリスト、現在のエントリがマークされています。 現在、生のプロパティ値は役に立ちません。

これにはいくつかのサブプロパティがあります。 交換 N 0 ベースのプレイリスト エントリ
インデックス。

プレイリスト/カウント
プレイリスト エントリの数 (と同じ プレイリスト数).

プレイリスト/N/ファイル名
N 番目のエントリのファイル名。

プレイリスト/N/現在、 プレイリスト/N/再生中
はい このエントリが現在再生中 (またはロード中) の場合。 利用不可または いいえ
そうでなければ。 ファイルを変更するときは、 現在 および 再生 異なる場合があります。
現在再生中のファイルがまだアンロードされていないため。 この場合、
現在 新しい選択を指します。 (mpv 0.7.0 以降)

プレイリスト/N/タイトル
N 番目のエントリの名前。 プレイリスト ファイルにそのようなものが含まれている場合にのみ使用できます。
フィールド、および mpv のパーサーが指定されたプレイリスト形式でそれをサポートしている場合のみ。

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (プレイリスト エントリごと)
「ファイル名」MPV_FORMAT_STRING
「現在の」MPV_FORMAT_FLAG (mpv 0.7.0 以降では欠落している可能性があります)
「再生中」 MPV_FORMAT_FLAG (同上)
「タイトル」 MPV_FORMAT_STRING (任意)

トラックリスト
オーディオ/ビデオ/サブ トラックのリスト、現在のエントリがマークされています。 現在、生のプロパティ
価値は無用です。

これにはいくつかのサブプロパティがあります。 交換 N 0 ベースのトラック インデックスを使用します。

トラックリスト/カウント
トラックの総数。

トラックリスト/N/id
使用される ID -シド/- 援助/--vid. これは、のトラック内で一意です
同じタイプ (サブ/オーディオ/ビデオ) ですが、それ以外は異なります。

トラックリスト/N/タイプ
メディア タイプを説明する文字列。 の一つ オーディオ, ビデオ, 以下.

トラックリスト/N/ソースID
ソース ファイルで使用されているトラック ID。 常に利用できるわけではありません。

トラックリスト/N/タイトル
ファイルに保存されているタイトルを追跡します。 常に利用できるわけではありません。

トラックリスト/N/lang
ファイルによって識別される言語を追跡します。 常に利用できるわけではありません。

トラックリスト/N/オーディオチャンネル
オーディオ トラックの場合、オーディオ ストリーム内のオーディオ チャネルの数。 いいえ
常に正確です (コンテナーのヒントに依存します)。 常に利用できるわけではありません。

トラックリスト/N/albumart
はい これが単一の画像で構成されるビデオ トラックの場合、 いいえ or
それ以外の場合は利用できません。 これは、実際のビデオ トラックに使用されます。
音声ファイルに添付された写真。

トラックリスト/N/default
はい トラックにファイルでデフォルトのフラグが設定されている場合、 いいえ さもないと。

トラックリスト/N/強制
はい ファイルでトラックに強制フラグが設定されている場合、 いいえ さもないと。

トラックリスト/N/コーデック
このトラックで使用されるコーデック名。 h264. 一部利用不可
まれなケース。

トラックリスト/N/外部
はい トラックが外部ファイルの場合、 いいえ そうでなければ。 これはセパレート用に設定されています
字幕ファイル。

トラックリスト/N/外部ファイル名
トラックが外部ファイルからのものである場合のファイル名。それ以外の場合は使用できません。

トラックリスト/N/選択済み
はい トラックが現在デコードされている場合、 いいえ さもないと。

トラックリスト/N/ff-index
FFmpeg ユーティリティで通常使用されるストリーム インデックス。 これはできることに注意してください
libavformat (--demuxer=lavf）であり、
使用済み。 mkv ファイルの場合、インデックスは通常、デフォルトの場合でも一致します。
(組み込み) demuxer を使用しますが、ハードの保証はありません。

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (トラックごと)
「id」MPV_FORMAT_INT64
"タイプ" MPV_FORMAT_STRING
「ソースID」MPV_FORMAT_INT64
「タイトル」MPV_FORMAT_STRING
"lang" MPV_FORMAT_STRING
「オーディオチャンネル」 MPV_FORMAT_INT64
「アルバムマート」MPV_FORMAT_FLAG
「デフォルト」MPV_FORMAT_FLAG
「強制」 MPV_FORMAT_FLAG
「外部」MPV_FORMAT_FLAG
「外部ファイル名」MPV_FORMAT_STRING
「コーデック」MPV_FORMAT_STRING

チャプターリスト
章のリスト、現在のエントリがマークされています。 現在、生のプロパティ値は
役に立たない。

これにはいくつかのサブプロパティがあります。 交換 N 0 ベースのチャプター インデックスを使用します。

チャプターリスト/カウント
章の数。

チャプターリスト/N/タイトル
ファイルに保存されている章のタイトル。 常に利用できるわけではありません。

チャプターリスト/N/回
章の開始時間 (秒単位)。

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (チャプターごと)
「タイトル」MPV_FORMAT_STRING
"時間" MPV_FORMAT_DOUBLE

af (RW)
詳細はこちら： --af と af

vf (RW)
詳細はこちら： --vf と vf

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (フィルター エントリごと)
「名前」 MPV_FORMAT_STRING
「ラベル」MPV_FORMAT_STRING [オプション]
"params" MPV_FORMAT_NODE_MAP [オプション]
「キー」MPV_FORMAT_STRING
"値" MPV_FORMAT_STRING

この形式を使用してプロパティを書き込むこともできます。

ビデオ回転 (RW)
詳細はこちら： --ビデオ回転 オプションを選択します。

シーク可能
通常、現在のファイルをシークできるかどうかを返します。

部分的にシーク可能
返品 はい 現在のファイルがシーク可能と見なされる場合、ただしキャッシュが原因でのみ
アクティブです。 これは、小さな相対シークは問題ないかもしれませんが、大きなシークは失敗する可能性があることを意味します
とりあえず。 通常、シークが成功するかどうかは事前にわかりません。

このプロパティが true を返す場合、 シーク可能 も true を返します。

再生中止
再生を停止しているか停止するかを返します。 (あいまいで便利です
中のような状況 オンロード フック処理、ユーザーが再生を停止できる場合、
ただし、スクリプトは明示的に処理を終了する必要があります。)

カーソル自動非表示 (RW)
詳細はこちら： --カーソル-自動非表示. これを新しい値に設定すると、常にカーソルが更新されます。
内部タイマーをリセットします。

osd-sym-cc
現在の OSD シンボルを不透明な OSD 制御コード (cc) として挿入します。 意味あり
だけで テキスト表示 OSD メッセージを設定するコマンドまたはオプション。 制御
コードは実装固有のものであり、それ以外には役に立ちません。

osd-お尻-cc
${osd-ass-cc/0} OSD 内のテキストの ASS シーケンスのエスケープを無効にします。 ${osd-ass-cc/1}
再度有効にします。 デフォルトでは、偶発的な事故を避けるために ASS シーケンスはエスケープされます。
このプロパティは、この動作を無効にすることができます。 プロパティに注意してください
不透明な OSD 制御コードを返します。これは、 テキスト表示 command
または OSD メッセージを設定するオプション。

例

· --osd-status-msg='これ is ${osd-ass-cc/0}{\\b1}太字 文章'

· テキスト表示 "この is ${osd-ass-cc/0}{\b1}太字 文章"

libass によって認識される任意の ASS オーバーライド タグを使用できます。

エスケープする必要があることに注意してください \ 文字列は C 用に処理されるため
OSDコードに渡す前にエスケープシーケンス。

タグのリストは次の場所にあります。 http://docs.aegisub.org/latest/ASS_Tags/

音声構成
VO が現在構成されているかどうかを返します。 通常、これは
ビデオ ウィンドウが表示されます。 もし -- 強制ウィンドウ オプションが使用され、これは通常
常に戻ります はい.

ビデオビットレート、 オーディオビットレート、 サブビットレート
パケット レベルで計算されたビットレート値。 これは、ビットサイズを分割することで機能します
プレゼンテーション タイムスタンプ距離による XNUMX つのキーフレーム間のすべてのパケットの。
(これはファイルに保存されているタイムスタンプを使用するため、たとえば再生速度は
返される値に影響します。特に、ビデオのビットレートのみが更新されます。
キーフレームごとに、「過去の」ビットレートを表示します。 プロパティをより UI フレンドリーにするために、
これらのプロパティへの更新は、特定の方法で調整されます。

単位はビット/秒です。 OSD フォーマットは、これらの値をキロビット (または
これは未加工のプロパティ値を使用することで防止できます。
例： ${=ビデオ ビットレート}.

これらのプロパティの精度は、いくつかの要因の影響を受けることに注意してください。 もし
基礎となるデマルチプレクサーは、デマルチプレクサーでパケットを書き換えます (一部のファイル形式で行われます)。
ビットレートが若干ずれている可能性があります。 タイムスタンプが悪いか不安定な場合 (
Matroska)、一定のビットレート ストリームでさえ、変動するビットレートを示す場合があります。

これらの値の正確な計算方法は、将来変更される可能性があります。

以前のバージョンの mpv では、これらのプロパティは静的な (しかし不適切な) 推測を返しました。
まったく別の方法を使用しています。

パケットビデオビットレート、 パケットオーディオビットレート、 パケットサブビットレート
の古くて非推奨のプロパティ ビデオビットレート, オーディオビットレート, サブビットレート。 彼ら
まったく同じように動作しますが、キロビット単位で値を返します。 また、彼らは何も持っていません
OSD フォーマット。 ${=ビデオ ビットレート}.

これらのプロパティは使用しないでください。

オーディオデバイスリスト
検出されたオーディオ デバイスのリストを返します。 これは主にクライアントで使用するためのものです
API、および何を反映するか --audio-device = help コマンドラインプレーヤーで戻ります。

を使用してクライアント API でプロパティをクエリする場合 MPV_FORMAT_NODE、またはLuaを使用
mp.get_property_native、これは次の内容の mpv_node を返します:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (デバイス エントリごと)
「名前」 MPV_FORMAT_STRING
「説明」MPV_FORMAT_STRING

当学校区の 名 に渡されるものです - オーディオ装置 オプション（そしてしばしばむしろ
暗号化されたオーディオ API 固有の ID)、一方で 説明 人間が読める自由形式のテキストです。
何も受信されなかった場合、説明は空の文字列です。

名前が設定された特別なエントリ オート デフォルトのオーディオ出力ドライバを選択します
そしてデフォルトのデバイス。

クライアント内のプロパティ監視機構でプロパティを監視可能
API および Lua スクリプト内。 (技術的には、変更通知は初めて有効になります。
このプロパティは読み取られます。)

オーディオ装置 (RW)
オーディオデバイスを設定します。 これは、 - オーディオ装置 オプション、ただしオン
書き込みアクセスがある場合、オーディオ出力はリロードのためにスケジュールされます。

オーディオ出力がアクティブでないときにこのプロパティを書き込んでも、自動的には有効になりません。
オーディオ。 (これは、オーディオが無効になった場合にも当てはまります。
への前回の書き込みアクセス後の再初期化の失敗 オーディオ装置.)

このプロパティは、実際に使用されているオーディオ デバイスも示しません。

これらの詳細の処理方法は、将来変更される可能性があります。

現在のvo
現在のビデオ出力ドライバ (名前は --vo).

現在の青
現在のオーディオ出力ドライバ (名前は --あお).

オーディオ出力検出デバイス
AO ドライバーによって選択されたオーディオ デバイスを返します (一部のデバイスでのみ実装されます)。
ドライバー: 現在のみ コアオーディオ).

作業ディレクトリ
mpv プロセスの作業ディレクトリを返します。 JSON IPC ユーザーに役立ちます。
コマンドラインプレーヤーは通常、相対パスで動作するためです。

プロトコルリスト
プレーヤーによって認識される可能性のあるプロトコル プレフィックスのリスト。 彼らは返されます
末尾なし :/ / 接尾辞 (これは常に必要です)。 場合によっては、
プロトコルは実際にはサポートされません (考慮してください HTTPS ffmpeg がコンパイルされていない場合
TLS サポート付き）。

mpv バージョン
mpv バージョン/著作権文字列を返します。 バイナリのビルド方法に応じて、
リリース バージョンまたは git ハッシュのみが含まれる場合があります。

mpv 構成
ビルド システムに渡された構成引数を返します (通常は
方法 ./waff configure ... 呼び出されました）。

オプション/ (RW)
オプションの値への読み取り専用アクセス --. ほとんどのオプションは次の場所で変更できます
このプロパティに書き込むことにより、ランタイム。 多くのオプションでは、
変更を有効にするためのファイル。 同等のプロパティがある場合は、優先設定
代わりにプロパティ。

ファイルローカルオプション/
そして オプション/、しかし、このプロパティを介してオプションを設定すると、
現在のファイルの再生が停止すると、オプションは古い値にリセットされます。 しようとしている
ファイルが再生されていない (またはロードされていない) ときにオプションを書き込むと、
エラー。

(オプションがファイルローカルとしてマークされている場合でも、 オプション/ アクセスします
ローカル値、および 古い 再生の終了時に復元される値は、
再生が終了するまで読み書きできません。)

オプション情報/
オプションごとの追加情報。

これにはいくつかのサブプロパティがあります。 交換 トップレベルの名前で
オプション。 これらのサブプロパティの安定性は保証されません。
機能で根本的に変化する可能性があります。

オプション情報/ /名前
オプションの名前を返します。

オプション情報/ /タイプ
次のようなオプションタイプの名前を返します String or 整数. 多くの場合
複雑な型、これはあまり正確ではありません。

オプション情報/ /set-from-コマンドライン
返品 はい オプションが mpv コマンドラインから設定された場合、 いいえ さもないと。
オプションが実行時に変更された場合などに設定されるものはそのままです
未定義 (将来変更される可能性があることを意味します)。

オプション情報/ /set-locally
返品 はい オプションがファイルごとに設定されている場合。 これは
自動的にロードされたプロファイル、ファイルディレクトリ構成、およびその他のケース。 その意味は
オプション値は、再生開始前の値に復元されます。
再生が終了します。

オプション情報/ /デフォルト値
オプションのデフォルト値。 常に利用できるとは限りません。

オプション情報/ /分、 オプション情報/ /最大
オプションに許可される整数の最小値と最大値。 場合にのみ利用可能
オプションは数値で、最小/最大は内部で設定されています。
これらの XNUMX つだけが設定されている可能性もあります。

オプション情報/ /選択肢
オプションが選択オプションの場合、可能な選択肢。 ある選択肢
整数は含まれる場合と含まれない場合があります (それらは 分 および マックス).
選択オプションのように動作するが、実際のオプションではないことに注意してください
選択オプションが内部的に存在するため、この情報が利用できない場合があります。

プロパティリスト
最上位のプロパティのリストを返します。

プロパティ 拡張
入力コマンドへのすべての文字列引数と特定のオプション (
--term-playing-msg) はプロパティ拡張の対象となります。 プロパティの拡張が行われることに注意してください
たとえば、数値パラメータが期待される場所では機能しません。 (たとえば、 加えます
コマンドはプロパティ展開を行いません。 の セッションに コマンドは例外であり、一般的なものではありません
ルール。）

input.conf の例

i テキスト表示 ファイル名： ${ファイル名}
を押すと、現在のファイルのファイル名が表示されます i キー

中で 入力.conf、プロパティの拡張は、 生 前にプレフィックス
コマンドの。

次の拡張がサポートされています。

$ {NAME}
プロパティの値に展開 NAME. プロパティの取得に失敗した場合は展開します
エラー文字列に。 （使用 ${名前:} 末尾に : 空の文字列に展開する
代わりに。) NAME 接頭辞が付いています =、プロパティの生の値に展開します (参照
以下のセクション）。

${名前:STR}
プロパティの値に展開 NAMEまたは STR プロパティができない場合
取得しました。 STR 再帰的に展開されます。

${?NAME:STR}
に拡大 STR (再帰的に) プロパティの場合 NAME の新しいガイドができました。

${!NAME:STR}
に拡大 STR (再帰的に) プロパティの場合 NAME 取得できません。

${?NAME==VALUE:STR}
に拡大 STR (再帰的に) プロパティの場合 NAME に等しい文字列に展開されます
VALUE. 接頭辞を付けることができます NAME 　 = プロパティの生の値を比較するため
（以下のセクションを参照）。 プロパティが利用できない場合、またはその他のエラーが発生した場合
取得しても、値が等しいとは見なされません。 ご了承ください VALUE 含めることはできません
いずれかのキャラクター : or }. また、エスケープすることも可能です " or % かもしれない
今後、必要に応じて追加します。

${!NAME==VALUE:STR}
と同じ ? バリアントですが、 STR 値が等しくない場合は展開されます。 (使用
と同じセマンティクス ?.)

$$ に拡大 $.

$} に拡大 }. (再帰展開内でこの文字を生成するには。)

$> プロパティの拡張と特別な処理を無効にする $ 文字列の残りの部分。

プロパティの展開が許可されている場所では、C スタイルのエスケープも受け入れられることがよくあります。
例：

· \n 改行文字になります

· \\ に拡大します \

Raw および フォーマット済み プロパティ
通常、プロパティは人間が読めるテキストとしてフォーマットされ、OSD または
端末で。 フォーマットされていない (生の) 値をプロパティから取得することができます。
その名前の前に =. これらの生の値は、他のプログラムによって解析され、
プロパティに関連付けられたオプションと同じ規則。

例

· ${時間位置} に拡大します 00:14:23 （再生位置が14分23秒の場合）

· ${=時間位置} に拡大します 863.4 (同時に、プラス 400 ミリ秒 - ミリ秒は
通常、フォーマットされたケースでは表示されません)

場合によっては、生のプロパティとフォーマットされたプロパティによって運ばれる情報の量の違い
値はかなり大きくなる可能性があります。 場合によっては、生の値の方がより多くの情報を持っています。
秒よりも精度 時間位置. 場合によっては、逆の場合もあります。 援助 ショー
フォーマットされた場合はトラックのタイトルと言語ですが、未加工の場合はトラック番号のみです。

ON SCREEN CONTROLLER

オン スクリーン コントローラー (略して: OSC) は、基本的な機能を提供するために mpv と統合された最小限の GUI です。
マウス操作性。 これは、新しいユーザーが簡単に操作できるようにすることを目的としています。
正確でダイレクトなシークを可能にします。

mpv が Lua サポート付きでコンパイルされている場合、OSC はデフォルトで有効になっています。 無効にすることができます
完全に --osc=いいえ オプションを選択します。

使い方 　 OSC
デフォルトでは、プレーヤー ウィンドウ内でマウスを動かすと OSC が表示され、
マウスが OSC の外に 0.5 秒間動かされないか、マウスが離れると非表示になります
窓。

当学校区の インタフェース
+--------------------+-----------------------+------------------ --+
| | プレイリストタイトル | 次のプレイリスト |
+------+------+---+--+------+-+----+------+------ --+
| | オーディオ | スキップ | シーク | | | シーク | スキップ | フル |
+------+ 戻る | 戻る | 遊ぶ | 前へ | 前へ | スクリーン |
| | サブ | サブ | | | | | | | | | | | | |
+------+------+------+------+------+------+------ --+
| | シークバー |
+----------------+----------------------------+----------------- --+
| | 時間経過 | キャッシュの状態 | 残り時間 |
+----------------+----------------------------+----------------- --+

プレイリスト 前のページ

┌─────────┬─────────────┐
│左クリック │ プレイリストの前のファイルを再生 │
§─────────┼───────────────┤
│shift+L-クリック │ プレイリストを表示 │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┘

タイトル
現在のメディア タイトルまたはファイル名を表示します

┌───────┬─────────────┐
│左クリック │ プレイリストの位置を表示 │
│ │ 長さと完全なタイトル │
§───────┼───────────────┤
│右クリック │ ファイル名を表示 │
━━━━━━━━━━━━━━━━━━━━━━━━━┘

プレイリスト 次の

┌─────────┬─────────────┐
│左クリック │ プレイリストの次のファイルを再生 │
━━━━━━━━━━━━━━━━━━━━━━━┤
│shift+L-クリック │ プレイリストを表示 │
━━━━━━━━━━━━━━━━━━━━━━┘

オーディオ および 以下
選択したトラックと利用可能なトラックの量を表示します

┌──────────────┬────────────────────────────────── ┐
│左クリック │ オーディオ/サブトラックを順方向に循環 │
├──────────────┼─────────────────────────────────── ┤
│右クリック │ オーディオ/サブトラックを逆方向に循環 │
├──────────────┼─────────────────────────────────── ┤
│shift+L-クリック │利用可能なオーディオ/サブトラックを表示 │
└──────────────┴─────────────────────────────────── ┘

スキップ バック

┌──────────────┬────────────────────────────────── ┐
│左クリック │ 章の最初に移動 / │
│ │ 前章 │
├──────────────┼─────────────────────────────────── ┤
│shift+L-クリック │ 章を表示 │
└──────────────┴─────────────────────────────────── ┘

求める バック

┌─────────┬───────────┐
│左クリック │ 5 秒前にスキップ │
§─────────┼─────────────┤
│右クリック │ 30 秒前にスキップ │
§─────────┼─────────────┤
│shift-L-クリック │ 1 フレーム戻る │
━─────────┴─────────────┘

遊びます

┌────────────┬────────────────────┐
│左クリック │ 再生/一時停止 │
└────────────┴────────────────────┘

求める 前へ

┌──────────────┬──────────────────────────┐
│左クリック │ 10秒早送り │
├──────────────┼──────────────────────────┤
│右クリック │ 60秒早送り │
├──────────────┼──────────────────────────┤
│shift-L-クリック │ 1 フレーム先にスキップ │
└──────────────┴──────────────────────────┘

スキップ 前へ

┌─────────┬───────────┐
│左クリック │ 次のチャプターへ │
§─────────┼───────────┤
│shift+L-クリック │ 章を表示 │
━─────────┴───────────┘

フルスクリーン

┌────────────┬────────────────────┐
│左クリック │ 全画面切り替え │
└────────────┴────────────────────┘

シークバー
現在の再生位置とチャプターの位置を表示

┌────────────┬──────────────────┐
│左クリック │ シーク │
└────────────┴──────────────────┘

時間 渡された
現在の再生位置のタイムスタンプを表示

┌────────────┬──────────────────────────────────┐
│左クリック │ タイムコードの表示を切り替える │
│ │ ミリ秒 │
└────────────┴──────────────────────────────────┘

キャッシュ status
現在のキャッシュ フィル ステータスを表示します (45% 未満の場合のみ表示)

時間 残り
残りの再生時間のタイムスタンプを表示

┌────────────┬──────────────────────────────────┐
│左クリック │ 合計と │ を切り替える
│ │ 残り時間 │
└────────────┴──────────────────────────────────┘

キー バインディング
これらのキー バインドは、これらのキーに他に何もバインドされていない場合、既定でアクティブになります。
衝突の場合、関数を別のキーにバインドする必要があります。 を参照してください スクリプト
コマンド のセクションから無料でダウンロードできます。

┌────┬───────────────┐
│del │ OSC を永久に非表示にする │
│ │ mpv を再起動します。 │
━───┴─────────────────┘

　
OSC は、構成ファイルを介して限定的な構成を提供します lua-設定/osc.conf に配置
mpv のユーザー ディレクトリと --script-opts コマンドライン オプション。 を通じて提供されるオプション
コマンドラインは設定ファイルからのものを上書きします。

設定 構文
構成ファイルは、次の構文に正確に従う必要があります。

＃これはコメントです
オプションA=値1
オプションB=値2

# は行頭でのみ使用でき、前後にスペースを入れてはいけません。 = or
どこか他の。

コマンドライン 構文
他のスクリプトとの衝突を避けるために、すべてのオプションに接頭辞を付ける必要があります オシッコ-.

例：

--script-opts=osc-optionA=値1,osc-optionB=値2

構成可能 オプション
ショーウィンドウ
デフォルト：はい
ウィンドウ表示時に OSC を有効にする

全画面表示
デフォルト：はい
フルスクリーン時に OSC を有効にする

スケールウィンドウ
デフォルト：1.0
ウィンドウ表示時の OSC の倍率

スケールフルスクリーン
デフォルト：1.0
フルスクリーン時の OSC の倍率

スケール強制ウィンドウ
デフォルト：2.0
強制 (ダミー) ウィンドウでレンダリングされたときの OSC の倍率

ビデオスケール
デフォルト：はい
ビデオで OSC をスケーリングする
いいえ ウィンドウ サイズが許す限り、OSC サイズを一定に保とうとします。

不正な
デフォルト：0.8
垂直方向の配置、-1 (上) から 1 (下)

ハライン
デフォルト：0.0
水平方向の配置、-1 (左) から 1 (右)

ボックスアルファ
デフォルト：80
背景ボックスのアルファ、0 (不透明) から 255 (完全に透明)

非表示タイムアウト
デフォルト：500
マウスの動きがない場合に OSC が非表示になるまでのミリ秒単位の期間、負の値
自動非表示を無効にします

フェードデュレーション
デフォルト：200
フェードアウトの期間 (ミリ秒)、0 = フェードなし

デッドゾーンサイズ
デフォルト：0
デッドゾーンのサイズ。 デッドゾーンはマウスを行動させる領域です
窓を離れるように。 そこを動かしても OSC は表示されず、
マウスが入るとすぐに非表示になります。 デッドゾーンが始まる
OSC の反対側のウィンドウの境界にあり、サイズはどれだけ制御するかを制御します
それがまたがるウィンドウの。 0 ～ 1 の値。

最小マウス移動
デフォルト：3
マウスが目盛り間で移動する必要があるピクセルの最小量
OSCが表示されます

レイアウト
デフォルト: ボックス
OSC のレイアウト。 現在利用可能なもの: ボックス、スリムボックス、
ボトムバーとトップバー。

シークバースタイル
デフォルト: スライダー
シークバー、スライダー (ダイヤモンド マーカー)、またはバー (塗りつぶし) のスタイルを設定します。

総時間
デフォルト：いいえ
残り時間ではなく合計時間を表示

時間
デフォルト：いいえ
タイムコードをミリ秒単位で表示

スクリプト コマンド
OSC スクリプトは、特定のスクリプト コマンドをリッスンします。 これらのコマンドは、 入力.conf,
または他のスクリプトによって送信されます。

OSC を有効にする
元に戻す 無効-OSC またはの効果 インクルード キー。

無効-OSC
OSC を永久に非表示にします。 これはまた、 インクルード キーはします。

osc メッセージ
OSC を使用して画面にメッセージを表示します。 最初の引数はメッセージ、XNUMX 番目の引数は
秒単位の期間。

例

これを入れることができます 入力.conf でOSCを非表示にするには a キーとそれを再表示する b:

script_message disable-osc
b script_message イネーブル-osc

LUA スクリプティング

mpv は Lua スクリプトをロードできます。 に渡されるスクリプト - 脚本 オプション、または スクリプト
mpv 設定ディレクトリのサブディレクトリ (通常は 〜/ .config / mpv / scripts /）になります
プログラムの開始時にロードされます。 mpv も追加します スクリプト Lua の末尾のサブディレクトリ
そこからもスクリプトをインポートできるようにします。 末尾に追加されるので、名前を付けないでください
Lua ライブラリと同じようにインポートしたいスクリプト
それら。

mpv は組み込みモジュールを提供します mpmpv にコマンドを送信する関数が含まれています。
コアと、再生状態、ユーザー設定、ファイル情報に関する情報を取得するため、
などがあります。

これらのスクリプトは、スレーブ モードと同様の方法で mpv を制御するために使用できます。 技術的には、
Lua コードはクライアント API を内部的に使用します。

例
プレーヤーが一時停止したときにフルスクリーン モードを終了するスクリプト:

関数 on_pause_change(名前、値)
値 == true の場合
mp.set_property("フルスクリーン", "いいえ")
end
end
mp.observe_property("一時停止", "bool", on_pause_change)

詳細 on 　 スクリプト 初期化 および wifecycwe
スクリプトは、プログラムの開始時にプレーヤーによって読み込まれます。 スクリプト の監視
サブディレクトリ、または - 脚本 オプション。 一部のスクリプトが読み込まれます
内部的に（のように --osc）。 各スクリプトは独自のスレッドで実行されます。 あなたのスクリプトは最初に「として実行されます
is」であり、それが完了すると、イベントループに入ります。このイベントループはディスパッチされます
mpv によって受信されたイベントと、登録した独自のイベント ハンドラーを呼び出す
mp.register_event、または追加されたタイマー mp.add_timeout または類似。

プレーヤーが終了すると、すべてのスクリプトが終了するよう求められます。 これは、 shutdown
これにより、デフォルトでイベント ループが返されます。 スクリプトが
無限ループ、mpv はおそらく再生中に正常に動作します (プレーヤーが
一時停止、参照 MP.サスペンド）、ただし、待機しているため、終了しても終了しません
スクリプト。

内部的には、C コードは Lua 関数を呼び出します。 mp_event_loop Luaをロードした後
脚本。 この関数は通常、スクリプトの前にロードされるデフォルトのプレリュードによって定義されます
（参照してください プレーヤー/lua/defaults.lua mpv ソースで)。 イベント ループはイベントを待機し、
に登録された派遣イベント mp.register_event. で追加されたタイマーも処理します
mp.add_timeout 同様に（タイムアウトで待機することにより）。

mpv 0.6.0 以降、プレーヤーはスクリプトが完全に読み込まれるまで待機してから続行します。
通常の操作。 プレーヤーは、スクリプトが開始されるとすぐに完全にロードされたと見なします
mpv イベントを待っています (または終了します)。 実際には、これはプレーヤーが多かれ少なかれ
スクリプトがメイン チャンクから戻るまでハングします (そして mp_event_loop と呼ばれる)、または
スクリプト呼び出し mp_event_loop or mp.dispatch_events 直接。 これはそれを作るために行われます
実際に再生を開始する前に、スクリプトでイベント ハンドラーなどを完全にセットアップすることができます。
古いバージョンの mpv では、これは非同期で発生していました。

mp 機能
当学校区の mp モジュールはプリロードされていますが、手動でロードすることもできます 必要とする 'mp'。 それ
コア クライアント API を提供します。

mp.command(文字列)
指定されたコマンドを実行します。 これは、input.conf で使用されるコマンドに似ています。 見る
リスト of 入力 コマンド.

デフォルトでは、OSD に何かが表示されます (コマンドによって異なります)。
で使用されました 入力.conf。 見る 入力 Command 接頭辞 OSD の使用に影響を与える方法
コマンドごと。

返品 true 成功した場合、または なし エラー エラー時。

mp.commandv(arg1, arg2、 ...）
そして mp.コマンド、ただし、各コマンド引数を個別のパラメーターとして渡します。 この
一部の引用符やエスケープを気にする必要がないという利点があります
ケース。

例：

mp.command("ロードファイル"..ファイル名.."追加")
mp.commandv("ロードファイル", ファイル名, "追加")

これら XNUMX つのコマンドは同等ですが、最初のバージョンは、
filename には、スペースまたは特定の特殊文字が含まれています。

プロパティは 拡大しました。 どちらでも使用できます mp.コマンド
拡張プロパティ プレフィックス、または mp.get_property 関数のファミリー。

取消 mp.コマンド、これもデフォルトでは OSD を使用しません (一部を除く)。
OSD 固有のコマンド)。

mp.command_native(テーブル [,定義])
そして mp.commandv、しかし引数リストをテーブルとして渡します。 これには利点があります
少なくとも場合によっては、引数をネイティブ型として渡すことができます。

成功した場合は結果テーブルを返します (通常は空)、または 間違いなく、 エラー エラー時。 def is
関数に提供される XNUMX 番目のパラメーターであり、欠落している場合は nil です。

mp.get_property(名前 [,定義])
指定されたプロパティの値を文字列として返します。 これらは、
input.conf で使用されます。 見る プロパティ プロパティのリストについては。 返される文字列は
に似たフォーマット ${=名前} （参照してください プロパティ 拡張).

成功した場合は文字列を返します。または 間違いなく、 エラー エラー時。 def は XNUMX 番目のパラメータです
関数に提供され、欠落している場合は nil です。

mp.get_property_osd(名前 [,定義])
そして mp.get_propertyただし、OSD 用にフォーマットされたプロパティ値を返します。 この
で印刷されたものと同じ文字列です $ {名前} input.conf で使用する場合。

成功した場合は文字列を返します。または 間違いなく、 エラー エラー時。 def は XNUMX 番目のパラメータです
関数に提供され、欠落している場合は空の文字列です。 ようではない
get_property（）、戻り値を変数に割り当てると、常に
文字列。

mp.get_property_bool(名前 [,定義])
そして mp.get_property、ただし、プロパティ値をブール値として返します。

成功した場合はブール値を返します。または 間違いなく、 エラー エラー時。

mp.get_property_number(名前 [,定義])
そして mp.get_propertyですが、プロパティ値を数値として返します。

Lua は整数と浮動小数点を区別しませんが、mpv 内部は
行う。 この関数は単純に mpv から double float を要求し、mpv は通常
整数プロパティ値を float に変換します。

成功した場合は数値を返します。または 間違いなく、 エラー エラー時。

mp.get_property_native(名前 [,定義])
そして mp.get_property、ただし、最適な Lua タイプを使用してプロパティ値を返します
プロパティのために。 ほとんどの場合、これは文字列、ブール値、または数値を返します。 いくつかの
プロパティ (たとえば チャプターリスト) はテーブルとして返されます。

成功時に値を返す、または 間違いなく、 エラー エラーで。 ご了承ください ゼロ かもしれない
場合によっては有効な値も可能です。

mp.set_property(名前、 値）
指定されたプロパティを指定された文字列値に設定します。 見る mp.get_property および
プロパティ プロパティの詳細については。

成功した場合に true を返す、または なし エラー エラー時。

mp.set_property_bool(名前、 値）
そして mp.set_property、ただし、指定されたプロパティを指定されたブール値に設定します。

mp.set_property_number(名前、 値）
そして mp.set_property、ただし、指定されたプロパティを指定された数値に設定します。

Lua は整数と浮動小数点を区別しませんが、mpv 内部は
行う。 この関数は、数値が整数として表現できるかどうかをテストし、
そうであれば整数値を mpv に渡し、そうでなければ倍精度浮動小数点数を渡します。

mp.set_property_native(名前、 値）
そして mp.set_property、ただし、ネイティブ型を使用して特定のプロパティを設定します。

Lua ではネイティブに表現できないデータ型がいくつかあるため、
常に期待どおりに機能するとは限りません。 たとえば、Lua ラッパーはいくつかのことを実行できますが、
Lua テーブルが配列かマップかを推測で判断すると、次のエラーで失敗します。
空のテーブル。 また、使用する意味のあるプロパティは多くありません
これの代わりに セットプロパティ, set_property_bool, set_property_number。 これらのために
理由により、プロパティを除いて、この関数はおそらく今のところ避けるべきです
テーブルをネイティブに使用します。

mp.get_time()
現在の mpv 内部時間を秒単位で返します。 これは基本的に、
任意のオフセットを持つシステム時間。

mp.add_key_binding(キー、 名前|fn [,fn [,フラグ]])
キーバインディングで実行されるコールバックを登録します。 バインディングはにマップされます
与えられた キー、物理キーを説明する文字列です。 これは同じキーを使用します
input.conf のように名前を付け、組み合わせも許可します (例: ctrl + a).

この関数を呼び出した後、キーを押すと関数が呼び出されます fn 呼ばれる
(ユーザーが別のバインディングでキーを再マップしない限り)。

当学校区の 名 引数は短い記号文字列でなければなりません。 ユーザーが再マッピングできるようにします
を使用したinput.confによるキーバインディング スクリプトメッセージ コマンド、およびの名前
キー バインド (例については以下を参照)。 名前は他とは異なる固有のものにする必要があります
同じスクリプト内のバインディング - そうでない場合、同じ名前の以前のバインディングが
上書きされます。 名前は省略できます。その場合、ランダムな名前が生成されます
内部的に。

最後の引数は、オプションのフラグに使用されます。 これは、
次のエントリ:

繰り返し可能
に設定した場合 true、この特定のバインディングのキーの繰り返しを有効にします。

複雑な
に設定した場合 trueをタップし、その後、 fn キーアップとキーダウンの両方のイベントで呼び出されます (同様に
有効な場合はキーリピートとして)、最初の引数はテーブルです。 この
テーブルには イベント 文字列の XNUMX つに設定されているエントリ ダウン,
繰り返す, up or (キーの上下を追跡できない場合は後者)。 それ
さらに is_mouse イベントが発生したかどうかを示すエントリ
マウスボタンで。

内部的には、キーバインディングは script_message_to or スクリプトバインディング
入力コマンドと mp.register_script_message.

複数のコマンドをキーにマップしようとすると、基本的にランダムなバインドが優先されます。
他のバインディングは呼び出されません。 ユーザーが定義したことが保証されています
中央の input.conf のバインディングは、これで追加されたバインディングよりも優先されます
関数 (ただし、 mp.add_forced_key_binding).

例：

関数 something_handler()
print("キーが押されました")
end
mp.add_key_binding("x", "何か", something_handler)

これにより、メッセージが出力されます 　 キー ました 押し いつ x 押されました。

ユーザーは、これらのキー バインドを再マップできます。 次に、ユーザーは以下を
彼の input.conf は、コマンドを y キー：

y script_binding 何か

これは、キーが y 押されます。 (x ない限り、引き続き機能します。
ユーザーが再マップします。)

名前付きスクリプトのみに明示的にメッセージを送信することもできます。 上記を想定
スクリプトはファイル名を使用していました fooscript.lua:

y script_binding fooscript.something

mp.add_forced_key_binding(...)
これはほぼ同じように機能します mp.add_key_binding、しかしキーバインディングを登録します
input.conf 内のユーザーのカスタム バインディングを上書きする方法。
(mp.add_key_binding デフォルトのキーバインディングのみを上書きしますが、
ユーザーのinput.conf。)

mp.remove_key_binding(名前)
で追加されたキーバインディングを削除します mp.add_key_binding or mp.add_forced_key_binding.
バインディングを追加したときと同じ名前を使用します。 削除することはできません
名前を省略したバインディング。

mp.register_event(名前、 fn）
イベントが発生したときに特定の関数を呼び出します。 イベント名は文字列で、
function fn は Lua 関数の値です。

一部のイベントには関連データがあります。 これは Lua テーブルに入れられ、次のように渡されます。
fn への引数。 Lua テーブルにはデフォルトで 名 文字列であるフィールド
イベント名が含まれています。 イベントにエラーが関連付けられている場合、 エラー 分野は
エラーを説明する文字列に設定され、成功した場合は設定されません。

複数の関数が同じイベントに登録されている場合、それらは実行されます
最初に登録された関数がすべての関数の前に実行される登録順序
その他のもの。

そのようなイベントが存在する場合は true、そうでない場合は false を返します。

詳細はこちら： イベント および リスト of イベント より詳細をご確認いただけます。

mp.unregister_event(fn)
アンドゥ mp.register_event(..., fn）. これにより、等しいすべてのイベント ハンドラーが削除されます。
　 fn パラメータ。 これは通常のLuaを使用します == 比較になりますので、お取引にはご注意ください。
クロージャー付き。

mp.observe_property(名前、 タイプ、 fn）
プロパティの変更を監視します。 プロパティの場合 名 が変更された場合、関数
fn(名前) と呼ばれます。 type することができます ゼロ、またはいずれかに設定 なし, ネイティブ, ブール,
stringまたは 数. なし と同じです。 ゼロ. 他のすべての値については、新しい値
プロパティは の XNUMX 番目の引数として渡されます fn、使用して mp.get_property_
それを取得します。 これは、 type 例えば string, fn と大まかに呼ばれる
in fn(名前、 mp.get_property_string(名前)).

可能であれば、変更イベントは結合されます。 プロパティが何度も変更された場合
続けて、最後の変更のみが変更機能をトリガーします。 (正確な動作
時期等により異なります。）

プロパティが変更されても関数が呼び出されない場合があります。 どうにか
これは、プロパティによって発生する可能性があります。

Status type is なし or ゼロ、散発的なプロパティ変更イベントが発生する可能性があります。 この
変化関数を意味します fn プロパティが実際に呼び出されなくても呼び出すことができます
変更します。

mp.unobserve_property(fn)
アンドゥ mp.observe_property(..., fn）. これにより、すべてのプロパティ ハンドラーが削除されます。
に等しい fn パラメータ。 これは通常のLuaを使用します == 比較するので気をつけてください
クロージャーの扱い。

mp.add_timeout(秒、 fn）
指定された秒数が経過したときに、指定された関数 fn を呼び出します。 ご了承ください
秒数は分数にすることができます。 今のところ、タイマーの解像度は
これは将来的に改善される予定ですが、50 ミリ秒と低くなります。

これはワンショット タイマーです。起動すると削除されます。

タイマー オブジェクトを返します。 見る mp.add_periodic_timer より詳細をご確認いただけます。

mp.add_periodic_timer(秒、 fn）
指定された関数を定期的に呼び出します。 これは mp.add_timeout、しかしタイマーは
関数 fn の実行後に再度追加されます。

返品 a タイマー オブジェクト。 当学校区の タイマー オブジェクト は、大阪で 　 フォロー中 メソッド：

停（） タイマーを無効にします。 タイマーがすでに無効になっている場合は何もしません。
これにより、停止時に現在の経過時間が記憶されるため、
履歴書（） 基本的にタイマーの一時停止を解除します。

殺す（） タイマーを無効にします。 経過時間をリセットします。 履歴書（） を再起動します
タイマー。

履歴書（）
タイマーを再起動します。 タイマーが無効になっている場合 停（）、 この意志
停止した時点から再開します。 タイマーが無効になっている場合
殺す（）、または以前に起動されたワンショット タイマーの場合 (
add_timeout())、これはタイマーを最初から開始します。
最初に構成されたタイムアウト。

タイムアウト (RW)
このフィールドには、現在のタイムアウト期間が含まれています。 この値は
時間の経過とともに更新されます。 次の場合にのみ計算に使用されます。
タイマーが切れると、タイマーが次に起動するはずです。

これを書けば電話できる t:kill() ; t:再開() をリセットするには
現在のタイムアウトを新しいものに。 (t:ストップ() 新しいタイムアウトは使用されません。)

ワンショット (RW)
タイマーが周期的かどうか (false) または XNUMX 回だけ起動 (true）。 この
値は、タイマーが期限切れになったときに使用されます (ただし、タイマー コールバックの前)
関数 fn が実行されます)。

これらはメソッドであり、次を使用して呼び出す必要があることに注意してください : . （参照
〜へ http://www.lua.org/manual/5.2/manual.html#3.4.9 .)

例：

秒 = 0
タイマー = mp.add_periodic_timer(1, 関数()
print("毎秒呼び出される")
# 10秒後に停止
秒 = 秒 + 1
秒 >= 10 の場合
タイマー:キル()
end
終わり）

mp.get_opt(キー)
から設定を返す --script-opts オプション。 それはユーザーとスクリプト次第です
このメカニズムの使用方法。 現在、すべてのスクリプトがこれに等しくアクセスできるため、
衝突に注意する必要があります。

mp.get_script_name()
現在のスクリプトの名前を返します。 名前は通常、ファイル名から作られます
ディレクトリとファイル拡張子が削除されたスクリプト。 スクリプトが複数ある場合
同じ名前を持つ場合、番号を追加することで一意になります。

例

スクリプト /パス/へ/fooscript.lua になる 原稿.

mp.osd_message(テキスト [、間隔]）
画面に OSD メッセージを表示します。 デュレーション 秒単位で、オプションです (を使用します
--osd-期間 デフォルト）。

高機能 mp 機能
これらはまた、 mp モジュールでのみ有用であるため、個別に文書化されています。
特別な状況。

mp.suspend()
mpv メインループをサスペンドします。 これについては、C API に長い説明があります。
function mpv_suspend(). つまり、これにより、プレーヤーは次の画面を表示できなくなります。
プレーヤーにアクセスしようとしたときにブロックされないようにします。

これは、イベント ハンドラーによって自動的に呼び出されます。

mp.resume()
XNUMX つ元に戻す mp.suspend() コール。 mp.suspend() 内部カウンターをインクリメントし、
mp.resume() デクリメントします。 0 に達すると、プレーヤーは実際に再開されます。

mp.resume_all()
これにより、内部サスペンド カウンターがリセットされ、プレーヤーが再開されます。 （電話みたいな
mp.resume() プレーヤーが実際に再開されるまで。)

時間がかかることをしようとしている場合は、これを呼び出したいと思うかもしれません。
ただし、実際にはプレーヤーへのアクセスは必要ありません (ネットワーク操作など)。 ご了承ください
プレーヤーにはいつでもアクセスできます。

mp.get_wakeup_pipe()
コー​​ル mpv_get_wakeup_pipe() そして、ウェイクアップ パイプの読み取り終了を返します。 （見る
client.h 詳細については。）

mp.get_next_timeout()
次のタイマー (mp.add_timeout および
同様）は期限切れになります。 タイマーがない場合は戻る ゼロ.

mp.dispatch_events([allow_wait])
これは、カスタム イベント ループを実行するために使用できます。 何を直接制御したい場合
Lua スクリプトが (デフォルトのイベント ループによって呼び出される代わりに) 行うので、次のことができます。
グローバル変数を設定する mp_event_loop イベントループを実行する独自の関数に。
イベントループから、呼び出す必要があります mp.dispatch_events() デキューしてディスパッチする
mpv イベント。

Status 許可_待機 パラメータは true、関数は次までブロックします
イベントが受信されるか、次のタイマーが期限切れになります。 それ以外の場合 (これがデフォルトです)
イベントループが空になるとすぐに戻ります。 強くね
使用をお勧めします mp.get_next_timeout() および mp.get_wakeup_pipe() もしあなたが〜なら
新しいイベントの適切な通知とタイマーの動作に関心があります。

この関数は mp.suspend() および mp.resume_all() そのままで。

mp.enable_messages(レベル)
受信する mpv メッセージ出力の最小ログ レベルを設定します。 これらのメッセージ
通常、端末に出力されます。 この関数を呼び出すことで、
で受信する必要があるメッセージの最小ログ レベル ログメッセージ イベント。
詳細については、このイベントの説明を参照してください。 レベルは文字列です。 メッセージログ
許可されたログ レベル。

mp.register_script_message(名前、 fn）
派遣するヘルパーです スクリプトメッセージ or script_message_to Lua への呼び出し
機能します。 fn 次の場合に呼び出されます スクリプトメッセージ or script_message_to （このスクリプトを
宛先) で実行されます 名 最初のパラメーターとして。 他のパラメータが渡されます
〜へ fn. 指定された名前のメッセージが既に登録されている場合は、上書きされます。

によって使われた mp.add_key_binding、名前の衝突に注意してください。

mp.unregister_script_message(名前)
で以前の登録を取り消す mp.register_script_message. 次の場合は何もしません
名 登録されていませんでした。

MP.メッセージ 機能
このモジュールを使用すると、端末にメッセージを出力できます。 必要とする
「mp.msg」.

msg.log(レベル、 ...）
level パラメータはメッセージの優先度です。 それは文字列であり、 致命的な, エラー,
警告する, info, v, debug. ユーザーの設定によって、これらのメッセージのどれが決定されますか
表示されます。 通常、すべてのメッセージが表示されます。 v および debug.

その後のパラメータはすべて文字列に変換されます。 スペースが挿入されます
複数のパラメータを分離します。

改行を追加する必要はありません。

msg.fatal(...)、 msg.error(...)、 msg.warn(...)、 msg.info(...)、 msg.verbose(...)、
msg.debug(...)
これらはすべてショートカットであり、対応する msg.log(レベル、 ...）
コール。

MPオプション 機能
mpv には、構成ファイルとコマンドラインからオプションを管理するための組み込みモジュールが付属しています。
必要な作業は、read_options 関数にデフォルト オプションを含むテーブルを提供することだけです。
この関数は、config-file にある値でデフォルト値を上書きし、
コマンドライン (この順序で)。

options.read_options(テーブル [, 識別子]）
A テーブル キーと値のペアを使用します。 デフォルト値のタイプは重要です
構成ファイルまたはコマンドラインから読み取った値を変換して戻します。 使ってはいけません
ゼロ デフォルト値として！

当学校区の 識別子 構成ファイルとコマンドライン オプションを識別するために使用されます。
これらは、他のスクリプトとの衝突を避けるために一意である必要があります。 デフォルトは
mp.get_script_name().

実装例：

「mp.options」が必要
ローカル オプション = {
オプションA = "デフォルト値A",
オプションB = -0.5、
オプション C = 真、
}
read_options(オプション、「myscript」)
print(オプション.オプションA)

設定ファイルは次の場所に保存されます lua-settings/identifier.conf mpv のユーザー フォルダにあります。
コメント行は # で始めることができ、余分なスペースは削除されません。 ブール値は
はい/いいえで表します。

設定例：

＃ コメント
オプションA=ハローワールド
オプションB=9999
オプションC=いいえ

コマンドライン オプションは、 --script-opts パラメータ。 衝突を避けるために、すべての
キーには接頭辞を付ける必要があります 識別子-.

コマンドラインの例:

--script-opts=myscript-optionA=TEST、myscript-optionB=0、myscript-optionC=yes

mp.utils オプション
この組み込みモジュールは、Lua の一般的なヘルパー関数を提供し、厳密に言えば
mpv やビデオ/オーディオの再生とは関係ありません。 それらは利便性のために提供されています。 多くの
Lua の不足している標準ライブラリを補います。

これらの機能はいつでも消える可能性があることに注意してください。 彼らは厳密には一部ではありません
保証された API の。

ユーティリティ.getcwd()
mpv が起動されたディレクトリを返します。 エラー時、 なし エラー 返されます。

utils.readdir(パス [, フィルター]）
ファイルシステム上の指定されたパスにあるすべてのエントリを列挙し、それらを次のように返します。
配列。 各エントリはディレクトリ エントリです (パスなし)。 リストはソートされていません
（オペレーティングシステムが返す順序は何でも）。

Status filter 引数を指定する場合、次の文字列のいずれかにする必要があります。

ファイル 通常のファイルのみを一覧表示します。 これは、ディレクトリ、特別なファイル (のようなもの) を除外します。
UNIX デバイス ファイルまたは FIFO)、およびデッド シンボリック リンク。 UNIXシンボリックリンクが含まれています
通常のファイルに。

Dirs ディレクトリのみ、またはディレクトリへのシンボリックリンクを一覧表示します。 . および .. ありません
含まれています。

通常の 両方の結果を含める ファイル および Dirs. (これがデフォルトです。)

を デバイスファイル、無効なシンボリックリンク、FIFO、および . および
.. エントリー。

エラーの場合、 なし エラー 返されます。

utils.split_path(パス)
パスをディレクトリ構成要素とファイル名構成要素に分割して返します。 の
最初の戻り値は常にディレクトリです。 XNUMX 番目の戻り値は末尾です。
パスの一部、ディレクトリ エントリ。

utils.join_path(p1, p2）
2 つのパスの連結を返します。 賢くなろうとします。 たとえば、 `p2 is
絶対パスの場合、p2 はそのまま返されます。

utils.subprocess(t)
外部プロセスを実行し、終了するまで待機します。 プロセスのステータスと
キャプチャされた出力。

パラメータ t はテーブルです。 この関数は次のエントリを読み取ります。

引数 文字列の配列。 最初の配列エントリは実行可能ファイルです。 これはすることができます
絶対パス、またはパス コンポーネントを含まないファイル名のいずれか。
ケース パス 環境変数は、実行可能ファイルを解決するために使用されます。 の
その他の配列要素は、コマンド ライン引数として渡されます。

キャンセル可能
オプション。 に設定されている場合 true (デフォルト)、ユーザーが再生を停止した場合、または
プロセスの実行中に次のファイルに移動すると、プロセスは次のようになります。
殺された

最大サイズ
オプション。 キャプチャできるデータの最大サイズ (バイト)
標準出力。 (デフォルト: 16 MB。)

この関数は、次のエントリを含むテーブルを結果として返します。

status プロセスのそのままの終了ステータス。 エラーの場合は負になります。

(Linuxで言うところのstdout） 文字列としてキャプチャされた出力ストリーム。 最大サイズ.

エラー ゼロ 成功について。 文字列 殺されました プロセスが途中で終了した場合
珍しい方法。 文字列 INIT プロセスを開始できなかった場合。

Windowsでは、 殺されました によってプロセスが強制終了された場合にのみ返されます。
結果としてのmpv キャンセル可能 に設定されています true.

kill_by_us
に設定され true の結果としてプロセスが mpv によって強制終了された場合
キャンセル可能 に設定されています true.

すべての場合において、 mp.resume_all() 暗黙的に呼び出されます。

utils.parse_json(文字列 [, トレイル])
指定された文字列引数を JSON として解析し、Lua テーブルとして返します。 エラー時、
収益 なし エラー. （現在、 エラー 単なる文字列の読み取りです エラー、そこにあるので
あらゆる種類のきめ細かなエラー報告ではありません。)

戻り値は、次のような規則を使用します。 mp.get_property_native() 〜へ
空のオブジェクトと配列を区別します。

Status トレイル パラメータは true (または等しい任意の値 true)、次に末尾
空白以外のテキストは関数によって許容され、末尾のテキストが返されます
3 番目の戻り値として。 (3 番目の戻り値は常に存在しますが、 トレイル セット、いいえ
エラーが発生します。)

utils.format_json(v)
指定された Lua テーブル (または値) を JSON 文字列としてフォーマットして返します。 エラー時、
収益 なし エラー. (エラーは通常、互換性のない値の型でのみ発生します。
JSON。)

引数値は、次のように同様の規則を使用します。 mp.set_property_native() 〜へ
空のオブジェクトと配列を区別します。

utils.to_string(v)
指定された値を文字列に変換します。 テーブルとその内容をフォーマットします。 これはしません
何か特別なことをします。 Luaがひどいので必要です。

イベント
イベントは、プレーヤー コアからスクリプトへの通知です。 イベントハンドラを登録できます
　 mp.register_event.

すべてのスクリプト (およびプレーヤーの他の部分) がイベントを等しく受け取ることに注意してください。
他のスクリプトがイベントを受信するのをブロックするようなことはありません。

例：

関数 my_fn(イベント)
print("再生開始!")
end

mp.register_event("ファイル読み込み", my_fn)

リスト of イベント
開始ファイル
新しいファイルがロードされる直前に発生します。 これを受け取るとプレイヤーは
ファイルを読み込んでいます（または、すでに実行されている可能性があります）。

最終ファイル
ファイルがアンロードされた後に発生します。 通常、プレーヤーは次のファイルをロードします
すぐに終了するか、これが最後のファイルである場合は終了します。

イベントには、 理由 次のいずれかの値を取ります。

eof ファイルは終了しました。 これには、不完全なファイルを含めることができます (必須ではありません)。
または状況下でのネットワーク接続の切断。

stop コマンドにより再生が終了しました。

やめます quit コマンドの送信により、再生が終了しました。

エラー エラーが発生しました。 この場合、 エラー フィールドにエラーが存在します
文字列。

リダイレクト
プレイリストなどで発生します。 詳細はこちら MPV_END_FILE_REASON_REDIRECT
C API で。

未知の
わからない。 Lua API が同期していない限り、通常は発生しません。
C API。 (同様に、スクリプトが理由文字列を取得する可能性があります。
スクリプトが作成された時点ではまだ存在していませんでした。)

ファイルロード
ファイルがロードされ、再生が開始された後に発生します。

求める シーク時に発生します。 (これには、プレーヤーが内部的にシークする場合が含まれる場合があります。
ユーザーの操作がなくても。 これには、たとえば、再生中のセグメントの変更が含まれます
順序付けられた章 Matroska ファイル。)

再生再開
シーク後またはファイルロード後の再生開始。

アイドル アイドルモードに入ります。 これは、再生が終了し、プレーヤーが開始されたときに発生します
　 -アイドル or -- 強制ウィンドウ. このモードは、 開始ファイル or
shutdown イベントが発生します。

ダニ ビデオ フレームが表示された後に呼び出されます。 これはハックであり、避けるべきです
それを使用しています。 代わりにタイマーを使用し、イベントの一時停止/一時停止解除を監視して回避する
プレーヤーが一時停止しているときに CPU を浪費します。

shutdown
プレイヤーが終了したときに送信され、スクリプトを終了する必要があります。 通常扱い
自動的。 見る 詳細 on 　 スクリプト 初期化 および wifecycwe.

ログメッセージ
で有効になっているメッセージを受信します mp.enable_messages. メッセージデータは
イベント ハンドラーに最初のパラメーターとして渡されるテーブル。 表には、
デフォルトのイベント フィールドに加えて、次のフィールドが追加されました。

接頭辞 モジュールのプレフィックスは、メッセージの送信者を識別します。 これが
を使用する場合、端末プレーヤーはメッセージ テキストの前に置きます。 --v オプション、
また、 --msg レベル.

レベル 文字列としてのログ レベル。 見る メッセージログ 可能性のあるログ レベル名。 ノート
それ以降のバージョンの mpv では、新しいレベルが追加されるか削除される可能性があります (文書化されていません)。
既存のもの。

클라우드 기반 AI/ML및 고성능 컴퓨팅을 통한 디지털 트윈의 기초 – Edward Hsu, Rescale CPO 많은 엔지니어링 중심 기업에게 클라우드는 R&D디지털 전환의 첫 단계일 뿐입니다. 클라우드 자원을 활용해 엔지니어링 팀의 제약을 해결하는 단계를 넘어, 시뮬레이션 운영을 통합하고 최적화하며, 궁극적으로는 모델 기반의 협업과 의사 결정을 지원하여 신제품을 결정할 때 데이터 기반 엔지니어링을 적용하고자 합니다. Rescale은 이러한 혁신을 돕기 위해 컴퓨팅 추천 엔진, 통합 데이터 패브릭, 메타데이터 관리 등을 개발하고 있습니다. 이번 자리를 빌려 비즈니스 경쟁력 제고를 위한 디지털 트윈 및 디지털 스레드 전략 개발 방법에 대한 인사이트를 나누고자 합니다. ログメッセージ。 テキストは改行文字で終わります。 時々それ
複数の行を含めることができます。

これらのメッセージは人間へのヒントであることを念頭に置いてください。 貴方はするべきではない
それらを解析し、メッセージのプレフィックス/レベル/テキストはいつでも変更される可能性があります。

プロパティの取得応答
文書化されていません (Lua スクリプトには役に立ちません)。

セット プロパティ応答
文書化されていません (Lua スクリプトには役に立ちません)。

コマンド応答
文書化されていません (Lua スクリプトには役に立ちません)。

クライアントメッセージ
文書化されていません (内部で使用されます)。

ビデオ再構成
ビデオ出力またはフィルターの再構成で発生します。

オーディオ再構成
オーディオ出力またはフィルターの再構成で発生します。

次のイベントも発生しますが、非推奨です。 トラック変更, トラック切り替え,
一時停止, 一時停止を解除, メタデータ更新, チャプターチェンジ。 使用 mp.observe_property() を代わりにお使いください。

付属品
これは、実験的な機能、または「特別すぎる」機能を保証するには機能を文書化します。
安定したインターフェース。

mp.add_hook(タイプ、 優先度、 fn）
のフック コールバックを追加します。 type (特定の種類のフックを識別する文字列)。 これらは
フックにより、プレイヤーはスクリプト関数を呼び出してその結果を待つことができます
(通常、Lua スクリプト インターフェイスは、
プレイヤーコア)。 優先順位 フック間の順序付けを可能にする任意の整数
同じ種類の。 ニュートラルなデフォルト値として、値 50 を使用することをお勧めします。 fn is
フックの実行中に呼び出される関数。

詳細はこちら： フック 現在存在するフックとその機能 - フック リストのみ
面白い; フック実行の処理は Lua スクリプト関数によって行われます
自動的に。

JSONの IPC

mpv は、JSON ベースの IPC プロトコルを使用して外部プログラムから制御できます。 かもね
オプションを使用して UNIX ソケットへのパスを指定することで有効になります --input-unix-ソケット.
クライアントはこのソケットに接続して、プレーヤーにコマンドを送信したり、プレーヤーからイベントを受信したりできます。
ボーマンは

警告：
これは、安全なネットワーク プロトコルを意図したものではありません。 明らかに安全ではありません。
認証なし、暗号化なし、コマンド自体も安全ではありません。 にとって
例、 ラン コマンドが公開され、任意のシステム コマンドを実行できます。 の
ユースケースは、プレーヤーをローカルで制御しています。 これはMPlayerと変わらない
スレーブ プロトコル。

ソキャット 例
あなたが使用することができます ソキャット シェルからコマンドを送信 (および応答を受信) するためのツール。 仮定
mpv は次のように開始されました。

mpv ファイル.mkv --input-unix-socket=/tmp/mpvsocket

次に、socat を使用して制御できます。

> echo '{ "コマンド": ["get_property", "再生時間"] }' | socat - /tmp/mpvsocket
{"データ":190.482000,"エラー":"成功"}

この場合、socat は stdin/stdout と mpv ソケット接続の間でデータをコピーします。

ジョブの設定方法については、 -アイドル すぐに終了したり、ファイルを再生したりせずに mpv を開始する方法のオプション。

input.conf スタイルのテキストのみのコマンドを送信することもできます。

> echo 'show_text ${playback-time}' | socat - /tmp/mpvsocket

しかし、ソケットを介して応答を受け取ることはありません。 (この特定のコマンドは、再生を示しています
プレーヤーの OSD に表示されます。)

プロトコル
クライアントは、次の形式の JSON メッセージを送信することにより、プレーヤーでコマンドを実行できます。

{ "コマンド": ["コマンド名", "param1", "param2", ...] }

コラボレー コマンド名 実行するコマンドの名前で、その後にリストが続きます
パラメーター。 パラメータは、ネイティブの JSON 値 (整数、文字列、
ブール値、...)。 すべてのメッセージ しなければなりません で終了する \n。 さらに、 \n 表示してはいけません
メッセージ内の任意の場所。 実際には、これはメッセージを縮小する必要があることを意味します
mpv に送信される前に。

mpv は、コマンドが正しく実行されたかどうかを示す応答を返します。
コマンド固有の戻りデータを保持する追加フ​​ィールド (null の場合もあります)。

{ "エラー": "成功", "データ": null }

mpv は、次の形式の JSON メッセージでクライアントにイベントも送信します。

{ "イベント": "イベント名" }

コラボレー イベント名 イベントの名前です。 追加のイベント固有のフィールドも
現在。 見る リスト of イベント サポートされているすべてのイベントのリストについては、

イベントはいつでも発生する可能性があるため、特定するのが難しい場合があります。
応答は、どのコマンドで行われますか。 コマンドにはオプションで リクエストID これ、もし
コマンド リクエストで指定された情報は、そのままレスポンスにコピーされます。 mpv はしません
を解釈します リクエストID いずれにせよ; これは、請求者のみが使用するためのものです。

たとえば、次のリクエストです。

{ "command": ["get_property", "time-pos"], "request_id": 100 }

次の応答が生成されます。

{ "エラー": "成功", "データ": 1.468135, "request_id": 100 }

すべてのコマンド、応答、およびイベントは、改行で互いに区切られています
キャラクター （\n).

最初の文字 (空白をスキップした後) が {、コマンドは
input.conf で使用されているため、非 JSON テキスト コマンドとして解釈されます (または
mpv_command_string() クライアント API で)。 さらに、で始まる行 # そして空
行は無視されます。

現在、埋め込まれた 0 バイトは現在の行を終了しますが、これに頼るべきではありません。

コマンド
で説明されているコマンドに加えて、 リスト of 入力 コマンド、いくつかの追加コマンド
プロトコルの一部としても使用できます。

クライアント名
クライアントの名前を文字列として返します。 これが文字列です ipc-N N は
整数。

get_time_us
現在の mpv 内部時間をマイクロ秒単位で数値として返します。 これは基本的に
任意のオフセットを持つシステム時間。

get_property
指定されたプロパティの値を返します。 値は、のデータ フィールドで送信されます。
リプレイメッセージ。

例：

{ "コマンド": ["get_property", "ボリューム"] }
{ "データ": 50.0、"エラー": "成功" }

get_property_string
いいね get_propertyですが、結果のデータは常に文字列になります。

例：

{ "コマンド": ["get_property_string", "ボリューム"] }
{ "データ": "50.000000", "エラー": "成功" }

セットプロパティ
指定されたプロパティを指定された値に設定します。 見る プロパティ 詳しく知る
プロパティについて。

例：

{ "コマンド": ["set_property", "一時停止", true] }
{ "エラー": "成功" }

set_property_string
いいね セットプロパティですが、引数値は文字列として渡す必要があります。

例：

{ "コマンド": ["set_property_string", "一時停止", "はい"] }
{ "エラー": "成功" }

観察プロパティ
プロパティの変更を監視します。 指定されたプロパティが変更された場合、次のイベント
type プロパティ変更 生成されます

例：

{ "コマンド": ["observe_property", 1, "ボリューム"] }
{ "エラー": "成功" }
{ "event": "property-change", "id": 1, "data": 52.0, "name": "volume" }

監視プロパティ文字列
いいね 観察プロパティですが、結果のデータは常に文字列になります。

例：

{ "コマンド": ["observe_property_string", 1, "ボリューム"] }
{ "エラー": "成功" }
{ "event": "property-change", "id": 1, "data": "52.000000", "name": "volume" }

unobserve_property
アンドゥ 観察プロパティ or 監視プロパティ文字列. これには数値 ID が必要です
引数として監視コマンドに渡されます。

例：

{ "コマンド": ["unobserve_property", 1] }
{ "エラー": "成功" }

request_log_messages
mpv ログ メッセージの出力を有効にします。 イベントとして受け取ります。 パラメータ
このコマンドへのログ レベルです (を参照してください)。 mpv_request_log_messages C API 関数)。

ログ メッセージの出力は、人間のみを対象としています (主にデバッグ用)。 試行する
これらのメッセージを解析して情報を取得すると、破損につながるだけです
今後の mpv リリース。 代わりに、機能リクエストを作成し、適切なイベントを依頼してください
必要な情報を返します。

enable_event、 イベントを無効にする
名前付きイベントを有効または無効にします。 ミラーリング mpv_request_event C API 関数。
文字列の場合 を がイベント名の代わりに使用されている場合、すべてのイベントが有効になっている、または
無効にする。

デフォルトでは、ほとんどのイベントが有効になっており、このコマンドの用途はあまりありません。

サスペンド
mpv メインループをサスペンドします。 これについては、C API に長い説明があります。
function mpv_suspend(). つまり、これにより、プレーヤーは次の画面を表示できなくなります。
プレーヤーにアクセスしようとしたときにブロックされないようにします。

履歴書 XNUMX つ元に戻す サスペンド コール。 サスペンド 内部カウンターをインクリメントし、 履歴書
デクリメントします。 0 に達すると、プレーヤーは実際に再開されます。

バージョンの取得
リモート mpv インスタンスの C API が提供するクライアント API バージョンを返します。 （また
DOCS/client-api-changes.rst.)

UTF-8
通常、すべての文字列は UTF-8 です。 文字列が一部にあることが時々起こります。
壊れたエンコーディング (ファイル タグなどでよく発生し、多くの Unix のファイル名は
UTF-8 である必要もありません)。 これは、mpv が無効な JSON を送信する場合があることを意味します。 もしも
これはクライアント アプリケーションのパーサーの問題です。
無効な UTF-8 シーケンスを削除し、データを
その JSON パーサー。

mpv は、壊れたエスケープ シーケンスで無効な UTF-8 を構築しようとしません。

変更履歴

実際の変更ログはありませんが、次のことを確認できます。

· 新しいものを含む、ユーザーに見えるほとんどの変更を含むリリースの変更ログ。
機能とバグ修正:

https://github.com/mpv-player/mpv/releases

· 「本当の」変更ログである git ログ

・ ファイル mplayer-changes.rst 会場は DOCS 使用した git リポジトリのサブディレクトリ
このセクションの代わりになります。 mplayer2以降に発生したいくつかの変更を文書化しています
MPlayer から分岐しました。

埋め込み INTO その他 プログラム (LIBMPV)

mpv は、ビデオ/オーディオ再生バックエンドとして他のプログラムに埋め込むことができます。 推奨される
その方法は、libmpv を使用することです。 見る libmpv/client.h mpv ソース コード リポジトリにあります。 この
C API を提供します。 他の言語のバインディングが利用できる場合があります (wiki を参照)。

ENVIRONMENT 変数

の動作を制御するために使用できる多くの環境変数があります。
mpv。

ホーム、 XDG_CONFIG_HOME
mpv 構成ディレクトリを決定するために使用されます。 もしも XDG_CONFIG_HOME 設定されていません、
$HOME/.config/mpv 使用されている。

$HOME/.mpv 常に設定検索パスのリストに追加されます。
優先度。

XDG_CONFIG_DIRS
設定されている場合、XDG スタイルのシステム構成ディレクトリが使用されます。 そうでなければ、UNIX
コンベンション（プレフィックス/etc/mpv/） 使用されている。

TERM 端末タイプを判別するために使用されます。

MPV_HOME
mpv がユーザー設定を探すディレクトリ。 オーバーライド ホーム、そして mpv はしようとします
設定ファイルを次のようにロードします $MPV_HOME/mpv.conf.

MPV_VERBOSE （参照してください また -v および --msg レベル)
すべてのメッセージ モジュールの初期詳細レベルを設定します (デフォルト: 0)。 これは
整数、結果の冗長性はの数に対応します --v オプション
コマンドラインに渡されます。

MPV_LEAK_REPORT
に設定した場合 1、内部タロック リーク レポートを有効にします。 原因となる場合があることに注意してください。
マルチスレッドに問題があるため、開発者のみがこれを使用する必要があります。

LADSPA_PATH
LADSPA プラグインの検索パスを指定します。 設定されていない場合は、完全修飾パス
名前を使用する必要があります。

DISPLAY
使用する標準の X11 表示名。

FFmpeg/Libav:
このライブラリは、さまざまな環境変数にアクセスします。 ただし、そうではありません
それらを文書化することは私たちの仕事ではありません。 したがって、このリストは
不完全な。

注目すべき環境変数:

http_proxy
プロキシする URL http:// および https:// URL。

no_proxy
プロキシを使用しないドメイン パターンのリスト。 リストのエントリは
で区切られた ,. パターンには以下を含めることができます *.

libdvdcss:

DVDCSS_キャッシュ
タイトル キー値を格納するディレクトリを指定します。 これでスピードアップします
キャッシュにある DVD のデスクランブル。 の DVDCSS_キャッシュ ディレクトリは
存在しない場合は作成され、サブディレクトリが作成されます。
DVD のタイトルまたは製造日。 もしも DVDCSS_キャッシュ 設定されていないか、空です。
libdvdcss はデフォルト値を使用します。 ${HOME}/.dvdcss/ Unix の下で
およびローミング アプリケーション データ ディレクトリ (％APPDATA％と) Windows で。 の
特別な値「off」はキャッシュを無効にします。

DVDCSS_METHOD
libdvdcss が使用する認証および復号化方法を設定します。
スクランブルディスクを読み取ります。 次のいずれかになります。 タイトル, キー or ディスク.

キー がデフォルトの方法です。 libdvdcss は計算されたプレーヤーのセットを使用します
キーを押して、ディスク キーを取得しようとします。 ドライブがそうでない場合、これは失敗する可能性があります
プレーヤーのキーを認識します。

ディスク キーが失敗した場合のフォールバック メソッドです。 プレーヤーを使用する代わりに
キー、libdvdcss はブルート フォースを使用してディスク キーをクラックします。
アルゴリズム。 このプロセスは CPU を集中的に使用し、64 MB のメモリが必要です
一時データを保存します。

タイトル 他のすべてのメソッドが失敗した場合のフォールバックです。 依存しない
DVD ドライブとの鍵交換ではなく、暗号攻撃を使用します。
タイトルキーを推測します。 まれに、これが失敗することがあります。
統計を実行するのに十分な暗号化データがディスクにありません
攻撃しますが、DVD を復号化する唯一の方法です。
ハードディスク、または RPC2 上の間違ったリージョンの DVD に保存されている
ドライブ。

DVDCSS_RAW_DEVICE
使用する raw デバイスを指定します。 正確な使用法は、操作によって異なります
システムでは、raw デバイスを設定する Linux ユーティリティは 生(8) 例えば。
ほとんどのオペレーティング システムでは、raw デバイスを使用するには
高度に整列されたバッファー: Linux では 2048 バイトの整列が必要です (これは、
DVD セクターのサイズ)。

DVDCSS_VERBOSE
libdvdcss の詳細レベルを設定します。

0 メッセージをまったく出力しません。

1 エラーメッセージを stderr に出力します。

2 エラーメッセージとデバッグメッセージを stderr に出力します。

DVDREAD_NOKEYS
起動時にすべてのキーの取得をスキップします。 現在無効になっています。

ホーム FIXME: これを文書化します。

EXIT コード

通常は mpv 再生が正常に終了した後、終了コードとして 0 を返します。 エラーの場合
次の終了コードが返される可能性があります。

1 mpv の初期化中にエラーが発生しました。 これは、未知のオプションが渡された場合にも返されます
mpv。

2 mpv に渡されたファイルを再生できませんでした。 これはややあいまいです: 現在、
初期化がほとんど完了した場合、ファイルの再生は成功したと見なされます
初期化直後に再生が失敗しても成功します。

3 再生できるファイルと再生できないファイルがありました（
上記の成功の定義）。

4 シグナルによる終了、VO ウィンドウでの Ctrl+c (デフォルト)、またはデフォルトからの終了
エンコーディング モードでのキー バインドを終了します。

プレーヤーを手動で終了すると、常に終了コード 0 になり、
通常返される終了コード。 また、 やめます 入力コマンドは終了できます
code: この場合、その終了コードが返されます。

onworks.net サービスを使用してオンラインで mpv を使用する