mpv

CHƯƠNG TRÌNH:

TÊN

mpv - một trình phát đa phương tiện

SYNOPSIS

mpv [tùy chọn] [tệp | URL | DANH SÁCH PHÁT | -]
mpv [tùy chọn] tệp

MÔ TẢ

mpv là một trình phát đa phương tiện dựa trên MPlayer và mplayer2. Nó hỗ trợ nhiều loại video
các định dạng tệp, codec âm thanh và video, và các loại phụ đề. Các loại URL đầu vào đặc biệt là
có sẵn để đọc đầu vào từ nhiều nguồn khác nhau ngoài tệp đĩa. Phụ thuộc vào
nền tảng, một loạt các phương pháp đầu ra video và âm thanh khác nhau được hỗ trợ.

Các ví dụ sử dụng để giúp bạn bắt đầu nhanh chóng có thể được tìm thấy ở cuối trang nam này.

TƯƠNG TÁC KIỂM SOÁT

mpv có một lớp điều khiển theo lệnh, có thể định cấu hình đầy đủ cho phép bạn điều khiển mpv
sử dụng bàn phím, chuột hoặc điều khiển từ xa (không có hỗ trợ LIRC - định cấu hình điều khiển từ xa như
thiết bị đầu vào thay thế).

Xem --đầu vào- các tùy chọn về cách tùy chỉnh nó.

Bàn phím Kiểm soát
LEFT và QUYỀN
Tìm kiếm lùi / tiến 5 giây. Shift + mũi tên thực hiện tìm kiếm chính xác trong 1 giây (xem
--giờ-tìm kiếm).

UP và Down
Tìm kiếm tiến / lùi 1 phút. Shift + mũi tên thực hiện tìm kiếm chính xác 5 giây (xem
--giờ-tìm kiếm).

Ctrl + TRÁI và Ctrl + PHẢI
Tìm kiếm phụ đề trước đó / tiếp theo. Tuân theo một số hạn chế và có thể không hoạt động
luôn; Thấy chưa tìm kiếm phụ chỉ huy.

[ và ]
Giảm / tăng 10% tốc độ phát lại hiện tại.

{ và }
Giảm một nửa / gấp đôi tốc độ phát lại hiện tại.

QUAY LẠI
Đặt lại tốc độ phát lại bình thường.

< và >
Đi lùi / tiến trong danh sách phát.

ENTER Tiếp tục trong danh sách phát.

p / SPACE
Tạm dừng (nhấn lại để bỏ tạm dừng).

. Bước tới. Nhấn một lần sẽ tạm dừng, mỗi lần nhấn liên tiếp sẽ phát một khung hình
và sau đó chuyển sang chế độ tạm dừng một lần nữa.

, Bước giật lùi. Nhấn một lần sẽ tạm dừng, mỗi lần nhấn liên tiếp sẽ phát một
ngược lại khung và sau đó chuyển sang chế độ tạm dừng một lần nữa.

q Ngừng chơi và bỏ cuộc.

Q Như q, nhưng lưu trữ vị trí phát lại hiện tại. Chơi cùng một tệp sau đó sẽ
tiếp tục ở vị trí phát lại cũ nếu có thể.

/ và *
Giảm / tăng âm lượng.

9 và 0
Giảm / tăng âm lượng.

m Âm thanh câm.

_ Lướt qua các đoạn video có sẵn.

# Lướt qua các bản âm thanh có sẵn.

f Chuyển đổi toàn màn hình (xem thêm --fs).

ESC Thoát khỏi chế độ toàn màn hình.

T Chuyển đổi chế độ luôn cập nhật (xem thêm --trên đỉnh).

w và e
Giảm / tăng phạm vi quét và quét.

o (cũng thế P)
Hiển thị thanh tiến trình, thời gian đã trôi qua và tổng thời lượng trên OSD.

O Chuyển đổi trạng thái OSD giữa bình thường và thời gian / thời lượng phát lại.

v Chuyển đổi chế độ hiển thị phụ đề.

j và J
Lướt qua các phụ đề có sẵn.

x và z
Điều chỉnh độ trễ của phụ đề thêm +/- 0.1 giây.

l Đặt / xóa các điểm vòng AB. Nhìn thấy vòng lặp ab lệnh để biết chi tiết.

L Chuyển đổi vòng lặp vô hạn.

Ctrl + và Ctrl -
Điều chỉnh độ trễ âm thanh thêm +/- 0.1 giây.

u Chuyển đổi giữa áp dụng ghi đè không có kiểu sang phụ đề SSA / ASS và ghi đè
chúng gần như hoàn toàn với kiểu phụ đề bình thường. Nhìn thấy --ass-style-ghi đè cho
thêm thông tin.

V Chuyển đổi chế độ tương thích khía cạnh VSFilter phụ đề. Nhìn thấy
--ass-vsfilter-khía cạnh-compat để biết thêm chi tiết.

r và t
Di chuyển phụ đề lên / xuống.

s Chụp màn hình.

S Chụp ảnh màn hình, không có phụ đề. (Điều này có hoạt động hay không phụ thuộc vào trình điều khiển VO
ủng hộ.)

Ctrl s Chụp ảnh màn hình, khi cửa sổ hiển thị nó (với phụ đề, OSD và video được chia tỷ lệ).

I Hiển thị tên tệp trên OSD.

PGUP và PGDWN
Tìm kiếm phần đầu của chương trước / sau. Trong hầu hết các trường hợp, "trước đó" sẽ
thực sự đi đến đầu chương hiện tại; Thấy chưa --chương-tìm-ngưỡng.

Shift + PGUP và Shift + PGDWN
Tua lùi hoặc tua đi 10 phút. (Điều này từng được ánh xạ tới PGUP / PGDWN
không có Shift.)

d Kích hoạt / hủy kích hoạt deinterlacer.

A Ghi đè tỷ lệ khung hình chu kỳ.

(Các phím sau chỉ hợp lệ khi sử dụng đầu ra video hỗ trợ
điều chỉnh tương ứng hoặc bộ cân bằng phần mềm (--vf = eq).)

1 và 2
Điều chỉnh độ tương phản.

3 và 4
Tùy chỉnh độ sáng.

5 và 6
Điều chỉnh gamma.

7 và 8
Điều chỉnh độ bão hòa.

Alt + 0 (Và lệnh + 0 on OSX)
Thay đổi kích thước cửa sổ video thành một nửa kích thước ban đầu.

Alt + 1 (Và lệnh + 1 on OSX)
Thay đổi kích thước cửa sổ video về kích thước ban đầu.

Alt + 2 (Và lệnh + 2 on OSX)
Thay đổi kích thước cửa sổ video để tăng gấp đôi kích thước ban đầu của nó.

lệnh + f (OSX chỉ)
Chuyển đổi toàn màn hình (xem thêm --fs).

lệnh + [ và lệnh + ] (OSX chỉ)
Đặt alpha cửa sổ video.

(Các phím sau sẽ hợp lệ nếu bạn có bàn phím với các phím đa phương tiện.)

PAUSE Tạm ngừng.

DỪNG Ngừng chơi và bỏ cuộc.

PREVIOUS và NEXT
Tìm kiếm lùi / tiến 1 phút.

(Các phím sau chỉ hợp lệ nếu bạn được biên dịch với hỗ trợ đầu vào TV hoặc DVB.)

h và k
Chọn kênh trước đó / tiếp theo.

Chuột Kiểm soát
nút 3 và nút 4
Tìm kiếm lùi / tiến 1 phút.

nút 5 và nút 6
Giảm / tăng âm lượng.

SỬ DỤNG

Mỗi cờ tùy chọn có một không có cờ đối lập, ví dụ đối lập với --fs Tùy chọn là
--no-fs. --fs = vâng giống như --fs, --fs = không giống như --no-fs.

Nếu một tùy chọn được đánh dấu là (XXX chỉ), nó sẽ chỉ hoạt động kết hợp với XXX tùy chọn
hoặc nếu XXX được biên dịch trong.

Thoát không gian và Khác đặc biệt nhân vật
Hãy nhớ rằng shell sẽ phân tích cú pháp một phần và xử lý các đối số mà bạn chuyển đến mpv.
Ví dụ: bạn có thể cần phải trích dẫn hoặc thoát các tùy chọn và tên tệp:
mpv "tên tệp với dấu cách.mkv " --title = "cửa sổ chức vụ"

Nó trở nên phức tạp hơn nếu có sự tham gia của trình phân tích cú pháp phụ đề. Trình phân tích cú pháp phụ đề đặt
một số tùy chọn thành một chuỗi và chuyển chúng đến một thành phần cùng một lúc, thay vì
sử dụng nhiều tùy chọn ở cấp độ của dòng lệnh.

Trình phân tích cú pháp phụ đề có thể trích dẫn các chuỗi với " và [...]. Ngoài ra, có một
hình thức trích dẫn với %N% được mô tả dưới đây.

Ví dụ, các OpenGL VO có thể có nhiều tùy chọn:
mpv kiểm tra.mkv --vo = opengl: scale = lanczos: icc-profile = file.icc, xv

Điều này vượt qua scale = lanczos và icc-profile = file.icc đến OpenGL, và cũng chỉ định xv as
dự phòng VO. Nếu đường dẫn hồ sơ icc chứa khoảng trắng hoặc các ký tự như , or :, bạn cần
để trích dẫn chúng:
mpv '--vo = opengl: icc-profile = "tệp với dấu cách.icc ", xv '

Vỏ thực sự có thể loại bỏ một số dấu ngoặc kép từ chuỗi được chuyển đến dòng lệnh, vì vậy
ví dụ trích dẫn chuỗi hai lần, đảm bảo rằng mpv nhận được " trích dẫn.

[...] hình thức của dấu ngoặc kép bao bọc mọi thứ giữa [ và ]. Nó hữu ích với các shell
không diễn giải các ký tự này ở giữa một đối số (như bash). Những câu trích dẫn này
được cân bằng (kể từ mpv 0.9.0): [ và ] lồng vào nhau, và câu trích dẫn kết thúc vào cuối cùng ]
điều đó không phù hợp [ trong chuỗi. (Ví dụ, [a [b] c] kết quả trong a [b] c.)

Cú pháp trích dẫn có độ dài cố định được thiết kế để sử dụng với các tập lệnh và chương trình bên ngoài.

Nó được bắt đầu với % và có định dạng sau:

% n% string_of_length_n

Các ví dụ

mpv --ao = pcm: file =% 10% C: test.wav thử nghiệm.avi

Hoặc trong một tập lệnh:

mpv --ao = pcm: file =% `expr chiều dài "$ NAME" `%" $ NAME " thử nghiệm.avi

Các tiểu mục được chuyển đến API ứng dụng khách cũng có thể thoát. Sử dụng
mpv_set_option_string () giống hệt như đi qua --name = data vào dòng lệnh (nhưng
mà không cần xử lý shell của chuỗi). Một số tùy chọn hỗ trợ chuyển các giá trị trong một
theo cách có cấu trúc thay vì chuỗi phẳng và có thể tránh được sự lộn xộn khi phân tích cú pháp phụ đề. Vì
thí dụ, --vf hỗ trợ MPV_FORMAT_NODE, cho phép bạn chuyển các phân mục con dưới dạng dữ liệu lồng nhau
cấu trúc của bản đồ và mảng. (--vo hỗ trợ điều này theo cách tương tự, mặc dù thực tế này là
không có giấy tờ.)

Đường dẫn
Cần phải cẩn thận một số khi chuyển các đường dẫn và tên tệp tùy ý sang mpv. Ví dụ,
con đường bắt đầu với - sẽ được hiểu là các tùy chọn. Tương tự như vậy, nếu một đường dẫn chứa
trình tự :/ /, chuỗi trước đó có thể được hiểu là tiền tố giao thức, mặc dù
:/ / có thể là một phần của đường dẫn UNIX hợp pháp. Để tránh các vấn đề với các đường dẫn tùy ý, bạn nên
đảm bảo rằng các đường dẫn tuyệt đối được chuyển đến mpv bắt đầu bằng /và các đường dẫn tương đối với ./.

Tên - bản thân nó được hiểu là stdin và sẽ khiến mpv vô hiệu hóa các điều khiển của bảng điều khiển.
(Điều này làm cho nó phù hợp để phát dữ liệu được chuyển sang stdin.)

Đối với các đường dẫn được chuyển đến các tiểu mục, tình hình còn phức tạp hơn do cần phải thoát ra
ký tự đặc biệt. Để giải quyết vấn đề này, đường dẫn có thể được bao bọc thêm trong
cú pháp có độ dài cố định, ví dụ: % n% string_of_length_n (xem ở trên).

Một số tùy chọn mpv diễn giải các đường dẫn bắt đầu bằng ~. Hiện tại, tiền tố ~~ / mở rộng đến
thư mục cấu hình mpv (thường là ~ / .config / mpv /). ~/ mở rộng đến nhà của người dùng
danh mục. (Dấu vết / luôn luôn bắt buộc.) Cũng có các đường dẫn sau:

┌──────────────┬────────────────────────────────────┐
│Tên │ Ý nghĩa │
└──────────────┴────────────────────────────────────┘

│~~ nha / Tôi giống như ~~ / │
├──────────────┼────────────────────────────────────┤
│~~ toàn cầu / │ đường dẫn cấu hình chung, nếu │
│ │ có sẵn (không có trên win32) │
├──────────────┼────────────────────────────────────┤
│~~ osxbundle / │ đường dẫn tài nguyên gói OSX │
│ │ (chỉ OSX) │
├──────────────┼────────────────────────────────────┤
│~~ máy tính để bàn / │ đường dẫn đến màn hình (win32, │
│ │OSX) │
└──────────────┴────────────────────────────────────┘

Mỗi tệp Các lựa chọn
Khi phát nhiều tệp, bất kỳ tùy chọn nào được đưa ra trên dòng lệnh thường ảnh hưởng đến tất cả
các tập tin. Thí dụ:

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

┌───────────┬─────────────────┐
│Tập tin │ Tùy chọn hoạt động │
├───────────┼─────────────────┤
│file1.mkv │ --một --NS --NS │
├───────────┼─────────────────┤
│file2.mkv │ --một --NS --NS │
└───────────┴─────────────────┘

(Điều này khác với MPlayer và mplayer2.)

Ngoài ra, nếu bất kỳ tùy chọn nào được thay đổi trong thời gian chạy (thông qua các lệnh đầu vào), chúng sẽ không được đặt lại khi
tệp mới được phát.

Đôi khi, rất hữu ích khi thay đổi các tùy chọn trên mỗi tệp. Điều này có thể đạt được bằng cách thêm
các điểm đánh dấu đặc biệt cho mỗi tệp - { và -}. (Lưu ý rằng bạn phải thoát chúng trên một số shell.)
Ví dụ:

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

┌───────────┬────────────────────
│Tập tin │ Tùy chọn hoạt động │
├───────────┼─────────────────────
│file1.mkv │ --một --NS --NS │
├───────────┼─────────────────────
│file2.mkv │ --một --NS --NS --NS --NS - │
├───────────┼─────────────────────
│file3.mkv │ --một --NS --NS --NS --NS - │
├───────────┼─────────────────────
│file4.mkv │ --một --NS --NS │
└───────────┴─────────────────────

Ngoài ra, bất kỳ tùy chọn cục bộ tệp nào đã thay đổi trong thời gian chạy sẽ được đặt lại khi tệp hiện tại
ngừng chơi. Nếu tùy chọn --NS được thay đổi trong quá trình phát lại tập tin2.mkv, nó được đặt lại khi
tiến tới tập tin3.mkv. Điều này chỉ ảnh hưởng đến các tùy chọn cục bộ tệp. Các tùy chọn --một không bao giờ
đặt lại ở đây.

CẤU HÌNH CÁC TẬP TIN

Địa điểm và cú pháp
Bạn có thể đặt tất cả các tùy chọn trong các tệp cấu hình sẽ được đọc mỗi khi mpv
chạy. Tệp cấu hình toàn hệ thống 'mpv.conf' nằm trong thư mục cấu hình của bạn
(ví dụ / etc / mpv or / usr / local / etc / mpv), người dùng cụ thể là ~ / .config / mpv / mpv.conf.
Để biết chi tiết và thông tin cụ thể về nền tảng (trong các đường dẫn Windows cụ thể), hãy xem CÁC TẬP TIN phần.

Các tùy chọn dành riêng cho người dùng ghi đè các tùy chọn trên toàn hệ thống và các tùy chọn được cung cấp trên dòng lệnh
ghi đè một trong hai. Cú pháp của các tệp cấu hình là option = giá trị. Mọi thứ sau một
# được coi là một bình luận. Các tùy chọn hoạt động mà không có giá trị có thể được bật bằng cách đặt chúng
đến Vâng và bị vô hiệu hóa bằng cách đặt chúng thành Không. Ngay cả các tiểu mục cũng có thể được chỉ định theo cách này.

Tệp cấu hình mẫu

# Sử dụng đầu ra video opengl theo mặc định.
vo = opengl
# Sử dụng dấu ngoặc kép cho văn bản có thể chứa khoảng trắng:
status-msg = "Thời gian: $ {time-pos}"

Thoát không gian và đặc biệt nhân vật
Điều này được thực hiện giống như với các tùy chọn dòng lệnh. Vỏ không liên quan ở đây, nhưng tùy chọn
các giá trị vẫn cần được trích dẫn tổng thể nếu nó chứa các ký tự nhất định như dấu cách. MỘT
mục nhập cấu hình có thể được trích dẫn bằng ", cũng như với cú pháp có độ dài cố định (%N%) đề cập
trước. Điều này giống như chuyển nội dung chính xác của chuỗi được trích dẫn dưới dạng dòng lệnh
lựa chọn. Các lối thoát kiểu C hiện được _not_ giải thích ở cấp độ này, mặc dù một số
tùy chọn làm điều này theo cách thủ công. (Đây là một mớ hỗn độn và có lẽ nên được thay đổi vào một lúc nào đó.)

Đặt Lệnh Dòng Các lựa chọn trong các Cấu hình Tập tin
Hầu hết tất cả các tùy chọn dòng lệnh đều có thể được đưa vào tệp cấu hình. Đây là một nhỏ
hướng dẫn:

┌────────────────────
│ Tùy chọn │ Mục nhập tệp cấu hình │
├────────────────────
│--lá cờ │ cờ │
├────────────────────
│-opt val │ opt = val │
├────────────────────
│--opt = val │ opt = val │
├────────────────────
│-opt "có dấu cách " │ opt = "có dấu cách " │
└────────────────────

Tập tin cụ thể Cấu hình Các Tập Tin
Bạn cũng có thể ghi các tệp cấu hình dành riêng cho tệp. Nếu bạn muốn có một cấu hình
tệp cho tệp có tên 'video.avi', tạo tệp có tên 'video.avi.conf' với
tùy chọn tệp cụ thể trong đó và đặt nó vào ~ / .config / mpv /. Bạn cũng có thể đặt
tệp cấu hình trong cùng thư mục với tệp sẽ phát. Cả hai đều yêu cầu bạn thiết lập
các - sử dụng hồ sơ tùy chọn (trên dòng lệnh hoặc trong tệp cấu hình chung của bạn).
Nếu một tệp cấu hình dành riêng cho tệp được tìm thấy trong cùng một thư mục, không có tệp cụ thể
cấu hình được tải từ ~ / .config / mpv. Ngoài ra, - sử dụng hồ sơ tùy chọn
cho phép các tệp cấu hình dành riêng cho thư mục. Đối với điều này, trước tiên mpv cố gắng tải một
mpv.conf từ cùng thư mục với tệp được phát và sau đó cố gắng tải bất kỳ
cấu hình tệp cụ thể.

Profiles
Để dễ dàng làm việc với các cấu hình khác nhau, cấu hình có thể được xác định trong
các tệp cấu hình. Một cấu hình bắt đầu bằng tên của nó trong dấu ngoặc vuông, ví dụ: [thông tin của tôi].
Tất cả các tùy chọn sau đây sẽ là một phần của hồ sơ. Mô tả (được hiển thị bởi --profile = trợ giúp)
có thể được định nghĩa với hồ sơ-desc lựa chọn. Để kết thúc hồ sơ, hãy bắt đầu một hồ sơ khác hoặc sử dụng
tên hồ sơ mặc định để tiếp tục với các tùy chọn bình thường.

Tệp cấu hình mpv mẫu có cấu hình

# tùy chọn cấp cao nhất bình thường
toàn màn hình = vâng

# một cấu hình có thể được bật bằng --profile = big-cache
[bộ nhớ đệm lớn]
cache = 123400
demuxer-readahead-secs = 20

[chậm]
profile-desc = "một số tên hồ sơ"
vo = opengl: scale = ewa_lanczos: scale-radius = 16

[Nhanh]
vo = vdpau

# sử dụng lại cấu hình sẽ mở rộng nó
[chậm]
framedrop = không
# bạn cũng có thể bao gồm các cấu hình khác
profile = big-cache

Tự động hồ sơ
Một số cấu hình được tải tự động. Ví dụ sau minh họa điều này:

Tự động tải hồ sơ

[vo.vdpau]
# Sử dụng giải mã phần cứng
hwdec = vdpau

[giao thức.dvd]
profile-desc = "hồ sơ cho dvd: // stream"
alang = vi

[phần mở rộng.flv]
profile-desc = "hồ sơ cho các tệp .flv"
vf = lật

[ao.alsa]
device = spdif

Tên hồ sơ theo sau giản đồ tên loại, loại có thể được vo để khớp với giá trị
--vo tùy chọn được đặt thành, ao cho --ao, giao thức cho giao thức đầu vào / đầu ra đang được sử dụng (xem
- giao thức danh sách), Và mở rộng cho phần mở rộng của đường dẫn hiện đang phát
tập tin (không định dạng tệp).

Tính năng này rất hạn chế và không có cấu hình tự động nào khác.

ĐANG LẤY MÀN HÌNH

Ảnh chụp màn hình của tệp hiện đang phát có thể được chụp bằng chế độ nhập 'ảnh chụp màn hình'
, theo mặc định được liên kết với s Chìa khóa. Tệp có tên bắnNNNN.jpg sẽ được lưu trong
thư mục làm việc, sử dụng số có sẵn đầu tiên - không có tệp nào sẽ bị ghi đè.

Ảnh chụp màn hình thường sẽ chứa nội dung video chưa được phân tỷ lệ ở cuối video
chuỗi bộ lọc và phụ đề. Theo mặc định, S chụp ảnh màn hình mà không có phụ đề, trong khi s
bao gồm phụ đề.

Không giống như với MPlayer, ảnh chụp màn hình bộ lọc video là không cần thiết. Bộ lọc này chưa bao giờ
yêu cầu trong mpv và đã bị xóa.

TERMINAL TÌNH TRẠNG ĐƯỜNG DÂY

Trong khi phát lại, mpv hiển thị trạng thái phát lại trên thiết bị đầu cuối. Nó trông giống như một cái gì đó
như thế này:
CỦA: 00:03:12 / 00:24:25 (% 13) AV: -0.000

Dòng trạng thái có thể được ghi đè bằng --term-status-msg tùy chọn.

Sau đây là danh sách những thứ có thể hiển thị trong dòng trạng thái. Thuộc tính đầu vào,
có thể được sử dụng để lấy cùng một thông tin theo cách thủ công, cũng được liệt kê.

· CỦA: or V: (chỉ video) hoặc A: (chỉ có âm thanh)

· Vị trí thời gian hiện tại ở HH: MM: SS định dạng (thời gian phát lại bất động sản)

· Tổng thời lượng tệp (vắng mặt nếu không xác định) (chiều dài bất động sản)

· Tốc độ phát lại, ví dụ: `` x2.0 ''. Chỉ hiển thị nếu tốc độ không bình thường. Đây là
tốc độ do người dùng yêu cầu chứ không phải tốc độ thực tế (thường thì chúng phải giống nhau, trừ khi
phát lại quá chậm). (tốc độ bất động sản.)

· Tỷ lệ phần trăm phát lại, ví dụ: (% 13). Bao nhiêu tệp đã được phát. Thông thường
được tính từ vị trí và thời lượng phát lại, nhưng có thể dự phòng cho các phương pháp khác
(như vị trí byte) nếu chúng không có sẵn. (phần trăm-pos bất động sản.)

· Đồng bộ hóa âm thanh / video như AV: 0.000. Đây là sự khác biệt giữa âm thanh và video
thời gian. Thông thường, nó phải bằng 0 hoặc gần bằng 0. Nếu nó đang phát triển, nó có thể cho biết
sự cố phát lại. (avsync bất động sản.)

· Tổng số thay đổi đồng bộ A / V, ví dụ: ct: -0.417. Bình thường vô hình. Có thể hiển thị nếu có
âm thanh bị "thiếu", hoặc không đủ khung hình có thể bị loại bỏ. Thông thường, điều này sẽ chỉ ra một
vấn đề. (thay đổi toàn bộ avsync bất động sản.)

· Trạng thái mã hóa trong {...}, chỉ hiển thị trong chế độ mã hóa.

· Hiển thị trạng thái đồng bộ. Nếu đồng bộ hóa hiển thị đang hoạt động (hiển thị-đồng bộ hóa-hoạt động tài sản), điều này cho thấy
DS: 2.500/13, trong đó số đầu tiên là số vsync trung bình trên mỗi khung hình video (ví dụ:
2.5 khi phát video 24Hz trên màn hình 60Hz), có thể bị rung nếu tỷ lệ không
làm tròn, hoặc có khung bị sai lệch (tỷ lệ vsync), và số thứ hai trong số
số lượng vsync ước tính mất quá nhiều thời gian (vo-delay-frame-count bất động sản). Các
sau là một phương pháp heuristic, vì thường không thể xác định điều này một cách chắc chắn.

· Khung hình bị rơi, ví dụ: Giảm: 4. Chỉ hiển thị nếu số lượng không phải là 0. Có thể phát triển nếu
tốc độ khung hình video cao hơn tốc độ khung hình của màn hình hoặc nếu kết xuất video quá chậm.
Cũng có thể được tăng lên khi "nấc" và khi không thể hiển thị khung video
thời gian. (vo-drop-frame-count thuộc tính.) Nếu bộ giải mã giảm khung hình, số lượng
Các khung hình được thả xuống của bộ giải mã cũng được thêm vào màn hình, ví dụ: Giảm: 4/34. Điều này
chỉ xảy ra nếu giảm khung bộ giải mã được bật với --framedrop tùy chọn.
(đếm khung hình bất động sản.)

· Trạng thái bộ nhớ cache, ví dụ: Bộ nhớ cache: 2 giây + 134KB. Hiển thị nếu bộ đệm ẩn luồng được bật. Người đầu tiên
giá trị hiển thị lượng video được lưu vào bộ đệm trong trình giải mã tính bằng giây, giá trị thứ hai
chương trình bổ sung dữ liệu được lưu vào bộ đệm trong luồng tính bằng kilobyte. (demuxer-cache-thời lượng
và được sử dụng trong bộ nhớ cache tính chất.)

BẢO VỆ

http://..., https://, ...
Nhiều giao thức mạng được hỗ trợ, nhưng tiền tố giao thức phải luôn
được chỉ định. mpv sẽ không bao giờ cố đoán xem tên tệp có thực sự là một mạng hay không
địa chỉ. Tiền tố giao thức luôn được yêu cầu.

Lưu ý rằng không phải tất cả các tiền tố đều được ghi lại ở đây. Các tiền tố không có giấy tờ là
bí danh cho các giao thức được tài liệu hóa hoặc chỉ là chuyển hướng đến các giao thức được triển khai
và được ghi lại trong FFmpeg.

- Phát dữ liệu từ stdin.

smb: // PATH
Chơi một đường dẫn từ chia sẻ Samba.

bd: // [title] [/ device] --bluray-device = PATH
Phát đĩa Blu-Ray. Hiện tại, điều này không chấp nhận tệp ISO. Thay vào đó, bạn phải
mount tệp ISO dưới dạng hệ thống tệp và trỏ --bluray-thiết bị gắn kết
thư mục trực tiếp.

dvd: // [title | [starttitle] -endtitle] [/ device] --dvd-device = PATH
Phát một đĩa DVD. Các menu DVD không được hỗ trợ. Nếu không có tiêu đề nào được đưa ra, thì tiêu đề dài nhất là
tự động chọn.

dvdnav: // là một bí danh cũ cho đĩa DVD:// và làm chính xác những điều tương tự.

dvdread: // ...:
Phát DVD bằng mã libdvdread cũ. Đây là MPlayer và mpv cũ hơn
phiên bản sử dụng cho đĩa DVD://. Không khuyến khích sử dụng. Nó chỉ được cung cấp để tương thích
và để chuyển đổi.

tv: // [kênh] [/ input_id] --TV-...
Truyền hình tương tự qua V4L. Cũng hữu ích cho webcam. (Chỉ dành cho Linux.)

pvr: // --pvr -...
PVR. (Chỉ dành cho Linux.)

dvb: // [cardnumber @] kênh --dvbin -...
Truyền hình kỹ thuật số qua DVB. (Chỉ dành cho Linux.)

mf: // [filemask | @listfile] --mf -...
Phát một loạt hình ảnh dưới dạng video.

cdda: // track [-endtrack] [: speed] [/ device] --cdrom-device = PATH --cdda -...
Phát CD.

lavf: // ...
Truy cập bất kỳ giao thức libavformat FFmpeg / Libav nào. Về cơ bản, điều này thông qua chuỗi
sau // trực tiếp tới libavformat.

av: // type: options
Điều này nhằm mục đích sử dụng đầu vào libavdevice. kiểu là trình giải mã libavdevice
tên và lựa chọn là tên tập tin (pseudo-) được truyền cho demuxer.

Ví dụ, mpv av: // lavfi: mandelbrot sử dụng trình bao bọc libavfilter
được bao gồm trong libavdevice và sẽ sử dụng mandelbrot bộ lọc nguồn để tạo
dữ liệu đầu vào.

avdevice: // là một bí danh.

đường dẫn tập tin
Đường dẫn cục bộ dưới dạng URL. Có thể hữu ích trong một số trường hợp sử dụng đặc biệt. Lưu ý rằng PATH
bản thân nó nên bắt đầu bằng một phần ba / để làm cho đường dẫn trở thành đường dẫn tuyệt đối.

fd: // 123
Đọc dữ liệu từ UNIX FD đã cho (ví dụ 123). Điều này tương tự với dữ liệu đường ống
stdin qua -, nhưng có thể sử dụng bộ mô tả tệp tùy ý. Sẽ không hoạt động chính xác
trên MS Windows.

edl: // [edl đặc điểm kỹ thuật as in edl-mpv.rst]
Ghép các phần của nhiều tệp lại với nhau và phát chúng.

vô giá trị://
Mô phỏng một tệp trống.

memory: // data
Sử dụng dữ liệu một phần như dữ liệu nguồn.

giả GUI PHƯƠNG THỨC

mpv không có GUI chính thức, ngoài OSC (ON MÀN CONTROLLER), không phải là một
GUI và không có nghĩa là như vậy. Tuy nhiên, để bù đắp cho việc thiếu hành vi GUI mong đợi,
mpv trong một số trường hợp sẽ bắt đầu với một số cài đặt được thay đổi để hoạt động giống GUI hơn một chút
chế độ.

Hiện tại, điều này chỉ xảy ra trong các trường hợp sau:

· Nếu bắt đầu sử dụng mpv.desktop tệp trên Linux (ví dụ: bắt đầu từ menu hoặc tệp
các liên kết do môi trường máy tính để bàn cung cấp)

· Nếu bắt đầu từ explorer.exe trên Windows (về mặt kỹ thuật, nếu nó được khởi động trên Windows, và
tất cả các chốt điều khiển stdout / stderr / stdin đều chưa được đặt)

· Thêm thủ công --profile = pseudo-gui đến dòng lệnh

Chế độ này hoàn toàn thêm vào --profile = pseudo-gui vào dòng lệnh, với giả gui
hồ sơ được xác định trước với các nội dung sau:

[giả gui]
terminal = không
force-window = vâng
nhàn rỗi = một lần
screenshot-thư mục = ~~ desktop /

Điều này tuân theo định dạng tệp cấu hình mpv. Để tùy chỉnh chế độ GUI giả, bạn có thể đặt
riêng giả gui hồ sơ của bạn mpv.conf. Cấu hình này sẽ nâng cao cấu hình mặc định,
hơn là ghi đè lên nó.

Hồ sơ luôn ghi đè các cài đặt khác trong mpv.conf.

LỰA CHỌN

Theo dõi Lựa chọn
--alang =
Chỉ định danh sách ưu tiên của các ngôn ngữ âm thanh để sử dụng. Các định dạng vùng chứa khác nhau
sử dụng các mã ngôn ngữ khác nhau. DVD sử dụng mã ngôn ngữ hai chữ cái ISO 639-1,
Matroska, MPEG-TS và NUT sử dụng mã ngôn ngữ ba chữ cái ISO 639-2, trong khi OGM sử dụng
một mã định danh dạng tự do. Xem thêm --sự giúp đỡ.

Các ví dụ

mpv dvd: // 1 --alang = hu, vi
Chọn bài hát tiếng Hungary trên DVD và quay lại tiếng Anh
nếu tiếng Hungary không có sẵn.

mpv --alang = jpn ví dụ.mkv
Phát tệp Matroska bằng tiếng Nhật.

--slang =
Chỉ định danh sách ưu tiên các ngôn ngữ phụ đề để sử dụng. Các định dạng vùng chứa khác nhau
sử dụng các mã ngôn ngữ khác nhau. DVD sử dụng mã ngôn ngữ hai chữ cái ISO 639-1,
Matroska sử dụng mã ngôn ngữ ba chữ cái ISO 639-2 trong khi OGM sử dụng biểu mẫu tự do
định danh. Xem thêm --sid.

Các ví dụ

· mpv dvd: // 1 --slang = hu, vi chọn phụ đề tiếng Hungary trên DVD và
trở lại tiếng Anh nếu tiếng Hungary không có sẵn.

· mpv --slang = jpn ví dụ.mkv phát tệp Matroska có phụ đề tiếng Nhật.

- đã nói =
Chọn bản âm thanh. tự động chọn mặc định, Không tắt âm thanh. Xem thêm --alang.
mpv thường in các bản âm thanh có sẵn trên thiết bị đầu cuối khi bắt đầu phát lại
của một tệp.

--sid =
Hiển thị luồng phụ đề được chỉ định bởi . tự động chọn mặc định, Không
tắt phụ đề.

Xem thêm --tiếng lóng, --no-sub.

--vid =
Chọn kênh video. tự động chọn mặc định, Không tắt video.

--ff-aid = , --ff-sid = , --ff-vid =
Chọn luồng âm thanh / phụ đề / video theo chỉ mục luồng FFmpeg. Luồng FFmpeg
chỉ mục tương đối tùy ý, nhưng hữu ích khi tương tác với phần mềm khác
sử dụng FFmpeg (xem xét ffprobe).

Lưu ý rằng với các bản nhạc bên ngoài (được thêm vào - tệp phụ và các tùy chọn tương tự), ở đó
sẽ là các luồng có ID trùng lặp. Trong trường hợp này, luồng đầu tiên theo thứ tự là
đã chọn.

--edition =
(Chỉ dành cho tệp Matroska) Chỉ định phiên bản (tập hợp các chương) để sử dụng, trong đó 0 là
đầu tiên. Nếu được đặt thành tự động (mặc định), mpv sẽ chọn ấn bản đầu tiên được khai báo là
một mặc định, hoặc nếu không có mặc định, thì ấn bản đầu tiên được xác định.

Phát lại Kiểm soát
--start = thời gian>
Tìm kiếm vị trí thời gian nhất định.

Định dạng chung cho thời gian tuyệt đối là [[hh:] mm:] ss [.ms]. Nếu thời gian được cho
với tiền tố là + or -, tìm kiếm là tương đối từ đầu hoặc cuối của tệp.
(Vì mpv 0.14, phần đầu của tệp luôn được coi là 0)

trang% tìm kiếm vị trí phần trăm pp (0-100).

#c tìm kiếm số chương c. (Các chương bắt đầu từ 1.)

Các ví dụ

--start = + 56, --start = + 00: 56
Tìm kiếm thời gian bắt đầu + 56 giây.

--start = -56, --start = -00: 56
Tìm kiếm thời gian kết thúc - 56 giây.

--start = 01: 10: 00
Tìm kiếm đến 1 giờ 10 phút.

--start = 50%
Tìm kiếm giữa tệp.

--start = 30 --end = 40
Tìm đến 30 giây, phát 10 giây và thoát.

--start = -3: 20 --length = 10
Tìm kiếm 3 phút 20 giây trước khi kết thúc tệp, phát 10
giây và thoát.

--start = '# 2' --end = '# 4'
Phát chương 2 và 3 và thoát.

--end =
Dừng lại ở thời gian tuyệt đối nhất định. Sử dụng --chiều dài nếu thời gian phải liên quan đến
--bắt đầu. Thấy --bắt đầu cho các giá trị tùy chọn hợp lệ và các ví dụ.

--length = thời gian>
Dừng lại sau một thời gian nhất định so với thời gian bắt đầu. Nhìn thấy --bắt đầu cho tùy chọn hợp lệ
giá trị và ví dụ.

--rebase-start-time =
Có di chuyển thời gian bắt đầu tệp sang 00:00:00 (mặc định: có). Điều này ít hơn
khó xử đối với các tệp bắt đầu ở dấu thời gian ngẫu nhiên, chẳng hạn như luồng truyền tải. Trên
mặt khác, nếu có đặt lại dấu thời gian, hành vi kết quả có thể là
kỳ dị. Vì lý do này, và trong trường hợp bạn thực sự quan tâm đến
dấu thời gian, hành vi này có thể bị vô hiệu hóa với Không.

--speed = <0.01-100>
Làm chậm hoặc tăng tốc độ phát lại bằng hệ số được cho dưới dạng tham số.

If - âm thanh-cao độ-chỉnh sửa (bật theo mặc định) được sử dụng, phát với tốc độ cao hơn
hơn bình thường tự động chèn nhịp độ bộ lọc âm thanh.

--loop =
Phát lại vòng lặp N lần. Một giá trị của 1 phát nó một lần (mặc định), 2 hai lần, v.v.
inf có nghĩa là mãi mãi. Không giống như 1 và vô hiệu hóa vòng lặp. Nếu một số tệp
được chỉ định trên dòng lệnh, toàn bộ danh sách phát được lặp lại.

lực lượng chế độ giống như inf, nhưng không bỏ qua các mục nhập danh sách phát đã được
được đánh dấu là không thành công. Điều này có nghĩa là người chơi có thể lãng phí thời gian của CPU khi cố gắng lặp lại một tệp
điều đó không tồn tại. Nhưng nó có thể hữu ích khi chơi các webradios dưới chế độ rất tệ
điều kiện mạng.

--tạm ngừng
Khởi động trình phát ở trạng thái tạm dừng.

--luffle
Phát các tệp theo thứ tự ngẫu nhiên.

--chapter =
Chỉ định chương sẽ bắt đầu phát. Tùy ý chỉ định chương nào sẽ kết thúc
chơi tại. Cũng thấy --bắt đầu.

--playlist-pos =
Đặt tệp trong danh sách phát nội bộ để bắt đầu phát lại. Chỉ số là một
số nguyên, với 0 nghĩa là tệp đầu tiên. Giá trị Không có nghĩa là việc lựa chọn
mục để phát được để lại cho cơ chế tiếp tục phát lại (mặc định). Nếu một mục nhập
với chỉ mục đã cho không tồn tại, hành vi không được xác định và có thể thay đổi trong
phiên bản mpv trong tương lai. Điều tương tự cũng áp dụng nếu danh sách phát có các danh sách phát khác
(không mong đợi bất kỳ hành vi hợp lý nào). Chuyển tệp danh sách phát tới mpv sẽ hoạt động
với tùy chọn này, mặc dù. Ví dụ mpv danh sách phát.m3u --playlist-pos = 123 sẽ hoạt động như
mong đợi, miễn là danh sách phát.m3u không liên kết đến các danh sách phát khác.

--playlist =
Phát tệp theo tệp danh sách phát (Hỗ trợ một số định dạng phổ biến. Nếu không có định dạng
được phát hiện, nó sẽ được coi là danh sách các tệp, được phân tách bằng các ký tự dòng mới.
Lưu ý rằng các định dạng danh sách phát XML không được hỗ trợ.)

Tuy nhiên, bạn có thể phát danh sách phát trực tiếp và không có tùy chọn này
vô hiệu hóa bất kỳ cơ chế bảo mật nào có thể có. Bạn cũng có thể cần cái này
tùy chọn để tải các tệp bản rõ dưới dạng danh sách phát.

Chú ý:
Cách mpv sử dụng tệp danh sách phát qua - danh sách chơi không an toàn chống lại ác ý
các tệp đã xây dựng. Các tệp như vậy có thể gây ra các hành động có hại. Đây đã là
trường hợp cho tất cả các phiên bản mpv và MPlayer, nhưng thật không may, thực tế này không tốt
đã được ghi nhận trước đó và một số người thậm chí đã khuyến nghị một cách sai lầm về việc sử dụng
- danh sách chơi với các nguồn không đáng tin cậy. Không được dùng - danh sách chơi với internet ngẫu nhiên
nguồn hoặc tệp bạn không tin cậy!

Danh sách phát có thể chứa các mục nhập sử dụng các giao thức khác, chẳng hạn như tệp cục bộ hoặc
(nghiêm trọng nhất), các giao thức đặc biệt như avdevice: //, vốn dĩ là
không an toàn

--chapter-merge-Ngưỡng =
Ngưỡng để hợp nhất các phần chương có thứ tự gần như liên tiếp tính bằng mili giây
(mặc định: 100). Một số tệp Matroska với các chương được sắp xếp có chương không chính xác
dấu thời gian kết thúc, gây ra một khoảng cách nhỏ giữa phần cuối của một chương và phần đầu của
cái tiếp theo khi chúng nên khớp. Nếu phần cuối của một phần phát lại nhỏ hơn
ngưỡng đã cho trước khi bắt đầu ngưỡng tiếp theo, sau đó tiếp tục phát video
thường qua chương thay vì thực hiện tìm kiếm.

--chapter-seek-ngưỡng =
Khoảng cách tính bằng giây từ đầu chương trong đó chương lùi
seek sẽ chuyển đến chương trước (mặc định: 5.0). Vượt qua ngưỡng này, a
Thay vào đó, tìm kiếm chương ngược sẽ chuyển đến đầu chương hiện tại. MỘT
giá trị âm nghĩa là luôn quay trở lại chương trước.

--hr-seek =
Chọn thời điểm sử dụng các tìm kiếm chính xác không giới hạn ở khung hình chính. Như vậy tìm kiếm
yêu cầu giải mã video từ khung hình chính trước đó đến vị trí mục tiêu, v.v.
có thể mất một thời gian tùy thuộc vào hiệu suất giải mã. Đối với một số định dạng video,
tìm kiếm chính xác bị vô hiệu hóa. Tùy chọn này chọn lựa chọn mặc định để sử dụng cho
tìm kiếm; có thể ghi đè rõ ràng mặc định đó trong định nghĩa của khóa
ràng buộc và trong các lệnh chế độ nô lệ.

Không Không bao giờ sử dụng các tìm kiếm chính xác.

tuyệt đối
Sử dụng các tìm kiếm chính xác nếu tìm kiếm đến một vị trí tuyệt đối trong tệp, chẳng hạn như
như một tìm kiếm chương, nhưng không phải cho các tìm kiếm tương đối như hành vi mặc định của
các phím mũi tên (mặc định).

Vâng Sử dụng các tìm kiếm chính xác bất cứ khi nào có thể.

luôn luôn Giống như Vâng (để tương thích).

--hr-seek-demuxer-offset =
Tùy chọn này tồn tại để khắc phục những lỗi không thực hiện được các tìm kiếm chính xác (như trong --giờ-tìm kiếm)
gây ra bởi lỗi hoặc hạn chế trong trình giải mã đối với một số định dạng tệp. Một số demuxer
thất bại trong việc tìm kiếm khung hình chính trước vị trí mục tiêu đã cho, sẽ đến muộn hơn
thay vào đó. Giá trị của tùy chọn này được trừ khỏi dấu thời gian đã cho
cho demuxer. Do đó, nếu bạn đặt tùy chọn này thành 1.5 và cố gắng thực hiện một cách chính xác
60 giây, demuxer được yêu cầu tìm kiếm thời gian 58.5, hy vọng làm giảm
khả năng là nó xuất hiện sai một thời gian sau 60 giây. Nhược điểm của
cài đặt tùy chọn này là các tìm kiếm chính xác trở nên chậm hơn, vì video giữa
vị trí demuxer trước đó và mục tiêu thực có thể bị giải mã một cách không cần thiết.

--hr-seek-framedrop =
Cho phép bộ giải mã video giảm các khung hình trong khi tìm kiếm, nếu các khung hình này nằm trước
tìm kiếm mục tiêu. Nếu tính năng này được bật, việc tìm kiếm chính xác có thể nhanh hơn, nhưng nếu bạn đang sử dụng
bộ lọc video sửa đổi dấu thời gian hoặc thêm khung hình mới, nó có thể dẫn đến chính xác
đang tìm cách bỏ qua khung mục tiêu. Ví dụ: điều này có thể phá vỡ khung backstepping khi
khử xen kẽ được bật.

Mặc định: Vâng

--index =
Kiểm soát cách tìm kiếm trong tệp. Lưu ý rằng nếu chỉ mục bị thiếu trong một tệp, nó
sẽ được xây dựng nhanh chóng theo mặc định, vì vậy bạn không cần phải thay đổi điều này. Nhưng nó có thể
trợ giúp với một số tệp bị hỏng.

mặc định
sử dụng một chỉ mục nếu tệp có một hoặc xây dựng nó nếu thiếu

tái tạo
không đọc hoặc sử dụng chỉ mục của tệp

LƯU Ý:
Tùy chọn này chỉ hoạt động nếu phương tiện cơ bản hỗ trợ tìm kiếm (nghĩa là không với
stdin, đường ống, v.v.).

- tải-không an-toàn-danh sách phát
Tải các URL từ danh sách phát được coi là không an toàn (mặc định: không). Điêu nay bao gôm
giao thức đặc biệt và bất kỳ thứ gì không tham chiếu đến các tệp bình thường. Tệp cục bộ và
Mặt khác, các liên kết HTTP luôn được coi là an toàn.

Lưu ý rằng - danh sách chơi luôn tải tất cả các mục nhập, vì vậy bạn sử dụng mục đó thay thế nếu bạn
thực sự có nhu cầu cho chức năng này.

--loop-file =
Lặp lại một tệp N lần. inf có nghĩa là mãi mãi, Không có nghĩa là phát lại bình thường. Vì
khả năng tương thích, --tập tin vòng lặp và --loop-file = yes cũng được chấp nhận, và giống nhau
as --loop-file = inf.

Sự khác biệt đối với --vòng là điều này không lặp lại danh sách phát, chỉ là tệp
chinh no. Nếu danh sách phát chỉ chứa một tệp duy nhất, thì sự khác biệt giữa hai
là tùy chọn này thực hiện tìm kiếm trên vòng lặp, thay vì tải lại tệp.

--ab-loop-a = , --ab-loop-b =
Đặt điểm vòng lặp. Nếu quá trình phát lại vượt qua b dấu thời gian, nó sẽ tìm kiếm a
dấu thời gian. Tìm kiếm quá khứ b điểm không lặp lại (điều này là cố ý). Các
Các điểm vòng lặp có thể được điều chỉnh trong thời gian chạy với các thuộc tính tương ứng. Xem thêm
ab_loop chỉ huy.

- chương có thứ tự, - chương không theo thứ tự
Được bật theo mặc định. Tắt hỗ trợ cho các chương đã đặt hàng của Matroska. mpv sẽ không
tải hoặc tìm kiếm các phân đoạn video từ các tệp khác và cũng sẽ bỏ qua bất kỳ
thứ tự chương được chỉ định cho tệp chính.

--ordered-chapter-files =
Tải tệp đã cho dưới dạng danh sách phát và cố gắng sử dụng các tệp có trong đó dưới dạng
các tệp tham chiếu khi mở tệp Matroska sử dụng các chương có thứ tự. Điều này
ghi đè cơ chế thông thường để tải các tệp được tham chiếu bằng cách quét cùng một
thư mục chứa tệp chính.

Hữu ích để tải các tệp chương có thứ tự không nằm trên cục bộ
hệ thống tệp hoặc nếu các tệp được tham chiếu nằm trong các thư mục khác nhau.

Lưu ý: danh sách phát có thể đơn giản như một tệp văn bản chứa các tên tệp được phân tách bằng
dòng mới.

--chapter-file =
Tải các chương từ tệp này, thay vì sử dụng siêu dữ liệu chương được tìm thấy trong
tập tin chính.

--sstep =
Nhảy giây sau mỗi khung hình.

LƯU Ý:
Nếu không có --giờ-tìm kiếm, việc bỏ qua sẽ chuyển sang khung hình chính.

--stop-playback-on-init-fail =
Dừng phát lại nếu âm thanh hoặc video không khởi chạy được. Hiện tại, mặc định
hành vi là Không cho trình phát dòng lệnh, nhưng Vâng cho libmpv. Với Không, phát lại
sẽ tiếp tục ở chế độ chỉ video hoặc chỉ âm thanh nếu một trong số chúng không thành công. Điều này không
ảnh hưởng đến việc phát lại các tệp chỉ có âm thanh hoặc video.

chương trình Hành vi
--Cứu giúp Hiển thị tóm tắt ngắn về các tùy chọn.

-v Mức độ chi tiết tăng dần, một mức độ cho mỗi -v tìm thấy trên dòng lệnh.

--phiên bản, -V
In chuỗi phiên bản và thoát.

--no-config
Không tải các tệp cấu hình mặc định. Điều này ngăn cản việc tải cả hai
cấp người dùng và toàn hệ thống mpv.conf và đầu vào.conf các tập tin. Các tệp cấu hình khác
cũng bị chặn, chẳng hạn như tiếp tục phát lại các tệp.

LƯU Ý:
Các tệp được yêu cầu rõ ràng bởi các tùy chọn dòng lệnh, như --bao gồm or
- sử dụng hồ sơ, vẫn sẽ được tải.

Cũng thấy --config-dir.

- tùy chọn danh sách
In tất cả các tùy chọn có sẵn.

- thuộc tính danh sách
In danh sách các thuộc tính có sẵn.

- giao thức danh sách
In danh sách các giao thức được hỗ trợ.

--log-file =
Mở đường dẫn đã cho để viết và in thông báo nhật ký vào đó. Các tệp hiện có sẽ
được cắt bớt. Mức nhật ký luôn tương ứng với -v, bất kể thiết bị đầu cuối
mức độ chi tiết.

--config-dir =
Buộc một thư mục cấu hình khác. Nếu điều này được đặt, thư mục đã cho là
được sử dụng để tải các tệp cấu hình và tất cả các thư mục cấu hình khác
làm ngơ. Điều này có nghĩa là thư mục cấu hình mpv chung cũng như cho mỗi người dùng
các thư mục bị bỏ qua và ghi đè thông qua các biến môi trường (MPV_HOME) là
cũng bị bỏ qua.

Lưu ý rằng --no-config tùy chọn được ưu tiên hơn tùy chọn này.

- lưu-vị-trí-khi-bỏ
Luôn lưu vị trí phát hiện tại khi thoát. Khi tệp này được phát lại
sau đó, người chơi sẽ tìm đến vị trí phát lại cũ khi bắt đầu. Điều này không
xảy ra nếu quá trình phát lại tệp bị dừng theo bất kỳ cách nào khác ngoài việc thoát. Vì
ví dụ: chuyển đến tệp tiếp theo trong danh sách phát sẽ không lưu vị trí và
bắt đầu phát lại từ đầu vào lần phát tệp tiếp theo.

Hành vi này bị tắt theo mặc định, nhưng luôn khả dụng khi thoát khỏi
người chơi bằng Shift + Q.

--dump-stats =
Ghi số liệu thống kê nhất định vào tệp đã cho. Tệp bị cắt bớt khi mở. Các
tệp sẽ chứa các mẫu thô, mỗi mẫu có một dấu thời gian. Để làm cho tệp này thành một
có thể đọc được, kịch bản TOOLS / stats-conv.py có thể được sử dụng (hiện đang hiển thị nó
dưới dạng đồ thị).

Tùy chọn này chỉ hữu ích cho việc gỡ lỗi.

--idle =
Làm cho mpv chờ đợi không thay vì thoát khi không có tệp để phát. Hầu hết
hữu ích trong chế độ nô lệ, nơi mpv có thể được điều khiển thông qua các lệnh đầu vào.

hàng loạt sẽ chỉ không hoạt động khi bắt đầu và cho phép trình phát đóng khi danh sách phát đầu tiên có
chơi xong quay lại.

--bao gồm =
Chỉ định tệp cấu hình sẽ được phân tích cú pháp sau tệp mặc định.

--load-scripts =
Nếu được đặt thành Không, không tự động tải các tập lệnh từ kịch bản thư mục con cấu hình
(Thường ~ / .config / mpv / scripts /). (Vỡ nợ: Vâng)

--script =
Tải một tập lệnh Lua. Bạn có thể tải nhiều tập lệnh bằng cách phân tách chúng bằng dấu phẩy
(,).

--script-opts = key1 = value1, key2 = value2, ...
Đặt các tùy chọn cho các tập lệnh. Một tập lệnh có thể truy vấn một tùy chọn theo khóa. Nếu một tùy chọn được sử dụng
và ngữ nghĩa mà giá trị tùy chọn có hoàn toàn phụ thuộc vào các tập lệnh được tải.
Các giá trị không được xác nhận bởi bất kỳ tập lệnh nào sẽ bị bỏ qua.

--merge-tệp
Giả sử rằng tất cả các tệp được chuyển đến mpv được nối thành một tệp lớn, duy nhất. Điều này
sử dụng dòng thời gian / hỗ trợ EDL trong nội bộ. Lưu ý rằng điều này sẽ không hoạt động đối với chương đã đặt hàng
các tập tin.

--không tiếp tục-phát lại
Không khôi phục vị trí phát lại từ xem sau thư mục con cấu hình
(Thường ~ / .config / mpv / watch_later /). Xem bỏ_watch_later lệnh đầu vào.

--profile =
Sử dụng (các) hồ sơ đã cho, --profile = trợ giúp hiển thị danh sách các cấu hình đã xác định.

--reset-on-next-file =
Thông thường, mpv sẽ cố gắng giữ tất cả cài đặt khi phát tệp tiếp theo trên
danh sách phát, ngay cả khi chúng đã bị người dùng thay đổi trong khi phát lại. (Hành vi này là
ngược lại với MPlayer, cố gắng đặt lại tất cả cài đặt khi bắt đầu tiếp theo
tập tin.)

Mặc định: Không đặt lại bất cứ thứ gì.

Điều này có thể được thay đổi với tùy chọn này. Nó chấp nhận một danh sách các tùy chọn và mpv sẽ
đặt lại giá trị của các tùy chọn này khi bắt đầu phát lại về giá trị ban đầu. Các
giá trị ban đầu là giá trị mặc định hoặc được đặt bởi tệp cấu hình hoặc lệnh
hàng.

Trong một số trường hợp, điều này có thể không hoạt động như mong đợi. Ví dụ, --âm lượng sẽ chỉ có
đặt lại nếu nó được đặt rõ ràng trong tệp cấu hình hoặc dòng lệnh.

Tên đặc biệt tất cả các đặt lại nhiều tùy chọn nhất có thể.

Các ví dụ

· --reset-on-next-file = pause Đặt lại chế độ tạm dừng khi chuyển sang tệp tiếp theo.

· --reset-on-next-file = toàn màn hình, tốc độ Đặt lại toàn màn hình và tốc độ phát lại
cài đặt nếu chúng bị thay đổi trong khi phát lại.

· --reset-on-next-file = all Cố gắng đặt lại tất cả các cài đặt đã được thay đổi trong
phát lại.

--write-filename-in-watch-lat-config
Thêm trước các tệp cấu hình của đồng hồ sau này với tên của tệp mà chúng tham chiếu đến. Điều này
được viết đơn giản dưới dạng nhận xét trên đầu tệp.

Chú ý:
Tùy chọn này có thể làm lộ thông tin nhạy cảm về quyền riêng tư và do đó bị vô hiệu hóa bởi
mặc định.

--ignore-path-in-watch-lat-config
Bỏ qua đường dẫn (tức là chỉ sử dụng tên tệp) khi sử dụng tính năng xem sau.

--show-profile =
Hiển thị mô tả và nội dung của một hồ sơ.

- sử dụng hồ sơ
Tìm tệp cấu hình dành riêng cho tệp trong cùng thư mục với tệp
đang được chơi. Nhìn thấy Tập tin cụ thể Cấu hình Các Tập Tin.

Chú ý:
Có thể nguy hiểm nếu phát từ các phương tiện không đáng tin cậy.

--ytdl, --không-ytdl
Bật tập lệnh hook youtube-dl. Nó sẽ xem xét URL đầu vào và sẽ phát
video nằm trên trang web. Điều này hoạt động với nhiều trang web phát trực tuyến, không chỉ
một mà tập lệnh được đặt tên theo. Điều này yêu cầu phiên bản youtube-dl gần đây để
được cài đặt trên hệ thống. (Được bật theo mặc định, ngoại trừ khi API máy khách /
libmpv đã được sử dụng.)

Nếu tập lệnh không thể làm bất cứ điều gì với một URL, nó sẽ không làm gì cả.

--ytdl-format =
Định dạng / chất lượng video được chuyển trực tiếp tới youtube-dl. Các giá trị có thể là
cụ thể cho trang web và video, đối với một url nhất định, các định dạng có sẵn có thể
tìm thấy bằng lệnh youtube-dl - định dạng danh sách URL. Xem youtube-dl's
tài liệu cho các bí danh có sẵn. (Mặc định: mặc định của youtube-dl, hiện tại
bestvideo + bestaudio / tốt nhất)

--ytdl-raw-options = = [, = [, ...]]
Chuyển các tùy chọn tùy ý đến youtube-dl. Tham số và đối số phải được truyền dưới dạng
cặp khóa-giá trị. Các tùy chọn không có đối số phải bao gồm =.

Không có kiểm tra tỉnh táo nên có thể làm hỏng mọi thứ (tức là chuyển
tham số cho youtube-dl).

Ví dụ

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

Video
--vo =
Chỉ định danh sách ưu tiên các trình điều khiển đầu ra video sẽ được sử dụng. Để sử dụng tương tác,
người ta thường chỉ định một cái duy nhất để sử dụng, nhưng trong các tệp cấu hình,
chỉ định một danh sách các dự phòng có thể có ý nghĩa. Nhìn thấy Thêm bài này vào danh sách Video của bạn Download bài này OUTPUT DRIVERS để biết chi tiết
và mô tả của các trình điều khiển có sẵn.

--vd = <[+ | -] family1: (* | decoder1), [+ | -] family2: (* | decoder2), ... [-]>
Chỉ định danh sách ưu tiên các bộ giải mã video sẽ được sử dụng, theo họ và
Tên. Nhìn thấy --quảng cáo để biết thêm chi tiết. Cả hai tùy chọn này đều sử dụng cùng một cú pháp và
ngữ nghĩa; sự khác biệt duy nhất là chúng hoạt động trên các danh sách codec khác nhau.

LƯU Ý:
Xem --vd = trợ giúp để có danh sách đầy đủ các bộ giải mã có sẵn.

--vf =
Chỉ định danh sách các bộ lọc video để áp dụng cho luồng video. Nhìn thấy Thêm bài này vào danh sách Video của bạn Download bài này LỌC cho
chi tiết và mô tả về các bộ lọc có sẵn. Các biến thể tùy chọn --vf-thêm,
--vf-pre, --vf-del và --vf-clr tồn tại để sửa đổi danh sách đã chỉ định trước đó, nhưng
bạn không cần những thứ này để sử dụng thông thường.

- không có video
Không phát video. Với một số demuxer, điều này có thể không hoạt động. Trong những trường hợp đó, bạn có thể thử
--vo = null thay thế.

mpv sẽ cố gắng tải xuống âm thanh chỉ khi phương tiện được truyền trực tuyến bằng youtube-dl,
vì nó tiết kiệm băng thông. Điều này được thực hiện bằng cách đặt ytdl_format thành
"bestaudio / best" trong tập lệnh ytdl_hook.lua.

- hạn chế
Không ngủ khi xuất khung video. Hữu ích cho điểm chuẩn khi được sử dụng với
--không có âm thanh.

--framedrop =
Bỏ qua hiển thị một số khung hình để duy trì đồng bộ hóa A / V trên các hệ thống chậm hoặc phát ở mức cao
tốc độ khung hình video trên các đầu ra video có giới hạn tốc độ khung hình trên.

Đối số chọn các phương thức drop và có thể là một trong những cách sau:

Vô hiệu hóa bất kỳ thao tác nào trong khung.

Giảm khung hình trễ trên đầu ra video (mặc định). Điều này vẫn giải mã và lọc
tất cả các khung hình, nhưng không hiển thị chúng trên VO. Nó cố gắng truy vấn màn hình
FPS (chỉ X11, không đúng trên hệ thống nhiều màn hình) hoặc giả định là vô hạn
hiển thị FPS nếu không thành công. Giọt được chỉ ra trong dòng trạng thái đầu cuối
as D: cánh đồng. Nếu bộ giải mã quá chậm, về lý thuyết, tất cả các khung hình sẽ phải
bị rơi (vì tất cả các khung hình quá muộn) - để tránh điều này, khung hình bị rơi
dừng nếu tốc độ khung hình hiệu dụng dưới 10 FPS.


Chế độ khung hình cũ, dựa trên bộ giải mã. (Điều này giống với --framedrop = vâng in
mpv 0.5.x trở về trước.) Điều này yêu cầu bộ giải mã bỏ qua các khung hình (trừ khi chúng
cần thiết để giải mã các khung hình trong tương lai). Có thể giúp ích cho các hệ thống chậm, nhưng có thể
tạo ra đầu ra không thể chỉnh sửa được, hoặc thậm chí đóng băng hoàn toàn màn hình.
Không được khuyến khích. Các --vd-lavc-framedrop tùy chọn kiểm soát những khung hình nào
rơi vãi.


Bật cả hai chế độ. Không được khuyến khích.

LƯU Ý:
--vo = vdpau có mã riêng cho vo chế độ khung hình. Sự khác biệt nhỏ đối với
VO khác có thể.

--display-fps =
Đặt FPS hiển thị được sử dụng với --video-sync = display- * các chế độ. Theo mặc định a
giá trị phát hiện được sử dụng (chỉ X11, không đúng trên hệ thống nhiều màn hình). Giữ trong
lưu ý rằng việc đặt một giá trị không chính xác (ngay cả khi hơi không chính xác) có thể làm hỏng video
phát lại.

--hwdec =
Chỉ định API giải mã video phần cứng sẽ được sử dụng nếu có thể. Liệu
giải mã phần cứng thực sự được thực hiện phụ thuộc vào codec video. Nếu giải mã phần cứng
là không thể, mpv sẽ trở lại giải mã phần mềm.

có thể là một trong những điều sau:

Không luôn sử dụng giải mã phần mềm (mặc định)

tự động xem dưới đây

vdpau đòi hỏi --vo = vdpau or --vo = opengl (Chỉ dành cho Linux)

vaapi đòi hỏi --vo = opengl or --vo = vaapi (Chỉ dành cho Linux)

bản sao vaapi
sao chép lại video vào RAM hệ thống (chỉ dành cho Linux với GPU Intel)

hộp videotoolbox
đòi hỏi --vo = opengl (Chỉ OS X 10.8 trở lên)

sao chép dxva2
sao chép video trở lại RAM hệ thống (chỉ dành cho Windows)

rpi đòi hỏi --vo = rpi (Chỉ Raspberry Pi - mặc định nếu có)

tự động cố gắng tự động bật giải mã phần cứng bằng cách sử dụng
phương pháp. Điều này vẫn phụ thuộc vào VO bạn đang sử dụng. Ví dụ, nếu bạn không sử dụng
--vo = vdpau or --vo = opengl, giải mã vdpau sẽ không bao giờ được bật. Cũng lưu ý rằng nếu
phương pháp tìm thấy đầu tiên không thực sự hoạt động, nó sẽ luôn quay trở lại phần mềm
giải mã, thay vì thử phương pháp tiếp theo (có thể quan trọng trên một số hệ thống Linux).

vaapi chế độ, nếu được sử dụng với --vo = opengl, yêu cầu Mesa 11 và rất có thể hoạt động
chỉ với GPU Intel. Nó cũng yêu cầu phần phụ trợ opengl EGL (được sử dụng tự động
nếu có sẵn). Bạn cũng có thể thử chương trình phụ trợ GLX cũ bằng cách buộc nó với
--vo = opengl: backend = x11, nhưng tương tác vaapi / GLX được cho là chậm hơn
bản sao vaapi.

bản sao vaapi chế độ cho phép bạn sử dụng vaapi với bất kỳ VO. Bởi vì điều này sao chép
video đã giải mã trở lại RAM hệ thống, nó có thể kém hiệu quả hơn vaapi chế độ.

LƯU Ý:
Khi sử dụng công tắc này, việc giải mã phần cứng vẫn chỉ được thực hiện đối với một số codec.
Xem --hwdec-codec để cho phép giải mã phần cứng cho nhiều codec hơn.

--hwdec-tải trước =
Điều này rất hữu ích cho OpenGL và opengl-cb VO để tạo giải mã phần cứng
Ngữ cảnh tương tác OpenGL, nhưng không thực sự bật tính năng giải mã phần cứng
(như --hwdec làm).

Nếu được đặt thành Không (mặc định), --hwdec tùy chọn được sử dụng.

Trong cáp OpenGL, nếu được đặt, không tạo ngữ cảnh tương tác theo yêu cầu, nhưng khi VO được
tạo ra.

Trong cáp opengl-cb, nếu được đặt, hãy tải ngữ cảnh tương tác ngay khi ngữ cảnh OpenGL
tạo. Từ opengl-cb không tải theo yêu cầu, điều này cho phép kích hoạt phần cứng
giải mã trong thời gian chạy mà không cần phải tạm thời đặt hwdec tùy chọn
chỉ trong quá trình khởi tạo ngữ cảnh OpenGL với mpv_opengl_cb_init_gl ().

--videotoolbox-format =
Đặt định dạng pixel bên trong được sử dụng bởi --hwdec = videotoolbox trên OSX. Sự lựa chọn của
định dạng có thể ảnh hưởng đáng kể đến hiệu suất. Mặt khác, không có
dường như là một cách tốt để phát hiện định dạng tốt nhất cho phần cứng nhất định. nv12, Các
mặc định, hoạt động tốt hơn trên phần cứng hiện đại, trong khi uyvy422 dường như tốt hơn cho
phần cứng cũ. rgb0 cũng hoạt động.

--panscan = <0.0-1.0>
Bật chức năng quét và quét (cắt các cạnh của video 16: 9 để tạo
nó phù hợp với màn hình 4: 3 không có dải đen). Phạm vi kiểm soát lượng hình ảnh
bị cắt xén. Có thể không hoạt động với tất cả các trình điều khiển đầu ra video.

--video-khía cạnh =
Ghi đè tỷ lệ khung hình video, trong trường hợp thông tin khung hình không chính xác hoặc bị thiếu trong
tệp đang được phát. Xem thêm - không có video-khía cạnh.

Hai giá trị có ý nghĩa đặc biệt:

0 vô hiệu hóa xử lý tỷ lệ khung hình, giả sử video có pixel vuông

-1 sử dụng luồng video hoặc khía cạnh vùng chứa (mặc định)

Nhưng lưu ý rằng việc xử lý các giá trị đặc biệt này có thể thay đổi trong tương lai.

Các ví dụ

· --video-khía cạnh = 4: 3 or --video-khía cạnh = 1.3333

· --video-khía cạnh = 16: 9 or --video-khía cạnh = 1.7777

- không có video-khía cạnh
Bỏ qua thông tin tỷ lệ khung hình khỏi tệp video và giả sử video có hình vuông
điểm ảnh. Xem thêm --video-khía cạnh.

--video-angle-method =
Điều này đặt phương pháp xác định khía cạnh video mặc định (nếu khía cạnh là _not_
bị người dùng ghi đè với --video-khía cạnh hoặc những người khác).

lai Ưu tiên tỷ lệ khung hình vùng chứa. Nếu khía cạnh dòng bit chuyển đổi
giữa luồng, chuyển sang ưu tiên khía cạnh luồng bit. Đây là mặc định
hành vi trong mpv và mplayer2.

chứa
Hoàn toàn thích tỷ lệ khung hình vùng chứa. Đây rõ ràng là mặc định
hành vi với VLC, ít nhất là với Matroska.

dòng bit
Hoàn toàn thích tỷ lệ khung hình dòng bit, trừ khi tỷ lệ dòng bit
tỷ lệ không được thiết lập. Đây rõ ràng là hành vi mặc định với XBMC / kodi, tại
ít nhất là với Matroska.

Thông thường bạn không nên đặt điều này. Thử chứa và dòng bit lựa chọn nếu bạn
gặp phải video có tỷ lệ khung hình sai trong mpv, nhưng có vẻ như đúng trong
những người chơi khác.

--video-chưa chia tỷ lệ
Tắt chia tỷ lệ của video. Nếu cửa sổ lớn hơn video, các thanh màu đen
được thêm. Nếu không, video sẽ bị cắt. Video vẫn có thể bị ảnh hưởng bởi
khác --băng hình-... tùy chọn. (Nhưng không phải tất cả; ví dụ - thu phóng video Không lam gi cả
nếu tùy chọn này được bật.)

Các khía cạnh về video và màn hình sẽ bị bỏ qua. Chỉnh sửa khía cạnh sẽ
yêu cầu chia tỷ lệ video theo hướng X hoặc Y, nhưng tùy chọn này vô hiệu hóa
chia tỷ lệ, vô hiệu hóa tất cả các chỉnh sửa khía cạnh.

Lưu ý rằng thuật toán tỷ lệ vẫn có thể được sử dụng, ngay cả khi video không được chia tỷ lệ.
Ví dụ, điều này có thể ảnh hưởng đến chuyển đổi sắc độ.

Tùy chọn này bị vô hiệu hóa nếu --không giữ được khía cạnh tùy chọn được sử dụng.

--video-pan-x = , --video-pan-y =
Di chuyển hình chữ nhật video được hiển thị theo giá trị đã cho theo hướng X hoặc Y. Các
đơn vị có kích thước bằng một phần nhỏ so với kích thước của video được chia tỷ lệ (kích thước đầy đủ, ngay cả khi các phần
của video không hiển thị do panscan hoặc các tùy chọn khác).

Ví dụ: hiển thị video toàn màn hình 1280x720 trên màn hình 1680x1050 với
--video-pan-x = -0.1 sẽ di chuyển video 168 pixel sang trái (tạo ra 128 pixel
của nguồn video ẩn).

Tùy chọn này bị vô hiệu hóa nếu --không giữ được khía cạnh tùy chọn được sử dụng.

--video-xoay = <0-360 | no>
Xoay video theo chiều kim đồng hồ, theo độ. Hiện chỉ hỗ trợ các bước 90 °. Nếu như Không
được cung cấp, video không bao giờ được xoay, ngay cả khi tệp có siêu dữ liệu xoay. (Các
giá trị xoay vòng được thêm vào siêu dữ liệu xoay vòng, có nghĩa là giá trị 0 sẽ
xoay video theo siêu dữ liệu xoay.)

--video-stereo-mode =
Đặt chế độ đầu ra 3D âm thanh nổi (mặc định: mono). Điều này được thực hiện bằng cách chèn
âm thanh nổi3d bộ lọc chuyển đổi.

Chế độ giả Không vô hiệu hóa hoàn toàn chuyển đổi tự động.

Chế độ mono là một bí danh cho ml, đề cập đến khung bên trái ở dạng 2D. Đây là
mặc định, có nghĩa là mpv sẽ cố gắng hiển thị phim 3D ở dạng 2D, thay vì
Hình ảnh 3D không nhằm mục đích tiêu dùng (chẳng hạn như hiển thị khung bên trái và bên phải
cạnh nhau, v.v.).

Sử dụng --video-stereo-mode = help để liệt kê tất cả các chế độ có sẵn. Kiểm tra với âm thanh nổi3d
lọc tài liệu để xem ý nghĩa của các tên. Lưu ý rằng một số tên đề cập đến
chế độ không được hỗ trợ bởi âm thanh nổi3d - các chế độ này có thể xuất hiện trong tệp, nhưng không thể
được xử lý đúng cách bởi mpv.

--video-zoom =
Điều chỉnh hệ số tỷ lệ hiển thị video theo giá trị đã cho. Đơn vị là phân số
của kích thước video cửa sổ (được chia tỷ lệ).

Ví dụ: với một video 1280x720 được hiển thị trong cửa sổ 1280x720, --video-zoom = -0.1
sẽ làm cho video nhỏ hơn 128 pixel theo hướng X và 72 pixel theo hướng Y
hướng.

Tùy chọn này bị vô hiệu hóa nếu --không giữ được khía cạnh tùy chọn được sử dụng.

--video-align-x = <-1-1>, --video-align-y = <-1-1>
Di chuyển hình chữ nhật video bên trong các đường viền màu đen, thường được thêm vào pad
video để hiển thị nếu tỷ lệ khung hình giữa video và màn hình khác nhau.
--video-align-y = -1 sẽ di chuyển video lên đầu màn hình (để lại một đường viền
chỉ ở dưới cùng), giá trị của 0 căn giữa nó (mặc định) và một giá trị là 1 sẽ đặt
video ở cuối màn hình.

Nếu kích thước video và màn hình khớp hoàn toàn, các tùy chọn này không có tác dụng gì.

Tùy chọn này bị vô hiệu hóa nếu --không giữ được khía cạnh tùy chọn được sử dụng.

--các-pts, --không đúng-pts
--không đúng-pts chuyển mpv sang một chế độ mà thời gian video được xác định bằng cách sử dụng
giá trị tốc độ khung hình cố định (sử dụng --khung hình/giây hoặc sử dụng thông tin tệp).
Đôi khi, các tệp có dấu thời gian rất bị hỏng có thể được phát khá tốt trong
chế độ. Lưu ý rằng các bộ lọc video, hiển thị phụ đề và đồng bộ hóa âm thanh có thể
hoàn toàn bị hỏng trong chế độ này.

--fps =
Ghi đè tốc độ khung hình video. Hữu ích nếu giá trị ban đầu bị sai hoặc bị thiếu.

LƯU Ý:
Hoạt động trong --không đúng-pts chỉ chế độ.

--deinterlace =
Bật hoặc tắt tính năng xen kẽ (mặc định: tự động, thường có nghĩa là không). Xen kẽ
video hiển thị các đồ tạo tác xấu xí giống như chiếc lược, có thể nhìn thấy khi di chuyển nhanh. Cho phép
điều này thường chèn bộ lọc video yadif để khử xen kẽ video hoặc
cho phép đầu ra video áp dụng tính năng khử xen kẽ nếu được hỗ trợ.

Điều này hoạt động chính xác như khử xen kẽ thuộc tính đầu vào (thường được ánh xạ tới d).

tự động là một tính kỹ thuật. Nói một cách chính xác, mặc định cho tùy chọn này là
hủy xen kẽ bị vô hiệu hóa, nhưng tự động trường hợp là cần thiết nếu yadif đã được thêm vào
chuỗi lọc thủ công với --vf. Sau đó, lõi không nên vô hiệu hóa việc khử xen kẽ chỉ
bởi vì --deinterlace không được thiết lập.

- trường-thống trị =
Đặt trường đầu tiên cho nội dung xen kẽ. Hữu ích cho các bộ giải xen kẽ làm tăng gấp đôi
tỷ lệ khung hình: --vf = yadif = trường và --vo = vdpau: deint.

tự động (mặc định) Nếu bộ giải mã không xuất thông tin thích hợp, nó
rơi trở lại hàng đầu (trường trên cùng đầu tiên).

hàng đầu trường trên cùng đầu tiên

dưới cùng trường dưới cùng đầu tiên

LƯU Ý:
Đặt một trong hai hàng đầu or dưới cùng sẽ gắn cờ tất cả các khung là xen kẽ.

--frames =
Chỉ phát / chuyển đổi trước khung video, sau đó thoát.

--frames = 0 tải tệp, nhưng thoát ngay lập tức trước khi bắt đầu phát lại.
(Có thể hữu ích cho các tập lệnh chỉ muốn xác định một số thuộc tính tệp.)

Đối với phát lại chỉ có âm thanh, bất kỳ giá trị nào lớn hơn 0 sẽ ngừng phát lại ngay lập tức
sau khi khởi tạo. Giá trị 0 hoạt động như với video.

--video-output-levels =
Các mức màu RGB được sử dụng với chuyển đổi YUV sang RGB. Thông thường, các thiết bị đầu ra như
Màn hình PC sử dụng toàn dải màu. Tuy nhiên, một số TV và màn hình video
mong đợi mức độ RGB trong phòng thu. Cung cấp đầu ra toàn dải cho một thiết bị mong đợi studio
đầu vào cấp dẫn đến người da đen và da trắng bị nghiền nát, ngược lại với người da đen xám mờ
và lòng trắng mờ.

Không phải tất cả VO đều hỗ trợ tùy chọn này. Một số sẽ im lặng bỏ qua nó.

Các dải màu có sẵn là:

tự động lựa chọn tự động (bằng với toàn dải) (mặc định)

hạn chế
phạm vi giới hạn (16-235 mỗi thành phần), cấp độ studio

Full phạm vi đầy đủ (0-255 mỗi thành phần), mức PC

LƯU Ý:
Thay vào đó, bạn nên sử dụng tùy chọn dải màu của trình điều khiển đồ họa của mình, nếu
có sẵn.

--hwdec-codecs =
Chỉ cho phép giải mã phần cứng cho một danh sách codec nhất định. Giá trị đặc biệt tất cả các
luôn cho phép tất cả các codec.

Bạn có thể lấy danh sách các codec được phép với mpv --vd = trợ giúp. Bỏ tiền tố, ví dụ:
thay vì lavc: h264 sử dụng h264.

Theo mặc định, điều này được đặt thành h264, vc1, wmv3, hevc, mpeg2video. Lưu ý rằng phần cứng
tăng tốc codec đặc biệt như h264_vdpau không còn liên quan nữa, và trên thực tế
đã bị xóa khỏi Libav ở dạng này.

Điều này thường chỉ cần thiết với các GPU bị hỏng, trong đó codec được báo cáo là
được hỗ trợ, nhưng giải mã gây ra nhiều vấn đề hơn là giải quyết.

Ví dụ

mpv --hwdec = vdpau --vo = vdpau --hwdec-codecs = h264, mpeg2video
Chỉ bật giải mã vdpau cho h264 và mpeg2.

--vd-lavc-check-hw-profile =
Kiểm tra hồ sơ bộ giải mã phần cứng (mặc định: có). Nếu như Không được thiết lập, cấu hình cao nhất của
bộ giải mã phần cứng được chọn vô điều kiện và giải mã bắt buộc ngay cả khi
hồ sơ của video cao hơn thế. Kết quả là rất có thể bị hỏng
giải mã, nhưng cũng có thể hữu ích nếu các cấu hình được phát hiện hoặc được báo cáo bằng cách nào đó
sai.

--vd-lavc-phần mềm-dự phòng =
Dự phòng giải mã phần mềm nếu bộ giải mã tăng tốc phần cứng không thành công (mặc định:
3). Nếu đây là một số, thì dự phòng sẽ được kích hoạt nếu N khung không giải mã được
trong một hàng. 1 tương đương với Vâng.

--vd-lavc-cắnxact
Chỉ sử dụng các thuật toán chính xác về bit trong tất cả các bước giải mã (để kiểm tra codec).

--vd-lavc-nhanh (MPEG-2, MPEG-4, và H.264 chỉ)
Bật tính năng tối ưu hóa không tuân thủ đặc điểm định dạng và
có khả năng gây ra sự cố, như dequantization đơn giản hơn, chuyển động đơn giản hơn
bù, giả sử sử dụng ma trận lượng tử hóa mặc định, giả sử YUV 4: 2: 0
và bỏ qua một vài lần kiểm tra để phát hiện các dòng bit bị hỏng.

--vd-lavc-o = = [, = [, ...]]
Chuyển AVOptions đến bộ giải mã libavcodec. Lưu ý, một bản vá để làm cho o= không cần thiết và
vượt qua tất cả các tùy chọn không xác định thông qua hệ thống AVOption được hoan nghênh. Một danh sách đầy đủ
AVOptions có thể được tìm thấy trong sách hướng dẫn FFmpeg.

Một số tùy chọn từng là tùy chọn trực tiếp có thể được đặt bằng cơ chế này, như
lỗi, màu xám, nhận dạng, ec, vismv, bỏ qua (đã st), bỏ qua_bottom (đã sb), gỡ lỗi.

Ví dụ

--vd-lavc-o = debug = picture

--vd-lavc-show-all =
Hiển thị ngay cả các khung hình bị hỏng / bị hỏng (mặc định: không). Nếu tùy chọn này được đặt thành không,
libavcodec sẽ không xuất ra các khung đã được giải mã trước khung hình chính ban đầu
đã được giải mã hoặc các khung được nhận dạng là bị hỏng.

--vd-lavc-vialoopfilter = (H.264 chỉ)
Bỏ qua bộ lọc vòng lặp (gỡ lỗi AKA) trong quá trình giải mã H.264. Kể từ khi lọc
khung được cho là được sử dụng làm tham chiếu để giải mã các khung phụ thuộc, khung này có
ảnh hưởng xấu hơn đến chất lượng so với không thực hiện gỡ lỗi trên video MPEG-2, ví dụ. Nhưng tại
ít nhất đối với HDTV tốc độ bit cao, điều này cung cấp một tốc độ lớn mà ít có thể nhìn thấy
giảm chất lượng.

có thể là một trong những điều sau:

không ai Không bao giờ bỏ qua.

mặc định
Bỏ qua các bước xử lý vô ích (ví dụ: gói kích thước 0 trong AVI).

không giới thiệu Bỏ qua các khung không được tham chiếu (tức là không được sử dụng để giải mã khác
khung, lỗi không thể "xây dựng").

giá thầu Bỏ qua khung B.

không khóa Bỏ qua tất cả các khung hình ngoại trừ khung hình chính.

tất cả các Bỏ qua tất cả các khung.

--vd-lavc-jumpidct = (MPEG-1/2 chỉ)
Bỏ qua bước IDCT. Điều này làm giảm chất lượng rất nhiều trong hầu hết các trường hợp (xem
bộ lọc bỏ qua cho các giá trị bỏ qua có sẵn).

--vd-lavc-viaframe =
Bỏ qua hoàn toàn giải mã khung. Tăng tốc lớn, nhưng chuyển động giật và đôi khi
tạo tác xấu (xem bộ lọc bỏ qua để biết các giá trị bỏ qua có sẵn).

--vd-lavc-framedrop =
Đặt chế độ đóng khung được sử dụng với --framedrop (xem bỏ qua bộ lọc để biết có sẵn phần bỏ qua
giá trị).

--vd-lavc-thread =
Số lượng chủ đề để sử dụng để giải mã. Luồng có thực sự được hỗ trợ hay không
phụ thuộc vào codec (mặc định: 0). 0 có nghĩa là số lõi tự động phát hiện trên máy
và sử dụng nó, tối đa là 16. Bạn có thể thiết lập hơn 16 chủ đề theo cách thủ công.

Bài nghe
--audio-cao độ-chỉnh sửa =
Nếu điều này được bật (mặc định), phát với tốc độ khác với bình thường
tự động chèn nhịp độ bộ lọc âm thanh. Để biết chi tiết, hãy xem bộ lọc âm thanh
phần.

--audio-device =
Sử dụng thiết bị âm thanh đã cho. Điều này bao gồm tên đầu ra âm thanh, ví dụ: trỗi dậy,
tiếp theo /, tiếp theo là tên thiết bị cụ thể của đầu ra âm thanh.

Bạn có thể liệt kê các thiết bị âm thanh với --audio-device = trợ giúp. Điều này xuất ra tên thiết bị
trong dấu ngoặc kép, theo sau là mô tả. Tên thiết bị là những gì bạn phải chuyển đến
các --thiết bị âm thanh tùy chọn.

Giá trị mặc định cho tùy chọn này là tự động, thử mọi đầu ra âm thanh trong
thứ tự ưu tiên với thiết bị mặc định.

Lưu ý rằng nhiều AO có một thiết bị tùy chọn phụ, ghi đè lựa chọn thiết bị
của tùy chọn này (nhưng không phải lựa chọn đầu ra âm thanh). Tương tự như vậy, buộc một AO với
--ao sẽ ghi đè lựa chọn đầu ra âm thanh của --thiết bị âm thanh (nhưng không phải thiết bị
lựa chọn).

Hiện tại không được thực hiện cho hầu hết các AO.

--audio-dự phòng-to-null =
Nếu không có thiết bị âm thanh nào có thể mở được, hãy cư xử như thể --ao = null đã được đưa ra. Cái này hữu ích
kết hợp với --thiết bị âm thanh: thay vì gây ra lỗi nếu được chọn
thiết bị không tồn tại, người dùng API ứng dụng khách (hoặc tập lệnh Lua) có thể cho phép phát lại
tiếp tục bình thường và kiểm tra áo dài và danh sách thiết bị âm thanh tài sản để
đưa ra quyết định cấp cao về cách tiếp tục.

--ao =
Chỉ định danh sách ưu tiên của các trình điều khiển đầu ra âm thanh sẽ được sử dụng. Để sử dụng tương tác một
thông thường sẽ chỉ định một cái duy nhất để sử dụng, nhưng trong các tệp cấu hình chỉ định một
danh sách dự phòng có thể có ý nghĩa. Nhìn thấy AUDIO OUTPUT DRIVERS để biết chi tiết và
mô tả của các trình điều khiển có sẵn.

--af =
Chỉ định danh sách các bộ lọc âm thanh để áp dụng cho luồng âm thanh. Nhìn thấy AUDIO LỌC cho
chi tiết và mô tả về các bộ lọc có sẵn. Các biến thể tùy chọn --af-thêm,
--af-pre, --af-del và --af-clr tồn tại để sửa đổi danh sách đã chỉ định trước đó, nhưng
bạn không cần những thứ này để sử dụng thông thường.

--audio-spdif =
Danh sách codec nên sử dụng chuyển qua âm thanh nén. Những công việc này
cho cả S / PDIF và HDMI cổ điển.

Các codec có thể là ac3, dts, dts-hd. Nhiều codec có thể được chỉ định bởi
tách chúng ra với ,. dts đề cập đến lõi DTS tốc độ bit thấp, trong khi dts-hd đề cập đến
DTS MA (bộ thu và hỗ trợ hệ điều hành khác nhau). Bạn chỉ nên sử dụng một trong hai dts or dts-hd
(nếu cả hai đều được chỉ định, và dts đến trước, chỉ dts sẽ được sử dụng).

Nói chung, tất cả các codec trong spdif gia đình được liệt kê với --ad = giúp đỡ được hỗ trợ trong
học thuyết.

Cảnh báo

Không có nhiều lý do để sử dụng điều này. HDMI hỗ trợ không nén
đa kênh PCM và mpv hỗ trợ giải mã DTS-HD không mất dữ liệu thông qua FFmpeg's
trình bao bọc libdcadec.

--ad = <[+ | -] family1: (* | decoder1), [+ | -] family2: (* | decoder2), ... [-]>
Chỉ định danh sách ưu tiên các bộ giải mã âm thanh sẽ được sử dụng, theo họ và
tên bộ giải mã. Các mục như gia đình:* ưu tiên tất cả các bộ giải mã của họ đã cho.
Khi xác định bộ giải mã nào sẽ sử dụng, bộ giải mã đầu tiên phù hợp với âm thanh
định dạng được chọn. Nếu không có, bộ giải mã tiếp theo sẽ được sử dụng. Cuối cùng, nó
thử tất cả các bộ giải mã khác không được lựa chọn rõ ràng hoặc bị từ chối bởi
tùy chọn.

- ở cuối danh sách ngăn chặn dự phòng trên các bộ giải mã có sẵn khác không có trong
--quảng cáo danh sách. + trước một mục nhập buộc bộ giải mã. Cả hai điều này không nên
thường được sử dụng, vì chúng phá vỡ lựa chọn tự động của bộ giải mã thông thường!

- phía trước một mục nhập sẽ vô hiệu hóa lựa chọn của bộ giải mã.

Các ví dụ

--ad = lavc: mp3float
Thích FFmpeg / Libav mp3float bộ giải mã trên tất cả các bộ giải mã MP3 khác.

--ad = spdif: ac3, lavc: *
Luôn thích spdif AC3 hơn FFmpeg / Libav hơn bất kỳ thứ gì khác.

--ad = giúp đỡ
Liệt kê tất cả các bộ giải mã có sẵn.

Cảnh báo

Cho phép truyền âm thanh nén (AC3 và DTS qua SPDIF / HDMI) với
tùy chọn này không được dùng nữa. Sử dụng --audio-spdif thay thế.

--volume =
Đặt âm lượng khởi động. 0 nghĩa là im lặng, 100 nghĩa là không giảm âm lượng hoặc
sự khuếch đại. Giá trị -1 (mặc định) sẽ không thay đổi âm lượng. Xem thêm
--softvol.

LƯU Ý:
Điều này đã được thay đổi sau khi phát hành mpv 0.9. Trước đó, 100 thực sự có nghĩa là
âm lượng tối đa. Đồng thời, thang đo thể tích đã được lập thành khối nên
các giá trị sẽ không khớp với các giá trị mới.

--audio-delay =
Độ trễ âm thanh tính bằng giây (giá trị float dương hoặc âm). Giá trị dương trì hoãn
âm thanh và các giá trị âm làm trễ video.

--không có âm thanh
Không phát âm thanh.

--mute =
Đặt trạng thái tắt tiếng khởi động. tự động (mặc định) sẽ không thay đổi trạng thái tắt tiếng. Cũng thế
xem --âm lượng.

--softvol =
Kiểm soát việc sử dụng các điều khiển âm lượng của trình điều khiển đầu ra âm thanh hoặc
bộ lọc âm lượng mpv nội bộ.

Không thích điều khiển trình điều khiển âm thanh hơn, chỉ sử dụng bộ lọc âm lượng nếu hoàn toàn
cần thiết

Vâng luôn sử dụng bộ lọc âm lượng

tự động thích bộ lọc âm lượng hơn nếu trình điều khiển âm thanh sử dụng bộ trộn hệ thống (mặc định)

Ý định của tự động là để tránh thay đổi cài đặt bộ trộn hệ thống từ bên trong mpv
với cài đặt mặc định. mpv là một trình phát video, không phải là một bảng trộn. Mặt khác
tay, điều khiển bộ trộn được bật cho các máy chủ âm thanh như PulseAudio, cung cấp
khối lượng mỗi ứng dụng.

--audio-demuxer = <[+] tên>
Sử dụng loại demuxer âm thanh này khi sử dụng --tập tin âm thanh. Sử dụng dấu '+' trước tên để
buộc nó; điều này sẽ bỏ qua một số kiểm tra. Đặt tên demuxer như được in bởi
--audio-demuxer = trợ giúp.

--ad-lavc-ac3drc =
Chọn mức Nén dải động cho các luồng âm thanh AC-3. là một
giá trị float từ 0 đến 1, trong đó 0 có nghĩa là không nén (là
mặc định) và 1 có nghĩa là nén đầy đủ (làm cho các đoạn lớn im lặng hơn và ngược lại
ngược lại). Giá trị lên đến 6 cũng được chấp nhận, nhưng hoàn toàn là giá trị thử nghiệm. Tùy chọn này
chỉ hiển thị hiệu ứng nếu luồng AC-3 chứa dải nén bắt buộc
thông tin.

Tiêu chuẩn yêu cầu DRC được bật theo mặc định, nhưng mpv (và một số
người chơi) bỏ qua điều này vì lợi ích của chất lượng âm thanh tốt hơn.

--ad-lavc-downmix =
Có yêu cầu trộn kênh âm thanh từ bộ giải mã hay không (mặc định: có). Một số
các bộ giải mã, như AC-3, AAC và DTS, có thể phối lại âm thanh khi giải mã. Số được yêu cầu
của các kênh đầu ra được thiết lập với - kênh âm thanh lựa chọn. Hữu ích để chơi
âm thanh vòm trên hệ thống âm thanh nổi.

--ad-lavc-thread = <0-16>
Số lượng chủ đề để sử dụng để giải mã. Luồng có thực sự được hỗ trợ hay không
phụ thuộc vào codec. Theo cách viết này, nó chỉ được hỗ trợ cho một số codec không mất dữ liệu.
0 có nghĩa là số lõi tự động phát hiện trên máy và sử dụng số lõi đó, tối đa
của 16 (mặc định: 1).

--ad-lavc-o = = [, = [, ...]]
Chuyển AVOptions đến bộ giải mã libavcodec. Lưu ý, một bản vá để làm cho o = không cần thiết và
vượt qua tất cả các tùy chọn không xác định thông qua hệ thống AVOption được hoan nghênh. Một danh sách đầy đủ
AVOptions có thể được tìm thấy trong sách hướng dẫn FFmpeg.

--ad-spdif-dtshd = , --dtshd, --không-dtshd
Nếu DTS được truyền qua, hãy sử dụng DTS-HD.

Cảnh báo

Điều này và cho phép chuyển qua --quảng cáo không dùng nữa để ủng hộ việc sử dụng
--audio-spdif = dts-hd.

--audio-channel =
Yêu cầu bố cục kênh cho đầu ra âm thanh (mặc định: tự động). Điều này sẽ yêu cầu AO
mở một thiết bị có bố cục kênh nhất định. Việc chấp nhận điều này tùy thuộc vào AO
bố cục hoặc để chọn một dự phòng hoặc để xảy ra lỗi nếu bố cục được yêu cầu không phải là
được hỗ trợ.

- kênh âm thanh tùy chọn lấy số kênh hoặc kênh rõ ràng
bố trí. Số kênh đề cập đến bố cục mặc định, ví dụ: 2 kênh đề cập đến âm thanh nổi,
6 đề cập đến 5.1.

Xem --audio-channel = trợ giúp đầu ra cho các bố cục mặc định đã xác định. Điều này cũng liệt kê
tên người nói, có thể được sử dụng để thể hiện bố cục kênh tùy ý (ví dụ:
fl-fr-lfe là 2.1).

Mặc định là --audio-channel = auto, cố gắng phát âm thanh bằng đầu vào
bố cục kênh của tệp. (Hay chính xác hơn là đầu ra của chuỗi bộ lọc âm thanh.)
(trống là một bí danh lỗi thời được chấp nhận cho tự động.)

Điều này cũng sẽ yêu cầu bố cục kênh từ bộ giải mã. Nếu bộ giải mã không
hỗ trợ bố cục, nó sẽ trở lại bố cục kênh gốc. (Bạn có thể dùng
--ad-lavc-downmix = không để làm cho bộ giải mã luôn xuất ra bố cục gốc của nó.)
rằng chỉ một số bộ giải mã hỗ trợ phối lại âm thanh. Một số bao gồm AC-3, AAC hoặc
Âm thanh DTS.

Nếu bố cục kênh của tệp phương tiện (tức là bộ giải mã) và kênh của AO
bố cục không khớp, mpv sẽ cố gắng chèn bộ lọc chuyển đổi.

Cảnh báo

Sử dụng tự động có thể gây ra sự cố khi sử dụng âm thanh qua HDMI. Hệ điều hành sẽ
thường báo cáo tất cả các bố cục kênh _can_ đi qua HDMI, ngay cả khi
người nhận không hỗ trợ chúng. Nếu người nhận nhận được một kênh không được hỗ trợ
bố cục, những điều ngẫu nhiên có thể xảy ra, chẳng hạn như bỏ phần bổ sung
các kênh hoặc thêm tiếng ồn.

--audio-display =
Đặt tùy chọn này thành tập tin đính kèm (mặc định) sẽ hiển thị tệp đính kèm hình ảnh (ví dụ:
bìa album) khi phát tệp âm thanh. Nó sẽ hiển thị hình ảnh đầu tiên được tìm thấy,
và các hình ảnh bổ sung có sẵn dưới dạng các đoạn video.

Đặt tùy chọn này thành Không tắt hoàn toàn hiển thị video khi phát âm thanh
các tập tin.

Tùy chọn này không ảnh hưởng đến các tệp có đoạn video bình thường.

--audio-file =
Phát âm thanh từ tệp bên ngoài trong khi xem video. Mỗi lần sử dụng tùy chọn này
sẽ thêm một bản âm thanh mới. Các chi tiết tương tự như cách - tệp phụ công trình.

--audio-format =
Chọn định dạng mẫu được sử dụng cho đầu ra từ lớp lọc âm thanh thành âm thanh
Thẻ. Các giá trị mà có thể áp dụng được liệt kê bên dưới trong mô tả của
định dạng bộ lọc âm thanh.

--audio-samplerate =
Chọn tốc độ lấy mẫu đầu ra sẽ được sử dụng (tất nhiên card âm thanh có giới hạn về
cái này). Nếu tần số mẫu được chọn khác với tần số của dòng điện
media, bộ lọc âm thanh lavrresample sẽ được chèn vào lớp bộ lọc âm thanh
để bù vào phần chênh lệch.

--gapless-audio =
Cố gắng phát các tệp âm thanh liên tiếp mà không bị tắt tiếng hoặc gián đoạn tại điểm
thay đổi tập tin. Vỡ nợ: yếu.

Không Tắt âm thanh không có khe hở.

Vâng Thiết bị âm thanh được mở bằng cách sử dụng các thông số được chọn theo
tập tin được phát và sau đó được giữ ở trạng thái mở để phát lại không có khe hở. Điều này có nghĩa là nếu
ví dụ: tệp đầu tiên có tỷ lệ mẫu thấp, sau đó là các tệp sau
có thể được lấy mẫu lại thành cùng một tỷ lệ mẫu thấp, dẫn đến giảm âm thanh
phẩm chất. Nếu bạn phát các tệp có các thông số khác nhau, hãy cân nhắc sử dụng các tùy chọn
như là --audio-lấy mẫu và --định dạng âm thanh để chọn rõ ràng những gì
định dạng đầu ra được chia sẻ sẽ là.

yếu Thông thường, thiết bị âm thanh được giữ ở trạng thái mở (sử dụng định dạng đầu tiên
khởi tạo bằng). Nếu định dạng âm thanh mà đầu ra của bộ giải mã thay đổi, âm thanh
thiết bị được đóng và mở lại. Điều này có nghĩa là bạn thường sẽ không bị thiếu hụt
âm thanh với các tệp được mã hóa bằng cùng cài đặt, nhưng có thể không
không có lỗ hổng trong các trường hợp khác. (Không giống như với Vâng, bạn không phải lo lắng về
các trường hợp góc như tệp đầu tiên đặt định dạng đầu ra chất lượng rất thấp,
và làm hỏng việc phát lại các tệp chất lượng cao hơn sau đó.)

LƯU Ý:
Tính năng này được thực hiện một cách đơn giản và phụ thuộc vào thiết bị đầu ra âm thanh
vào bộ đệm để tiếp tục phát lại trong khi chuyển từ tệp này sang tệp khác. Nếu như
quá trình phát lại tệp mới bắt đầu chậm, chẳng hạn như vì nó được phát từ
vị trí mạng từ xa hoặc vì bạn đã chỉ định cài đặt bộ đệm
yêu cầu thời gian để lấp đầy bộ nhớ cache ban đầu, sau đó âm thanh trong bộ đệm có thể hết
trước khi quá trình phát lại tệp mới có thể bắt đầu.

--đồng bộ hóa âm thanh ban đầu, - không-ban-đầu-âm thanh-đồng bộ hoá
Khi bắt đầu một tệp video hoặc sau các sự kiện như tìm kiếm, mpv sẽ theo mặc định
sửa đổi luồng âm thanh để bắt đầu từ cùng một dấu thời gian như video, bằng cách
hoặc chèn im lặng khi bắt đầu hoặc cắt bỏ các mẫu đầu tiên. Vô hiệu hóa
tùy chọn này làm cho trình phát hoạt động giống như các phiên bản mpv cũ hơn đã làm: video và âm thanh
cả hai đều được bắt đầu ngay lập tức ngay cả khi dấu thời gian bắt đầu của chúng khác nhau và sau đó là video
thời gian được điều chỉnh dần dần nếu cần thiết để đạt được đồng bộ hóa chính xác sau này.

--softvol-max = <100.0-1000.0>
Đặt mức khuếch đại tối đa theo phần trăm (mặc định: 130). Giá trị 130 sẽ
cho phép bạn điều chỉnh âm lượng lên khoảng gấp đôi mức bình thường.

--audio-file-auto = , --no-audio-file-auto
Tải các tệp âm thanh bổ sung khớp với tên tệp video. Tham số chỉ định
cách các tệp âm thanh bên ngoài được đối sánh. chính xác được bật theo mặc định.

Không Không tự động tải các tệp âm thanh bên ngoài.

chính xác Tải tên tệp phương tiện với phần mở rộng tệp âm thanh (mặc định).

mờ Tải tất cả các tệp âm thanh có chứa tên tệp phương tiện.

tất cả các Tải tất cả các tệp âm thanh trong thư mục hiện tại.

--audio-client-name =
Tên ứng dụng mà trình phát báo cáo tới API âm thanh. Có thể hữu ích nếu bạn muốn
để buộc một cấu hình âm thanh khác (ví dụ: với PulseAudio) hoặc để thiết lập cấu hình âm thanh của riêng bạn
tên ứng dụng khi sử dụng libmpv.

--volume-restore-data =
Được sử dụng trong nội bộ để sử dụng bằng cách tiếp tục phát lại (ví dụ: với bỏ_watch_later). Phục hồi
giá trị phải được thực hiện cẩn thận, bởi vì các AO khác nhau cũng như softvol có thể có
các phạm vi giá trị khác nhau và chúng tôi không muốn khôi phục âm lượng nếu đặt âm lượng
thay đổi nó trên toàn hệ thống. Các tùy chọn bình thường (như --âm lượng) sẽ luôn đặt
âm lượng. Tùy chọn này đã được thêm vào để khôi phục âm lượng theo cách an toàn hơn (bằng cách lưu trữ
được sử dụng để đặt âm lượng), và thường không hữu ích. Ngữ nghĩa của nó là
được coi là riêng tư đối với mpv.

Không được dùng.

--audio-buffer =
Đặt bộ đệm tối thiểu cho đầu ra âm thanh. Thiết bị âm thanh thực sự có thể tạo ra một
bộ đệm lớn hơn nếu nó hài lòng. Nếu thiết bị tạo bộ đệm nhỏ hơn, hãy bổ sung
âm thanh được đệm trong bộ đệm phần mềm bổ sung.

Làm cho điều này lớn hơn sẽ làm cho âm lượng mềm và các bộ lọc khác phản ứng chậm hơn, giới thiệu
các vấn đề khác về thay đổi tốc độ phát lại và chặn trình phát ở định dạng âm thanh
những thay đổi. Bộ đệm nhỏ hơn có thể dẫn đến việc bỏ qua âm thanh.

Tùy chọn này chỉ nên được sử dụng để thử nghiệm. Nếu một giá trị không mặc định sẽ giúp
đáng kể, nên liên hệ với các nhà phát triển mpv.

Mặc định: 0.2 (200 ms).

Phụ đề
--no-sub
Không chọn bất kỳ phụ đề nào khi tệp được tải.

--sub-demuxer = <[+] tên>
Buộc loại demuxer phụ đề cho - tệp phụ. Đặt tên demuxer như được in bởi
--sub-demuxer = trợ giúp.

- sub-delay =
Chậm trễ phụ đề bởi giây. Có thể là tiêu cực.

--sub-file = subtitlefile
Thêm tệp phụ đề vào danh sách phụ đề bên ngoài.

Nếu bạn sử dụng - tệp phụ chỉ một lần, tệp phụ đề này được hiển thị theo mặc định.

If - tệp phụ được sử dụng nhiều lần, phụ đề để sử dụng có thể được chuyển đổi tại
thời gian chạy bằng phụ đề đi xe đạp. Có thể hiển thị hai phụ đề cùng một lúc:
sử dụng --sid để chọn chỉ mục phụ đề đầu tiên và --sid phụ để chọn
chỉ số thứ hai. (Chỉ mục được in trên đầu ra của thiết bị đầu cuối sau --sid = trong
danh sách các luồng.)

--secondary-sid =
Chọn một luồng phụ đề phụ. Điều này tương tự như --sid. Nếu một phụ
phụ đề được chọn, nó sẽ được hiển thị dưới dạng phụ đề (tức là trên đầu
màn hình) cùng với phụ đề bình thường và cung cấp một cách để hiển thị hai phụ đề
một lần.

Có một số lưu ý liên quan đến tính năng này. Ví dụ: phụ đề bitmap
sẽ luôn được hiển thị ở vị trí thông thường của chúng, vì vậy hãy chọn một phụ đề bitmap như
phụ đề phụ sẽ dẫn đến phụ đề chồng chéo. Phụ đề phụ là
không bao giờ hiển thị trên thiết bị đầu cuối nếu video bị tắt.

LƯU Ý:
Việc tạo kiểu và diễn giải bất kỳ thẻ định dạng nào bị vô hiệu hóa cho thẻ phụ
phụ đề. Về nội bộ, cơ chế tương tự như --no-sub-ass được sử dụng để tước
kiểu dáng.

LƯU Ý:
Nếu luồng phụ đề chính chứa các thẻ định dạng hiển thị phụ đề
ở đầu màn hình, nó sẽ chồng lên phụ đề phụ. Đến
ngăn chặn điều này, bạn có thể sử dụng --no-sub-ass để tắt kiểu trong phụ đề chính
dòng.

- thang đo phụ = <0-100>
Yếu tố cho kích thước phông chữ của phụ đề văn bản (mặc định: 1).

LƯU Ý:
Điều này cũng ảnh hưởng đến phụ đề ASS và có thể dẫn đến phụ đề không chính xác
kết xuất. Sử dụng cẩn thận, hoặc sử dụng - sub-text-font-size thay thế.

--sub-scale-by-window =
Có chia tỷ lệ phụ đề với kích thước cửa sổ hay không (mặc định: có). Nêu Đây la
bị vô hiệu hóa, việc thay đổi kích thước cửa sổ sẽ không thay đổi kích thước phông chữ của phụ đề.

Như - quy mô nhỏ, điều này có thể phá vỡ phụ đề ASS.

--sub-scale-with-window =
Đặt kích thước phông chữ của phụ đề so với cửa sổ, thay vì cho video. Đây là
hữu ích nếu bạn luôn muốn có cùng kích thước phông chữ, ngay cả khi video không che
cửa sổ hoàn toàn, ví dụ: vì khía cạnh màn hình và khía cạnh cửa sổ không khớp (và trình phát
thêm các thanh màu đen).

Mặc định: có.

Tùy chọn này được đặt tên sai. Sự khác biệt đối với tùy chọn phát ra âm thanh giống nhau đến khó hiểu
- sub-scale-by-window là - sub-scale-with-window vẫn quy mô với
kích thước cửa sổ gần đúng, trong khi tùy chọn khác vô hiệu hóa tỷ lệ này.

Chỉ ảnh hưởng đến phụ đề văn bản thuần túy (hoặc ASS nếu --ass-style-ghi đè được đặt cao
đầy đủ).

--ass-scale-with-window =
Như - sub-scale-with-window, nhưng chỉ ảnh hưởng đến phụ đề ở định dạng ASS. Thích
- quy mô nhỏ, điều này có thể phá vỡ phụ đề ASS.

Mặc định: không.

--embeddedphông chữ, --no-nhúngfonts
Sử dụng phông chữ được nhúng trong tệp vùng chứa Matroska và tập lệnh ASS (mặc định: đã bật).
Các phông chữ này có thể được sử dụng để hiển thị phụ đề SSA / ASS.

--sub-pos = <0-100>
Chỉ định vị trí của phụ đề trên màn hình. Giá trị là vị trí thẳng đứng
của phụ đề tính bằng% chiều cao màn hình.

LƯU Ý:
Điều này cũng ảnh hưởng đến phụ đề ASS và có thể dẫn đến phụ đề không chính xác
kết xuất. Sử dụng cẩn thận, hoặc sử dụng --sub-văn bản-lề-y thay thế.

- tốc độ phụ = <0.1-10.0>
Nhân dấu thời gian của sự kiện phụ đề với giá trị đã cho. Có thể được sử dụng để sửa chữa
tốc độ phát lại cho các định dạng phụ đề dựa trên khung hình. Chỉ ảnh hưởng đến phụ đề văn bản.

Ví dụ

- tốc độ phụ = 25 / 23.976 ' phát phụ đề dựa trên khung hình đã được tải
giả sử tốc độ khung hình là 23.976 ở 25 FPS.

--ass-force-style = <[Style.] Param = Value [, ...]>
Ghi đè một số thông số kiểu hoặc thông tin tập lệnh.

Các ví dụ

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

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

LƯU Ý:
Sử dụng tùy chọn này có thể dẫn đến hiển thị phụ đề không chính xác.

--ass-hinting =
Đặt loại gợi ý phông chữ. có thể:

không ai không có gợi ý (mặc định)

ánh sáng FreeType autohinter, chế độ ánh sáng

bình thường FreeType autohinter, chế độ bình thường

tự nhiên phông chữ bản địa

Cảnh báo

Bật gợi ý có thể dẫn đến văn bản được định vị sai vị trí (trong các tình huống
phải phù hợp với nền video) hoặc giảm độ mượt của
hoạt ảnh với một số tập lệnh ASS có tác giả kém. Khuyến cáo không nên
sử dụng tùy chọn này, trừ khi thực sự cần thiết.

--ass-line-spacing =
Đặt giá trị giãn cách dòng cho trình kết xuất SSA / ASS.

--ass-shaper =
Đặt công cụ bố cục văn bản được libass sử dụng.

đơn giản chỉ sử dụng Fribidi, nhanh, không hiển thị chính xác một số ngôn ngữ

phức tạp
sử dụng HarfBuzz, hỗ trợ ngôn ngữ chậm hơn, rộng hơn

phức tạp là mặc định. Nếu libass chưa được biên dịch để chống lại HarfBuzz, libass
âm thầm trở lại đơn giản.

--ass-styles =
Tải tất cả các kiểu SSA / ASS được tìm thấy trong tệp được chỉ định và sử dụng chúng để hiển thị văn bản
phụ đề. Cú pháp của tệp chính xác như [V4 Phong cách] / [V4 + Phong cách]
phần của SSA / ASS.

LƯU Ý:
Sử dụng tùy chọn này có thể dẫn đến hiển thị phụ đề không chính xác.

--ass-style-override =
Kiểm soát xem có nên áp dụng ghi đè kiểu người dùng hay không.

Vâng Áp dụng tất cả --ass- * các tùy chọn ghi đè kiểu. Thay đổi mặc định cho bất kỳ
trong số các tùy chọn này có thể dẫn đến hiển thị phụ đề không chính xác (mặc định).

dấu hiệu Lượt thích Vâng, nhưng áp dụng - quy mô nhỏ chỉ để ký

Không Hiển thị phụ đề do tập lệnh phụ đề ép buộc.

lực lượng Cố gắng buộc kiểu phông chữ như được xác định bởi - sub-text- * tùy chọn. Có thể
ngắt kết xuất dễ dàng.

--ass-force-margin
Cho phép đặt phụ đề và phụ đề trong đường viền đen khi chúng có sẵn,
nếu phụ đề ở định dạng ASS.

Mặc định: không.

- sub-use-margin
Cho phép đặt phụ đề và phụ đề trong đường viền đen khi chúng có sẵn,
nếu phụ đề ở định dạng văn bản thuần túy (hoặc ASS nếu --ass-style-ghi đè được thiết lập
đủ cao).

Mặc định: có.

Đã đổi tên từ --ass-sử dụng-lề. Để đặt phụ đề ASS trong đường viền (như
tùy chọn cũ đã làm), cũng thêm --ass-force-margin.

--ass-vsfilter-khía cạnh-compat =
Kéo dài phụ đề SSA / ASS khi phát video anamorphic để tương thích với
hành vi VSFilter truyền thống. Công tắc này không có tác dụng khi video được lưu trữ
với pixel vuông.

Trình kết xuất trước đây được sử dụng phổ biến nhất cho các định dạng phụ đề SSA / ASS,
VSFilter, có hành vi đáng ngờ dẫn đến phụ đề cũng bị kéo dài
nếu video được lưu trữ ở định dạng anamorphic yêu cầu điều chỉnh tỷ lệ để hiển thị.
Hành vi này thường không mong muốn và các phiên bản VSFilter mới hơn có thể hoạt động
khác nhau. Tuy nhiên, nhiều tập lệnh hiện có bù đắp cho việc kéo dài
sửa đổi những điều theo hướng ngược lại. Do đó, nếu các tập lệnh như vậy được hiển thị
"một cách chính xác", chúng sẽ không xuất hiện như dự định. Công tắc này cho phép mô phỏng
hành vi VSFilter cũ (không mong muốn nhưng được mong đợi bởi nhiều tập lệnh hiện có).

Được bật theo mặc định.

--ass-vsfilter-blur-compat =
Quy mô \mơ hồ thẻ theo độ phân giải video thay vì độ phân giải tập lệnh (được kích hoạt bởi
vỡ nợ). Đây là lỗi trong VSFilter, theo một số người, không thể sửa được nữa
nhân danh sự tương thích.

Lưu ý rằng điều này sử dụng độ phân giải video thực tế để tính toán tỷ lệ bù đắp
chứ không phải yếu tố mà chuỗi bộ lọc video hoặc đầu ra video sử dụng.

--ass-vsfilter-color-compat =
Mangle màu như (xy-) vsfilter do (mặc định: cơ bản). Trong lịch sử, VSFilter là
không màu nhận biết không gian. Điều này không thành vấn đề miễn là không gian màu được sử dụng cho SD
video (BT.601) đã được sử dụng. Nhưng khi mọi thứ chuyển sang HD (BT.709), VSFilter đã
vẫn chuyển đổi màu RGB thành BT.601, hiển thị chúng vào khung video và
đã xử lý khung hình thành đầu ra video, sẽ sử dụng BT.709 để chuyển đổi sang
RGB. Kết quả là màu sắc của phụ đề bị lệch. Sau đó, các bản hack xấu đã được thêm vào
của định dạng ASS để kiểm soát cách màu sắc bị xáo trộn.

cơ bản Chỉ xử lý BT.601-> BT.709 nghe lộn xộn, nếu phụ đề có vẻ cho biết điều đó
điều này là bắt buộc (mặc định).

Full Xử lý toàn bộ YCbCr Matrix tiêu đề với tất cả các không gian màu video được hỗ trợ bởi
libass và mpv. Điều này có thể dẫn đến sự cố hỏng hóc trong các trường hợp ở góc và không
hoàn toàn cần thiết cho khả năng tương thích (hy vọng), đó là lý do tại sao điều này không
mặc định.

lực lượng-601
Buộc trộn BT.601-> BT.709, bất kể tiêu đề phụ đề hoặc màu video
không gian.

Không Tắt hoàn toàn việc trộn màu. Tất cả các màu đều là RGB.

Chọn bất cứ điều gì khác ngoài Không sẽ làm cho màu phụ đề phụ thuộc vào video
không gian màu và ví dụ về lý thuyết là không thể sử dụng lại tập lệnh phụ đề
với một tệp video khác. Các --ass-style-ghi đè tùy chọn không ảnh hưởng đến cách này
tùy chọn được diễn giải.

--stretch-dvd-subs =
Kéo dài phụ đề DVD khi phát video anamorphic để có phông chữ đẹp hơn trên
những đĩa DVD không thành thạo. Công tắc này không có tác dụng khi video được lưu trữ bằng hình vuông
pixel - mặc dù không thể dùng cho đầu vào DVD.

Nhiều studio có xu hướng sử dụng phông chữ bitmap được thiết kế cho các pixel vuông khi tác giả
DVD, làm cho phông chữ trông bị kéo dài khi phát lại trên đầu đĩa DVD. Tùy chọn này
sửa chữa chúng, tuy nhiên với cái giá là có thể sắp xếp sai một số phụ đề (ví dụ: dấu
bản dịch).

Vô hiệu hóa theo mặc định.

--stretch-image-subs-to-screen =
Kéo dài DVD và phụ đề hình ảnh khác lên màn hình, bỏ qua lề video.
Điều này có tác dụng tương tự như - sub-use-margin cho phụ đề văn bản, ngoại trừ
văn bản tự nó sẽ được kéo dài, không chỉ được đặt lại vị trí. (Ít nhất là nói chung nó
là không thể tránh khỏi, vì một bitmap hình ảnh về lý thuyết có thể bao gồm một bitmap duy nhất
bao phủ toàn bộ màn hình và người chơi sẽ không biết chính xác vị trí của các phần văn bản
được định vị.)

Tùy chọn này không hiển thị phụ đề một cách chính xác. Sử dụng cẩn thận.

Vô hiệu hóa theo mặc định.

- thằng khốn, --no-sub-ass
Hiển thị phụ đề ASS nguyên bản (được bật theo mặc định).

If --no-sub-ass được chỉ định, tất cả các thẻ và khai báo kiểu đều bị loại bỏ và
bị bỏ qua trên màn hình. Trình kết xuất phụ đề sử dụng kiểu phông chữ như được chỉ định bởi
- văn bản phụ- thay vào đó.

LƯU Ý:
Sử dụng --no-sub-ass có thể dẫn đến kết xuất không chính xác hoặc bị hỏng hoàn toàn
Phụ đề ASS / SSA. Đôi khi có thể hữu ích nếu buộc ghi đè kiểu
phụ đề ASS, nhưng nói chung nên tránh.

LƯU Ý:
Hãy thử sử dụng --ass-style-override = force thay thế.

--sub-auto = , - không tự động phụ
Tải các tệp phụ đề bổ sung khớp với tên tệp video. Tham số chỉ định
cách các tệp phụ đề bên ngoài được đối sánh. chính xác được bật theo mặc định.

Không Không tự động tải các tệp phụ đề bên ngoài.

chính xác Tải tên tệp phương tiện với phần mở rộng tệp phụ đề (mặc định).

mờ Tải tất cả các phụ có chứa tên tệp phương tiện.

tất cả các Tải tất cả các đăng ký hiện tại và - đường dẫn phụ thư mục.

--sub-codepage =
Nếu hệ thống của bạn hỗ trợ iconv(3), bạn có thể sử dụng tùy chọn này để chỉ định phụ đề
mã trang. Theo mặc định, uchardet sẽ được sử dụng để đoán bộ ký tự. Nếu mpv không
được biên dịch bằng uchardet, enca sẽ được sử dụng. Nếu mpv được biên dịch không có
uchardet hay enca, UTF-8: UTF-8-BROKEN là mặc định, có nghĩa là nó sẽ cố gắng
sử dụng UTF-8, nếu không UTF-8-THÔI giả mã (xem bên dưới).

Giá trị mặc định cho tùy chọn này là tự động, hiệu quả thực tế của ai phụ thuộc vào việc
ENCA được biên dịch.

Cảnh báo

Nếu bạn buộc bộ ký tự, ngay cả phụ đề được biết là UTF-8 cũng sẽ
được mã hóa, mà có lẽ không phải là những gì bạn mong đợi. Tiền tố mã hóa với
utf8: nếu bạn muốn mã hóa chỉ được sử dụng nếu đầu vào không hợp lệ
UTF-8.

Các ví dụ

· --sub-codepage = utf8: latin2 Sử dụng tiếng Latinh 2 nếu đầu vào không phải là UTF-8.

· --sub-codepage = cp1250 Luôn buộc mã hóa thành cp1250.

Bộ mã giả UTF-8-THÔI được sử dụng trong nội bộ. Khi nó là codepage,
phụ đề được hiểu là UTF-8 với "Latin 1" là dự phòng cho các byte được
trình tự UTF-8 không hợp lệ. iconv không bao giờ tham gia vào chế độ này.

Nếu trình phát được biên dịch với sự hỗ trợ của ENCA, bạn có thể kiểm soát nó bằng cách sau
cú pháp:

--sub-codepage = enca: : codepage>

Ngôn ngữ được chỉ định bằng cách sử dụng mã hai chữ cái để giúp ENCA phát hiện mã hóa
tự động. Nếu nhập mã ngôn ngữ không hợp lệ, mpv sẽ khiếu nại và liệt kê
ngôn ngữ hợp lệ. (Tuy nhiên, lưu ý rằng danh sách này sẽ chỉ được in khi
mã chuyển đổi thực sự được gọi, ví dụ: khi tải phụ đề bên ngoài).
Mã hóa dự phòng được sử dụng nếu tính năng tự động phát hiện không thành công. Nếu không có dự phòng nào được chỉ định,
UTF-8-THÔI Được sử dụng.

Các ví dụ

· --sub-codepage = enca: pl: cp1250 đoán mã hóa, giả sử phụ đề là
Đánh bóng, quay trở lại cp1250

· --sub-codepage = enca: pl đoán mã hóa cho tiếng Ba Lan, quay lại UTF-8.

· --sub-codepage = enca thử phát hiện phổ quát, rơi trở lại UTF-8.

Nếu trình phát được biên dịch với hỗ trợ libguess, bạn có thể sử dụng nó với:

--sub-codepage = đoán: : codepage>

libguess luôn cần một ngôn ngữ. Không có chế độ phát hiện phổ quát. Sử dụng
--sub-codepage = đoán: giúp đỡ để có được danh sách các ngôn ngữ có cùng cảnh báo như
với ENCA ở trên.

Nếu trình phát được biên dịch với sự hỗ trợ của uchardet, bạn có thể sử dụng nó với:

--sub-codepage = uchardet

Chế độ này không sử dụng ngôn ngữ hoặc mã dự phòng.

- sub-fix-timeing, --không-phụ-sửa-thời-gian
Theo mặc định, thời gian của phụ đề được điều chỉnh để loại bỏ những khoảng trống nhỏ hoặc trùng lặp giữa
phụ đề (nếu sự khác biệt nhỏ hơn 210 ms, khoảng cách hoặc chồng chéo là
loại bỏ).

- chỉ bắt buộc phụ
Chỉ hiển thị phụ đề bắt buộc cho luồng phụ đề DVD được chọn bởi ví dụ
--tiếng lóng.

--sub-fps =
Chỉ định tốc độ khung hình của tệp phụ đề (mặc định: video fps). Ảnh hưởng đến văn bản
chỉ phụ đề.

LƯU Ý:
> video fps tăng tốc độ phụ đề cho các tệp phụ đề dựa trên khung hình và
làm chậm chúng đối với những cái dựa trên thời gian.

Cũng thấy - tốc độ dưới tùy chọn.

--sub-gauss = <0.0-3.0>
Áp dụng tính năng làm mờ Gaussian cho phụ đề hình ảnh (mặc định: 0). Điều này có thể giúp tạo pixelated
DVD / Vobsub trông đẹp hơn. Giá trị khác 0 cũng chuyển sang phụ đề phần mềm
mở rộng quy mô. Có thể là chậm.

LƯU Ý:
Không bao giờ áp dụng cho phụ đề văn bản.

- xám đen
Chuyển đổi phụ đề hình ảnh sang thang độ xám. Có thể giúp làm cho DVD / Vobsubs màu vàng trông
Đẹp hơn.

LƯU Ý:
Không bao giờ áp dụng cho phụ đề văn bản.

- đường dẫn phụ =
Chỉ định các thư mục bổ sung để tìm kiếm phụ đề phù hợp với video. Nhiều
các thư mục có thể được phân tách bằng ":" (";" trên Windows). Các đường dẫn có thể tương đối hoặc
tuyệt đối. Các đường dẫn tương đối được diễn giải liên quan đến thư mục tệp video.

Ví dụ

Giả sử răng /path/to/video/video.avi được chơi và
--sub-path = sub: subtitles: / tmp / subs được chỉ định, mpv tìm kiếm
các tệp phụ đề trong các thư mục này:

· / path / to / video /

· / path / to / video / sub /

· / path / to / video / subtitles /

· / tmp / subs /

· NS phụ thư mục con cấu hình (thường là ~ / .config / mpv / sub /)

- khả năng hiển thị dưới mức, - không có khả năng hiển thị phụ
Có thể được sử dụng để tắt hiển thị phụ đề, nhưng vẫn chọn và giải mã chúng.

- sub-clear-on-seek
(Ít người biết đến, hiếm khi hữu ích.) Có thể được sử dụng để phát các tệp mkv bị hỏng có trùng lặp
Các trường ReadOrder. ReadOrder là trường đầu tiên trong phụ đề ASS kiểu Matroska
gói tin. Nó phải là duy nhất và libass sử dụng nó để loại bỏ nhanh chóng
các bản sao. Tùy chọn này vô hiệu hóa bộ nhớ đệm của phụ đề trên các lượt tìm kiếm, vì vậy sau khi tìm kiếm
libass không thể loại bỏ các gói phụ đề có cùng ReadOrder như các gói trước đó.

Cửa sổ
--title =
Đặt tiêu đề cửa sổ. Điều này được sử dụng cho cửa sổ video và nếu có thể, cũng thiết lập
tiêu đề luồng âm thanh.

Thuộc tính được mở rộng. (Nhìn thấy Bất động sản Sự bành trướng.)

Chú ý:
Điều này có nguy cơ gây ra việc sử dụng CPU đáng kể, tùy thuộc vào
các thuộc tính được sử dụng. Thay đổi tiêu đề cửa sổ thường là một thao tác chậm và nếu
Tiêu đề thay đổi mọi khung hình, quá trình phát lại có thể bị hủy hoại.

--screen =
Trong cấu hình nhiều màn hình (tức là một máy tính để bàn duy nhất trải dài trên nhiều
hiển thị), tùy chọn này cho mpv biết màn hình nào sẽ hiển thị video.

Ghi chú (X11)

Tùy chọn này không hoạt động bình thường với tất cả các trình quản lý cửa sổ. Trong những
trường hợp, bạn có thể thử sử dụng --hình học để định vị cửa sổ một cách rõ ràng.
Cũng có thể trình quản lý cửa sổ cung cấp các tính năng gốc để
kiểm soát các cửa sổ ứng dụng màn hình nên sử dụng.

Xem thêm --fs-màn hình.

--toàn màn hình, --fs
Phát lại toàn màn hình.

--fs-screen =
Trong cấu hình nhiều màn hình (tức là một máy tính để bàn duy nhất trải dài trên nhiều
hiển thị), tùy chọn này cho mpv biết màn hình nào sẽ chuyển sang chế độ toàn màn hình. Nếu như mặc định is
được cung cấp mpv sẽ dự phòng việc sử dụng hành vi tùy thuộc vào những gì người dùng
được cung cấp với màn tùy chọn.

Ghi chú (X11)

Tùy chọn này chỉ hoạt động bình thường với trình quản lý cửa sổ
hiểu EWMH _NET_WM_FULLSCREEN_MONITORS sự gợi ý.

Lưu ý (OS X)

tất cả các không hoạt động trên OS X và sẽ hoạt động như hiện hành.

Xem thêm --màn.

--fs-black-out-screen
Chỉ OS X. Bôi đen các màn hình khác khi chuyển sang chế độ toàn màn hình.

--keep-open =
Không kết thúc khi chơi hoặc tìm kiếm vượt quá phần cuối của tệp, và có
không phải tệp tiếp theo sẽ được phát (và --vòng Không được sử dụng). Thay vào đó, hãy tạm dừng trình phát.
Khi cố gắng tìm kiếm ngoài phần cuối của tệp, người chơi sẽ cố gắng tìm kiếm
khung cuối cùng.

Các đối số sau đây có thể được đưa ra:

Không Nếu tệp hiện tại kết thúc, hãy chuyển đến tệp tiếp theo hoặc kết thúc. (Vỡ nợ.)

Vâng Không kết thúc nếu tệp hiện tại là mục nhập danh sách phát cuối cùng. Tương đương
đến - mở cửa mà không cần đối số.

luôn luôn Như Vâng, nhưng cũng áp dụng cho các tệp trước mục nhập danh sách phát cuối cùng. Điều này
có nghĩa là quá trình phát lại sẽ không bao giờ tự động chuyển sang tệp tiếp theo.

LƯU Ý:
Tùy chọn này không được tôn trọng khi sử dụng --khung. Rõ ràng bỏ qua
tệp tiếp theo nếu ràng buộc sử dụng lực lượng cũng sẽ chấm dứt phát lại.

Ngoài ra, nếu có lỗi hoặc trường hợp bất thường xảy ra, người chơi vẫn có thể bỏ cuộc.

Kể từ mpv 0.6.0, điều này sẽ không tạm dừng nếu có tệp tiếp theo trong danh sách phát hoặc
danh sách phát được lặp lại. Gần như, quá trình này sẽ tạm dừng khi trình phát bình thường
thoát ra, nhưng trong thực tế có những trường hợp góc mà trường hợp này không phải như vậy (ví dụ:
mpv - mở cửa tập tin.mkv / dev / null sẽ phát file.mkv bình thường, sau đó không mở được
/ dev / null, sau đó thoát ra). (Trong mpv 0.8.0, luôn luôn đã được giới thiệu, khôi phục lại
cư xử.)

--force-window =
Tạo cửa sổ xuất video ngay cả khi không có video. Điều này có thể hữu ích khi
giả vờ rằng mpv là một ứng dụng GUI. Hiện tại, cửa sổ luôn có kích thước
640x480 và tùy thuộc vào --hình học, --tự động điều chỉnh, và các tùy chọn tương tự.

Chú ý:
Cửa sổ chỉ được tạo sau khi khởi tạo (để đảm bảo cửa sổ mặc định
vị trí vẫn hoạt động nếu kích thước video khác với --buộc-cửa sổ
kích thước cửa sổ mặc định). Đây có thể là sự cố nếu quá trình khởi tạo không hoạt động
hoàn hảo, chẳng hạn như khi mở URL với kết nối mạng kém hoặc đang mở
các tập tin video bị hỏng. Các lập tức chế độ có thể được sử dụng để tạo cửa sổ luôn
khi bắt đầu chương trình, nhưng điều này có thể gây ra các vấn đề khác.

--trên đỉnh
Làm cho cửa sổ trình phát luôn ở trên các cửa sổ khác.

Trên Windows, nếu được kết hợp với chế độ toàn màn hình, điều này khiến mpv được coi là
cửa sổ toàn màn hình độc quyền bỏ qua Trình quản lý cửa sổ trên màn hình.

--ranh giới, - không biên giới
Phát video với viền cửa sổ và đồ trang trí. Vì tính năng này được bật theo mặc định, hãy sử dụng
- không biên giới để vô hiệu hóa các trang trí cửa sổ tiêu chuẩn.

- trên tất cả-không gian làm việc
(Chỉ dành cho X11) Hiển thị cửa sổ video trên tất cả các màn hình ảo.

--geometry = <[W [xH]] [+ - x + -y]>, --geometry =
Điều chỉnh vị trí hoặc kích thước cửa sổ ban đầu. W và H đặt kích thước cửa sổ tính bằng pixel.
x và y đặt vị trí cửa sổ, được đo bằng pixel từ góc trên cùng bên trái của
ở góc trên bên trái của hình ảnh đang được hiển thị. Nếu một dấu phần trăm
(%) được đưa ra sau đối số, nó biến giá trị thành phần trăm của màn hình
kích thước theo hướng đó. Các vị trí được chỉ định tương tự như tiêu chuẩn X11
--hình học định dạng tùy chọn, trong đó ví dụ: + 10-50 có nghĩa là "đặt 10 pixel từ bên trái
đường viền và 50 pixel từ đường viền dưới "và" --20 + -10 "có nghĩa là" đặt 20 pixel
ngoài bên phải và 10 pixel ngoài đường viền trên cùng ".

Nếu một cửa sổ bên ngoài được chỉ định bằng cách sử dụng --rộng tùy chọn này, tùy chọn này bị bỏ qua.

Các tọa độ liên quan đến màn hình được cho với --màn cho đầu ra video
trình điều khiển hỗ trợ đầy đủ --màn.

LƯU Ý:
Nói chung chỉ được hỗ trợ bởi GUI VOs. Bỏ qua để mã hóa.

Ghi chú (X11)

Tùy chọn này không hoạt động bình thường với tất cả các trình quản lý cửa sổ.

Các ví dụ

50:40 Đặt cửa sổ tại x = 50, y = 40.

50%: 50%
Đặt cửa sổ ở giữa màn hình.

100%: 100%
Đặt cửa sổ ở góc dưới cùng bên phải của màn hình.

50% Đặt chiều rộng cửa sổ bằng một nửa chiều rộng màn hình. Chiều cao cửa sổ được đặt như vậy
rằng cửa sổ có tỷ lệ khung hình video.

50% x50%
Buộc chiều rộng và chiều cao của cửa sổ bằng một nửa chiều rộng và chiều cao của màn hình.
Sẽ hiển thị các đường viền màu đen để bù cho tỷ lệ khung hình video (với
hầu hết các VO và không có --không giữ được khía cạnh).

50% + 10 + 10
Đặt cửa sổ thành một nửa chiều rộng màn hình và đặt nó là 10 pixel
bên dưới / bên trái của góc trên cùng bên trái của màn hình.

Xem thêm --tự động điều chỉnh và --autofit-lớn hơn để lắp cửa sổ vào một kích thước nhất định
mà không thay đổi tỷ lệ khung hình.

--autofit = <[W [xH]]>
Đặt kích thước cửa sổ ban đầu thành kích thước tối đa được chỉ định bởi WxH, không hề thay đổi
tỷ lệ khung hình của cửa sổ. Kích thước được đo bằng pixel hoặc nếu một số
theo sau là một dấu phần trăm (%), tính bằng phần trăm của kích thước màn hình.

Tùy chọn này không bao giờ thay đổi tỷ lệ khung hình của cửa sổ. Nếu tỷ lệ khung hình
không khớp, kích thước của cửa sổ được giảm xuống cho đến khi nó vừa với kích thước được chỉ định.

Vị trí cửa sổ không được tính đến, cũng như không được sửa đổi bởi tùy chọn này (
trình quản lý cửa sổ vẫn có thể đặt cửa sổ khác nhau tùy thuộc vào kích thước). Sử dụng
--hình học để thay đổi vị trí cửa sổ. Hiệu ứng của nó được áp dụng sau đó
tùy chọn.

Xem --hình học để biết chi tiết cách xử lý điều này với thiết lập nhiều màn hình.

Sử dụng --autofit-lớn hơn thay vào đó nếu bạn chỉ muốn giới hạn kích thước tối đa của
cửa sổ, thay vì luôn luôn ép buộc kích thước cửa sổ.

Sử dụng --hình học nếu bạn muốn buộc cả chiều rộng và chiều cao của cửa sổ thành một
kích cỡ.

LƯU Ý:
Nói chung chỉ được hỗ trợ bởi GUI VOs. Bỏ qua để mã hóa.

Các ví dụ

70% Đặt chiều rộng cửa sổ bằng 70% kích thước màn hình, giữ nguyên tỷ lệ khung hình.

1000 Đặt chiều rộng cửa sổ thành 1000 pixel, giữ nguyên tỷ lệ khung hình.

70%: 60%
Làm cho cửa sổ càng lớn càng tốt, không rộng hơn 70%
chiều rộng màn hình hoặc cao hơn 60% chiều cao màn hình.

--autofit-large = <[W [xH]]>
Tùy chọn này hoạt động giống hệt như --tự động điều chỉnh, ngoại trừ kích thước cửa sổ chỉ được thay đổi
nếu cửa sổ sẽ lớn hơn kích thước được chỉ định.

Ví dụ

90% x80%
Nếu video lớn hơn 90% chiều rộng màn hình hoặc 80% màn hình
chiều cao, hãy thu nhỏ cửa sổ cho đến khi chiều rộng của nó bằng 90%
hoặc chiều cao của nó bằng 80% màn hình.

--autofit-small = <[W [xH]]>
Tùy chọn này hoạt động giống hệt như --tự động điều chỉnh, ngoại trừ việc nó đặt kích thước tối thiểu là
cửa sổ (giống như --autofit-lớn hơn đặt giá trị tối đa).

Ví dụ

500x500
Đặt cửa sổ rộng ít nhất 500 pixel và cao 500 pixel (tùy thuộc vào
trên tỷ lệ khung hình video, chiều rộng hoặc chiều cao sẽ lớn hơn 500 in
để giữ nguyên tỷ lệ khung hình).

--window-scale =
Thay đổi kích thước cửa sổ video thành nhiều (hoặc một phần nhỏ) của kích thước video. Tùy chọn này
được áp dụng trước đây --tự động điều chỉnh và các tùy chọn khác được áp dụng (vì vậy chúng ghi đè lên
Tùy chọn).

Ví dụ, --window-scale = 0.5 sẽ hiển thị cửa sổ bằng một nửa kích thước video.

--cursor-autohide =
Làm cho con trỏ chuột tự động ẩn sau một số mili giây nhất định. Không sẽ
tắt tính năng tự động ẩn con trỏ. luôn luôn nghĩa là con trỏ sẽ ở trạng thái ẩn.

--cursor-autohide-fs-chỉ
Nếu tùy chọn này được đưa ra, con trỏ luôn hiển thị ở chế độ cửa sổ. Trong
chế độ toàn màn hình, con trỏ được hiển thị hoặc ẩn theo --con trỏ-tự động ẩn.

--no-fixed-vo, --fixed-vo
--no-fixed-vo thực thi đóng và mở lại cửa sổ video cho nhiều tệp
(một (bỏ) lần khởi tạo cho mỗi tệp).

--force-rgba-osd-kết xuất
Thay đổi cách một số đầu ra video hiển thị OSD và phụ đề văn bản. Điều này không
thay đổi giao diện của phụ đề và chỉ có ý nghĩa về hiệu suất. Đối với VO
hỗ trợ hiển thị ASS gốc (như vdpau, OpenGL, direct3d), Điều này có thể là
nhanh hơn hoặc chậm hơn một chút, tùy thuộc vào trình điều khiển GPU và phần cứng. Đối với các VO khác,
điều này chỉ làm cho kết xuất chậm hơn.

--force-window-vị trí
Di chuyển mạnh mẽ cửa sổ đầu ra video của mpv đến vị trí mặc định bất cứ khi nào có
thay đổi thông số video, luồng video hoặc tệp. Điều này từng là mặc định
hành vi. Hiện tại chỉ ảnh hưởng đến X11 VO.

--heartbeat-cmd =
Lệnh được thực hiện cứ sau 30 giây trong khi phát lại qua hệ thống () - tức là sử dụng
cái vỏ. Thời gian giữa các lệnh có thể được tùy chỉnh với
- nhịp điệu-khoảng thời gian lựa chọn. Lệnh không chạy trong khi tạm dừng phát lại.

LƯU Ý:
mpv sử dụng lệnh này mà không cần kiểm tra. Bạn có trách nhiệm đảm bảo
nó không gây ra vấn đề bảo mật (ví dụ: đảm bảo sử dụng đường dẫn đầy đủ nếu "." là
trong đường dẫn của bạn như trên Windows). Nó cũng chỉ hoạt động khi phát video (tức là không
với - không có video nhưng làm việc với -vo = null).

Điều này có thể bị "lạm dụng" để vô hiệu hóa trình bảo vệ màn hình không hỗ trợ API X thích hợp
(Xem thêm --stop-screenaver). Nếu bạn nghĩ điều này quá phức tạp, hãy hỏi tác giả
của chương trình bảo vệ màn hình để hỗ trợ các API X thích hợp. Lưu ý rằng
--stop-screenaver hoàn toàn không ảnh hưởng đến mã nhịp tim.

Ví dụ cho xscreensaver

mpv --heartbeat-cmd = "xscreensaver-command -deactivate " hồ sơ

Ví dụ cho trình bảo vệ màn hình GNOME

mpv --heartbeat-cmd = "gnome-screenaver-command -P" hồ sơ

--heartbeat-khoảng =
Thời gian giữa --nhịp tim-cmd lệnh gọi tính bằng giây (mặc định: 30).

LƯU Ý:
Điều này không ảnh hưởng đến hoạt động bình thường của trình bảo vệ màn hình theo bất kỳ cách nào.

- không coi trọng, - gìn giữ
--không giữ được khía cạnh sẽ luôn kéo dài video đến kích thước cửa sổ và sẽ tắt
trình quản lý cửa sổ gợi ý rằng buộc tỷ lệ khung hình cửa sổ. (Bỏ qua ở chế độ toàn màn hình
chế độ.)

--no-keepaspect-window, - cửa sổ ngắm cảnh
- cửa sổ ngắm cảnh (mặc định) sẽ khóa kích thước cửa sổ theo khía cạnh video.
--no-keepaspect-window vô hiệu hóa hành vi này và thay vào đó sẽ thêm các thanh màu đen nếu
khía cạnh cửa sổ và khía cạnh video không khớp. Điều này có thực sự hoạt động hay không phụ thuộc vào
Chương trình phụ trợ VO. (Bỏ qua ở chế độ toàn màn hình.)

--monitoraspect =
Đặt tỷ lệ khung hình của màn hình hoặc màn hình TV của bạn. Giá trị 0 vô hiệu hóa giá trị trước đó
cài đặt (ví dụ: trong tệp cấu hình). Ghi đè --monitorpixelaspect thiết lập nếu
kích hoạt.

Xem thêm --monitorpixelaspect và --video-khía cạnh.

Các ví dụ

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

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

--monitorpixelaspect =
Đặt kích thước của một pixel trên màn hình hoặc màn hình TV của bạn (mặc định: 1). Một giá trị
của 1 có nghĩa là các pixel vuông (đúng cho (hầu hết?) tất cả các màn hình LCD). Xem thêm --monitoraspect
và --video-khía cạnh.

--stop-screenaver, --no-stop-screenaver
Tắt trình bảo vệ màn hình (hoặc trình trống màn hình và các cơ chế tương tự) khi khởi động và
bật lại khi thoát (mặc định: có). Trình bảo vệ màn hình luôn được bật lại khi
trình phát bị tạm dừng.

Điều này không được hỗ trợ trên tất cả các nền tảng hoặc đầu ra video. Đôi khi nó là
được triển khai, nhưng không hoạt động (thường xảy ra trên GNOME). Bạn có thể
làm việc này xung quanh bằng cách sử dụng --nhịp tim-cmd thay thế.

--wid =
Điều này yêu cầu mpv đính kèm vào một cửa sổ hiện có. Nếu VO được chọn hỗ trợ
tùy chọn này, nó sẽ sử dụng cửa sổ đó để xuất video. mpv sẽ chia tỷ lệ video thành
kích thước của cửa sổ này và sẽ thêm các thanh màu đen để bù đắp nếu tỷ lệ khung hình
của video là khác nhau.

Trên X11, ID được hiểu là Cửa sổ trên X11. Không giống như MPlayer / mplayer2, mpv
luôn tạo cửa sổ riêng và đặt cửa sổ widget làm cửa sổ chính. Cửa sổ sẽ
luôn được thay đổi kích thước để che hoàn toàn cửa sổ mẹ. Giá trị 0 được diễn giải
đặc biệt, và mpv sẽ vẽ trực tiếp trên cửa sổ gốc.

Trên win32, ID được hiểu là CTNH. Chuyển nó dưới dạng giá trị được truyền tới intptr_t. mpv
sẽ tạo cửa sổ riêng và đặt cửa sổ widget làm cửa sổ chính, giống như với X11.

Trên OSX / Cocoa, ID được hiểu là NSView *. Chuyển nó dưới dạng giá trị được truyền tới intptr_t.
mpv sẽ tạo chế độ xem phụ của riêng nó. Bởi vì OSX không hỗ trợ nhúng cửa sổ của
các quy trình nước ngoài, điều này chỉ hoạt động với libmpv và sẽ bị lỗi khi được sử dụng từ
dòng lệnh.

--no-window-drag
Không di chuyển cửa sổ khi nhấp vào nó và di chuyển con trỏ chuột.

--x11-tên
Đặt tên lớp cửa sổ cho các phương thức xuất video dựa trên X11.

--x11-netwm =
(Chỉ dành cho X11) Kiểm soát việc sử dụng các tính năng của giao thức NetWM.

Điều này có thể hữu ích hoặc không với các trình quản lý cửa sổ bị hỏng. Điều này cung cấp một số
chức năng đã được triển khai bởi hiện đã bị loại bỏ --fstype Lựa chọn. Thật,
nhà phát triển không biết tùy chọn này cần thiết ở mức độ nào, vì vậy
phản hồi được hoan nghênh.

Cụ thể, Vâng sẽ buộc sử dụng hỗ trợ toàn màn hình NetWM, ngay cả khi không
được quảng cáo bởi WM. Điều này có thể hữu ích cho các WM bị phá vỡ có chủ đích, như
XMonad. (XMonad được cho là không quảng cáo hỗ trợ toàn màn hình, vì Flash sử dụng
nó. Rõ ràng, các ứng dụng muốn sử dụng toàn màn hình đều phải
bỏ qua các gợi ý hỗ trợ NetWM hoặc đưa ra giải pháp thay thế. XMonad xấu hổ vì
cố tình phá vỡ các giao thức X (như thể X chưa đủ tệ).

Theo mặc định, hỗ trợ NetWM được tự động phát hiện (tự động).

Tùy chọn này có thể bị xóa trong tương lai.

--x11-bypass-compositor =
Nếu được đặt thành Vâng (mặc định), sau đó yêu cầu trình tổng hợp hủy chuyển hướng cửa sổ mpv. Cái này
sử dụng _NET_WM_BYPASS_COMPOSITOR sự gợi ý.

Disc Thiết bị (Devices)
--cdrom-device =
Chỉ định thiết bị CD-ROM (mặc định: / dev / cdrom).

--dvd-device =
Chỉ định thiết bị DVD hoặc tên tệp .iso (mặc định: / dev / dvd). Bạn cũng có thể chỉ định một
thư mục chứa các tệp đã sao chép trực tiếp trước đó từ đĩa DVD (ví dụ:
từ vựng).

Ví dụ

mpv đĩa DVD:// --dvd-device = / path / to / dvd /

--bluray-device =
(Chỉ Blu-ray) Chỉ định vị trí đĩa Blu-ray. Phải là một thư mục có Blu-ray
cấu trúc.

Ví dụ

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

--bluray-angle =
Một số đĩa Blu-ray chứa các cảnh có thể được xem từ nhiều góc độ. Cái này
tùy chọn cho mpv biết góc nào để sử dụng (mặc định: 1).

--cdda -...
Các tùy chọn này có thể được sử dụng để điều chỉnh tính năng đọc CD Audio của mpv.

--cdda-speed =
Đặt tốc độ quay đĩa CD.

--cdda-paranoia = <0-2>
Đặt mức độ hoang tưởng. Các giá trị khác 0 dường như phá vỡ quá trình phát lại bất kỳ thứ gì ngoại trừ
bản nhạc đầu tiên.

0 tắt kiểm tra (mặc định)

1 chỉ kiểm tra chồng chéo

2 chỉnh sửa và xác minh dữ liệu đầy đủ

--cdda-sector-size =
Đặt kích thước đọc nguyên tử.

--cdda-trùng lặp =
Buộc tìm kiếm chồng chéo tối thiểu trong quá trình xác minh các ngành.

--cdda-toc-thiên vị
Giả sử rằng độ lệch đầu của rãnh 1 như được báo cáo trong TOC sẽ là
được đánh địa chỉ là LBA 0. Một số đĩa cần điều này để xác định ranh giới bản nhạc một cách chính xác.

--cdda-toc-offset =
Thêm cung cấp cho các giá trị được báo cáo khi giải quyết các tuyến đường. Có lẽ
tiêu cực.

--cdda-bỏ qua =
(Không bao giờ) chấp nhận việc xây dựng lại dữ liệu không hoàn hảo.

--cdda-cdtext =
In văn bản CD. Điều này bị tắt theo mặc định, vì nó làm hỏng hiệu suất với
Ổ đĩa CD-ROM không rõ lý do.

--dvd-speed =
Cố gắng giới hạn tốc độ DVD (mặc định: 0, không thay đổi). Tốc độ cơ bản của DVD là 1385 kB / s, vì vậy một
Ổ 8x có thể đọc với tốc độ lên đến 11080 kB / s. Tốc độ chậm hơn làm cho ổ đĩa nhiều hơn
Yên tĩnh. Để xem DVD, 2700 kB / s phải đủ yên tĩnh và nhanh. mpv đặt lại
tốc độ đến giá trị mặc định của ổ đĩa khi đóng. Giá trị của ít nhất 100 tốc độ trung bình trong
kB / s. Giá trị nhỏ hơn 100 có nghĩa là bội số của 1385 kB / s, tức là --dvd-speed = 8 chọn
11080 kB / s.

LƯU Ý:
Bạn cần quyền ghi vào thiết bị DVD để thay đổi tốc độ.

--dvd-angle =
Một số DVD chứa các cảnh có thể được xem từ nhiều góc độ. Tùy chọn này
cho mpv biết góc nào để sử dụng (mặc định: 1).

Equalizer
- độ sáng = <-100-100>
Điều chỉnh độ sáng của tín hiệu video (mặc định: 0). Không được hỗ trợ bởi tất cả video
trình điều khiển đầu ra.

--contrast = <-100-100>
Điều chỉnh độ tương phản của tín hiệu video (mặc định: 0). Không được hỗ trợ bởi tất cả video
trình điều khiển đầu ra.

--saturation = <-100-100>
Điều chỉnh độ bão hòa của tín hiệu video (mặc định: 0). Bạn có thể nhận được thang độ xám
đầu ra với tùy chọn này. Không được hỗ trợ bởi tất cả các trình điều khiển đầu ra video.

--gamma = <-100-100>
Điều chỉnh gamma của tín hiệu video (mặc định: 0). Không được hỗ trợ bởi tất cả video
trình điều khiển đầu ra.

--hue = <-100-100>
Điều chỉnh màu sắc của tín hiệu video (mặc định: 0). Bạn có thể nhận được một phủ định có màu của
hình ảnh với tùy chọn này. Không được hỗ trợ bởi tất cả các trình điều khiển đầu ra video.

bộ giải mã
--demuxer = <[+] tên>
Buộc loại demuxer. Sử dụng dấu '+' trước tên để buộc nó; cái này sẽ bỏ qua một số
Séc. Đặt tên demuxer như được in bởi --demuxer = trợ giúp.

--demuxer-lavf-analyuration =
Độ dài tối đa tính bằng giây để phân tích thuộc tính luồng.

--demuxer-lavf-probescore = <1-100>
Điểm thăm dò libavformat yêu cầu tối thiểu. Giá trị thấp hơn sẽ yêu cầu ít dữ liệu hơn
được tải (làm cho các luồng bắt đầu nhanh hơn), nhưng làm cho việc phát hiện định dạng tệp kém đáng tin cậy hơn.
Có thể được sử dụng để buộc các demuxer libavformat được phát hiện tự động, ngay cả khi libavformat
coi việc phát hiện không đủ tin cậy. (Mặc định: 26.)

--demuxer-lavf-allow-mimetype =
Cho phép lấy định dạng từ kiểu HTTP MIME (mặc định: có). Đặt điều này thành không trong
trường hợp phát mọi thứ từ HTTP không thành công một cách bí ẩn, mặc dù các tệp giống nhau hoạt động
từ đĩa cục bộ.

Điều này là mặc định để giảm độ trễ khi mở các luồng HTTP.

--demuxer-lavf-format =
Buộc một trình demuxer libavformat cụ thể.

--demuxer-lavf-hacks =
Theo mặc định, một số định dạng sẽ được xử lý khác với các định dạng khác bằng cách
kiểm tra rõ ràng cho họ. Hầu hết những điều này bù đắp cho những điều kỳ lạ hoặc không hoàn hảo
hành vi từ các demuxer libavformat. Đi qua Không vô hiệu hóa những điều này. Để gỡ lỗi và
chỉ thử nghiệm.

--demuxer-lavf-genpts-mode =
Chế độ lấy ra các giá trị PTS gói bị thiếu từ DTS gói. lavf cho phép
libavformat's quý tộc tùy chọn. Không vô hiệu hóa nó. Điều này từng được bật theo mặc định,
nhưng sau đó nó được coi là không cần thiết nữa. Kích hoạt điều này có thể hữu ích với
vấn đề về dấu thời gian hoặc làm cho chúng tồi tệ hơn.

--demuxer-lavf-o = = [, = [, ...]]
Chuyển AVOptions đến libavformat demuxer.

Lưu ý, một bản vá để làm cho o= không cần thiết và vượt qua tất cả các tùy chọn không xác định thông qua
Hệ thống AVOption được chào đón. Danh sách đầy đủ các AVOptions có thể được tìm thấy trong FFmpeg
thủ công. Lưu ý rằng một số tùy chọn có thể xung đột với tùy chọn mpv.

Ví dụ

--demuxer-lavf-o = fflags = + burdx

--demuxer-lavf-probesize =
Lượng dữ liệu tối đa để thăm dò trong giai đoạn phát hiện. Trong trường hợp của MPEG-TS
giá trị này xác định số lượng gói TS tối đa để quét.

--demuxer-lavf-buffersize =
Kích thước của bộ đệm đọc luồng được phân bổ cho libavformat theo byte (mặc định: 32768).
Giảm kích thước có thể làm giảm độ trễ. Lưu ý rằng libavformat có thể phân bổ lại
đệm nội bộ, hoặc không sử dụng hết tất cả.

--demuxer-lavf-cryptokey =
Khóa mã hóa mà demuxer nên sử dụng. Đây là dữ liệu nhị phân thô của khóa
được chuyển đổi thành một chuỗi thập lục phân.

--demuxer-mkv-phụ đề-preroll, --mkv-phụ đề-preroll
Cố gắng hơn nữa để hiển thị phụ đề mềm được nhúng khi tìm kiếm một nơi nào đó. Thông thường, nó có thể
xảy ra rằng phụ đề tại mục tiêu tìm kiếm không được hiển thị do một số vùng chứa
các định dạng tệp được thiết kế. Phụ đề chỉ xuất hiện nếu tìm kiếm trước hoặc chính xác
đến vị trí mà phụ đề xuất hiện đầu tiên. Để làm cho điều này tồi tệ hơn, phụ đề thường
được hẹn giờ để xuất hiện một lượng rất nhỏ trước khung video được liên kết, để
tìm kiếm khung video thường không làm giảm chất lượng phụ đề ở vị trí đó.

Bật tùy chọn này làm cho trình giải mã bắt đầu đọc dữ liệu một chút trước khi tìm kiếm
mục tiêu, để phụ đề xuất hiện chính xác. Lưu ý rằng điều này làm cho việc tìm kiếm chậm hơn,
và không được đảm bảo luôn hoạt động. Nó chỉ hoạt động nếu phụ đề đủ gần
đến mục tiêu tìm kiếm.

Chỉ hoạt động với demuxer Matroska nội bộ. Luôn được bật cho tuyệt đối và
hr-seeks và tùy chọn này thay đổi hành vi chỉ với những tìm kiếm tương đối hoặc không chính xác.

Bạn có thể sử dụng --demuxer-mkv-phụ đề-preroll-giây tùy chọn để chỉ định bao nhiêu dữ liệu
demuxer nên đọc trước nhiều nhất để tìm các gói phụ đề có thể
chồng lên nhau. Đặt giá trị này thành 0 sẽ vô hiệu hóa cơ chế preroll này một cách hiệu quả. Cài đặt
một giá trị rất lớn có thể làm cho việc tìm kiếm rất chậm và một giá trị cực kỳ lớn sẽ
hoàn toàn đọc lại toàn bộ tệp từ đầu để tìm kiếm mục tiêu trên mỗi lần tìm kiếm - tìm kiếm
có thể trở nên chậm hơn về cuối tệp. Các chi tiết lộn xộn và giá trị
thực sự được làm tròn xuống cụm với khung hình chính video trước đó.

Một số tệp, đặc biệt là các tệp được trộn với các phiên bản mkvmerge mới hơn, có thông tin
được nhúng có thể được sử dụng để xác định gói phụ đề nào trùng lặp với một tìm kiếm
Mục tiêu. Trong những trường hợp này, mpv sẽ giảm lượng dữ liệu đọc xuống mức tối thiểu.
(Mặc dù nó vẫn sẽ đọc tất cả các dữ liệu giữa cụm chứa đầu tiên
gói phụ đề mong muốn và mục tiêu tìm kiếm.)

Xem thêm --hr-seek-demuxer-offset Lựa chọn. Tùy chọn này có thể đạt được hiệu quả tương tự,
nhưng chỉ khi hr-seek đang hoạt động. Nó hoạt động với bất kỳ demuxer nào, nhưng làm cho việc tìm kiếm nhiều
chậm hơn, vì nó phải giải mã dữ liệu âm thanh và video thay vì chỉ bỏ qua.

--mkv-phụ đề-preroll là một bí danh không được dùng nữa.

--demuxer-mkv-subtitle-preroll-secs =
Xem --demuxer-mkv-phụ đề-preroll.

--demuxer-mkv-probe-video-time =
Khi mở tệp, hãy tìm đến cuối tệp và kiểm tra dấu thời gian cuối cùng
gói video có và báo cáo đó là thời lượng tệp. Điều này hoàn toàn dành cho
chỉ tương thích với Haali. Trong chế độ này, có thể việc mở sẽ
chậm hơn (đặc biệt là khi phát qua http) hoặc hành vi với các tệp bị hỏng là
tệ hơn nhiều. Vì vậy, không sử dụng tùy chọn này.

Vâng chế độ chỉ sử dụng chỉ mục và đọc một số lượng nhỏ các khối từ cuối
của tệp. Các Full chế độ thực sự duyệt qua toàn bộ tệp và có thể tạo ra một
ước tính đáng tin cậy ngay cả khi không có chỉ mục (chẳng hạn như các tệp một phần).

--demuxer-rawaudio-channel =
Số kênh (hoặc bố cục kênh) nếu --demuxer = rawaudio được sử dụng (mặc định:
âm thanh nổi).

--demuxer-rawaudio-format =
Định dạng mẫu cho --demuxer = rawaudio (mặc định: s16le). Sử dụng
--demuxer-rawaudio-format = help để có được danh sách tất cả các định dạng.

--demuxer-rawaudio-rate =
Tỷ lệ mẫu cho --demuxer = rawaudio (mặc định: 44 kHz).

--demuxer-rawvideo-fps =
Tỷ lệ khung hình trên giây cho --demuxer = rawvideo (mặc định: 25.0).

--demuxer-rawvideo-w = , --demuxer-rawvideo-h =
Kích thước hình ảnh tính bằng pixel cho --demuxer = rawvideo.

Ví dụ

Phát một mẫu YUV thô:

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

--demuxer-rawvideo-format =
Không gian màu (bốncc) trong hệ thập lục phân hoặc chuỗi cho --demuxer = rawvideo (vỡ nợ: YV12).

--demuxer-rawvideo-mp-format =
Không gian màu theo định dạng video nội bộ cho --demuxer = rawvideo. Sử dụng
--demuxer-rawvideo-mp-format = help để biết danh sách các định dạng có thể có.

--demuxer-rawvideo-codec =
Đặt codec video thay vì chọn codec rawvideo khi sử dụng
--demuxer = rawvideo. Điều này sử dụng các giá trị giống như tên codec trong --vd (nhưng nó có
không chấp nhận tên bộ giải mã).

--demuxer-rawvideo-size =
Kích thước khung hình tính bằng byte khi sử dụng --demuxer = rawvideo.

--demuxer-max-packets = , --demuxer-max-byte =
Điều này kiểm soát lượng demuxer được phép lưu vào bộ đệm phía trước. Demuxer sẽ
thường cố gắng đọc trước nhiều khi cần thiết hoặc nhiều như được yêu cầu với
--demuxer-readahead-giây. Các --demuxer-max -... các tùy chọn có thể được sử dụng để hạn chế
đầu đọc tối đa. Điều này hạn chế quá nhiều đầu đọc trong trường hợp tệp bị hỏng hoặc
phát lại được khử đồng bộ hóa. Demuxer sẽ ngừng đọc các gói bổ sung ngay sau khi một
trong số các giới hạn đạt được. (Các giới hạn vẫn có thể bị vượt quá một chút do
lý do kỹ thuật.)

Đặt các giới hạn này cao hơn nếu bạn nhận được cảnh báo tràn hàng đợi gói và bạn nghĩ
có thể phát lại bình thường với hàng đợi gói lớn hơn.

Xem - tùy chọn danh sách cho các giá trị mặc định và phạm vi giá trị.

--demuxer-thread =
Chạy trình demuxer trong một chuỗi riêng biệt và để nó tìm nạp trước một số lượng nhất định
gói tin (mặc định: có). Bật tính năng này có thể dẫn đến phát lại mượt mà hơn, nhưng trên
mặt khác có thể gây chậm trễ cho việc tìm kiếm hoặc theo dõi chuyển đổi.

--demuxer-readahead-secs =
If --demuxer-thread được bật, điều này kiểm soát lượng demuxer nên đệm
trước sau vài giây (mặc định: 1). Miễn là không có gói nào có sự khác biệt về dấu thời gian
cao hơn số lượng đầu đọc so với gói cuối cùng được trả về
bộ giải mã, bộ giải mã tiếp tục đọc.

Lưu ý rằng --cache-giây tùy chọn sẽ ghi đè giá trị này nếu bộ đệm ẩn được bật,
và giá trị lớn hơn.

(Giá trị này có xu hướng mờ do nhiều định dạng tệp không lưu trữ tuyến tính
dấu thời gian.)

--force-seekable =
Nếu người chơi nghĩ rằng phương tiện không thể tìm kiếm được (ví dụ: phát từ một đường ống, hoặc
đó là một luồng http với một máy chủ không hỗ trợ các yêu cầu phạm vi), tìm kiếm sẽ
bị vô hiệu hóa. Tùy chọn này có thể bắt buộc phải kích hoạt nó. Đối với các tìm kiếm trong bộ nhớ cache,
có một cơ hội tốt để thành công.

Đầu vào
--lặp lại phím gốc
Sử dụng cài đặt hệ thống cho độ trễ và tốc độ gõ phím, thay vì --input-ar-delay và
--input-ar-rate. (Điều này có áp dụng hay không phụ thuộc vào phụ trợ VO và cách nó xử lý
nhập bàn phím. Không áp dụng cho đầu vào thiết bị đầu cuối.)

--input-ar-delay
Chậm trễ tính bằng mili giây trước khi chúng tôi bắt đầu tự động chạy lại khóa (0 để tắt).

--input-ar-rate
Số lần nhấn phím để tạo mỗi giây khi tự động chạy lại.

--input-conf =
Chỉ định tệp cấu hình đầu vào khác với vị trí mặc định trong mpv
thư mục cấu hình (thường là ~ / .config / mpv / input.conf).

--no-input-default-ràng buộc
Tắt liên kết khóa mpv mặc định (tích hợp).

--input-cmdlist
In tất cả các lệnh có thể liên kết với các phím.

--input-doubleclick-time =
Thời gian tính bằng mili giây để nhận ra hai lần nhấn nút liên tiếp khi nhấp đúp
(mặc định: 300).

--danh sách khóa đầu vào
In tất cả các phím có thể được liên kết với các lệnh.

--input-key-XVo-size = <2-65000>
Chỉ định kích thước của FIFO đệm các sự kiện chính (mặc định: 7). Nếu nó quá
một số sự kiện nhỏ có thể bị mất. Nhược điểm chính của việc đặt nó thành rất lớn
giá trị là nếu bạn giữ một phím kích hoạt một số lệnh đặc biệt chậm thì
trình phát có thể không phản hồi trong khi nó xử lý tất cả các lệnh đã xếp hàng đợi.

--kiểm tra đầu vào
Chế độ kiểm tra đầu vào. Thay vì thực hiện các lệnh khi nhấn phím, mpv sẽ hiển thị
các phím và các lệnh liên kết trên OSD. Phải được sử dụng với một video giả và
các cách thông thường để thoát trình phát sẽ không hoạt động (các ràng buộc chính thường thoát sẽ
chỉ được hiển thị trên OSD, giống như bất kỳ ràng buộc nào khác). Xem INPUT.CONF.

--input-file =
Đọc lệnh từ tệp đã cho. Hầu hết hữu ích với FIFO. Vì mpv 0.7.0 cũng
hiểu các lệnh JSON (xem JSON IPC), nhưng bạn không thể nhận được câu trả lời hoặc sự kiện. Sử dụng
--input-unix-socket cho một cái gì đó hai chiều. Trên MS Windows, các lệnh JSON là
Không có sẵn.

Điều này cũng có thể chỉ định một bộ mô tả tệp trực tiếp với fd: // N (Chỉ UNIX). Trong này
trường hợp, các câu trả lời JSON sẽ được viết nếu FD có thể ghi được.

LƯU Ý:
Khi tệp đã cho là FIFO mpv sẽ mở cả hai đầu, vì vậy bạn có thể thực hiện một số bỏ lỡ
"tìm kiếm 10 " > mp_pipe và đường ống sẽ vẫn hợp lệ.

--input-thiết bị đầu cuối, - không có đầu vào-đầu cuối
- không có đầu vào-đầu cuối ngăn người chơi đọc các sự kiện chính từ tiêu chuẩn
đầu vào. Hữu ích khi đọc dữ liệu từ đầu vào tiêu chuẩn. Điều này được tự động bật
khi nào - được tìm thấy trên dòng lệnh. Có những tình huống bạn phải đặt nó
theo cách thủ công, ví dụ: nếu bạn mở / dev / stdin (hoặc tương đương trên hệ thống của bạn), sử dụng stdin
trong danh sách phát hoặc định đọc từ stdin sau này qua tệp tải hoặc danh sách tải
lệnh nô lệ.

--input-unix-socket =
Bật hỗ trợ IPC và tạo ổ cắm nghe tại đường dẫn nhất định.

Xem JSON IPC để biết thêm chi tiết.

Không khả dụng trên MS Windows.

--input-appleremote =
(Chỉ OS X) Bật / tắt hỗ trợ Apple Remote. Được bật theo mặc định (ngoại trừ
libmpv).

--input-con trỏ, - không có đầu vào-con trỏ
Cho phép mpv nhận các sự kiện con trỏ do trình điều khiển đầu ra video báo cáo. Cần thiết
để sử dụng OSC hoặc để chọn các nút trong menu DVD. Hỗ trợ phụ thuộc vào VO
đang sử dụng.

--input-media-key =
(Chỉ dành cho OS X) Bật / tắt hỗ trợ phím đa phương tiện. Được bật theo mặc định (ngoại trừ
libmpv).

--input-right-alt-gr, --no-input-right-alt-gr
(Chỉ dành cho cacao và Windows) Sử dụng phím Alt bên phải làm Alt Gr để tạo đặc biệt
nhân vật. Nếu bị vô hiệu hóa, hãy đếm phím Alt bên phải làm phím bổ trợ Alt. Được kích hoạt bởi
mặc định.

--input-vo-keyboard =
Tắt tất cả tính năng nhập bằng bàn phím cho VO không thể tham gia vào bàn phím thích hợp
điều phối đầu vào. Có thể không ảnh hưởng đến tất cả các VO. Nói chung chỉ hữu ích cho việc nhúng.

Trên X11, một cửa sổ phụ có bật tính năng nhập liệu sẽ lấy tất cả các đầu vào bàn phím miễn là nó
1. con của cửa sổ được lấy nét và 2. con chuột ở bên trong cửa sổ phụ. Các
có thể lấy cắp tất cả đầu vào bàn phím từ ứng dụng nhúng cửa sổ mpv,
và mặt khác, cửa sổ mpv sẽ không nhận được đầu vào nếu con chuột ở bên ngoài
của cửa sổ mpv, ngay cả khi mpv có tiêu điểm. Bộ công cụ hiện đại giải quyết vấn đề này
hành vi X11 kỳ lạ, nhưng việc nhúng các cửa sổ nước ngoài một cách ngây thơ đã phá vỡ nó.

Cách duy nhất để xử lý điều này một cách hợp lý là sử dụng giao thức XEmbed,
được thiết kế để giải quyết những vấn đề này. GTK cung cấp GtkSocket, hỗ trợ XEmbed. Qt
dường như không cung cấp bất kỳ thứ gì hoạt động trong các phiên bản mới hơn.

Nếu trình nhúng hỗ trợ XEmbed, đầu vào sẽ hoạt động với các cài đặt mặc định và với
tùy chọn này bị vô hiệu hóa. Lưu ý rằng ràng buộc đầu vào mặc định bị tắt theo mặc định trong
libmpv cũng vậy - nó phải được bật nếu bạn muốn các liên kết khóa mặc định mpv.

(Tùy chọn này đã được đổi tên từ --input-x11-bàn phím.)

--input-app-event =
(Chỉ OS X) Bật / tắt các sự kiện bàn phím trên toàn ứng dụng để bàn phím đó
các phím tắt có thể được xử lý mà không cần cửa sổ. Được bật theo mặc định (ngoại trừ
libmpv).

OSD
--osc, --no-osc
Có tải bộ điều khiển trên màn hình hay không (mặc định: có).

--no-osd-bar, --osd-thanh
Tắt hiển thị thanh OSD. Điều này sẽ làm cho một số thứ (như tìm kiếm) sử dụng OSD
tin nhắn văn bản thay vì thanh.

Bạn có thể định cấu hình điều này trên cơ sở từng lệnh trong input.conf bằng cách sử dụng osd- tiền tố,
xem Đầu vào lệnh tiền tố. Nếu bạn muốn tắt hoàn toàn OSD, hãy sử dụng
--osd-level = 0.

--osd-time =
Đặt thời lượng của tin nhắn OSD tính bằng mili giây (mặc định: 1000).

--osd-font = , --sub-text-font =
Chỉ định phông chữ để sử dụng cho OSD và cho phụ đề không chỉ định
phông chữ cụ thể. Mặc định là sans-serif.

Các ví dụ

· --osd-font = 'Bitstream Vera Không'

· --osd-font = 'MS Truyện tranh Không'

LƯU Ý:
- sub-text-font tùy chọn (và hầu hết các tùy chọn khác - văn bản phụ- tùy chọn) bị bỏ qua khi
Phụ đề ASS được hiển thị, trừ khi --no-sub-ass tùy chọn được chỉ định.

Điều này được sử dụng để hỗ trợ các mẫu fontconfig. Bắt đầu với libass 0.13.0, cái này
đã ngưng làm việc.

--osd-font-size = , --sub-text-font-size =
Chỉ định kích thước phông chữ OSD / phụ. Đơn vị là kích thước tính bằng pixel được chia tỷ lệ tại một cửa sổ
chiều cao là 720. Kích thước pixel thực tế được chia tỷ lệ với chiều cao cửa sổ: nếu
chiều cao cửa sổ lớn hơn hoặc nhỏ hơn 720, kích thước thực của văn bản sẽ tăng lên
hoặc giảm.

Mặc định: 55.

--osd-msg1 =
Hiển thị chuỗi này dưới dạng thông báo trên OSD với OSD mức 1 (hiển thị theo mặc định). Các
tin nhắn sẽ được hiển thị theo mặc định và miễn là không có tin nhắn nào khác che nó và
Mức OSD không thay đổi (xem - cấposd). Mở rộng thuộc tính; thấy Bất động sản
Sự bành trướng.

--osd-msg2 =
Tương tự như --osd-tin nhắn1, nhưng đối với OSD cấp 2. Nếu đây là một chuỗi trống (mặc định),
thì thời gian phát lại được hiển thị.

--osd-msg3 =
Tương tự như --osd-tin nhắn1, nhưng đối với OSD cấp 3. Nếu đây là một chuỗi trống (mặc định),
thì thời gian phát lại, thời lượng và một số thông tin khác được hiển thị.

Điều này cũng được sử dụng cho show_tiến trình lệnh (theo mặc định được ánh xạ tới P), hoặc trong
một số trường hợp không mặc định khi tìm kiếm.

--osd-trạng thái-tin nhắn là một di sản tương đương (nhưng với một sự khác biệt nhỏ).

--osd-status-msg =
Hiển thị một chuỗi tùy chỉnh trong khi phát lại thay vì văn bản trạng thái tiêu chuẩn. Cái này
ghi đè văn bản trạng thái được sử dụng cho --osd-level = 3, khi sử dụng show_tiến trình
lệnh (theo mặc định được ánh xạ tới P), hoặc trong một số trường hợp không mặc định khi tìm kiếm.
Mở rộng thuộc tính. Xem Bất động sản Sự bành trướng.

Tùy chọn này đã được thay thế bằng --osd-tin nhắn3. Sự khác biệt duy nhất là cái này
tùy chọn ngầm bao gồm $ {osd-sym-cc}. Tùy chọn này bị bỏ qua nếu --osd-tin nhắn3 is
không rỗng.

--osd-Playing-msg =
Hiển thị thông báo trên OSD khi bắt đầu phát lại. Chuỗi được mở rộng cho các thuộc tính,
ví dụ --osd-Playing-msg = 'tệp: $ {filename} ' sẽ hiển thị thông báo tập tin: tiếp theo
một khoảng trắng và tên tệp hiện đang phát.

Xem Bất động sản Sự bành trướng.

--osd-bar-align-x = <-1-1>
Vị trí của thanh OSD. -1 ở ngoài cùng bên trái, 0 ở giữa, 1 ở ngoài cùng bên phải. Phân số
giá trị (như 0.5) được cho phép.

--osd-bar-align-y = <-1-1>
Vị trí của thanh OSD. -1 là trên cùng, 0 là chính giữa, 1 là dưới cùng. Giá trị phân số
(như 0.5) được cho phép.

--osd-bar-w = <1-100>
Chiều rộng của thanh OSD, tính theo phần trăm chiều rộng màn hình (mặc định: 75). Một giá trị của
50 có nghĩa là thanh có chiều rộng bằng một nửa màn hình.

--osd-bar-h = <0.1-50>
Chiều cao của thanh OSD, tính theo phần trăm chiều cao của màn hình (mặc định: 3.125).

--osd-back-color = , --sub-text-back-color =
Xem --osd-màu. Màu được sử dụng cho OSD / nền văn bản phụ.

--osd-dim = <0..20.0>, --sub-text-dim = <0..20.0>
Yếu tố mờ Gaussian. 0 có nghĩa là không có hiệu ứng mờ nào được áp dụng (mặc định).

--osd-bold = , --sub-text-bold =
Định dạng văn bản trên chữ in đậm.

--osd-border-color = , --sub-text-border-color =
Xem --osd-màu. Màu được sử dụng cho viền phông chữ OSD / phụ.

LƯU Ý:
bỏ qua khi --osd-back-màu/- sub-text-back-color được chỉ định (hoặc nhiều hơn
chính xác: khi tùy chọn đó không được đặt thành hoàn toàn trong suốt).

--osd-border-size = , --sub-text-border-size =
Kích thước của viền phông chữ OSD / phụ tính bằng pixel được chia tỷ lệ (xem --osd-cỡ chữ để biết chi tiết).
Giá trị 0 sẽ vô hiệu hóa các đường viền.

Mặc định: 3.

--osd-color = , --sub-text-color =
Chỉ định màu được sử dụng cho phụ đề văn bản OSD / chưa định kiểu.

Màu sắc được chỉ định trong biểu mẫu r / g / b, trong đó mỗi thành phần màu được chỉ định
dưới dạng số trong phạm vi từ 0.0 đến 1.0. Cũng có thể chỉ định độ trong suốt
bằng cách sử dụng r / g / b / a, trong đó giá trị alpha 0 có nghĩa là hoàn toàn trong suốt và 1.0 có nghĩa là
mờ mịt. Nếu thành phần alpha không được đưa ra, màu sắc là 100% mờ đục.

Chuyển một số duy nhất vào tùy chọn sẽ đặt OSD thành màu xám và biểu mẫu màu xám / a
cho phép bạn chỉ định thêm alpha.

Các ví dụ

· --osd-color = 1.0 / 0.0 / 0.0 đặt OSD thành màu đỏ đục

· --osd-color = 1.0 / 0.0 / 0.0 / 0.75 đặt OSD thành màu đỏ đục với 75% alpha

· --osd-color = 0.5 / 0.75 đặt OSD thành 50% xám với 75% alpha

Ngoài ra, màu có thể được chỉ định dưới dạng bộ ba hệ lục phân RGB trong biểu mẫu #RRGGBB,
trong đó mỗi nhóm 2 chữ số thể hiện một giá trị màu trong phạm vi 0 (00) đến 255 (FF).
Ví dụ, #FF0000 có màu đỏ. Điều này tương tự với màu web. Alpha được đưa ra với
#AARRGGBB.

Các ví dụ

· --osd-color = '# FF0000' đặt OSD thành màu đỏ đục

· --osd-color = '# C0808080' đặt OSD thành 50% xám với 75% alpha

--osd-phân số
Hiển thị thời gian OSD theo từng phần giây (độ chính xác mili giây). Hữu ích để xem
dấu thời gian chính xác của khung video.

--osd-level = <0-3>
Chỉ định chế độ OSD sẽ bắt đầu.

0 OSD bị tắt hoàn toàn (chỉ phụ đề)

1 đã bật (chỉ hiển thị khi người dùng tương tác)

2 đã bật + thời gian hiện tại hiển thị theo mặc định

3 đã bật + --osd-trạng thái-tin nhắn (thời gian và trạng thái hiện tại theo mặc định)

--osd-margin-x = , --sub-text-margin-x =
Lề màn hình trái và phải cho OSD / subs theo pixel được chia tỷ lệ (xem --osd-cỡ chữ
để biết chi tiết).

Tùy chọn này chỉ định khoảng cách của OSD sang trái, cũng như tại đó
khoảng cách từ đường viền bên phải văn bản OSD dài sẽ bị phá vỡ.

Mặc định: 25.

--osd-margin-y = , --sub-text-margin-y =
Lề trên và dưới màn hình cho OSD / subs theo pixel được chia tỷ lệ (xem --osd-cỡ chữ
để biết chi tiết).

Tùy chọn này chỉ định các lề dọc của OSD. Điều này cũng được sử dụng cho
phụ đề văn bản chưa được định kiểu. Nếu bạn chỉ muốn nâng cao vị trí phụ đề dọc,
sử dụng - vị trí phụ.

Mặc định: 22.

--osd-align-x = , --sub-text-align-x = ...
Kiểm soát góc nào của màn hình OSD hoặc phụ đề văn bản sẽ được căn chỉnh theo
(vỡ nợ: Trung tâm cho người đăng ký, trái cho OSD).

Không bao giờ áp dụng cho phụ đề ASS, ngoại trừ trong --no-sub-ass chế độ. Tương tự như vậy, điều này không
không áp dụng cho phụ đề hình ảnh.

--osd-align-y = --sub-text-align-y = ...
Vị trí dọc (mặc định: dưới cùng cho người đăng ký, hàng đầu cho OSD). Chi tiết xem
--osd-căn chỉnh-x.

--osd-scale =
Hệ số kích thước phông chữ OSD, nhân với --osd-cỡ chữ giá trị.

--osd-scale-by-window =
Có mở rộng OSD với kích thước cửa sổ hay không (mặc định: có). Nếu điều này bị vô hiệu hóa,
--osd-cỡ chữ và các tùy chọn OSD khác sử dụng pixel được chia tỷ lệ luôn ở trong thực tế
điểm ảnh. Kết quả là việc thay đổi kích thước cửa sổ sẽ không thay đổi kích thước phông chữ OSD.

--osd-shadow-color = , --sub-text-shadow-color =
Xem --osd-màu. Màu được sử dụng cho OSD / bóng văn bản phụ.

--osd-shadow-offset = , --sub-text-shadow-offset =
Sự dịch chuyển của bóng OSD / văn bản phụ trong các pixel được chia tỷ lệ (xem --osd-cỡ chữ cho
chi tiết). Giá trị 0 sẽ tắt bóng.

Mặc định: 0.

--osd-spacing = , --sub-text-spacing =
Giãn cách phông chữ phụ / OSD ngang tính bằng pixel được chia tỷ lệ (xem --osd-cỡ chữ để biết chi tiết).
Giá trị này được thêm vào khoảng cách giữa các chữ cái bình thường. Giá trị âm được cho phép.

Mặc định: 0.

Ảnh chụp màn hình
--screenshot-format =
Đặt loại tệp hình ảnh được sử dụng để lưu ảnh chụp màn hình.

Các lựa chọn có sẵn:

png PNG

ppm PPM

pgm PGM

pgmyuv PGM với định dạng pixel YV12

tga HAART

jpg JPEG (mặc định)

jpeg JPEG (giống như jpg, nhưng có đuôi tệp .jpeg)

--screenshot-tag-colorpace =
Gắn thẻ ảnh chụp màn hình với không gian màu thích hợp.

Lưu ý rằng không phải tất cả các định dạng đều được hỗ trợ.

Mặc định: Không.

--screenshot-high-bit-depth =
Nếu có thể, hãy viết ảnh chụp màn hình với độ sâu bit tương tự như video nguồn
(mặc định: có). Điều này đặc biệt thú vị đối với PNG, vì điều này đôi khi
kích hoạt viết PNG 16 bit với kích thước tệp lớn.

--screenshot-template =
Chỉ định mẫu tên tệp được sử dụng để lưu ảnh chụp màn hình. Mẫu chỉ định
tên tệp không có phần mở rộng tệp và có thể chứa các mã định dạng, sẽ là
được thay thế khi chụp ảnh màn hình. Theo mặc định, mẫu là mpv-shot% n, Mà
kết quả là các tên tệp như mpv-shot0012.png ví dụ.

Mẫu có thể bắt đầu bằng một đường dẫn tương đối hoặc tuyệt đối, để chỉ định một
vị trí thư mục nơi ảnh chụp màn hình sẽ được lưu.

Nếu tên tệp ảnh chụp màn hình cuối cùng trỏ đến tệp đã tồn tại, tệp sẽ
không bị ghi đè. Ảnh chụp màn hình sẽ không được lưu hoặc nếu mẫu
chứa %n, được lưu bằng tên tệp khác, mới được tạo.

Các chỉ định định dạng được phép:

% [#] [0X] n
Một số thứ tự, được đệm bằng các số không đến độ dài X (mặc định: 04). Ví dụ
chuyển định dạng % 04n sẽ mang lại 0012 trên ảnh chụp màn hình thứ 12. Con số
được tăng lên mỗi khi chụp ảnh màn hình hoặc nếu tệp đã có
tồn tại. Độ dài X phải nằm trong khoảng 0-9. Với dấu # tùy chọn, mpv
sẽ sử dụng số lượng thấp nhất hiện có. Ví dụ, nếu bạn lấy ba
ảnh chụp màn hình - 0001, 0002, 0003 - và xóa hai ảnh đầu tiên, hai ảnh tiếp theo
ảnh chụp màn hình sẽ không phải là 0004 và 0005, mà là 0001 và 0002 một lần nữa.

%f Tên tệp của video hiện đang phát.

%F Giống như %f, nhưng loại bỏ phần mở rộng tệp, bao gồm cả dấu chấm.

%x Đường dẫn thư mục của video hiện đang phát. Nếu video không có trên
hệ thống tập tin (nhưng ví dụ: http://), điều này mở rộng thành một chuỗi trống.

% X {dự phòng}
Giống như %x, nhưng nếu tệp video không có trên hệ thống tệp, hãy trả về
chuỗi dự phòng bên trong {...}.

%p Thời gian phát lại hiện tại, ở định dạng giống như được sử dụng trong OSD. Kết quả là
một chuỗi có dạng "HH: MM: SS". Ví dụ: nếu video ở thời điểm
vị trí 5 phút 34 giây, %p sẽ được thay thế bằng "00:05:34".

%P Tương tự như %p, nhưng được kéo dài với thời gian phát lại tính bằng mili giây. Nó là
được định dạng là "HH: MM: SS.mmm", với "mmm" là phần mili giây của
thời gian phát lại.

LƯU Ý:
Đây là một cách đơn giản để có được dấu thời gian duy nhất trên mỗi khung hình. (Khung
các con số sẽ trực quan hơn, nhưng không dễ dàng thực hiện được vì
định dạng vùng chứa thường sử dụng tem thời gian để xác định khung.)

% wX Chỉ định thời gian phát lại hiện tại bằng cách sử dụng chuỗi định dạng X. %p giống như
% wH:% wM:% wSvà %P giống như % wH:% wM:% wS.% wT.

Hợp lệ định dạng thông số kỹ thuật:

% wH giờ (được đệm bằng 0 đến hai chữ số)

% wh giờ (không đệm)

% wM phút (00-59)

% wm tổng số phút (bao gồm giờ, không giống như % wM)

% wS giây (00-59)

% ws tổng số giây (bao gồm giờ và phút)

% wf Lượt thích % ws, nhưng dưới dạng phao

% wT mili giây (000-999)

% tX Chỉ định ngày / giờ địa phương hiện tại bằng cách sử dụng định dạng X. Định dạng này
trình xác định sử dụng UNIX strftime () hoạt động bên trong và chèn
kết quả của việc chuyển "% X" tới thời gian căng thẳng. Ví dụ, % tm sẽ chèn số
của tháng hiện tại dưới dạng số. Bạn phải sử dụng nhiều % tX chỉ định cho
xây dựng một chuỗi ngày / giờ đầy đủ.

% {prop [: dự phòng bản văn]}
Chèn giá trị của thuộc tính nô lệ 'prop'. Ví dụ % {filename} là giống nhau
as %f. Nếu thuộc tính không tồn tại hoặc không có sẵn, một văn bản lỗi là
được chèn, trừ khi một dự phòng được chỉ định.

%% Được thay thế bằng % bản thân nhân vật.

--screenshot-directory =
Lưu trữ ảnh chụp màn hình trong thư mục này. Đường dẫn này được kết hợp với tên tệp
được tạo ra bởi --mẫu ảnh chụp màn hình. Nếu tên tệp mẫu đã là tuyệt đối,
thư mục bị bỏ qua.

Nếu thư mục không tồn tại, nó được tạo trên ảnh chụp màn hình đầu tiên. Nếu nó là
không phải là một thư mục, một lỗi được tạo ra khi cố gắng viết một ảnh chụp màn hình.

Tùy chọn này không được đặt theo mặc định và do đó sẽ ghi ảnh chụp màn hình vào thư mục
từ đó mpv đã được bắt đầu. Ở chế độ giả gui (xem giả GUI PHƯƠNG THỨC), cái này được thiết lập
vào máy tính để bàn.

--screenshot-jpeg-quality = <0-100>
Đặt mức chất lượng JPEG. Cao hơn có nghĩa là chất lượng tốt hơn. Giá trị mặc định là 90.

--screenshot-jpeg-source-chroma =
Ghi các tệp JPEG với cùng một mẫu con sắc độ như video (mặc định: có). Nếu
bị vô hiệu hóa, mặc định libjpeg được sử dụng.

--screenshot-png-nén = <0-9>
Đặt mức nén PNG. Cao hơn có nghĩa là nén tốt hơn. Điều này sẽ ảnh hưởng đến
kích thước tệp của tệp ảnh chụp màn hình đã viết và thời gian cần thiết để viết
ảnh chụp màn hình. Nén quá cao có thể chiếm đủ thời gian của CPU để làm gián đoạn
sự phát lại. Giá trị mặc định là 7.

--screenshot-png-filter = <0-5>
Đặt bộ lọc được áp dụng trước khi nén PNG. 0 là không có, 1 là "phụ", 2 là "lên",
3 là "trung bình", 4 là "Paeth", và 5 là "hỗn hợp". Điều này ảnh hưởng đến mức độ
nén có thể đạt được. Đối với hầu hết các hình ảnh, "hỗn hợp" đạt được mức tốt nhất
tỷ lệ nén, do đó nó là mặc định.

Phần mềm Máy cào
--sws-scaler =
Chỉ định thuật toán mở rộng quy mô phần mềm được sử dụng với --vf = quy mô. Điều này cũng ảnh hưởng đến
trình điều khiển đầu ra video thiếu khả năng tăng tốc phần cứng, ví dụ: x11. Xem thêm
--vf = quy mô.

Để có được danh sách các tỷ lệ có sẵn, hãy chạy --sws-scaler = trợ giúp.

Mặc định: lưỡng tính.

--sws-lgb = <0-100>
Bộ lọc mờ Gaussian scaler phần mềm (luma). Xem --sws-scaler.

--sws-cgb = <0-100>
Bộ lọc mờ Gaussian (sắc độ) của bộ chia tỷ lệ phần mềm. Xem --sws-scaler.

--sws-ls = <-100-100>
Bộ lọc làm sắc nét phần mềm scaleer (luma). Xem --sws-scaler.

--sws-cs = <-100-100>
Bộ lọc sắc nét phần mềm scaleer (sắc độ). Xem --sws-scaler.

--sws-chs =
Chuyển đổi màu theo chiều ngang của bộ chia tỷ lệ phần mềm. Xem --sws-scaler.

--sws-cvs =
Chuyển dịch theo chiều dọc của thang đo phần mềm. Xem --sws-scaler.

Thiết bị đầu cuối
--Yên lặng
Làm cho đầu ra của bảng điều khiển ít dài dòng hơn; đặc biệt, ngăn dòng trạng thái (tức là AV:
3.4 (00: 00: 03.37) / 5320.6 ...) từ được hiển thị. Đặc biệt hữu ích khi làm chậm
thiết bị đầu cuối hoặc thiết bị đầu cuối bị hỏng không xử lý đúng cách xuống dòng (tức là \r).

Cũng thấy - thực sự yên tĩnh và - cấpmsg.

- thực sự yên tĩnh
Hiển thị thông báo trạng thái và đầu ra thậm chí ít hơn so với --Yên lặng.

- không có thiết bị đầu cuối, --phần cuối
Vô hiệu hóa mọi quyền sử dụng thiết bị đầu cuối và stdin / stdout / stderr. Điều này hoàn toàn im lặng
bất kỳ đầu ra thông báo.

Không giống như - thực sự yên tĩnh, điều này cũng vô hiệu hóa đầu vào và khởi tạo đầu cuối.

--no-tin nhắn-màu
Tắt đầu ra bảng điều khiển đầy màu sắc trên các thiết bị đầu cuối.

--msg-level =
Kiểm soát độ chi tiết trực tiếp cho từng mô-đun. Các tất cả các mô-đun thay đổi độ dài của
tất cả các mô-đun không được chỉ định rõ ràng trên dòng lệnh.

Chạy mpv với --msg-level = all = trace để xem tất cả các tin nhắn đầu ra mpv. Bạn có thể dùng
tên mô-đun được in trong đầu ra (tiền tố cho mỗi dòng trong [...]) để hạn chế
đầu ra cho các mô-đun thú vị.

LƯU Ý:
Một số thông báo được in trước khi dòng lệnh được phân tích cú pháp và do đó
không bị ảnh hưởng bởi - cấpmsg. Để kiểm soát những thông báo này, bạn phải sử dụng
MPV_VERBOSE biến môi trường; Thấy chưa MÔI TRƯỜNG BIẾN để biết thêm chi tiết.

Các cấp độ có sẵn:

Không hoàn toàn im lặng

gây tử vong chỉ những tin nhắn nghiêm trọng

lôi thông báo lỗi

cảnh báo tin nhắn cảnh báo

Thông tin tin nhắn thông tin

tình trạng thông báo trạng thái (mặc định)

v tin nhắn dài dòng

gỡ lỗi gỡ lỗi tin nhắn

theo dõi thông báo gỡ lỗi rất ồn ào

--hạn-osd, - không có kỳ hạn-osd, --term-osd = lực lượng
Hiển thị thông báo OSD trên bảng điều khiển khi không có đầu ra video. Được kích hoạt bởi
mặc định.

lực lượng bật OSD đầu cuối ngay cả khi cửa sổ video được tạo.

--term-osd-bar, --no-term-osd-bar
Cho phép in thanh tiến trình dưới dòng trạng thái trên thiết bị đầu cuối. (Bị vô hiệu hóa bởi
vỡ nợ.)

--term-osd-bar-chars =
Tùy chỉnh --term-osd-bar tính năng. Chuỗi dự kiến ​​sẽ bao gồm 5
ký tự (bắt đầu, khoảng trắng bên trái, chỉ báo vị trí, khoảng trắng bên phải, kết thúc). Bạn có thể dùng
Các ký tự Unicode, nhưng lưu ý rằng các ký tự XNUMX byte sẽ không được xử lý
đúng.

Mặc định: [- + -].

--term-Playing-msg =
In ra một chuỗi sau khi bắt đầu phát lại. Chuỗi được mở rộng cho các thuộc tính,
ví dụ --term-Playing-msg = 'tệp: $ {filename} ' sẽ in chuỗi tập tin: tiếp theo
một khoảng trắng và tên tệp hiện đang phát.

Xem Bất động sản Sự bành trướng.

--term-status-msg =
In ra một chuỗi tùy chỉnh trong khi phát lại thay vì dòng trạng thái tiêu chuẩn.
Mở rộng thuộc tính. Xem Bất động sản Sự bành trướng.

--msg-mô-đun
Thêm tên mô-đun vào mỗi thông báo bảng điều khiển.

--msg-thời gian
Thêm thông tin thời gian vào từng thông báo trên bảng điều khiển.

TV
--TV-...
Các tùy chọn này điều chỉnh các thuộc tính khác nhau của mô-đun chụp TV. Để xem TV
với mpv, sử dụng TV:// or TV:// hoặc thậm chí TV:// (xem
tùy chọn kênh truyền hình cho Tên kênh dưới đây) dưới dạng URL phương tiện. Bạn cũng có thể dùng
TV:/// để bắt đầu xem video từ đầu vào tổng hợp hoặc S-Video (xem
tùy chọn đầu vào để biết chi tiết).

--tv-device =
Chỉ định thiết bị TV (mặc định: / dev / video0).

--tv-channel =
Đặt bộ dò thành kênh.

--no-tv-âm thanh
không có âm thanh

--tv-automute = <0-255> (v4l và v4l2 chỉ)
Nếu cường độ tín hiệu được thiết bị báo cáo nhỏ hơn giá trị này, âm thanh và video sẽ
bị tắt tiếng. Trong hầu hết các trường hợp, automute = 100 sẽ là đủ. Mặc định là 0 (tự động hóa
tàn tật).

--tv-driver =
Xem --tv = driver = help để biết danh sách các trình điều khiển đầu vào TV được biên dịch sẵn. có sẵn: dummy,
v4l2 (mặc định: autodetect)

--tv-input =
Chỉ định đầu vào (mặc định: 0 (TV), xem đầu ra bảng điều khiển để biết các đầu vào khả dụng).

--tv-freq =
Chỉ định tần số để đặt bộ dò (ví dụ: 511.250). Không tương thích với
tham số kênh.

--tv-outfmt =
Chỉ định định dạng đầu ra của bộ chỉnh với giá trị đặt trước được hỗ trợ bởi V4L
trình điều khiển (YV12, UYVY, YUY2, I420) hoặc một định dạng tùy ý được cung cấp dưới dạng giá trị hex.

--tv-width =
chiều rộng cửa sổ đầu ra

--tv-height =
chiều cao cửa sổ đầu ra

--tv-fps =
tốc độ khung hình để quay video (khung hình trên giây)

--tv-buffersize =
kích thước tối đa của bộ đệm chụp tính bằng megabyte (mặc định: động)

--tv-norm =
Xem đầu ra bảng điều khiển để biết danh sách tất cả các định mức có sẵn, cũng xem bình thường
tùy chọn bên dưới.

--tv-normid = (v4l2 chỉ)
Đặt định mức TV thành ID số nhất định. Định mức TV phụ thuộc vào thẻ chụp.
Xem đầu ra bảng điều khiển để biết danh sách các định mức TV có sẵn.

--tv-chanlist =
có sẵn: argentina, australia, china-bcast, europe-East, europe-west, France,
ireland, italy, japan-bcast, japan-cable, newzealand, nga, namhafrica,
us-bcast, us-cáp, us-cáp-hrc

--tv-channel = - [= ], - [= ], ...
Đặt tên cho các kênh.

LƯU Ý:
Nếu là một số nguyên lớn hơn 1000, nó sẽ được coi là tần số (trong
kHz) chứ không phải tên kênh từ bảng tần số. Sử dụng _ cho khoảng trắng trong tên
(hoặc chơi với trích dẫn ;-)). Sau đó, tên kênh sẽ được viết bằng OSD,
và các lệnh của nô lệ tv_step_channel, tv_set_channel và tv_last_channel sẽ
có thể sử dụng cho một điều khiển từ xa. Không tương thích với tần số tham số.

LƯU Ý:
Số kênh sau đó sẽ là vị trí trong danh sách 'kênh', bắt đầu
với 1.

Các ví dụ

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

--tv- [độ sáng | độ tương phản | màu | độ bão hòa] = <-100-100>
Đặt bộ cân bằng hình ảnh trên thẻ.

--tv-audiorate =
Đặt tốc độ lấy mẫu âm thanh đầu vào.

--tv-forceaudio
Ghi lại âm thanh ngay cả khi không có nguồn âm thanh nào được báo cáo bởi v4l.

--tv-alsa
Chụp từ ALSA.

--tv-amode = <0-3>
Chọn một chế độ âm thanh:

0 mono

1 âm thanh nổi

2 ngôn ngữ 1

3 ngôn ngữ 2

--tv-forcechan = <1-2>
Theo mặc định, số lượng kênh âm thanh đã ghi được xác định tự động bằng
truy vấn chế độ âm thanh từ thẻ TV. Tùy chọn này cho phép buộc âm thanh nổi / đơn âm
ghi âm bất kể tùy chọn amode và các giá trị được trả về bởi v4l. Cái này có thể
được sử dụng để khắc phục sự cố khi card TV không thể báo cáo âm thanh hiện tại
chế độ.

--tv-adevice =
Đặt thiết bị âm thanh. nên là / dev / xxx cho OSS và một ID phần cứng cho ALSA.
Bạn phải thay thế bất kỳ ':' bằng một '.' trong ID phần cứng cho ALSA.

--tv-audioid =
Chọn một đầu ra âm thanh của thẻ chụp, nếu thẻ có nhiều hơn một.

--tv- [âm lượng | âm trầm | âm bổng | cân bằng] = <0-100>
Các tùy chọn này thiết lập các thông số của bộ trộn trên thẻ ghi hình. Họ sẽ
không có hiệu lực, nếu thẻ của bạn không có. Đối với bản đồ v4l2 50 về mặc định
giá trị của điều khiển, theo báo cáo của trình điều khiển.

--tv-gain = <0-100>
Đặt kiểm soát độ lợi cho các thiết bị video (thường là webcam) thành giá trị mong muốn và
tắt điều khiển tự động. Giá trị 0 cho phép điều khiển tự động. Nếu điều này
tùy chọn bị bỏ qua, quyền kiểm soát sẽ không được sửa đổi.

--tv-ngaymode =
Giá trị 0 có nghĩa là thu và đệm âm thanh và video với nhau. Giá trị 1
(mặc định) có nghĩa là chỉ thực hiện quay video và để âm thanh đi qua một vòng lặp lại
cáp từ card TV đến card âm thanh.

--tv-mjpeg
Sử dụng tính năng nén MJPEG phần cứng (nếu thẻ hỗ trợ). Khi sử dụng tùy chọn này,
bạn không cần chỉ định chiều rộng và chiều cao của cửa sổ đầu ra, vì mpv
sẽ tự động xác định nó từ giá trị thập phân (xem bên dưới).

--tv-decimation = <1 | 2 | 4>
chọn kích thước của hình ảnh sẽ được nén bằng MJPEG phần cứng
nén:

1 kích thước đầy đủ

· PAL 704x576

· 704x480 NTSC

2 Kích thước trung bình

· PAL 352x288

· 352x240 NTSC

4 kích thước nhỏ

· PAL 176x144

· 176x120 NTSC

--tv-quality = <0-100>
Chọn chất lượng nén JPEG (khuyến nghị <60 cho kích thước đầy đủ).

--tv-quét-tự khởi động
Bắt đầu quét kênh ngay sau khi khởi động (mặc định: đã tắt).

--tv-scan-period = <0.1-2.0>
Chỉ định độ trễ tính bằng giây trước khi chuyển sang kênh tiếp theo (mặc định: 0.5). Thấp hơn
giá trị sẽ giúp quét nhanh hơn, nhưng có thể phát hiện các kênh TV không hoạt động là đang hoạt động.

--tv-scan-Ngưỡng = <1-100>
Giá trị ngưỡng cho cường độ tín hiệu (tính bằng phần trăm), như được thiết bị báo cáo
(mặc định: 50). Cường độ tín hiệu cao hơn giá trị này sẽ chỉ ra rằng
kênh quét hiện đang hoạt động.

Bộ nhớ cache
--cache =
Đặt kích thước của bộ nhớ đệm tính bằng kilobyte, vô hiệu hóa nó bằng Khônghoặc tự động bật
nó nếu cần với tự động (vỡ nợ: tự động). Với tự động, bộ nhớ cache thường sẽ là
được bật cho các luồng mạng, sử dụng kích thước được đặt bởi --cache-mặc định. Với Vâng, Các
bộ nhớ cache sẽ luôn được kích hoạt với kích thước được đặt bởi --cache-mặc định (trừ khi
luồng không thể được lưu trữ trong bộ nhớ cache, hoặc --cache-mặc định tắt bộ nhớ đệm).

Có thể hữu ích khi phát tệp từ phương tiện chậm, nhưng cũng có thể có âm thanh
hiệu ứng, đặc biệt là với các định dạng tệp đòi hỏi nhiều tìm kiếm, chẳng hạn như MP4.

Lưu ý rằng một nửa kích thước bộ nhớ cache sẽ được sử dụng để cho phép tìm kiếm lại nhanh chóng. Đây cũng là
lý do tại sao bộ nhớ cache đầy thường không được báo cáo là đầy 100%. Bộ nhớ đệm lấp đầy
hiển thị không bao gồm một phần của bộ nhớ cache được dành riêng cho việc tìm kiếm trở lại. Các
tỷ lệ phần trăm tối đa thực tế thường sẽ là tỷ lệ giữa đầu đọc và
kích thước bộ đệm sau.

--cache-default =
Đặt kích thước của bộ đệm theo kilobyte (mặc định: 75000 KB). Sử dụng Không sẽ không
tự động kích hoạt bộ nhớ cache, ví dụ khi phát từ một luồng mạng. Lưu ý rằng
sử dụng --bộ nhớ đệm sẽ luôn ghi đè tùy chọn này.

--cache-initial =
Quá trình phát lại sẽ bắt đầu khi bộ nhớ đệm đã được lấp đầy với nhiều kilobyte này
dữ liệu (mặc định: 0).

--cache-seek-min =
Nếu một tìm kiếm được thực hiện cho một vị trí trong kích thước bộ nhớ cache từ
vị trí hiện tại, mpv sẽ đợi bộ đệm được lấp đầy vào vị trí này thay vì
hơn thực hiện tìm kiếm luồng (mặc định: 500).

Điều này quan trọng đối với những tìm kiếm nhỏ về phía trước. Với các luồng chậm (đặc biệt là các luồng HTTP)
có sự cân bằng giữa việc bỏ qua dữ liệu giữa vị trí hiện tại và tìm kiếm
điểm đến, hoặc thực hiện một tìm kiếm thực tế. Tùy thuộc vào tình huống, một trong hai
chúng có thể chậm hơn so với phương pháp khác. Tùy chọn này cho phép kiểm soát điều này.

--cache-backbuffer =
Kích thước của bộ đệm trở lại bộ đệm (mặc định: 75000 KB). Điều này sẽ thêm vào tổng bộ nhớ cache
kích thước, và dành số tiền để tìm kiếm lại. Số tiền đặt trước sẽ không được
được sử dụng cho đầu đọc và thay vào đó lưu giữ dữ liệu đã đọc để cho phép tìm kiếm nhanh
trở lại.

--cache-file =
Tạo tệp bộ đệm trên hệ thống tệp.

Có hai cách để sử dụng điều này:

1. Truyền một đường dẫn (tên tệp). Tệp sẽ luôn bị ghi đè. Khi mà
bộ đệm chung được bật, bộ đệm tệp này sẽ được sử dụng để lưu trữ bất cứ thứ gì được đọc
từ dòng nguồn.

Thao tác này sẽ luôn ghi đè lên tệp bộ đệm và bạn không thể sử dụng bộ đệm hiện có
tệp để tiếp tục phát lại luồng. (Về mặt kỹ thuật, mpv thậm chí không biết cái nào
các khối trong tệp là hợp lệ và không hợp lệ.)

Tệp kết quả sẽ không nhất thiết phải chứa tất cả dữ liệu của luồng nguồn.
Ví dụ: nếu bạn tìm kiếm, những phần bị bỏ qua sẽ không bao giờ được đọc và
do đó không được ghi vào bộ nhớ cache. Các phần bị bỏ qua được lấp đầy
với số không. Điều này có nghĩa là tệp bộ đệm không nhất thiết phải tương ứng với
tải xuống toàn bộ luồng nguồn.

Cả hai vấn đề này đều có thể được cải thiện nếu có bất kỳ sự quan tâm nào của người dùng.

Chú ý:
Gây hỏng ngẫu nhiên khi được sử dụng với các chương có thứ tự hoặc với
--tập tin âm thanh.

2. Truyền chuỗi TMP. Đây sẽ không được hiểu là tên tệp. Thay vào đó, một
tệp tạm thời vô hình được tạo. Nó phụ thuộc vào thư viện C của bạn, nơi này
tệp được tạo (thường là / tmp /), và liệu tên tệp có hiển thị hay không ( tmpfile ()
chức năng được sử dụng). Trên một số hệ thống, tự động xóa tệp bộ nhớ cache có thể
không được đảm bảo.

Nếu bạn muốn sử dụng bộ đệm tệp, chế độ này được khuyến nghị, vì nó không
ngắt các chương có thứ tự hoặc --tập tin âm thanh. Các chế độ này mở nhiều luồng bộ nhớ cache,
và việc sử dụng cùng một tệp cho chúng rõ ràng là xung đột.

Cũng thấy --cache-file-size.

--cache-file-size =
Kích thước tối đa của tệp được tạo bằng --cache-tệp. Đối với quyền truy cập đọc ở trên này
kích thước, bộ nhớ cache chỉ đơn giản là không được sử dụng.

Hãy nhớ rằng một số trường hợp sử dụng, chẳng hạn như phát các chương có thứ tự có bật bộ nhớ cache,
sẽ thực sự tạo ra nhiều tệp bộ đệm, mỗi tệp sẽ sử dụng đến mức này
dung lượng đĩa.

(Mặc định: 1048576, 1 GB.)

- không có bộ nhớ cache
Tắt bộ nhớ đệm luồng đầu vào. Xem --bộ nhớ đệm.

--cache-secs =
Bao nhiêu giây âm thanh / video cần tìm nạp trước nếu bộ nhớ đệm đang hoạt động. Điều này ghi đè
các --demuxer-readahead-giây tùy chọn nếu và chỉ khi bộ nhớ cache được bật và
giá trị lớn hơn. (Mặc định: 10.)

--tạm dừng bộ đệm, --no-cache-tạm dừng
Trình phát có nên tự động tạm dừng khi bộ nhớ đệm sắp hết hay không và bỏ tạm dừng
khi có thêm dữ liệu ("đệm").

mạng
--user-agent =
Sử dụng làm tác nhân người dùng cho truyền trực tuyến HTTP.

--bánh quy, - không có cookie
Hỗ trợ cookie khi thực hiện các yêu cầu HTTP. Bị tắt theo mặc định.

--cookies-file =
Đọc cookie HTTP từ . Tệp được giả định ở định dạng Netscape.

--http-header-fields =
Đặt các trường HTTP tùy chỉnh khi truy cập luồng HTTP.

Ví dụ

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

Sẽ tạo yêu cầu HTTP:

GET / HTTP / 1.0
Máy chủ: localhost: 1234
Tác nhân người dùng: MPlayer
Siêu dữ liệu băng giá: 1
Trường1: giá trị1
Trường2: giá trị2
Kết nối: đóng

--tls-ca-file =
Tệp cơ sở dữ liệu của tổ chức phát hành chứng chỉ để sử dụng với TLS. (Không thành công với cũ hơn
Phiên bản FFmpeg hoặc Libav.)

--tls-xác minh
Xác minh chứng chỉ ngang hàng khi sử dụng TLS (ví dụ: với https://...). (Âm thầm không thành công
với các phiên bản FFmpeg hoặc Libav cũ hơn.)

--tls-cert-file
Tệp có chứa chứng chỉ để sử dụng trong quá trình bắt tay với ngang hàng.

--tls-key-file
Tệp chứa khóa riêng tư cho chứng chỉ.

--referrer =
Chỉ định đường dẫn liên kết giới thiệu hoặc URL cho các yêu cầu HTTP.

--network-timeout =
Chỉ định thời gian chờ của mạng tính bằng giây. Điều này ảnh hưởng ít nhất đến HTTP. Cái đặc biệt
giá trị 0 (mặc định) sử dụng mặc định FFmpeg / Libav. Nếu một giao thức được sử dụng thì
không hỗ trợ hết thời gian chờ, tùy chọn này sẽ bị bỏ qua một cách im lặng.

--rtsp-transport =
Chọn phương thức vận chuyển RTSP (mặc định: tcp). Thao tác này sẽ chọn mạng cơ bản
vận chuyển khi chơi rtsp: // ... Các URL. Giá trị lavf để lại quyết định cho
libavformat.

--hls-bitrate = >
Nếu các luồng HLS được phát, tùy chọn này sẽ kiểm soát những luồng nào được chọn bởi
mặc định. Tùy chọn cho phép các tham số sau:

Không Đừng làm bất cứ điều gì đặc biệt. Thông thường, điều này sẽ chỉ cần chọn đầu tiên
luồng âm thanh / video mà nó có thể tìm thấy.

phút Chọn các luồng có tốc độ bit thấp nhất.

tối đa Tương tự, nhưng tốc độ bit cao nhất. (Mặc định.)

Ngoài ra, nếu tùy chọn là một số, luồng có tỷ lệ cao nhất bằng hoặc
dưới giá trị tùy chọn được chọn.

Tốc độ bit như đã sử dụng được gửi bởi máy chủ và không có gì đảm bảo rằng nó thực sự
có ý nghĩa.

DVB
--dvbin-card = <1-4>
Chỉ định sử dụng thẻ số 1-4 (mặc định: 1).

--dvbin-file =
Hướng dẫn mpv đọc danh sách kênh từ . Mặc định là trong mpv
thư mục cấu hình (thường là ~ / .config / mpv) với tên tệp
channel.conf. {sat, ter, cbl, atsc} (dựa trên loại thẻ của bạn) hoặc channel.conf như là một
phương sách cuối cùng. Đối với thẻ DVB-S / 2, danh sách kênh định dạng VDR 1.7.x được khuyến nghị như
nó cho phép điều chỉnh các kênh DVB-S2, cho phép phụ đề và giải mã PMT (
cải thiện phần lớn việc tách dòng). Danh sách kênh định dạng mplayer cổ điển vẫn còn
được hỗ trợ (không có những cải tiến này) và đối với các loại thẻ khác, chỉ VDR giới hạn
hỗ trợ danh sách kênh định dạng được triển khai (hoan nghênh các bản vá lỗi). Đối với các kênh có
chuyển đổi PID động hoặc không đầy đủ channel.conf, --dvbin-full-transponder hoặc là
PID ma thuật 8192 được giới thiệu.

--dvbin-timeout = <1-30>
Số giây phải đợi tối đa khi cố gắng điều chỉnh một tần số trước khi từ bỏ
(mặc định: 30).

--dvbin-full-transponder =
Không áp dụng bộ lọc trên PID của chương trình, chỉ điều chỉnh theo tần số và chuyển bộ phát đáp đầy đủ
đến demuxer. Điều này rất hữu ích để ghi lại nhiều chương trình trên một bộ phát đáp duy nhất, hoặc
để giải quyết các vấn đề trong channel.conf. Nó cũng được khuyến khích sử dụng cái này cho
các kênh chuyển đổi PID một cách nhanh chóng, ví dụ: cho tin tức khu vực.

Mặc định: Không

hỗn hợp
--display-tags = tag1, tags2, ...
Đặt danh sách các thẻ sẽ được hiển thị trên thiết bị đầu cuối. Các thẻ nằm trong
danh sách, nhưng không có trong tệp đã phát, sẽ không được hiển thị. Nếu một giá trị kết thúc
với *, tất cả các thẻ được so khớp bằng tiền tố (mặc dù không có dấu nháy chung). Chỉ cần
đi qua * thực chất là lọc.

Mặc định bao gồm một danh sách các thẻ phổ biến, hãy gọi mpv với - tùy chọn danh sách để xem nó

--mc =
Hiệu chỉnh đồng bộ AV tối đa trên mỗi khung hình (tính bằng giây)

--autosync =
Điều chỉnh dần đồng bộ A / V dựa trên các phép đo độ trễ âm thanh. Xác định
--autosync = 0, mặc định, sẽ khiến thời gian khung hình hoàn toàn dựa trên âm thanh
các phép đo độ trễ. Xác định --autosync = 1 sẽ làm như vậy, nhưng sẽ tinh vi
thay đổi thuật toán hiệu chỉnh A / V. Tốc độ khung hình video không đồng đều trong một video
chơi tốt với --không có âm thanh thường có thể được trợ giúp bằng cách đặt giá trị này thành một giá trị số nguyên
lớn hơn 1. Giá trị càng cao thì thời gian càng gần với --không có âm thanh.
Thử --autosync = 30 để giải quyết các vấn đề với trình điều khiển âm thanh không triển khai
một phép đo độ trễ âm thanh hoàn hảo. Với giá trị này, nếu hiệu số đồng bộ A / V lớn
xảy ra, chúng sẽ chỉ mất khoảng 1 hoặc 2 giây để giải quyết. Sự chậm trễ này trong
thời gian phản ứng với sự chênh lệch A / V đột ngột sẽ là tác dụng phụ duy nhất của việc biến điều này
tùy chọn bật, cho tất cả các trình điều khiển âm thanh.

--video-sync =
Cách trình phát đồng bộ hóa âm thanh và video.

Các chế độ bắt đầu với màn hình hiển thị cố gắng xuất hoàn toàn khung hình video
đồng bộ với màn hình, sử dụng tốc độ làm tươi dọc màn hình được phát hiện làm
gợi ý tốc độ khung hình sẽ được hiển thị trung bình như thế nào. Các chế độ này thay đổi tốc độ video
một chút để phù hợp với màn hình. Xem --video-sync -... các tùy chọn để tinh chỉnh. Các
Mức độ mạnh mẽ của chế độ này được giảm bớt bằng cách đưa ra một số giả định lý tưởng hóa,
mà không phải lúc nào cũng có thể áp dụng trong thực tế. Hành vi có thể phụ thuộc vào VO và
trình điều khiển video và âm thanh của hệ thống. Các tệp phương tiện phải sử dụng tốc độ khung hình không đổi.
VFR theo phần khôn ngoan cũng có thể hoạt động với một số định dạng vùng chứa (nhưng không phải như mkv).
Nếu mã đồng bộ phát hiện A / V desync trầm trọng hoặc không thể phát hiện được tốc độ khung hình,
trình phát tự động trở lại âm thanh chế độ trong một thời gian hoặc vĩnh viễn.

Các chế độ với khử đồng bộ trong tên của họ không cố gắng giữ cho âm thanh / video được đồng bộ hóa.
Chúng sẽ từ từ (hoặc nhanh chóng) giải mã đồng bộ, cho đến khi lần tìm kiếm tiếp theo xảy ra. Các chế độ này
có nghĩa là để thử nghiệm, không phải là sử dụng nghiêm túc.

âm thanh Thời gian từ khung hình video sang âm thanh. Đây là chế độ mạnh mẽ nhất, vì người chơi
không phải giả định bất cứ điều gì về cách màn hình hoạt động. Các
bất lợi là nó có thể dẫn đến việc khung hình không thường xuyên bị giảm hoặc lặp lại. Nếu
âm thanh bị tắt, điều này sử dụng đồng hồ hệ thống. Đây là chế độ mặc định.

hiển thị lại mẫu
Lấy mẫu lại âm thanh để khớp với video. Chế độ này cũng sẽ cố gắng điều chỉnh âm thanh
tốc độ để bù cho sự trôi dạt khác. (Điều này có nghĩa là nó sẽ phát âm thanh tại
một tốc độ khác nhau thỉnh thoảng để giảm sự khác biệt A / V.)

hiển thị-mẫu lại-vdrop
Lấy mẫu lại âm thanh để khớp với video. Thả khung hình video để bù đắp
trôi dạt.

hiển thị-resample-desync
Giống như chế độ trước, nhưng không có bù A / V.

hiển thị-vdrop
Thả hoặc lặp lại các khung hình video để bù đắp video khử đồng bộ. (Mặc dù nó
sẽ có những tác động tương tự như âm thanh, việc thực hiện rất
khác nhau.)

quảng cáo hiển thị
Thả hoặc lặp lại dữ liệu âm thanh để bù đắp video giải mã đồng bộ. Xem
--video-sync-adrop-size. Chế độ này sẽ gây ra các hiện tượng âm thanh nghiêm trọng nếu
tốc độ làm mới màn hình thực quá khác với tốc độ được báo cáo hoặc bắt buộc.

hiển thị không đồng bộ hóa
Đồng bộ hóa video để hiển thị và để âm thanh tự phát.

khử đồng bộ Đồng bộ hóa video theo đồng hồ hệ thống và để âm thanh tự phát.

--video-sync-max-video-change =
Chênh lệch tốc độ tối đa tính theo phần trăm được áp dụng cho video có
--video-sync = display -... (mặc định: 1). Chế độ đồng bộ hóa màn hình sẽ bị tắt nếu
cách làm mới màn hình và video không khớp trong phạm vi đã cho. Nó cố gắng
bội số: phát video 30 khung hình / giây trên màn hình 60 Hz sẽ nhân đôi mọi
khung thứ hai. Phát video 24 khung hình / giây trên màn hình 60 Hz sẽ phát video ở chế độ
2-3-2-3 -... mẫu.

Cài đặt mặc định không đủ lỏng để tăng tốc độ video 23.976 khung hình / giây lên 25 khung hình / giây.
Chúng tôi cho rằng sự thay đổi cao độ là quá nghiêm trọng để cho phép hành vi này theo mặc định. Đặt
tùy chọn này có giá trị là 5 để kích hoạt nó.

Lưu ý rằng trong --video-sync = display-resample chế độ, tốc độ âm thanh cũng sẽ
được thay đổi một lượng nhỏ nếu cần thiết cho đồng bộ A / V. Xem
--video-sync-max-audio-change.

--video-sync-max-audio-change =
tối đa bổ sung tốc độ chênh lệch phần trăm được áp dụng cho âm thanh với
--video-sync = display -... (mặc định: 0.125). Thông thường, trình phát phát âm thanh tại
tốc độ của video. Nhưng nếu sự khác biệt giữa vị trí âm thanh và video là
quá cao, ví dụ như do trôi dạt hoặc các lỗi thời gian khác, nó sẽ cố gắng tăng tốc độ hoặc
làm chậm âm thanh bởi yếu tố bổ sung này. Giá trị quá thấp có thể dẫn đến khung video
rơi hoặc lặp lại nếu không thể bù A / V desync, giá trị quá cao
có thể dẫn đến giảm khung hình hỗn loạn do âm thanh bị "vượt quá" và bỏ qua
nhiều khung hình video trước khi logic đồng bộ hóa có thể phản ứng.

--video-sync-adrop-size =
Đối với --video-sync = display-adrop cách thức. Chế độ này sao chép / giảm dữ liệu âm thanh xuống
giữ âm thanh đồng bộ với video. Để tránh tạo tác âm thanh trên jitter (điều này sẽ
thêm / bớt mẫu mọi lúc), điều này được thực hiện trong các đơn vị tương đối lớn, cố định,
được kiểm soát bởi tùy chọn này. Đơn vị là giây.

--mf-fps =
Tốc độ khung hình được sử dụng khi giải mã từ nhiều tệp PNG hoặc JPEG với mf: // (vỡ nợ:
1).

--mf-type =
Loại tệp đầu vào cho mf: // (có sẵn: jpeg, png, tga, sgi). Theo mặc định, đây là
đoán từ phần mở rộng tệp.

--stream-capture =
Cho phép ghi lại luồng chính (không phải các bản âm thanh bổ sung hoặc các loại khác
luồng) vào tệp đã cho. Quá trình chụp cũng có thể được bắt đầu và dừng bằng cách thay đổi
tên tệp với bắt dòng tài sản nô lệ. Nói chung điều này sẽ không
tạo ra kết quả có thể sử dụng cho bất kỳ thứ gì khác ngoài MPEG hoặc luồng thô, trừ khi chụp
bao gồm các tiêu đề tệp và không bị gián đoạn. Lưu ý rằng, do bộ nhớ cache
độ trễ, dữ liệu được thu thập có thể bắt đầu và kết thúc hơi chậm so với những gì bạn
xem hiển thị.

Tệp đích luôn được thêm vào. (Trước mpv 0.8.0, tệp là
bị ghi đè.)

--stream-dump =
Giống như - bắt dòng, nhưng không bắt đầu phát lại. Thay vào đó, toàn bộ tệp là
đổ.

--stream-lavf-o = opt1 = value1, opt2 = value2, ...
Đặt AVOptions trên các luồng được mở bằng libavformat. Các tùy chọn không xác định hoặc sai chính tả là
im lặng bỏ qua. (Chúng được đề cập trong đầu ra đầu cuối ở chế độ tiết, tức là
--v. Nói chung, chúng tôi không thể in lỗi, vì các tùy chọn khác, chẳng hạn như người dùng
tác nhân không khả dụng với tất cả các giao thức và lỗi in cho các tùy chọn không xác định
cuối cùng sẽ trở nên quá ồn ào.)

--vo-mmcss-profile =
(Chỉ dành cho Windows.) Đặt cấu hình MMCSS cho chuỗi trình kết xuất video (mặc định:
Phát lại).

- thâm niên =
(Chỉ dành cho Windows.) Đặt ưu tiên quy trình cho mpv theo định sẵn
các ưu tiên có sẵn trong Windows.

Giá trị có thể có của : nhàn rỗi | dưới bình thường | bình thường | trên bình thường | cao | thời gian thực

Chú ý:
Sử dụng ưu tiên thời gian thực có thể gây khóa hệ thống.

--force-media-title =
Buộc nội dung của tiêu đề phương tiện thuộc tính giá trị này. Hữu ích cho các tập lệnh
muốn đặt tiêu đề mà không ghi đè cài đặt của người dùng trong --chức vụ.

AUDIO OUTPUT DRIVERS

Trình điều khiển đầu ra âm thanh là giao diện cho các thiết bị đầu ra âm thanh khác nhau. Cú pháp là:

--ao =
Chỉ định danh sách ưu tiên của các trình điều khiển đầu ra âm thanh sẽ được sử dụng.

Nếu danh sách có dấu ',', mpv sẽ trở lại các trình điều khiển không có trong danh sách.
Các tiểu mục là tùy chọn và hầu như có thể được bỏ qua.

Bạn cũng có thể đặt giá trị mặc định cho từng trình điều khiển. Các giá trị mặc định được áp dụng trước giá trị bình thường
thông số trình điều khiển.

--ao-defaults =
Đặt giá trị mặc định cho từng trình điều khiển.

LƯU Ý:
Xem --ao = giúp đỡ để biết danh sách các trình điều khiển đầu ra âm thanh đã được biên dịch. Người lái xe --ao = alsa is
được ưu tiên. --ao = xung được ưu tiên trên các hệ thống sử dụng PulseAudio. Trên Windows,
--ao = wasapi được ưu tiên, mặc dù đôi khi nó có thể gây ra rắc rối, trong trường hợp đó
--ao = dsound nên được sử dụng. Trên hệ thống BSD, --ao = oss or --ao = sndio` có thể hoạt động (
sau đó là thử nghiệm). Trên hệ thống OS X, sử dụng --ao = coreaudio.

Các ví dụ

· --ao = alsa, oss, Hãy thử trình điều khiển ALSA, sau đó là trình điều khiển OSS, sau đó thử các trình điều khiển khác.

· --ao = alsa: resample = yes: device = [plughw: 0,3] Cho phép ALSA lấy lại mẫu và đặt
tên thiết bị làm thẻ đầu tiên, thiết bị thứ tư.

Trình điều khiển đầu ra âm thanh có sẵn là:

trỗi dậy (Linux chỉ)
Trình điều khiển đầu ra âm thanh ALSA

thiết bị =
Đặt tên thiết bị. Đối với đầu ra ac3 qua S / PDIF, hãy sử dụng "iec958" hoặc "spdif"
thiết bị, trừ khi bạn thực sự biết cách đặt chính xác.

resample = có
Bật plugin lấy mẫu lại ALSA. (Tính năng này bị tắt theo mặc định, vì một số
trình điều khiển báo cáo độ trễ âm thanh không chính xác trong một số trường hợp.)

máy trộn-thiết bị =
Đặt thiết bị trộn được sử dụng với --no-softvol (vỡ nợ: mặc định).

mixer-name =
Đặt tên của phần tử trộn (mặc định: Bậc thầy). Đây là ví dụ PCM
or Bậc thầy.

mixer-index =
Đặt chỉ số của kênh trộn (mặc định: 0). Xem xét đầu ra của
"máy trộn sự kiểm soát", thì chỉ mục là số theo sau tên của
phần tử.

không xen kẽ
Cho phép xuất các định dạng không xen kẽ (nếu bộ giải mã âm thanh sử dụng
định dạng). Hiện bị tắt theo mặc định do một số plugin ALSA phổ biến
hoàn toàn bị hỏng với các định dạng không xen kẽ.

lờ-chmap
Không đọc hoặc đặt bản đồ kênh của thiết bị ALSA - chỉ yêu cầu
số kênh cần thiết, rồi chuyển âm thanh nguyên trạng đến nó. Cái này
tùy chọn rất có thể không nên được sử dụng. Nó có thể hữu ích cho việc gỡ lỗi, hoặc
cho các thiết lập tĩnh với cấu hình ALSA được thiết kế đặc biệt (trong
trường hợp bạn nên luôn buộc cùng một bố cục với - kênh âm thanh, hoặc nó
sẽ chỉ hoạt động đối với các tệp sử dụng bố cục ngầm định cho thiết bị ALSA của bạn).

LƯU Ý:
MPlayer và mplayer2 yêu cầu bạn thay thế bất kỳ ',' bằng '.' và bất kỳ ':' nào với
'=' trong tên thiết bị ALSA. mpv không làm điều này nữa. Thay vào đó, hãy trích dẫn
Tên thiết bị:
--ao = alsa: device = [plug: surround50]

Lưu ý rằng [ và ] chỉ cần trích dẫn tên thiết bị. Với một số shell (như zsh),
bạn phải trích dẫn chuỗi tùy chọn để ngăn trình bao diễn giải
thay vì chuyển chúng đến mpv.

Trên thực tế, bạn nên sử dụng --thiết bị âm thanh tùy chọn, thay vì đặt
thiết bị trực tiếp.

Chú ý:
Xử lý âm thanh đa kênh / âm thanh vòm đã thay đổi trong mpv 0.8.0 từ hành vi
trong MPlayer / mplayer2 và các phiên bản mpv cũ hơn.

Hành vi cũ là trình phát luôn giảm âm thanh nổi theo mặc định. Các
- kênh âm thanh (Hoặc --kênh truyền hình trước đó) tùy chọn phải được đặt để có được
âm thanh đa kênh. Sau đó, phát âm thanh nổi sẽ sử dụng mặc định thiết bị (cái nào
thường cho phép nhiều chương trình phát âm thanh cùng lúc qua dmix),
trong khi phát bất kỳ thứ gì với nhiều kênh hơn sẽ mở một trong các phần cứng
thiết bị, ví dụ như thông qua bao quanh51 bí danh (thường có quyền truy cập độc quyền).
Người chơi có sử dụng quyền truy cập độc quyền hay không sẽ phụ thuộc vào tệp
đang được chơi.

Hành vi mới kể từ mpv 0.8.0 luôn bật âm thanh đa kênh, tức là
--audio-channel = auto là mặc định. Tuy nhiên, vì ALSA không cung cấp cách nào tốt
để phát âm thanh đa kênh theo cách không độc quyền (mà không chặn
ứng dụng sử dụng âm thanh), trình phát bị hạn chế ở các khả năng của
các mặc định thiết bị theo mặc định, có nghĩa là nó chỉ hỗ trợ âm thanh nổi và đơn âm (tại
ít nhất với các cấu hình ALSA điển hình hiện tại). Nhưng nếu một thiết bị phần cứng là
được chọn, thì âm thanh đa kênh thường sẽ hoạt động.

Câu chuyện ngắn là: nếu bạn muốn âm thanh đa kênh với ALSA, hãy sử dụng --thiết bị âm thanh
để chọn thiết bị (sử dụng --audio-device = trợ giúp để có được danh sách tất cả các thiết bị và
tên mpv của họ).

Bạn cũng có thể thử sử dụng các kết hợp Plugin. Thiết lập này cho phép âm thanh đa kênh
trên mặc định thiết bị có tính năng trộn tự động với quyền truy cập được chia sẻ, vì vậy chơi
âm thanh nổi và đa kênh cùng lúc sẽ hoạt động như mong đợi.

Trung tâm Trình điều khiển đầu ra âm thanh OSS


Đặt thiết bị đầu ra âm thanh (mặc định: / dev / dsp).


Đặt thiết bị trộn âm thanh (mặc định: / dev / mixer).


Đặt kênh bộ trộn âm thanh (mặc định: pcm). Các giá trị hợp lệ khác bao gồm tập,
pcm, hàng. Để có danh sách đầy đủ các tùy chọn, hãy tìm ÂM THANH_DEVICE_NAMES in
/usr/include/linux/soundcard.h.

jack Trình điều khiển đầu ra âm thanh JACK (Jack Audio Connection Kit)

cổng =
Kết nối với các cổng có tên đã cho (mặc định: cổng vật lý).

tên =
Tên ứng dụng khách được chuyển cho JACK (mặc định: mpv). Hữu ích nếu bạn muốn
có một số kết nối được thiết lập tự động.

(không-) tự động khởi động
Tự động khởi động jackd nếu cần (mặc định: bị vô hiệu hóa). Lưu ý rằng điều này
có xu hướng không đáng tin cậy và sẽ làm tràn ngập các tin nhắn máy chủ.

(không kết nối
Tự động tạo kết nối đến các cổng đầu ra (mặc định: đã bật). Khi nào
được bật, số lượng kênh đầu ra tối đa sẽ bị giới hạn ở số lượng
của các cổng đầu ra có sẵn.

std-channel-layout = waveext | any
Chọn bố cục kênh tiêu chuẩn (mặc định: waveext). Bản thân JACK không có
khái niệm về bố cục kênh (nghĩa là chỉ định loa nào mà một kênh nhất định là
phải ánh xạ tới) - nó chỉ lấy bất cứ thứ gì ứng dụng xuất ra và
định tuyến lại nó đến bất cứ điều gì người dùng xác định. Điều này có nghĩa là người dùng và
ứng dụng phụ trách xử lý bố trí kênh. bước sóng sử dụng
WAVE_FORMAT_EXTENSIBLE đơn đặt hàng, ngay cả khi nó được xác định bởi
Microsoft, là tiêu chuẩn trên nhiều hệ thống. Giá trị bất kì làm cho JACK chấp nhận
bất kỳ thứ gì đến từ chuỗi bộ lọc âm thanh, bất kể bố cục kênh và
mà không cần sắp xếp lại. Chế độ này có lẽ không hữu ích lắm, ngoại trừ
gỡ lỗi hoặc khi được sử dụng với các thiết lập cố định.

lõiaudio (Mạc OS X chỉ)
Trình điều khiển đầu ra âm thanh gốc Mac OS X sử dụng AudioUnits và âm thanh CoreAudio
máy chủ.

Tự động chuyển hướng đến coreaudio_exclusive khi phát các định dạng nén.

change-vật lý-định dạng =
Thay đổi định dạng vật lý thành một định dạng tương tự như định dạng âm thanh được yêu cầu
(mặc định: không). Điều này có lợi thế là đầu ra âm thanh đa kênh sẽ
thực sự hoạt động. Điểm bất lợi là nó sẽ thay đổi âm thanh toàn hệ thống
cài đặt. Điều này tương đương với việc thay đổi Định dạng thiết lập trong Bài nghe
Thiết bị (Devices) hộp thoại trong Bài nghe MIDI Thành lập tính thiết thực. Lưu ý rằng điều này không
hiệu ứng thiết lập loa đã chọn.

độc quyền
Sử dụng quyền truy cập chế độ độc quyền. Điều này chỉ chuyển hướng đến coreaudio_exclusive, Nhưng
nên được ưu tiên hơn là sử dụng AO trực tiếp.

coreaudio_exclusive (Mạc OS X chỉ)
Trình điều khiển đầu ra âm thanh gốc Mac OS X sử dụng quyền truy cập thiết bị trực tiếp và chế độ độc quyền
(bỏ qua máy chủ âm thanh).

mở cửa Trình điều khiển đầu ra âm thanh OpenAL thử nghiệm

LƯU Ý:
Trình điều khiển này không phải là rất hữu ích. Phát âm thanh đa kênh với nó rất chậm.

xung Trình điều khiển đầu ra âm thanh PulseAudio

[ ] [: chìm>]
Chỉ định máy chủ lưu trữ và tùy chọn đầu ra chìm để sử dụng. Trống rỗng dây
sử dụng kết nối cục bộ, "localhost" sử dụng chuyển mạng (rất có thể không
bạn muốn gì).

đệm = <1-2000 | gốc>
Đặt kích thước bộ đệm âm thanh tính bằng mili giây. Giá trị cao hơn chứa nhiều dữ liệu hơn,
và có xác suất chạy dưới bộ đệm thấp hơn. Một giá trị nhỏ hơn làm cho
luồng âm thanh phản ứng nhanh hơn, chẳng hạn như thay đổi tốc độ phát lại. Mặc định: 250.

latency-hacks =
Bật hack để giải quyết lỗi định thời PulseAudio (mặc định: không). Nếu được bật,
mpv sẽ tự tính toán độ trễ phức tạp. Nếu bị vô hiệu hóa, nó sẽ
sử dụng thông tin thời gian được cập nhật tự động của PulseAudio. Đang vô hiệu hóa cái này
có thể hữu ích với ví dụ như âm thanh được nối mạng hoặc một số plugin, trong khi bật nó
có thể hữu ích trong một số tình huống không xác định (trước đây cần phải có để trở nên tốt
hành vi trên các phiên bản PulseAudio cũ).

Nếu bạn có video nói lắp khi sử dụng xung, hãy thử bật tùy chọn này.
(Hoặc cách khác, hãy thử cập nhật PulseAudio.)

d âm (Các cửa sổ chỉ)
Trình điều khiển đầu ra âm thanh DirectX DirectSound

LƯU Ý:
Trình điều khiển này là để tương thích với các hệ thống cũ.

thiết bị =
Đặt số thiết bị để sử dụng. Đang phát tệp với -v sẽ hiển thị một danh sách
các thiết bị có sẵn.

kích thước bộ đệm =
Kích thước bộ đệm DirectSound tính bằng mili giây (mặc định: 200).

sđl Trình điều khiển đầu ra âm thanh SDL 1.2+. Sẽ hoạt động trên bất kỳ nền tảng nào được hỗ trợ bởi SDL 1.2, nhưng
có thể yêu cầu SDL_AUDIODRIVER biến môi trường được đặt thích hợp cho
hệ thống của bạn.

LƯU Ý:
Trình điều khiển này là để tương thích với các môi trường cực kỳ xa lạ, chẳng hạn như
hệ thống không có trình điều khiển nào khác khả dụng.

buflen =
Đặt độ dài bộ đệm âm thanh tính bằng giây. Chỉ được sử dụng như một gợi ý bằng âm thanh
hệ thống. Đang phát tệp với -v sẽ hiển thị chính xác được yêu cầu và thu được
kích thước bộ đệm. Giá trị 0 chọn mặc định của hệ thống âm thanh.

bufcnt =
Đặt số lượng bộ đệm âm thanh bổ sung trong mpv. Thường không cần thay đổi.

vô giá trị Không tạo ra âm thanh đầu ra nhưng vẫn duy trì tốc độ phát lại video. Sử dụng --ao = null: không có thời gian
để đo điểm chuẩn.

không có thời gian
Không mô phỏng thời gian của một thiết bị âm thanh hoàn hảo. Điều này có nghĩa là giải mã âm thanh
sẽ diễn ra nhanh nhất có thể, thay vì định thời gian cho đồng hồ hệ thống.

đệm Độ dài bộ đệm mô phỏng tính bằng giây.

bộc phát
Kích thước đoạn mô phỏng trong các mẫu.

tốc độ Tốc độ phát lại âm thanh được mô phỏng dưới dạng hệ số nhân. Thông thường, một thiết bị âm thanh thực
sẽ không nhanh như đồng hồ hệ thống. Nó sẽ đi chệch hướng chỉ
ít, và tùy chọn này giúp mô phỏng điều này.

Độ trễ
Độ trễ của thiết bị được mô phỏng. Điều này là bổ sung cho EOF.

tan vỡ
Mô phỏng trình điều khiển âm thanh bị hỏng, luôn thêm độ trễ cố định của thiết bị vào
vị trí phát lại âm thanh được báo cáo.

sự chậm trễ bị phá vỡ
Mô phỏng trình điều khiển âm thanh bị hỏng, không báo cáo độ trễ một cách chính xác.

bố cục kênh
Nếu không trống, đây là một , danh sách bố trí kênh riêng biệt mà AO cho phép.
Điều này có thể được sử dụng để kiểm tra lựa chọn bố cục kênh.

pcm Đầu ra âm thanh của trình ghi tệp PCM / WAVE thô

(no-) waveheader
Bao gồm hoặc không bao gồm tiêu đề WAVE (mặc định: bao gồm). Khi không
bao gồm, PCM thô sẽ được tạo.

tập tin =
Viết âm thanh cho thay vì mặc định audiodump.wav. Nếu
không có đầu sóng được chỉ định, mặc định là audiodump.pcm.

(no-) chắp thêm
Nối vào tệp, thay vì ghi đè nó. Luôn sử dụng cái này với
không có đầu sóng tùy chọn - với đầu sóng nó bị hỏng, bởi vì nó sẽ viết một
Tiêu đề WAVE mỗi khi tệp được mở.

âm vang Đầu ra âm thanh cho một daemon RSound

LƯU Ý:
Hoàn toàn vô dụng, trừ khi bạn có ý định chạy RSound. Không nên nhầm lẫn với
RoarAudio, một thứ hoàn toàn khác.

máy chủ =
Đặt địa chỉ của máy chủ (mặc định: localhost). Có thể là một mạng
tên máy chủ cho các kết nối TCP hoặc đường dẫn ổ cắm miền Unix bắt đầu bằng '/'.

cổng =
Đặt cổng TCP được sử dụng để kết nối với máy chủ (mặc định: 12345). Không
được sử dụng nếu kết nối với ổ cắm miền Unix.

sndio Đầu ra âm thanh cho hệ thống âm thanh sndio OpenBSD

LƯU Ý:
Thực nghiệm. Có những lỗi và sự cố đã biết.

(Lưu ý: chỉ hỗ trợ bố cục kênh mono, stereo, 4.0, 5.1 và 7.1.)

thiết bị =
thiết bị sndio để sử dụng (mặc định: $ AUDIODEVICE, tương ứng. snd0).

wasapi Đầu ra âm thanh tới API phiên âm thanh của Windows.

độc quyền
Yêu cầu quyền truy cập phần cứng trực tiếp, độc quyền. Theo định nghĩa ngăn chặn âm thanh
phát lại bất kỳ chương trình nào khác cho đến khi thoát mpv.

thiết bị =
Sử dụng điểm cuối được yêu cầu thay vì điểm cuối âm thanh mặc định của hệ thống.
Cả số thứ tự (0,1,2, ...) và Chuỗi GUID đều hợp lệ; HƯỚNG DẪN
chuỗi được đảm bảo không thay đổi trừ khi trình điều khiển được gỡ cài đặt.

Cũng hỗ trợ tìm kiếm các thiết bị đang hoạt động theo tên có thể đọc được của con người. Nếu nhiều hơn
một thiết bị khớp với tên, từ chối tải nó.

Tùy chọn này hầu như không được dùng nữa để thay thế cho tùy chọn tổng quát hơn
--thiết bị âm thanh lựa chọn. Mà nói, --audio-device = trợ giúp sẽ đưa ra một danh sách
GUID thiết bị hợp lệ (có tiền tố là wasapi /), cũng như con người có thể đọc được
tên, mà sẽ hoạt động ở đây.

Thêm bài này vào danh sách Video của bạn Download bài này OUTPUT DRIVERS

Trình điều khiển đầu ra video là giao diện cho các cơ sở đầu ra video khác nhau. Cú pháp là:

--vo =
Chỉ định danh sách ưu tiên các trình điều khiển đầu ra video sẽ được sử dụng.

Nếu danh sách có dấu ',', mpv sẽ trở lại các trình điều khiển không có trong danh sách.
Các tiểu mục là tùy chọn và hầu như có thể được bỏ qua.

Bạn cũng có thể đặt giá trị mặc định cho từng trình điều khiển. Các giá trị mặc định được áp dụng trước giá trị bình thường
thông số trình điều khiển.

--vo-defaults =
Đặt giá trị mặc định cho từng trình điều khiển.

LƯU Ý:
Xem --vo = giúp đỡ để biết danh sách các trình điều khiển đầu ra video đã được biên dịch.

Trình điều khiển đầu ra được khuyến nghị là --vo = opengl-hq. Tất cả các trình điều khiển khác dành cho
khả năng tương thích hoặc các mục đích đặc biệt. Theo mặc định, --vo = opengl được sử dụng, nhưng nếu điều đó xuất hiện
không hoạt động, nó dự phòng cho các trình điều khiển khác (theo thứ tự như được liệt kê bởi --vo = giúp đỡ).

Trình điều khiển đầu ra video có sẵn là:

xv (X11 chỉ)
Sử dụng tiện ích mở rộng XVideo để cho phép hiển thị tăng tốc phần cứng. Cái này là nhất
tương thích VO trên X, nhưng có thể chất lượng thấp và có vấn đề với OSD và phụ đề
trưng bày.

LƯU Ý:
Trình điều khiển này là để tương thích với các hệ thống cũ.

bộ chuyển đổi =
Chọn một bộ điều hợp XVideo cụ thể (kiểm tra kết quả xvinfo).

cổng =
Chọn một cổng XVideo cụ thể.

ck =
Chọn nguồn lấy phím màu (mặc định: cur).

ass Mặc định lấy khóa màu hiện được đặt trong Xv.

sử dụng Sử dụng nhưng không đặt khóa màu từ mpv (sử dụng --màu sắc chính tùy chọn
để thay đổi nó).

định Tương tự như cách sử dụng nhưng cũng đặt phím màu được cung cấp.

ck-method =
Đặt phương pháp vẽ phím màu (mặc định: man).

người đàn ông Vẽ phím màu theo cách thủ công (giảm nhấp nháy trong một số trường hợp).

bg Đặt phím màu làm nền cửa sổ.

tự động Cho Xv vẽ chìa khóa màu.

phím màu =
Thay đổi phím màu thành giá trị RGB mà bạn chọn. 0x000000 là màu đen và
0xffffff là màu trắng.

không màu
Tắt tính năng khóa màu.

bộ đệm =
Số bộ đệm hình ảnh để sử dụng cho bộ đệm nhạc chuông bên trong (mặc định: 2).
Việc tăng điều này sẽ sử dụng nhiều bộ nhớ hơn, nhưng có thể giúp ích cho máy chủ X thì không
phản hồi đủ nhanh nếu FPS của video gần bằng hoặc cao hơn
tốc độ làm mới hiển thị.

x11 (X11 chỉ)
Trình điều khiển đầu ra video bộ nhớ dùng chung mà không cần tăng tốc phần cứng hoạt động bất cứ khi nào
X11 có mặt.

LƯU Ý:
Đây chỉ là dự phòng và không nên được sử dụng bình thường.

vdpau (X11 chỉ)
Sử dụng giao diện VDPAU để hiển thị và cũng có thể giải mã video. Phần cứng
giải mã được sử dụng với --hwdec = vdpau.

LƯU Ý:
Các phiên bản trước đó của mpv (và MPlayer, mplayer2) đã cung cấp các tùy chọn phụ để điều chỉnh
vdpau xử lý hậu kỳ, như định mệnh, làm sắc nét, làm biến chất, sắc độ, kéo lên,
tỷ lệ hqscaling. Các tùy chọn phụ này không được dùng nữa và bạn nên sử dụng vdpaupp
thay vào đó là bộ lọc video.

mài = <-1-1>
(Không được dùng nữa. Xem ghi chú về vdpaupp.)

Đối với các giá trị dương, hãy áp dụng thuật toán làm sắc nét cho video, đối với giá trị âm
giá trị thuật toán làm mờ (mặc định: 0).

biến tính = <0-1>
(Không được dùng nữa. Xem ghi chú về vdpaupp.)

Áp dụng thuật toán giảm nhiễu cho video (mặc định: 0; không nhiễu
giảm).

deint = <-4-4>
(Không được dùng nữa. Xem ghi chú về vdpaupp.)

Chọn chế độ khử xen kẽ (mặc định: 0). Trong các phiên bản cũ hơn (cũng như
MPlayer / mplayer2) bạn có thể sử dụng tùy chọn này để bật tính năng khử xen kẽ. Cái này
không hoạt động nữa và chức năng khử xen kẽ được bật với d key (bởi
ánh xạ mặc định đến lệnh chu kỳ khử xen kẽ), hoặc là --deinterlace
lựa chọn. Ngoài ra, để chọn chế độ deint mặc định, bạn nên sử dụng
Lượt thích --vf-defaults = vdpaupp: deint-mode = temporal thay vì tùy chọn phụ này.

0 Chọn vdpaupp bộ lọc video mặc định, tương ứng với 3.

1 Chỉ hiển thị trường đầu tiên.

2 Bob khử xen kẽ.

3 Khử xen kẽ theo thời gian thích ứng với chuyển động. Có thể dẫn đến giải mã A / V với
phần cứng video chậm và / hoặc độ phân giải cao.

4 Không xen kẽ theo thời gian thích ứng với chuyển động với không gian có hướng dẫn cạnh
phép nội suy. Cần phần cứng video nhanh.

sắc độ
(Không được dùng nữa. Xem ghi chú về vdpaupp.)

Làm cho các bộ khử xen kẽ thời gian hoạt động cả trên luma và chroma (mặc định). Sử dụng
no-chroma-deint để chỉ sử dụng luma và tăng tốc độ khử xen kẽ nâng cao.
Hữu ích với bộ nhớ video chậm.

kéo lên (Không được dùng nữa. Xem ghi chú về vdpaupp.)

Cố gắng áp dụng telecine nghịch đảo, cần khử xen kẽ thời gian thích ứng chuyển động.

hqscaling = <0-9>
(Không được dùng nữa. Xem ghi chú về vdpaupp.)

0 Sử dụng tỷ lệ VDPAU mặc định (mặc định).

1-9 Áp dụng quy mô VDPAU chất lượng cao (cần phần cứng có khả năng).

fps =
Ghi đè giá trị tốc độ làm mới màn hình được phát hiện tự động (giá trị này cần thiết cho
khung để cho phép tốc độ phát lại video cao hơn tốc độ làm mới màn hình,
và để điều chỉnh thời gian khung nhận biết vsync). Mặc định 0 có nghĩa là sử dụng
giá trị tự động phát hiện. Giá trị dương được hiểu là tốc độ làm mới tính bằng Hz
và ghi đè giá trị được phát hiện tự động. Giá trị âm vô hiệu hóa tất cả thời gian
điều chỉnh và logic khung.

phát hiện tổng hợp
Việc triển khai VDPAU hiện tại của NVIDIA hoạt động hơi khác theo
trình quản lý cửa sổ tổng hợp và không cung cấp thời gian khung hình chính xác
thông tin. Với tùy chọn này được bật, người chơi sẽ cố gắng phát hiện xem
trình quản lý cửa sổ tổng hợp đang hoạt động. Nếu một người được phát hiện, người chơi
tắt điều chỉnh thời gian như thể người dùng đã chỉ định fps = -1 (như họ
sẽ dựa trên đầu vào không chính xác). Điều này có nghĩa là thời gian có phần ít hơn
chính xác hơn là không kết hợp, nhưng với hành vi chế độ tổng hợp của
trình điều khiển NVIDIA, không có giới hạn tốc độ phát lại cứng ngay cả khi không có
logic bị vô hiệu hóa. Được bật theo mặc định, sử dụng không-tổng-hợp-phát hiện để vô hiệu hóa.

queuetime_windowed = và queuetime_fs =
Sử dụng chức năng hàng đợi bản trình bày của VDPAU để xếp hàng khung video trong tương lai
thay đổi nhiều nhất là nhiều mili giây này trước (mặc định: 50). Xem bên dưới
để biết thêm thông tin.

output_surfaces = <2-15>
Phân bổ nhiều bề mặt đầu ra này để hiển thị khung hình video (mặc định: 3). Xem
dưới đây để biết thêm thông tin.

phím màu = <# RRGGBB | #AARRGGBB>
Đặt màu nền hàng đợi bản trình bày VDPAU, trong thực tế, màu này là
phím màu được sử dụng nếu VDPAU hoạt động ở chế độ lớp phủ (mặc định: #020507, một số
bóng đen). Nếu thành phần alpha của giá trị này là 0, giá trị mặc định
Phím màu VDPAU sẽ được sử dụng thay thế (thường có màu xanh lục).

buộc-yuv
Không bao giờ chấp nhận đầu vào RGBA. Điều này có nghĩa là mpv sẽ chèn một bộ lọc để chuyển đổi thành
Định dạng YUV trước VO. Đôi khi hữu ích để buộc có sẵn một số
Các tính năng chỉ dành cho YUV, như bộ cân bằng video hoặc khử xen kẽ.

Sử dụng chức năng xếp hàng khung VDPAU được điều khiển bởi các tùy chọn thời gian hàng đợi
làm cho thời gian lật khung của mpv ít nhạy cảm hơn với tải CPU của hệ thống và cho phép mpv
bắt đầu giải mã (các) khung hình tiếp theo sớm hơn một chút, điều này có thể làm giảm hiện tượng chập chờn gây ra
bằng các khung giải mã chậm riêng lẻ. Tuy nhiên, trình điều khiển đồ họa NVIDIA có thể làm cho
hành vi cửa sổ khác chẳng hạn như cửa sổ di chuyển bị giật nếu VDPAU đang sử dụng hàng đợi blit
(chủ yếu xảy ra nếu bạn đã bật tiện ích mở rộng tổng hợp) và tính năng này là
tích cực. Nếu điều này xảy ra trên hệ thống của bạn và nó làm phiền bạn thì bạn có thể đặt
giá trị thời gian hàng đợi thành 0 để tắt tính năng này. Các cài đặt để sử dụng trong cửa sổ và
chế độ toàn màn hình là riêng biệt vì không có lý do gì để tắt chế độ này cho
chế độ toàn màn hình (vì vấn đề trình điều khiển sẽ không ảnh hưởng đến video).

Bạn có thể xếp hàng trước nhiều khung hơn bằng cách tăng giá trị thời gian xếp hàng và
đầu ra_bề mặt đếm (để đảm bảo có đủ bề mặt để đệm video trong một thời gian nhất định
phía trước, bạn cần ít nhất bao nhiêu bề mặt vì video có khung hình trong thời gian đó,
cộng hai). Điều này có thể giúp video mượt mà hơn trong một số trường hợp. Nhược điểm chính
là yêu cầu RAM video tăng lên đối với các bề mặt và phản hồi hiển thị chậm hơn
đối với các lệnh của người dùng (các thay đổi hiển thị chỉ hiển thị một thời gian sau khi chúng
xếp hàng). Việc triển khai trình điều khiển đồ họa cũng có thể có giới hạn về độ dài của
thời gian xếp hàng tối đa hoặc số lượng bề mặt được xếp hàng hoạt động tốt hoặc hoàn toàn.

direct3d_shader (Các cửa sổ chỉ)
Trình điều khiển đầu ra video sử dụng giao diện Direct3D.

LƯU Ý:
Trình điều khiển này là để tương thích với các hệ thống không cung cấp OpenGL thích hợp
trình điều khiển.

thích kéo dài
Sử dụng IDirect3DDevice9 :: StretchRect qua các phương pháp khác nếu có thể.

vô hiệu hóa kéo dài
Không bao giờ kết xuất video bằng IDirect3DDevice9 :: StretchRect.

vô hiệu hóa kết cấu
Không bao giờ kết xuất video bằng kết xuất họa tiết D3D. Kết xuất với các kết cấu
+ shader sẽ vẫn được phép. Thêm vào vô hiệu hóa-shader để vô hiệu hóa hoàn toàn
kết xuất video với kết cấu.

vô hiệu hóa-shader
Không bao giờ sử dụng bộ đổ bóng khi kết xuất video.

chỉ-8bit
Không bao giờ hiển thị video YUV với nhiều hơn 8 bit cho mỗi thành phần. Sử dụng cờ này
sẽ buộc chuyển đổi phần mềm thành 8-bit.

vô hiệu hóa-kết cấu-căn chỉnh
Thông thường, kích thước họa tiết luôn được căn chỉnh thành 16. Với tùy chọn này được bật,
kết cấu video sẽ luôn có cùng kích thước với video
chính nó.

Tùy chọn gỡ lỗi. Những điều này có thể không chính xác, có thể bị xóa trong tương lai, có thể
sự cố, có thể gây chậm máy, v.v. Hãy liên hệ với nhà phát triển nếu bạn thực sự cần
trong số này cho hiệu suất hoặc hoạt động thích hợp.

lực-sức-của-2
Luôn buộc các kết cấu ở mức 2, ngay cả khi thiết bị báo
kích thước kết cấu không phải của 2 như được hỗ trợ.

kết cấu-bộ nhớ =
Chỉ ảnh hưởng đến hoạt động khi bật chế độ tạo bóng / tạo kết cấu và (E) OSD. Có thể được
các giá trị:

mặc định (Default)
Sử dụng D3DPOOL_DEFAULT, Với một D3DPOOL_HỆ THỐNG kết cấu để khóa. Nếu
trình điều khiển hỗ trợ D3DDEVCAPS_TEXTUREHỆ THỐNG NHỚ, D3DPOOL_HỆ THỐNG
được sử dụng trực tiếp.

nhóm mặc định
Sử dụng D3DPOOL_DEFAULT. (Như mặc định, nhưng không bao giờ sử dụng kết cấu bóng.)

mặc định-pool-shadow
Sử dụng D3DPOOL_DEFAULT, Với một D3DPOOL_HỆ THỐNG kết cấu để khóa.
(Giống mặc định, nhưng luôn ép kết cấu bóng.)

quản lý
Sử dụng D3DPOOL_MANAGED.

xước
Sử dụng D3DPOOL_SCRATCH, Với một D3DPOOL_HỆ THỐNG kết cấu để khóa.

hoán đổi-loại bỏ
Sử dụng D3DSWAPEFFECT_DISCARD, có thể nhanh hơn. Cũng có thể chậm hơn, như
nó phải (?) rõ ràng mọi khung hình.

bộ đệm chính xác
Luôn thay đổi kích thước bộ đệm sau thành kích thước cửa sổ.

direct3d (Các cửa sổ chỉ)
Giống như direct3d_shader, nhưng với các tùy chọn vô hiệu hóa kết cấu và vô hiệu hóa-shader
bị ép.

LƯU Ý:
Trình điều khiển này là để tương thích với các hệ thống cũ.

OpenGL Trình điều khiển đầu ra video OpenGL. Nó hỗ trợ các phương pháp chia tỷ lệ mở rộng, phối màu và
quản lý màu sắc.

Theo mặc định, nó cố gắng sử dụng các cài đặt nhanh và không an toàn. Sử dụng bí danh opengl-hq đến
sử dụng trình điều khiển này với các giá trị mặc định được đặt thành kết xuất chất lượng cao.

Yêu cầu ít nhất OpenGL 2.1.

Một số tính năng chỉ khả dụng với trình điều khiển đồ họa hỗ trợ OpenGL 3 (hoặc nếu
các phần mở rộng cần thiết có sẵn).

OpenGL ES 2.0 và 3.0 cũng được hỗ trợ.

Giải mã phần cứng qua OpenGL-interop được hỗ trợ ở một mức độ nào đó. Lưu ý rằng trong
chế độ này, một số trường hợp ở góc có thể không được xử lý khéo léo và không gian màu
chuyển đổi và lấy mẫu sắc độ nói chung nằm trong tay của bộ giải mã phần cứng
API.

OpenGL sử dụng FBO theo mặc định. Đôi khi bạn có thể đạt được chất lượng tốt hơn hoặc
hiệu suất bằng cách thay đổi định dạng fbo phụ đề cho rgb16f, rgb32f or rgb. Đã biết
các vấn đề bao gồm Mesa / Intel không chấp nhận rgb16, Mesa đôi khi không được biên dịch
với hỗ trợ kết cấu nổi và một số thiết lập OS X rất chậm với rgb16 nhưng
nhanh chóng với rgb32f. Nếu bạn gặp sự cố, bạn cũng có thể thử vượt qua chế độ câm = vâng
tùy chọn phụ.

chế độ câm =
Chế độ này cực kỳ hạn chế và sẽ vô hiệu hóa hầu hết các OpenGL mở rộng
Tính năng, đặc điểm. Điều này bao gồm bộ chia tỷ lệ chất lượng cao và bộ đổ bóng tùy chỉnh!

Nó dành cho phần cứng không hỗ trợ FBO (bao gồm GLES,
hỗ trợ nó không đầy đủ) hoặc để có thêm một số hiệu suất từ
phần cứng xấu hoặc cũ.

Chế độ này được buộc tự động nếu cần và tùy chọn này chủ yếu là
hữu ích cho việc gỡ lỗi. Nó cũng được bật tự động nếu không có gì sử dụng
các tính năng yêu cầu FBO.

Tùy chọn này có thể bị xóa trong tương lai.

quy mô =

song tuyến tính
Lọc kết cấu phần cứng song tuyến (nhanh nhất, chất lượng rất thấp). Đây là
mặc định vì lý do tương thích.

spline36
Chất lượng và tốc độ trung bình. Đây là mặc định khi sử dụng opengl-hq.

lanczos
Mở rộng quy mô Lanczos. Cung cấp chất lượng và tốc độ trung bình. Nói chung là tệ hơn
spline36, nhưng nó dẫn đến hình ảnh sắc nét hơn một chút, rất tốt cho
một số loại nội dung. Số lượng vòi có thể được kiểm soát với
bán kính quy mô, nhưng tốt nhất là không thay đổi.

Bộ lọc này tương ứng với bộ lọc cũ lanczos3 bí danh nếu bán kính mặc định
được sử dụng, trong khi lanczos2 tương ứng với bán kính bằng 2.

(Bộ lọc này là bí danh cho chân thành-có gió chân thành)

ewa_lanczos
Tỷ lệ Lanczos trung bình có trọng số elliptic. Còn được gọi là Jinc.
Tương đối chậm, nhưng chất lượng rất tốt. Bán kính có thể được kiểm soát với
bán kính quy mô. Tăng bán kính làm cho bộ lọc sắc nét hơn nhưng thêm
nhiều chuông hơn.

(Bộ lọc này là bí danh cho jinc-có gió jinc)

ewa_lanczossharp
Một phiên bản hơi sắc nét của ewa_lanczos, được định cấu hình trước để sử dụng
bán kính và thông số lý tưởng. Nếu phần cứng của bạn có thể chạy nó, đây có thể là
những gì bạn nên sử dụng theo mặc định.

mitchell
Mitchell-Netravali. Các B và C các tham số có thể được thiết lập với quy mô-param1
và quy mô-param2. Bộ lọc này rất tốt trong việc giảm tỷ lệ (xem quy mô).

lấy mẫu
Một phiên bản của hàng xóm gần nhất (nguyên bản) làm quá các pixel, do đó
pixel các cạnh chồng lên nhau được nội suy tuyến tính thay vì làm tròn.
Điều này về cơ bản loại bỏ các khiếm khuyết nhỏ và tạo tác rung
gây ra bởi phép nội suy láng giềng gần nhất, để đổi lấy việc thêm một số
mơ hồ. Bộ lọc này tốt trong phép nội suy theo thời gian và còn được gọi là
"Smoothmotion" (xem tỉ lệ).

khách hàng Trình đổ bóng tùy chỉnh do người dùng xác định (xem máy đổ bóng quy mô).

Có một số bộ lọc khác, nhưng hầu hết không hữu ích. Để có một danh sách đầy đủ,
vượt qua giúp đỡ như giá trị, ví dụ:

mpv --vo = opengl: scale = help

scale-param1 = , scale-param2 =
Đặt thông số bộ lọc. Bỏ qua nếu bộ lọc không thể điều chỉnh được. Hiện tại,
điều này ảnh hưởng đến các thông số bộ lọc sau:

bcspline
Thông số spline (B và C). Mặc định là 0.5 cho cả hai.

gaussian
Tham số tỷ lệ (t). Tăng điều này làm cho kết quả mờ hơn.
Giá trị mặc định là 1.

lấy mẫu
Khoảng cách tối thiểu đến một cạnh trước khi sử dụng nội suy. Thiết lập
giá trị này thành 0 sẽ luôn nội suy các cạnh, trong khi đặt nó thành 0.5
sẽ không bao giờ nội suy, do đó hoạt động như thể chính quy gần nhất
thuật toán láng giềng đã được sử dụng. Mặc định là 0.0.

quy mô-mờ =
Hệ số tỷ lệ nhân (còn được gọi là hệ số mờ). Giảm điều này làm cho
kết quả sắc nét hơn, tăng nó làm cho nó mờ hơn (mặc định là 0). Nếu được đặt thành
0, hệ số mờ ưa thích của hạt nhân được sử dụng. Lưu ý rằng cài đặt này quá
thấp (ví dụ: 0.5) dẫn đến kết quả không tốt. Thông thường, bạn nên tuân theo
giá trị từ 0.8 đến 1.2.

bán kính tỷ lệ =
Đặt bán kính cho các bộ lọc được liệt kê bên dưới, phải là một số thực từ 0.5 đến
16.0. Mặc định bán kính ưa thích của bộ lọc nếu không được chỉ định.
chân thành và các dẫn xuất, jinc và các dẫn xuất, gaussian, cái hộp và tam giác

Lưu ý rằng tùy thuộc vào chi tiết triển khai bộ lọc và tỷ lệ video
tỷ lệ, bán kính thực sự đang được sử dụng có thể khác (rất có thể
đang được tăng lên một chút).

đóng cặn =
Đặt cường độ chống mài mòn. Điều này cố gắng loại bỏ đổ chuông, nhưng có thể
giới thiệu các hiện vật khác trong quá trình. Phải là một số thực giữa 0.0
và 1.0. Giá trị mặc định là 0.0 sẽ vô hiệu hóa hoàn toàn quá trình chống lại.

Lưu ý rằng điều này không ảnh hưởng đến các bộ lọc đặc biệt song tuyến tính và bicubic_fast.

scale-window =
(Chỉ dành cho người dùng nâng cao) Chọn một chức năng cửa sổ tùy chỉnh cho hạt nhân.
Mặc định cho cửa sổ ưa thích của bộ lọc nếu không được đặt. Sử dụng scale-window = trợ giúp đến
nhận danh sách các chức năng cửa sổ được hỗ trợ.

scale-wparam =
(Chỉ dành cho người dùng nâng cao) Định cấu hình tham số cho chức năng cửa sổ đã cho
by cửa sổ tỷ lệ. Bỏ qua nếu cửa sổ không thể điều chỉnh được. Hiện tại, điều này
ảnh hưởng đến các thông số cửa sổ sau:

kaiser Tham số cửa sổ (alpha). Mặc định là 6.33.

người da đen
Tham số cửa sổ (alpha). Mặc định là 0.16.

gaussian
Tham số thang đo (t). Tăng điều này làm cho cửa sổ rộng hơn.
Giá trị mặc định là 1.

scaler-lut-size = <4..10>
Đặt kích thước của kết cấu tra cứu cho các nhân có tỷ lệ (mặc định: 6). Các
kích thước thực tế của kết cấu là 2 ^ N cho một giá trị tùy chọn là N. Vì vậy, việc tra cứu
kết cấu với cài đặt mặc định sử dụng 64 mẫu.

Tất cả các trọng lượng đều được nội suy song tinh từ các mẫu đó, do đó tăng
kích thước của bảng tra cứu có thể cải thiện độ chính xác của tỷ lệ.

scale-resize-only
Tắt bộ chia tỷ lệ nếu hình ảnh video không được thay đổi kích thước. Trong trường hợp đó, song tuyến tính
được sử dụng thay thế bất cứ thứ gì được đặt với tỉ lệ. Bilinear sẽ tái tạo
hình ảnh nguồn hoàn hảo nếu không thực hiện chia tỷ lệ. Lưu ý rằng tùy chọn này
không bao giờ ảnh hưởng cscale.

pbo Cho phép sử dụng PBO. Điều này nhanh hơn một chút, nhưng đôi khi có thể dẫn đến
hỏng hình ảnh lẻ tẻ và tạm thời (về lý thuyết, vì tải lại không
thử lại khi không thành công) và có lẽ thực sự kích hoạt các đường dẫn chậm hơn với
trình điều khiển không hỗ trợ PBO đúng cách.

dither-depth =
Đặt độ sâu mục tiêu hòa sắc thành N. Mặc định: không.

Không Tắt mọi phối màu do mpv thực hiện.

tự động Lựa chọn tự động. Nếu độ sâu bit đầu ra không thể được phát hiện, 8 bit
mỗi thành phần được giả định.

8 Dither đến đầu ra 8 bit.

Lưu ý rằng độ sâu của thiết bị hiển thị video được kết nối không thể
được phát hiện. Thông thường, các tấm nền LCD sẽ tự hòa màu, điều này gây xung đột
với OpenGLphối màu và dẫn đến đầu ra xấu xí.

dither-size-fruit = <2-8>
Đặt kích thước của ma trận hòa sắc (mặc định: 6). Kích thước thực tế của
ma trận là (2 ^ N) x (2 ^ N) cho một giá trị tùy chọn là N, vì vậy giá trị của 6 cho
kích thước 64x64. Ma trận được tạo tại thời điểm khởi động và một ma trận lớn
có thể mất khá nhiều thời gian để tính toán (vài giây).

Được dùng trong dither = trái cây chỉ chế độ.

hòa sắc =
Chọn thuật toán phối màu (mặc định: trái cây). (Thông thường, độ sâu
tùy chọn kiểm soát xem có bật phối màu hay không.)

hòa sắc thời gian
Bật phối màu theo thời gian. (Chỉ hoạt động nếu nói chung đã bật phối màu.)
Điều này thay đổi giữa 8 kiểu phối màu khác nhau trên mỗi khung hình bằng cách thay đổi
hướng của ma trận phối màu lát gạch. Thật không may, điều này có thể dẫn đến
nhấp nháy trên màn hình LCD, vì chúng có thời gian phản ứng cao.

temporal-dither-period = <1-128>
Xác định tần suất cập nhật kiểu phối màu khi hòa sắc thời gian
đang được sử dụng. 1 (mặc định) sẽ cập nhật trên mọi khung video, 2 trên mọi
khung khác, v.v.

gỡ lỗi Kiểm tra lỗi OpenGL, tức là cuộc gọi glGetError (). Đồng thời yêu cầu gỡ lỗi OpenGL
ngữ cảnh (không liên quan gì đến trình điều khiển đồ họa hiện tại kể từ đây
viết).

phép nội suy
Giảm hiện tượng nói lắp do không khớp trong khung hình / giây của video và làm mới màn hình
tỷ lệ (còn được gọi là judder).

Chú ý:
Điều này yêu cầu thiết lập --đồng bộ hóa video tùy chọn cho một trong những màn hình hiển thị
hoặc nó sẽ bị tắt âm thầm. Điều này không bắt buộc trước mpv
0.14.0.

Về cơ bản, điều này cố gắng nội suy các khung bị thiếu bằng cách làm phức tạp
video dọc theo trục thời gian. Bộ lọc được sử dụng có thể được kiểm soát bằng cách sử dụng
các tỉ lệ thiết lập.

Lưu ý rằng điều này dựa vào vsync để hoạt động, hãy xem hoán đổi để biết thêm
thông tin.

swapinterval =
Khoảng thời gian trong khung hiển thị giữa hai lần hoán đổi bộ đệm. 1 tương đương với
bật VSYNC, 0 để tắt VSYNC. Mặc định là 1 nếu không được chỉ định.

Lưu ý rằng điều này phụ thuộc vào hỗ trợ OpenGL vsync thích hợp. Trên một số nền tảng và
trình điều khiển, điều này chỉ hoạt động đáng tin cậy khi ở chế độ toàn màn hình. Nó cũng có thể
yêu cầu các bản hack dành riêng cho trình điều khiển nếu sử dụng nhiều màn hình, để đảm bảo mpv
đồng bộ hóa với một trong những bên phải. Tổng hợp trình quản lý cửa sổ cũng có thể dẫn đến
kết quả, vì có thể thiếu hoặc không chính xác thông tin FPS hiển thị (xem
--display-fps).

dscale =
Như tỉ lệ, nhưng thay vào đó hãy áp dụng các bộ lọc này khi giảm tỷ lệ. Nếu tùy chọn này
chưa được đặt, bộ lọc được ngụ ý bởi tỉ lệ sẽ được áp dụng.

cscale =
As tỉ lệ, nhưng để nội suy thông tin về sắc độ. Nếu hình ảnh không
được lấy mẫu con, tùy chọn này bị bỏ qua hoàn toàn.

tscale =
Bộ lọc được sử dụng để nội suy trục thời gian (khung). Đây chỉ là
được sử dụng nếu phép nội suy được kích hoạt. Các lựa chọn hợp lệ duy nhất cho tỉ lệ đang
bộ lọc tích chập phân tách (sử dụng tscale = trợ giúp để có được một danh sách). Mặc định
is mitchell.

Lưu ý rằng bán kính bộ lọc được hỗ trợ tối đa hiện là 3, do
hạn chế về số lượng kết cấu video có thể được tải
đồng thời.

kẹp tscale
Kẹp tỉ lệ lọc phạm vi giá trị của hạt nhân thành [0-1]. Điều này làm giảm
tạo tác đổ chuông quá mức trong miền thời gian (thường biểu hiện
chúng như những tia chớp ngắn hoặc viền đen, chủ yếu là xung quanh các cạnh chuyển động)
đổi lại có khả năng làm mờ nhiều hơn.

bán kính dscale, cscale-bán kính, bán kính tscale, và vv
Đặt thông số bộ lọc cho quy mô, cscale và tỉ lệ, Tương ứng.

Xem các tùy chọn tương ứng cho tỉ lệ.

tỷ lệ tuyến tính
Thang đo trong ánh sáng tuyến tính. Nó chỉ nên được sử dụng với định dạng fbo điều đó có lúc
độ chính xác tối thiểu 16 bit.

hạ tỷ lệ chính xác
Khi sử dụng bộ lọc dựa trên tích chập, hãy mở rộng kích thước bộ lọc khi
giảm quy mô. Tăng chất lượng, nhưng giảm hiệu suất trong khi giảm quy mô.

Điều này sẽ hoạt động hơi kém tối ưu đối với video anamorphic (nhưng vẫn
tốt hơn là không có nó) vì nó sẽ mở rộng kích thước để chỉ phù hợp với
nhẹ hơn của các yếu tố tỷ lệ giữa các trục.

tỷ lệ đặt trước =
Tùy chọn này cung cấp các bộ lọc không dựa trên tích chập để nâng cấp. Này
bộ lọc thay đổi kích thước video thành nhiều kích thước ban đầu (tất cả hiện
các bộ định mức được hỗ trợ chỉ có thể thực hiện nhân đôi hình ảnh trong một lần chuyển).
Nói chung, một bộ lọc dựa trên tích chập khác (tỷ lệ chính) sẽ được áp dụng
sau khi cài đặt trước để phù hợp với kích thước hiển thị mục tiêu.

không ai Vô hiệu hóa tất cả các bộ định mức trước. Đây là mặc định.

superxbr
Một bộ định tỷ lệ tương đối nhanh ban đầu được phát triển cho nghệ thuật pixel.

Một số thông số có thể được điều chỉnh với siêu sắc nét và
superxbr-edge-sức mạnh tùy chọn.

nedi3 Một deinterlacer dựa trên mạng nơ-ron nhân tạo, có thể được sử dụng để
hình ảnh cao cấp.

Cực kỳ chậm và yêu cầu một cạc đồ họa tầm trung hoặc cao cấp gần đây để
hoạt động trơn tru (tính đến năm 2015).

Lưu ý rằng tất cả các bộ lọc ở trên đều được thiết kế (hoặc triển khai) để xử lý
Chỉ máy bay luma và có thể sẽ không hoạt động như dự định cho video ở định dạng RGB.

tỷ lệ đặt trước = <1..5>
Số lần vượt qua để áp dụng bộ định tỷ lệ (mặc định là 1). Đặt nó
đến 2 sẽ thực hiện nâng cấp 4x.

prescale-downcaling-ngưỡng = <0..32>
Tùy chọn này ngăn việc sử dụng "quá mức cần thiết" của các bộ định mức trước, có thể do
định cấu hình sai hoặc người dùng cố phát video có kích thước lớn hơn nhiều. Với
tùy chọn này, người dùng có thể chỉ định tỷ lệ giảm quy mô tối đa được phép trong cả hai
kích thước. Để đáp ứng nó, số lần vượt qua cho bộ đếm trước sẽ là
giảm và nếu cần thiết cũng có thể tắt tính năng đặt trước.

Giá trị mặc định là 2.0 và sẽ có thể ngăn hầu hết các
sử dụng không hợp lý các điểm đặt trước. Hầu hết người dùng có thể muốn đặt nó thành
giá trị nhỏ hơn từ 1.0 đến 1.5 để có hiệu suất tốt hơn.

Giá trị nhỏ hơn 1.0 sẽ vô hiệu hóa việc kiểm tra.

nnedi3-neurons=<16|32|64|128>
Chỉ định các nơ-ron cho tính năng đặt trước nnedi3 (mặc định là 32). Kết xuất
thời gian được cho là tuyến tính với số lượng tế bào thần kinh.

nnedi3-window=<8x4|8x6>
Chỉ định kích thước của cửa sổ cục bộ để lấy mẫu trong tính năng đặt trước nnedi3 (mặc định
được 8x4). Các 8x6 window tạo ra hình ảnh sắc nét hơn, nhưng cũng chậm hơn.

nnedi3-upload =
Chỉ định cách tải trọng số NN lên GPU. Tùy thuộc vào card đồ họa,
trình điều khiển, trình biên dịch shader và cài đặt nnedi3, cả hai phương pháp đều có thể nhanh hơn hoặc
Chậm hơn.

ubo Tải các trọng lượng này lên thông qua các đối tượng đệm thống nhất. Đây là mặc định.
(yêu cầu OpenGL 3.1 / GLES 3.0)

shader Mã cứng tất cả các trọng số vào mã nguồn shader. (đòi hỏi
OpenGL 3.3/GLES 3.0)

pre-shader = , post-shaders = , scale-shader =
Trình tạo bóng phân đoạn GLSL tùy chỉnh.

pre-shader (danh sách)
Chúng được áp dụng sau khi chuyển đổi sang RGB và trước khi tuyến tính hóa
và nâng cấp. Hoạt động trên RGB phi tuyến tính (giống như đầu vào). Đây là
nơi tốt nhất để đặt những thứ như làm sắc nét bộ lọc.

máy đổ bóng quy mô
Điều này được sử dụng thay vì tỷ lệ / cscale khi các tùy chọn đó được đặt thành
khách hàng. Không gian màu mà nó hoạt động phụ thuộc vào các giá trị của
tỷ lệ tuyến tính và sigmoid-nâng cấp, vì vậy không có giả định nào nên
được thực hiện tại đây.

post-shader (danh sách)
Chúng được áp dụng sau khi nâng cấp và trộn phụ đề (khi
pha trộn phụ đề được bật), nhưng trước khi quản lý màu. Hoạt động
trên RGB tuyến tính nếu tỷ lệ tuyến tính có hiệu lực, nếu không thì phi tuyến tính
RGB. Đây là nơi tốt nhất để chuyển đổi không gian màu (ví dụ:
ánh xạ bão hòa).

Các tệp này phải xác định một hàm với chữ ký sau:

vec4 mẫu (sampler2D tex, vec2 pos, vec2 tex_size)

Ý nghĩa của các tham số như sau:

bộ lấy mẫu2D tex
Kết cấu nguồn cho bộ đổ bóng.

vec2 gửi
Vị trí cần lấy mẫu, trong không gian tọa độ [0-1].

vec2 tex_size
Kích thước của kết cấu, tính bằng pixel. Điều này có thể khác với image_size,
ví dụ. cho nội dung được lấy mẫu con hoặc cho người làm bóng hậu kỳ.

Ngoài các thông số này, các bộ đồng phục sau đây cũng được toàn cầu
có sẵn:

phao ngẫu nhiên
Một số ngẫu nhiên trong phạm vi [0-1], khác nhau trên mỗi khung.

int khung
Số lượng khung hình được hiển thị đơn giản, tăng lên một khung hình và
không bao giờ đặt lại (bất kể tìm kiếm).

vec2 kích thước ảnh
Kích thước tính bằng pixel của hình ảnh đầu vào.

Ví dụ: một bộ đổ bóng có thể đảo ngược màu sắc có thể trông như thế này:

vec4 mẫu (sampler2D tex, vec2 pos, vec2 tex_size)
{
vec4 color = texture (tex, pos);
return vec4 (1.0 - color.rgb, color.a);
}

bỏ đi Bật thuật toán loại bỏ. Điều này làm giảm đáng kể lượng hiển thị
tạo dải, chặn và các hiện vật lượng tử hóa khác, với cái giá rất đắt
hơi làm mờ một số chi tiết tốt nhất. Trong thực tế, nó hầu như
luôn luôn là một cải tiến - lý do duy nhất để vô hiệu hóa nó sẽ là vì
hiệu suất.

deband-iterations = <1..16>
Số bước bỏ qua cần thực hiện trên mỗi mẫu. Mỗi bước giảm một chút
nhiều dải hơn, nhưng cần thời gian để tính toán. Lưu ý rằng sức mạnh của mỗi bước
giảm rất nhanh, vì vậy các số cao (> 4) thực tế là vô dụng.
(Mặc định 1)

ngưỡng deband = <0..4096>
Ngưỡng cắt của bộ lọc hủy bỏ. Con số cao hơn làm tăng
giảm sức mạnh đáng kể nhưng giảm dần chi tiết hình ảnh.
(Mặc định 64)

dải băng tần = <1..64>
Bán kính ban đầu của bộ lọc hủy bỏ. Bán kính tăng tuyến tính cho
mỗi lần lặp lại. Bán kính cao hơn sẽ tìm thấy nhiều gradient hơn, nhưng bán kính thấp hơn
sẽ mượt mà mạnh mẽ hơn. (Mặc định 16)

Nếu bạn tăng loại bỏ-lặp lại, bạn có thể nên giảm điều này xuống
bù lại.

deband-grain = <0..4096>
Thêm một số nhiễu cho hình ảnh. Điều này giúp che đậy đáng kể
hiện vật lượng tử hóa còn lại. Số cao hơn gây ra nhiều tiếng ồn hơn. (Mặc định
48)

sigmoid-nâng cấp
Khi nâng cấp, hãy sử dụng chuyển đổi màu sắc theo chiều ngang để tránh nhấn mạnh tiếng chuông
hiện vật. Điều này cũng ngụ ý tỷ lệ tuyến tính.

trung tâm sigmoid
Tâm của đường cong sigmoid được sử dụng cho sigmoid-nâng cấp, phải là một phao
từ 0.0 đến 1.0. Giá trị mặc định là 0.75 nếu không được chỉ định.

độ dốc sigmoid
Độ dốc của đường cong sigmoid được sử dụng cho sigmoid-nâng cấp, phải là một phao
từ 1.0 đến 20.0. Giá trị mặc định là 6.5 nếu không được chỉ định.

mài giũa =
Nếu được đặt thành giá trị khác 0, hãy bật bộ lọc tạo mặt nạ không hoạt động. Tích cực
các giá trị sẽ làm sắc nét hình ảnh (nhưng thêm nhiều chuông và răng cưa). Phủ định
giá trị sẽ làm mờ hình ảnh. Nếu GPU của bạn đủ mạnh, hãy xem xét
các lựa chọn thay thế như ewa_lanczossharp bộ lọc quy mô, hoặc quy mô mờ
tùy chọn phụ.

(Tính năng này thay thế cho tính năng cũ mài 3 và mài 5 tỷ lệ.)

tráng men
Gọi số glFinish () trước và sau khi hoán đổi bộ đệm (mặc định: bị vô hiệu hóa).
Chậm hơn, nhưng có thể giúp nhận được kết quả tốt hơn khi thực hiện việc lập khung. Có thể
hoàn toàn làm hỏng hiệu suất. Các chi tiết phụ thuộc hoàn toàn vào OpenGL
người lái xe.

chờvsync
Gọi số glXWaitVideoSyncSGI sau mỗi lần hoán đổi bộ đệm (mặc định: bị vô hiệu hóa). Đây
có thể có hoặc không giúp với độ chính xác của thời gian video và giảm khung hình. Nó có thể
rằng điều này làm cho đầu ra video chậm hơn hoặc không có tác dụng gì.

Chỉ X11 / GLX.

vsync-domains =
Đồng bộ hóa CPU với khung thứ N trong quá khứ bằng cách sử dụng GL_ARB_sync gia hạn. MỘT
giá trị 0 vô hiệu hóa hành vi này (mặc định). Giá trị 1 có nghĩa là nó sẽ
đồng bộ hóa với khung hiện tại sau khi kết xuất nó. Giống tráng men và
chờvsync, điều này có thể làm giảm hoặc làm hỏng hiệu suất. Ưu điểm của nó là nó có thể
mở rộng nhiều khung hình và giới hạn hiệu quả số lượng khung hình của GPU
xếp hàng phía trước (cũng có ảnh hưởng đến vsync).

dwmflush =
Cuộc gọi DwmFlush sau khi hoán đổi bộ đệm trên Windows (mặc định: tự động). Nó cũng
bộ Khoảng thời gian hoán đổi(0) để bỏ qua thời gian OpenGL. Giá trị là: không (bị vô hiệu hóa),
có cửa sổ (chỉ ở chế độ cửa sổ), có (cả ở chế độ toàn màn hình).

Giá trị tự động sẽ cố gắng xác định xem trình soạn nhạc có hoạt động hay không và
cuộc gọi DwmFlush chỉ khi nó có vẻ là như vậy.

Điều này có thể giúp có được khoảng thời gian khung hình nhất quán hơn, đặc biệt là với
clip fps cao - cũng có thể làm giảm khung hình bị giảm. Điển hình là một giá trị
of có cửa sổ là đủ vì toàn màn hình có thể bỏ qua DWM.

Chỉ dành cho Windows.

sw Tiếp tục ngay cả khi phát hiện thấy trình kết xuất phần mềm.

phụ trợ =
Giá trị tự động (mặc định) chọn chương trình phụ trợ cửa sổ. Bạn cũng có thể
vượt qua giúp đỡ để có được danh sách đầy đủ được biên dịch trong phần phụ trợ (được sắp xếp theo
lệnh autoprobe).

tự động tự động chọn (mặc định)

ca cao Ca cao / OS X

giành chiến thắng Win32 / WGL

góc Direct3D11 thông qua lớp dịch OpenGL ES ANGLE. Đây
hỗ trợ hầu hết mọi thứ giành chiến thắng phụ trợ không, ngoại trừ hồ sơ ICC,
đầu vào video độ sâu bit cao và nedi3 bộ định mức.

dxinterop (thực nghiệm)
Win32, sử dụng WGL để kết xuất và Direct3D 9Ex để trình bày.
Chỉ hoạt động trên Nvidia và AMD.

x11 X11 / GLX

con đường
Wayland / EGL

drm-egl
DRM / EGL

x11egl X11 / EGL

es =
Chọn có sử dụng GLES hay không:

Vâng Cố gắng thích ES hơn Desktop GL

Không Cố gắng thích GL trên máy tính để bàn hơn ES

tự động Sử dụng mặc định cho mỗi chương trình phụ trợ (mặc định)

fbo-format =
Chọn định dạng nội bộ của kết cấu được sử dụng cho FBO. Định dạng có thể
ảnh hưởng đến hiệu suất và chất lượng của video đầu ra. fmt có thể là một trong số:
rgb, rgba, rgb8, rgb10, rgb10_a2, rgb16, rgb16f, rgb32f, rgba12, rgba16,
rgba16f, rgba32f. Mặc định: tự động, ánh xạ tới rgba16 trên GL máy tính để bàn, và
rgb10_a2 trên GLES (ví dụ: ANGLE).

gamma = <0.1..2.0>
Đặt giá trị gamma (mặc định: 1.0). Nếu gamma được điều chỉnh theo những cách khác (như
với --gamma tùy chọn hoặc ràng buộc chính và gamma tài sản), giá trị
được nhân với giá trị gamma khác.

Các giá trị được đề xuất dựa trên độ sáng của môi trường:

1.0 Chiếu sáng rực rỡ (mặc định)

0.9 Hơi mờ

0.8 Pitch phòng đen

gamma-tự động
Tự động sửa giá trị gamma tùy thuộc vào ánh sáng xung quanh
điều kiện (thêm gamma tăng cho phòng tối).

Với độ rọi xung quanh là 64lux, mpv sẽ chọn giá trị 1.0 gamma (không
tăng), và tăng nhẹ mức tăng lên đến 0.8 cho 16lux.

LƯU Ý: Chỉ được triển khai trên OS X.

target-prim =
Chỉ định các bầu chọn chính của màn hình. Màu video sẽ được điều chỉnh để phù hợp với điều này
không gian màu nếu cần thiết. Giá trị hợp lệ là:

tự động Tắt mọi điều chỉnh (mặc định)

bt.470m
ITU-R BT.470 M

bt.601-525
ITU-R BT.601 (hệ thống SD 525 dòng, ví dụ: NTSC), SMPTE 170M / 240M

bt.601-625
ITU-R BT.601 (hệ thống SD 625 dòng, ví dụ: PAL / SECAM), ITU-R BT.470 B / G

bt.709 ITU-R BT.709 (HD), IEC 61966-2-4 (sRGB), SMPTE RP177 Phụ lục B

bt.2020
ITU-R BT.2020 (UHD)

táo táo RGB

adobe AdobeRGB (1998)

tiên tri
ProPhoto RGB (ROMM)

cie1931
CIE 1931 RGB (đừng nhầm với CIE XYZ)

target-trc =
Chỉ định các đặc tính truyền (gamma) của màn hình. Màu video
sẽ được điều chỉnh theo đường cong này. Giá trị hợp lệ là:

tự động Tắt mọi điều chỉnh (mặc định)

bt.1886
Đường cong ITU-R BT.1886, không giảm độ sáng (khoảng 1.961)

srgb IEC 61966-2-4 (sRGB)

tuyến tính Đầu ra ánh sáng tuyến tính

gamma1.8
Đường cong công suất thuần túy (gamma 1.8), cũng được sử dụng cho Apple RGB

gamma2.2
Đường cong công suất thuần túy (gamma 2.2)

gamma2.8
Đường cong công suất thuần túy (gamma 2.8), cũng được sử dụng cho BT.470-BG

tiên tri
ProPhoto RGB (ROMM)

icc-profile =
Tải cấu hình ICC và sử dụng nó để chuyển đổi RGB tuyến tính thành đầu ra màn hình.
Cần hỗ trợ LittleCMS 2 được biên dịch trong. Tùy chọn này ghi đè
mục tiêu-prim, mục tiêu-trc và icc-hồ sơ-tự động tùy chọn.

icc-hồ sơ-tự động
Tự động chọn cấu hình hiển thị ICC hiện được chỉ định bởi
cài đặt hiển thị của hệ điều hành.

LƯU Ý: Trên Windows, cấu hình mặc định phải là cấu hình ICC. Hồ sơ WCS
không được hỗ trợ.

icc-cache-dir =
Lưu trữ và tải 3D LUT được tạo từ hồ sơ ICC trong thư mục này.
Điều này có thể được sử dụng để tăng tốc độ tải, vì LittleCMS 2 có thể mất một lúc để
tạo 3D LUT. Lưu ý rằng các tệp này chứa các LUT không nén. Của chúng
kích thước phụ thuộc vào Kích thước 3dlut, và có thể rất lớn.

LƯU Ý: Thao tác này không được làm sạch tự động, vì vậy các tệp bộ đệm cũ, không sử dụng có thể
gắn bó vô định.

icc-Ý định =
Chỉ định mục đích ICC được sử dụng để chuyển đổi màu (khi sử dụng
hồ sơ icc).

0 tri giác

1 đo màu tương đối (mặc định)

2 bão hòa

3 đo màu tuyệt đối

3dlut-size = x x
Kích thước của 3D LUT được tạo từ hồ sơ ICC theo từng chiều.
Mặc định là 128x256x64. Kích thước phải là lũy thừa của hai và tối đa là 512.

pha trộn phụ đề =
Trộn phụ đề trực tiếp vào khung video được nâng cấp, trước khi nội suy
và / hoặc quản lý màu (mặc định: không). Bật điều này sẽ làm cho phụ đề
bị ảnh hưởng bởi hồ sơ icc, mục tiêu-prim, mục tiêu-trc, phép nội suy, gamma và
hậu kỳ. Nó cũng tăng hiệu suất phụ đề khi sử dụng
phép nội suy.

Nhược điểm của việc kích hoạt điều này là nó hạn chế phụ đề ở mức hiển thị
phần của video, vì vậy bạn không thể có phụ đề ở lề đen
bên dưới video (ví dụ).

If video được chọn, hành vi tương tự như Vâng, nhưng người đăng ký được thu hút tại
độ phân giải gốc của video và được chia tỷ lệ cùng với video.

Chú ý:
Điều này thay đổi cách xử lý màu sắc của phụ đề. Thông thường, phụ đề
màu sắc được giả định là sRGB và màu được quản lý như vậy. Kích hoạt điều này
thay vào đó, chúng được coi như đang ở trong không gian màu của video. Đây là
tốt nếu bạn muốn những thứ như dấu hiệu ASS có đệm lót phù hợp với video
màu sắc, nhưng có thể khiến phụ đề SRT hoặc phụ đề tương tự trông hơi lệch.

alpha =
Quyết định việc cần làm nếu đầu vào có thành phần alpha (mặc định: pha trộn).

pha trộn Trộn khung trên nền đen.

Vâng Cố gắng tạo bộ đệm khung với thành phần alpha. Điều này chỉ làm cho
cảm nhận nếu video chứa thông tin alpha (cực kỳ
quý hiếm). Có thể không được hỗ trợ trên tất cả các nền tảng. Nếu bộ đệm khung alpha
không khả dụng, nó âm thầm rơi trở lại bộ đệm khung bình thường. Ghi chú
điều đó nếu bạn đặt định dạng fbo tùy chọn cho một giá trị không mặc định,
định dạng với alpha phải được chỉ định, nếu không điều này sẽ không hoạt động.

Không Bỏ qua thành phần alpha.

hình chữ nhật-kết cấu
Buộc sử dụng các kết cấu hình chữ nhật (mặc định: không). Bình thường điều này không nên có
bất kỳ lợi thế nào so với kết cấu bình thường. Lưu ý rằng phần cứng giải mã ghi đè
cờ này.

nền =
Màu được sử dụng để vẽ các phần của cửa sổ mpv không có trong video. Nhìn thấy
--osd-màu tùy chọn cách xác định màu sắc.

opengl-hq
Giống như OpenGL, nhưng với cài đặt mặc định để hiển thị chất lượng cao.

Điều này tương đương với:

--vo = opengl: scale = spline36: cscale = spline36: dscale = mitchell: dither-depth = auto: correct-downcaling: sigmoid-upscaling: pbo: deband: es = no

Lưu ý rằng một số màn hình LCD rẻ hơn có phối màu gây nhiễu nặng OpenGL's
phối màu. Tắt phối màu với dither-depth = không giúp.

sđl SDL 2.0+ Render trình điều khiển đầu ra video, tùy thuộc vào hệ thống có hoặc không có phần cứng
sự tăng tốc. Nên hoạt động trên tất cả các nền tảng được hỗ trợ bởi SDL 2.0. Để điều chỉnh, hãy tham khảo
tới bản sao của tệp SDL_hint.h.

LƯU Ý:
Trình điều khiển này là để tương thích với các hệ thống không cung cấp đồ họa thích hợp
trình điều khiển hoặc chỉ hỗ trợ GLES.

sw Tiếp tục ngay cả khi phát hiện thấy trình kết xuất phần mềm.

chế độ chuyển đổi
Hướng dẫn SDL chuyển chế độ video màn hình khi chuyển sang chế độ toàn màn hình.

vaapi Trình điều khiển đầu ra video Intel VA API với hỗ trợ giải mã phần cứng. Lưu ý rằng
hoàn toàn không có lý do gì để sử dụng cái này, ngoài việc muốn sử dụng phần cứng
giải mã để tiết kiệm năng lượng trên máy tính xách tay hoặc có thể ngăn video bị xé hình với một số
thiết lập.

LƯU Ý:
Trình điều khiển này là để tương thích với các hệ thống tồi tệ. Bạn có thể sử dụng phần cứng vaapi
giải mã với --vo = opengl quá.

mở rộng quy mô =

mặc định
Trình điều khiển mặc định (mặc định mpv cũng vậy).

Rychle Nhanh chóng, nhưng chất lượng thấp.

hq Tốc độ chậm, phụ thuộc vào trình điều khiển không xác định phụ thuộc vào trình điều khiển chất lượng cao.

không phi tuyến tính biến hình mở rộng quy mô

deint-mode =
Chọn thuật toán khử xen kẽ. Lưu ý rằng theo mặc định, hủy xen kẽ là
ban đầu luôn tắt và cần được bật với d key (phím mặc định
ràng buộc cho chu kỳ khử xen kẽ).

Tùy chọn này không áp dụng nếu libva hỗ trợ xử lý bài đăng video (vpp). Trong
trường hợp này, mặc định cho chế độ deint is Khôngvà cho phép khử xen kẽ qua
tương tác của người dùng bằng cách sử dụng các phương pháp được đề cập ở trên thực sự chèn
vavpp bộ lọc video. Nếu vpp thực sự không được hỗ trợ với chương trình phụ trợ libva
khi sử dụng, bạn có thể sử dụng tùy chọn này để bật tính năng khử xen kẽ dựa trên VO.

Không Không cho phép hủy xen kẽ (mặc định cho libva mới hơn).

lĩnh vực đầu tiên
Chỉ hiển thị trường đầu tiên (đi qua - thống trị trường).

ngũ cốc bob deinterlacing (mặc định cho libva cũ hơn).

scaled-osd =
Nếu được bật, OSD sẽ được hiển thị ở độ phân giải video và được chia tỷ lệ thành
độ phân giải màn hình. Theo mặc định, điều này bị tắt và OSD được hiển thị tại
độ phân giải hiển thị nếu trình điều khiển hỗ trợ nó.

vô giá trị Không tạo ra đầu ra video. Hữu ích cho việc đo điểm chuẩn.

Thông thường, tốt hơn là tắt video bằng - không có video thay thế.

fps =
Mô phỏng FPS hiển thị. Điều này giới hạn một cách giả tạo số lượng khung hình VO
chấp nhận mỗi giây.

caca Trình điều khiển đầu ra video nghệ thuật ASCII màu hoạt động trên bảng điều khiển văn bản.

LƯU Ý:
Người lái xe này là một trò đùa.

hình ảnh Xuất từng khung hình thành tệp hình ảnh trong thư mục hiện tại. Mỗi tệp có
số khung được đệm bằng các số XNUMX ở đầu làm tên.

định dạng =
Chọn định dạng tệp hình ảnh.

jpg Tệp JPEG, đuôi .jpg. (Mặc định.)

jpeg Tệp JPEG, đuôi .jpeg.

png Tệp PNG.

ppm Định dạng bitmap di động.

pgm Định dạng bản đồ di động.

pgmyuv Định dạng bản đồ di động, sử dụng định dạng pixel YV12.

tga Truevision TGA.

png-nén = <0-9>
Hệ số nén PNG (sự cân bằng giữa tốc độ và kích thước tệp) (mặc định: 7)

png-filter = <0-5>
Bộ lọc được áp dụng trước khi nén PNG (0 = none; 1 = sub; 2 = up; 3 =
trung bình; 4 = Paeth; 5 = hỗn hợp) (mặc định: 5)

jpeg-quality = <0-100>
Yếu tố chất lượng JPEG (mặc định: 90)

(không-) jpeg-progressive
Chỉ định JPEG tiêu chuẩn hoặc liên tục (mặc định: không).

(không-) jpeg-baseline
Chỉ định sử dụng đường cơ sở JPEG hay không (mặc định: có).

jpeg-tối ưu hóa = <0-100>
Yếu tố tối ưu hóa JPEG (mặc định: 100)

jpeg-Smooth = <0-100>
yếu tố mượt mà (mặc định: 0)

jpeg-dpi = <1->
JPEG DPI (mặc định: 72)

chịu thua kém =
Chỉ định thư mục để lưu các tệp hình ảnh vào (mặc định: ./).

con đường (Vùng đất chỉ)
Wayland chia sẻ đầu ra video bộ nhớ dưới dạng dự phòng cho OpenGL.

LƯU Ý:
Trình điều khiển này là để tương thích với các hệ thống không cung cấp OpenGL hoạt động
trình điều khiển.

alpha Sử dụng định dạng bộ đệm hỗ trợ video và hình ảnh với thông tin alpha

rgb565 Sử dụng RGB565 làm định dạng bộ đệm. Định dạng này được triển khai trên hầu hết các nền tảng,
đặc biệt là được nhúng, nơi nó hiệu quả hơn nhiều so với RGB8888.

bộ đệm ba
Sử dụng 3 bộ đệm thay vì 2. Điều này có thể dẫn đến phát lại trôi chảy hơn, nhưng sử dụng
nhiều bộ nhớ hơn.

opengl-cb
Để sử dụng với nhúng OpenGL trực tiếp của libmpv; vô dụng trong bất kỳ bối cảnh nào khác. (Nhìn thấy
.)

Điều này cũng hỗ trợ nhiều tiểu mục OpenGL VO có. Chạy mpv
--vo = opengl-cb: trợ giúp cho một danh sách.

Điều này cũng hỗ trợ vo_cmdline chỉ huy.

rpi (Dâu rừng Số Pi)
Đầu ra video gốc trên Raspberry Pi bằng API MMAL.

hiển thị =
Chọn số hiển thị mà lớp phủ video sẽ được hiển thị
(mặc định: 0).

lớp =
Chọn lớp dispmanx mà lớp phủ video sẽ được hiển thị
(mặc định: -10). Lưu ý rằng mpv cũng sẽ sử dụng 2 lớp phía trên phần đã chọn
để xử lý nền cửa sổ và OSD. Kết xuất video thực tế sẽ
xảy ra trên lớp phía trên lớp đã chọn.

nền =
Có hiển thị nền đen phía sau video hay không (mặc định: không).
Thông thường, tốt hơn là nên giết bộ đệm khung của bảng điều khiển để thay thế, điều này mang lại
hiệu suất tốt hơn.

osd =
Được bật theo mặc định. Nếu bị vô hiệu hóa với Không, không có lớp OSD nào được tạo. Điều này cũng
có nghĩa là sẽ không có phụ đề được hiển thị.

drm (Thẳng thắn Rendering manager)
Trình điều khiển đầu ra video bằng Cài đặt chế độ hạt nhân / Trình quản lý kết xuất trực tiếp. Nên
được sử dụng khi một người không muốn cài đặt môi trường đồ họa toàn diện (ví dụ: không
X). Không hỗ trợ tăng tốc phần cứng (nếu bạn cần điều này, hãy kiểm tra drm-egl
phụ trợ cho OpenGL VŨ).

đầu nối =
Chọn đầu nối để sử dụng (thường đây là màn hình.) Nếu được đặt thành -1, mpv
hiển thị đầu ra trên đầu nối khả dụng đầu tiên. (mặc định: -1)

devpath =
Đường dẫn đến thiết bị thẻ đồ họa. (mặc định: / dev / dri / card0)

mode =
ID chế độ để sử dụng (độ phân giải, độ sâu bit và tốc độ khung hình). (mặc định: 0)

AUDIO LỌC

Bộ lọc âm thanh cho phép bạn sửa đổi luồng âm thanh và các thuộc tính của nó. Cú pháp là:

--af =
Thiết lập một chuỗi các bộ lọc âm thanh.

LƯU Ý:
Để có danh sách đầy đủ các bộ lọc âm thanh có sẵn, hãy xem --af = trợ giúp.

Ngoài ra, hãy nhớ rằng hầu hết các bộ lọc thực tế đều có sẵn thông qua lavfi trình bao bọc, mà
cung cấp cho bạn quyền truy cập vào hầu hết các bộ lọc của libavfilter. Điều này bao gồm tất cả các bộ lọc có
đã được chuyển từ MPlayer sang libavfilter.

Bạn cũng có thể đặt giá trị mặc định cho từng bộ lọc. Các giá trị mặc định được áp dụng trước giá trị bình thường
thông số bộ lọc.

--af-defaults =
Đặt giá trị mặc định cho mỗi bộ lọc.

Bộ lọc âm thanh được quản lý trong danh sách. Có một số lệnh để quản lý danh sách bộ lọc:

--af-add =
Thêm các bộ lọc đã cho dưới dạng đối số vào danh sách bộ lọc.

--af-pre =
Thêm các bộ lọc được cung cấp làm đối số cho danh sách bộ lọc.

--af-del =
Xóa các bộ lọc tại các chỉ mục nhất định. Số chỉ mục bắt đầu từ 0, âm
số địa chỉ cuối danh sách (-1 là số cuối cùng).

--af-clr
Hoàn toàn trống danh sách bộ lọc.

Các bộ lọc có sẵn là:

lavrresample [= option1: option2: ...]
Bộ lọc này sử dụng libavresample (hoặc libswresample, tùy thuộc vào bản dựng) để thay đổi
tốc độ mẫu, định dạng mẫu hoặc bố cục kênh của luồng âm thanh. Bộ lọc này là
tự động bật nếu đầu ra âm thanh không hỗ trợ cấu hình âm thanh
của tệp đang được phát.

Nó chỉ hỗ trợ các định dạng mẫu sau: u8, s16, s32, float.

filter-size =
Chiều dài của bộ lọc đối với tốc độ lấy mẫu thấp hơn. (mặc định: 16)

dịch pha =
Nhật ký 2 của số lượng mục nhập nhiều pha. (..., 10-> 1024, 11-> 2048, 12-> 4096,
...) (mặc định: 10-> 1024)

cutoff =
Tần số ngắt (0.0-1.0), đặt mặc định tùy thuộc vào độ dài bộ lọc.

tuyến tính Nếu được đặt thì các bộ lọc sẽ được nội suy tuyến tính giữa các mục nhập nhiều pha.
(mặc định: không)

không tách rời
Không tách ra nếu định dạng / tốc độ / kênh âm thanh đầu vào và đầu ra khớp với nhau. (Nếu bạn
chỉ muốn đặt mặc định cho bộ lọc này sẽ được sử dụng ngay cả bởi
các trường hợp lavrresample được chèn tự động, bạn nên thích cài đặt hơn
họ với --af-defaults = lavrresample: ....)

bình thường hóa =
Có chuẩn hóa hay không khi phối lại bố cục kênh (mặc định: có). Đây là
Ví dụ: áp dụng khi trộn âm thanh vòm thành âm thanh nổi. Ưu điểm là vậy
điều này đảm bảo rằng không có sự cắt xén nào có thể xảy ra. Thật không may, điều này cũng có thể
dẫn đến mức âm lượng quá thấp. Cho dù bạn bật hay tắt điều này là
về cơ bản là vấn đề về khẩu vị, nhưng mặc định sử dụng sự lựa chọn an toàn hơn.

o =
Đặt AVOptions trên SwrContext hoặc AVAudioResampleContext. Đây phải là
được tài liệu bởi FFmpeg hoặc Libav.

lavcac3enc [= tospdif [: bitrate [: minch]]]
Mã hóa âm thanh đa kênh sang AC-3 trong thời gian chạy bằng libavcodec. Hỗ trợ 16-bit
định dạng đầu vào gốc-endian, tối đa 6 kênh. Đầu ra là big-endian khi
xuất ra luồng AC-3 thô, gốc-endian khi xuất ra S / PDIF. Nếu đầu vào
Tốc độ mẫu không phải là 48 kHz, 44.1 kHz hoặc 32 kHz, nó sẽ được lấy mẫu lại thành 48 kHz.

tospdif =
Xuất dòng AC-3 thô nếu Không, xuất ra S / PDIF để chuyển qua nếu Vâng
(mặc định).

tốc độ bit =
Việc sử dụng tốc độ bit cho luồng AC-3. Đặt nó thành 384 để nhận được 384 kbps.

Giá trị mặc định là 640. Một số bộ thu có thể không xử lý được điều này.

Giá trị hợp lệ: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320,
384, 448, 512, 576, 640.

Giá trị đặc biệt tự động chọn tốc độ bit mặc định dựa trên kênh đầu vào
con số:

1ch 96

2ch 192

3ch 224

4ch 384

5ch 448

6ch 448

minch =
Nếu số kênh đầu vào nhỏ hơn , bộ lọc sẽ tách ra
chính nó (mặc định: 3).

bộ cân bằng = g1: g2: g3: ...: g10
Bộ cân bằng đồ họa băng tần 10 quãng tám, được triển khai bằng cách sử dụng 10 bộ lọc băng thông IIR. Đây
có nghĩa là nó hoạt động bất kể loại âm thanh nào đang được phát lại. Các
tần số trung tâm của 10 dải là:

┌────┬─────────────┐
│Không. │ tần số │
├────┼─────────────┤
│0 │ 31.25 Hz │
├────┼─────────────┤
│1 │ 62.50 Hz │
├────┼─────────────┤
│2 │ 125.00 Hz │
├────┼─────────────┤
│3 │ 250.00 Hz │
├────┼─────────────┤
│4 │ 500.00 Hz │
├────┼─────────────┤
│5 │ 1.00 kHz │
├────┼─────────────┤
│6 │ 2.00 kHz │
├────┼─────────────┤
│7 │ 4.00 kHz │
├────┼─────────────┤
│8 │ 8.00 kHz │
├────┼─────────────┤
│9 │ 16.00 kHz │
└────┴─────────────┘

Nếu tốc độ mẫu của âm thanh đang được phát thấp hơn tần số trung tâm cho
một băng tần, thì băng tần đó sẽ bị vô hiệu hóa. Một lỗi đã biết với bộ lọc này là
rằng các đặc tính của dải trên cùng không hoàn toàn đối xứng nếu
tốc độ lấy mẫu gần với tần số trung tâm của dải tần đó. Vấn đề này có thể được
đã làm việc xung quanh bằng cách lấy mẫu âm thanh bằng cách sử dụng bộ lọc lấy mẫu lại trước khi nó đạt đến
bộ lọc này.

: : : ...:
số dấu phẩy động đại diện cho mức tăng được tính bằng dB cho mỗi dải tần số
(-12-12)

Ví dụ

mpv --af=equalizer=11:11:10:5:0:-12:0:5:12:12 phương tiện truyền thông.avi
Sẽ khuếch đại âm thanh ở vùng tần số trên và dưới trong khi
triệt tiêu nó gần như hoàn toàn xung quanh 1 kHz.

kênh = nch [: tuyến đường]
Có thể được sử dụng để thêm, xóa, định tuyến và sao chép các kênh âm thanh. giá như
được đưa ra, định tuyến mặc định được sử dụng. Nó hoạt động như sau: Nếu số lượng đầu ra
kênh lớn hơn số kênh đầu vào, các kênh trống sẽ được chèn
(ngoại trừ khi trộn từ đơn âm sang âm thanh nổi; khi đó kênh đơn âm được nhân đôi). Nếu
số lượng kênh đầu ra ít hơn số lượng kênh đầu vào,
các kênh vượt quá bị cắt bớt.

số kênh đầu ra (1-8)


Danh sách của , các tuyến đường riêng biệt, dưới dạng from1-to1, from2-to2, .... Từng cặp
xác định nơi định tuyến mỗi kênh. Có thể có nhiều nhất 8 tuyến đường. Không có
đối số này, định tuyến mặc định được sử dụng. Từ , cũng được dùng để ngăn cách
bộ lọc, bạn phải trích dẫn đối số này với [...] hoặc tương tự.

Các ví dụ

mpv --af=channels=4:[0-1,1-0,2-2,3-3] phương tiện truyền thông.avi
Sẽ thay đổi số lượng kênh thành 4 và thiết lập 4 tuyến đường hoán đổi
kênh 0 và kênh 1 và để nguyên kênh 2 và 3. Quan sát điều đó
nếu phương tiện có chứa hai kênh được phát lại, các kênh 2 và 3 sẽ
chứa im lặng nhưng 0 và 1 sẽ vẫn được hoán đổi.

mpv --af=channels=6:[0-0,0-1,0-2,0-3] phương tiện truyền thông.avi
Sẽ thay đổi số kênh thành 6 và thiết lập 4 tuyến sao chép
kênh 0 đến các kênh 0 đến 3. Kênh 4 và 5 sẽ chứa khoảng lặng.

LƯU Ý:
Bạn có thể không nên sử dụng bộ lọc này. Nếu bạn muốn thay đổi đầu ra
bố cục kênh, hãy thử định dạng bộ lọc, có thể làm cho mpv tự động thiết lập- và
bố cục kênh tiêu chuẩn downmix.

format = format: srate: channel: out-format: out-srate: out-channel
Không thực hiện bất kỳ chuyển đổi định dạng nào. Thay vào đó, nó có thể khiến hệ thống lọc
chèn các bộ lọc chuyển đổi cần thiết trước hoặc sau bộ lọc này nếu cần. Nó là
chủ yếu hữu ích để kiểm soát định dạng âm thanh đi vào các bộ lọc khác. Đến
chỉ định định dạng cho đầu ra âm thanh, xem --định dạng âm thanh, --audio-lấy mẫuvà
- kênh âm thanh. Bộ lọc này có thể buộc một định dạng cụ thể, trong khi
--audio- * có thể bị ao ghi đè dựa trên khả năng tương thích đầu ra.

Tất cả các thông số là tùy chọn. 3 tham số đầu tiên hạn chế những gì bộ lọc
chấp nhận làm đầu vào. Do đó, chúng sẽ khiến các bộ lọc chuyển đổi được chèn vào
trước cái này. Các ngoài- các tham số cho các bộ lọc hoặc đầu ra âm thanh theo sau
bộ lọc này cách diễn giải dữ liệu mà không thực sự thực hiện chuyển đổi. Cài đặt
những thứ này có thể sẽ chỉ phá vỡ mọi thứ trừ khi bạn thực sự biết rằng bạn muốn điều này cho một số
lý do, chẳng hạn như thử nghiệm hoặc xử lý phương tiện bị hỏng.


Buộc chuyển đổi sang định dạng này. Sử dụng --af = format = format = help để có được một danh sách
định dạng hợp lệ.


Buộc chuyển đổi thành một tỷ lệ mẫu cụ thể. Tỷ lệ là một số nguyên, 48000
ví dụ.


Buộc trộn vào một bố cục kênh cụ thể. Nhìn thấy - kênh âm thanh tùy chọn cho
những giá trị khả thi.







LƯU Ý: bộ lọc này từng được đặt tên lực lượng. Người già định dạng bộ lọc được sử dụng để làm
chuyển đổi chính nó, không giống như chuyển đổi này cho phép hệ thống lọc xử lý
sự chuyển đổi.

khối lượng [= [: ...]]
Thực hiện kiểm soát âm lượng phần mềm. Sử dụng bộ lọc này một cách thận trọng vì nó có thể
giảm tỷ lệ tín hiệu trên nhiễu của âm thanh. Trong hầu hết các trường hợp, tốt nhất là sử dụng
Bậc thầy điều khiển âm lượng của card âm thanh hoặc núm âm lượng trên bộ khuếch đại của bạn.

LƯU Ý: Bộ lọc này không được sử dụng lại và do đó chỉ có thể được bật một lần cho mỗi
luồng âm thanh.


Đặt mức tăng mong muốn tính bằng dB cho tất cả các kênh trong luồng từ -200 dB đến
+60 dB, trong đó -200 dB tắt tiếng hoàn toàn và +60 dB bằng mức tăng của
1000 (mặc định: 0).

phát lại theo dõi
Điều chỉnh tăng âm lượng theo giá trị tăng lại theo dõi-khuếch đại được lưu trữ trong
siêu dữ liệu tệp.

album phát lại
Giống như replaygain-track nhưng thay vào đó sử dụng giá trị album-gain.

replaygain-preamp
Độ lợi tiền khuếch đại tính bằng dB để áp dụng cho độ lợi khuếch đại phát lại đã chọn
(mặc định: 0).

replaygain-clip = yes | no
Ngăn chặn sự cắt xén do độ lợi phát lại bằng cách tự động giảm độ lợi
(mặc định). Sử dụng replaygain-clip = không để vô hiệu hóa điều này.

replaygain-dự phòng
Tăng theo dB để áp dụng nếu tệp không có thẻ tăng phát lại. Tùy chọn này là
luôn được áp dụng nếu logic replaygain bằng cách nào đó không hoạt động. Nêu Đây la
được áp dụng, không có tùy chọn phát lại nào khác được áp dụng.

kẹp mềm
Bật tính năng cắt mềm. Cắt mềm có thể làm cho âm thanh mượt mà hơn nếu rất
mức âm lượng cao được sử dụng. Bật tùy chọn này nếu phạm vi động của
loa rất thấp.

CẢNH BÁO: Tính năng này tạo ra sự biến dạng và nên được coi là cuối cùng
phương sách.

s16 Buộc định dạng mẫu S16 nếu được đặt. Chất lượng thấp hơn, nhưng có thể nhanh hơn ở một số
tình huống.

tách ra Xóa bộ lọc nếu âm lượng không được thay đổi tại thời điểm cấu hình bộ lọc âm thanh.
Hữu ích với replaygain: nếu tệp hiện tại không có thẻ replaygain, thì
bộ lọc sẽ bị xóa nếu tùy chọn này được bật. (Nếu --softvol = vâng được sử dụng
và các điều khiển âm lượng của trình phát được sử dụng trong khi phát lại, một âm lượng khác
bộ lọc sẽ được chèn.)

Ví dụ

mpv --af = volume = 10.1 phương tiện truyền thông.avi
Sẽ khuếch đại âm thanh thêm 10.1 dB và clip cứng nếu mức âm thanh
quá cao.

pan = n: [ ]
Trộn các kênh tùy ý. Về cơ bản là sự kết hợp giữa âm lượng và các kênh
bộ lọc có thể được sử dụng để trộn nhiều kênh xuống chỉ còn một số kênh, ví dụ: âm thanh nổi thành
mono hoặc thay đổi "chiều rộng" của loa trung tâm trong hệ thống âm thanh vòm. Đây
khó sử dụng bộ lọc và sẽ yêu cầu mày mò trước khi cho ra kết quả mong muốn
thu được. Số lượng tùy chọn cho bộ lọc này phụ thuộc vào số lượng đầu ra
kênh truyền hình. Ví dụ về cách trộn tệp sáu kênh xuống hai kênh với tệp này
bộ lọc có thể được tìm thấy trong phần ví dụ gần cuối.

Số kênh đầu ra (1-8).


Một danh sách các giá trị [L00,L01,L02,...,L10,L11,L12,...,Ln0,Ln1,Ln2,...], Nơi
mỗi phần tử Lij có nghĩa là có bao nhiêu kênh đầu vào i được trộn vào đầu ra
kênh j (phạm vi 0-1). Vì vậy, về nguyên tắc, đầu tiên bạn có n số nói lên điều gì
thực hiện với kênh đầu vào đầu tiên, sau đó n số hoạt động trên kênh thứ hai
kênh đầu vào, v.v. Nếu bạn không chỉ định bất kỳ số nào cho một số đầu vào
kênh, 0 được giả định. Lưu ý rằng các giá trị được phân tách bằng ,, Đó là
đã được trình phân tích cú pháp tùy chọn sử dụng để tách các bộ lọc. Đây là lý do tại sao bạn phải
trích dẫn danh sách giá trị với [...] hoặc tương tự.

Các ví dụ

mpv --af = pan = 1: [0.5,0.5] phương tiện truyền thông.avi
Sẽ giảm âm lượng từ âm thanh nổi thành đơn âm.

mpv --af = pan = 3: [1,0,0.5,0,1,0.5] phương tiện truyền thông.avi
Sẽ cung cấp đầu ra 3 kênh, giữ nguyên các kênh 0 và 1 và trộn
kênh 0 và 1 vào kênh đầu ra 2 (có thể được gửi đến
loa siêu trầm chẳng hạn).

LƯU Ý:
Nếu bạn chỉ muốn buộc phối lại theo một bố cục kênh đầu ra nhất định, thì
dễ dàng hơn để sử dụng định dạng lọc. Ví dụ, mpv '--af = format = channel = 5.1'
'--audio-channel = 5.1' sẽ luôn buộc phối lại âm thanh thành 5.1 và xuất ra
như thế này.

trì hoãn [= [ch1, ch2, ...]]
Trì hoãn âm thanh đến loa để âm thanh từ các loa khác
các kênh đến vị trí nghe đồng thời. Nó chỉ hữu ích nếu bạn
có nhiều hơn 2 loa.

[ch1, ch2, ...]
Độ trễ tính bằng mili giây sẽ được áp dụng cho mỗi kênh (dấu phẩy động
số từ 0 đến 1000).

Để tính toán độ trễ cần thiết cho các kênh khác nhau, hãy làm như sau:

1. Đo khoảng cách đến loa tính bằng mét liên quan đến khả năng nghe của bạn
vị trí, cho bạn khoảng cách s1 đến s5 (đối với hệ thống 5.1). Không có
điểm bù cho loa siêu trầm (bạn sẽ không nghe thấy sự khác biệt
dù sao).

2. Lấy khoảng cách lớn nhất trừ khoảng cách s1 đến s5, tức là s [i] = tối đa -
s [i]; i = 1 ... 5.

3. Tính toán độ trễ cần thiết theo mili giây như d [i] = 1000 * s [i] / 342; i = 1 ... 5.

Ví dụ

mpv --af = delay = [10.5,10.5,0,0,7,0] phương tiện truyền thông.avi
Sẽ trì hoãn phía trước bên trái và bên phải 10.5 ms, hai kênh phía sau và
loa siêu trầm 0 ms và kênh trung tâm 7 ms.

drc [= method: target]
Áp dụng tính năng nén dải động. Điều này tối đa hóa âm lượng bằng cách nén
dải động của tín hiệu âm thanh. (Trước đây được gọi là định mức thể tích.)


Đặt phương thức đã sử dụng.

1 Sử dụng một mẫu duy nhất để làm mượt các biến thể thông qua tiêu chuẩn
trung bình có trọng số so với các mẫu trước đây (mặc định).

2 Sử dụng một số mẫu để làm mượt các biến thể thông qua tiêu chuẩn
trung bình có trọng số so với các mẫu trong quá khứ.


Đặt biên độ mục tiêu dưới dạng một phần nhỏ của mức tối đa cho loại mẫu
(mặc định: 0.25).

LƯU Ý:
Bộ lọc này có thể gây ra biến dạng với các tín hiệu âm thanh có
phạm vi động.

scaletempo [= option1: option2: ...]
Cân nhịp độ âm thanh mà không làm thay đổi cao độ, được đồng bộ hóa tùy chọn với tốc độ phát lại
(mặc định).

Điều này hoạt động bằng cách phát "sải chân" mili giây âm thanh ở tốc độ bình thường sau đó tiêu thụ
'sải bước * scale' ms của âm thanh đầu vào. Nó kết hợp các bước tiến với nhau bằng cách pha trộn
'chồng chéo'% sải chân với âm thanh sau sải bước trước đó. Nó tùy ý
thực hiện một phân tích thống kê ngắn trên ms âm thanh 'tìm kiếm' tiếp theo để xác định
vị trí chồng chéo tốt nhất.

quy mô =
Số lượng danh nghĩa để mở rộng nhịp độ. Cân số lượng này ngoài tốc độ.
(mặc định: 1.0)

sải bước =
Độ dài tính bằng mili giây để xuất ra mỗi sải chân. Giá trị quá cao sẽ gây ra
bỏ qua đáng chú ý ở mức quy mô cao và tiếng vọng ở mức quy mô thấp.
Giá trị rất thấp sẽ làm thay đổi cao độ. Tăng cường cải thiện hiệu suất. (mặc định:
60)

chồng chéo lên nhau =
Tỷ lệ sải chân trùng nhau. Giảm dần cải thiện hiệu suất. (mặc định:
.20)

tìm kiếm =
Độ dài tính bằng mili giây để tìm kiếm vị trí chồng chéo tốt nhất. Đang giảm dần
cải thiện hiệu suất rất nhiều. Trên các hệ thống chậm, có thể bạn sẽ muốn đặt
điều này rất thấp. (mặc định: 14)

tốc độ =
Đặt phản hồi để thay đổi tốc độ.

tiến độ Quy mô tiến độ đồng bộ với tốc độ (mặc định).

sân Đảo ngược tác dụng của bộ lọc. Thang điểm mà không làm thay đổi nhịp độ. cộng
cái này cho bạn đầu vào.conf theo từng bước bán âm:

[nhân tốc độ 0.9438743126816935
] nhân tốc độ 1.059463094352953

Chú ý:
Mất đồng bộ hóa với video.

cả hai Quy mô cả nhịp độ và cao độ.

không ai Bỏ qua sự thay đổi tốc độ.

Các ví dụ

mpv --af = scaletempo --speed = 1.2 phương tiện truyền thông.ogg
Sẽ phát phương tiện ở tốc độ 1.2 lần bình thường với âm thanh ở cao độ bình thường.
Thay đổi tốc độ phát lại sẽ thay đổi nhịp độ âm thanh để phù hợp.

mpv --af = scaletempo = scale = 1.2: speed = none --speed = 1.2 phương tiện truyền thông.ogg
Sẽ phát phương tiện ở tốc độ 1.2 lần bình thường, với âm thanh ở cường độ bình thường, nhưng
thay đổi tốc độ phát lại sẽ không ảnh hưởng đến nhịp độ âm thanh.

mpv --af = scaletempo = stride = 30: trùng lặp = .50: tìm kiếm = 10 phương tiện truyền thông.ogg
Sẽ điều chỉnh các thông số chất lượng và hiệu suất.

mpv --af = format = float, scaletempo phương tiện truyền thông.ogg
Làm cho scaletempo sử dụng mã float. Có thể nhanh hơn trên một số nền tảng.

mpv --af = scaletempo = scale = 1.2: speed = pitch âm thanh.ogg
Sẽ phát phương tiện ở tốc độ 1.2 lần bình thường với âm thanh ở cao độ bình thường.
Thay đổi tốc độ phát lại sẽ thay đổi cao độ, để lại nhịp độ âm thanh ở mức 1.2 lần.

dây cao su
Hiệu chỉnh cao độ chất lượng cao với librubberband. Điều này có thể được sử dụng thay cho
nhịp độvà sẽ được sử dụng để điều chỉnh cao độ âm thanh khi phát ở tốc độ khác nhau
từ bình thường.

Bộ lọc này có một số tùy chọn phụ. Bạn có thể liệt kê chúng với mpv
--af = dây chun = trợ giúp. Điều này cũng sẽ hiển thị các giá trị mặc định cho mỗi tùy chọn. Các
các tùy chọn không được ghi lại ở đây, bởi vì chúng chỉ được chuyển đến librubberband.
Xem tài liệu librubberband để tìm hiểu chức năng của mỗi tùy chọn:
http://breakfastquay.com/rubberband/code-doc/classRubberBand_1_1RubberBandStretcher.html
(Ánh xạ của các tên và giá trị phụ của bộ lọc dây cao su mpv với các tên và giá trị của
librubberband tuân theo một mẫu đơn giản: "Quyền mua" + Họ tên + Giá trị.)

lavfi = đồ thị
Lọc âm thanh bằng libavfilter của FFmpeg.


Đồ thị libavfilter. Nhìn thấy lavfi bộ lọc video để biết chi tiết - cú pháp biểu đồ là
giống nhau.

Chú ý:
Đừng quên trích dẫn đồ thị libavfilter như được mô tả trong video lavfi
phần bộ lọc.

o =
TRÁNH.

Thêm bài này vào danh sách Video của bạn Download bài này LỌC

Bộ lọc video cho phép bạn sửa đổi luồng video và các thuộc tính của nó. Cú pháp là:

--vf =
Thiết lập một chuỗi các bộ lọc video.

Bạn cũng có thể đặt giá trị mặc định cho từng bộ lọc. Các giá trị mặc định được áp dụng trước giá trị bình thường
thông số bộ lọc.

--vf-defaults =
Đặt giá trị mặc định cho mỗi bộ lọc.

LƯU Ý:
Để có danh sách đầy đủ các bộ lọc video có sẵn, hãy xem --vf = trợ giúp.

Ngoài ra, hãy nhớ rằng hầu hết các bộ lọc thực tế đều có sẵn thông qua lavfi trình bao bọc, mà
cung cấp cho bạn quyền truy cập vào hầu hết các bộ lọc của libavfilter. Điều này bao gồm tất cả các bộ lọc có
đã được chuyển từ MPlayer sang libavfilter.

Bộ lọc video được quản lý trong danh sách. Có một số lệnh để quản lý danh sách bộ lọc.

--vf-add =
Thêm các bộ lọc đã cho dưới dạng đối số vào danh sách bộ lọc.

--vf-pre =
Thêm các bộ lọc được cung cấp làm đối số cho danh sách bộ lọc.

--vf-del =
Xóa các bộ lọc tại các chỉ mục nhất định. Số chỉ mục bắt đầu từ 0, âm
số địa chỉ cuối danh sách (-1 là số cuối cùng).

--vf-clr
Hoàn toàn trống danh sách bộ lọc.

Với các bộ lọc hỗ trợ nó, bạn có thể truy cập các thông số theo tên của chúng.

--vf = = giúp đỡ
In tên tham số và phạm vi giá trị tham số cho một bộ lọc cụ thể.

--vf =
Đặt một tham số đã đặt tên thành giá trị đã cho. Sử dụng bật và tắt hoặc có và không để đặt cờ
thông số.

Các bộ lọc có sẵn là:

cắt [= w: h: x: y]
Cắt phần đã cho của hình ảnh và loại bỏ phần còn lại. Hữu ích để loại bỏ màu đen
từ các video màn hình rộng.

,
Chiều rộng và chiều cao đã cắt, mặc định là chiều rộng và chiều cao ban đầu.

,
Vị trí của hình ảnh đã cắt, mặc định là chính giữa.

mở rộng [= w: h: x: y: khía cạnh: vòng]
Mở rộng (không chia tỷ lệ) độ phân giải video đến giá trị đã cho và đặt giá trị không theo tỷ lệ
gốc tại tọa độ x, y.

,
Chiều rộng, chiều cao được mở rộng (mặc định: chiều rộng, chiều cao ban đầu). Giá trị âm cho
w và h được coi là hiệu số so với kích thước ban đầu.

Ví dụ

mở rộng = 0: -50: 0: 0
Thêm đường viền 50 pixel vào cuối hình ảnh.

,
vị trí của hình ảnh gốc trên hình ảnh được mở rộng (mặc định: trung tâm)


Mở rộng để vừa với một khía cạnh thay vì độ phân giải (mặc định: 0).

Ví dụ

mở rộng = 800 :::: 4/3
Mở rộng thành 800x600, trừ khi nguồn có độ phân giải cao hơn, trong
trường hợp nào nó mở rộng để lấp đầy một khía cạnh 4/3.


Làm tròn lên để làm cho cả chiều rộng và chiều cao chia hết cho (mặc định: 1).

lật Lật ngược hình ảnh.

gương Phản chiếu hình ảnh trên trục Y.

xoay [= 0 | 90 | 180 | 270]
Xoay hình ảnh theo bội số 90 độ theo đồng hồ.

scale [= w: h: param: param2: chr-drop: noup: arnd
Cân chỉnh hình ảnh bằng bộ chia tỷ lệ phần mềm (chậm) và tạo màu YUV <-> RGB
chuyển đổi không gian (xem thêm --sws).

Tất cả các thông số là tùy chọn.

:
chiều rộng / chiều cao được chia tỷ lệ (mặc định: chiều rộng / chiều cao ban đầu)

0 được chia tỷ lệ d_width / d_height

-1 chiều rộng / chiều cao ban đầu

-2 Tính toán w / h bằng cách sử dụng thứ nguyên khác và phương diện được tính trước
tỉ lệ.

-3 Tính w / h bằng cách sử dụng thứ nguyên khác và phương diện ban đầu
tỉ lệ.

- (n + 8) Giống như -n ở trên, nhưng làm tròn thứ nguyên thành bội số gần nhất của
16.

[: ] (xem Ngoài ra --sws)
Đặt một số thông số tỷ lệ tùy thuộc vào loại tỷ lệ được chọn với
--sws:

--sws = 2 (bicubic): B (làm mờ) và C (đổ chuông)
0.00: 0.60 mặc định
0.00: 0.75 "bicubic chính xác" của VirtualDub
0.00: 0.50 Catmull-Rom spline
0.33: 0.33 Mitchell-Netravali spline
1.00: 0.00 khối B-spline

--sws = 7 (Gaussian): độ sắc nét (0 (mềm) - 100 (sắc nét))

--sws = 9 (Lanczos): độ dài bộ lọc (1-10)


bỏ qua sắc độ

0 Sử dụng tất cả các dòng đầu vào có sẵn cho sắc độ (mặc định).

1 Chỉ sử dụng mỗi 2. dòng đầu vào cho sắc độ.

2 Chỉ sử dụng mỗi 4. dòng đầu vào cho sắc độ.

3 Chỉ sử dụng mỗi 8. dòng đầu vào cho sắc độ.

Không cho phép nâng cấp quá kích thước ban đầu.

0 Cho phép nâng cấp (mặc định).

1 Không cho phép nâng cấp nếu một thứ nguyên vượt quá giá trị ban đầu của nó.

2 Không cho phép nâng cấp nếu cả hai thứ nguyên đều vượt quá giá trị ban đầu của chúng.

Làm tròn chính xác cho tỷ lệ dọc, có thể nhanh hơn hoặc chậm hơn
so với cách làm tròn mặc định.

Không Tắt làm tròn chính xác (mặc định).

Vâng Cho phép làm tròn chính xác.

dsize [= w: h: khía cạnh-phương pháp: r: khía cạnh]
Thay đổi kích thước / khía cạnh hiển thị dự kiến ​​tại một điểm tùy ý trong chuỗi bộ lọc.
Góc có thể được cho dưới dạng phân số (4/3) hoặc số dấu phẩy động (1.33).
Ngoài ra, bạn có thể chỉ định chiều rộng và chiều cao hiển thị chính xác mong muốn. Ghi chú
mà bộ lọc này làm không tự mở rộng quy mô; nó chỉ ảnh hưởng đến những gì người mở rộng quy mô sau này
(phần mềm hoặc phần cứng) sẽ thực hiện khi tự động điều chỉnh tỷ lệ đến đúng khía cạnh.

,
Chiều rộng và chiều cao màn hình mới.

Cũng có thể là những giá trị đặc biệt sau:

0 chiều rộng và chiều cao màn hình gốc

-1 chiều rộng và chiều cao video gốc (mặc định)

-2 Tính w / h bằng cách sử dụng kích thước khác và màn hình gốc
tỷ lệ khung hình.

-3 Tính w / h bằng cách sử dụng kích thước khác và khía cạnh video gốc
tỉ lệ.

Ví dụ

dsize = 800: -2
Chỉ định độ phân giải hiển thị 800x600 cho video 4/3 khung hình,
hoặc 800x450 cho video có tỷ lệ 16/9.


Sửa đổi chiều rộng và chiều cao theo tỷ lệ khung hình gốc.

-1 Bỏ qua tỷ lệ khung hình gốc (mặc định).

0 Giữ tỷ lệ khung hình hiển thị bằng cách sử dụng và như độ phân giải tối đa.

1 Giữ tỷ lệ khung hình hiển thị bằng cách sử dụng và là độ phân giải tối thiểu.

2 Giữ tỷ lệ khung hình video bằng cách sử dụng và như độ phân giải tối đa.

3 Giữ tỷ lệ khung hình video bằng cách sử dụng và là độ phân giải tối thiểu.

Ví dụ

dsize = 800: 600: 0
Chỉ định độ phân giải màn hình tối đa là 800x600 hoặc nhỏ hơn ở
để giữ khía cạnh.

Làm tròn lên để làm cho cả chiều rộng và chiều cao chia hết cho (mặc định: 1).


Bắt buộc một tỷ lệ khung hình.

format = fmt = : colormatrix = : ...
Hạn chế không gian màu cho bộ lọc tiếp theo mà không thực hiện bất kỳ chuyển đổi nào. Sử dụng
cùng với bộ lọc tỷ lệ cho một chuyển đổi thực sự.

LƯU Ý:
Để biết danh sách các định dạng có sẵn, hãy xem format = fmt = help.

Định dạng tên, ví dụ: rgb15, bgr24, 420p, v.v. (mặc định: không thay đổi).


Định dạng tên sẽ được thay thế cho đầu ra. Nếu họ không có
các byte giống nhau trên mỗi pixel và con dấu sắc độ, nó sẽ không thành công.


Điều khiển chuyển đổi không gian màu YUV sang RGB khi phát video. Có
các tiêu chuẩn khác nhau. Thông thường, BT.601 nên được sử dụng cho video SD và BT.709
cho video HD. (Điều này được thực hiện theo mặc định.) Sử dụng kết quả không gian màu không chính xác
có màu hơi dưới hoặc quá bão hòa và chuyển màu.

Các tùy chọn này không phải lúc nào cũng được hỗ trợ. Các đầu ra video khác nhau cung cấp
các mức độ hỗ trợ khác nhau. Các OpenGL và vdpau trình điều khiển đầu ra video
thường cung cấp hỗ trợ đầy đủ. Các xv đầu ra có thể đặt không gian màu nếu
trình điều khiển video hệ thống hỗ trợ nó, nhưng không hỗ trợ mức đầu vào và đầu ra. Các tỉ lệ
bộ lọc video có thể định cấu hình không gian màu và mức đầu vào, nhưng chỉ khi
định dạng đầu ra là RGB (nếu trình điều khiển đầu ra video hỗ trợ đầu ra RGB, bạn
có thể buộc điều này với -vf scale, format = rgba).

Nếu tùy chọn này được đặt thành tự động (là mặc định), màu của video
cờ khoảng trắng sẽ được sử dụng. Nếu cờ đó không được đặt, không gian màu sẽ là
được chọn tự động. Điều này được thực hiện bằng cách sử dụng phương pháp heuristic đơn giản để cố gắng
để phân biệt video SD và HD. Nếu video lớn hơn 1279x576 pixel,
BT.709 (HD) sẽ được sử dụng; nếu không thì BT.601 (SD) được chọn.

Không gian màu có sẵn là:

tự động lựa chọn tự động (mặc định)

bt.601 ITU-R BT.601 (SD)

bt.709 ITU-R BT.709 (HD)

bt.2020-ncl
Hệ thống độ sáng không đổi ITU-R BT.2020

bt.2020-cl
Hệ thống độ sáng không đổi ITU-R BT.2020

smte-240m
SMPTE-240M


Các mức màu YUV được sử dụng với chuyển đổi YUV sang RGB. Tùy chọn này chỉ là
cần thiết khi phát các tệp bị hỏng không theo màu chuẩn
cấp độ hoặc được gắn cờ sai. Nếu video không chỉ định màu của nó
phạm vi, nó được giả định là phạm vi giới hạn.

Các hạn chế tương tự như với ứng dụng.

Các dải màu có sẵn là:

tự động lựa chọn tự động (phạm vi thường giới hạn) (mặc định)

hạn chế
phạm vi giới hạn (16-235 cho luma, 16-240 cho chroma)

Full toàn dải (0-255 cho cả luma và chroma)


Các số liệu cơ bản RGB mà tệp nguồn đã được mã hóa. Thông thường điều này phải
đặt trong tiêu đề tệp, nhưng khi phát các tệp bị hỏng hoặc bị gắn thẻ nhầm, điều này
có thể được sử dụng để ghi đè cài đặt.

Tùy chọn này chỉ ảnh hưởng đến trình điều khiển đầu ra video thực hiện màu
quản lý, ví dụ OpenGL với mục tiêu-prim or hồ sơ icc
bộ phụ đề.

Nếu tùy chọn này được đặt thành tự động (là mặc định), video của
cờ bầu cử sơ bộ sẽ được sử dụng. Nếu cờ đó không được đặt, không gian màu sẽ
được chọn tự động, bằng cách sử dụng các kinh nghiệm sau: Nếu
được đặt hoặc xác định là BT.2020 hoặc BT.709,
các bầu cử sơ bộ tương ứng được sử dụng. Ngược lại, nếu chiều cao video là
chính xác 576 (PAL), BT.601-625 được sử dụng. Nếu nó chính xác là 480 hoặc 486 (NTSC),
BT.601-525 được sử dụng. Nếu độ phân giải video là bất kỳ thứ gì khác, BT.709 là
đã sử dụng.

Các cuộc bầu cử sơ bộ hiện có là:

tự động lựa chọn tự động (mặc định)

bt.601-525
Hệ thống 601 dòng ITU-R BT.525 (SD) (NTSC, SMPTE-C)

bt.601-625
Hệ thống 601 dòng ITU-R BT.625 (SD) (PAL, SECAM)

bt.709 ITU-R BT.709 (HD) (giống như sRGB)

bt.2020
ITU-R BT.2020 (UHD)

táo táo RGB

adobe AdobeRGB (1998)

tiên tri
ProPhoto RGB (ROMM)

cie1931
CIE 1931 RGB


Hàm gamma mà tệp nguồn đã được mã hóa. Thông thường điều này nên
được đặt trong tiêu đề tệp, nhưng khi phát tệp bị hỏng hoặc bị đánh dấu nhầm
điều này có thể được sử dụng để ghi đè cài đặt.

Tùy chọn này chỉ ảnh hưởng đến trình điều khiển đầu ra video thực hiện màu
quản lý.

Nếu tùy chọn này được đặt thành tự động (là mặc định), gamma sẽ
được đặt thành BT.1886 cho nội dung YCbCr, sRGB cho nội dung RGB và Tuyến tính
cho nội dung XYZ.

Các hàm gamma có sẵn là:

tự động lựa chọn tự động (mặc định)

bt.1886
ITU-R BT.1886 (xấp xỉ đường cong BT.601 / BT.709 / BT.2020)

srgb IEC 61966-2-4 (sRGB)

tuyến tính Ánh sáng tuyến tính

gamma1.8
Đường cong công suất thuần túy (gamma 1.8)

gamma2.2
Đường cong công suất thuần túy (gamma 2.2)

gamma2.8
Đường cong công suất thuần túy (gamma 2.8)

tiên tri
Đường cong ProPhoto RGB (ROMM)


Đặt chế độ âm thanh nổi mà video được coi là được mã hóa. Thực hiện tương tự
giá trị như --video-âm thanh nổi-chế độ tùy chọn.


Đặt chế độ âm thanh nổi mà video sẽ được hiển thị. Có các giá trị giống nhau
như --video-âm thanh nổi-chế độ tùy chọn.


Đặt cách xoay video được giả định là được mã hóa theo độ. Các
giá trị đặc biệt -1 sử dụng định dạng đầu vào.

,
Đặt kích thước hiển thị. Lưu ý rằng đặt kích thước hiển thị sao cho video
được chia tỷ lệ theo cả hai hướng thay vì chỉ thay đổi tỷ lệ khung hình là một
chi tiết triển khai và có thể thay đổi sau này.

Đặt tỷ lệ khung hình hiển thị của khung video. Đây là một float, nhưng các giá trị
như là [16: 9] cũng có thể được thông qua ([...] để trích dẫn để ngăn chặn tùy chọn
phân tích cú pháp từ việc diễn giải : tính cách).

noformat [= fmt]
Hạn chế không gian màu cho bộ lọc tiếp theo mà không thực hiện bất kỳ chuyển đổi nào. không giống
bộ lọc định dạng, điều này sẽ cho phép bất kỳ không gian màu nào ngoại trừ không gian bạn chỉ định.

LƯU Ý:
Để biết danh sách các định dạng có sẵn, hãy xem noformat = fmt = help.

Định dạng tên, ví dụ: rgb15, bgr24, 420p, v.v. (mặc định: 420p).

lavfi = graph [: sws-flags [: o = opts]]
Lọc video bằng libavfilter của FFmpeg.


Chuỗi đồ thị libavfilter. Bộ lọc phải có một đệm đầu vào video duy nhất
và một pad đầu ra video.

Xem https://ffmpeg.org/ffmpeg-filters.html để biết cú pháp và các bộ lọc có sẵn.

Chú ý:
Nếu bạn muốn sử dụng cú pháp bộ lọc đầy đủ với tùy chọn này, bạn phải
trích dẫn biểu đồ bộ lọc để ngăn cú pháp của mpv và bộ lọc
cú pháp đồ thị khỏi đụng độ.

Các ví dụ

-vf lavfi = [gradfun = 20: 30, vflip]
tốt nghiệp bộ lọc với các tham số vô nghĩa, theo sau là vflip
lọc. (Điều này cho thấy cách libavfilter lấy biểu đồ và không
chỉ một bộ lọc.) Chuỗi biểu đồ bộ lọc được trích dẫn bằng [
và ]. Điều này không yêu cầu trích dẫn bổ sung hoặc thoát với một số
shell (như bash), trong khi các shell khác (như zsh) yêu cầu bổ sung "
dấu ngoặc kép xung quanh chuỗi tùy chọn.

'--vf = lavfi = "gradfun = 20: 30, vflip"'
Giống như trước đây, nhưng sử dụng trích dẫn nên an toàn với tất cả
vỏ sò. Bên ngoài ' dấu ngoặc kép đảm bảo rằng trình bao không
loại bỏ các " báo giá cần thiết của mpv.

'--vf = lavfi = graph = "gradfun = radius = 30: strength = 20, vflip"'
Giống như trước đây, nhưng sử dụng các tham số được đặt tên cho mọi thứ.


Nếu libavfilter chèn các bộ lọc để chuyển đổi định dạng pixel, thì tùy chọn này
đưa ra các cờ sẽ được chuyển tới libswscale. Tùy chọn này là số
và có sự kết hợp khôn ngoan giữa SWS_ cờ.

Xem http://git.videolan.org/? p = ffmpeg.git; a = blob; f = libswscale / swscale.h.

Đặt tùy chọn AVFilterGraph. Những điều này sẽ được FFmpeg ghi lại.

Ví dụ

'--vf = lavfi = yadif: o = "thread = 2, thread_type = slice"
buộc một cấu hình luồng cụ thể.

eq [= gamma: tương phản: độ sáng: độ bão hòa: rg: gg: bg: trọng lượng]
Bộ cân bằng phần mềm sử dụng bảng tra cứu (chậm), cho phép hiệu chỉnh gamma trong
ngoài việc điều chỉnh độ sáng và độ tương phản đơn giản. Các tham số được đưa ra là
các giá trị dấu phẩy động.

<0.1-10>
giá trị gamma ban đầu (mặc định: 1.0)

<-2-2> độ tương phản ban đầu, trong đó các giá trị âm dẫn đến hình ảnh âm tính (mặc định:
1.0)

<-1-1> độ sáng ban đầu (mặc định: 0.0)

<0-3> độ bão hòa ban đầu (mặc định: 1.0)

<0.1-10>
giá trị gamma cho thành phần màu đỏ (mặc định: 1.0)

<0.1-10>
giá trị gamma cho thành phần màu xanh lá cây (mặc định: 1.0)

<0.1-10>
giá trị gamma cho thành phần màu xanh lam (mặc định: 1.0)

<0-1> Tham số trọng lượng có thể được sử dụng để giảm ảnh hưởng của giá trị gamma cao
trên các khu vực hình ảnh sáng, ví dụ: giữ cho chúng không bị đơn giản hóa quá mức và chỉ
trắng trơn. Giá trị 0.0 làm giảm toàn bộ việc hiệu chỉnh gamma
trong khi 1.0 để nó ở mức tối đa (mặc định: 1.0).

pullup [= jl: jr: jt: jb: sb: mp]
Bộ lọc đảo ngược kéo xuống (nghịch đảo telecine), có khả năng xử lý hỗn hợp
hard-telecine, 24000/1001 fps lũy tiến và 30000/1001 fps nội dung.
kéo lên bộ lọc sử dụng ngữ cảnh trong tương lai để đưa ra quyết định. Nó là
không trạng thái theo nghĩa là nó không khóa vào một khuôn mẫu để tuân theo, nhưng nó
thay vào đó, trông đợi vào các trường sau để xác định các kết quả phù hợp và
xây dựng lại các khung lũy ​​tiến.

jl, jr, jt, và jb
Các tùy chọn này đặt số lượng "rác" cần bỏ qua ở bên trái, bên phải, trên cùng,
và dưới cùng của hình ảnh, tương ứng. Trái / phải tính theo đơn vị 8 pixel,
trong khi top / bottom tính theo đơn vị là 2 dòng. Mặc định là 8 pixel trên mỗi
bên.

sb (nghiêm khắc nghỉ giải lao)
Đặt tùy chọn này thành 1 sẽ làm giảm cơ hội kéo lên tạo ra một
đôi khi khung không khớp, nhưng nó cũng có thể gây ra quá nhiều
khung hình bị rơi trong chuỗi chuyển động cao. Ngược lại, đặt nó
đến -1 sẽ làm cho kéo lên khớp các trường dễ dàng hơn. Điều này có thể giúp xử lý
video có hơi mờ giữa các trường, nhưng cũng có thể gây ra
có các khung xen kẽ trong đầu ra.

mp (Hệ mét chiếc máy bay)
Tùy chọn này có thể được đặt thành u or v sử dụng mặt phẳng màu thay vì mặt phẳng luma
máy bay để làm kéo lêntính toán của. Điều này có thể cải thiện độ chính xác trên rất
nguyên liệu nguồn sạch, nhưng nhiều khả năng sẽ làm giảm độ chính xác, đặc biệt nếu
có nhiễu sắc độ (hiệu ứng cầu vồng) hoặc bất kỳ video nào có thang độ xám. Chính
mục đích của việc thiết lập mp sang mặt phẳng sắc độ là để giảm tải CPU và làm cho
pullup có thể sử dụng trong thời gian thực trên các máy chạy chậm.

yadif = [mode: interlaced-only]
Tuy nhiên, một bộ lọc khử xen kẽ khác



khung Xuất ra 1 khung hình cho mỗi khung hình.

lĩnh vực Xuất ra 1 khung cho mỗi trường.

khung-không gian
Như khung nhưng bỏ qua kiểm tra xen kẽ không gian.

lĩnh vực không gian
Như lĩnh vực nhưng bỏ qua kiểm tra xen kẽ không gian.



Không Khử xen kẽ tất cả các khung (mặc định).

Vâng Chỉ hủy xen kẽ các khung được đánh dấu là xen kẽ (mặc định nếu bộ lọc này
được chèn qua khử xen kẽ bất động sản).

Bộ lọc này, được tự động chèn khi sử dụng d chìa khóa (hoặc bất kỳ khóa nào khác
bật tắt khử xen kẽ tài sản hoặc khi sử dụng --deinterlace chuyển đổi), giả sử
đầu ra video không có hỗ trợ khử xen kẽ gốc.

Nếu bạn chỉ muốn đặt chế độ mặc định, hãy đặt bộ lọc này và các tùy chọn của nó vào
--vf-mặc định thay vào đó, và bật khử xen kẽ với d or --deinterlace.

Cũng lưu ý rằng d phím đủ ngu ngốc để chèn một bộ khử xen kẽ hai lần khi
chèn yadif với --vf, vì vậy việc sử dụng các phương pháp trên được khuyến khích.

sub = [= bottom-margin: top-margin]
Di chuyển hiển thị phụ đề đến một điểm tùy ý trong chuỗi bộ lọc hoặc buộc
hiển thị phụ đề trong bộ lọc video thay vì sử dụng OSD đầu ra video
hỗ trợ.


Thêm một dải màu đen ở dưới cùng của khung. Trình kết xuất SSA / ASS có thể đặt
phụ đề ở đó (với - sub-use-margin).


Dải màu đen trên đầu cho phụ đề (với - sub-use-margin).

Các ví dụ

--vf = sub, eq
Di chuyển hiển thị phụ trước bộ lọc eq. Điều này sẽ đặt cả hai phụ đề
màu sắc và video dưới ảnh hưởng của cài đặt bộ cân bằng video.

stereo3d [= in: out]
Stereo3d chuyển đổi giữa các định dạng hình ảnh lập thể khác nhau.

Định dạng hình ảnh lập thể của đầu vào. Những giá trị khả thi:

ssl or side_by_side_left_first
song song cạnh nhau (mắt trái bên trái, mắt phải bên phải)

ssr or side_by_side_right_first
mắt chéo bên nhau (mắt phải trái, mắt trái phải)

abl or trên_below_left_first
trên-dưới (mắt trái ở trên, mắt phải ở dưới)

tháng tư or trên_below_right_first
trên-dưới (mắt phải ở trên, mắt trái ở dưới)

ab2l or trên_below_half_height_left_first
trên-dưới với độ phân giải nửa chiều cao (mắt trái ở trên, mắt phải
dưới đây)

ab2r or trên_below_half_height_right_first
trên-dưới với độ phân giải nửa chiều cao (mắt phải ở trên, mắt trái
dưới đây)

Định dạng hình ảnh lập thể của đầu ra. Các giá trị có thể là tất cả các đầu vào
cũng như:

vòng cung or anaglyph_red_cyan_gray
anaglyph red / cyan gray (bộ lọc màu đỏ ở mắt trái, bộ lọc màu lục lam ở bên phải
con mắt)

arch or anaglyph_red_cyan_half_color
anaglyph đỏ / lục lam một nửa màu (bộ lọc màu đỏ ở mắt trái, bộ lọc màu lục lam
trên mắt phải)

vòng cung or anaglyph_red_cyan_color
màu đỏ / lục lam anaglyph (bộ lọc màu đỏ ở mắt trái, bộ lọc màu lục lam ở bên phải
con mắt)

vòng cung or anaglyph_red_cyan_dubois
Màu đỏ / lục lam anaglyph được tối ưu hóa với phép chiếu hình vuông nhỏ nhất
của Dubois (bộ lọc màu đỏ ở mắt trái, bộ lọc màu lục lam ở mắt phải)

ôi trời or anaglyph_green_magenta_gray
màu xanh lá cây anaglyph / màu xám đỏ tươi (bộ lọc màu xanh lục ở mắt trái, bộ lọc màu đỏ tươi
trên mắt phải)

ôi trời or anaglyph_green_magenta_half_color
màu xanh lá cây anaglyph / nửa màu đỏ tươi (bộ lọc màu xanh lục ở mắt trái,
bộ lọc màu đỏ tươi trên mắt phải)

agmc or anaglyph_green_magenta_color
màu xanh lá cây / đỏ tươi anaglyph (bộ lọc màu xanh lục ở mắt trái, màu đỏ tươi
bộ lọc trên mắt phải)

aybg or anaglyph_vàng_xanh_xám
anaglyph màu vàng / xanh xám (bộ lọc màu vàng ở mắt trái, bộ lọc màu xanh lam đang bật
mắt phải)

ôi or anaglyph_ yellow_blue_half_color
anaglyph màu vàng / xanh lam nửa màu (bộ lọc màu vàng ở mắt trái, màu xanh lam
bộ lọc trên mắt phải)

aybc or anaglyph_vàng_xanh_color
anaglyph màu vàng / xanh lam (bộ lọc màu vàng ở mắt trái, bộ lọc màu xanh lam
trên mắt phải)

irl or xen kẽ_rows_left_first
Các hàng xen kẽ (mắt trái có hàng trên cùng, mắt phải bắt đầu ở hàng tiếp theo)

nước mắt or xen kẽ_rows_right_first
Các hàng xen kẽ (mắt phải có hàng trên cùng, mắt trái bắt đầu ở hàng tiếp theo)

ml or mono_left
đầu ra đơn sắc (chỉ mắt trái)

mr or mono_right
đầu ra đơn sắc (chỉ mắt phải)

gradfun [= strength [: radius |: size = ]]
Sửa lỗi tạo tác dải đôi khi được đưa vào các vùng gần như bằng phẳng bằng cách
cắt bớt độ sâu màu 8 bit. Nội suy các gradient sẽ đi đến đâu
các ban nhạc đang, và trang trí chúng.


Số tiền tối đa mà bộ lọc sẽ thay đổi bất kỳ một pixel nào. Ngoài ra
ngưỡng phát hiện các vùng gần như phẳng (mặc định: 1.5).


Vùng lân cận để phù hợp với gradient. Bán kính lớn hơn giúp mượt mà hơn
gradient, nhưng cũng ngăn bộ lọc sửa đổi các pixel gần chi tiết
vùng (mặc định: bị vô hiệu hóa).

kích thước của bộ lọc tính bằng phần trăm kích thước đường chéo của hình ảnh. Điều này được sử dụng để
tính toán kích thước bán kính cuối cùng (mặc định: 1).

dlopen = dll [: a0 [: a1 [: a2 [: a3]]]]
Tải một thư viện bên ngoài để lọc hình ảnh. Giao diện thư viện là
vf_dlopen giao diện được chỉ định bằng cách sử dụng libmpcodecs / vf_dlopen.h.

Chú ý:
Bộ lọc này không được dùng nữa.

dll =
Chỉ định thư viện để tải. Điều này có thể yêu cầu một đường dẫn hệ thống tệp đầy đủ trong
một số trường hợp. Đối số này là bắt buộc.

a0 =
Chỉ định tham số đầu tiên để truyền vào thư viện.

a1 =
Chỉ định tham số thứ hai để truyền vào thư viện.

a2 =
Chỉ định tham số thứ ba để truyền vào thư viện.

a3 =
Chỉ định tham số thứ tư để truyền vào thư viện.

vapoursynth = file: buffered-frames: concurrent-frames
Tải tập lệnh bộ lọc VapourSynth. Điều này dành cho quá trình xử lý trực tuyến: mpv
thực sự cung cấp một bộ lọc nguồn, thay vì sử dụng video VapourSynth gốc
nguồn. Nguồn mpv sẽ chỉ trả lời các yêu cầu khung trong một cửa sổ nhỏ của
khung (kích thước của cửa sổ này được kiểm soát bằng khung đệm tham số),
và các yêu cầu bên ngoài đó sẽ trả về lỗi. Như vậy, bạn không thể sử dụng đầy đủ
sức mạnh của VapourSynth, nhưng bạn có thể sử dụng một số bộ lọc nhất định.

Nếu bạn chỉ muốn phát video được tạo bởi VapourSynth (tức là sử dụng video gốc
Nguồn video VapourSynth), tốt hơn nên sử dụng vspipe và FIFO để cung cấp video
tới mpv. Điều tương tự cũng áp dụng nếu tập lệnh bộ lọc yêu cầu quyền truy cập khung ngẫu nhiên (xem
khung đệm tham số).

Bộ lọc này là thử nghiệm. Nếu nó hoạt động tốt và được sử dụng, nó
sẽ được chuyển sang libavfilter. Nếu không, nó sẽ bị loại bỏ.

hồ sơ Tên tệp của nguồn tập lệnh. Hiện tại, đây luôn là một tập lệnh python.
Biến video_in được đặt thành nguồn video mpv và nó được mong đợi
rằng tập lệnh đọc video từ nó. (Nếu không, mpv sẽ không giải mã video,
và hàng đợi gói video sẽ tràn, cuối cùng dẫn đến âm thanh
đã dừng.) Tập lệnh cũng dự kiến ​​sẽ chuyển qua các dấu thời gian bằng cách sử dụng
_DurationNum và _DurationDen thuộc tính khung.

Ví dụ:

import vapoursynth dưới dạng vs
core = vs.get_core ()
core.std.AddBorders (video_in, 10, 10, 20, 20) .set_output ()

Chú ý:
Tập lệnh sẽ được tải lại sau mỗi lần tìm kiếm. Điều này được thực hiện để thiết lập lại
lọc đúng khi không liên tục.

khung đệm
Số lượng khung video được giải mã tối đa sẽ được lưu vào bộ đệm trước
bộ lọc (mặc định: 4). Điều này chỉ định số khung tối đa mà tập lệnh
có thể yêu cầu ngược lại. Ví dụ: nếu khung đệm = 5và kịch bản chỉ
đã yêu cầu khung 15, nó vẫn có thể yêu cầu khung 10, nhưng khung 9 thì không
có sẵn nữa. Nếu nó yêu cầu khung 30, mpv sẽ giải mã thêm 15 khung,
và chỉ giữ khung 25-30.

Số lượng khung hình được đệm thực tế cũng phụ thuộc vào giá trị của
khung đồng thời quyền mua. Hiện tại, cả hai giá trị tùy chọn đều được nhân với
lấy kích thước bộ đệm cuối cùng.

(Thông thường, bộ lọc nguồn VapourSynth phải cung cấp quyền truy cập ngẫu nhiên, nhưng mpv
được tạo ra để phát lại và không cung cấp quyền truy cập ngẫu nhiên chính xác theo khung hình. Các
cách bộ lọc video này hoạt động là một sự thỏa hiệp để làm cho các bộ lọc đơn giản hoạt động
dù sao.)

khung đồng thời
Số lượng khung hình cần được yêu cầu song song. Mức độ
đồng thời phụ thuộc vào bộ lọc và mpv có thể giải mã video nhanh như thế nào để
cấp cho bộ lọc. Giá trị này có lẽ phải tỷ lệ với số
trên máy của bạn. Hầu hết thời gian, làm cho nó cao hơn số lõi
thực sự có thể làm cho nó chậm hơn.

Theo mặc định, điều này sử dụng giá trị đặc biệt tự động, đặt tùy chọn thành
số lõi CPU logic được phát hiện.

Các biến sau được xác định bởi mpv:

video_in
Nguồn video mpv dưới dạng clip vapoursynth. Lưu ý rằng điều này không có độ dài được đặt,
khiến nhiều bộ lọc nhầm lẫn. Sử dụng Tỉa trên clip có chiều dài hình nộm cao
có thể biến nó thành một clip hữu hạn.

video_in_dw, video_in_dh
Kích thước hiển thị của video. Có thể khác với kích thước video nếu video
không sử dụng pixel vuông (ví dụ: DVD).

container_fps
Giá trị FPS như được báo cáo bởi tiêu đề tệp. Giá trị này có thể sai hoặc hoàn toàn
bị hỏng (ví dụ: 0 hoặc NaN). Ngay cả khi giá trị là chính xác, nếu một bộ lọc khác
thay đổi FPS thực (bằng cách giảm hoặc chèn khung hình), giá trị của điều này
biến có thể không hữu ích. Lưu ý rằng --khung hình/giây tùy chọn dòng lệnh
ghi đè giá trị này.

Hữu ích cho một số bộ lọc đòi hỏi phải có FPS.

hiển thị_fps
Tốc độ làm mới của màn hình hiện tại. Lưu ý rằng giá trị này có thể là 0.

vapoursynth-lười biếng
Giống như tổng hợp hơi, nhưng không tải các tập lệnh Python. Thay vào đó, một chương trình phụ trợ tùy chỉnh
sử dụng Lua và API VapourSynth thô được sử dụng. Cú pháp hoàn toàn khác,
và hoàn toàn không có tính năng tiện lợi nào được cung cấp. Không có kiểu kiểm tra
và bạn có thể gây ra sự cố.

Ví dụ:

video_out = invoke ("morpho", "Mở", {clip = video_in})

Biến đặc biệt video_in là nguồn video mpv, trong khi biến đặc biệt
video_out được sử dụng để đọc video từ. Đối số đầu tiên là plugin (được truy vấn với
getPluginByNs), đối số thứ 2 là tên bộ lọc và đối số thứ 3 là bảng có
các đối số. Đối số vị trí không được hỗ trợ. Các loại phải phù hợp
một cách chính xác. Vì Lua rất tệ và không thể phân biệt số nguyên và số thực, số nguyên
các đối số phải được bắt đầu bằng i_, trong trường hợp đó tiền tố bị xóa và
đối số được chuyển thành một số nguyên. Tên của đối số có bắt đầu bằng i_, bạn
hết may mắn.

Clip (VSNodeRef) được chuyển dưới dạng dữ liệu người dùng nhẹ, vì vậy hãy cố gắng chuyển bất kỳ đoạn nào khác
loại dữ liệu người dùng sẽ dẫn đến sự cố khó.

vavpp Xử lý bài đăng video VA-AP-API. Làm việc với --vo = vaapi và --vo = opengl chỉ
Hiện đang hủy xen kẽ. Bộ lọc này được tự động chèn vào nếu không xen kẽ là
được yêu cầu (hoặc sử dụng d , theo mặc định được ánh xạ tới lệnh chu kỳ
khử xen kẽ, Hoặc --deinterlace Tùy chọn).

deint =
Chọn thuật toán khử xen kẽ.

Không Không thực hiện khử xen kẽ.

lĩnh vực đầu tiên
Chỉ hiển thị trường đầu tiên (đi qua - thống trị trường).

ngũ cốc bob deinterlacing (mặc định).

dệt, thích ứng chuyển động, bù chuyển động
Các thuật toán khử xen kẽ nâng cao. Liệu những thứ này có thực sự hoạt động hay không
phụ thuộc vào phần cứng GPU, trình điều khiển GPU, lỗi trình điều khiển và mpv
lỗi.



Không Khử xen kẽ tất cả các khung.

Vâng Chỉ hủy xen kẽ các khung được đánh dấu là xen kẽ (mặc định).

vdpaupp
Xử lý bài đăng video VDPAU. Làm việc với --vo = vdpau và --vo = opengl chỉ có. Điều này
bộ lọc được tự động chèn nếu yêu cầu khử xen kẽ (sử dụng d
, theo mặc định được ánh xạ tới lệnh chu kỳ khử xen kẽ, Hoặc --deinterlace
quyền mua). Khi bật chức năng khử xen kẽ, nó luôn được ưu tiên hơn phần mềm
bộ lọc deinterlacer nếu vdpau VO được sử dụng và cũng có thể OpenGL được sử dụng và
giải mã phần cứng đã được kích hoạt ít nhất một lần (tức là vdpau đã được tải).

mài = <-1-1>
Đối với các giá trị dương, hãy áp dụng thuật toán làm sắc nét cho video, đối với giá trị âm
giá trị thuật toán làm mờ (mặc định: 0).

biến tính = <0-1>
Áp dụng thuật toán giảm nhiễu cho video (mặc định: 0; không nhiễu
giảm).

deint =
Bỏ xen kẽ có được bật hay không (mặc định: không). Nếu được bật, nó sẽ sử dụng
chế độ được chọn với chế độ deint.

deint-mode =
Chọn chế độ khử xen kẽ (mặc định: tạm thời). Tất cả các chế độ tôn trọng
- thống trị trường.

Lưu ý rằng hiện có một cơ chế cho phép vdpau VO để thay đổi
các chế độ deint trong tổng số tự động được chèn vdpaupp bộ lọc. Để tránh nhầm lẫn, nó
khuyến cáo không sử dụng --vo = vdpau các tiểu mục liên quan đến lọc.

lĩnh vực đầu tiên
Chỉ hiển thị trường đầu tiên.

ngũ cốc Bob khử xen kẽ.

tạm thời
Khử xen kẽ theo thời gian thích ứng với chuyển động. Có thể dẫn đến giải mã A / V với
phần cứng video chậm và / hoặc độ phân giải cao.

thời gian-không gian
Không xen kẽ theo thời gian thích ứng với chuyển động với không gian có hướng dẫn cạnh
phép nội suy. Cần phần cứng video nhanh.

sắc độ
Làm cho các bộ khử xen kẽ thời gian hoạt động cả trên luma và chroma (mặc định). Sử dụng
no-chroma-deint để chỉ sử dụng luma và tăng tốc độ khử xen kẽ nâng cao.
Hữu ích với bộ nhớ video chậm.

kéo lên Cố gắng áp dụng telecine nghịch đảo, cần khử xen kẽ thời gian thích ứng chuyển động.

interlaced-only =
If Vâng (mặc định), chỉ hủy xen kẽ các khung được đánh dấu là đã xen kẽ.

hqscaling = <0-9>

0 Sử dụng tỷ lệ VDPAU mặc định (mặc định).

1-9 Áp dụng quy mô VDPAU chất lượng cao (cần phần cứng có khả năng).

vdpaurb
Video VDPAU đọc lại. Làm việc với --vo = vdpau và --vo = opengl chỉ có. Bộ lọc này
sẽ đọc lại các khung được VDPAU giải mã để các bộ lọc khác không
thường tương thích với VDPAU, có thể được sử dụng như bình thường. Bộ lọc này phải là
được chỉ định trước vdpaupp trong chuỗi bộ lọc nếu vdpaupp Được sử dụng.

đệm =
Đệm khung trong chuỗi bộ lọc. Bộ lọc này có lẽ khá vô dụng,
ngoại trừ gỡ lỗi. (Lưu ý rằng điều này sẽ không giúp làm dịu độ trễ với
giải mã, bởi vì bộ lọc sẽ không bao giờ xuất ra khung nếu bộ đệm không đầy,
ngoại trừ trên EOF.)

THƯỞNG THỨC

Bạn có thể mã hóa tệp từ định dạng / codec này sang định dạng / codec khác bằng cách sử dụng tiện ích này.

--o =
Bật chế độ mã hóa và chỉ định tên tệp đầu ra.

--of =
Chỉ định định dạng đầu ra (ghi đè tính năng tự động phát hiện bằng phần mở rộng tên tệp của
tệp được chỉ định bởi -o). Đây có thể là danh sách các định dạng có thể được phân tách bằng dấu phẩy
thử. Nhìn thấy --of = giúp đỡ để có danh sách đầy đủ các định dạng được hỗ trợ.

--ofopts =
Chỉ định các tùy chọn định dạng đầu ra cho libavformat. Nhìn thấy --ofopts = trợ giúp cho đầy đủ
danh sách các tùy chọn được hỗ trợ.

Các tùy chọn được quản lý trong danh sách. Có một số lệnh để quản lý danh sách tùy chọn.

--ofopts-add =
Thêm các tùy chọn đã cho dưới dạng đối số vào danh sách tùy chọn.

--ofopts-pre =
Đặt trước các tùy chọn được cung cấp dưới dạng đối số cho danh sách tùy chọn.

--ofopts-del =
Xóa các tùy chọn tại các chỉ mục đã cho. Số chỉ mục bắt đầu từ 0, âm
số địa chỉ cuối danh sách (-1 là số cuối cùng).

--ofopts-clr
Hoàn toàn trống danh sách tùy chọn.

--ofps = giá trị>
Chỉ định cơ sở thời gian định dạng đầu ra (mặc định: 24000). Các giá trị thấp như giới hạn 25
video fps bằng cách giảm khung hình.

--oautofps
Đặt cơ sở thời gian định dạng đầu ra thành tốc độ khung hình đoán của video đầu vào
(mô phỏng hành vi MEncoder, hữu ích cho AVI; có thể gây giảm khung hình). Lưu ý rằng
không phải tất cả các codec và không phải tất cả các định dạng đều hỗ trợ mã hóa VFR và một số có
lỗi khi tốc độ bit mục tiêu được chỉ định - sử dụng --opps or --oautofps buộc CFR
mã hóa trong những trường hợp này.

--omaxfps = giá trị>
Chỉ định khoảng cách tối thiểu của các khung liền kề (mặc định: 0, có nghĩa là không được đặt).
Nội dung của tốc độ khung hình thấp hơn không được điều chỉnh lại thành tốc độ khung hình này; nội dung của cao hơn
tốc độ khung hình được giảm xuống tốc độ khung hình này.

--oharddup
Nếu được đặt, tốc độ khung hình được cung cấp bởi --opps đạt được không phải bằng cách bỏ qua mã thời gian, nhưng
bằng cách nhân đôi khung hình (chế độ tốc độ khung hình không đổi).

--oneverdrop
Nếu được đặt, khung không bao giờ bị rơi. Thay vào đó, mã thời gian của video được điều chỉnh lại thành
luôn tăng. Tuy nhiên, điều này có thể gây ra AV desync; để giải quyết vấn đề này, hãy sử dụng
cơ sở thời gian fps cao bằng cách sử dụng --opps và tuyệt đối tránh --oautofps.

--oac =
Chỉ định codec âm thanh đầu ra. Đây có thể là danh sách có thể được phân tách bằng dấu phẩy
codec để thử. Nhìn thấy --oac = giúp đỡ để có danh sách đầy đủ các codec được hỗ trợ.

--oaoffset =
Dịch chuyển dữ liệu âm thanh theo thời gian nhất định (tính bằng giây) bằng cách thêm / bớt mẫu tại
khởi đầu.

--oacopts =
Chỉ định các tùy chọn codec âm thanh đầu ra cho libavcodec. Nhìn thấy --oacopts = trợ giúp cho một
danh sách đầy đủ các tùy chọn được hỗ trợ.

Ví dụ

--oac = libmp3lame --oacopts = b = 128000
chọn mã hóa MP128 3 kbps.

Các tùy chọn được quản lý trong danh sách. Có một số lệnh để quản lý danh sách tùy chọn.

--oacopts-add =
Thêm các tùy chọn đã cho dưới dạng đối số vào danh sách tùy chọn.

--oacopts-pre =
Đặt trước các tùy chọn được cung cấp dưới dạng đối số cho danh sách tùy chọn.

--oacopts-del =
Xóa các tùy chọn tại các chỉ mục đã cho. Số chỉ mục bắt đầu từ 0, âm
số địa chỉ cuối danh sách (-1 là số cuối cùng).

--oacopts-clr
Hoàn toàn trống danh sách tùy chọn.

- đầu tiên
Buộc luồng âm thanh trở thành luồng đầu tiên trong đầu ra. Theo mặc định,
thứ tự không xác định.

--ovc =
Chỉ định codec video đầu ra. Đây có thể là danh sách có thể được phân tách bằng dấu phẩy
codec để thử. Nhìn thấy --ovc = trợ giúp để có danh sách đầy đủ các codec được hỗ trợ.

--ovoffset =
Dịch chuyển dữ liệu video theo thời gian nhất định (tính bằng giây) bằng cách thay đổi các giá trị pts.

--ovcopt
Chỉ định các tùy chọn codec video đầu ra cho libavcodec. Xem --ovcopts = help for a
danh sách đầy đủ các tùy chọn được hỗ trợ.

Các ví dụ

"--ovc = mpeg4 --ovcopts = qscale = 5 "
chọn thang lượng tử không đổi 5 cho mã hóa MPEG-4.

"--ovc = libx264 --ovcopts = crf = 23 "
chọn hệ số chất lượng VBR 23 cho mã hóa H.264.

Các tùy chọn được quản lý trong danh sách. Có một số lệnh để quản lý danh sách tùy chọn.

--ovcopts-add =
Thêm các tùy chọn đã cho dưới dạng đối số vào danh sách tùy chọn.

--ovcopts-pre =
Đặt trước các tùy chọn được cung cấp dưới dạng đối số cho danh sách tùy chọn.

--ovcopts-del =
Xóa các tùy chọn tại các chỉ mục đã cho. Số chỉ mục bắt đầu từ 0, âm
số địa chỉ cuối danh sách (-1 là số cuối cùng).

--ovcopts-clr
Hoàn toàn trống danh sách tùy chọn.

--ovfirst
Buộc luồng video trở thành luồng đầu tiên trong đầu ra. Theo mặc định,
thứ tự không xác định.

- máy photocopy
Sao chép pts đầu vào vào video đầu ra (không được hỗ trợ bởi một số vùng chứa đầu ra
định dạng, ví dụ như AVI). Sự gián đoạn vẫn được khắc phục. Theo mặc định, pts âm thanh được đặt
đến thời gian phát lại và pts video được đồng bộ hóa để khớp với pts âm thanh, như một số đầu ra
định dạng không hỗ trợ bất cứ điều gì khác.

--orawts
Sao chép pts đầu vào vào video đầu ra (không được hỗ trợ bởi một số vùng chứa đầu ra
định dạng, ví dụ như AVI). Trong chế độ này, sự gián đoạn không được cố định và tất cả các điểm đều
đi qua nguyên trạng. Không bao giờ tìm kiếm ngược lại hoặc sử dụng nhiều tệp đầu vào trong này
chế độ!

--không có siêu dữ liệu
Tắt sao chép siêu dữ liệu từ tệp đầu vào sang tệp đầu ra khi mã hóa (cái nào
được bật theo mặc định).

COMMAND GIAO DIỆN

Lõi mpv có thể được điều khiển bằng các lệnh và thuộc tính. Một số cách để tương tác
với người chơi sử dụng chúng: các ràng buộc chính (đầu vào.conf), OSD (hiển thị thông tin với
thuộc tính), JSON IPC, API ứng dụng khách (libmpv), và chế độ nô lệ cổ điển.

đầu vào.conf
Tệp input.conf bao gồm danh sách các liên kết khóa, ví dụ:

s screenshot # chụp ảnh màn hình bằng phím s
LEFT seek 15 # ánh xạ phím mũi tên trái để tìm kiếm về phía trước trong 15 giây

Mỗi dòng ánh xạ một khóa cho một lệnh đầu vào. Các phím được chỉ định với giá trị theo nghĩa đen của chúng
(chữ hoa nếu kết hợp với sự thay đổi), hoặc tên cho các khóa đặc biệt. Ví dụ, a bản đồ tới
các a phím không cần shift, và A bản đồ tới a với ca làm việc.

Tệp nằm trong thư mục cấu hình mpv (thường ở
~ / .config / mpv / input.conf tùy thuộc vào nền tảng). Các ràng buộc mặc định được xác định ở đây:

https://github.com/mpv-player/mpv/blob/master/etc/input.conf

Danh sách các khóa đặc biệt có thể nhận được bằng
mpv --danh sách khóa đầu vào

Nói chung, các phím có thể được kết hợp với sự thay đổi, Ctrl và Khác:

ctrl + q thoát

mpv có thể được bắt đầu ở chế độ kiểm tra đầu vào, hiển thị các ràng buộc chính và các lệnh
chúng bị ràng buộc trên OSD, thay vì thực hiện các lệnh:

mpv --input-test --force-window --idle

(Chỉ đóng cửa sổ mới làm cho mpv thoát, nhấn các phím bình thường sẽ chỉ hiển thị
ràng buộc, ngay cả khi được ánh xạ để thoát.)

Tổng quan Đầu vào Lệnh cú pháp
[Shift +] [Ctrl +] [Alt +] [Meta +] [{ }] [ ] ( ) * [;
]

Lưu ý rằng theo mặc định, phím Alt bên phải có thể được sử dụng để tạo các ký tự đặc biệt, và do đó
không đăng ký như một bổ ngữ. Các tùy chọn --no-input-right-alt-gr thay đổi hành vi này.

Dòng mới luôn bắt đầu một ràng buộc mới. # bắt đầu một nhận xét (bên ngoài chuỗi được trích dẫn
tranh luận). Để ràng buộc các lệnh với # Chìa khóa, NHỌN có thể được sử dụng.

là ký tự chữ mà khóa tạo ra (ký tự ASCII hoặc Unicode), hoặc
tên tượng trưng (như được in bởi --danh sách khóa đầu vào).

(giằng co với { và }) là phần đầu vào cho lệnh này.

Các đối số được phân tách bằng khoảng trắng. Điều này áp dụng ngay cả với các đối số chuỗi. Đối với điều này
lý do, các đối số chuỗi phải được trích dẫn bằng ". Bên trong dấu ngoặc kép, thoát kiểu C có thể
đã sử dụng.

Bạn có thể liên kết nhiều lệnh với một phím. Ví dụ:
một show-text "lệnh 1"; show-text "lệnh 2"

Cũng có thể liên kết một lệnh với một chuỗi khóa:
abc show-text "lệnh chạy sau khi nhấn a, b, c"

(Điều này không được hiển thị trong cú pháp lệnh chung.)

If a or ab or b đã bị ràng buộc, điều này sẽ chạy lệnh đầu tiên phù hợp và
lệnh đa phím sẽ không bao giờ được gọi. Các khóa trung gian có thể được ánh xạ lại thành bỏ qua in
để tránh vấn đề này. Số lượng phím (không bổ trợ) tối đa cho các tổ hợp là
hiện 4.

Danh sách of Đầu vào Lệnh
bỏ qua Sử dụng điều này để "chặn" các khóa không được liên kết và không làm gì cả. Hữu ích cho
vô hiệu hóa các ràng buộc mặc định, mà không tắt tất cả các ràng buộc với
--no-input-default-ràng buộc.

tìm kiếm [tương đối | tuyệt đối | tuyệt đối-phần trăm | tương đối-phần trăm | chính xác | khung hình chính]
Thay đổi vị trí phát lại. Theo mặc định, tìm kiếm theo một lượng giây tương đối.

Đối số thứ hai bao gồm các cờ điều khiển chế độ tìm kiếm:

tương đối (Default)
Tìm kiếm so với vị trí hiện tại (giá trị âm tìm kiếm ngược lại).

tuyệt đối
Tìm kiếm một thời gian nhất định.

phần trăm tuyệt đối
Tìm kiếm một vị trí phần trăm nhất định.

phần trăm tương đối
Tìm kiếm so với vị trí hiện tại tính bằng phần trăm.

keyframe
Luôn bắt đầu phát lại ở ranh giới khung hình chính (nhanh).

chính xác Luôn tìm kiếm chính xác / giờ / chính xác (chậm).

Nhiều cờ có thể được kết hợp, ví dụ: khung hình chính + tuyệt đối.

Theo mặc định, keyframe được sử dụng cho các tìm kiếm tương đối, và chính xác được sử dụng cho tuyệt đối
tìm kiếm.

Trước mpv 0.9, keyframe và chính xác cờ phải được truyền dưới dạng tham số thứ 3
(về cơ bản là sử dụng khoảng trắng thay vì +). Tham số thứ 3 vẫn được phân tích cú pháp, nhưng
được coi là không dùng nữa.

hoàn nguyên tìm kiếm [chế độ]
Hoàn tác tìm kiếm lệnh và một số lệnh khác tìm kiếm (nhưng không nhất thiết là tất cả
của họ). Gọi lệnh này một lần sẽ chuyển đến vị trí phát lại trước
tìm kiếm. Gọi nó lần thứ hai sẽ hoàn tác hoàn nguyên tìm kiếm tự ra lệnh. Cái này chỉ
hoạt động trong một tệp duy nhất.

Đối số đầu tiên là tùy chọn và có thể thay đổi hành vi:

dấu Đánh dấu vị trí thời gian hiện tại. Bình thường tiếp theo hoàn nguyên tìm kiếm lệnh sẽ
tìm kiếm trở lại thời điểm này, bất kể có bao nhiêu tìm kiếm đã xảy ra kể từ lần trước.

Sử dụng nó mà không có bất kỳ đối số nào cung cấp cho bạn hành vi mặc định.

bước khung
Phát một khung hình, sau đó tạm dừng. Không có gì với phát lại chỉ âm thanh.

bước lùi khung
Quay lại từng khung hình, sau đó tạm dừng. Lưu ý rằng điều này có thể rất chậm (nó cố gắng
chính xác, không nhanh), và đôi khi không hoạt động như mong đợi. Điều này hoạt động tốt như thế nào
phụ thuộc vào việc tìm kiếm chính xác có hoạt động chính xác hay không (ví dụ: xem
--hr-seek-demuxer-offset quyền mua). Bộ lọc video hoặc xử lý hậu kỳ video khác
sửa đổi thời gian của khung hình (ví dụ như khử xen kẽ) thường sẽ hoạt động, nhưng có thể làm
backstepping âm thầm hành xử không chính xác trong các trường hợp góc. Sử dụng
--hr-seek-framedrop = không sẽ hữu ích, mặc dù nó có thể làm cho việc tìm kiếm chính xác chậm hơn.

Điều này không hoạt động với phát lại chỉ có âm thanh.

định
Đặt thuộc tính đã cho thành giá trị đã cho.

thêm vào [ ]
Thêm giá trị đã cho vào thuộc tính. Trên dòng chảy tràn hoặc dòng chảy dưới, hãy kẹp thuộc tính
ở mức tối đa. Nếu được bỏ qua, giả sử 1.

chu kỳ [lên | xuống]
Chu kỳ thuộc tính đã cho. up và xuống thiết lập hướng chu kỳ. Trên phần tràn, hãy đặt
thuộc tính trở lại mức tối thiểu, trên quy trình dưới đặt nó ở mức tối đa. Nếu up or xuống is
bỏ qua, giả sử up.

nhân
Nhân giá trị của thuộc tính với hệ số.

ảnh chụp màn hình [phụ đề | video | cửa sổ | - [đơn | mỗi khung]]
Chụp màn hình.

Đối số đầu tiên:

(Default)
Lưu hình ảnh video ở độ phân giải gốc và có phụ đề. Một số
đầu ra video vẫn có thể bao gồm OSD trong đầu ra theo một số
hoàn cảnh.


Như phụ đề, nhưng thường không có OSD hoặc phụ đề. Hành vi chính xác
phụ thuộc vào đầu ra video đã chọn.


Lưu nội dung của cửa sổ mpv. Thường được chia tỷ lệ, với OSD và
phụ đề. Hành vi chính xác phụ thuộc vào đầu ra video đã chọn và nếu
không có sẵn hỗ trợ, điều này sẽ hoạt động như thế nào video.


Chụp ảnh màn hình từng khung hình. Ra lệnh này một lần nữa để ngừng sử dụng
ảnh chụp màn hình. Lưu ý rằng bạn nên tắt chức năng giảm khung hình khi sử dụng tính năng này
chế độ - hoặc bạn có thể nhận được hình ảnh trùng lặp trong trường hợp khung hình
giảm. Cờ này có thể được kết hợp với các cờ khác, ví dụ
video + từng khung hình.

ảnh chụp màn hình thành tệp [phụ đề | video | cửa sổ]
Chụp ảnh màn hình và lưu nó vào một tệp nhất định. Định dạng của tệp sẽ là
đoán bởi phần mở rộng (và - định dạng ảnh chụp màn hình bị bỏ qua - hành vi khi
phần mở rộng bị thiếu hoặc không xác định là tùy ý).

Đối số thứ hai giống như đối số đầu tiên ảnh chụp màn hình.

Nếu tệp đã tồn tại, nó sẽ bị ghi đè.

Giống như tất cả các tham số lệnh đầu vào, tên tệp có thể mở rộng thuộc tính như
diễn tả cái Bất động sản Sự bành trướng.

danh sách phát-tiếp theo [yếu | lực]
Chuyển đến mục tiếp theo trên danh sách phát.

yếu (Default)
Nếu tệp cuối cùng trong danh sách phát hiện đang được phát, bạn không cần làm gì.

lực lượng Chấm dứt phát lại nếu không còn tệp nào trên danh sách phát.

danh sách phát-trước [yếu | lực]
Chuyển đến mục nhập trước trên danh sách phát.

yếu (Default)
Nếu tệp đầu tiên trong danh sách phát hiện đang được phát, bạn không cần làm gì cả.

lực lượng Chấm dứt phát lại nếu tệp đầu tiên đang được phát.

tải tập tin [Replace | append | append-play [tùy chọn]]
Tải tệp đã cho và chơi nó.

Đối số thứ hai:

(Default)
Dừng phát lại tệp hiện tại và phát tệp mới ngay lập tức.


Nối tệp vào danh sách phát.


Nối tệp và nếu không có gì hiện đang phát, hãy bắt đầu phát lại.
(Luôn bắt đầu với tệp đã thêm, ngay cả khi danh sách phát không trống
trước khi chạy lệnh này.)

Đối số thứ ba là danh sách các tùy chọn và giá trị sẽ được đặt trong khi
tệp đang phát. Nó có dạng opt1 = value1, opt2 = value2, ... Không phải tất cả các tùy chọn đều có thể
được thay đổi theo cách này. Một số tùy chọn yêu cầu khởi động lại trình phát.

danh sách tải [thay thế | nối thêm]
Tải tệp danh sách phát đã cho (như - danh sách chơi).

danh sách phát rõ ràng
Xóa danh sách phát, ngoại trừ tệp hiện đang phát.

danh sách phát-loại bỏ hiện tại |
Xóa mục nhập danh sách phát ở chỉ mục đã cho. Giá trị chỉ mục bắt đầu đếm bằng 0.
Giá trị đặc biệt hiện hành xóa mục nhập hiện tại. Lưu ý rằng loại bỏ hiện tại
mục nhập cũng dừng phát lại và bắt đầu phát mục tiếp theo.

danh sách phát-di chuyển
Di chuyển mục nhập danh sách phát tại index1, để nó thay thế cho mục nhập index2.
(Nghịch lý là mục nhập danh sách phát đã di chuyển sẽ không có giá trị chỉ mục index2 sau
di chuyển nếu index1 thấp hơn index2, vì index2 đề cập đến mục nhập mục tiêu,
không phải là chỉ mục mà mục nhập sẽ có sau khi di chuyển.)

danh sách phát ngẫu nhiên
Phát ngẫu nhiên danh sách phát. Điều này tương tự như những gì được thực hiện khi bắt đầu nếu --luffle
tùy chọn được sử dụng.

chạy lệnh arg1 arg2 ...
Chạy lệnh đã cho. Không giống như trong MPlayer / mplayer2 và các phiên bản mpv trước đó
(0.2.x trở lên), điều này không gọi là shell. Thay vào đó, lệnh được chạy
trực tiếp, với mỗi đối số được truyền riêng biệt. Mỗi đối số được mở rộng như trong
Bất động sản Sự bành trướng. Lưu ý rằng có một giới hạn tĩnh là (tính đến thời điểm viết bài này) 9
đối số (giới hạn này có thể được nâng lên theo yêu cầu).

Chương trình được chạy theo cách tách rời. mpv không đợi cho đến khi lệnh được
đã hoàn thành, nhưng vẫn tiếp tục phát lại ngay sau khi tạo nó.

Để có được hành vi cũ, hãy sử dụng / Bin / sh và -c như hai đối số đầu tiên.

Ví dụ

chạy "/ Bin / sh" "-NS" "tiếng vang $ {title} > / tmp / đang phát "

Đây không phải là một ví dụ đặc biệt tốt, vì nó không xử lý
thoát và một tệp được chuẩn bị đặc biệt có thể cho phép kẻ tấn công
thực hiện các lệnh shell tùy ý. Nó được khuyến khích để viết một
shell script và gọi nó bằng chạy.

bỏ thuốc lá [ ]
Thoát trình phát. Nếu một đối số được đưa ra, nó được sử dụng làm mã thoát quy trình.

bỏ-xem-sau [ ]
Thoát trình phát và lưu trữ vị trí phát hiện tại. Phát tệp đó sau này sẽ tìm kiếm
đến vị trí trước đó khi bắt đầu. Đối số (tùy chọn) chính xác như trong
bỏ thuốc lá chỉ huy.

phụ thêm [ [ [ ]]]
Tải tệp phụ đề đã cho. Nó được chọn làm phụ đề hiện tại sau khi tải.

cờ args là một trong các giá trị sau:


Chọn phụ đề ngay lập tức.


Không chọn phụ đề. (Hoặc trong một số tình huống đặc biệt, hãy để mặc định
cơ chế lựa chọn luồng quyết định.)


Chọn phụ đề. Nếu một phụ đề có cùng tên tệp đã được thêm vào,
cái đó được chọn, thay vì tải một mục nhập trùng lặp. (Trong trường hợp này,
tiêu đề / ngôn ngữ bị bỏ qua và nếu nó đã được thay đổi kể từ khi nó được tải, những
các thay đổi sẽ không được phản ánh.)

tiêu đề đối số đặt tiêu đề bản nhạc trong giao diện người dùng.

lang đối số đặt ngôn ngữ bản nhạc và cũng có thể ảnh hưởng đến việc lựa chọn luồng
với cờ đặt thành tự động.

loại bỏ phụ [ ]
Xóa phụ đề đã cho. Nếu id đối số bị thiếu, loại bỏ đối số hiện tại
theo dõi. (Chỉ hoạt động trên các tệp phụ đề bên ngoài.)

tải lại phụ [ ]
Tải lại các phụ đề đã cho. Nếu id đối số bị thiếu, tải lại hiện tại
theo dõi. (Chỉ hoạt động trên các tệp phụ đề bên ngoài.)

Điều này hoạt động bằng cách dỡ bỏ và thêm lại phụ đề.

bước phụ
Thay đổi thời gian của phụ đề sao cho sự kiện phụ đề sau sự kiện tiếp theo phụ đề
các sự kiện được hiển thị. có thể tiêu cực để lùi bước.

tìm kiếm phụ
Tìm kiếm phụ đề tiếp theo (bỏ qua đặt thành 1) hoặc phụ đề trước đó (bỏ qua đặt thành -1). Đây
tương tự như bước phụ, ngoại trừ việc nó tìm kiếm video và âm thanh thay vì điều chỉnh
sự chậm trễ của phụ đề.

Đối với phụ đề được nhúng (như với Matroska), điều này chỉ hoạt động với các sự kiện phụ đề
đã được hiển thị hoặc nằm trong phạm vi tìm nạp trước ngắn.

osd [ ]
Chuyển đổi mức OSD. Nếu được chỉ định, đặt chế độ OSD (xem - cấposd cho
giá trị hợp lệ).

văn bản in
In văn bản ra stdout. Chuỗi có thể chứa các thuộc tính (xem Bất động sản Sự bành trướng).

hiển thị văn bản [ | - [ ]]
Hiển thị văn bản trên OSD. Chuỗi có thể chứa các thuộc tính, được mở rộng như
diễn tả cái Bất động sản Sự bành trướng. Điều này có thể được sử dụng để hiển thị thời gian phát lại, tên tệp,
và như vậy.


Thời gian tính bằng mili giây để hiển thị thông báo cho. Theo mặc định, nó sử dụng cùng một giá trị
as --osd-thời lượng.


Mức OSD tối thiểu để hiển thị văn bản tại (xem - cấposd).

trình diễn
Hiển thị thanh tiến trình, thời gian đã trôi qua và tổng thời lượng của tệp trên
OSD.

ghi-xem-sau-config
Viết tệp cấu hình sơ yếu lý lịch mà bỏ-xem-sau lệnh ghi, nhưng vẫn tiếp tục
phát lại bình thường.

dừng lại Dừng phát lại và xóa danh sách phát. Với cài đặt mặc định, điều này về cơ bản giống như
bỏ thuốc lá. Hữu ích cho API máy khách: có thể dừng phát lại mà không chấm dứt
người chơi.

chuột [ [đơn | đôi]]
Gửi một sự kiện chuột với tọa độ đã cho (, ).

Đối số thứ hai:


Số nút của nút chuột đã nhấp. Đây phải là một trong số 0-19. Nếu
bị bỏ qua, chỉ vị trí sẽ được cập nhật.

Đối số thứ ba:

(Default)
Sự kiện chuột đại diện cho một cú nhấp chuột thông thường.


Sự kiện chuột đại diện cho nhấp đúp.

phím bấm
Gửi một sự kiện quan trọng thông qua trình xử lý đầu vào của mpv, kích hoạt bất kỳ hành vi nào
được định cấu hình cho khóa đó. key_name sử dụng đầu vào.conf lược đồ đặt tên cho các khóa và
bổ ngữ. Hữu ích cho API máy khách: các sự kiện chính có thể được gửi đến libmpv để xử lý
nội bộ

bàn phím
Tương tự như phím bấm, nhưng đặt TỪ KHÓA gắn cờ để nếu khóa được liên kết với
lệnh có thể lặp lại, nó sẽ được chạy lặp lại với thời gian lặp lại phím của mpv cho đến khi
các bàn phím lệnh được gọi.

bàn phím [ ]
Đặt KHÓA gắn cờ, dừng bất kỳ hành vi lặp lại nào đã được kích hoạt.
key_name Là tùy chọn. Nếu như key_name không được cung cấp hoặc là một chuỗi trống, KHÓA sẽ được
thiết lập trên tất cả các phím. Nếu không thì, KHÓA sẽ chỉ được đặt trên khóa được chỉ định bởi
key_name.

thêm âm thanh [ [ [ ]]]
Tải tệp âm thanh đã cho. Nhìn thấy phụ thêm chỉ huy.

loại bỏ âm thanh [ ]
Xóa đoạn âm thanh đã cho. Nhìn thấy loại bỏ phụ chỉ huy.

tải lại âm thanh [ ]
Tải lại các bản âm thanh đã cho. Nhìn thấy tải lại phụ chỉ huy.

quét lại-bên ngoài-tệp [ ]
Quét lại các tệp bên ngoài theo hiện tại - sub-auto và --audio-tệp-tự động
cài đặt. Điều này có thể được sử dụng để tự động tải các tệp bên ngoài sau khi tệp đã được tải.

chế độ đối số là một trong những điều sau:

(Default)
Chọn các luồng phụ đề và âm thanh mặc định, các luồng này thường chọn
các tệp bên ngoài với ưu tiên cao nhất. (Việc triển khai không hoàn hảo,
và có thể được cải thiện theo yêu cầu.)


Không thay đổi lựa chọn bản nhạc hiện tại.

Đầu vào Lệnh việc này đang Có thể Tiêu Đề đến Thay đổi
af thiết lập | thêm | chuyển đổi | del | clr filter1 = params, filter2, ...
Thay đổi chuỗi bộ lọc âm thanh. Nhìn thấy vf chỉ huy.

vf thiết lập | thêm | chuyển đổi | del | clr filter1 = params, filter2, ...
Thay đổi chuỗi bộ lọc video.

Đối số đầu tiên quyết định điều gì sẽ xảy ra:

định Ghi đè chuỗi bộ lọc trước đó bằng chuỗi bộ lọc mới.

thêm vào Nối chuỗi bộ lọc mới với chuỗi bộ lọc trước đó.

bật lên Kiểm tra xem bộ lọc đã cho (với các thông số chính xác) đã có trong
chuỗi video. Nếu có, hãy loại bỏ bộ lọc. Nếu không, hãy thêm bộ lọc. (Nếu nhiều
bộ lọc được chuyển cho lệnh, điều này được thực hiện cho mỗi bộ lọc.)

các Xóa các bộ lọc đã cho khỏi chuỗi video. Không giống như những trường hợp khác,
tham số thứ hai là danh sách tên bộ lọc hoặc số nguyên được phân tách bằng dấu phẩy
các chỉ mục. 0 sẽ biểu thị bộ lọc đầu tiên. Chỉ mục phủ định bắt đầu từ
bộ lọc cuối cùng và -1 biểu thị bộ lọc cuối cùng.

clr Loại bỏ tất cả các bộ lọc. Lưu ý rằng giống như các lệnh con khác, lệnh này không
kiểm soát các bộ lọc được chèn tự động.

Bạn có thể gán nhãn để lọc bằng cách thêm @Tên: (Ở đâu tên là một
định danh tùy ý do người dùng chọn). Nhãn có thể được sử dụng để tham chiếu đến các bộ lọc theo tên
trong tất cả các lệnh sửa đổi chuỗi bộ lọc. Vì thêm vào, sử dụng một đã được sử dụng
nhãn sẽ thay thế bộ lọc hiện có.

vf lệnh hiển thị danh sách các bộ lọc được yêu cầu trên OSD sau khi thay đổi
chuỗi bộ lọc. Điều này gần tương đương với hiển thị văn bản $ {vf}. Lưu ý rằng
các bộ lọc được chèn tự động để chuyển đổi định dạng không được hiển thị trên danh sách, chỉ những gì
đã được yêu cầu bởi người dùng.

Thông thường, các lệnh sẽ kiểm tra xem chuỗi video có được tạo lại hay không
thành công và sẽ hoàn tác thao tác khi không thành công. Nếu lệnh được chạy trước
video được định cấu hình (có thể xảy ra nếu lệnh được chạy ngay sau khi mở
và trước khi giải mã khung video), không thể chạy kiểm tra này. Sau đó, nó có thể
xảy ra việc tạo chuỗi video không thành công.

Ví dụ cho input.conf

· a vf định lật lật ngược video trên a chính

· b vf định "" loại bỏ tất cả các bộ lọc video trên b

· c vf bật lên lavfi = gradfun bật tắt từ bỏ c

giá trị chu kỳ ["!đảo ngược"] ...
Lướt qua một danh sách các giá trị. Mỗi lần gọi lệnh sẽ thiết lập
thuộc tính giá trị tiếp theo trong danh sách. Lệnh duy trì một bộ đếm bên trong
giá trị nào để chọn tiếp theo và giá trị nào ban đầu là 0. Nó được đặt lại về 0 sau lần cuối cùng
đạt được giá trị.

Bộ đếm nội bộ được liên kết bằng cách sử dụng tên thuộc tính và danh sách giá trị. Nếu
nhiều lệnh (liên kết với các khóa khác nhau) sử dụng cùng một tên và danh sách giá trị, chúng
sẽ chia sẻ bộ đếm nội bộ.

Đối số đặc biệt !đảo ngược có thể được sử dụng để đảo ngược danh sách giá trị.
So với lệnh chỉ liệt kê ngược lại giá trị, lệnh này sẽ
thực sự chia sẻ bộ đếm bên trong với ràng buộc khóa tua đi (miễn là
vì phần còn lại của các đối số giống nhau).

Lưu ý rằng có giới hạn tĩnh là (tính đến thời điểm viết bài này) 10 đối số (giới hạn này
có thể được nâng lên theo yêu cầu).

phần kích hoạt [cờ]
Bật tất cả các ràng buộc chính trong phần đầu vào được đặt tên.

Các phần đầu vào được kích hoạt tạo thành một ngăn xếp. Ràng buộc trong các phần trên đầu
ngăn xếp được ưu tiên hơn các phần thấp hơn. Lệnh này đặt phần trên đầu trang của
cây rơm. Nếu phần đã có trên ngăn xếp, nó sẽ bị loại bỏ hoàn toàn
Tới trước. (Một phần không thể nằm trên ngăn xếp nhiều hơn một lần.)

cờ tham số có thể là một tổ hợp (được phân tách bằng +) trong số các cờ sau:


Tất cả các phần được bật trước khi phần mới được bật đều bị vô hiệu hóa. Họ
sẽ được bật lại ngay sau khi tất cả các phần độc quyền ở trên chúng bị xóa.
Nói cách khác, phần mới đổ bóng tất cả các phần trước đó.


Không thể sử dụng tính năng này thông qua API công khai.


Tương tự.

phần vô hiệu hóa
Tắt phần đầu vào được đặt tên. Hoàn tác phần kích hoạt.

phần xác định [mặc định | bắt buộc]
Tạo phần đầu vào được đặt tên hoặc thay thế nội dung của phần đầu vào đã có
phần. Các nội dung tham số sử dụng cùng một cú pháp với đầu vào.conf tập tin (ngoại trừ
rằng việc sử dụng cú pháp phần trong đó là không được phép), bao gồm cả sự cần thiết phải tách
ràng buộc với một ký tự dòng mới.

Nếu nội dung tham số là một chuỗi rỗng, phần bị loại bỏ.

Phần có tên mặc định là phần nhập thông thường.

Nói chung, các phần đầu vào phải được bật với phần kích hoạt lệnh, hoặc
chúng bị bỏ qua.

Tham số cuối cùng có ý nghĩa sau:

(cũng thế đã sử dụng if tham số bỏ qua)
Chỉ sử dụng ràng buộc khóa được xác định bởi phần này nếu người dùng chưa sử dụng
liên kết phím này với một lệnh.


Luôn ràng buộc một khóa. (Phần đầu vào được kích hoạt gần đây nhất
thắng nếu có sự mơ hồ.)

lớp phủ-thêm
Thêm lớp phủ OSD có nguồn gốc từ dữ liệu thô. Điều này có thể hữu ích cho các tập lệnh và
các ứng dụng điều khiển mpv và muốn hiển thị mọi thứ trên đầu video
cửa sổ.

Lớp phủ thường được hiển thị ở độ phân giải màn hình, nhưng với một số VO,
độ phân giải được giảm xuống độ phân giải của video. Bạn có thể đọc chiều rộng osd và
chiều cao osd đặc tính. Ít nhất với --vo-xv và video anamorphic (chẳng hạn như DVD),
osd-par cũng nên được đọc và lớp phủ phải được bù đắp theo khía cạnh.
(Định hướng trong tương lai: có lẽ mpv nên lo mấy việc này
tự động, nhưng thật khó để biết vị trí vẽ đường thẳng.)

id là một số nguyên từ 0 đến 63 xác định phần tử lớp phủ. ID có thể là
được sử dụng để thêm nhiều phần lớp phủ, cập nhật một phần bằng cách sử dụng lệnh này với một
ID đã tồn tại hoặc để xóa một phần với loại bỏ lớp phủ. Sử dụng trước đây
ID không sử dụng sẽ thêm một lớp phủ mới, trong khi việc sử dụng lại ID sẽ cập nhật nó. (Tương lai
hướng dẫn: cần có một cái gì đó để đảm bảo các chương trình khác nhau muốn
tạo các lớp phủ không xung đột với nhau, nếu cần thiết.)

x và y chỉ định vị trí nơi OSD sẽ được hiển thị.

hồ sơ chỉ định tệp mà dữ liệu hình ảnh thô được đọc từ đó. Nó có thể là một số
Bộ mô tả tệp UNIX có tiền tố là @ (ví dụ @4), hoặc tên tệp. Tệp sẽ được
ánh xạ vào bộ nhớ với mmap (). Một số VO sẽ chuyển trực tiếp con trỏ được ánh xạ tới
hiển thị các API (ví dụ: opengl hoặc vdpau), vì vậy không có quá trình sao chép thực tế nào được thực hiện. Cắt bớt
tệp nguồn trong khi lớp phủ đang hoạt động sẽ làm hỏng trình phát. Bạn không nên
thay đổi dữ liệu trong khi lớp phủ đang hoạt động, vì dữ liệu về cơ bản là
được truy cập tại các điểm ngẫu nhiên. Thay vào đó, hãy gọi lớp phủ-thêm một lần nữa (tốt nhất là với một
vùng nhớ khác nhau để ngăn chặn xé).

Cũng có thể chuyển một địa chỉ bộ nhớ thô để sử dụng làm bộ nhớ bitmap bằng cách
chuyển địa chỉ bộ nhớ dưới dạng số nguyên có tiền tố là & tính cách. Vượt qua
điều sai ở đây sẽ làm hỏng máy nghe nhạc. Chế độ này có thể hữu ích để sử dụng với
libmpv. Các bù đắp tham số chỉ được thêm vào địa chỉ bộ nhớ (vì mpv
0.8.0, bỏ qua trước đó).

bù đắp là độ lệch byte của pixel đầu tiên trong tệp nguồn. (Hiện tại
luôn luôn thực hiện mmap là toàn bộ tệp từ vị trí 0 đến cuối tệp
hình ảnh, vì vậy nên tránh các hiệu số lớn. Trước mpv 0.8.0, phần bù là
thực sự được chuyển trực tiếp đến mmap, nhưng nó đã được thay đổi để giúp việc sử dụng dễ dàng hơn.)

fmt là một chuỗi xác định định dạng hình ảnh. Hiện tại, chỉ bgra được định nghĩa. Đây
định dạng có 4 byte trên mỗi pixel, với 8 bit trên mỗi thành phần. Ít có ý nghĩa nhất 8
các bit có màu xanh lam và 8 bit quan trọng nhất là alpha (trong số ít endian,
các thành phần là BGRA, với B là byte đầu tiên). Điều này sử dụng alpha được nhân tạo trước: mọi
thành phần màu đã được nhân với thành phần alpha. Điều này có nghĩa là
giá trị số của mỗi thành phần bằng hoặc nhỏ hơn thành phần alpha.
(Vi phạm quy tắc này sẽ dẫn đến các kết quả khác nhau với các VO khác nhau: số
tràn do kết hợp các giá trị alpha bị hỏng được coi là thứ gì đó
sẽ không xảy ra và do đó việc triển khai không đảm bảo rằng bạn nhận được
hành vi có thể dự đoán được trong trường hợp này.)

w, hvà stride chỉ định kích thước của lớp phủ. w là chiều rộng có thể nhìn thấy của
lớp phủ, trong khi stride cung cấp chiều rộng tính bằng byte trong bộ nhớ. Trong trường hợp đơn giản, và
với bgra định dạng, sải bước == 4 * w. Nói chung, tổng dung lượng bộ nhớ được truy cập
is stride * h. (Về mặt kỹ thuật, kích thước tối thiểu sẽ là stride * (h - 1) + w * 4,
nhưng vì đơn giản, người chơi sẽ truy cập tất cả stride * h byte.)

Cảnh báo

Khi cập nhật lớp phủ, bạn nên chuẩn bị một bộ nhớ dùng chung thứ hai
vùng (ví dụ: sử dụng tham số offset) và thêm nó làm lớp phủ,
thay vì sử dụng lại cùng một bộ nhớ mỗi lần. Nếu không, bạn có thể nhận được
tương đương với việc xé, khi ứng dụng của bạn và mpv viết / đọc
đệm cùng một lúc. Ngoài ra, hãy nhớ rằng mpv có thể truy cập vào một
bộ nhớ của lớp phủ vào những thời điểm ngẫu nhiên bất cứ khi nào nó cảm thấy cần phải làm như vậy, vì
ví dụ khi vẽ lại màn hình.

loại bỏ lớp phủ
Xóa lớp phủ đã thêm lớp phủ-thêm và cùng một ID. Không có gì nếu không
lớp phủ với ID này tồn tại.

script-tin nhắn ...
Gửi tin nhắn đến tất cả các máy khách và chuyển nó vào danh sách các đối số sau đây. Gì
thông báo này có nghĩa là, nó cần bao nhiêu đối số và ý nghĩa của các đối số là
hoàn toàn phụ thuộc vào người nhận và người gửi. Mọi khách hàng đều nhận được tin nhắn, vì vậy hãy
cẩn thận về xung đột tên (hoặc sử dụng script_message_to).

script-tin nhắn-đến ...
Giống như script_message, nhưng chỉ gửi nó cho khách hàng có tên . Mỗi khách hàng
(tập lệnh, v.v.) có một tên duy nhất. Ví dụ: các tập lệnh Lua có thể lấy tên của chúng qua
mp.get_script_name ().

script-ràng buộc
Gọi một ràng buộc khóa do tập lệnh cung cấp. Điều này có thể được sử dụng để ánh xạ lại các ràng buộc khóa
được cung cấp bởi các tập lệnh Lua bên ngoài.

Đối số là tên của ràng buộc.

Nó có thể được tùy chọn bắt đầu bằng tên của tập lệnh, bằng cách sử dụng / như dấu phân cách,
ví dụ script_bind scriptname / bindingname.

Để hoàn thiện, đây là cách lệnh này hoạt động bên trong. Các chi tiết có thể
thay đổi bất kỳ lúc nào. Trên bất kỳ sự kiện quan trọng phù hợp nào, script_message_to or script_message is
được gọi (tùy thuộc vào tên tập lệnh có được bao gồm hay không), trong đó đối số đầu tiên
là chuỗi Ràng buộc chính, đối số thứ hai là tên của ràng buộc và
đối số thứ ba là trạng thái khóa dưới dạng chuỗi. Trạng thái quan trọng bao gồm một số
bức thư. Chữ cái đầu tiên là một trong số d (phím đã được nhấn xuống), u (đã được phát hành), r
(phím vẫn không hoạt động và được lặp lại; chỉ khi tính năng lặp lại phím được bật cho việc này
ràng buộc), p (phím đã được nhấn; xảy ra nếu không thể theo dõi lên / xuống). Thư hai
viết thư cho dù sự kiện có bắt nguồn từ chuột hay không m (nút chuột) hoặc -
(thứ gì khác).

vòng lặp ab
Chu kỳ qua các trạng thái vòng AB. Lệnh đầu tiên sẽ thiết lập A điểm (cái
ab-loop-a tài sản); thứ hai B điểm, và thứ ba sẽ xóa cả hai điểm.

vo-cmdline
Đặt lại tùy chọn phụ của VO hiện tại. Hiện đang hoạt động với OpenGL (Bao gồm cả
opengl-hq). Đối số là chuỗi tùy chọn phụ thường được chuyển đến VO trên
dòng lệnh. Không phải tất cả các tùy chọn phụ đều có thể được đặt, nhưng những tùy chọn có thể được đặt lại
ngay cả khi chúng không xuất hiện trong đối số. Lệnh này có thể được thay đổi hoặc
bị loại bỏ trong tương lai.

bộ đệm thả
Thả bộ đệm âm thanh / video / demuxer và khởi động lại từ mới. Có thể giúp đỡ với
các luồng không thể nhìn thấy đang không đồng bộ. Lệnh này có thể được thay đổi hoặc
bị loại bỏ trong tương lai.

ảnh chụp màn hình thô [phụ đề | video | cửa sổ]
Trả lại ảnh chụp màn hình trong bộ nhớ. Điều này chỉ có thể được sử dụng thông qua API ứng dụng khách. Các
MPV_FORMAT_NODE_MAP được trả về bởi lệnh này có w, h, stride các trường được đặt thành
nội dung rõ ràng. Một định dạng trường được đặt thành bgr0 theo mặc định. Định dạng này là
được tổ chức như B8G8R8X8 (Ở đâu B là LSB). Nội dung của phần đệm X is
chưa xác định. Các dữ liệu trường thuộc loại MPV_FORMAT_BYTE_ARRAY với hình ảnh thực tế
dữ liệu. Hình ảnh được giải phóng ngay sau khi nút kết quả được giải phóng.

Lệnh không có tài liệu: tv-kênh cuối cùng (Chỉ TV / DVB), ao-tải lại (thử nghiệm / nội bộ).

Hooks
Hook là các sự kiện đồng bộ giữa lõi trình phát và một tập lệnh hoặc tương tự. Điều này áp dụng cho
API ứng dụng khách (bao gồm cả giao diện kịch bản Lua). Thông thường, các sự kiện được cho là
không đồng bộ và API hook cung cấp một cách xử lý các sự kiện khó hiểu và khó hiểu
yêu cầu sự phối hợp chặt chẽ hơn. Không có đảm bảo về độ ổn định API được thực hiện. Không tuân theo
giao thức chính xác có thể làm cho người chơi bị đóng băng ngẫu nhiên. Về cơ bản, không ai nên sử dụng
API này.

Có hai lệnh đặc biệt liên quan. Ngoài ra, khách hàng phải lắng nghe các thông điệp của khách hàng
(MPV_EVENT_CLIENT_MESSAGE trong API C).

móc-thêm
Theo dõi móc được xác định bởi đối số đầu tiên (về cơ bản, tên của
Sự kiện). Các id đối số là một số nguyên tùy ý do người dùng chọn. ưu tiên is
được sử dụng để sắp xếp tất cả các trình xử lý móc trên toàn cầu trên tất cả các máy khách. Mỗi khách hàng có thể
đăng ký nhiều trình xử lý móc (ngay cả cho cùng một tên móc). Một khi móc được
đã đăng ký, nó không thể được hủy đăng ký.

Khi một sự kiện cụ thể xảy ra, tất cả các trình xử lý đã đăng ký sẽ được chạy nối tiếp. Điều này sử dụng
một giao thức mà mọi khách hàng phải tuân theo một cách rõ ràng. Khi một trình xử lý móc câu được chạy, một
tin nhắn khách hàng (MPV_EVENT_CLIENT_MESSAGE) được gửi đến khách hàng đã đăng ký
cái móc. Thông báo này có các đối số sau:

1. chuỗi hook_run

2. các id đối số hook đã được đăng ký dưới dạng chuỗi (điều này có thể được sử dụng để
xử lý chính xác nhiều hook được đăng ký bởi cùng một ứng dụng khách, miễn là id
đối số là duy nhất trong máy khách)

3. một cái gì đó không xác định, được sử dụng bởi cơ chế hook để theo dõi việc thực thi hook
(hiện tại, đó là tên móc, nhưng điều này có thể thay đổi mà không có cảnh báo)

Khi nhận được thông báo này, khách hàng có thể xử lý sự kiện. Trong khi làm điều này,
lõi trình phát sẽ vẫn phản ứng với các yêu cầu, nhưng quá trình phát lại thường sẽ bị dừng.

Khi máy khách hoàn tất, nó phải tiếp tục thực thi hook của lõi bằng cách chạy
móc túi chỉ huy.

móc túi
Chạy hook tiếp theo trong chuỗi hook toàn cầu. Đối số là đối số thứ 3 của
thông báo máy khách bắt đầu thực thi hook cho máy khách hiện tại.

Các móc sau hiện được xác định:

đang tải
Được gọi khi một tệp được mở, trước khi mọi thứ thực sự được thực hiện. Ví dụ,
bạn có thể đọc và viết luồng-mở-tên-tệp thuộc tính để chuyển hướng một URL đến
thứ gì đó khác (xem xét hỗ trợ cho các trang web phát trực tuyến hiếm khi cung cấp cho người dùng
URL phương tiện trực tiếp) hoặc bạn có thể đặt các tùy chọn cho mỗi tệp bằng cách đặt thuộc tính
file-local-options / tên>. Người chơi sẽ đợi cho đến khi tất cả các móc được chạy.

on_unload
Chạy trước khi đóng tệp và trước khi thực sự hủy khởi tạo mọi thứ. Nó không thể
có thể tiếp tục phát lại ở trạng thái này.

Đầu vào Lệnh Tiền tố
Các tiền tố này được đặt giữa tên khóa và lệnh thực. Nhiều tiền tố có thể
được chỉ định. Chúng được ngăn cách bởi khoảng trắng.

osd-tự động (Default)
Sử dụng hành vi mặc định cho lệnh này.

không có osd Không sử dụng bất kỳ OSD nào cho lệnh này.

thanh osd
Nếu có thể, hãy hiển thị một thanh có lệnh này. Tìm kiếm lệnh sẽ hiển thị tiến trình
thanh, các lệnh thay đổi thuộc tính có thể hiển thị giá trị mới đặt.

osd-tin nhắn
Nếu có thể, hãy hiển thị thông báo OSD bằng lệnh này. Tìm kiếm lệnh hiển thị hiện tại
thời gian phát lại, các lệnh thay đổi thuộc tính hiển thị giá trị mới đặt dưới dạng văn bản.

osd-msg-bar
Kết hợp osd-bar và osd-msg.

nguyên Không mở rộng thuộc tính trong đối số chuỗi. (Giống "$ {property-name}".)

mở rộng thuộc tính (Default)
Tất cả các đối số chuỗi được mở rộng như được mô tả trong Bất động sản Sự bành trướng.

có thể lặp lại
Đối với một số lệnh, việc nhấn một phím sẽ không chạy lệnh lặp lại. Đây
tiền tố buộc cho phép lặp lại phím trong mọi trường hợp.

Tất cả các tiền tố osd vẫn bị toàn cầu ghi đè - cấposd cài đặt.

Đầu vào Mục
Các phần đầu vào nhóm một tập hợp các ràng buộc và bật hoặc tắt chúng cùng một lúc. Trong
đầu vào.conf, mỗi liên kết khóa được gán cho một phần đầu vào, thay vì thực sự có
phần văn bản rõ ràng.

Cũng thấy kích hoạt_section và vô hiệu hóa lệnh.

Các ràng buộc được xác định trước:

mặc định
Các ràng buộc không có phần đầu vào được gán ngầm cho phần này. Nó là
được bật theo mặc định trong khi phát lại bình thường.

mã hóa Phần đang hoạt động trong chế độ mã hóa. Nó được kích hoạt độc quyền, vì vậy
ràng buộc trong mặc định các phần bị bỏ qua.

Bất động sản
Thuộc tính được sử dụng để đặt các tùy chọn mpv trong thời gian chạy hoặc để truy vấn thông tin tùy ý.
Chúng có thể được điều khiển với định/thêm vào/chu kỳ các lệnh và được truy xuất bằng hiển thị văn bản, hoặc là
bất kỳ thứ gì khác sử dụng mở rộng thuộc tính. (Nhìn thấy Bất động sản Sự bành trướng.)

Tên thuộc tính được chú thích bằng RW để cho biết thuộc tính nói chung
có thể ghi được.

Nếu một tùy chọn được tham chiếu, thuộc tính thường sẽ nhận / trả về chính xác các giá trị giống nhau
như một tùy chọn. Trong những trường hợp này, thuộc tính chỉ là một cách để thay đổi một tùy chọn trong thời gian chạy.

Bất động sản
cấp độ osd (RW)
Xem - cấposd.

thang đo osd (RW)
Hệ số kích thước phông chữ OSD, xem --osd-quy mô.

vòng lặp (RW)
Xem --vòng.

tệp vòng lặp (RW)
Xem --tập tin vòng lặp (sử dụng Vâng/Không).

tốc độ (RW)
Xem --tốc độ, vận tốc.

hiệu chỉnh tốc độ âm thanh, chỉnh sửa tốc độ video
Hệ số nhân với tốc độ tại đó người chơi cố gắng phát tệp. Thường xuyên
nó chính xác là 1. (Chế độ đồng bộ hóa hiển thị sẽ làm cho điều này hữu ích.)

Định dạng OSD sẽ hiển thị nó ở dạng + 1.23456%, với số lượng là (thô
- 1) * 100 cho giá trị tài sản thô đã cho.

hiển thị-đồng bộ hóa-hoạt động
Trả lại liệu --video-sync = display đang thực sự hoạt động.

tên tập tin
Tệp hiện đã phát, với đường dẫn bị xóa. Nếu đây là một URL, hãy cố gắng hoàn tác phần trăm
mã hóa. (Kết quả không nhất thiết phải chính xác, nhưng có vẻ tốt hơn cho
mục đích hiển thị. Sử dụng con đường thuộc tính để lấy tên tệp chưa sửa đổi.)

Kích thước tập tin
Độ dài tính bằng byte của tệp / luồng nguồn. (Điều này giống với $ {stream-end}. Đối với
các chương đã đặt hàng và như vậy, kích thước của phân đoạn hiện đang phát sẽ được trả về.)

số khung hình ước tính
Tổng số khung hình trong tệp hiện tại.

LƯU Ý:
Đây chỉ là một ước tính. (Nó được tính toán từ hai đại lượng không đáng tin cậy: fps và
độ dài luồng.)

số khung hình ước tính
Số khung hiện tại trong luồng hiện tại.

LƯU Ý:
Đây chỉ là một ước tính. (Nó được tính toán từ hai đại lượng không đáng tin cậy: fps và
có thể là dấu thời gian làm tròn.)

con đường Đường dẫn đầy đủ của tệp hiện đang phát. Thông thường đây chính xác là chuỗi bạn
chuyển dòng lệnh mpv hoặc tải tập tin lệnh, ngay cả khi đó là một đường dẫn tương đối.
Nếu bạn mong đợi một con đường tuyệt đối, bạn sẽ phải tự mình xác định nó, chẳng hạn
bằng cách sử dụng thư mục làm việc bất động sản.

tiêu đề phương tiện
Nếu tệp hiện đang phát có tiêu đề thẻ, sử dụng cái đó.

Ngược lại, nếu loại phương tiện là DVD, hãy trả về ID ổ đĩa của DVD.

Nếu không, hãy trả lại tên tập tin bất động sản.

định dạng tệp
Tên tượng trưng của định dạng tệp. Trong một số trường hợp, đây là danh sách được phân tách bằng dấu phẩy về
tên định dạng, ví dụ: mp4 là mov,mp4,m4a,3gp,3g2,mj2 (danh sách có thể phát triển trong tương lai
cho bất kỳ định dạng nào).

bộ giải mã
Tên của demuxer hiện tại. (Điều này là vô ích.)

luồng-đường dẫn
Tên tệp (đường dẫn đầy đủ) của tên tệp lớp luồng. (Điều này có lẽ là vô ích. Nó
có vẻ như điều này có thể khác với con đường chỉ khi sử dụng các chương có thứ tự.)

luồng-pos (RW)
Vị trí byte thô trong luồng nguồn.

kết thúc luồng
Vị trí kết thúc thô tính bằng byte trong luồng nguồn.

thời gian
Thời lượng của tệp hiện tại tính bằng giây. Nếu thời lượng không xác định, thuộc tính
không có. Lưu ý rằng thời lượng tệp không phải lúc nào cũng được biết chính xác, vì vậy đây là
một ước tính.

Điều này thay thế chiều dài thuộc tính không được dùng nữa sau bản phát hành mpv 0.9.
(Ngữ nghĩa giống nhau.)

avsync Sự khác biệt đồng bộ hóa A / V cuối cùng. Không khả dụng nếu âm thanh hoặc video bị tắt.

thay đổi toàn bộ avsync
Đã hoàn tất chỉnh sửa đồng bộ toàn bộ AV. Không khả dụng nếu âm thanh hoặc video bị tắt.

đếm khung hình
Khung video bị giảm bởi bộ giải mã, do video ở quá xa so với âm thanh (khi sử dụng
--framedrop = bộ giải mã). Đôi khi, điều này có thể tăng lên trong các tình huống khác, ví dụ:
khi gói video bị hỏng hoặc bộ giải mã không tuân theo các quy tắc thông thường.
Không khả dụng nếu video bị tắt.

vo-drop-frame-count
Khung hình bị giảm bởi VO (khi sử dụng --framedrop = vo).

đếm sai khung hình
Số khung hình video không được định giờ chính xác trong chế độ đồng bộ hóa hiển thị cho
lợi ích của việc giữ đồng bộ A / V. Điều này không bao gồm các trường hợp bên ngoài, chẳng hạn như
kết xuất video quá chậm hoặc trình điều khiển đồ họa bằng cách nào đó bỏ qua vsync. Nó
cũng không bao gồm lỗi làm tròn (có thể xảy ra đặc biệt với lỗi
dấu thời gian nguồn). Ví dụ, bằng cách sử dụng hiển thị không đồng bộ hóa chế độ không bao giờ được thay đổi
giá trị này từ 0.

tỷ lệ vsync
Đối với bao nhiêu vsync một khung được hiển thị trung bình. Điều này có sẵn nếu
display-sync chỉ hoạt động. Đối với video 30 FPS trên màn hình 60 Hz, đây sẽ là 2.
Đây là mức trung bình động của những gì thực sự đã được lên lịch, vì vậy 24 FPS trên 60 Hz
sẽ không bao giờ duy trì chính xác trên 2.5, nhưng rung lắc tùy thuộc vào khung hình cuối cùng được hiển thị.

vo-delay-frame-count
Số khung hình ước tính bị trì hoãn do các trường hợp bên ngoài trong đồng bộ hóa hiển thị
cách thức. Lưu ý rằng nói chung, mpv phải đoán rằng điều này đang xảy ra và
có thể không chính xác.

phần trăm-pos (RW)
Vị trí trong tệp hiện tại (0-100). Lợi thế của việc sử dụng cái này thay vì
tính toán nó ra khỏi các thuộc tính khác là nó đúng cách trở lại ước tính
vị trí phát lại từ vị trí byte, nếu thời lượng tệp không được biết.

thời gian (RW)
Vị trí trong tệp hiện tại trong vài giây.

Thời gian bắt đầu
Không được chấp nhận. Luôn trả về 0. Trước mpv 0.14, giá trị này được sử dụng để trả về thời gian bắt đầu
của tệp (có thể ảnh hưởng đến các luồng truyền tải). Nhìn thấy --rebase-thời gian bắt đầu tùy chọn.

thời gian còn lại
Thời lượng còn lại của tệp tính bằng giây. Lưu ý rằng thời lượng tệp không phải lúc nào cũng
được biết chính xác, vì vậy đây là một ước tính.

thời gian chơi còn lại
thời gian còn lại được chia theo tỷ lệ hiện tại tốc độ.

thời gian phát lại (RW)
Vị trí trong tệp hiện tại trong vài giây. không giống thời gian, thời gian được kẹp vào
phạm vi của tệp. (Thời lượng tệp không chính xác, v.v. có thể khiến tệp nằm ngoài phạm vi.
Cũng hữu ích khi người dùng cố gắng tìm kiếm bên ngoài tệp, vì mục tiêu tìm kiếm
thời gian được coi là vị trí hiện tại trong quá trình tìm kiếm.)

chương (RW)
Số chương hiện tại. Số của chương đầu tiên là 0.

phiên bản (RW)
Số phiên bản MKV hiện tại. Đặt thuộc tính này thành một giá trị khác sẽ khởi động lại
phát lại. Số lần xuất bản đầu tiên là 0.

tiêu đề đĩa
Số lượng tiêu đề BD / DVD.

Điều này có một số thuộc tính phụ. Thay thế N với chỉ mục phiên bản dựa trên 0.

tiêu đề đĩa / số lượng
Số đầu sách.

tiêu đề đĩa / id
ID tiêu đề dưới dạng số nguyên. Hiện tại, điều này giống như chỉ mục tiêu đề.

tiêu đề đĩa / độ dài
Độ dài tính bằng giây. Có thể không khả dụng trong một số trường hợp (hiện tại
chỉ hoạt động cho libdvdnav).

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (cho mỗi phiên bản)
"id" MPV_FORMAT_INT64
"chiều dài" MPV_FORMAT_DOUBLE

đĩa-tiêu đề-danh sách
Danh sách các tiêu đề BD / DVD.

tiêu đề đĩa (RW)
Số tiêu đề BD / DVD hiện tại. Công việc viết lách chỉ dành cho dvdnav: // và bd: // (Và
bí danh cho những).

chương
Số chương.

phiên bản
Số lượng phiên bản MKV.

ấn bản-danh sách
Danh sách các phiên bản, mục nhập hiện tại được đánh dấu. Hiện tại, giá trị tài sản thô là
vô ích.

Điều này có một số thuộc tính phụ. Thay thế N với chỉ mục phiên bản dựa trên 0.

edition-list / count
Số lượng ấn bản. Nếu không có phiên bản nào, giá trị này có thể là 0 hoặc 1 (1 nếu
có một phiên bản giả vô dụng).

edition-list / N / id
ID ấn bản dưới dạng số nguyên. Sử dụng cái này để đặt phiên bản tài sản. Hiện nay,
điều này giống với chỉ mục ấn bản.

edition-list / N / default
Vâng nếu đây là phiên bản mặc định, Không nếu không thì.

edition-list / N / title
Tiêu đề ấn bản như được lưu trữ trong tệp. Không phải lúc nào cũng có sẵn.

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (cho mỗi phiên bản)
"id" MPV_FORMAT_INT64
"tiêu đề" MPV_FORMAT_STRING
"mặc định" MPV_FORMAT_FLAG

ab-loop-a, ab-vòng-b (RW)
Đặt / lấy các điểm vòng AB. Xem các tùy chọn tương ứng và ab_loop chỉ huy. Các
giá trị đặc biệt Không trên một trong hai thuộc tính này sẽ vô hiệu hóa vòng lặp.

góc (RW)
Góc DVD hiện tại.

siêu dữ liệu
Các cặp khóa / giá trị siêu dữ liệu.

Nếu tài sản được truy cập bằng Lua mp.get_property_native, điều này trả về một bảng
với các khóa siêu dữ liệu ánh xạ tới các giá trị siêu dữ liệu. Nếu nó được truy cập bằng máy khách
API, điều này trả về một MPV_FORMAT_NODE_MAP, với các khóa thẻ ánh xạ tới các giá trị thẻ.

Đối với OSD, nó trả về một danh sách được định dạng. Đang cố gắng lấy thuộc tính này dưới dạng tài liệu thô
chuỗi không hoạt động.

Điều này có một số thuộc tính phụ:

siêu dữ liệu / theo khóa /
Giá trị của mục nhập siêu dữ liệu .

siêu dữ liệu / danh sách / số lượng
Số lượng mục nhập siêu dữ liệu.

siêu dữ liệu / danh sách / N / khóa
Tên khóa của mục nhập siêu dữ liệu thứ N. (Mục đầu tiên là 0).

siêu dữ liệu / danh sách / N / giá trị
Giá trị của mục nhập siêu dữ liệu thứ N.

metadata/
Phiên bản cũ của siêu dữ liệu / theo khóa /. Không khuyến khích sử dụng, bởi vì
chuỗi khóa siêu dữ liệu có thể xung đột với các thuộc tính phụ khác.

Bố cục của thuộc tính này có thể thay đổi. Đề xuất được hoan nghênh như thế nào
chính xác tài sản này sẽ hoạt động.

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_MAP
(giá trị khóa và chuỗi cho mỗi mục nhập siêu dữ liệu)

siêu dữ liệu đã lọc
Như siêu dữ liệu, nhưng chỉ bao gồm các trường được liệt kê trong --thẻ hiển thị Lựa chọn. Điều này
là cùng một tập hợp các thẻ được in ra thiết bị đầu cuối.

siêu dữ liệu chương
Siêu dữ liệu của chương hiện tại. Hoạt động tương tự như siêu dữ liệu tài sản. Nó cũng cho phép
cùng các phương thức truy cập (sử dụng thuộc tính con).

Siêu dữ liệu mỗi chương rất hiếm. Thông thường, chỉ có tên chương (tiêu đề) được thiết lập.

Để truy cập thông tin khác, chẳng hạn như bắt đầu chương, hãy xem danh sách chương bất động sản.

vf-siêu dữ liệu /
Siêu dữ liệu được bộ lọc video thêm vào. Được truy cập bởi nhãn bộ lọc, nếu không
được chỉ định rõ ràng bằng cách sử dụng @ filter-label: cú pháp, sẽ là NN.

Hoạt động tương tự như siêu dữ liệu tài sản. Nó cho phép các phương thức truy cập giống nhau (sử dụng
thuộc tính phụ).

Ví dụ về loại siêu dữ liệu này là các thông số cắt xén được thêm vào bởi
--vf = lavfi = cropdetect.

siêu dữ liệu af /
Tương đương với vf-siêu dữ liệu /, nhưng đối với bộ lọc âm thanh.

tạm dừng (RW)
Trạng thái tạm dừng. Điều này thường là Vâng or Không. Thấy --tạm ngừng.

nhàn rỗi Trả hàng Vâng nếu không có tệp nào được tải, nhưng trình phát vẫn ở lại do
--nhàn rỗi tùy chọn.

lõi-nhàn rỗi
Trả hàng Vâng nếu lõi phát lại bị tạm dừng, nếu không Không. Điều này có thể khác
tạm dừng trong các tình huống đặc biệt, chẳng hạn như khi trình phát tự tạm dừng do thấp
bộ nhớ đệm mạng.

Điều này cũng trở lại Vâng nếu quá trình phát lại đang khởi động lại hoặc nếu không có gì đang phát. Trong
nói cách khác, nó chỉ Không nếu thực sự có video đang phát. (Hành vi kể từ mpv
0.7.0).

bộ nhớ cache Trạng thái lấp đầy bộ đệm mạng (0-100.0).

kích thước bộ nhớ cache (RW)
Kích thước bộ đệm mạng tính bằng KB. Điều này tương tự như --bộ nhớ đệm. Điều này cho phép thiết lập bộ nhớ cache
kích thước trong thời gian chạy. Hiện tại, không thể bật hoặc tắt bộ nhớ cache tại
thời gian chạy bằng cách sử dụng thuộc tính này, chỉ để thay đổi kích thước bộ đệm hiện có.

Điều này không bao gồm kích thước bộ đệm sau (được thay đổi sau mpv 0.10.0).

Lưu ý rằng điều này cố gắng giữ cho nội dung bộ nhớ cache càng xa càng tốt. Để làm điều này
dễ dàng hơn, mã thay đổi kích thước bộ nhớ cache sẽ phân bổ bộ nhớ cache mới trong khi bộ nhớ cache cũ là
vẫn được phân bổ.

Không sử dụng phần mềm này khi phát DVD hoặc Blu-ray.

không có bộ nhớ cache (R)
Tổng dung lượng bộ nhớ cache miễn phí tính bằng KB.

được sử dụng trong bộ nhớ cache (R)
Tổng kích thước bộ nhớ cache đã sử dụng tính bằng KB.

bộ nhớ cache không hoạt động (R)
Hoàn trả Vâng nếu bộ nhớ cache không hoạt động, có nghĩa là bộ nhớ cache được lấp đầy bằng
có thể, và hiện không đọc thêm dữ liệu.

demuxer-cache-thời lượng
Thời lượng gần đúng của video được lưu trong bộ đệm, tính bằng giây. Dự đoán là
rất không đáng tin cậy và thường thuộc tính sẽ không có sẵn, ngay cả khi dữ liệu
được đệm.

demuxer-cache-time
Thời gian gần đúng của video được lưu vào bộ đệm trong trình giải mã, tính bằng giây. Giống như
demuxer-cache-thời lượng nhưng trả về dấu thời gian cuối cùng của dữ liệu được đệm trong demuxer.

demuxer-cache-nhàn rỗi
Hoàn trả Vâng nếu demuxer không hoạt động, có nghĩa là bộ đệm demuxer được lấp đầy vào
số lượng yêu cầu và hiện không đọc thêm dữ liệu.

tạm dừng cho bộ nhớ cache
Hoàn trả Vâng khi quá trình phát bị tạm dừng vì đang đợi bộ nhớ cache.

bộ đệm-trạng thái đệm
Trả lại tỷ lệ phần trăm (0-100) của trạng thái lấp đầy bộ nhớ cache cho đến khi trình phát
bỏ tạm dừng (liên quan đến tạm dừng cho bộ nhớ cache).

eof-đạt
Hoàn trả Vâng nếu đạt đến kết thúc phát lại, Không nếu không thì. Lưu ý rằng điều này thường là
thú vị chỉ khi - mở cửa được bật, vì nếu không người chơi sẽ
ngay lập tức phát tệp tiếp theo (hoặc thoát hoặc vào chế độ không hoạt động) và trong những trường hợp này,
eof-đạt thuộc tính hợp lý sẽ bị xóa ngay lập tức sau khi nó được thiết lập.

tìm kiếm
Hoàn trả Vâng nếu người chơi hiện đang tìm kiếm hoặc đang cố gắng khởi động lại
phát lại. (Có thể nó quay trở lại Vâng trong khi một tệp được tải hoặc khi
chuyển đổi các phân đoạn chương có thứ tự. Điều này là do cùng một mã cơ bản là
được sử dụng để tìm kiếm và đồng bộ hóa lại.)

tìm giờ (RW)
Xem --giờ-tìm kiếm.

khối lượng (RW)
Khối lượng hiện tại (xem --âm lượng để biết chi tiết).

chuyển động (RW)
Trạng thái tắt tiếng hiện tại (Vâng/Không).

Sự chậm trễ âm thanh (RW)
Xem --Sự chậm trễ âm thanh.

Audio codec
Codec âm thanh được chọn để giải mã.

tên-codec-âm thanh
Audio codec.

thông số âm thanh
Định dạng âm thanh như đầu ra của bộ giải mã âm thanh. Điều này có một số thuộc tính phụ:

định dạng / tham số âm thanh
Định dạng mẫu dưới dạng chuỗi. Điều này sử dụng các tên giống như được sử dụng trong
địa điểm của mpv.

audio-params / samplerate
Tỷ lệ mẫu.

audio-params / kênh
Bố cục kênh dưới dạng một chuỗi. Điều này tương tự như những gì - kênh âm thanh
chấp nhận.

kênh audio-params / hr-channel
As kênh, nhưng thay vì bố cục thực tế có thể khó hiểu được gửi đến
thiết bị âm thanh, trả lại một biểu mẫu hy vọng con người có thể đọc được hơn. (Thường chỉ
audio-out-params / hr-channel có ý nghĩa.)

audio-params / channel-count
Số kênh âm thanh. Điều này là thừa đối với kênh lĩnh vực được mô tả
ở trên.

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_MAP
"định dạng" MPV_FORMAT_STRING
"tốc độ lấy mẫu" MPV_FORMAT_INT64
"kênh" MPV_FORMAT_STRING
"số kênh" MPV_FORMAT_INT64
"hr-channel" MPV_FORMAT_STRING

thông số âm thanh ra
Giống như thông số âm thanh, nhưng định dạng của dữ liệu được ghi vào API âm thanh.

viện trợ (RW)
Bản âm thanh hiện tại (tương tự như --sự giúp đỡ).

âm thanh (RW)
Bí danh cho viện trợ.

cân bằng (RW)
Cân bằng kênh âm thanh. (Việc triển khai tính năng này khá kỳ quặc. Nó
không thay đổi âm lượng của mỗi kênh, nhưng thay vào đó, thiết lập ma trận xoay để trộn
kênh trái và phải.)

toàn màn hình (RW)
Xem --toàn màn hình.

khử xen kẽ (RW)
Xem --deinterlace.

thống trị lĩnh vực (RW)
Xem - thống trị trường

ma trận màu (R)
Chuyển hướng đến video-params / colormatrix. Tham số này (cũng như những tham số tương tự) có thể
được ghi đè với định dạng bộ lọc video.

colormatrix-input-phạm vi (R)
Xem ma trận màu.

video-đầu ra-cấp (RW)
Xem --video-output-level,

colormatrix-sơ cấp (R)
Xem ma trận màu.

đứng đầu (RW)
Xem --trên đỉnh.

biên giới (RW)
Xem --biên giới.

trên tất cả các không gian làm việc (RW)
Xem - trên tất cả-không gian làm việc. Bỏ thiết lập có thể không hoạt động trên tất cả các WM.

khung (RW)
Xem --framedrop.

gamma (RW)
Xem --gamma.

độ sáng (RW)
Xem --độ sáng.

Ngược lại (RW)
Xem --sự tương phản.

bão hòa (RW)
Xem - bão hòa.

sắc (RW)
Xem --màu sắc.

hwdec (RW)
Phản ánh --hwdec tùy chọn.

Ghi vào nó có thể thay đổi bộ giải mã phần cứng hiện đang sử dụng, nếu có thể.
(Trong nội bộ, người chơi có thể khởi động lại bộ giải mã và sẽ thực hiện tìm kiếm
làm mới video đúng cách.) Bạn có thể xem các thuộc tính hwdec khác để xem
cho dù điều này đã thành công.

Không giống như trong mpv 0.9.x và trước đó, điều này không trả về phần cứng hiện đang hoạt động
bộ giải mã.

hwdec-hoạt động
Trả hàng Vâng or Không, tùy thuộc vào việc có bất kỳ loại giải mã phần cứng nào thực sự ở
sử dụng.

phát hiện hwdec
Nếu giải mã phần mềm đang hoạt động, điều này sẽ trả về bộ giải mã phần cứng đang được sử dụng.
Nếu không, nó trả về một trong hai Khônghoặc nếu có, phần cứng hiện đang được tải
API giải mã. Điều này chỉ được biết khi VO đã mở (và có thể sau đó). Với
một số VO (như OpenGL), điều này không bao giờ được biết trước, nhưng chỉ khi bộ giải mã
đã cố gắng tạo thành công bộ giải mã hw. Ngoài ra, bộ giải mã hw với -bộ soi
hậu tố sẽ trở lại Không trong khi không có video nào được giải mã. Tất cả điều này phản ánh cách
phát hiện bộ giải mã hw được phát hiện và sử dụng nội bộ trong mpv.

quét quét (RW)
Xem --panscan.

định dạng video
Định dạng video dưới dạng chuỗi.

codec video
Codec video được chọn để giải mã.

chiều rộng, cao
Kích thước video. Điều này sử dụng kích thước của video dưới dạng được giải mã hoặc nếu không có khung video nào có
đã được giải mã chưa, kích thước chỉ định của vùng chứa (có thể không chính xác).

thông số video
Các thông số video, dưới dạng đầu ra của bộ giải mã (với các ghi đè như khía cạnh, v.v.
đã áp dụng). Điều này có một số thuộc tính phụ:

video-params / pixelformat
Định dạng pixel dưới dạng chuỗi. Điều này sử dụng các tên giống như được sử dụng ở những nơi khác
của mpv.

video-params / average-bpp
Số bit trung bình trên mỗi pixel dưới dạng số nguyên. Các định dạng phẳng được lấy mẫu phụ sử dụng một
độ phân giải, đó là lý do tại sao giá trị này đôi khi có thể là số lẻ hoặc
gây nhầm lẫn. Có thể không khả dụng với một số định dạng.

video-params / độ sâu mặt phẳng
Độ sâu bit cho mỗi thành phần màu dưới dạng số nguyên. Điều này chỉ được hiển thị cho
các định dạng phẳng hoặc một thành phần và không khả dụng cho các định dạng khác.

video-params / w, video-params / h
Kích thước video dưới dạng số nguyên, không áp dụng hiệu chỉnh kích thước.

video-params / dw, video-params / dh
Kích thước video dưới dạng số nguyên, được chia tỷ lệ để có tỷ lệ khung hình chính xác.

video-params / khía cạnh
Hiển thị tỷ lệ khung hình dưới dạng float.

video-params / par
Tỉ lệ điểm ảnh.

video-params / colormatrix
Colormatrix được sử dụng dưới dạng chuỗi. (Các giá trị chính xác có thể thay đổi.)

video-params / colorlevels
Các cấp độ màu dưới dạng chuỗi. (Các giá trị chính xác có thể thay đổi.)

video-params / primaries
Các bầu cử sơ bộ được sử dụng dưới dạng chuỗi. (Các giá trị chính xác có thể thay đổi.)

video-params / gamma
Hàm gamma được sử dụng dưới dạng chuỗi. (Các giá trị chính xác có thể thay đổi.)

video-params / chroma-location
Vị trí nhiễm sắc thể dưới dạng chuỗi. (Các giá trị chính xác có thể thay đổi.)

video-params / xoay
Xoay màn hình dự định theo độ (theo chiều kim đồng hồ).

video-params / stereo-in
Chế độ âm thanh nổi 3D của tệp nguồn. (Nhìn thấy --video-âm thanh nổi-chế độ Tùy chọn.)

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_MAP
"pixelformat" MPV_FORMAT_STRING
"w" MPV_FORMAT_INT64
"h" MPV_FORMAT_INT64
"dw" MPV_FORMAT_INT64
"dh" MPV_FORMAT_INT64
"khía cạnh" MPV_FORMAT_DOUBLE
"mệnh" MPV_FORMAT_DOUBLE
"colormatrix" MPV_FORMAT_STRING
"colorlevels" MPV_FORMAT_STRING
"bầu cử sơ bộ" MPV_FORMAT_STRING
"chroma-location" MPV_FORMAT_STRING
"xoay" MPV_FORMAT_INT64
"âm thanh nổi" MPV_FORMAT_STRING

chiều rộng, chiều cao
Kích thước hiển thị video. Đây là kích thước video sau khi các bộ lọc và tỷ lệ khung hình có
đã được áp dụng. Kích thước cửa sổ video thực tế vẫn có thể khác với kích thước này, ví dụ:
nếu người dùng thay đổi kích thước cửa sổ video theo cách thủ công.

Chúng có các giá trị giống như video-out-params / dw và video-out-params / dh.

thông số đầu ra video
Giống như thông số video, nhưng sau khi bộ lọc video đã được áp dụng. Nếu không có
bộ lọc video đang được sử dụng, bộ lọc này sẽ chứa các giá trị giống như thông số video. Lưu ý rằng
đây vẫn không nhất thiết là những gì cửa sổ video sử dụng, vì người dùng có thể thay đổi
kích thước cửa sổ và tất cả các VO thực sự thực hiện điều chỉnh tỷ lệ riêng của chúng độc lập với
chuỗi bộ lọc.

Có các thuộc tính phụ giống như thông số video.

video-khung-thông tin
Thông tin gần đúng của khung hiện tại. Lưu ý rằng nếu bất kỳ cái nào trong số này được sử dụng trên
OSD, thông tin có thể bị tắt một vài khung hình do quá trình vẽ lại OSD và khung
màn hình hơi bị ngắt kết nối và bạn có thể phải tạm dừng và buộc
vẽ lại.

Thuộc tính phụ:

video-frame-info / picture-type video-khung-thông tin / xen kẽ video-frame-info / tff
video-khung-thông tin / lặp lại

fps FPS vùng chứa. Điều này có thể dễ dàng chứa các giá trị không có thật. Đối với video sử dụng hiện đại
định dạng vùng chứa hoặc codec video, điều này thường sẽ không chính xác.

ước tính-vf-fps
FPS ước tính / đo được của đầu ra chuỗi bộ lọc video. (Nếu không có bộ lọc nào được sử dụng,
điều này tương ứng với đầu ra của bộ giải mã.) Điều này sử dụng giá trị trung bình của 10 khung hình trong quá khứ
thời lượng để tính FPS. Nó sẽ không chính xác nếu liên quan đến giảm khung hình
(chẳng hạn như khi khung được bật rõ ràng hoặc sau khi tìm kiếm chính xác). Các tập tin
với dấu thời gian không chính xác (chẳng hạn như Matroska) có thể dẫn đến kết quả không ổn định.

quy mô cửa sổ (RW)
Hệ số kích thước cửa sổ. Cài đặt này sẽ thay đổi kích thước cửa sổ video thành các giá trị
chứa trong chiều rộng và chiều cao nhân với giá trị được đặt với thuộc tính này.
Giàn cảnh 1 sẽ thay đổi kích thước thành kích thước video gốc (hoặc chính xác là kích thước video
đầu ra bộ lọc). 2 sẽ đặt kích thước gấp đôi, 0.5 giảm một nửa kích thước.

thu nhỏ cửa sổ
Trả lại xem cửa sổ video có được thu nhỏ hay không.

tên hiển thị
Tên của các màn hình mà cửa sổ mpv bao phủ. Trên X11, đây là các xrandr
tên (LVDS1, HDMI1, DP1, VGA1, v.v.).

hiển thị khung hình / giây (RW)
Tốc độ làm mới của màn hình hiện tại. Hiện tại, đây là FPS thấp nhất trong số các
hiển thị được bao phủ bởi video, như được truy xuất bởi các API hệ thống cơ bản (ví dụ:
xrandr trên X11). Nó không phải là FPS đo được. Nó không nhất thiết phải có trên tất cả
nền tảng. Lưu ý rằng bất kỳ sự kiện nào được liệt kê có thể thay đổi bất kỳ lúc nào mà không cần cảnh báo trước.

ước tính-hiển thị-fps
Chỉ khả dụng nếu chế độ hiển thị-đồng bộ hóa (như được chọn bởi --đồng bộ hóa video) đang hoạt động.
Trả về tốc độ thực tế mà tại đó hiển thị làm mới dường như xảy ra, được đo bằng
thời gian hệ thống.

vsync-jitter
Hệ số sai lệch ước tính của thời lượng vsync.

khía cạnh video (RW)
Khía cạnh video, xem --video-khía cạnh.

chiều rộng osd, chiều cao osd
Chiều rộng OSD được biết gần đây nhất (có thể là 0). Điều này là cần thiết nếu bạn muốn sử dụng lớp phủ_add
yêu cầu. Nó cung cấp cho bạn kích thước OSD thực tế, có thể khác với cửa sổ
kích thước trong một số trường hợp.

osd-par
Khía cạnh pixel hiển thị OSD được biết gần đây nhất (có thể là 0).

tại (RW)
Đoạn video hiện tại (tương tự như --vid).

video (RW)
Bí danh cho tại.

căn chỉnh video-x, video-căn chỉnh-y (RW)
Xem --video-căn chỉnh-x và --video-căn chỉnh-y.

video-pan-x, video-pan-y (RW)
Xem --video-pan-x và --video-pan-y.

thu phóng video (RW)
Xem - thu phóng video.

video không có tỷ lệ (W)
Xem --video-chưa chia tỷ lệ.

chương trình (W)
Chuyển chương trình TS (chỉ ghi).

sid (RW)
Bản phụ đề hiện tại (tương tự như --sid).

thứ cấp (RW)
Phụ đề phụ (xem --sid phụ).

phụ (RW)
Bí danh cho sid.

sự chậm trễ phụ (RW)
Xem - chậm trễ.

vị trí phụ (RW)
Xem - vị trí phụ.

khả năng hiển thị phụ (RW)
Xem - khả năng hiển thị dưới.

chỉ bắt buộc phụ (RW)
Xem - chỉ bắt buộc phụ.

quy mô phụ (RW)
Hệ số kích thước phông chữ phụ đề.

ass-force-margin (RW)
Xem --ass-force-margin.

lợi nhuận phụ sử dụng (RW)
Xem - sub-use-margin.

ass-vsfilter-khía cạnh-compat (RW)
Xem --ass-vsfilter-khía cạnh-compat.

ass-style-ghi đè (RW)
Xem --ass-style-ghi đè.

bắt dòng (RW)
Tên tệp, hãy xem - bắt dòng. Cài đặt này sẽ bắt đầu chụp bằng cách sử dụng
tên tệp. Đặt nó thành một chuỗi trống sẽ dừng nó lại.

độ sáng tv, tương phản truyền hình, bão hòa tv, tvhue (RW)
Nội dung truyền hình.

danh sách phát-pos (RW)
Vị trí hiện tại trên danh sách phát. Mục nhập đầu tiên ở vị trí 0. Viết vào
thuộc tính sẽ bắt đầu phát lại ở mục đã viết.

danh sách phát
Tổng số mục nhập danh sách phát.

danh sách
Danh sách phát, mục nhập hiện tại đã được đánh dấu. Hiện tại, giá trị tài sản thô là vô dụng.

Điều này có một số thuộc tính phụ. Thay thế N với mục nhập danh sách phát dựa trên 0
mục lục.

danh sách phát / số lượng
Số lượng mục nhập danh sách phát (giống như danh sách phát).

danh sách phát / N / tên tệp
Tên tệp của mục nhập thứ N.

danh sách phát / N / hiện tại, playlist / N / đang phát
Vâng nếu mục này hiện đang phát (hoặc đang được tải). Không có sẵn hoặc Không
nếu không thì. Khi thay đổi tệp, hiện hành và chơi có thể khác,
bởi vì tệp hiện đang phát vẫn chưa được tải xuống; trong trường hợp này,
hiện hành đề cập đến lựa chọn mới. (Kể từ mpv 0.7.0.)

danh sách phát / N / tiêu đề
Tên của mục nhập thứ N. Chỉ khả dụng nếu tệp danh sách phát có chứa
và chỉ khi trình phân tích cú pháp của mpv hỗ trợ nó cho định dạng danh sách phát nhất định.

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (cho mỗi mục nhập danh sách phát)
"tên tệp" MPV_FORMAT_STRING
"hiện tại" MPV_FORMAT_FLAG (có thể bị thiếu; vì mpv 0.7.0)
"đang phát" MPV_FORMAT_FLAG (giống nhau)
"title" MPV_FORMAT_STRING (tùy chọn)

danh sách theo dõi
Danh sách các bài hát âm thanh / video / phụ, mục nhập hiện tại được đánh dấu. Hiện tại, tài sản thô
giá trị là vô ích.

Điều này có một số thuộc tính phụ. Thay thế N với chỉ số theo dõi dựa trên 0.

danh sách theo dõi / số lượng
Tổng số bản nhạc.

track-list / N / id
ID được sử dụng cho -sid/--sự giúp đỡ/--vid. Điều này là duy nhất trong các bài hát của
cùng loại (phụ / âm thanh / video), nhưng khác thì không.

danh sách theo dõi / N / loại
Chuỗi mô tả loại phương tiện. Một trong âm thanh, video, phụ.

track-list / N / src-id
Theo dõi ID như được sử dụng trong tệp nguồn. Không phải lúc nào cũng có sẵn.

track-list / N / title
Theo dõi tiêu đề vì nó được lưu trữ trong tệp. Không phải lúc nào cũng có sẵn.

track-list / N / lang
Theo dõi ngôn ngữ được xác định bởi tệp. Không phải lúc nào cũng có sẵn.

danh sách theo dõi / N / kênh âm thanh
Đối với các bản âm thanh, số lượng kênh âm thanh trong luồng âm thanh. Không
luôn chính xác (phụ thuộc vào gợi ý container). Không phải lúc nào cũng có sẵn.

track-list / N / albumart
Vâng nếu đây là một đoạn video bao gồm một hình ảnh, Không or
không có sẵn nếu không. Điều này được sử dụng cho các đoạn video thực sự
hình ảnh đính kèm trong tệp âm thanh.

danh sách theo dõi / N / mặc định
Vâng nếu bản nhạc có cờ mặc định được đặt trong tệp, Không nếu không thì.

danh sách theo dõi / N / bắt buộc
Vâng nếu bản nhạc có cờ bắt buộc được đặt trong tệp, Không nếu không thì.

track-list / N / codec
Ví dụ: tên codec mà bản nhạc này sử dụng h264. Không khả dụng ở một số
những trường hợp hiếm.

danh sách theo dõi / N / bên ngoài
Vâng nếu bản nhạc là một tệp bên ngoài, Không nếu không thì. Điều này được đặt cho riêng biệt
tệp phụ đề.

track-list / N / tên tệp bên ngoài
Tên tệp nếu bản nhạc là từ một tệp bên ngoài, nếu không thì không có sẵn.

danh sách theo dõi / N / đã chọn
Vâng nếu bản nhạc hiện đang được giải mã, Không nếu không thì.

track-list / N / ff-index
Chỉ mục luồng thường được sử dụng bởi các tiện ích FFmpeg. Lưu ý rằng điều này có thể
có khả năng sai nếu một demuxer không phải là libavformat (--demuxer = lavf) là
đã sử dụng. Đối với tệp mkv, chỉ mục thường sẽ khớp ngay cả khi giá trị mặc định
demuxer (nội trang) được sử dụng, nhưng không có bảo đảm cứng.

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (cho mỗi bản nhạc)
"id" MPV_FORMAT_INT64
"loại" MPV_FORMAT_STRING
"src-id" MPV_FORMAT_INT64
"tiêu đề" MPV_FORMAT_STRING
"lang" MPV_FORMAT_STRING
"kênh âm thanh" MPV_FORMAT_INT64
"albumart" MPV_FORMAT_FLAG
"mặc định" MPV_FORMAT_FLAG
"buộc" MPV_FORMAT_FLAG
"bên ngoài" MPV_FORMAT_FLAG
"tên tệp bên ngoài" MPV_FORMAT_STRING
"codec" MPV_FORMAT_STRING

danh sách chương
Danh sách các chương, mục hiện tại được đánh dấu. Hiện tại, giá trị tài sản thô là
vô ích.

Điều này có một số thuộc tính phụ. Thay thế N với chỉ mục chương dựa trên 0.

danh sách / số chương
Số chương.

danh sách chương / N / tiêu đề
Tên chương như được lưu trong tệp. Không phải lúc nào cũng có sẵn.

danh sách chương / N / thời gian
Thời gian bắt đầu chương tính bằng giây dưới dạng float.

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (cho mỗi chương)
"tiêu đề" MPV_FORMAT_STRING
"thời gian" MPV_FORMAT_DOUBLE

af (RW)
Xem --af và af chỉ huy.

vf (RW)
Xem --vf và vf chỉ huy.

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (cho mỗi mục nhập bộ lọc)
"tên" MPV_FORMAT_STRING
"nhãn" MPV_FORMAT_STRING [tùy chọn]
"params" MPV_FORMAT_NODE_MAP [tùy chọn]
"khóa" MPV_FORMAT_STRING
"giá trị" MPV_FORMAT_STRING

Cũng có thể viết thuộc tính bằng định dạng này.

xoay video (RW)
Xem --video xoay tùy chọn.

có thể tìm kiếm
Trả lại xem thông thường có thể tìm kiếm trong tệp hiện tại hay không.

có thể tìm kiếm một phần
Trả hàng Vâng nếu tệp hiện tại được coi là có thể tìm kiếm được, nhưng chỉ vì bộ nhớ cache
đang hoạt động. Điều này có nghĩa là các tìm kiếm tương đối nhỏ có thể ổn, nhưng tìm kiếm lớn hơn có thể thất bại
dù sao. Việc tìm kiếm có thành công hay không thường không được biết trước.

Nếu thuộc tính này trả về true, có thể tìm kiếm cũng sẽ trả về true.

phát lại-hủy bỏ
Quay lại việc phát lại có bị dừng hay sắp bị dừng. (Hữu ích khi ít người biết đến
tình huống như trong đang tải xử lý móc, khi người dùng có thể ngừng phát lại,
nhưng tập lệnh phải kết thúc xử lý một cách rõ ràng.)

con trỏ-tự động ẩn (RW)
Xem --con trỏ-tự động ẩn. Đặt giá trị này thành giá trị mới sẽ luôn cập nhật con trỏ,
và đặt lại bộ đếm thời gian bên trong.

osd-sym-cc
Chèn biểu tượng OSD hiện tại dưới dạng mã điều khiển OSD mờ đục (cc). Điều này thật ý nghĩa
chỉ với hiển thị văn bản lệnh hoặc các tùy chọn đặt thông báo OSD. Sự kiểm soát
mã là triển khai cụ thể và vô dụng cho bất kỳ thứ gì khác.

osd-ass-cc
$ {osd-ass-cc / 0} vô hiệu hóa chuỗi văn bản ASS thoát trong OSD, $ {osd-ass-cc / 1}
cho phép nó một lần nữa. Theo mặc định, chuỗi ASS được thoát để tránh tình cờ
định dạng và thuộc tính này có thể vô hiệu hóa hành vi này. Lưu ý rằng các thuộc tính
trả về mã điều khiển OSD không rõ ràng, mã này chỉ có ý nghĩa đối với hiển thị văn bản lệnh
hoặc các tùy chọn đặt thông báo OSD.

Ví dụ

· --osd-status-msg = 'Cái này is $ {osd-ass-cc / 0} {\\ b1} in đậm chữ'

· hiển thị văn bản "Điều này is $ {osd-ass-cc / 0} {\ b1} in đậm chữ"

Có thể sử dụng bất kỳ thẻ ghi đè ASS nào như được hiểu bởi libass.

Lưu ý rằng bạn cần thoát khỏi \ ký tự, vì chuỗi được xử lý cho C
thoát trình tự trước khi chuyển nó sang mã OSD.

Danh sách các thẻ có thể được tìm thấy ở đây: http://docs.aegisub.org/latest/ASS_Tags/

vo-cấu hình
Trở lại xem VO có được định cấu hình ngay bây giờ hay không. Thông thường điều này tương ứng với việc
cửa sổ video được hiển thị. Nếu --buộc-cửa sổ tùy chọn được sử dụng, đây thường là
luôn luôn trở lại Vâng.

tốc độ bit video, tốc độ âm thanh, tốc độ bit phụ
Giá trị tốc độ bit được tính trên mức gói. Điều này hoạt động bằng cách chia kích thước bit
của tất cả các gói giữa hai khung hình chính theo khoảng cách dấu thời gian trình bày của chúng.
(Điều này sử dụng dấu thời gian được lưu trữ trong tệp, vì vậy, ví dụ: tốc độ phát lại không
ảnh hưởng đến các giá trị được trả về.) Đặc biệt, tốc độ bit của video sẽ chỉ cập nhật
trên mỗi khung hình chính và hiển thị tốc độ bit "trong quá khứ". Để làm cho thuộc tính thân thiện hơn với giao diện người dùng,
cập nhật cho các thuộc tính này được điều chỉnh theo một cách nhất định.

Đơn vị là bit trên giây. Định dạng OSD biến các giá trị này thành kilobit (hoặc
megabit, nếu thích hợp), có thể được ngăn chặn bằng cách sử dụng giá trị thuộc tính thô,
ví dụ với $ {= video-bitrate}.

Lưu ý rằng độ chính xác của các thuộc tính này bị ảnh hưởng bởi một số yếu tố. Nếu
demuxer bên dưới viết lại các gói trên demuxing (được thực hiện cho một số định dạng tệp),
tốc độ bit có thể hơi tắt. Nếu dấu thời gian xấu hoặc chập chờn (như trong
Matroska), thậm chí các luồng có tốc độ bit không đổi có thể hiển thị tốc độ bit dao động.

Cách tính chính xác các giá trị này có thể thay đổi trong tương lai.

Trong các phiên bản mpv trước đó, các thuộc tính này trả về một phỏng đoán tĩnh (nhưng không tốt)
sử dụng một phương pháp hoàn toàn khác.

gói-video-bitrate, gói-âm thanh-bitrate, tốc độ bit phụ của gói
Thuộc tính cũ và không dùng nữa cho tốc độ bit video, tốc độ âm thanh, tốc độ bit phụ. Họ
hoạt động giống hệt nhau, nhưng trả về một giá trị tính bằng kilobit. Ngoài ra, họ không có bất kỳ
Định dạng OSD, mặc dù có thể đạt được điều tương tự với ví dụ $ {= video-bitrate}.

Những thuộc tính này không nên được sử dụng nữa.

danh sách thiết bị âm thanh
Trả lại danh sách các thiết bị âm thanh đã phát hiện. Điều này chủ yếu để sử dụng với khách hàng
API và phản ánh những gì --audio-device = trợ giúp với trình phát dòng lệnh trả về.

Khi truy vấn thuộc tính bằng API ứng dụng khách bằng cách sử dụng MPV_FORMAT_NODE, hoặc với Lua
mp.get_property_native, điều này sẽ trả về mpv_node với nội dung sau:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (cho mỗi mục nhập thiết bị)
"tên" MPV_FORMAT_STRING
"mô tả" MPV_FORMAT_STRING

tên là những gì sẽ được chuyển cho --thiết bị âm thanh tùy chọn (và thường là
ID dành riêng cho API âm thanh khó hiểu), trong khi Mô tả là văn bản biểu mẫu miễn phí có thể đọc được của con người.
Mô tả là một chuỗi trống nếu không có chuỗi nào được nhận.

Mục nhập đặc biệt có tên được đặt thành tự động chọn trình điều khiển đầu ra âm thanh mặc định
và thiết bị mặc định.

Thuộc tính có thể được theo dõi với cơ chế quan sát thuộc tính trong máy khách
API và trong các tập lệnh Lua. (Về mặt kỹ thuật, thông báo thay đổi được bật lần đầu tiên
thuộc tính này đã được đọc.)

thiết bị âm thanh (RW)
Đặt thiết bị âm thanh. Điều này trực tiếp đọc / ghi --thiết bị âm thanh tùy chọn, nhưng trên
ghi các quyền truy cập, đầu ra âm thanh sẽ được lên lịch tải lại.

Việc ghi thuộc tính này trong khi không có đầu ra âm thanh nào đang hoạt động sẽ không tự động bật
âm thanh. (Điều này cũng đúng trong trường hợp âm thanh bị tắt do
lỗi khởi động lại sau một lần truy cập ghi trước đó vào thiết bị âm thanh.)

Thuộc tính này cũng không cho bạn biết thiết bị âm thanh nào đang thực sự được sử dụng.

Cách xử lý các chi tiết này có thể thay đổi trong tương lai.

hiện-vo
Trình điều khiển đầu ra video hiện tại (tên như được sử dụng với --vo).

áo dài
Trình điều khiển đầu ra âm thanh hiện tại (tên như được sử dụng với --ao).

thiết bị phát hiện âm thanh
Trả lại thiết bị âm thanh được chọn bởi trình điều khiển AO (chỉ được triển khai cho một số
trình điều khiển: hiện chỉ lõiaudio).

thư mục làm việc
Trả lại thư mục làm việc của tiến trình mpv. Có thể hữu ích cho người dùng JSON IPC,
vì trình phát dòng lệnh thường làm việc với các đường dẫn tương đối.

danh sách giao thức
Danh sách các tiền tố giao thức có khả năng được người chơi nhận ra. Họ được trả lại
không có dấu vết :/ / hậu tố (vẫn luôn được yêu cầu). Trong một số trường hợp,
giao thức sẽ không thực sự được hỗ trợ (xem xét https nếu ffmpeg không được biên dịch
với hỗ trợ TLS).

phiên bản mpv
Trả lại phiên bản mpv / chuỗi bản quyền. Tùy thuộc vào cách thức nhị phân được xây dựng, nó
có thể chứa một phiên bản phát hành hoặc chỉ một băm git.

cấu hình mpv
Trả lại các đối số cấu hình đã được chuyển đến hệ thống xây dựng (thường là
cách ./waff cấu hình ... đã được gọi).

tùy chọn/ (RW)
Quyền truy cập chỉ đọc vào giá trị của tùy chọn -. Hầu hết các tùy chọn có thể được thay đổi tại
thời gian chạy bằng cách ghi vào tài sản này. Lưu ý rằng nhiều tùy chọn yêu cầu tải lại
để các thay đổi có hiệu lực. Nếu có thuộc tính tương đương, hãy ưu tiên cài đặt
tài sản thay thế.

file-local-options /
Tương tự như tùy chọn/, nhưng khi đặt một tùy chọn thông qua thuộc tính này,
tùy chọn được đặt lại về giá trị cũ sau khi tệp hiện tại ngừng phát. Cố gắng
để viết một tùy chọn trong khi không có tệp nào đang phát (hoặc đang được tải) dẫn đến
lỗi.

(Lưu ý rằng nếu một tùy chọn được đánh dấu là tệp cục bộ, ngay cả tùy chọn / sẽ truy cập
giá trị địa phương và xưa giá trị này sẽ được khôi phục khi kết thúc phát lại, không thể
được đọc hoặc ghi cho đến khi kết thúc phát lại.)

option-thông tin /
Thông tin bổ sung cho mỗi tùy chọn.

Điều này có một số thuộc tính phụ. Thay thế với tên của cấp cao nhất
quyền mua. Không đảm bảo tính ổn định được đưa ra cho bất kỳ thuộc tính phụ nào - chúng
có thể thay đổi hoàn toàn trong tính năng.

option-thông tin / /Tên
Trả về tên của tùy chọn.

option-thông tin / /loại hình
Trả lại tên của loại tùy chọn, như Chuỗi or Số nguyên. Cho nhieu
loại phức tạp, điều này không chính xác lắm.

option-thông tin / / set-from-commandline
Trả hàng Vâng nếu tùy chọn được đặt từ dòng lệnh mpv, Không nếu không thì.
Điều này được đặt thành gì nếu tùy chọn được thay đổi, ví dụ: thay đổi trong thời gian chạy là còn lại
không xác định (có nghĩa là nó có thể thay đổi trong tương lai).

option-thông tin / / set-local
Trả hàng Vâng nếu tùy chọn được đặt cho mỗi tệp. Đây là trường hợp với
các cấu hình được tải tự động, cấu hình file-dir và các trường hợp khác. Nó có nghĩa là
giá trị tùy chọn sẽ được khôi phục về giá trị trước khi bắt đầu phát lại khi
phát lại kết thúc.

option-thông tin / /giá trị mặc định
Giá trị mặc định của tùy chọn. Có thể không phải lúc nào cũng có sẵn.

option-thông tin / / phút, option-thông tin / / tối đa
Số nguyên giá trị tối thiểu và tối đa được phép cho tùy chọn. Chỉ khả dụng nếu
các tùy chọn là số và mức tối thiểu / tối đa đã được đặt trong nội bộ.
Cũng có thể chỉ một trong số này được thiết lập.

option-thông tin / / lựa chọn
Nếu tùy chọn là một tùy chọn lựa chọn, các lựa chọn khả dĩ. Lựa chọn đó là
số nguyên có thể được bao gồm hoặc không (chúng có thể được ngụ ý bởi phút và tối đa).
Lưu ý rằng các tùy chọn hoạt động giống như các tùy chọn lựa chọn, nhưng không thực tế
các tùy chọn lựa chọn trong nội bộ, có thể không có sẵn thông tin này.

danh sách tài sản
Trả lại danh sách các thuộc tính cấp cao nhất.

Bất động sản Sự bành trướng
Tất cả các đối số chuỗi cho các lệnh đầu vào cũng như các tùy chọn nhất định (như
--term-Playing-msg) có thể mở rộng tài sản. Lưu ý rằng việc mở rộng thuộc tính không
không hoạt động ở những nơi mà các tham số số được mong đợi. (Ví dụ, thêm vào
lệnh không mở rộng thuộc tính. Các định lệnh là một ngoại lệ và không phải là một chung
qui định.)

Ví dụ cho input.conf

i hiển thị văn bản Tên tập tin: $ {filename}
hiển thị tên tệp của tệp hiện tại khi nhấn i chính

Trong thời hạn đầu vào.conf, việc mở rộng tài sản có thể bị hạn chế bằng cách đặt nguyên tiền tố ở phía trước
của các lệnh.

Các bản mở rộng sau được hỗ trợ:

$ {NAME}
Mở rộng giá trị của tài sản TÊN. Nếu truy xuất thuộc tính không thành công, hãy mở rộng
thành một chuỗi lỗi. (Sử dụng $ {NAME:} với một dấu vết : để mở rộng thành một chuỗi rỗng
thay vào đó.) Nếu TÊN có tiền tố là =, mở rộng đến giá trị thô của tài sản (xem
phần bên dưới).

$ {NAME: STR}
Mở rộng giá trị của tài sản TÊN, hoặc là STR nếu tài sản không thể
lấy lại. STR được mở rộng một cách đệ quy.

$ {? NAME: STR}
Mở rộng thành STR (đệ quy) nếu thuộc tính TÊN có sẵn

$ {! NAME: STR}
Mở rộng thành STR (đệ quy) nếu thuộc tính TÊN không thể lấy lại được.

$ {? NAME == VALUE: STR}
Mở rộng thành STR (đệ quy) nếu thuộc tính TÊN mở rộng thành một chuỗi bằng
VALUE . Bạn có thể tiền tố TÊN với = để so sánh giá trị thô của một tài sản
(xem phần bên dưới). Nếu thuộc tính không khả dụng hoặc các lỗi khác xảy ra khi
truy xuất nó, giá trị không bao giờ được coi là bằng nhau. Lưu ý rằng VALUE không thể chứa
bất kỳ ký tự nào : or }. Ngoài ra, có thể thoát bằng " or % Might
sẽ được bổ sung trong tương lai, nếu nhu cầu phát sinh.

$ {! NAME == VALUE: STR}
Tương tự như với ? biến thể, nhưng STR được mở rộng nếu giá trị không bằng nhau. (Sử dụng
ngữ nghĩa tương tự như với ?.)

$$ Mở rộng thành $.

$} Mở rộng thành }. (Để tạo ký tự này bên trong mở rộng đệ quy.)

$> Tắt tính năng mở rộng thuộc tính và xử lý đặc biệt $ cho phần còn lại của chuỗi.

Ở những nơi cho phép mở rộng tài sản, các cuộc vượt ngục kiểu C cũng thường được chấp nhận.
Ví dụ:

· \n trở thành một nhân vật dòng mới

· \\ mở rộng đến \

Nguyên và Formatted Bất động sản
Thông thường, các thuộc tính được định dạng dưới dạng văn bản mà con người có thể đọc được, có nghĩa là hiển thị trên OSD hoặc
trên thiết bị đầu cuối. Có thể truy xuất giá trị chưa được định dạng (thô) từ một thuộc tính bằng cách
tiền tố tên của nó bằng =. Các giá trị thô này có thể được phân tích cú pháp bởi các chương trình khác và tuân theo
các quy ước tương tự như các tùy chọn được liên kết với các thuộc tính.

Các ví dụ

· $ {time-pos} mở rộng đến 00:14:23 (nếu vị trí phát lại là 14 phút 23 giây)

· $ {= time-pos} mở rộng đến 863.4 (cùng thời gian, cộng với 400 mili giây - mili giây là
thường không được hiển thị trong trường hợp được định dạng)

Đôi khi, sự khác biệt về lượng thông tin do thuộc tính thô và định dạng mang theo
giá trị có thể khá lớn. Trong một số trường hợp, giá trị thô có nhiều thông tin hơn, chẳng hạn như
chính xác hơn giây với thời gian. Đôi khi nó là ngược lại, ví dụ: viện trợ chương trình
tiêu đề và ngôn ngữ bản nhạc trong trường hợp được định dạng, nhưng chỉ số bản nhạc nếu nó là bản thô.

ON MÀN CONTROLLER

Bộ điều khiển trên màn hình (viết tắt: OSC) là một GUI tối thiểu được tích hợp với mpv để cung cấp
khả năng điều khiển chuột. Nó nhằm mục đích giúp người dùng mới tương tác dễ dàng hơn và
cho phép tìm kiếm chính xác và trực tiếp.

OSC được bật theo mặc định nếu mpv được biên dịch với sự hỗ trợ của Lua. Nó có thể bị vô hiệu hóa
hoàn toàn sử dụng --osc = không tùy chọn.

Sử dụng các OSC
Theo mặc định, OSC sẽ hiển thị bất cứ khi nào con chuột được di chuyển bên trong cửa sổ trình phát và
sẽ ẩn nếu chuột không được di chuyển ra ngoài OSC trong 0.5 giây hoặc nếu chuột rời khỏi
cửa sổ.

Giao thức
+ ------------------ + ----------- + ------------------ - +
| danh sách phát trước | tiêu đề | danh sách phát tiếp theo |
+ ------- + ------ + --- + - + ------ + - + ---- + ------ + ------ - +
| âm thanh | bỏ qua | tìm kiếm | | tìm kiếm | bỏ qua | đầy đủ |
+ ------- + quay lại | trở lại | chơi | frwd | frwd | màn hình |
| phụ | | | | | | |
+ ------- + ------ + ------ + ------ + ------ + ------ + ------ - +
| thanh tìm kiếm |
+ ---------------- + -------------- + ----------------- - +
| thời gian trôi qua | tình trạng bộ nhớ cache | thời gian còn lại |
+ ---------------- + -------------- + ----------------- - +

danh sách trước

┌───────────────┬──────────────────────────────────┐
│lên trái, nhấp │ phát tệp trước đó trong danh sách phát │
├───────────────┼──────────────────────────────────┤
│shift + L-click │ hiển thị danh sách phát │
└───────────────┴──────────────────────────────────┘

tiêu đề
Hiển thị tiêu đề phương tiện hoặc tên tệp hiện tại

-
│là nhấp chuột trái │ hiển thị vị trí danh sách phát và │
│ │ độ dài và tiêu đề đầy đủ │
-
│ nhấp chuột phải │ hiển thị tên tệp │
-

danh sách tiếp theo

┌─────────────────────────────────────────────
│lên trái-nhấp │ phát tệp tiếp theo trong danh sách phát │
├────────────────┼────────────────────────────
│shift + L-click │ hiển thị danh sách phát │
└─────────────────────────────────────────────

âm thanh và phụ
Hiển thị bản nhạc đã chọn và số lượng bản nhạc có sẵn

┌───────────────┬──────────────────────────────────── ┐
│left-nhấp chuột │ chuyển tiếp âm thanh / bản nhạc phụ về phía trước │
├───────────────┼───────────────────────────── ┤
│ nhấp chuột phải │ xoay vòng các rãnh âm thanh / phụ về phía sau │
├───────────────┼───────────────────────────── ┤
│shift + L-click │ hiển thị các bản âm thanh / phụ có sẵn │
└───────────────┴──────────────────────────────────── ┘

bỏ qua trở lại

┌───────────────┬──────────────────────────────────── ┐
Left-click │ chuyển đến đầu chương / │
│ │ chương trước │
├───────────────┼───────────────────────────── ┤
│shift + L-click │ hiển thị các chương │
└───────────────┴──────────────────────────────────── ┘

tìm kiếm trở lại

┌───────────────┬───────────────────────┐
│ nhấp chuột trái │ quay lại 5 giây │
├───────────────┼───────────────────────┤
│ nhấp chuột phải │ quay lại 30 giây │
├───────────────┼───────────────────────┤
│shift-L-nhấp chuột │ bỏ qua quay lại 1 khung hình │
└───────────────┴───────────────────────┘

chơi

┌────────────┬────────────────────
│ nhấp chuột trái │ chuyển đổi phát / tạm dừng │
└────────────┴────────────────────

tìm kiếm kết thúc

┌───────────────┬──────────────────────────┐
│lựa chuột trái │ tua đi 10 giây │
├───────────────┼──────────────────────────┤
│ nhấp chuột phải │ tua đi 60 giây │
├───────────────┼──────────────────────────┤
│shift-L-nhấp chuột │ chuyển tiếp 1 khung hình │
└───────────────┴──────────────────────────┘

bỏ qua kết thúc

┌───────────────┬─────────────────
│ nhấp chuột trái │ chuyển sang chương tiếp theo │
├───────────────┼─────────────────
│shift + L-click │ hiển thị các chương │
└───────────────┴─────────────────

toàn màn hình

┌────────────┬────────────────────
│ nhấp chuột trái │ chuyển đổi toàn màn hình │
└────────────┴────────────────────

tìm kiếm quán bar
Cho biết vị trí phát lại hiện tại và vị trí của các chương

┌────────────┬───────────────────
│lựa chuột trái │ tìm kiếm vị trí │
└────────────┴───────────────────

thời gian thông qua
Hiển thị dấu thời gian vị trí phát lại hiện tại

┌────────────┬───────────────────────────────────
│left-nhấp chuột │ chuyển đổi hiển thị mã thời gian với │
│ │ mili giây │
└────────────┴───────────────────────────────────

bộ nhớ cache tình trạng
Hiển thị trạng thái lấp đầy bộ nhớ cache hiện tại (chỉ hiển thị khi dưới 45%)

thời gian còn lại
Hiển thị dấu thời gian phát lại còn lại

┌────────────┬───────────────────────────────────
│left-nhấp chuột │ để chuyển đổi giữa tổng và │
│ │ thời gian còn lại │
└────────────┴───────────────────────────────────

Key Bindings
Các liên kết khóa này được kích hoạt theo mặc định nếu không có gì khác đã được liên kết với các khóa này.
Trong trường hợp va chạm, chức năng cần được liên kết với một khóa khác. Xem Script
Lệnh phần.

┌────┬────────────────────────────────
│del │ Ẩn OSC vĩnh viễn cho đến khi │
│ │ mpv được khởi động lại. │
└────┴────────────────────────────────

Cấu hình
OSC cung cấp cấu hình giới hạn thông qua một tệp cấu hình lua-settings / osc.conf đặt trong
người dùng của mpv và thông qua --script-opt tùy chọn dòng lệnh. Các tùy chọn được cung cấp thông qua
dòng lệnh sẽ ghi đè chúng từ tệp cấu hình.

Config cú pháp
Tệp cấu hình phải tuân theo chính xác cú pháp sau:

# đây là một nhận xét
optionA = value1
optionB = value2

# chỉ có thể được sử dụng ở đầu dòng và có thể không có khoảng trắng xung quanh = or
bất cứ nơi nào khác.

Dòng lệnh cú pháp
Để tránh va chạm với các tập lệnh khác, tất cả các tùy chọn cần phải có tiền tố OSC-.

Ví dụ:

--script-opts = osc-optionA = value1, osc-optionB = value2

Cấu hình Các lựa chọn
khoe khoang
Mặc định: có
Bật OSC khi cửa sổ

màn hình hiển thị
Mặc định: có
Bật OSC khi toàn màn hình

có vảy
Mặc định: 1.0
Hệ số tỷ lệ của OSC khi được cửa sổ

quy mô toàn màn hình
Mặc định: 1.0
Hệ số tỷ lệ của OSC khi toàn màn hình

quy mô cửa sổ cưỡng bức
Mặc định: 2.0
Hệ số tỷ lệ của OSC khi được hiển thị trên một cửa sổ bắt buộc (giả)

vidscale
Mặc định: có
Quy mô OSC với video
Không cố gắng giữ cho kích thước OSC không đổi nhiều như kích thước cửa sổ cho phép

giá trị
Mặc định: 0.8
Căn chỉnh theo chiều dọc, -1 (trên cùng) đến 1 (dưới cùng)

căn chỉnh
Mặc định: 0.0
Căn chỉnh theo chiều ngang, -1 (trái) đến 1 (phải)

hộpalpha
Mặc định: 80
Alpha của hộp nền, 0 (mờ) đến 255 (hoàn toàn trong suốt)

thời gian ẩn náu
Mặc định: 500
Thời gian tính bằng mili giây cho đến khi OSC ẩn nếu không có chuyển động chuột, giá trị âm
tắt tính năng tự động ẩn

khoảng thời gian mờ dần
Mặc định: 200
Thời gian mất dần tính bằng mili giây, 0 = không phai

kích thước vùng chết
Mặc định: 0
Kích thước của vùng chết. Vùng chết là khu vực khiến chuột hoạt động
như rời khỏi cửa sổ. Chuyển động ở đó sẽ không làm cho OSC xuất hiện và
nó sẽ ẩn ngay lập tức nếu con chuột xâm nhập vào nó. Vùng chết bắt đầu
ở đường viền cửa sổ đối diện với OSC và kích thước kiểm soát bao nhiêu
của cửa sổ nó sẽ kéo dài. Giá trị từ 0 đến 1.

minmousemove
Mặc định: 3
Số lượng pixel tối thiểu mà chuột phải di chuyển giữa các lần đánh dấu để tạo ra
OSC hiển thị

bố trí
Mặc định: hộp
Bố cục cho OSC. Hiện có sẵn: hộp, hộp mỏng,
đáy và thanh trên cùng.

phong cách tìm kiếm
Mặc định: thanh trượt
Đặt kiểu của thanh tìm kiếm, thanh trượt (điểm đánh dấu kim cương) hoặc thanh (tô)

thời gian
Mặc định: không
Hiển thị tổng thời gian thay vì thời gian còn lại

hẹn giờ
Mặc định: không
Hiển thị mã thời gian với mili giây

Script Lệnh
Tập lệnh OSC lắng nghe các lệnh tập lệnh nhất định. Các lệnh này có thể ràng buộc trong đầu vào.conf,
hoặc được gửi bởi các tập lệnh khác.

kích hoạt-osc
Hoàn tác vô hiệu hóa-osc hoặc ảnh hưởng của các Chìa khóa.

vô hiệu hóa-osc
Ẩn OSC vĩnh viễn. Đây cũng là những gì các chìa khóa nào.

osc-tin nhắn
Hiển thị thông báo trên màn hình bằng OSC. Đối số đầu tiên là thông báo, đối số thứ hai là
thời lượng tính bằng giây.

Ví dụ

Bạn có thể đặt cái này vào đầu vào.conf để ẩn OSC với a chìa khóa và để hiện nó bằng b:

một script_message vô hiệu hóa-osc
b script_message kích hoạt-osc

LUA ĐIÊU KHẮC

mpv có thể tải các tập lệnh Lua. Tập lệnh được chuyển đến --kịch bản hoặc tìm thấy trong kịch bản
thư mục con của thư mục cấu hình mpv (thường là ~ / .config / mpv / scripts /) sẽ là
được tải khi bắt đầu chương trình. mpv cũng nối kịch bản thư mục con đến cuối Lua
đường dẫn để bạn cũng có thể nhập các tập lệnh từ đó. Vì nó được thêm vào cuối nên không đặt tên
các tập lệnh bạn muốn nhập giống như thư viện Lua vì chúng sẽ bị lu mờ bởi
Chúng.

mpv cung cấp mô-đun tích hợp sẵn mp, chứa các hàm để gửi lệnh tới mpv
cốt lõi và để truy xuất thông tin về trạng thái phát lại, cài đặt người dùng, thông tin tệp,
và như vậy.

Các tập lệnh này có thể được sử dụng để điều khiển mpv theo cách tương tự như chế độ nô lệ. Về mặt kỹ thuật,
Mã Lua sử dụng API ứng dụng khách trong nội bộ.

Ví dụ
Một tập lệnh rời khỏi chế độ toàn màn hình khi trình phát bị tạm dừng:

function on_pause_change (tên, giá trị)
nếu giá trị == true thì
mp.set_property ("toàn màn hình", "không")
cuối
cuối
mp.observe_property ("tạm dừng", "bool", on_pause_change)

Chi Tiết on các kịch bản khởi tạo và vòng đời
Tập lệnh của bạn sẽ được tải bởi trình phát khi chương trình bắt đầu từ kịch bản cấu hình
thư mục con hoặc từ một đường dẫn được chỉ định với --kịch bản quyền mua. Một số tập lệnh được tải
nội bộ (như --osc). Mỗi tập lệnh chạy trong một chuỗi riêng của nó. Tập lệnh của bạn được chạy lần đầu tiên "với tư cách là
là "và sau khi hoàn tất, vòng lặp sự kiện sẽ được nhập. Vòng lặp sự kiện này sẽ gửi
các sự kiện do mpv nhận và gọi các trình xử lý sự kiện của riêng bạn mà bạn đã đăng ký
mp.register_eventhoặc bộ hẹn giờ được thêm vào mp.add_timeout hoặc tương tự.

Khi người chơi thoát, tất cả các tập lệnh sẽ được yêu cầu kết thúc. Điều này xảy ra thông qua một tắt máy
sự kiện, theo mặc định sẽ làm cho vòng lặp sự kiện trở lại. Nếu kịch bản của bạn dính vào một
vòng lặp vô tận, mpv có thể sẽ hoạt động tốt trong khi phát lại (trừ khi trình phát
bị đình chỉ, hãy xem mp.tạm dừng), nhưng nó sẽ không kết thúc khi bỏ thuốc, vì nó đang chờ
kịch bản của bạn.

Trong nội bộ, mã C sẽ gọi hàm Lua mp_event_loop sau khi tải một Lua
script. Chức năng này thường được xác định bởi đoạn dạo đầu mặc định được tải trước tập lệnh của bạn
(xem player / lua / defaults.lua trong các nguồn mpv). Vòng lặp sự kiện sẽ đợi các sự kiện và
sự kiện cử đi đã đăng ký với mp.register_event. Nó cũng sẽ xử lý các bộ hẹn giờ được thêm vào
mp.add_timeout và tương tự (bằng cách chờ đợi với thời gian chờ).

Kể từ mpv 0.6.0, người chơi sẽ đợi cho đến khi tập lệnh được tải đầy đủ trước khi tiếp tục
hoạt động binh thương. Người chơi coi một tập lệnh được tải đầy đủ ngay khi nó bắt đầu
đang chờ các sự kiện mpv (hoặc nó thoát). Trong thực tế, điều này có nghĩa là người chơi sẽ ít nhiều
treo cho đến khi tập lệnh trở lại từ đoạn chính (và mp_event_loop được gọi là), hoặc
các cuộc gọi kịch bản mp_event_loop or mp.dispatch_events trực tiếp. Điều này được thực hiện để làm cho nó
có thể cho một tập lệnh để thiết lập đầy đủ các trình xử lý sự kiện, v.v. trước khi phát lại thực sự bắt đầu.
Trong các phiên bản mpv cũ hơn, điều này xảy ra không đồng bộ.

mp chức năng
mp mô-đun được tải trước, mặc dù nó có thể được tải theo cách thủ công với yêu cầu 'mp'. Nó
cung cấp API ứng dụng khách cốt lõi.

mp.command (chuỗi)
Chạy lệnh đã cho. Điều này tương tự như các lệnh được sử dụng trong input.conf. Nhìn thấy
Danh sách of Đầu vào Lệnh.

Theo mặc định, điều này sẽ hiển thị một cái gì đó trên OSD (tùy thuộc vào lệnh), như thể
nó đã được sử dụng trong đầu vào.conf. Thấy Đầu vào Lệnh Tiền tố làm thế nào để ảnh hưởng đến việc sử dụng OSD
mỗi lệnh.

Hoàn trả đúng về thành công, hoặc không, lôi về lỗi.

mp.commandv (arg1, arg2, ...)
Tương tự như mp.command, nhưng chuyển mỗi đối số lệnh dưới dạng tham số riêng biệt. Đây
có lợi thế là bạn không phải quan tâm đến việc trích dẫn và thoát trong một số
các trường hợp.

Ví dụ:

mp.command ("loadfile" .. filename .. "append")
mp.commandv ("loadfile", filename, "append")

Hai lệnh này tương đương nhau, ngoại trừ việc phiên bản đầu tiên bị hỏng nếu
tên tệp chứa khoảng trắng hoặc các ký tự đặc biệt nhất định.

Lưu ý rằng các thuộc tính là không được mở rộng. Bạn có thể sử dụng một trong hai mp.command, Các
mở rộng thuộc tính tiền tố, hoặc mp.get_property họ các chức năng.

Không giống như mp.command, điều này sẽ không sử dụng OSD theo mặc định (ngoại trừ một số
Các lệnh dành riêng cho OSD).

mp.command_native (bảng [, def])
Tương tự như mp.commandv, nhưng chuyển danh sách đối số dưới dạng bảng. Điều này có lợi thế
rằng trong ít nhất một số trường hợp, các đối số có thể được chuyển dưới dạng các kiểu gốc.

Trả về một bảng kết quả khi thành công (thường là trống) hoặc phản đối, lôi về lỗi. def is
tham số thứ hai được cung cấp cho hàm và bằng không nếu nó bị thiếu.

mp.get_property (tên [, def])
Trả về giá trị của thuộc tính đã cho dưới dạng chuỗi. Đây là những thuộc tính giống như
được sử dụng trong input.conf. Nhìn thấy Bất động sản để biết danh sách các thuộc tính. Chuỗi trả về là
được định dạng tương tự như $ {= name} (xem Bất động sản Sự bành trướng).

Trả về chuỗi thành công hoặc phản đối, lôi về lỗi. def là tham số thứ hai
được cung cấp cho hàm, và sẽ không có nếu nó bị thiếu.

mp.get_property_osd (tên [, def])
Tương tự như mp.get_property, nhưng trả về giá trị thuộc tính được định dạng cho OSD. Đây
là chuỗi giống như được in với $ {name} khi được sử dụng trong input.conf.

Trả về chuỗi thành công hoặc phản đối, lôi về lỗi. def là tham số thứ hai
được cung cấp cho hàm và là một chuỗi trống nếu nó bị thiếu. không giống
get_property (), việc gán giá trị trả về cho một biến sẽ luôn dẫn đến
chuỗi.

mp.get_property_bool (tên [, def])
Tương tự như mp.get_property, nhưng trả về giá trị thuộc tính là Boolean.

Trả về Boolean khi thành công hoặc phản đối, lôi về lỗi.

mp.get_property_number (tên [, def])
Tương tự như mp.get_property, nhưng trả về giá trị thuộc tính dưới dạng số.

Lưu ý rằng mặc dù Lua không phân biệt giữa số nguyên và số thực, nhưng nội bộ mpv
làm. Hàm này chỉ cần yêu cầu một float kép từ mpv và mpv thường sẽ
chuyển đổi các giá trị thuộc tính số nguyên thành float.

Trả về một số thành công hoặc phản đối, lôi về lỗi.

mp.get_property_native (tên [, def])
Tương tự như mp.get_property, nhưng trả về giá trị thuộc tính bằng cách sử dụng loại Lua tốt nhất
cho tài sản. Thông thường, điều này sẽ trả về một chuỗi, Boolean hoặc số. Một số
thuộc tính (ví dụ danh sách chương) được trả về dưới dạng bảng.

Trả về giá trị thành công hoặc phản đối, lôi về lỗi. Lưu ý rằng hư không có thể là một
có thể, giá trị hợp lệ quá trong một số trường hợp góc.

mp.set_property (tên, giá trị)
Đặt thuộc tính đã cho thành giá trị chuỗi đã cho. Nhìn thấy mp.get_property và
Bất động sản để biết thêm thông tin về tài sản.

Trả về true khi thành công, hoặc không, lôi về lỗi.

mp.set_property_bool (tên, giá trị)
Tương tự như mp.set_property, nhưng đặt thuộc tính đã cho thành giá trị Boolean đã cho.

mp.set_property_number (tên, giá trị)
Tương tự như mp.set_property, nhưng hãy đặt thuộc tính đã cho thành giá trị số đã cho.

Lưu ý rằng mặc dù Lua không phân biệt giữa số nguyên và số thực, nhưng nội bộ mpv
làm. Hàm này sẽ kiểm tra xem số có thể được biểu diễn dưới dạng số nguyên hay không và
nếu vậy, nó sẽ chuyển một giá trị nguyên cho mpv, nếu không thì là một số thực kép.

mp.set_property_native (tên, giá trị)
Tương tự như mp.set_property, nhưng hãy đặt thuộc tính đã cho bằng cách sử dụng kiểu gốc của nó.

Vì có một số kiểu dữ liệu không thể biểu diễn nguyên bản trong Lua, điều này
có thể không phải lúc nào cũng hoạt động như mong đợi. Ví dụ: trong khi trình bao bọc Lua có thể thực hiện một số
phỏng đoán để quyết định xem bảng Lua là một mảng hay một bản đồ, điều này sẽ không thành công với
bàn trống. Ngoài ra, không có nhiều thuộc tính phù hợp để sử dụng
cái này, thay vì set_property, set_property_bool, set_property_number. Đối với những
lý do, có lẽ nên tránh chức năng này ngay bây giờ, ngoại trừ các thuộc tính
sử dụng bảng nguyên bản.

mp.get_time ()
Trả về thời gian nội bộ mpv hiện tại tính bằng giây dưới dạng một số. Về cơ bản đây là
thời gian hệ thống, với một độ lệch tùy ý.

mp.add_key_binding (key, tên | fn [, fn [, cờ]])
Đăng ký gọi lại để được chạy trên một ràng buộc khóa. Ràng buộc sẽ được ánh xạ tới
được chính, là một chuỗi mô tả khóa vật lý. Điều này sử dụng cùng một khóa
tên như trong input.conf, và cũng cho phép kết hợp (ví dụ: ctrl + a).

Sau khi gọi chức năng này, các phím bấm sẽ gây ra chức năng fn được gọi là
(trừ khi người dùng ánh xạ lại khóa với một ràng buộc khác).

tên đối số phải là một chuỗi ký hiệu ngắn. Nó cho phép người dùng remap
ràng buộc khóa thông qua input.conf bằng cách sử dụng script_message lệnh và tên của
ràng buộc khóa (xem ví dụ bên dưới). Tên phải là duy nhất trên các
các ràng buộc trong cùng một tập lệnh - nếu không, liên kết trước đó có cùng tên sẽ
bị ghi đè. Bạn có thể bỏ qua tên, trong trường hợp đó, một tên ngẫu nhiên được tạo
nội bộ

Đối số cuối cùng được sử dụng cho các cờ tùy chọn. Đây là một bảng, có thể có
các mục sau:

có thể lặp lại
Nếu được đặt thành đúng, cho phép lặp lại phím cho ràng buộc cụ thể này.

phức tạp
Nếu được đặt thành đúngthì fn được gọi trên cả sự kiện quan trọng lên và xuống (cũng như
dưới dạng lặp lại phím, nếu được bật), với đối số đầu tiên là một bảng. Đây
bàn có một sự kiện mục nhập, được đặt thành một trong các chuỗi xuống,
lặp lại, up or nhấn (cái sau nếu phím lên / xuống không thể theo dõi). Nó
hơn nữa có một is_mouse mục nhập, cho biết liệu sự kiện có được gây ra hay không
bằng một nút chuột.

Trong nội bộ, các ràng buộc chính được gửi qua script_message_to or script_bind
lệnh đầu vào và mp.register_script_message.

Cố gắng ánh xạ nhiều lệnh với một khóa về cơ bản sẽ thích một ràng buộc ngẫu nhiên,
trong khi các ràng buộc khác không được gọi. Nó được đảm bảo rằng người dùng đã xác định
các liên kết trong đầu vào trung tâm.conf được ưu tiên hơn các liên kết được thêm vào
chức năng (nhưng hãy xem mp.add_forced_key_bind).

Ví dụ:

function something_handler ()
print ("phím đã được nhấn")
cuối
mp.add_key_binding ("x", "something", something_handler)

Điều này sẽ in tin nhắn các chính là ép lại khi nào x đã được ép.

Người dùng có thể ánh xạ lại các ràng buộc chính này. Sau đó, người dùng phải đưa những điều sau vào
input.conf của anh ấy để ánh xạ lại lệnh thành y Chìa khóa:

y script_binding cái gì đó

Thao tác này sẽ in thông báo khi khóa y bị ép buộc. (x sẽ vẫn hoạt động, trừ khi
người dùng sửa lại nó.)

Bạn cũng có thể gửi tin nhắn một cách rõ ràng chỉ đến một tập lệnh đã đặt tên. Giả sử như trên
script đã sử dụng tên tệp fooscript.lua:

y script_binding fooscript.s Something

mp.add_forced_key_binding (...)
Điều này hoạt động gần giống như mp.add_key_bind, nhưng đăng ký ràng buộc khóa trong
một cách sẽ ghi đè lên các ràng buộc tùy chỉnh của người dùng trong input.conf của anh ta.
(mp.add_key_bind chỉ ghi đè các ràng buộc khóa mặc định, chứ không ghi đè các ràng buộc bằng
input.conf của người dùng.)

mp.remove_key_binding (tên)
Xóa một ràng buộc khóa được thêm vào mp.add_key_bind or mp.add_forced_key_bind.
Sử dụng cùng tên mà bạn đã sử dụng khi thêm các liên kết. Không thể gỡ bỏ
ràng buộc mà bạn đã bỏ qua tên.

mp.register_event (tên, fn)
Gọi một chức năng cụ thể khi một sự kiện xảy ra. Tên sự kiện là một chuỗi và
hàm fn là một giá trị hàm Lua.

Một số sự kiện có dữ liệu liên quan. Điều này được đưa vào bảng Lua và được chuyển như
đối số fn. Theo mặc định, bảng Lua chứa một tên trường, là một chuỗi
chứa tên sự kiện. Nếu sự kiện có lỗi liên quan, lôi lĩnh vực là
đặt thành một chuỗi mô tả lỗi, khi thành công, nó không được đặt.

Nếu nhiều chức năng được đăng ký cho cùng một sự kiện, chúng sẽ được chạy trong
thứ tự đăng ký, mà chức năng đã đăng ký đầu tiên chạy trước tất cả
những cái khác.

Trả về true nếu sự kiện như vậy tồn tại, nếu không thì trả về false.

Xem Sự kiện và Danh sách of sự kiện để biết thêm chi tiết.

mp.unregister_event (fn)
Undo mp.register_event (..., fn). Thao tác này sẽ xóa tất cả các trình xử lý sự kiện bằng
các fn tham số. Điều này sử dụng Lua bình thường == so sánh, vì vậy hãy cẩn thận khi giao dịch
có đóng cửa.

mp.observe_property (tên, kiểu, fn)
Xem một thuộc tính để biết những thay đổi. Nếu tài sản tên được thay đổi, sau đó chức năng
fn (tên) sẽ được gọi. kiểu có thể hư khônghoặc được đặt thành một trong số không ai, tự nhiên, bool,
chuỗi, hoặc là con số. không ai giống như hư không. Đối với tất cả các giá trị khác, giá trị mới của
thuộc tính sẽ được chuyển làm đối số thứ hai cho fn, Sử dụng mp.get_property_
để lấy nó. Điều này có nghĩa là nếu kiểu là ví dụ chuỗi, fn đại khái được gọi là
in fn (tên, mp.get_property_string (tên)).

Nếu có thể, các sự kiện thay đổi được liên kết với nhau. Nếu một thuộc tính bị thay đổi nhiều lần
liên tiếp, chỉ thay đổi cuối cùng mới kích hoạt chức năng thay đổi. (Hành vi chính xác
phụ thuộc vào thời gian và những thứ khác.)

Trong một số trường hợp, hàm không được gọi ngay cả khi thuộc tính thay đổi. Cho dù
điều này có thể xảy ra tùy thuộc vào tài sản.

Nếu kiểu is không ai or hư không, các sự kiện thay đổi tài sản lẻ tẻ có thể xảy ra. Đây
có nghĩa là chức năng thay đổi fn có thể được gọi ngay cả khi thuộc tính không thực sự
thay đổi.

mp.unobserve_property (fn)
Undo mp.observe_property (..., fn). Thao tác này sẽ xóa tất cả các trình xử lý thuộc tính
bằng với fn tham số. Điều này sử dụng Lua bình thường == so sánh, vì vậy hãy cẩn thận khi
đối phó với việc đóng cửa.

mp.add_timeout (giây, fn)
Gọi hàm đã cho là fn khi số giây đã cho đã trôi qua. Lưu ý rằng
số giây có thể là phân số. Hiện tại, độ phân giải của bộ hẹn giờ có thể là
thấp nhất là 50 ms, mặc dù điều này sẽ được cải thiện trong tương lai.

Đây là bộ đếm thời gian một phát: nó sẽ bị xóa khi nó được bắn.

Trả về một đối tượng hẹn giờ. Nhìn thấy mp.add_ Periodic_timer để biết thêm chi tiết.

mp.add_periodic_timer (giây, fn)
Gọi hàm đã cho theo chu kỳ. Điều này giống như mp.add_timeout, nhưng bộ đếm thời gian là
được thêm lại sau khi chạy hàm fn.

Hoàn trả a bộ đếm thời gian vật. bộ đếm thời gian vật cung cấp các tiếp theo phương pháp:

dừng lại() Tắt bộ hẹn giờ. Không có gì nếu bộ hẹn giờ đã bị tắt.
Điều này sẽ ghi nhớ thời gian đã trôi qua hiện tại khi dừng lại, để
bản tóm tắt() về cơ bản bỏ tạm dừng bộ hẹn giờ.

giết chết() Tắt bộ hẹn giờ. Đặt lại thời gian đã trôi qua. bản tóm tắt() sẽ khởi động lại
hẹn giờ.

bản tóm tắt()
Khởi động lại bộ hẹn giờ. Nếu bộ hẹn giờ bị tắt với dừng lại(), điều này sẽ
tiếp tục tại thời điểm nó đã được dừng lại. Nếu bộ hẹn giờ bị tắt với
giết chết()hoặc nếu đó là bộ đếm thời gian chụp một lần đã được kích hoạt trước đây (được thêm vào
add_timeout ()), điều này bắt đầu bộ hẹn giờ từ đầu, sử dụng
thời gian chờ được định cấu hình ban đầu.

thời gian chờ (RW)
Trường này chứa khoảng thời gian chờ hiện tại. Giá trị này không
cập nhật theo thời gian. Nó chỉ được sử dụng để tính toán khi
bộ hẹn giờ sẽ kích hoạt tiếp theo khi bộ hẹn giờ hết hạn.

Nếu bạn viết điều này, bạn có thể gọi t: giết () ; t: sơ yếu lý lịch () để đặt lại
thời gian chờ hiện tại sang cái mới. (t: dừng lại () sẽ không sử dụng thời gian chờ mới.)

một Châu (RW)
Bộ hẹn giờ có định kỳ hay không (sai) hoặc chỉ kích hoạt một lần (đúng). Điều này
giá trị được sử dụng khi bộ hẹn giờ hết hạn (nhưng trước khi bộ hẹn giờ gọi lại
hàm fn được chạy).

Lưu ý rằng đây là các phương thức và bạn phải gọi chúng bằng cách sử dụng : thay vì . (Tham khảo
đến http://www.lua.org/manual/5.2/manual.html#3.4.9 .)

Ví dụ:

giây = 0
timer = mp.add_periodic_timer (1, function ()
print ("được gọi mỗi giây")
# dừng lại sau 10 giây
giây = giây + 1
nếu giây> = 10 thì
timer: kill ()
cuối
kết thúc)

mp.get_opt (key)
Trả lại một cài đặt từ --script-opt quyền mua. Nó phụ thuộc vào người dùng và tập lệnh
cơ chế này được sử dụng như thế nào. Hiện tại, tất cả các tập lệnh đều có thể truy cập điều này như nhau, vì vậy bạn
nên cẩn thận về va chạm.

mp.get_script_name ()
Trả lại tên của tập lệnh hiện tại. Tên thường được làm bằng tên tệp của
tập lệnh, với phần mở rộng thư mục và tệp đã bị xóa. Nếu có một số kịch bản
sẽ có cùng tên, nó được tạo thành duy nhất bằng cách thêm một số.

Ví dụ

Kịch bản /path/to/fooscript.lua trở thành bản thảo.

mp.osd_message (text [,khoảng thời gian])
Hiển thị thông báo OSD trên màn hình. thời gian tính bằng giây và là tùy chọn (sử dụng
--osd-thời lượng theo mặc định).

Nâng cao mp chức năng
Chúng cũng sống trong mp mô-đun, nhưng được ghi lại một cách riêng biệt vì chúng chỉ hữu ích trong
những tình huống đặc biệt.

mp.suspend ()
Tạm dừng vòng lặp chính mpv. Có một lời giải thích dài dòng về điều này trong API C
chức năng mpv_suspend (). Tóm lại, điều này ngăn người chơi hiển thị
khung video để bạn không bị chặn khi cố truy cập trình phát.

Điều này được tự động gọi bởi trình xử lý sự kiện.

mp.resume ()
Hoàn tác một mp.suspend () gọi. mp.suspend () tăng một bộ đếm nội bộ và
mp.resume () giảm nó. Khi đạt đến 0, trình phát thực sự được tiếp tục.

mp.resume_all ()
Thao tác này sẽ đặt lại bộ đếm tạm ngừng bên trong và tiếp tục trình phát. (Nó giống như cách gọi
mp.resume () cho đến khi trình phát thực sự được tiếp tục lại.)

Bạn có thể muốn gọi số này nếu bạn sắp làm việc gì đó mất nhiều thời gian,
nhưng không thực sự cần quyền truy cập vào trình phát (như hoạt động mạng). Lưu ý rằng
bạn vẫn có thể truy cập trình phát bất kỳ lúc nào.

mp.get_wakeup_pipe ()
Cuộc gọi mpv_get_wakeup_pipe () và trả về phần cuối đã đọc của đường dẫn đánh thức. (Nhìn thấy
khách hàng.h để biết chi tiết.)

mp.get_next_timeout ()
Trả lại thời gian tương đối tính bằng giây khi bộ hẹn giờ tiếp theo (mp.add_timeout và
tương tự) hết hạn. Nếu không có hẹn giờ, hãy quay lại hư không.

mp.dispatch_events ([allow_wait])
Điều này có thể được sử dụng để chạy các vòng lặp sự kiện tùy chỉnh. Nếu bạn muốn kiểm soát trực tiếp những gì
tập lệnh Lua thực hiện (thay vì được gọi bởi vòng lặp sự kiện mặc định), bạn có thể
đặt biến toàn cục mp_event_loop vào chức năng của riêng bạn khi chạy vòng lặp sự kiện.
Từ vòng lặp sự kiện của bạn, bạn nên gọi mp.dispatch_events () để xếp hàng và gửi đi
sự kiện mpv.

Nếu cho phép_đợi tham số được đặt thành đúng, chức năng sẽ chặn cho đến lần tiếp theo
sự kiện được nhận hoặc bộ hẹn giờ tiếp theo hết hạn. Nếu không (và đây là mặc định
hành vi), nó trả về ngay sau khi vòng lặp sự kiện được làm trống. Nó mạnh mẽ
khuyến khích sử dụng mp.get_next_timeout () và mp.get_wakeup_pipe () Nếu bạn
quan tâm đến việc thông báo các sự kiện mới và bộ hẹn giờ làm việc hiệu quả.

Hàm này gọi mp.suspend () và mp.resume_all () một mình.

mp.enable_messages (cấp độ)
Đặt mức nhật ký tối thiểu mà đầu ra thông báo mpv sẽ nhận được. Những tin nhắn này
thường được in vào thiết bị đầu cuối. Bằng cách gọi hàm này, bạn có thể đặt
mức nhật ký tối thiểu của các thông báo sẽ được nhận với nhật ký tin nhắn biến cố.
Xem mô tả của sự kiện này để biết chi tiết. Mức độ là một chuỗi, hãy xem tin nhắn.log
cho các cấp độ nhật ký được phép.

mp.register_script_message (tên, fn)
Đây là một người trợ giúp để gửi script_message or script_message_to lời kêu gọi đến Lua
chức năng. fn được gọi là nếu script_message or script_message_to (với kịch bản này là
đích) được chạy với tên như tham số đầu tiên. Các tham số khác được chuyển
đến fn. Nếu một tin nhắn với tên cụ thể đã được đăng ký, nó sẽ bị ghi đè.

Được sử dụng bởi mp.add_key_bind, vì vậy hãy cẩn thận về những va chạm tên tuổi.

mp.unregister_script_message (tên)
Hoàn tác đăng ký trước đó với mp.register_script_message. Không có gì nếu
tên chưa được đăng ký.

mp.msg chức năng
Mô-đun này cho phép xuất thông báo tới thiết bị đầu cuối và có thể được tải bằng yêu cầu
'mp.msg'.

msg.log (cấp độ, ...)
Tham số mức là mức độ ưu tiên của thông báo. Đó là một chuỗi và một trong số gây tử vong, lôi,
cảnh báo, Thông tin, v, gỡ lỗi. Cài đặt của người dùng sẽ xác định thông báo nào trong số những thông báo này
sẽ được hiển thị. Thông thường, tất cả các tin nhắn đều hiển thị, ngoại trừ v và gỡ lỗi.

Các tham số sau đó đều được chuyển thành chuỗi. Các dấu cách được chèn vào
tách nhiều tham số.

Bạn không cần thêm dòng mới.

msg.fatal (...), msg.error (...), msg.warn (...), msg.info (...), msg.verbose (...),
msg.debug (...)
Tất cả đều là phím tắt và tương đương với msg.log (cấp độ, ...)
gọi.

mp.options chức năng
mpv đi kèm với một mô-đun tích hợp để quản lý các tùy chọn từ các tệp cấu hình và dòng lệnh.
Tất cả những gì bạn phải làm là cung cấp một bảng với các tùy chọn mặc định cho hàm read_options.
Hàm sẽ ghi đè các giá trị mặc định bằng các giá trị được tìm thấy trong tệp cấu hình và
dòng lệnh (theo thứ tự đó).

options.read_options (bảng [, định danh])
A bàn với các cặp khóa-giá trị. Loại giá trị mặc định rất quan trọng đối với
chuyển đổi các giá trị được đọc từ tệp cấu hình hoặc dòng lệnh trở lại. Không được dùng
hư không như một giá trị mặc định!

định danh được sử dụng để xác định tệp cấu hình và các tùy chọn dòng lệnh.
Những điều này cần phải duy nhất để tránh va chạm với các tập lệnh khác. Mặc định là
mp.get_script_name ().

Triển khai ví dụ:

yêu cầu 'mp.options'
tùy chọn địa phương = {
optionA = "defaultvalueA",
tùy chọnB = -0.5,
tùy chọnC = đúng,
}
read_options (tùy chọn, "myscript")
print (options.optionA)

Tệp cấu hình sẽ được lưu trữ trong lua-settings / IDfier.conf trong thư mục người dùng của mpv.
Các dòng nhận xét có thể được bắt đầu bằng # và các khoảng trắng không bị xóa bỏ. Giá trị boolean sẽ
được biểu thị bằng có / không.

Cấu hình ví dụ:

# bình luận
optionA = Hello World
optionB = 9999
optionC = không

Các tùy chọn dòng lệnh được đọc từ --script-opt tham số. Để tránh va chạm, tất cả
các khóa phải được bắt đầu bằng định danh-.

Dòng lệnh ví dụ:

--script-opts = myscript-optionA = TEST, myscript-optionB = 0, myscript-optionC = yes

mp.utils lựa chọn
Mô-đun tích hợp này cung cấp các chức năng trợ giúp chung cho Lua và nói một cách chính xác
không liên quan gì đến phát lại mpv hoặc video / âm thanh. Chúng được cung cấp để thuận tiện. Phần lớn
bù đắp cho thư viện chuẩn khan hiếm của Lua.

Hãy cảnh báo rằng bất kỳ chức năng nào trong số này có thể biến mất bất kỳ lúc nào. Họ không hoàn toàn là một phần
của API được đảm bảo.

utils.getcwd ()
Trả về thư mục mà mpv đã được khởi chạy. Có lỗi, không, lôi Được trả lại.

utils.readdir (đường dẫn [, lọc])
Liệt kê tất cả các mục nhập theo đường dẫn nhất định trên hệ thống tệp và trả lại chúng dưới dạng
mảng. Mỗi mục nhập là một mục nhập thư mục (không có đường dẫn). Danh sách không được sắp xếp
(theo bất kỳ thứ tự nào hệ điều hành trả về nó).

Nếu lọc đối số được đưa ra, nó phải là một trong các chuỗi sau:

các tập tin Chỉ liệt kê các tệp thông thường. Điều này không bao gồm các thư mục, các tệp đặc biệt (như
Tệp thiết bị UNIX hoặc FIFO) và các liên kết tượng trưng đã chết. Nó bao gồm các liên kết tượng trưng UNIX
sang các tệp thông thường.

dirs Chỉ liệt kê các thư mục hoặc các liên kết tượng trưng đến các thư mục. . và .. không
bao gồm.

bình thường Bao gồm kết quả của cả hai các tập tin và dirs. (Đây là mặc định.)

tất cả các Liệt kê tất cả các mục nhập, thậm chí cả tệp thiết bị, liên kết tượng trưng đã chết, FIFO và . và
.. mục.

Có lỗi, không, lôi Được trả lại.

utils.split_path (đường dẫn)
Chia một đường dẫn thành thành phần thư mục và thành phần tên tệp, rồi trả lại chúng. Các
giá trị trả về đầu tiên luôn là thư mục. Giá trị trả về thứ hai là dấu
một phần của đường dẫn, mục nhập thư mục.

utils.join_path (p1, tr2)
Trả lại sự nối của 2 đường dẫn. Cố gắng trở nên thông minh. Ví dụ, nếu `p2 is
một đường dẫn tuyệt đối, p2 được trả về mà không thay đổi.

utils.subprocess (t)
Chạy một tiến trình bên ngoài và đợi cho đến khi nó thoát. Trả về trạng thái quy trình và
đầu ra bắt được.

Thông số t là một cái bàn. Hàm đọc các mục sau:

args. Mảng chuỗi. Mục nhập mảng đầu tiên là tệp thực thi. Điều này có thể là
đường dẫn tuyệt đối hoặc tên tệp không có thành phần đường dẫn, trong đó
trường hợp PATH biến môi trường được sử dụng để giải quyết tệp thực thi. Các
các phần tử mảng khác được chuyển dưới dạng đối số dòng lệnh.

có thể hủy bỏ
Không bắt buộc. Nếu được đặt thành đúng (mặc định), sau đó nếu người dùng ngừng phát lại hoặc
chuyển đến tệp tiếp theo trong khi quá trình đang chạy, quá trình sẽ
bị giết.

kích thước tối đa
Không bắt buộc. Kích thước tối đa tính bằng byte của dữ liệu có thể được lấy từ
stdout. (Mặc định: 16 MB.)

Hàm trả về kết quả là một bảng với các mục sau:

tình trạng Trạng thái thoát thô của quy trình. Nó sẽ là tiêu cực về lỗi.

tiêu chuẩn Luồng đầu ra được chụp dưới dạng chuỗi, giới hạn ở kích thước tối đa.

lôi hư không về thành công. Chuỗi thiệt mạng nếu quá trình kết thúc trong một
cách khác thường. Chuỗi trong đó nếu quá trình không thể được bắt đầu.

Trên Windows, thiệt mạng chỉ được trả lại khi quá trình đã bị giết bởi
mpv là kết quả của có thể hủy bỏ được đặt thành đúng.

kill_by_us
Đặt thành đúng nếu quá trình đã bị giết bởi mpv do kết quả của
có thể hủy bỏ được đặt thành đúng.

Trong tất cả trường hợp, mp.resume_all () được gọi ngầm.

utils.parse_json (str [, đường mòn])
Phân tích cú pháp đối số chuỗi đã cho dưới dạng JSON và trả về nó dưới dạng bảng Lua. Có lỗi,
Trả về không, lôi. (Hiện nay, lôi chỉ là một chuỗi đọc lôi, bởi vì ở đó
không có báo cáo lỗi chi tiết dưới bất kỳ hình thức nào.)

Giá trị trả về sử dụng các quy ước tương tự như mp.get_property_native () đến
phân biệt các đối tượng và mảng rỗng.

Nếu đường mòn tham số là đúng (hoặc bất kỳ giá trị nào bằng đúng), sau đó theo sau
văn bản không có khoảng trắng được hàm chấp nhận và văn bản theo sau được trả về
là giá trị trả về thứ 3. (Giá trị trả về thứ 3 luôn ở đó, nhưng với đường mòn thiết lập, không
lỗi được nâng lên.)

utils.format_json (v)
Định dạng bảng Lua đã cho (hoặc giá trị) dưới dạng chuỗi JSON và trả về nó. Có lỗi,
Trả về không, lôi. (Lỗi thường chỉ xảy ra trên các loại giá trị không tương thích với
JSON.)

Giá trị đối số sử dụng các quy ước tương tự như mp.set_property_native () đến
phân biệt các đối tượng và mảng rỗng.

utils.to_string (v)
Biến giá trị đã cho thành một chuỗi. Định dạng bảng và nội dung của chúng. Điều này không
làm bất cứ điều gì đặc biệt; nó chỉ cần thiết vì Lua là khủng khiếp.

Sự kiện
Sự kiện là thông báo từ lõi của trình phát đến các tập lệnh. Bạn có thể đăng ký một trình xử lý sự kiện
với mp.register_event.

Lưu ý rằng tất cả các tập lệnh (và các phần khác của trình phát) đều nhận được các sự kiện như nhau và có
không có điều gì như chặn các tập lệnh khác nhận các sự kiện.

Ví dụ:

function my_fn (event)
print ("bắt đầu phát lại!")
cuối

mp.register_event ("đã tải tệp", my_fn)

Danh sách of sự kiện
tập tin bắt đầu
Xảy ra ngay trước khi một tệp mới được tải. Khi bạn nhận được điều này, người chơi sẽ
tải tệp (hoặc có thể đã được thực hiện với nó).

tập tin cuối
Xảy ra sau khi một tệp được tải xuống. Thông thường, trình phát sẽ tải tệp tiếp theo
ngay lập tức, hoặc thoát nếu đây là tệp cuối cùng.

Sự kiện có lý do trường nhận một trong các giá trị sau:

ôi Tệp đã kết thúc. Điều này có thể (nhưng không phải) bao gồm các tệp chưa hoàn chỉnh
hoặc kết nối mạng bị hỏng trong các trường hợp.

dừng lại Phát lại đã được kết thúc bằng một lệnh.

bỏ thuốc lá Việc phát lại đã được kết thúc bằng cách gửi lệnh thoát.

lôi Đã xảy ra lỗi. Trong trường hợp này, một lôi trường có lỗi
chuỗi.

chuyển hướng
Xảy ra với danh sách phát và tương tự. Thông tin chi tiết xem MPV_END_FILE_REASON_REDIRECT
trong API C.

không xác định
Không xác định. Thông thường không xảy ra, trừ khi API Lua không đồng bộ với
API C. (Tương tự như vậy, có thể xảy ra trường hợp tập lệnh của bạn nhận được các chuỗi lý do
chưa tồn tại vào thời điểm kịch bản của bạn được viết.)

tập tin được tải
Xảy ra sau khi tệp được tải và bắt đầu phát lại.

tìm kiếm Xảy ra khi tìm kiếm. (Điều này có thể bao gồm các trường hợp khi người chơi tìm kiếm nội bộ,
ngay cả khi không có sự tương tác của người dùng. Điều này bao gồm các thay đổi về phân đoạn, ví dụ: khi phát
các chương đã đặt hàng tệp Matroska.)

phát lại-khởi động lại
Bắt đầu phát lại sau khi tìm kiếm hoặc sau khi tệp được tải.

nhàn rỗi Chế độ nhàn rỗi được nhập. Điều này xảy ra khi quá trình phát lại kết thúc và trình phát đã được bắt đầu
với --nhàn rỗi or --buộc-cửa sổ. Chế độ này hoàn toàn kết thúc khi tập tin bắt đầu or
tắt máy sự kiện xảy ra.

đánh dấu Được gọi sau khi khung video được hiển thị. Đây là một vụ hack và bạn nên tránh
sử dụng nó. Thay vào đó, hãy sử dụng bộ hẹn giờ và có thể xem các sự kiện tạm dừng / bỏ tạm dừng để tránh
lãng phí CPU khi trình phát bị tạm dừng.

tắt máy
Được gửi khi người chơi thoát và tập lệnh sẽ kết thúc. Thường được xử lý
tự động. Nhìn thấy Chi Tiết on các kịch bản khởi tạo và vòng đời.

nhật ký tin nhắn
Nhận tin nhắn được bật với mp.enable_messages. Dữ liệu tin nhắn được chứa trong
bảng được truyền dưới dạng tham số đầu tiên cho trình xử lý sự kiện. Bảng chứa, trong
ngoài các trường sự kiện mặc định, các trường sau:

tiếp đầu ngữ Tiền tố mô-đun, xác định người gửi tin nhắn. Đây là những gì
trình phát đầu cuối đặt trước văn bản tin nhắn khi sử dụng --v Tùy chọn,
và cũng là những gì được sử dụng cho - cấpmsg.

cấp Mức nhật ký dưới dạng chuỗi. Nhìn thấy tin nhắn.log cho các tên cấp độ nhật ký có thể. Ghi chú
rằng các phiên bản mpv sau này có thể thêm các cấp mới hoặc xóa (không có tài liệu)
những thứ hiện có.

văn bản Thông báo nhật ký. Văn bản sẽ kết thúc bằng một ký tự dòng mới. Đôi khi nó
có thể chứa nhiều dòng.

Hãy nhớ rằng những thông điệp này là gợi ý cho con người. Bạn không nên
phân tích cú pháp chúng và tiền tố / cấp độ / văn bản của tin nhắn có thể thay đổi bất kỳ lúc nào.

get-property-trả lời
Không có giấy tờ (không hữu ích cho các tập lệnh Lua).

đặt thuộc tính-trả lời
Không có giấy tờ (không hữu ích cho các tập lệnh Lua).

trả lời lệnh
Không có giấy tờ (không hữu ích cho các tập lệnh Lua).

tin nhắn khách hàng
Không có giấy tờ (được sử dụng trong nội bộ).

tái cấu hình video
Xảy ra trên đầu ra video hoặc cấu hình lại bộ lọc.

cấu hình lại âm thanh
Xảy ra trên đầu ra âm thanh hoặc cấu hình lại bộ lọc.

Các sự kiện sau cũng xảy ra nhưng không được dùng nữa: bài hát đã thay đổi, chuyển hướng,
tạm dừng, bỏ tạm dừng, siêu dữ liệu-cập nhật, thay đổi chương. Sử dụng mp.observe_property () thay thế.

Extras
Tài liệu này ghi lại các tính năng thử nghiệm hoặc các tính năng "quá đặc biệt" để đảm bảo
giao diện ổn định.

mp.add_hook (loại, sự ưu tiên, fn)
Thêm một cuộc gọi lại hook cho kiểu (một chuỗi xác định một loại móc nhất định). Này
hooks cho phép người chơi gọi các hàm script và đợi kết quả của chúng
(thông thường, giao diện tập lệnh Lua là không đồng bộ theo quan điểm của
cốt lõi của người chơi). ưu tiên là một số nguyên tùy ý cho phép sắp xếp thứ tự giữa các móc
cùng loại. Nên sử dụng giá trị 50 làm giá trị mặc định trung tính. fn is
hàm sẽ được gọi trong quá trình thực thi hook.

Xem Hooks cho các hook hiện có và những gì chúng làm - chỉ có danh sách hook là
thú vị; xử lý thực thi hook được thực hiện bởi hàm Lua script
tự động.

JSON IPC

mpv có thể được điều khiển bởi các chương trình bên ngoài bằng giao thức IPC dựa trên JSON. Nó có thể
được kích hoạt bằng cách chỉ định đường dẫn đến ổ cắm unix bằng cách sử dụng tùy chọn --input-unix-socket.
Khách hàng có thể kết nối với ổ cắm này và gửi lệnh đến người chơi hoặc nhận các sự kiện từ
nó.

Chú ý:
Đây không phải là một giao thức mạng an toàn. Rõ ràng là không an toàn: ở đó
không xác thực, không mã hóa và bản thân các lệnh cũng không an toàn. Vì
ví dụ chạy lệnh được hiển thị, có thể chạy các lệnh hệ thống tùy ý. Các
use-case đang kiểm soát cục bộ trình phát. Điều này không khác với MPlayer
giao thức nô lệ.

socat ví dụ
Bạn có thể sử dụng con mèo công cụ để gửi lệnh (và nhận trả lời) từ trình bao. Giả định
mpv đã được bắt đầu bằng:

mpv file.mkv --input-unix-socket = / tmp / mpvsocket

Sau đó, bạn có thể kiểm soát nó bằng cách sử dụng socat:

> echo '{"command": ["get_property", "playback-time"]}' | socat - / tmp / mpvsocket
{"data": 190.482000, "error": "success"}

Trong trường hợp này, socat sao chép dữ liệu giữa stdin / stdout và kết nối ổ cắm mpv.

Xem --nhàn rỗi tùy chọn cách làm cho mpv khởi động mà không cần thoát ngay lập tức hoặc phát tệp.

Cũng có thể gửi các lệnh chỉ văn bản kiểu input.conf:

> echo 'show_text $ {playback-time}' | socat - / tmp / mpvsocket

Nhưng bạn sẽ không nhận được trả lời qua ổ cắm. (Lệnh cụ thể này hiển thị phát lại
thời gian trên OSD của người chơi.)

Nghị định thư
Khách hàng có thể thực hiện các lệnh trên trình phát bằng cách gửi các thông báo JSON có dạng sau:

{"command": ["command_name", "param1", "param2", ...]}

Ở đâu tên_lệnh là tên của lệnh sẽ được thực thi, theo sau là danh sách
thông số. Các tham số phải được định dạng dưới dạng giá trị JSON gốc (số nguyên, chuỗi,
boolean, ...). Mọi tin nhắn phải được chấm dứt với \n. Ngoài ra, \n không được xuất hiện
bất cứ nơi nào bên trong thư. Trong thực tế, điều này có nghĩa là các thông báo phải được giảm thiểu
trước khi được gửi đến mpv.

mpv sau đó sẽ gửi lại câu trả lời cho biết lệnh đã chạy đúng hay chưa và
trường bổ sung chứa dữ liệu trả về theo lệnh cụ thể (nó cũng có thể là null).

{"error": "success", "data": null}

mpv cũng sẽ gửi các sự kiện cho khách hàng với các thông báo JSON có dạng sau:

{"event": "event_name"}

Ở đâu tên sự kiện là tên của sự kiện. Các trường bổ sung dành riêng cho sự kiện cũng có thể là
hiện nay. Nhìn thấy Danh sách of sự kiện để biết danh sách tất cả các sự kiện được hỗ trợ.

Bởi vì các sự kiện có thể xảy ra bất kỳ lúc nào, đôi khi có thể khó xác định được
phản hồi đi với lệnh nào. Các lệnh có thể tùy chọn bao gồm Yêu cầu ID cái nào, nếu
được cung cấp trong yêu cầu lệnh, sẽ được sao chép nguyên văn vào phản hồi. mpv không
diễn giải Yêu cầu ID bằng mọi cách; nó chỉ dành cho việc sử dụng của người yêu cầu.

Ví dụ, yêu cầu này:

{"command": ["get_property", "time-pos"], "request_id": 100}

Sẽ tạo ra phản hồi này:

{"error": "success", "data": 1.468135, "request_id": 100}

Tất cả các lệnh, câu trả lời và sự kiện được phân tách với nhau bằng dấu ngắt dòng
tính cách (\n).

Nếu ký tự đầu tiên (sau khi bỏ qua khoảng trắng) thì không {, lệnh sẽ là
được hiểu là lệnh văn bản không phải JSON, vì chúng được sử dụng trong input.conf (hoặc
mpv_command_string () trong API ứng dụng khách). Ngoài ra, dòng bắt đầu bằng # và trống rỗng
dòng bị bỏ qua.

Hiện tại, các byte 0 được nhúng kết thúc dòng hiện tại, nhưng bạn không nên dựa vào điều này.

Lệnh
Ngoài các lệnh được mô tả trong Danh sách of Đầu vào Lệnh, một vài lệnh bổ sung
cũng có thể được sử dụng như một phần của giao thức:

tên khách hàng
Trả lại tên của khách hàng dưới dạng chuỗi. Đây là chuỗi ipc-N với N là một
số nguyên.

get_time_us
Trả về thời gian nội bộ mpv hiện tại tính bằng micro giây dưới dạng số. Về cơ bản đây là
thời gian hệ thống, với một độ lệch tùy ý.

get_property
Trả lại giá trị của tài sản đã cho. Giá trị sẽ được gửi trong trường dữ liệu của
tin nhắn phát lại.

Ví dụ:

{"command": ["get_property", "volume"]}
{"data": 50.0, "error": "success"}

get_property_string
Như get_property, nhưng dữ liệu kết quả sẽ luôn là một chuỗi.

Ví dụ:

{"command": ["get_property_string", "volume"]}
{"data": "50.000000", "error": "thành công"}

set_property
Đặt thuộc tính đã cho thành giá trị đã cho. Nhìn thấy Bất động sản để biết thêm thông tin
về tài sản.

Ví dụ:

{"command": ["set_property", "pause", true]}
{"error": "thành công"}

set_property_string
Như set_property, nhưng giá trị đối số phải được truyền dưới dạng chuỗi.

Ví dụ:

{"command": ["set_property_string", "pause", "yes"]}
{"error": "thành công"}

Obser_property
Xem một thuộc tính để biết những thay đổi. Nếu thuộc tính đã cho bị thay đổi, thì một sự kiện của
kiểu thay đổi tài sản sẽ được tạo ra

Ví dụ:

{"command": ["Obser_property", 1, "volume"]}
{"error": "thành công"}
{"event": "property-change", "id": 1, "data": 52.0, "name": "volume"}

Obser_property_string
Như Obser_property, nhưng dữ liệu kết quả sẽ luôn là một chuỗi.

Ví dụ:

{"command": ["Obser_property_string", 1, "volume"]}
{"error": "thành công"}
{"event": "property-change", "id": 1, "data": "52.000000", "name": "volume"}

unabserve_property
Undo Obser_property or Obser_property_string. Điều này yêu cầu id số
được chuyển đến lệnh quan sát dưới dạng đối số.

Ví dụ:

{"command": ["unabserve_property", 1]}
{"error": "thành công"}

request_log_messages
Cho phép xuất thông báo nhật ký mpv. Chúng sẽ được nhận dưới dạng các sự kiện. Thông số
đối với lệnh này là cấp nhật ký (xem mpv_request_log_messages Hàm API C).

Đầu ra thông báo nhật ký chỉ dành cho con người (chủ yếu là để gỡ lỗi). Cố gắng
truy xuất thông tin bằng cách phân tích cú pháp các thông báo này sẽ chỉ dẫn đến sự cố với
bản phát hành mpv trong tương lai. Thay vào đó, hãy đưa ra một yêu cầu tính năng và yêu cầu một sự kiện thích hợp
trả về thông tin bạn cần.

kích hoạt_sự kiện, vô hiệu hóa_event
Bật hoặc tắt sự kiện được đặt tên. Gương mpv_request_event Hàm API C.
Nếu chuỗi tất cả các được sử dụng thay cho tên sự kiện, tất cả các sự kiện đều được bật hoặc
tàn tật.

Theo mặc định, hầu hết các sự kiện đều được kích hoạt và lệnh này không được sử dụng nhiều.

Đình chỉ
Tạm dừng vòng lặp chính mpv. Có một lời giải thích dài dòng về điều này trong API C
chức năng mpv_suspend (). Tóm lại, điều này ngăn người chơi hiển thị
khung video để bạn không bị chặn khi cố truy cập trình phát.

tiếp tục Hoàn tác một Đình chỉ gọi. Đình chỉ tăng một bộ đếm nội bộ và tiếp tục
giảm nó. Khi đạt đến 0, trình phát thực sự được tiếp tục.

get_version
Trả về phiên bản API ứng dụng khách mà API C của phiên bản mpv từ xa cung cấp. (Cũng thế
xem DOCS / client-api-changes.rst.)

UTF-8
Thông thường, tất cả các chuỗi đều ở UTF-8. Đôi khi nó có thể xảy ra rằng các chuỗi ở một số
mã hóa bị hỏng (thường xảy ra với các thẻ tệp, v.v. và tên tệp trên nhiều Unix là
cũng không bắt buộc phải ở UTF-8). Điều này có nghĩa là mpv đôi khi gửi JSON không hợp lệ. Nếu
đó là vấn đề đối với trình phân tích cú pháp của ứng dụng khách, nó sẽ lọc dữ liệu thô cho
trình tự UTF-8 không hợp lệ và thực hiện thay thế mong muốn, trước khi cung cấp dữ liệu cho
trình phân tích cú pháp JSON của nó.

mpv sẽ không cố gắng tạo UTF-8 không hợp lệ với các chuỗi thoát bị hỏng.

THAY ĐỔI

Không có thay đổi thực sự, nhưng bạn có thể xem những điều sau:

· Bản thay đổi bản phát hành, sẽ chứa hầu hết các thay đổi mà người dùng có thể nhìn thấy, bao gồm cả mới
các tính năng và sửa lỗi:

https://github.com/mpv-player/mpv/releases

· Nhật ký git, là thay đổi "thực"

· Tập tin mplayer-changes.rst trong TÀI LIỆU thư mục con trên kho lưu trữ git, đã sử dụng
ở vị trí của phần này. Nó ghi lại một số thay đổi đã xảy ra kể từ mplayer2
tách rời MPlayer.

KẾT THÚC VÀO KHÁC CHƯƠNG TRÌNH (LIBMPV)

mpv có thể được nhúng vào các chương trình khác dưới dạng phụ trợ phát lại video / âm thanh. Đề nghị
cách để làm như vậy là sử dụng libmpv. Nhìn thấy libmpv / client.h trong kho mã nguồn mpv. Đây
cung cấp API C. Ràng buộc cho các ngôn ngữ khác có thể có sẵn (xem wiki).

MÔI TRƯỜNG BIẾN

Có một số biến môi trường có thể được sử dụng để kiểm soát hành vi của
mpv.

TRANG CHỦ, XDG_CONFIG_HOME
Được sử dụng để xác định thư mục cấu hình mpv. Nếu XDG_CONFIG_HOME không được thiết lập,
$ HOME / .config / mpv Được sử dụng.

$ HOME / .mpv luôn được thêm vào danh sách các đường dẫn tìm kiếm cấu hình với
sự ưu tiên.

XDG_CONFIG_DIRS
Nếu được đặt, các thư mục cấu hình hệ thống kiểu XDG sẽ được sử dụng. Nếu không, UNIX
quy ước (PREFIX / etc / mpv /) Được sử dụng.

HẠN Được sử dụng để xác định loại thiết bị đầu cuối.

MPV_HOME
Thư mục nơi mpv tìm kiếm cài đặt người dùng. Ghi đè TRANG CHỦvà mpv sẽ cố gắng
tải tệp cấu hình dưới dạng $ MPV_HOME / mpv.conf.

MPV_VERBOSE (xem Ngoài ra -v và - cấpmsg)
Đặt mức độ chi tiết ban đầu trên tất cả các mô-đun thông báo (mặc định: 0). Đây là
một số nguyên và độ dài kết quả tương ứng với số --v lựa chọn
được chuyển đến dòng lệnh.

MPV_LEAK_REPORT
Nếu được đặt thành 1, cho phép báo cáo rò rỉ talloc nội bộ. Lưu ý rằng điều này có thể gây ra
rắc rối với đa luồng, vì vậy chỉ các nhà phát triển mới nên sử dụng điều này.

LADSPA_PATH
Chỉ định đường dẫn tìm kiếm cho các plugin LADSPA. Nếu nó chưa được đặt, đường dẫn hoàn toàn đủ điều kiện
tên phải được sử dụng.

DISPLAY
Tên hiển thị tiêu chuẩn X11 để sử dụng.

FFmpeg / Libav:
Thư viện này truy cập các biến môi trường khác nhau. Tuy nhiên, chúng không
được ghi lại một cách tập trung, và việc ghi lại chúng không phải là công việc của chúng tôi. Do đó, danh sách này là
chưa hoàn thiện.

Các biến môi trường đáng chú ý:

http Proxy
URL tới proxy cho http:// và https:// Các URL.

không có proxy
Danh sách các mẫu miền không nên sử dụng proxy. Mục nhập danh sách là
cách nhau bởi ,. Các mẫu có thể bao gồm *.

libdvdcss:

DVDCSS_CACHE
Chỉ định một thư mục để lưu trữ các giá trị khóa tiêu đề. Điều này sẽ tăng tốc độ
giải mã đĩa DVD trong bộ đệm. Các DVDCSS_CACHE thư mục là
được tạo nếu nó không tồn tại và một thư mục con được tạo theo tên của
Tiêu đề hoặc ngày sản xuất của DVD. Nếu DVDCSS_CACHE không được đặt hoặc trống,
libdvdcss sẽ sử dụng giá trị mặc định là ${HOME}/.dvdcss/ dưới Unix
và thư mục dữ liệu ứng dụng chuyển vùng (% APPDATA%) trong Windows. Các
giá trị đặc biệt "tắt" vô hiệu hóa bộ nhớ đệm.

DVDCSS_METHOD
Đặt phương thức xác thực và giải mã mà libdvdcss sẽ sử dụng để
đọc đĩa bị xáo trộn. Có thể là một trong tiêu đề, chính or đĩa.

chính là phương pháp mặc định. libdvdcss sẽ sử dụng một bộ trình phát được tính toán
keys để thử và lấy khóa đĩa. Điều này có thể thất bại nếu ổ đĩa không
nhận ra bất kỳ phím nào của người chơi.

đĩa là một phương pháp dự phòng khi khóa bị lỗi. Thay vì sử dụng máy nghe nhạc
keys, libdvdcss sẽ bẻ khóa đĩa bằng vũ lực
thuật toán. Quá trình này sử dụng nhiều CPU và yêu cầu 64 MB bộ nhớ
để lưu trữ dữ liệu tạm thời.

tiêu đề là dự phòng khi tất cả các phương pháp khác không thành công. Nó không dựa
trên một trao đổi khóa với ổ đĩa DVD, mà sử dụng một cuộc tấn công bằng tiền điện tử
để đoán khóa tiêu đề. Trong những trường hợp hiếm hoi, điều này có thể thất bại vì có
không đủ dữ liệu được mã hóa trên đĩa để thực hiện thống kê
tấn công, nhưng mặt khác, đó là cách duy nhất để giải mã DVD
được lưu trữ trên đĩa cứng hoặc DVD có vùng sai trên RPC2
lái xe.

DVDCSS_RAW_DEVICE
Chỉ định thiết bị thô sẽ sử dụng. Việc sử dụng chính xác sẽ phụ thuộc vào hoạt động của bạn
hệ thống, tiện ích Linux để thiết lập thiết bị thô là nguyên(8) chẳng hạn.
Xin lưu ý rằng trên hầu hết các hệ điều hành, việc sử dụng thiết bị thô yêu cầu
bộ đệm được căn chỉnh cao: Linux yêu cầu căn chỉnh 2048 byte (là
kích thước của một khu vực DVD).

DVDCSS_VERBOSE
Đặt mức chi tiết libdvdcss.

0 Đầu ra không có tin nhắn nào cả.

1 Xuất thông báo lỗi ra stderr.

2 Xuất thông báo lỗi và thông báo gỡ lỗi tới thiết bị lỗi chuẩn.

DVDREAD_NOKEYS
Bỏ qua việc truy xuất tất cả các phím khi khởi động. Hiện đang bị vô hiệu.

TRANG CHỦ FIXME: Ghi lại tài liệu này.

EXIT MÃ

Thông thường mpv trả về 0 dưới dạng mã thoát sau khi phát lại thành công. Nếu lỗi
xảy ra, các mã thoát sau đây có thể được trả lại:

1 Lỗi khi khởi chạy mpv. Điều này cũng được trả lại nếu các tùy chọn không xác định được chuyển đến
mpv.

2 Không thể phát tệp được chuyển tới mpv. Điều này hơi mờ: hiện tại,
phát lại tệp được coi là thành công nếu quá trình khởi tạo hầu hết
thành công, ngay cả khi phát lại không thành công ngay sau khi khởi tạo.

3 Có một số tệp có thể phát được và một số tệp không thể phát (sử dụng
định nghĩa của thành công từ trên).

4 Thoát do có tín hiệu, Ctrl+c trong cửa sổ VO (theo mặc định) hoặc từ mặc định
thoát khỏi các ràng buộc chính trong chế độ mã hóa.

Lưu ý rằng việc thoát trình phát theo cách thủ công sẽ luôn dẫn đến mã thoát 0, ghi đè mã thoát
mã thoát sẽ được trả lại bình thường. Ngoài ra, các bỏ thuốc lá lệnh đầu vào có thể có một lối ra
mã: trong trường hợp này, mã thoát đó được trả về.

Sử dụng mpv trực tuyến bằng dịch vụ onworks.net