MPV

ПРОГРАММА:

ИМЯ

mpv - медиаплеер

СИНТАКСИС

MPV [параметры] [файл | URL | ПЛЕЙЛИСТ | -]
MPV [параметры] файлы

ОПИСАНИЕ

MPV - медиаплеер, основанный на MPlayer и mplayer2. Он поддерживает широкий спектр видео.
форматы файлов, аудио- и видеокодеки, а также типы субтитров. Специальные типы входных URL-адресов:
доступен для чтения ввода из множества источников, кроме файлов на диске. В зависимости от
Платформа поддерживает множество различных методов вывода видео и аудио.

Примеры использования, которые помогут вам быстро начать работу, можно найти в конце этой справочной страницы.

INTERACTIVE КОНТРОЛЬ

mpv имеет полностью настраиваемый уровень управления, управляемый командами, который позволяет вам управлять mpv.
с помощью клавиатуры, мыши или пульта дистанционного управления (нет поддержки LIRC - настройте пульты как
устройства ввода).

Смотрите пост в --Вход- варианты способов его настройки.

клавиатура Контролировать
ЛЕВЫЙ и ПРАВО
Перемотка назад / вперед на 5 секунд. Shift + стрелка выполняет поиск с точностью до 1 секунды (см.
--hr-искать).

UP и DOWN
Переход вперед / назад на 1 минуту. Shift + стрелка выполняет точный поиск за 5 секунд (см.
--hr-искать).

Ctrl + ВЛЕВО и Ctrl + ВПРАВО
Перейти к предыдущему / следующему субтитру. Имеет некоторые ограничения и может не работать
всегда; видеть sub_seek команда.

[ и ]
Уменьшить / увеличить текущую скорость воспроизведения на 10%.

{ и }
Уменьшить / удвоить текущую скорость воспроизведения.

BACKSPACE
Установите нормальную скорость воспроизведения.

< и >
Переход назад / вперед по плейлисту.

ENTER Перейти вперед по плейлисту.

p / SPACE
Пауза (повторное нажатие возобновляет паузу).

. Шаг вперед. Однократное нажатие приведет к паузе, при каждом последующем нажатии будет воспроизводиться один кадр.
а затем снова войдите в режим паузы.

, Шаг назад. При однократном нажатии происходит пауза, при каждом последующем нажатии воспроизводится одно нажатие.
кадра в обратном направлении, а затем снова войдите в режим паузы.

q Прекратите играть и выйдите.

Q Подобно q, но сохраните текущую позицию воспроизведения. Воспроизведение того же файла позже будет
если возможно, возобновите воспроизведение с прежней позиции.

/ и *
Уменьшить / увеличить громкость.

9 и 0
Уменьшить / увеличить громкость.

m Отключить звук.

_ Перебирайте доступные видеодорожки.

# Перебирайте доступные звуковые дорожки.

f Переключить полноэкранный режим (см. Также --fs).

ESC Выйдите из полноэкранного режима.

T Переключить режим "оставаться наверху" (см. Также --наверху).

w и e
Уменьшить / увеличить диапазон панорамирования и сканирования.

o (В том числе P)
Показать шкалу прогресса, прошедшее время и общую продолжительность на экранном меню.

O Переключайте состояние экранного меню между нормальным и временем / продолжительностью воспроизведения.

v Переключить видимость субтитров.

j и J
Перебирайте доступные субтитры.

x и z
Отрегулируйте задержку субтитров на +/- 0.1 секунды.

l Установка / удаление точек петли AB. Видеть ab-петля для подробностей.

L Включить бесконечный цикл.

Ctrl + и Ctrl -
Отрегулируйте задержку звука на +/- 0.1 секунды.

u Переключение между применением без переопределения стиля к субтитрам SSA / ASS и переопределением
их почти полностью с обычным стилем субтитров. Видеть --ass-стиль-переопределить для
больше информации.

V Переключить режим совместимости соотношения сторон VSFilter субтитров. Видеть
--ass-vsfilter-аспект-совместимость для дополнительной информации.

r и t
Перемещение субтитров вверх / вниз.

s Сделайте снимок экрана.

S Сделайте снимок экрана без субтитров. (Работает ли это, зависит от драйвера VO.
служба поддержки.)

Ctrl s Сделайте снимок экрана в том виде, в котором он отображается в окне (с субтитрами, экранным меню и масштабированным видео).

I Показать имя файла в экранном меню.

ПГУП и ПГДВН
Перейти к началу предыдущей / следующей главы. В большинстве случаев "предыдущий" будет
фактически перейти к началу текущей главы; видеть порог поиска главы.

Shift + PGUP и Shift + PGDWN
Переместитесь назад или вперед на 10 минут. (Раньше это отображалось в PGUP / PGDWN
без Shift.)

d Активировать / деактивировать деинтерлейсер.

A Цикл переопределения соотношения сторон.

(Следующие ключи действительны только при использовании видеовыхода, поддерживающего
соответствующая регулировка, или программный эквалайзер (--vf = экв).)

1 и 2
Отрегулируйте контраст.

3 и 4
Отрегулируйте яркость.

5 и 6
Отрегулируйте гамму.

7 и 8
Отрегулируйте насыщенность.

Alt + 0 (И команда + 0 on ОС X)
Измените размер окна видео до половины исходного размера.

Alt + 1 (И команда + 1 on ОС X)
Измените размер окна видео до исходного размера.

Alt + 2 (И команда + 2 on ОС X)
Измените размер окна видео в два раза по сравнению с исходным размером.

команду + f (ОС X только)
Переключить полноэкранный режим (см. Также --fs).

команду + [ и команду + ] (ОС X только)
Установить видео окно альфа.

(Следующие клавиши действительны, если у вас есть клавиатура с мультимедийными клавишами.)

PAUSE Пауза.

STOP Прекратите играть и выйдите.

Назад и ДАЛЕЕ
Перемотка назад / вперед на 1 минуту.

(Следующие ниже ключи действительны только в том случае, если вы скомпилировали с поддержкой входа TV или DVB.)

h и k
Выбрать предыдущий / следующий канал.

мышь Контролировать
кнопка 3 и кнопка 4
Перемотка назад / вперед на 1 минуту.

кнопка 5 и кнопка 6
Уменьшить / увеличить громкость.

ИСПОЛЬЗОВАНИЕ

Каждая флажок вариант имеет без флага аналог, например, противоположный --fs опция
--нет-фс. --fs = да такой же как --fs, --fs = нет такой же как --нет-фс.

Если опция отмечена как (ХХХ только), он будет работать только в сочетании с XXX вариант
или если XXX скомпилирован в.

Спасаясь пространства и другими особый символы
Имейте в виду, что оболочка частично анализирует и искажает аргументы, которые вы передаете в mpv.
Например, вам может потребоваться заключить в кавычки или экранировать параметры и имена файлов:
MPV "имя файла space.mkv " --title = "окно заглавие"

Ситуация усложняется, если задействован синтаксический анализатор подопций. Парсер подопции помещает
несколько параметров в одну строку и передает их компоненту одновременно, а не
используя несколько параметров на уровне командной строки.

Парсер подопции может заключать строки в кавычки с " и [...]. Дополнительно есть специальный
форма цитирования с % n% описано ниже.

Так, например, OpenGL VO может принимать несколько вариантов:
MPV тест.mkv --vo = opengl: scale = lanczos: icc-profile = file.icc, xv

Это проходит scale = lanczos и icc-profile = file.icc в OpenGL, а также указывает xv as
запасной вариант VO. Если путь к профилю icc содержит пробелы или символы, например , or :, тебе нужно
процитировать их:
MPV '--vo = opengl: icc-profile = "файл space.icc ", xv '

Оболочки могут фактически удалить некоторые кавычки из строки, переданной в командную строку, поэтому
пример цитирует строку дважды, гарантируя, что mpv получит " цитаты.

Команда [...] форма кавычек обертывает все между [ и ]. Это полезно с оболочками, которые
не интерпретируйте эти символы в середине аргумента (например, bash). Эти цитаты
сбалансированы (начиная с mpv 0.9.0): [ и ] гнездо, и цитата заканчивается на последнем ]
что не имеет соответствия [ внутри строки. (Например, [a [b] c] приводит к а [б] в.)

Синтаксис цитирования фиксированной длины предназначен для использования с внешними скриптами и программами.

Это началось с % и имеет следующий формат:

% n% длина_строки_n

Примеры

MPV --ao = pcm: file =% 10% C: test.wav тест.avi

Или в скрипте:

MPV --ao = pcm: file =% `выражение "$ NAME" `%" $ NAME " тест.avi

Подопции, передаваемые в клиентский API, также подлежат экранированию. С использованием
mpv_set_option_string () точно как прохождение --name = данные в командную строку (но
без обработки строки оболочкой). Некоторые параметры поддерживают передачу значений в более
структурированный способ вместо плоских строк и может избежать беспорядка при синтаксическом анализе подопций. Для
пример, --vf поддерживает MPV_FORMAT_NODE, который позволяет передавать подопции как вложенные данные
структура карт и массивов. (--во подтверждает это таким же образом, хотя этот факт
без документов.)

Пути
Следует соблюдать осторожность при передаче в mpv произвольных путей и имен файлов. Например,
пути, начинающиеся с - будут интерпретироваться как варианты. Аналогично, если путь содержит
последовательность :/ /, строка перед этим может быть интерпретирована как префикс протокола, даже если
:/ / может быть частью допустимого пути UNIX. Чтобы избежать проблем с произвольными путями, вам следует
убедитесь, что абсолютные пути, переданные в mpv, начинаются с /, и относительные пути с ./.

Имя - сам интерпретируется как stdin и заставляет mpv отключать элементы управления консоли.
(Что делает его подходящим для воспроизведения данных, передаваемых на стандартный ввод.)

Для путей, переданных в подопции, ситуация еще больше усложняется необходимостью выхода
специальные символы. Чтобы обойти это, путь можно дополнительно обернуть в
синтаксис фиксированной длины, например % n% длина_строки_n (см. выше).

Некоторые параметры mpv интерпретируют пути, начинающиеся с ~. В настоящее время приставка ~~ / расширяется до
Каталог конфигурации mpv (обычно ~ / .config / mpv /). ~/ расширяется до дома пользователя
каталог. (Конечный / всегда требуется.) Также существуют следующие пути:

┌─────────────┬─────────────────────────────────────
│ Имя │ Значение │
└─────────────┴────────────────────────────────────

│~~ главная / │ так же, как ~~ / │
├─────────────┼─────────────────────────────────────
│~~ глобальный / │ глобальный путь конфигурации, если │
│ │ доступно (не на win32) │
├─────────────┼─────────────────────────────────────
│~~ osxbundle / │ путь к ресурсам пакета OSX │
│ │ (только OSX) │
├─────────────┼─────────────────────────────────────
│~~ рабочий стол / │ путь к рабочему столу (win32, │
│ │ OSX) │
└─────────────┴────────────────────────────────────

На файл Возможности
При воспроизведении нескольких файлов любой параметр, указанный в командной строке, обычно влияет на все
файлы. Пример:

mpv --a файл1.mkv --b файл2.mkv --c

┌──────────┬─────────────────
│Файл │ Активные параметры │
├──────────┼─────────────────
│файл1.mkv │ --а --б --с │
├──────────┼─────────────────
│файл2.mkv │ --а --б --с │
└───────────────────────────

(Это отличается от MPlayer и mplayer2.)

Кроме того, если какой-либо параметр изменяется во время выполнения (через команды ввода), они не сбрасываются, когда
воспроизводится новый файл.

Иногда бывает полезно изменить параметры для каждого файла. Этого можно добиться, добавив
специальные маркеры для файлов - { и -}. (Обратите внимание, что вы должны экранировать их на некоторых оболочках.)
Пример:

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

┌─────────────────────────────────────
│Файл │ Активные параметры │
├─────────────────────────────────────
│файл1.mkv │ --а --б --f │
├─────────────────────────────────────
│файл2.mkv │ --а --б --f --с --д --e │
├─────────────────────────────────────
│файл3.mkv │ --а --б --f --с --д --e │
├─────────────────────────────────────
│файл4.mkv │ --а --б --f │
└─────────────────────────────────────

Кроме того, любой параметр локального файла, измененный во время выполнения, сбрасывается, когда текущий файл
перестает играть. Если вариант --с изменяется во время воспроизведения файл2.mkv, он сбрасывается, когда
продвигаясь к файл3.mkv. Это влияет только на локальные параметры файла. Опция --а никогда
сбросить здесь.

КОНФИГУРАЦИЯ FILES

Юридический адрес и Синтаксис
Вы можете поместить все параметры в файлы конфигурации, которые будут считываться каждый раз, когда mpv
бег. Общесистемный файл конфигурации mpv.conf находится в вашем каталоге конфигурации.
(например / etc / mpv or / USR / местные / и т. д. / MPV), пользовательский ~ / .config / mpv / mpv.conf.
Подробные сведения и особенности платформы (в частности, пути к Windows) см. В FILES .

Пользовательские параметры переопределяют общесистемные параметры и параметры, заданные в командной строке.
переопределить либо. Синтаксис файлов конфигурации: option = значение. Все после
# считается комментарием. Параметры, которые работают без значений, можно включить, задав их
в Да и отключили, установив для них нет. Таким образом можно указать даже подопции.

Пример файла конфигурации

# По умолчанию использовать видеовыход opengl.
vo = opengl
# Используйте кавычки для текста, который может содержать пробелы:
status-msg = "Время: $ {time-pos}"

Спасаясь пространства и особый символы
Это делается так же, как с параметрами командной строки. Оболочка здесь не задействована, но вариант
значения по-прежнему необходимо указывать как единое целое, если оно содержит определенные символы, например пробелы. А
запись config может быть заключена в кавычки с ", а также с синтаксисом фиксированной длины (% n%) упоминается
до. Это похоже на передачу точного содержимого строки в кавычках в виде командной строки.
вариант. Экраны в стиле C в настоящее время _не_ интерпретируются на этом уровне, хотя некоторые
варианты делают это вручную. (Это беспорядок и, вероятно, должен быть изменен в какой-то момент.)

Полагая Command линия Возможности в Конфигурация Файл
Практически все параметры командной строки можно поместить в файл конфигурации. Вот небольшой
руководство:

┌──────────────────┬───────────────────────────
│Опция │ Запись в файл конфигурации │
├──────────────────┼───────────────────────────
│--флаг │ флажок │
├──────────────────┼───────────────────────────
│-опт волна │ opt = val │
├──────────────────┼───────────────────────────
│--opt = val │ opt = val │
├──────────────────┼───────────────────────────
│-опт «имеет пробелы " │ opt = "имеет пробелы " │
└──────────────────┴───────────────────────────

Для конкретного файла Конфигурация Файлы
Вы также можете писать файлы конфигурации для конкретных файлов. Если вы хотите иметь конфигурацию
файл для файла с именем 'video.avi', создайте файл 'video.avi.conf' с
в нем параметры, специфичные для файла, и поместите его в ~ / .config / mpv /. Вы также можете поставить
файл конфигурации в том же каталоге, что и файл для воспроизведения. Оба требуют, чтобы вы установили
--use-filedir-conf вариант (либо в командной строке, либо в вашем глобальном файле конфигурации).
Если в том же каталоге найден файл конфигурации для конкретного файла,
конфигурация загружается из ~ / .config / mpv, Кроме того, --use-filedir-conf вариант
включает файлы конфигурации для конкретного каталога. Для этого mpv сначала пытается загрузить
mpv.conf из того же каталога, что и воспроизводимый файл, а затем пытается загрузить любой
конфигурация для конкретного файла.

Профили
Чтобы упростить работу с различными конфигурациями, профили могут быть определены в
файлы конфигурации. Профиль начинается с его имени в квадратных скобках, например [мой профайл].
Все следующие параметры будут частью профиля. Описание (показано --profile = help)
можно определить с помощью описание-профиля вариант. Чтобы завершить профиль, запустите другой или используйте
имя профиля по умолчанию чтобы продолжить с обычными вариантами.

Пример файла конфигурации mpv с профилями

# нормальный вариант верхнего уровня
полноэкранный = да

# профиль, который можно включить с помощью --profile = big-cache
[большой кеш]
cache = 123400
демультиплексор-readahead-secs = 20

[медленный]
profile-desc = "какое-то имя профиля"
vo = opengl: scale = ewa_lanczos: scale-radius = 16

[быстро]
vo = vdpau

# повторное использование профиля расширяет его
[медленный]
framedrop = нет
# вы также можете включить другие профили
профиль = большой кеш

Авто профили
Некоторые профили загружаются автоматически. Следующий пример демонстрирует это:

Автозагрузка профиля

[во.вдпау]
# Использовать аппаратное декодирование
hwdec = vdpau

[протокол.dvd]
profile-desc = "профиль для DVD: // потоков"
alang = en

[расширение.flv]
profile-desc = "профиль для файлов .flv"
vf = перевернуть

[ао.альса]
устройство = spdif

Имя профиля соответствует схеме тип.имя, где тип может быть vo чтобы соответствовать значению
--во опция установлена ​​на, ao для --ао, протокол для используемого протокола ввода / вывода (см.
--list-протоколы), а также расширение расширение для продления пути текущего воспроизводимого
файл ( формат файла).

Эта функция очень ограничена, и других автоматических профилей нет.

ПРИНИМАЯ СКРИНШОТЫ

Скриншоты текущего воспроизводимого файла можно сделать в режиме ввода «скриншот».
команда, которая по умолчанию привязана к s ключ. Файлы с именами выстрел.jpg будет сохранен в
рабочий каталог, используя первый доступный номер - файлы не будут перезаписаны.

Снимок экрана обычно содержит немасштабированное видео в конце видео.
цепочка фильтров и субтитры. По умолчанию, S делает скриншоты без субтитров, а s
включает субтитры.

В отличие от MPlayer, Скриншот видео фильтр не требуется. Этот фильтр никогда не был
требуется в MPV и был удален.

ТЕРМИНАЛ статус ЛИНИЯ

Во время воспроизведения mpv показывает статус воспроизведения на терминале. Похоже на что-то
как это:
СРЕДНИЙ: 00:03:12 / 00:24:25 (13%) СРЕДНИЙ: -0.000

Строку состояния можно изменить с помощью --term-статус-сообщение опцию.

Ниже приведен список вещей, которые могут отображаться в строке состояния. Входные свойства,
которые можно использовать для получения той же информации вручную, также перечислены.

· СРЕДНИЙ: or V: (только видео) или A: (только аудио)

· Текущее время в ЧЧ: ММ: СС формат (время воспроизведения свойство)

· Общая продолжительность файла (отсутствует, если неизвестно) ( свойство)

· Скорость воспроизведения, например, «x2.0». Видно только если скорость ненормальная. Это
запрашиваемая пользователем скорость, а не фактическая скорость (обычно они должны быть одинаковыми, если только
воспроизведение идет слишком медленно). (скорость имущество.)

· Процент воспроизведения, например (13%). Какая часть файла была воспроизведена. Как обычно
рассчитывается исходя из положения и продолжительности воспроизведения, но можно использовать другие методы
(например, положение байта), если они недоступны. (процент-поз имущество.)

· Аудио / видео синхронизация как СРЕДНИЙ: 0.000. В этом разница между аудио и видео
время. Обычно он должен быть 0 или близок к 0. Если он растет, это может указывать на
проблема с воспроизведением. (авсинк имущество.)

· Общее изменение синхронизации A / V, например кт: -0.417. Обычно невидимый. Может появиться, если есть
звук «отсутствует», или может быть пропущено недостаточно кадров. Обычно это означает
проблема. (общее изменение avsync имущество.)

· Состояние кодирования в {...}, отображается только в режиме кодирования.

· Отображение состояния синхронизации. Если синхронизация дисплея активна (дисплей-синхронизация-активный свойство), это показывает
DS: 2.500/13, где первое число - это среднее количество синхронизаций на видеокадр (например,
2.5 при воспроизведении видео с частотой 24 Гц на экранах с частотой 60 Гц), который может дрожать, если соотношение не
округляются, или есть несвоевременные кадры (vsync-коэффициент), а второе число
приблизительное количество синхронизаций, которые заняли слишком много времени (количество кадров с задержкой vo имущество). В
последнее является эвристическим, поскольку, как правило, невозможно определить это с уверенностью.

· Выпавшие кадры, например Упавший: 4. Отображается, только если счетчик не равен 0. Может расти, если
частота кадров видео выше, чем у дисплея, или если рендеринг видео слишком медленный.
Также может увеличиваться при "икоте" и когда видеокадр не может отображаться на
время. (vo-дроп-количество кадров свойство.) Если декодер пропускает кадры, количество
Кадры, пропущенные декодером, также добавляются к дисплею, например: Упавший: 4/34. Это
происходит, только если отбрасывание кадра декодера разрешено с помощью --framedrop настройки.
(количество пропущенных кадров имущество.)

· Состояние кеша, например Кэш: 2s + 134КБ. Виден, если включен кеш потока. Первое
значение показывает количество буферизованного в демультиплексоре видео в секундах, второе значение
сериал дополнительный данные в килобайтах буферизуются в потоковом кеше. (демультиплексор-кеш-продолжительность
и использованный кеш свойства.)

ПРОТОКОЛЫ

http://..., https://, ...
Поддерживаются многие сетевые протоколы, но префикс протокола всегда должен быть
указано. mpv никогда не будет пытаться угадать, действительно ли имя файла является сетевым
адрес. Всегда требуется префикс протокола.

Обратите внимание, что здесь документированы не все префиксы. Недокументированные префиксы либо
псевдонимы для документированных протоколов или просто перенаправления на реализованные протоколы
и задокументирован в FFmpeg.

- Воспроизвести данные со стандартного ввода.

smb: // ПУТЬ
Воспроизвести путь из Samba share.

bd: // [название] [/ устройство] --bluray-device = ПУТЬ
Воспроизведите диск Blu-Ray. В настоящее время это не принимает файлы ISO. Вместо этого вы должны
смонтируйте файл ISO как файловую систему и укажите --bluray-устройство к установленным
каталог напрямую.

dvd: // [заголовок | [начальный заголовок] -конечный заголовок] [/ устройство] --dvd-device = ПУТЬ
Воспроизведите DVD. Меню DVD не поддерживаются. Если заголовок не указан, будет самым длинным заголовком.
выбран автоматически.

dvdnav: // это старый псевдоним для dvd: // и делает то же самое.

dvdread: // ...:
Воспроизведите DVD, используя старый код libdvdread. Это то, что MPlayer и более старые mpv
версии используют для dvd: //. Использование не рекомендуется. Предоставлено только для совместимости
и для перехода.

tv: // [канал] [/ input_id] --телевидение-...
Аналоговое ТВ через V4L. Также полезно для веб-камер. (Только для Linux.)

pvr: // --pvr -...
PVR. (Только для Linux.)

dvb: // [номер карты @] канал --dvbin -...
Цифровое ТВ через DVB. (Только для Linux.)

mf: // [маска файла | @listfile] --мф -...
Воспроизвести серию изображений как видео.

cdda: // track [-endtrack] [: speed] [/ device] --cdrom-device = ПУТЬ --cdda -...
Воспроизвести компакт-диск.

lavf: // ...
Доступ к любому протоколу FFmpeg / Libav libavformat. По сути, это передало строку
после // прямо в libavformat.

av: // тип: параметры
Это предназначено для использования входов libavdevice. напишите демультиплексор libavdevice
имя и кредита это (псевдо) имя файла, переданное демультиплексору.

Например, MPV av: // lavfi: mandelbrot использует оболочку libavfilter
включен в libavdevice, и будет использовать Мандельброт исходный фильтр для генерации
входные данные.

avdevice: // это псевдоним.

Путь файла
Локальный путь как URL. Может быть полезно в некоторых особых случаях использования. Обратите внимание, что PATH
сам должен начинаться с третьего / чтобы сделать путь абсолютным путем.

fd: // 123
Считайте данные из данного UNIX FD (например, 123). Это похоже на данные трубопровода
на стандартный ввод через -, но может использовать произвольный файловый дескриптор. Не будет работать правильно
в MS Windows.

edl: // [edl Спецификация as in edl-mpv.rst]
Сшивайте части нескольких файлов и воспроизводите их.

нулевой://
Смоделируйте пустой файл.

память: // данные
Использовать данным часть как исходные данные.

ПСЕВДО Графический интерфейс пользователя РЕЖИМ

mpv не имеет официального графического интерфейса, кроме OSC (ON ЭКРАН КОНТРОЛЛЕР), что не является полным
GUI так и не должен быть. Однако, чтобы компенсировать отсутствие ожидаемого поведения графического интерфейса пользователя,
В некоторых случаях mpv запускается с некоторыми измененными настройками, чтобы вести себя немного больше как графический интерфейс.
Режим.

В настоящее время это происходит только в следующих случаях:

· Если начали использовать mpv.desktop файл в Linux (например, запускается из меню или файла
ассоциации, предоставляемые средами рабочего стола)

· Если он был запущен из explorer.exe в Windows (технически, если он был запущен в Windows, и
все дескрипторы stdout / stderr / stdin не установлены)

· Добавление вручную --profile = псевдо-графический интерфейс в командную строку

Этот режим неявно добавляет --profile = псевдо-графический интерфейс в командную строку с псевдо-графический интерфейс
профиль предопределен со следующим содержанием:

[псевдо-графический интерфейс]
терминал = нет
силовое окно = да
idle = один раз
скриншот-каталог = ~~ рабочий стол /

Это соответствует формату файла конфигурации mpv. Чтобы настроить режим псевдо-графического интерфейса, вы можете поместить свой
собственный псевдо-графический интерфейс профиль в свой mpv.conf. Этот профиль улучшит профиль по умолчанию,
а не перезаписывать его.

Профиль всегда имеет приоритет над другими настройками в mpv.conf.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

трек Выбор
--alang =
Укажите приоритетный список используемых языков аудио. Различные форматы контейнеров
использовать разные языковые коды. DVD используют двухбуквенные коды языков ISO 639-1,
Matroska, MPEG-TS и NUT используют трехбуквенные коды языков ISO 639-2, в то время как OGM использует
идентификатор произвольной формы. Смотрите также --помогать.

Примеры

MPV dvd: // 1 --alang = ху, эн
Выбирает трек на венгерском языке на DVD и возвращается к английскому
если венгерский язык недоступен.

MPV --alang = jpn пример.mkv
Воспроизводит файл Matroska на японском языке.

--slang =
Укажите список приоритетов используемых языков субтитров. Различные форматы контейнеров
использовать разные языковые коды. DVD используют двухбуквенные коды языков ISO 639-1,
Matroska использует трехбуквенные языковые коды ISO 639-2, в то время как OGM использует произвольную форму.
идентификатор. Смотрите также --сид.

Примеры

· MPV dvd: // 1 --slang = hu, en выбирает дорожку с венгерскими субтитрами на DVD и
возвращается к английскому, если венгерский недоступен.

· MPV --slang = jpn пример.mkv воспроизводит файл Matroska с японскими субтитрами.

--aid =
Выберите звуковую дорожку. автоматический выбирает значение по умолчанию, нет отключает звук. Смотрите также --аланг.
mpv обычно печатает доступные звуковые дорожки на терминале при запуске воспроизведения
файла.

--sid =
Отобразить поток субтитров, указанный . автоматический выбирает значение по умолчанию, нет
отключает субтитры.

Смотрите также --сленг, --без-суб.

--vid =
Выберите видеоканал. автоматический выбирает значение по умолчанию, нет отключает видео.

--ff-aid = , --ff-sid = , --ff-vid =
Выберите потоки аудио / субтитров / видео по индексу потока FFmpeg. Поток FFmpeg
индекс относительно произвольный, но полезен при взаимодействии с другим программным обеспечением
используя FFmpeg (рассмотрите ffprobe).

Обратите внимание, что с внешними дорожками (добавленными с - суб-файл и аналогичные варианты), там
будут потоки с повторяющимися идентификаторами. В этом случае первым по порядку потоком будет
выбран.

--edition =
(Только файлы Matroska) Укажите издание (набор глав), которое нужно использовать, где 0 - это
первый. Если установлено на автоматический (по умолчанию), mpv выберет первое издание, объявленное как
значение по умолчанию или, если значение по умолчанию отсутствует, определено первое издание.

Воспроизведение Контролировать
--start = время>
Стремитесь к заданной временной позиции.

Общий формат абсолютного времени: [[чч:] мм:] сс [.ms]. Если время дано
с префиксом + or -, поиск осуществляется относительно начала или конца файла.
(Начиная с mpv 0.14, начало файла всегда считается 0.)

пп% стремится к процентной позиции п.п. (0-100).

#c стремится к главе номер c. (Главы начинаются с 1.)

Примеры

--start = + 56, --start = + 00: 56
Стремится к времени старта + 56 секунд.

--start = -56, --start = -00: 56
Добивается до конца времени - 56 секунд.

--start = 01: 10: 00
Стремится к 1 часу 10 мин.

--start = 50%
Стремится к середине файла.

--start = 30 --end = 40
Стремится к 30 секундам, проигрывает 10 секунд и закрывается.

--start = -3: 20 --length = 10
Стремится за 3 минуты 20 секунд до конца файла, проигрывает 10
секунд и выходит.

--start = '# 2' --end = '# 4'
Воспроизведение глав 2 и 3 и выход.

--end =
Остановитесь в указанное абсолютное время. Использовать --длина если время должно быть относительно
--Начните. Посмотреть --Начните для допустимых значений параметров и примеров.

--length = время>
Остановить через заданное время относительно времени начала. Видеть --Начните для действительного варианта
ценности и примеры.

--rebase-start-time =
Перенести ли время начала файла на 00:00:00 (по умолчанию: да). Это меньше
неудобно для файлов, которые начинаются со случайной метки времени, например транспортных потоков. На
с другой стороны, если есть сброс меток времени, результирующее поведение может быть скорее
странный. По этой причине, а также в случае, если вы действительно заинтересованы в реальных
отметки времени, это поведение можно отключить с помощью нет.

--speed = <0.01-100>
Замедление или ускорение воспроизведения на коэффициент, указанный в параметре.

If - звуковая коррекция высоты тона (по умолчанию включено) используется, игра с большей скоростью
чем обычно, автоматически вставляет масштаб звуковой фильтр.

--loop =
Циклическое воспроизведение N раз. Ценность 1 играет один раз (по умолчанию), 2 два раза и т. д.
инф означает навсегда. нет такой же как 1 и отключает зацикливание. Если несколько файлов
указанный в командной строке, весь список воспроизведения зацикливается.

Команда сила режим похож на инф, но не пропускает записи списка воспроизведения, которые были
отмечен как неуспешный. Это означает, что игрок может тратить время процессора, пытаясь зациклить файл.
этого не существует. Но это может быть полезно для воспроизведения веб-радио в очень плохих условиях.
состояние сети.

--Пауза
Запустить плеер в приостановленном состоянии.

- перемешать
Воспроизведение файлов в случайном порядке.

--chapter =
Укажите, с какой главы начать воспроизведение. При желании укажите, какую главу завершить
играет на. Также см --Начните.

--playlist-pos =
Установите, с какого файла во внутреннем списке воспроизведения начать воспроизведение. Индекс является
целое число, где 0 означает первый файл. Значение нет означает, что выбор
запись для воспроизведения оставлена ​​механизму возобновления воспроизведения (по умолчанию). Если запись
с указанным индексом не существует, поведение не определено и может измениться в
будущие версии mpv. То же самое применимо, если в плейлисте есть другие плейлисты.
(не ожидайте разумного поведения). Передача файла списка воспроизведения в mpv должна работать
хотя с этой опцией. Например MPV плейлист.m3u --playlist-pos = 123 будет работать как
ожидается, пока плейлист.m3u не ссылается на другие плейлисты.

--playlist =
Воспроизведение файлов в соответствии с файлом списка воспроизведения (поддерживает некоторые распространенные форматы. Если формат отсутствует
обнаружен, он будет рассматриваться как список файлов, разделенных символами новой строки.
Обратите внимание, что форматы списков воспроизведения XML не поддерживаются.)

Вы можете воспроизводить плейлисты напрямую и без этой опции, однако эта опция
отключает любые механизмы безопасности, которые могут быть на месте. Вам также может понадобиться это
возможность загрузки файлов с открытым текстом в виде списка воспроизведения.

ПРЕДУПРЕЖДЕНИЕ:
То, как mpv использует файлы списков воспроизведения через - плейлист не застрахован от злонамеренного
сконструированные файлы. Такие файлы могут вызывать вредоносные действия. Это было
чехол для всех версий mpv и MPlayer, но, к сожалению, это не очень хорошо
задокументированы ранее, и некоторые люди даже ошибочно рекомендовали использовать
- плейлист из ненадежных источников. Не используйте - плейлист со случайным интернетом
источники или файлы, которым вы не доверяете!

Список воспроизведения может содержать записи, использующие другие протоколы, такие как локальные файлы или
(наиболее серьезно), специальные протоколы вроде avdevice: //, которые по своей сути
небезопасный.

--chapter-merge-threshold =
Порог слияния почти последовательных частей главы в миллисекундах
(по умолчанию: 100). Некоторые файлы Matroska с упорядоченными главами содержат неверные главы.
метки времени окончания, что приводит к небольшому разрыву между концом одной главы и началом
следующий, когда они должны совпадать. Если конец одной части воспроизведения меньше, чем
заданный порог от начала следующего, затем продолжайте воспроизведение видео
обычно по главе смены вместо того, чтобы искать.

--chapter-seek-threshold =
Расстояние в секундах от начала главы, в пределах которого происходит обратная глава
seek перейдет к предыдущей главе (по умолчанию: 5.0). После этого порога
обратный поиск главы перейдет к началу текущей главы. А
отрицательное значение означает всегда вернуться к предыдущей главе.

--hr-seek =
Выберите, когда следует использовать точный поиск, не ограниченный ключевыми кадрами. Такие поиски
требуется декодирование видео от предыдущего ключевого кадра до целевой позиции и поэтому
может занять некоторое время в зависимости от производительности декодирования. Для некоторых видеоформатов
точные поиски отключены. Эта опция выбирает вариант по умолчанию, который будет использоваться для
ищет; можно явно переопределить это значение по умолчанию в определении ключа
привязки и команды в режиме ведомого.

нет Никогда не используйте точные поиски.

абсолютный
Используйте точный поиск, если поиск осуществляется в абсолютной позиции в файле, например
как поиск по главе, но не для относительного поиска, как поведение по умолчанию
клавиши со стрелками (по умолчанию).

Да По возможности используйте точные поиски.

всегда Такой же как Да (для совместимости).

--hr-seek-demuxer-offset =
Эта опция существует, чтобы обойти ошибки при выполнении точных поисков (как в --hr-искать)
вызвано ошибками или ограничениями демультиплексоров для некоторых форматов файлов. Некоторые демультиплексоры
не удается найти ключевой кадр перед заданной целевой позицией, переходя к более позднему
положение вместо этого. Значение этой опции вычитается из указанной отметки времени.
в демультиплексор. Таким образом, если вы установите для этого параметра значение 1.5 и попытаетесь выполнить точный поиск, чтобы
60 секунд демультиплексор должен искать время 58.5, что, как мы надеемся, уменьшает время
шанс, что он ошибочно переходит в какое-то время позже 60 секунд. Обратной стороной
установка этого параметра заключается в том, что точные поиски становятся медленнее, поскольку видео между
более ранняя позиция демультиплексора и реальная цель могут быть без надобности декодированы.

--hr-seek-framedrop =
Разрешить видеодекодеру пропускать кадры во время поиска, если эти кадры находятся до
искать цель. Если этот параметр включен, точный поиск может быть быстрее, но если вы используете
видео фильтры, которые изменяют временные метки или добавляют новые кадры, это может привести к точному
поиск пропуска целевого кадра. Это, например, может нарушить возврат кадра, когда
деинтерлейсинг включен.

По умолчанию: Да

--index =
Управляет поиском в файлах. Обратите внимание, что если индекс отсутствует в файле, он
по умолчанию будет создаваться "на лету", поэтому вам не нужно это менять. Но это могло бы
помогите с некоторыми битыми файлами.

по умолчанию
используйте индекс, если он есть в файле, или создайте его, если он отсутствует

воссоздать
не читайте и не используйте индекс файла

ПРИМЕЧАНИЕ:
Этот параметр работает только в том случае, если базовый носитель поддерживает поиск (т. Е. Не с
stdin, pipe и т. д.).

--load-unsafe-плейлисты
Загружать URL-адреса из списков воспроизведения, которые считаются небезопасными (по умолчанию: нет). Это включает
специальные протоколы и все, что не относится к обычным файлам. Локальные файлы и
С другой стороны, HTTP-ссылки всегда считаются безопасными.

Обратите внимание, что - плейлист всегда загружает все записи, поэтому вы используете это вместо этого, если вы
действительно нуждаются в этой функциональности.

--loop-file =
Зациклить один файл N раз. инф означает навсегда, нет означает нормальное воспроизведение. Для
совместимость, --loop-файл и --loop-file = да также принимаются, и такие же
as --loop-file = inf.

Разница в --петля в том, что это не зацикливает список воспроизведения, а только файл
сам. Если список воспроизведения содержит только один файл, разница между двумя
вариант состоит в том, что эта опция выполняет поиск в цикле вместо перезагрузки файла.

--ab-loop-a = , --ab-петля-b =
Установите точки петли. Если воспроизведение проходит b отметка времени, он будет искать a
отметка времени. В поисках мимо b точка не зацикливается (это сделано намеренно). В
точки петель можно настроить во время выполнения с помощью соответствующих свойств. Смотрите также
ab_loop команда.

--упорядоченные-главы, --no-order-chapters
Включено по умолчанию. Отключить поддержку глав, заказанных Matroska. MPV не будет
загружать или искать фрагменты видео из других файлов, а также игнорировать любые
порядок глав, указанный для основного файла.

--ordered-chapters-files =
Загружает указанный файл как список воспроизведения и пытается использовать файлы, содержащиеся в нем, как
ссылочные файлы при открытии файла Matroska, в котором используются упорядоченные главы. Этот
отменяет обычный механизм загрузки файлов, на которые есть ссылки, путем сканирования тех же
каталог, в котором находится основной файл.

Полезно для загрузки упорядоченных файлов глав, которые не находятся на локальном
файловая система, или если указанные файлы находятся в разных каталогах.

Примечание: список воспроизведения может быть таким же простым, как текстовый файл, содержащий имена файлов, разделенные символом
новые строки.

--chapters-file =
Загрузите главы из этого файла вместо использования метаданных главы, найденных в
основной файл.

--sstep =
Пропускать секунд после каждого кадра.

ПРИМЕЧАНИЕ:
Без --hr-искать, пропуск будет привязан к ключевым кадрам.

--stop-play-on-init-failure =
Остановите воспроизведение, если не удается инициализировать аудио или видео. В настоящее время по умолчанию
поведение нет для проигрывателя командной строки, но Да для libmpv. С участием нет, воспроизведение
продолжит работу в режиме только видео или только звука, если один из них выйдет из строя. Это не
влияют на воспроизведение файлов, содержащих только аудио или только видео.

Программа Поведение
--Помогите Показать краткую сводку опций.

-v Увеличение уровня детализации, по одному уровню для каждого -v найдено в командной строке.

--версия, -V
Распечатать строку версии и выйти.

--no-config
Не загружайте файлы конфигурации по умолчанию. Это предотвращает загрузку как
на уровне пользователя и в масштабе всей системы mpv.conf и input.conf файлы. Другие файлы конфигурации
также заблокированы, например, файлы возобновления воспроизведения.

ПРИМЕЧАНИЕ:
Файлы, явно запрошенные параметрами командной строки, например --включают or
--use-filedir-conf, все равно будет загружаться.

Также см --config-дир.

--список-опций
Распечатывает все доступные параметры.

--список-свойств
Распечатайте список доступных свойств.

--list-протоколы
Распечатайте список поддерживаемых протоколов.

--log-file =
Открывает указанный путь для записи и выводит на него сообщения журнала. Существующие файлы будут
быть усеченным. Уровень журнала всегда соответствует -v, независимо от терминала
уровни детализации.

--config-dir =
Установить другой каталог конфигурации. Если это установлено, данный каталог будет
используется для загрузки файлов конфигурации, а все остальные каталоги конфигурации
игнорируется. Это означает, что глобальный каталог конфигурации mpv, а также индивидуальный пользовательский
каталоги игнорируются и переопределяются через переменные среды (MPV_HOME) находятся
также игнорируется.

Обратите внимание, что --no-config опция имеет приоритет перед этой опцией.

--сохранить позицию при выходе
Всегда сохраняйте текущую позицию воспроизведения при выходе. Когда этот файл воспроизводится снова
позже при запуске проигрыватель будет искать старую позицию воспроизведения. Это не
произойдет, если воспроизведение файла остановлено любым другим способом, кроме выхода. Для
Например, переход к следующему файлу в списке воспроизведения не сохранит позицию, и
начать воспроизведение с начала при следующем воспроизведении файла.

По умолчанию это поведение отключено, но всегда доступно при выходе из
игрок с Shift + Q.

--dump-stats =
Записать определенную статистику в данный файл. При открытии файл обрезается. В
файл будет содержать необработанные образцы, каждый с отметкой времени. Чтобы превратить этот файл в
читаемый, сценарий ИНСТРУМЕНТЫ / stats-conv.py может быть использован (который в настоящее время отображает его
в виде графика).

Эта опция полезна только для отладки.

--idle =
Заставляет mpv бездействовать, а не завершать работу, когда нет файла для воспроизведения. В основном
полезен в ведомом режиме, где mpv можно контролировать с помощью команд ввода.

консолидировать будет бездействовать только при запуске и позволит игроку закрываться, как только первый плейлист будет
закончил воспроизведение.

--include =
Укажите файл конфигурации для анализа после файлов по умолчанию.

--load-scripts =
Если установлено на нет, не загружайте автоматически скрипты из скрипты подкаталог конфигурации
(Как правило, ~ / .config / mpv / scripts /). (Дефолт: Да)

--script =
Загрузите сценарий Lua. Вы можете загрузить несколько скриптов, разделив их запятыми.
(,).

--script-opts = ключ1 = значение1, ключ2 = значение2, ...
Установите параметры для скриптов. Сценарий может запрашивать вариант по ключу. Если используется опция
а семантика значения параметра полностью зависит от загруженных сценариев.
Значения, не заявленные ни одним скриптом, игнорируются.

--merge-файлы
Представьте, что все файлы, переданные в mpv, объединены в один большой файл. Этот
использует внутреннюю поддержку временной шкалы / EDL. Обратите внимание, что это не сработает для заказанной главы
файлы.

--no-возобновить-воспроизведение
Не восстанавливайте позицию воспроизведения с смотреть позже подкаталог конфигурации
(Как правило, ~ / .config / mpv / watch_later /). Увидеть quit_watch_later команда ввода.

--profile =
Используйте данный профиль (ы), --profile = help отображает список определенных профилей.

--reset-на-следующем-файле =
Обычно mpv пытается сохранить все настройки при воспроизведении следующего файла на
плейлист, даже если они были изменены пользователем во время воспроизведения. (Это поведение
противоположность MPlayer, который пытается сбросить все настройки при следующем запуске
файл.)

По умолчанию: ничего не сбрасывать.

Это можно изменить с помощью этой опции. Он принимает список опций, и mpv будет
сбросить значение этих параметров при запуске воспроизведения до начального значения. В
начальное значение - это либо значение по умолчанию, либо значение, заданное конфигурационным файлом или командой.
линии.

В некоторых случаях это может не работать должным образом. Например, --объем будет только
сбросить, если он явно установлен в файле конфигурации или в командной строке.

Специальное имя ВСЕ сбрасывает максимально возможное количество параметров.

Примеры

· --reset-on-next-file = пауза Сброс режима паузы при переходе к следующему файлу.

· --reset-on-next-file = полноэкранный режим, скорость Сбросить полноэкранный режим и скорость воспроизведения
настройки, если они были изменены во время воспроизведения.

· --reset-on-next-file = все Попробуйте сбросить все настройки, которые были изменены во время
воспроизведение.

--write-filename-in-watch-later-config
Добавьте к файлам конфигурации watch later имя файла, на который они ссылаются. Этот
просто пишется как комментарий в верхней части файла.

ПРЕДУПРЕЖДЕНИЕ:
Эта опция может раскрывать конфиденциальную информацию и поэтому отключается
по умолчанию.

--ignore-path-in-watch-later-config
Игнорировать путь (т. Е. Использовать только имя файла) при использовании функции просмотра позже.

--show-profile =
Показать описание и содержание профиля.

--use-filedir-conf
Найдите файл конфигурации для конкретного файла в том же каталоге, что и файл,
играет. Видеть Для конкретного файла Конфигурация Файлы.

ПРЕДУПРЕЖДЕНИЕ:
Может быть опасно при воспроизведении с ненадежных носителей.

--YTDL, --no-ytdl
Включите сценарий перехвата youtube-dl. Он посмотрит на входной URL и проиграет
видео находится на сайте. Это работает со многими сайтами потокового вещания, а не только с
тот, в честь которого назван сценарий. Для этого требуется последняя версия youtube-dl.
быть установленным в системе. (Включено по умолчанию, кроме случаев, когда клиентский API /
libmpv используется.)

Если сценарий ничего не может сделать с URL-адресом, он ничего не сделает.

--ytdl-format =
Формат / качество видео, которое напрямую передается на youtube-dl. Возможные значения:
для конкретного веб-сайта и видео, для данного URL-адреса доступные форматы могут быть
найдено с помощью команды YouTube-DL --лист-форматы URL. Смотрите youtube-dl's
документация по доступным псевдонимам. (По умолчанию: youtube-dl по умолчанию, в настоящее время
bestvideo + bestaudio / лучшее)

--ytdl-raw-options = знак равно [, знак равно [, ...]]
Передайте в youtube-dl произвольные параметры. Параметр и аргумент следует передавать как
пара ключ-значение. Опции без аргументов должны включать =.

Нет проверки работоспособности, поэтому можно что-то сломать (например, передать недействительный
параметры в youtube-dl).

Пример

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

Видео
--vo =
Укажите список приоритетов используемых драйверов вывода видео. Для интерактивного использования
обычно можно указать один для использования, но в файлах конфигурации
определение списка резервных вариантов может иметь смысл. Видеть ВИДЕО ВЫВОД ВОДИТЕЛИ подробнее
и описания доступных драйверов.

--vd = <[+ | -] family1: (* | decoder1), [+ | -] family2: (* | decoder2), ... [-]>
Укажите приоритетный список используемых видеодекодеров в соответствии с их семейством и
имя. Видеть --объявление для получения дополнительной информации. Обе эти опции используют один и тот же синтаксис и
семантика; единственная разница в том, что они работают с разными списками кодеков.

ПРИМЕЧАНИЕ:
Посмотреть --vd = помощь для получения полного списка доступных декодеров.

--vf =
Укажите список видеофильтров для применения к видеопотоку. Видеть ВИДЕО ФИЛЬТРЫ для
детали и описания доступных фильтров. Варианты опций --vf-добавить,
--vf-pre, --vf-дель и --vf-clr существует для изменения ранее указанного списка, но
они вам не понадобятся для обычного использования.

--нет видео
Не воспроизводите видео. С некоторыми демультиплексорами это может не работать. В этих случаях вы можете попробовать
--vo = ноль .

mpv попытается загрузить звук только в том случае, если мультимедиа транслируется с помощью youtube-dl,
потому что это экономит пропускную способность. Это делается путем установки ytdl_format на
"bestaudio / best" в скрипте ytdl_hook.lua.

- бессрочно
Не спать при выводе видеокадров. Полезно для тестов при использовании с
- нет звука.

--framedrop =
Пропустить отображение некоторых кадров, чтобы поддерживать синхронизацию A / V на медленных системах или играть на высоких оборотах
частота кадров видео на видеовыходах с верхним пределом частоты кадров.

Аргумент выбирает методы перетаскивания и может быть одним из следующих:

Отключите любое кадрирование.

Отбрасывать поздние кадры при выводе видео (по умолчанию). Это все еще декодирует и фильтрует
все кадры, но не отображает их на VO. Он пытается запросить дисплей
FPS (только X11, неверно в системах с несколькими мониторами) или предполагает бесконечное
отображать FPS, если это не удается. Капли указываются в статусной строке терминала.
as D: поле. Если декодер работает слишком медленно, теоретически все кадры должны быть
быть отброшенным (потому что все кадры опаздывают) - чтобы избежать этого, отбрасывание кадра
останавливается, если эффективная частота кадров ниже 10 кадров в секунду.


Старый режим кадрирования на основе декодера. (Это то же самое, что и --framedrop = да in
mpv 0.5.x и ранее). Это указывает декодеру пропускать кадры (если они не
необходимы для декодирования будущих кадров). Может помочь с медленными системами, но может
воспроизводят прерывистые изображения, не доступные для просмотра, или даже полностью останавливают изображение на экране.
Не рекомендуется. В --vd-lavc-framedrop опция определяет, какие кадры
понижаться.


Включите оба режима. Не рекомендуется.

ПРИМЕЧАНИЕ:
--vo = vdpau есть собственный код для vo режим кадрирования. Небольшие отличия от
возможны другие ВО.

--display-fps =
Установите частоту кадров дисплея, используемую с --video-sync = дисплей- * режимы. По умолчанию
используется обнаруженное значение (только X11, неверно в системах с несколькими мониторами). Держать в
помните, что установка неправильного значения (даже если оно немного неправильное) может испортить видео
воспроизведение.

--hwdec =
Укажите API аппаратного декодирования видео, который следует использовать, если это возможно. Ли
аппаратное декодирование фактически выполняется в зависимости от видеокодека. Если аппаратное декодирование
невозможно, mpv вернется к программному декодированию.

может быть одним из следующих:

нет всегда использовать программное декодирование (по умолчанию)

автоматический см. ниже

вдпау требуется --vo = vdpau or --vo = opengl (Только Linux)

ваапи требуется --vo = opengl or --vo = vaapi (Только Linux)

ваапи-копия
копирует видео обратно в системную оперативную память (только для Linux с графическими процессорами Intel)

видеоинструмент
требуется --vo = opengl (Только OS X 10.8 и выше)

dxva2-копия
копирует видео обратно в системную RAM (только для Windows)

RPI требуется --vo = rpi (Только Raspberry Pi - по умолчанию, если доступно)

автоматический пытается автоматически включить аппаратное декодирование, используя первое доступное
метод. Это все еще зависит от того, какой VO вы используете. Например, если вы не используете
--vo = vdpau or --vo = opengl, декодирование vdpau никогда не будет включено. Также обратите внимание, что если
первый найденный метод на самом деле не работает, он всегда будет возвращаться к программному обеспечению
декодирование вместо того, чтобы пробовать следующий метод (может иметь значение в некоторых системах Linux).

Команда ваапи режим, если используется с --vo = opengl, требует Mesa 11 и, скорее всего, работает
только с графическими процессорами Intel. Также требуется бэкэнд opengl EGL (автоматически используется
если доступно). Вы также можете попробовать старый бэкэнд GLX, заставив его
--vo = opengl: backend = x11, но взаимодействие vaapi / GLX считается медленнее, чем
ваапи-копия.

Команда ваапи-копия режим позволяет использовать vaapi с любым VO. Потому что это копирует
декодированного видео обратно в системную RAM, вероятно, он менее эффективен, чем ваапи Режим.

ПРИМЕЧАНИЕ:
При использовании этого переключателя аппаратное декодирование по-прежнему выполняется только для некоторых кодеков.
Посмотреть --hwdec-кодеки чтобы включить аппаратное декодирование для большего количества кодеков.

--hwdec-preload =
Это полезно для OpenGL и opengl-cb ВО для создания аппаратного декодирования
Контекст взаимодействия OpenGL, но без фактического включения самого аппаратного декодирования
(как --hwdec делает).

Если установлено на нет (по умолчанию), --hwdec опция используется.

Что касается OpenGL, если установлено, не создавать контекст взаимодействия по запросу, но когда VO
создано.

Что касается opengl-cb, если установлено, загружать контекст взаимодействия, как только контекст OpenGL
созданный. С opengl-cb не имеет загрузки по запросу, это позволяет включать оборудование
декодирование во время выполнения, без необходимости временно устанавливать hwdec вариант
только во время инициализации контекста OpenGL с помощью mpv_opengl_cb_init_gl ().

--videotoolbox-format =
Установите внутренний формат пикселей, используемый --hwdec = videotoolbox на OSX. Выбор
формат может значительно повлиять на производительность. С другой стороны, нет
кажется хорошим способом определить лучший формат для данного оборудования. nv12,
по умолчанию, лучше работает на современном оборудовании, в то время как уйви422 кажется лучше для
старое оборудование. RGB0 тоже работает.

--panscan = <0.0-1.0>
Обеспечивает функцию панорамирования и сканирования (обрезка сторон, например, видео формата 16: 9, чтобы
он подходит для дисплея с соотношением сторон 4: 3 без черных полос). Диапазон определяет, какая часть изображения
обрезается. Может работать не со всеми драйверами вывода видео.

--video-аспект =
Переопределить соотношение сторон видео, если информация о соотношении сторон неверна или отсутствует в
воспроизводимый файл. Смотрите также --no-video-аспект.

Два значения имеют особое значение:

0 отключите обработку соотношения сторон, представьте, что в видео есть квадратные пиксели

-1 использовать видеопоток или аспект контейнера (по умолчанию)

Но учтите, что обработка этих специальных значений может измениться в будущем.

Примеры

· --video-аспект = 4: 3 or --video-аспект = 1.3333

· --video-аспект = 16: 9 or --video-аспект = 1.7777

--no-video-аспект
Игнорировать информацию о соотношении сторон из видеофайла и предполагать, что видео имеет квадратную форму.
пикселей. Смотрите также --видео-аспект.

--video-аспект-метод =
Устанавливает метод определения соотношения сторон видео по умолчанию (если соотношение сторон _не_
переопределено пользователем с помощью --видео-аспект или другие).

гибрид Предпочитайте соотношение сторон контейнера. Если аспект битового потока переключается
mid-stream, переключитесь в режим битового потока. Это по умолчанию
поведение в mpv и mplayer2.

контейнер
Строго предпочитаю соотношение сторон контейнера. По-видимому, это значение по умолчанию
поведение с VLC, по крайней мере, с Matroska.

битовый поток
Строго предпочитаю формат битового потока, если только формат битового потока
соотношение не установлено. По-видимому, это поведение по умолчанию с XBMC / kodi на
по крайней мере с Матроской.

Обычно вы не должны устанавливать это. Попробуйте контейнер и битовый поток выбор, если вы
встретить видео с неправильным соотношением сторон в mpv, но кажется правильным в
другие игроки.

--video-немасштабированный
Отключить масштабирование видео. Если окно больше видео, черные полосы
добавлены. В противном случае видео будет обрезано. На видео по-прежнему может влиять
другие --видео-... параметры. (Но не все; например --видео-зум ничего не делает
если эта опция включена.)

Аспекты видео и монитора будут проигнорированы. Коррекция аспекта
требуется масштабировать видео по оси X или Y, но этот параметр отключает
масштабирование, отключение всех коррекций сторон.

Обратите внимание, что алгоритм масштабирования все еще может использоваться, даже если видео не масштабируется.
Например, это может повлиять на преобразование цветности.

Эта опция отключена, если --no-keepaspect опция используется.

--video-pan-x = , --video-pan-y =
Перемещает отображаемый прямоугольник видео на заданное значение в направлении X или Y. В
единица измерения выражается в долях размера масштабированного видео (полный размер, даже если
видео не отображаются из-за панскана или других параметров).

Например, отображение полноэкранного видео 1280x720 на экране 1680x1050 с
--video-pan-x = -0.1 перемещает видео на 168 пикселей влево (делая 128 пикселей
исходного видео невидимо).

Эта опция отключена, если --no-keepaspect опция используется.

--video-rotate = <0-360 | нет>
Поверните видео по часовой стрелке в градусах. В настоящее время поддерживает только шаги 90 °. Если нет
задано, видео никогда не поворачивается, даже если файл имеет метаданные поворота. (В
значение поворота добавляется к метаданным поворота, что означает, что значение 0 бы
повернуть видео в соответствии с метаданными поворота.)

--video-стерео-режим =
Установите режим вывода стерео 3D (по умолчанию: моно). Это делается путем вставки
стерео3d фильтр преобразования.

Псевдо-режим нет полностью отключает автоматическое преобразование.

Режим моно это псевдоним для ml, который относится к левому кадру в 2D. Это
по умолчанию, что означает, что mpv будет пытаться показывать 3D-фильмы в 2D, а не в искаженном
3D-изображение, не предназначенное для использования (например, показ левого и правого кадра)
бок о бок и т. д.).

Используйте --video-stereo-mode = помощь чтобы перечислить все доступные режимы. Проверить с стерео3d
отфильтруйте документацию, чтобы увидеть, что означают названия. Обратите внимание, что некоторые имена относятся к
режимы не поддерживаются стерео3d - эти режимы могут появляться в файлах, но не могут быть
правильно обрабатывается mpv.

--video-zoom =
Отрегулируйте масштабный коэффициент отображения видео на заданное значение. Единица измерения в долях
размера (масштабированного) окна видео.

Например, для видео с разрешением 1280x720, отображаемого в окне с разрешением 1280x720, --video-zoom = -0.1
сделает видео на 128 пикселей меньше по оси X и на 72 пикселя по оси Y
направлении.

Эта опция отключена, если --no-keepaspect опция используется.

--video-align-x = <-1-1>, --video-align-y = <-1-1>
Перемещает прямоугольник видео внутри черных рамок, которые обычно добавляются на панель.
видео на экран, если соотношение сторон видео и экрана отличается.
--video-align-y = -1 переместит видео в верхнюю часть экрана (оставив границу
только внизу) значение 0 центрирует его (по умолчанию), а значение 1 положил бы
видео внизу экрана.

Если видео и формат экрана полностью совпадают, эти параметры ничего не делают.

Эта опция отключена, если --no-keepaspect опция используется.

--правильно-pts, --no-right-pts
--no-right-pts переключает mpv в режим, в котором время видео определяется с помощью
фиксированное значение частоты кадров (либо с использованием - кадров в секунду вариант или используя информацию о файле).
Иногда файлы с очень поврежденными временными метками могут неплохо воспроизводиться в этом
режим. Обратите внимание, что видеофильтры, рендеринг субтитров и синхронизация звука могут быть
полностью сломан в этом режиме.

--fps =
Переопределить частоту кадров видео. Полезно, если исходное значение неверно или отсутствует.

ПРИМЕЧАНИЕ:
Работает в --no-right-pts только режим.

--deinterlace =
Включение или отключение чересстрочной развертки (по умолчанию: авто, что обычно означает «нет»). Чересстрочный
видео показывает уродливые гребешковые артефакты, которые видны при быстром движении. Включение
обычно вставляется видеофильтр yadif для деинтерлейсинга видео, или
позволяет видео выходу применять деинтерлейсинг, если он поддерживается.

Это ведет себя точно так же, как деинтерлейсинг свойство ввода (обычно отображается на d).

автоматический это формальность. Строго говоря, значение по умолчанию для этой опции -
деинтерлейсинг отключен, но автоматический случай необходим, если Ядиф был добавлен в
цепочка фильтров вручную с --vf. Тогда ядро ​​не должно отключать деинтерлейсинг, просто
поскольку --деинтерлейсинг не было установлено.

--поле-доминирование =
Установите первое поле для чересстрочного контента. Полезно для деинтерлейсеров, удваивающих
частота кадров: --vf = yadif = поле и --vo = vdpau: deint.

автоматический (по умолчанию) Если декодер не экспортирует соответствующую информацию, он
падает обратно на топ (сначала верхнее поле).

топ сначала верхнее поле

нижний нижнее поле сначала

ПРИМЕЧАНИЕ:
Установка либо топ or нижний помечает все кадры как чересстрочные.

--frames =
Играть / конвертировать только сначала кадры видео, затем выйдите.

--frames = 0 загружает файл, но немедленно завершает работу перед инициализацией воспроизведения.
(Может быть полезно для скриптов, которые просто хотят определить некоторые свойства файла.)

Для воспроизведения только аудио любое значение больше 0 немедленно прекратит воспроизведение.
после инициализации. Значение 0 работает как с видео.

--video-output-levels =
Уровни цвета RGB, используемые с преобразованием YUV в RGB. Обычно такие устройства вывода, как
Мониторы ПК используют полный диапазон цветовых уровней. Однако некоторые телевизоры и видеомониторы
ожидайте студийные уровни RGB. Обеспечение вывода полного диапазона на устройство, ожидающее студии
ввод уровня приводит к раздавливанию черного и белого цветов, а наоборот - тусклым серым черным
и тусклые белые.

Не все ВО поддерживают этот вариант. Некоторые молча проигнорируют это.

Доступные цветовые диапазоны:

автоматический автоматический выбор (соответствует полному диапазону) (по умолчанию)

ограниченный
ограниченный диапазон (16-235 на компонент), студийные уровни

полный полный диапазон (0-255 на компонент), уровни ПК

ПРИМЕЧАНИЕ:
Вместо этого рекомендуется использовать параметр цветового диапазона вашего графического драйвера, если
доступен.

--hwdec-codecs =
Разрешить аппаратное декодирование только для указанного списка кодеков. Особая ценность ВСЕ
всегда разрешает все кодеки.

Вы можете получить список разрешенных кодеков с помощью MPV --vd = помощь. Удалите префикс, например
вместо lavc: h264 используют h264.

По умолчанию это установлено на h264, vc1, wmv3, hevc, mpeg2video. Обратите внимание, что оборудование
специальные кодеки ускорения, такие как h264_vdpau больше не актуальны, и на самом деле
удалены из Либава в этой форме.

Обычно это требуется только для сломанных графических процессоров, когда кодек отображается как
поддерживается, но декодирование вызывает больше проблем, чем решает.

Пример

MPV --hwdec = vdpau --vo = vdpau --hwdec-codecs = h264, mpeg2video
Включите декодирование vdpau только для форматов h264 и mpeg2.

--vd-lavc-check-hw-profile =
Проверьте профиль аппаратного декодера (по умолчанию: да). Если нет установлен, самый высокий профиль
аппаратный декодер выбирается безоговорочно, и декодирование принудительно, даже если
профиль видео выше этого. Результат скорее всего сломан
декодирование, но также может помочь, если обнаруженные или зарегистрированные профили каким-то образом
неверен.

--vd-lavc-software-fallback =
Возврат к программному декодированию в случае сбоя аппаратно-ускоренного декодера (по умолчанию:
3). Если это число, то откат будет запущен, если N кадров не декодируются.
в ряд. 1 эквивалентен Да.

--vd-lavc-bitexact
Используйте только алгоритмы с точностью до бита на всех этапах декодирования (для тестирования кодеков).

--vd-lavc-быстро (МПЕГ-2, MPEG-4, и H.264 только)
Включите оптимизацию, которая не соответствует спецификации формата и
потенциально могут вызвать проблемы, такие как более простое деквантование, более простое движение
компенсация, предполагая использование матрицы квантования по умолчанию, предполагая YUV 4: 2: 0
и пропуск нескольких проверок для обнаружения поврежденных битовых потоков.

--vd-lavc-o = знак равно [, знак равно [, ...]]
Передайте AVOptions декодеру libavcodec. Обратите внимание, патч, чтобы сделать o= ненужный и
передать все неизвестные варианты через систему AVOption приветствуется. Полный список
AVOptions можно найти в руководстве FFmpeg.

Некоторые параметры, которые раньше были прямыми, могут быть установлены с помощью этого механизма, например
ошибка, серый, ИДКТ, ec, Vismv, Skip_top (было st), пропустить_дно (было sb), отлаживать.

Пример

--vd-lavc-o = отладка = пикт

--vd-lavc-show-all =
Показывать даже битые / поврежденные кадры (по умолчанию: нет). Если для этого параметра установлено значение нет,
libavcodec не будет выводить кадры, которые были декодированы до исходного ключевого кадра.
был декодирован, или кадры признаны поврежденными.

--vd-lavc-skiploopfilter = (H.264 только)
Пропускает контурный фильтр (снятие блочности) во время декодирования H.264. Поскольку отфильтрованные
кадр предполагается использовать в качестве эталона для декодирования зависимых кадров, он имеет
хуже влияет на качество, чем отсутствие разблокировки, например, для видео MPEG-2. Но в
по крайней мере для HDTV с высоким битрейтом, это обеспечивает большое ускорение с малозаметным
потеря качества.

может быть одним из следующих:

нет Никогда не пропускайте.

по умолчанию
Пропустить бесполезные этапы обработки (например, пакеты нулевого размера в AVI).

нереф. Пропускать кадры, на которые нет ссылок (т. Е. Не используемые для декодирования других
кадры, ошибка не может "накапливаться").

бидир Пропустить B-кадры.

неключевой Пропускать все кадры, кроме ключевых.

ВСЕ Пропустить все кадры.

--vd-lavc-skipidct = (МПЕГ-1/2 только)
Пропускает шаг IDCT. Это сильно снижает качество почти во всех случаях (см.
skiploopfilter для доступных значений пропуска).

--vd-lavc-skipframe =
Полностью пропускает декодирование кадров. Большое ускорение, но резкие движения, а иногда и
плохие артефакты (доступные значения пропуска см. в skiploopfilter).

--vd-lavc-framedrop =
Установите режим кадрирования, используемый с --framedrop (см. skiploopfilter, чтобы узнать о возможности пропуска
ценности).

--vd-lavc-thread =
Количество потоков, используемых для декодирования. Поддерживается ли на самом деле многопоточность
зависит от кодека (по умолчанию: 0). 0 означает автоматическое определение количества ядер на машине
и используйте это максимум до 16. Вы можете установить более 16 потоков вручную.

Аудио
--audio-pitch-corrective =
Если он включен (по умолчанию), воспроизведение со скоростью, отличной от нормальной.
автоматически вставляет масштаб аудио фильтр. Подробнее см. Аудиофильтр.
.

--audio-device =
Используйте данное аудиоустройство. Он состоит из имени аудиовыхода, например альса,
последующей /, за которым следует имя конкретного устройства аудиовыхода.

Вы можете перечислить аудиоустройства с помощью --audio-device = помощь. Это выводит имя устройства
в кавычках с последующим описанием. Имя устройства - это то, что вы должны передать
--аудио-устройство опцию.

Значение по умолчанию для этой опции - автоматический, который пробует каждый аудиовыход в
порядок предпочтений с устройством по умолчанию.

Обратите внимание, что многие АО имеют устройство подопция, которая отменяет выбор устройства
этой опции (но не выбора аудиовыхода). Аналогичным образом, принудительное использование АО с
--ао отменяет выбор аудиовыхода --аудио-устройство (но не устройство
выбор).

В настоящее время не реализовано для большинства АО.

--audio-fallback-to-null =
Если не удается открыть ни одно аудиоустройство, ведите себя так, как если бы --ao = ноль был дан. Это полезно
в сочетании с --аудио-устройство: вместо того, чтобы вызывать ошибку, если выбранный
устройство не существует, пользователь клиентского API (или сценарий Lua) может разрешить воспроизведение
продолжайте нормально и проверьте ток-ао и список аудиоустройств свойства для
принимать высокоуровневые решения о том, как продолжить.

--ao =
Укажите список приоритетов используемых драйверов вывода звука. Для интерактивного использования один
обычно указывается один для использования, но в файлах конфигурации указывается
список резервных вариантов может иметь смысл. Видеть АУДИО ВЫВОД ВОДИТЕЛИ для деталей и
описания доступных драйверов.

--af =
Укажите список аудиофильтров для применения к аудиопотоку. Видеть АУДИО ФИЛЬТРЫ для
детали и описания доступных фильтров. Варианты опций --af-добавить,
--af-pre, --аф-дель и --af-clr существует для изменения ранее указанного списка, но
они вам не понадобятся для обычного использования.

--audio-spdif =
Список кодеков, для которых следует использовать сквозную передачу сжатого аудио. Это работает
как для классического S / PDIF, так и для HDMI.

Возможные кодеки: ac3, д.т.н., ДТС-HD. Можно указать несколько кодеков
разделяя их ,. д.т.н. относится к ядру DTS с низким битрейтом, а ДТС-HD относится к
DTS MA (поддержка приемника и ОС различается). Вы должны использовать только либо д.т.н. or ДТС-HD
(если указаны оба, и д.т.н. на первом месте, только д.т.н. будет использоваться).

В общем, все кодеки в SPDIF семья перечислена с --ad = помощь поддерживаются в
теория.

Предупреждение

Нет особой причины использовать это. HDMI поддерживает несжатый
многоканальный PCM и mpv поддерживает декодирование DTS-HD без потерь через FFmpeg
Оболочка libdcadec.

--ad = <[+ | -] family1: (* | decoder1), [+ | -] family2: (* | decoder2), ... [-]>
Укажите список приоритетов используемых аудиодекодеров в соответствии с их семейством и
имя декодера. Записи вроде семья:* отдать приоритет всем декодерам данного семейства.
При определении того, какой декодер использовать, первый декодер, который соответствует аудио
формат выбран. Если он недоступен, используется следующий декодер. Наконец, это
пробует все другие декодеры, которые не были явно выбраны или отклонены
опцию.

- в конце списка подавляет откат на другие доступные декодеры не на
--объявление . + перед входом заставляет декодер. Оба они не должны
обычно используются, потому что они нарушают нормальный автоматический выбор декодера!

- перед записью отключает выбор декодера.

Примеры

--ad = lavc: mp3float
Предпочитаю FFmpeg / Libav mp3поплавок декодер по сравнению со всеми другими декодерами MP3.

--ad = spdif: ac3, lavc: *
Всегда отдавайте предпочтение spdif AC3 перед FFmpeg / Libav всему остальному.

--ad = помощь
Перечислите все доступные декодеры.

Предупреждение

Включение передачи сжатого аудио (AC3 и DTS через SPDIF / HDMI) с
эта опция устарела. Использовать --аудио-spdif .

--volume =
Установите начальную громкость. 0 означает тишину, 100 означает отсутствие уменьшения громкости или
усиление. Значение -1 (по умолчанию) не изменит громкость. Смотрите также
--софтвол.

ПРИМЕЧАНИЕ:
Это было изменено после выпуска mpv 0.9. До этого 100 на самом деле означало
максимальная громкость. При этом шкалу объема сделали кубической, поэтому старая
значения в любом случае не будут совпадать с новыми.

--audio-delay =
Задержка звука в секундах (положительное или отрицательное значение с плавающей запятой). Задержка положительных значений
звук, а отрицательные значения задерживают видео.

--нет-аудио
Не воспроизводить звук.

--mute =
Установите статус отключения звука при запуске. автоматический (по умолчанию) не изменяет статус отключения звука. Также
посмотреть --объем.

--softvol =
Определите, использовать ли регуляторы громкости драйвера вывода звука или
внутренний объемный фильтр MPV.

нет предпочитаете элементы управления аудиодрайвером, используйте фильтр громкости только в том случае, если
необходимый

Да всегда используйте объемный фильтр

автоматический предпочитать фильтр громкости, если аудиодрайвер использует системный микшер (по умолчанию)

Намерение автоматический чтобы избежать изменения настроек системного микшера изнутри mpv
с настройками по умолчанию. mpv - это видеоплеер, а не панель микшера. С другой
стороны, элементы управления микшером включены для звуковых серверов, таких как PulseAudio, которые обеспечивают
объем на приложение.

--audio-demuxer = <[+] имя>
Используйте этот тип аудио демультиплексора при использовании --audio-файл. Используйте "+" перед именем, чтобы
заставить это; это пропустит некоторые проверки. Дайте демультиплексору имя, напечатанное
--audio-demuxer = помощь.

--ad-lavc-ac3drc =
Выберите уровень сжатия динамического диапазона для аудиопотоков AC-3. - это
значение с плавающей запятой в диапазоне от 0 до 1, где 0 означает отсутствие сжатия (что является
по умолчанию), а 1 означает полное сжатие (сделать громкие звуки тише и наоборот).
наоборот). Допускаются также значения до 6, но они являются чисто экспериментальными. Этот вариант
показывает эффект только в том случае, если поток AC-3 содержит сжатие необходимого диапазона
Информация.

Стандарт требует, чтобы DRC был включен по умолчанию, но mpv (и некоторые другие
плееры) игнорируют это ради лучшего качества звука.

--ad-lavc-downmix =
Следует ли запрашивать понижающее микширование аудиоканала от декодера (по умолчанию: да). Некоторые
декодеры, такие как AC-3, AAC и DTS, могут повторно микшировать звук при декодировании. Запрошенный номер
выходных каналов устанавливается с помощью --аудиоканалы вариант. Полезно для игры
объемный звук в стереосистеме.

--ad-lavc-thread = <0-16>
Количество потоков, используемых для декодирования. Поддерживается ли на самом деле многопоточность
зависит от кодека. На момент написания этой статьи он поддерживался только для некоторых кодеков без потерь.
0 означает автоматическое определение количества ядер на машине и использование его до максимума.
из 16 (по умолчанию: 1).

--ad-lavc-o = знак равно [, знак равно [, ...]]
Передайте AVOptions декодеру libavcodec. Обратите внимание, патч, чтобы сделать o = ненужным и
передать все неизвестные варианты через систему AVOption приветствуется. Полный список
AVOptions можно найти в руководстве FFmpeg.

--ad-spdif-dtshd = , --дтшд, --no-dtshd
Если DTS передается, используйте DTS-HD.

Предупреждение

Это и включение сквозной передачи через --объявление устарели в пользу использования
--audio-spdif = dts-hd.

--audio-каналы =
Запросить схему канала для вывода звука (по умолчанию: авто). Это попросит АО
открыть устройство с заданным расположением каналов. АО должно принять это
макет, или выбрать запасной вариант, или исправить ошибку, если запрошенный макет не
поддерживается.

Команда --аудиоканалы опция либо принимает номер канала, либо явный канал
макет. Номера каналов относятся к раскладке по умолчанию, например, 2 канала относятся к стерео,
6 относится к 5.1.

Посмотреть --audio-channels = help вывод для определенных макетов по умолчанию. Здесь также перечислены
имена динамиков, которые можно использовать для обозначения произвольной схемы каналов (например,
фл-фр-жизнь равно 2.1).

По умолчанию используется --audio-каналы = авто, который пытается воспроизвести звук, используя вход
макет канала файла. (Или, точнее, выход цепочки аудиофильтров.)
(пустой это приемлемый устаревший псевдоним для автоматический.)

Это также запросит схему канала у декодера. Если декодер не
поддерживая макет, он вернется к своему собственному макету канала. (Вы можете использовать
--ad-lavc-downmix = нет чтобы декодер всегда выводил свой собственный макет.) Примечание
что только некоторые декодеры поддерживают ремикс аудио. Некоторые из них включают AC-3, AAC или
Аудио DTS.

Если расположение каналов медиафайла (т.е. декодера) и канала АО
макет не совпадает, mpv попытается вставить фильтр преобразования.

Предупреждение

. автоматический может вызвать проблемы при использовании звука через HDMI. ОС будет
обычно сообщают обо всех схемах каналов, которые _ могут_ проходить через HDMI, даже если
ресивер их не поддерживает. Если получатель получает неподдерживаемый канал
макет, могут произойти случайные вещи, например, удаление дополнительных
каналов или добавление шума.

--audio-display =
Установка этого параметра на привязанность (по умолчанию) будет отображать прикрепленные изображения (например,
обложку альбома) при воспроизведении аудиофайлов. Будет отображено первое найденное изображение,
а дополнительные изображения доступны в виде видеодорожек.

Установка этого параметра на нет полностью отключает отображение видео при воспроизведении звука
файлы.

Эта опция не влияет на файлы с обычными видеодорожками.

--audio-file =
Воспроизведение звука из внешнего файла при просмотре видео. Каждое использование этой опции
добавит новую звуковую дорожку. Детали похожи на то, как - суб-файл работ.

--audio-format =
Выберите формат сэмпла, используемый для вывода из слоя аудиофильтра в звук.
карта. Ценности, которые могут принять, перечислены ниже в описании
формат звуковой фильтр.

--audio-samplerate =
Выберите используемую частоту дискретизации вывода (конечно, звуковые карты имеют ограничения на
это). Если выбранная частота дискретизации отличается от текущей
media, аудиофильтр lavrresample будет вставлен в слой аудиофильтра
чтобы компенсировать разницу.

--gapless-audio =
Попробуйте воспроизвести последовательные аудиофайлы без тишины или прерывания в момент
изменение файла. Дефолт: слабый.

нет Отключить непрерывный звук.

Да Открытие аудиоустройства осуществляется с использованием параметров, выбранных в соответствии с первым
файл воспроизводится, а затем остается открытым для воспроизведения без пауз. Это означает, что если
например, первый файл имеет низкую частоту дискретизации, затем следующие файлы
может быть передискретизирован до той же низкой частоты дискретизации, что приведет к уменьшению звука
качественный. Если вы воспроизводите файлы с разными параметрами, рассмотрите возможность использования опций
как --аудио-сэмплрейт и --аудио-формат чтобы явно выбрать, что
общий выходной формат будет.

слабый Обычно аудиоустройство остается открытым (в том формате, в котором оно было
инициализируется с помощью). Если аудиоформат вывода декодера изменится, звук
устройство закрывается и снова открывается. Это означает, что вы обычно получаете
аудио с файлами, которые были закодированы с использованием тех же настроек, но, возможно, не были
без зазоров в остальных случаях. (В отличие от Да, тебе не о чем беспокоиться
угловые случаи, такие как первый файл, устанавливающий выходной формат очень низкого качества,
и ухудшение воспроизведения следующих файлов более высокого качества.)

ПРИМЕЧАНИЕ:
Эта функция реализована просто и зависит от устройства вывода звука.
буферизация для продолжения воспроизведения при переходе от одного файла к другому. Если
воспроизведение нового файла начинается медленно, например, потому что он воспроизводится с
удаленное сетевое расположение или из-за того, что вы указали параметры кеширования, которые
требуется время для начального заполнения кеша, тогда буферизованный звук может закончиться
перед началом воспроизведения нового файла.

--initial-аудио-синхронизация, --no-начальная-аудио-синхронизация
При запуске видеофайла или после таких событий, как поиск, mpv по умолчанию
изменить аудиопоток, чтобы он начинался с той же метки времени, что и видео, с помощью
либо вставляя тишину в начале, либо отсекая первые сэмплы. Отключение
эта опция заставляет проигрыватель вести себя так же, как и старые версии mpv: видео и аудио
оба запускаются немедленно, даже если их временные метки различаются, а затем видео
время постепенно корректируется, если это необходимо для достижения правильной синхронизации позже.

--softvol-max = <100.0-1000.0>
Установите максимальный уровень усиления в процентах (по умолчанию: 130). Значение 130 будет
позволяют отрегулировать громкость примерно вдвое по сравнению с обычным уровнем.

--audio-file-auto = , --no-аудио-файл-авто
Загрузите дополнительные аудиофайлы, соответствующие имени файла видео. Параметр указывает
как сопоставляются внешние аудиофайлы. точный по умолчанию включен.

нет Не загружать внешние аудиофайлы автоматически.

точный Загрузите имя файла мультимедиа с расширением аудиофайла (по умолчанию).

нечеткий Загрузите все аудиофайлы, содержащие имя файла мультимедиа.

ВСЕ Загрузите все аудиофайлы в текущий каталог.

--audio-client-name =
Имя приложения, которое проигрыватель сообщает аудио API. Может пригодиться, если хочешь
для принудительного использования другого аудиопрофиля (например, с PulseAudio) или для установки собственного
имя приложения при использовании libmpv.

--volume-restore-data =
Используется внутри для использования при возобновлении воспроизведения (например, с quit_watch_later). Восстановление
значение нужно делать осторожно, потому что разные АО, а также softvol могут иметь
разные диапазоны значений, и мы не хотим восстанавливать громкость, если устанавливаем громкость
меняет его в масштабе всей системы. Обычные варианты (вроде --объем) всегда будет устанавливать
объем. Эта опция была добавлена ​​для более безопасного восстановления громкости (путем сохранения
метод, используемый для установки громкости), и обычно не используется. Его семантика
считается частным для mpv.

Не используйте.

--audio-buffer =
Установите минимальный буфер аудиовыхода. Аудиоустройство может фактически создать
больший буфер, если угодно. Если устройство создает буфер меньшего размера, дополнительные
аудио буферизуется в дополнительном программном буфере.

Увеличение этого параметра приведет к тому, что мягкий объем и другие фильтры будут реагировать медленнее.
дополнительные проблемы при изменении скорости воспроизведения и блокировка плеера на аудиоформате
изменения. Буфер меньшего размера может привести к пропаданию звука.

Этот вариант следует использовать только для тестирования. Если значение не по умолчанию помогает
Что важно, следует связаться с разработчиками mpv.

По умолчанию: 0.2 (200 мс).

Субтитры
--без-суб
Не выбирайте субтитры при загрузке файла.

--sub-demuxer = <[+] имя>
Принудительный тип демультиплексора субтитров для - суб-файл. Дайте демультиплексору имя, напечатанное
--sub-demuxer = помощь.

--sub-delay =
Задерживает субтитры на секунд. Может быть отрицательным.

--sub-file = файл субтитров
Добавьте файл субтитров в список внешних субтитров.

Если вы используете - суб-файл только один раз этот файл субтитров отображается по умолчанию.

If - суб-файл используется несколько раз, субтитры можно переключить в
время выполнения путем циклического воспроизведения дорожек субтитров. Одновременно можно показывать два субтитра:
используют --сид для выбора первого индекса субтитров и - вторичный-сид для выбора
второй индекс. (Индекс печатается на выходе терминала после --sid = в
список потоков.)

--secondary-sid =
Выберите дополнительный поток субтитров. Это похоже на --сид. Если вторичный
подзаголовок выбран, он будет отображаться как заголовок (т. е. в верхней части
экран) рядом с обычными субтитрами и обеспечивает способ визуализации двух субтитров.
однажды.

Есть некоторые предостережения, связанные с этой функцией. Например, растровые субтитры
всегда будут отображаться в их обычном положении, поэтому выберите подзаголовок растрового изображения как
вторичный субтитр приведет к наложению субтитров. Вторичные субтитры
никогда не отображается на терминале, если видео отключено.

ПРИМЕЧАНИЕ:
Стилизация и интерпретация любых тегов форматирования отключены для вторичного
подзаголовок. Внутри тот же механизм, что и - без задницы используется для снятия
укладка.

ПРИМЕЧАНИЕ:
Если основной поток субтитров содержит теги форматирования, отображающие субтитры
в верхней части экрана он будет перекрываться второстепенным субтитром. К
предотвратить это, вы можете использовать - без задницы отключить стили в главном субтитре
поток.

--sub-scale = <0-100>
Коэффициент для размера шрифта текстовых субтитров (по умолчанию: 1).

ПРИМЕЧАНИЕ:
Это также влияет на субтитры ASS и может привести к неправильным субтитрам.
рендеринг. Используйте с осторожностью или используйте --размер шрифта подтекста .

--sub-scale-by-window =
Масштабировать ли субтитры по размеру окна (по умолчанию: да). Если это
отключено, изменение размера окна не изменит размер шрифта субтитров.

Подобно - субшкала, это может нарушить субтитры ASS.

--sub-scale-with-window =
Делайте размер шрифта субтитров относительно окна, а не видео. Это
полезно, если вам всегда нужен один и тот же размер шрифта, даже если видео не скрывает
окно полностью, например, из-за несовпадения соотношения сторон экрана и окна (и проигрыватель
добавляет черные полосы).

По умолчанию: да.

Этот вариант неправильно назван. Отличие от до смешения похожего по звучанию варианта
-Суб-масштаб по шкале является то, что --sub-масштаб-с-окном все еще весит с
приблизительный размер окна, в то время как другой параметр отключает это масштабирование.

Влияет только на текстовые субтитры (или на ASS, если --ass-стиль-переопределить установлен высоко
достаточно).

--ass-scale-с-окном =
Подобно --sub-масштаб-с-окном, но влияет только на субтитры в формате ASS. Нравится
- субшкала, это может нарушить субтитры ASS.

По умолчанию: нет.

- встроенные шрифты, --no-embeddedfonts
Используйте шрифты, встроенные в файлы-контейнеры Matroska и сценарии ASS (по умолчанию: включено).
Эти шрифты можно использовать для рендеринга субтитров SSA / ASS.

--sub-pos = <0-100>
Укажите положение субтитров на экране. Значение - это вертикальное положение.
субтитра в% от высоты экрана.

ПРИМЕЧАНИЕ:
Это также влияет на субтитры ASS и может привести к неправильным субтитрам.
рендеринг. Используйте с осторожностью или используйте --sub-text-margin-y .

--sub-speed = <0.1-10.0>
Умножьте временные метки событий субтитров на заданное значение. Может использоваться для исправления
скорость воспроизведения для форматов субтитров на основе кадров. Влияет только на текстовые субтитры.

Пример

--sub-speed = 25 / 23.976` воспроизводит субтитры на основе кадров, которые были загружены
предполагая частоту кадров 23.976 при 25 кадрах в секунду.

--ass-force-style = <[Стиль.] Параметр = Значение [, ...]>
Заменить некоторые параметры стиля или информации о скрипте.

Примеры

· --ass-force-style = FontName = Arial, по умолчанию. жирный = 1

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

ПРИМЕЧАНИЕ:
Использование этой опции может привести к некорректному рендерингу субтитров.

--ass-hinting =
Установите тип хинтинга шрифта. возможно:

нет без подсказок (по умолчанию)

легкий Автохинтер FreeType, световой режим

"обычные" Автохинтер FreeType, нормальный режим

родной родной хинтер шрифтов

Предупреждение

Включение хинтинга может привести к неверному расположению текста (в некоторых случаях
должен совпадать с видеофоном) или уменьшить плавность
анимации с некоторыми плохо написанными сценариями ASS. Не рекомендуется
используйте эту опцию, если она действительно не нужна.

--ass-line-spacing =
Установите значение межстрочного интервала для модуля рендеринга SSA / ASS.

--ass-shaper =
Установите механизм верстки текста, используемый libass.

декриминализовано использует только Fribidi, быстро, некорректно отображает некоторые языки

комплекс
использует HarfBuzz, более медленную, более широкую языковую поддержку

комплекс по умолчанию. Если libass не был скомпилирован для HarfBuzz, libass
молча возвращается к декриминализовано.

--ass-styles =
Загрузить все стили SSA / ASS, найденные в указанном файле, и использовать их для рендеринга текста
субтитры. Синтаксис файла точно такой же, как у [В4 Стили] / [V4 + Стили]
раздел SSA / ASS.

ПРИМЕЧАНИЕ:
Использование этой опции может привести к некорректному рендерингу субтитров.

--ass-style-override =
Укажите, следует ли применять переопределения пользовательского стиля.

Да Применить все --жопа-* параметры переопределения стиля. Изменение значения по умолчанию для любого
из этих параметров может привести к неправильному отображению субтитров (по умолчанию).

знаки " У аборигенов Да, но применить - субшкала только знакам

нет Рендеринг субтитров в соответствии с сценариями субтитров.

сила Попробуйте установить стиль шрифта, как определено --подтекст-* опции. Может
легко прерывать рендеринг.

--ass-force-margins
Позволяет помещать заголовки и субтитры в черную рамку, когда они доступны,
если субтитры в формате ASS.

По умолчанию: нет.

--sub-use-margins
Позволяет помещать заголовки и субтитры в черную рамку, когда они доступны,
если субтитры в текстовом формате (или ASS, если --ass-стиль-переопределить установлен
достаточно высокий).

По умолчанию: да.

Переименован из --ass-use-margins. Чтобы разместить субтитры ASS в границах (например,
старый вариант делал), тоже добавляем --ass-force-margins.

--ass-vsfilter-aspect-compat =
Растягивайте субтитры SSA / ASS при воспроизведении анаморфных видео для совместимости с
традиционное поведение VSFilter. Этот переключатель не действует, когда видео сохраняется.
с квадратными пикселями.

Рендерер, который исторически чаще всего использовался для форматов субтитров SSA / ASS,
VSFilter, имел сомнительное поведение, из-за которого субтитры тоже растягивались
если видео хранилось в анаморфном формате, который требовал масштабирования для отображения.
Такое поведение обычно нежелательно, и более новые версии VSFilter могут вести себя.
иначе. Однако многие существующие скрипты компенсируют растяжение за счет
изменение вещей в обратном направлении. Таким образом, если такие скрипты отображаются
«правильно», они не появятся так, как задумано. Этот переключатель позволяет эмулировать
старое поведение VSFilter (нежелательное, но ожидаемое многими существующими скриптами).

Включено по умолчанию.

--ass-vsfilter-blur-compat =
Шкала \ размытие теги по разрешению видео, а не по разрешению скрипта (включено
дефолт). Это ошибка в VSFilter, которая, по мнению некоторых, больше не может быть исправлена.
во имя совместимости.

Обратите внимание, что здесь используется фактическое разрешение видео для расчета масштаба смещения.
фактор, а не то, что используют цепочка видеофильтров или видеовыход.

--ass-vsfilter-color-compat =
Изменять цвета, такие как (xy-) vsfilter do (по умолчанию: базовый). Исторически VSFilter был
не осознает цветовое пространство. Это не было проблемой, если цветовое пространство, используемое для SD
видео (BT.601). Но когда все перешло на HD (BT.709), VSFilter был
по-прежнему преобразует цвета RGB в BT.601, отображает их в видеокадре и
обработал кадр для видеовыхода, который будет использовать BT.709 для преобразования в
RGB. В результате были искажены цвета субтитров. Позже были добавлены плохие хаки.
формата ASS, чтобы управлять изменением цветов.

основной Обрабатывайте только BT.601-> BT.709, если субтитры указывают на то, что
это обязательно (по умолчанию).

полный Справиться с полной YCbCr матрица заголовок со всеми цветовыми пространствами видео, поддерживаемыми
libass и mpv. Это может привести к серьезным поломкам в угловых случаях, и это не так.
строго необходимо для совместимости (надеюсь), поэтому это не
по умолчанию.

сила-601
Принудительное изменение BT.601-> BT.709, независимо от заголовков субтитров или цвета видео
пространстве.

нет Полностью отключите искажение цвета. Все цвета RGB.

Выбирая что-нибудь кроме нет заставит цвет субтитров зависеть от видео
цветовое пространство, и, например, теоретически невозможно повторно использовать сценарий субтитров
с другим видео файлом. В --ass-стиль-переопределить опция не влияет на то, как это
вариант интерпретируется.

--stretch-dvd-subs =
Растягивайте субтитры DVD при воспроизведении анаморфных видео, чтобы шрифты выглядели лучше.
плохо освоенные DVD. Этот переключатель не действует, когда видео хранится в квадрате.
пикселей - чего не может быть для входа DVD.

Многие студии при разработке склонны использовать растровые шрифты, предназначенные для квадратных пикселей.
DVD, из-за чего шрифты выглядят растянутыми при воспроизведении на DVD-плеерах. Этот вариант
исправляет их, однако ценой возможного смещения некоторых субтитров (например, знака
переводы).

Отключено по умолчанию.

--stretch-image-subs-to-screen =
Растяните DVD и другие субтитры изображений на экране, игнорируя поля видео.
Это имеет тот же эффект, что и --sub-use-margins для текстовых субтитров, кроме
сам текст будет растягиваться, а не только перемещаться. (По крайней мере, в целом это
неизбежно, поскольку растровое изображение теоретически может состоять из одного растрового изображения
покрывая весь экран, и игрок не будет знать, где именно части текста
расположены.)

Эта опция неправильно отображает субтитры. Используйте с осторожностью.

Отключено по умолчанию.

- под задницу, - без задницы
Рендеринг субтитров ASS изначально (по умолчанию включено).

If - без задницы указан, все теги и объявления стилей удаляются и
игнорируется на дисплее. Средство визуализации субтитров использует стиль шрифта, указанный в параметре
--подтекст- варианты вместо этого.

ПРИМЕЧАНИЕ:
. - без задницы может привести к неправильному или полностью нарушенному рендерингу
Субтитры ASS / SSA. Иногда может быть полезно принудительно переопределить стиль
субтитров ASS, но их следует избегать в целом.

ПРИМЕЧАНИЕ:
Попробуйте использовать --ass-style-override = сила .

--sub-auto = , --нет-суб-авто
Загрузите дополнительные файлы субтитров, соответствующие имени файла видео. Параметр указывает
как сопоставляются внешние файлы субтитров. точный по умолчанию включен.

нет Не загружать автоматически внешние файлы субтитров.

точный Загрузите имя файла мультимедиа с расширением файла субтитров (по умолчанию).

нечеткий Загрузите все подпрограммы, содержащие имя файла мультимедиа.

ВСЕ Загрузить все сабвуферы в текущем и --подпутьи каталоги.

--sub-codepage =
Если ваша система поддерживает Iconv(3), вы можете использовать эту опцию, чтобы указать субтитры
кодовая страница. По умолчанию для угадывания кодировки будет использоваться uchardet. Если mpv не
скомпилировано с помощью uchardet, будет использоваться enca. Если mpv не компилируется ни с одним
учардет ни энка, UTF-8: UTF-8-BROKEN по умолчанию, что означает, что он попытается
используйте UTF-8, иначе UTF-8-СЛОМАН псевдокодовая страница (см. ниже).

Значение по умолчанию для этой опции - автоматический, действительный эффект которого зависит от того,
ENCA скомпилирован.

Предупреждение

Если вы установите кодировку принудительно, даже субтитры, которые известны как UTF-8, будут
перекодировать, что, возможно, не то, что вы ожидаете. Префикс кодовых страниц с помощью
утф8: если вы хотите, чтобы кодовая страница использовалась только в том случае, если ввод недействителен
УТФ-8.

Примеры

· --sub-codepage = utf8: latin2 Используйте Latin 2, если вводится не в кодировке UTF-8.

· --sub-codepage = cp1250 Всегда принудительно перекодируйте в cp1250.

Псевдокодовая страница UTF-8-СЛОМАН используется внутри. Когда это кодовая страница,
субтитры интерпретируются как UTF-8 с "Latin 1" как резерв для байтов, которые
недопустимые последовательности UTF-8. iconv никогда не участвует в этом режиме.

Если плеер был скомпилирован с поддержкой ENCA, вы можете управлять им с помощью следующих
синтаксис:

--sub-codepage = enca: : кодовая страница>

Язык указывается с использованием двухбуквенного кода, чтобы помочь ENCA определить кодовую страницу.
автоматически. Если введен неверный код языка, mpv пожалуется и перечислит
допустимые языки. (Учтите, однако, что этот список будет распечатан только тогда, когда
код преобразования фактически вызывается, например, при загрузке внешнего субтитра).
В случае сбоя автоопределения используется резервная кодовая страница. Если резервный вариант не указан,
UTF-8-СЛОМАН используется.

Примеры

· --sub-codepage = enca: pl: cp1250 угадайте кодировку, предполагая, что субтитры
Польский, возврат к cp1250

· --sub-codepage = enca: pl угадайте кодировку для польского языка, вернитесь к UTF-8.

· --sub-codepage = enca попробуйте универсальное обнаружение, вернитесь к UTF-8.

Если плеер был скомпилирован с поддержкой libguess, вы можете использовать его с:

--sub-codepage = угадать: : кодовая страница>

libguess всегда нужен язык. Универсального режима детектирования нет. Использовать
--sub-codepage = угадать: справка чтобы получить список языков с той же оговоркой, что и
с ENCA выше.

Если плеер был скомпилирован с поддержкой uchardet, вы можете использовать его с:

--sub-codepage = uchardet

В этом режиме не используются язык или резервная кодовая страница.

--sub-fix-time, --no-sub-fix-тайминги
По умолчанию синхронизация субтитров регулируется, чтобы удалить незначительные промежутки или перекрытия между
субтитры (если разница меньше 210 мс, промежуток или перекрытие
удаленный).

--sub-force-only
Отображать только принудительные субтитры для потока субтитров DVD, выбранного, например,
--сленг.

--sub-fps =
Укажите частоту кадров файла субтитров (по умолчанию: видео кадров в секунду). Влияет на текст
только субтитры.

ПРИМЕЧАНИЕ:
> частота кадров видео увеличивает скорость субтитров для файлов с субтитрами на основе кадра и
замедляет их для временных.

Также см --подскорость опцию.

--sub-gauss = <0.0-3.0>
Применить размытие по Гауссу к субтитрам изображения (по умолчанию: 0). Это может помочь сделать пиксельный
ДВД / Вобсабы получше выглядят. Значение, отличное от 0, также переключает на программные субтитры.
масштабирование. Может быть медленным.

ПРИМЕЧАНИЕ:
Никогда не применялся к текстовым субтитрам.

- суб-серый
Преобразуйте субтитры к изображениям в оттенки серого. Поможет сделать желтый DVD / Vobsub вид
лучше.

ПРИМЕЧАНИЕ:
Никогда не применялся к текстовым субтитрам.

--sub-paths =
Укажите дополнительные каталоги для поиска субтитров, соответствующих видео. Несколько
каталоги могут быть разделены знаком ":" (";" в Windows). Пути могут быть относительными или
абсолютный. Относительные пути интерпретируются относительно каталога видеофайлов.

Пример

При условии, что /путь/к/видео/video.avi играет и
--sub-paths = sub: субтитры: / tmp / subs указан, mpv ищет
файлы субтитров в этих каталогах:

· / путь / к / видео /

· / путь / к / видео / суб /

· / путь / к / видео / субтитрам /

· / tmp / subs /

· В ниже подкаталог конфигурации (обычно ~ / .config / mpv / sub /)

--подвидимость, --no-sub-видимость
Может использоваться для отключения отображения субтитров, но при этом их можно выбирать и декодировать.

--sub-ясно-на-поиске
(Непонятно, редко полезно.) Может использоваться для воспроизведения битых файлов mkv с дубликатами.
Поля ReadOrder. ReadOrder - это первое поле в субтитрах ASS в стиле Matroska.
пакеты. Он должен быть уникальным, и libass использует его для быстрого устранения
дубликаты. Эта опция отключает кеширование субтитров при поиске, поэтому после поиска
libass не может исключить пакеты с субтитрами с тем же ReadOrder, что и предыдущие пакеты.

Окно
--title =
Задайте заголовок окна. Используется для видеоокна и, если возможно, также устанавливает
заголовок аудиопотока.

Свойства расширены. (Видеть Объект расширение.)

ПРЕДУПРЕЖДЕНИЕ:
Это может вызвать значительную загрузку ЦП, в зависимости от
используемые свойства. Изменение заголовка окна часто является медленной операцией, и если
название меняется каждый кадр, воспроизведение может быть испорчено.

--screen =
В конфигурациях с несколькими мониторами (т. Е. Один рабочий стол, охватывающий несколько
отображает), этот параметр сообщает mpv, на каком экране отображать видео.

Примечание (X11)

Эта опция не работает должным образом со всеми оконными менеджерами. В этих
случаях вы можете попробовать использовать --геометрия для явного позиционирования окна.
Также возможно, что оконный менеджер предоставляет собственные функции для
контролировать, какие экраны должны использовать окна приложений.

Смотрите также --fs-экран.

--полноэкранный, --fs
Полноэкранное воспроизведение.

--fs-screen =
В конфигурациях с несколькими мониторами (т. Е. Один рабочий стол, охватывающий несколько
отображает), этот параметр указывает mpv, на какой экран перейти в полноэкранный режим. Если по умолчанию is
при условии, что mpv будет использовать поведение в зависимости от того, что пользователь
предоставлен экран опцию.

Примечание (X11)

Эта опция правильно работает только с оконными менеджерами, которые
понимать EWMH _NET_WM_FULLSCREEN_MONITORS намекать.

Примечание (OS X)

ВСЕ не работает в OS X и ведет себя как текущий.

Смотрите также --экран.

--fs-black-out-screen
Только OS X. Затемнение других дисплеев при переходе в полноэкранный режим.

--keep-open =
Не прекращайте воспроизведение при воспроизведении или поиске за пределами конца файла, если есть
не следующий файл для воспроизведения (и --петля не используется). Вместо этого поставьте проигрыватель на паузу.
При попытке поиска за пределами файла игрок попытается найти
последний кадр.

Можно привести следующие аргументы:

нет Если текущий файл заканчивается, перейти к следующему файлу или завершить работу. (Дефолт.)

Да Не завершать, если текущий файл является последней записью в списке воспроизведения. Эквивалент
в - держать открытым без аргументов.

всегда Подобно Да, но также применяется к файлам перед последней записью в списке воспроизведения. Этот
означает, что воспроизведение никогда не перейдет к следующему файлу автоматически.

ПРИМЕЧАНИЕ:
Эта опция не соблюдается при использовании --фреймы. Явный переход к
следующий файл, если привязка использует сила также прекратит воспроизведение.

Кроме того, в случае ошибок или необычных обстоятельств игрок все равно может выйти.

Начиная с mpv 0.6.0, это не приостанавливается, если в списке воспроизведения есть следующий файл или
плейлист зациклен. Примерно это будет пауза, когда игрок обычно
exit, но на практике бывают угловые случаи, когда это не так (например,
MPV - держать открытым файл.mkv / DEV / нуль будет воспроизводить file.mkv в обычном режиме, а затем не сможет открыть
/ DEV / нуль, затем выйдите). (В mpv 0.8.0, всегда был введен, который восстанавливает старые
поведение.)

--force-окно =
Создайте окно вывода видео, даже если видео нет. Это может быть полезно, когда
делая вид, что mpv - это приложение с графическим интерфейсом. В настоящее время окно всегда имеет размер
640 x 480 и может быть --геометрия, --автоподбор, и аналогичные варианты.

ПРЕДУПРЕЖДЕНИЕ:
Окно создается только после инициализации (чтобы убедиться, что окно по умолчанию
размещение по-прежнему работает, если размер видео отличается от --force-окно
размер окна по умолчанию). Это может быть проблемой, если инициализация не работает.
идеально, например, при открытии URL-адресов с плохим сетевым подключением или открытии
битые видео файлы. В немедленная режим можно использовать для создания окна всегда
при запуске программы, но это может вызвать другие проблемы.

--наверху
Делает окно проигрывателя поверх других окон.

В Windows, в сочетании с полноэкранным режимом, это приводит к тому, что mpv обрабатывается как
эксклюзивное полноэкранное окно, которое обходит диспетчер окон рабочего стола.

--граница, --без границ
Воспроизвести видео с рамкой окна и украшениями. Поскольку он включен по умолчанию, используйте
--без границ отключить стандартные оконные декорации.

--на всех рабочих пространствах
(Только X11) Показать видеоокно на всех виртуальных рабочих столах.

--geometry = <[W [xH]] [+ - x + -y]>, --geometry =
Отрегулируйте исходное положение или размер окна. W и H установить размер окна в пикселях.
x и y установить положение окна, измеряемое в пикселях от верхнего левого угла окна
экран в верхний левый угол отображаемого изображения. Если знак процента
(%) указывается после аргумента, он превращает значение в процент экрана
размер в этом направлении. Позиции указаны аналогично стандартному X11
--геометрия формат опций, в котором, например, + 10-50 означает "разместить 10 пикселей слева
границы и 50 пикселей от нижней границы », а« --20 + -10 »означает« разместить 20 пикселей
за правым краем и на 10 пикселей за верхней границей ".

Если внешнее окно указано с помощью --вид вариант, этот параметр игнорируется.

Координаты указаны относительно экрана с помощью --экран для видеовыхода
драйверы, которые полностью поддерживают --экран.

ПРИМЕЧАНИЕ:
Обычно поддерживается только ВО с графическим интерфейсом. Игнорируется при кодировании.

Примечание (X11)

Эта опция не работает должным образом со всеми оконными менеджерами.

Примеры

50:40 Помещает окно в x = 50, y = 40.

50%: 50%
Помещает окно посередине экрана.

100%: 100%
Помещает окно в нижний правый угол экрана.

50% Устанавливает ширину окна равной половине ширины экрана. Высота окна установлена ​​так
что окно имеет соотношение сторон видео.

50% x50%
Устанавливает ширину и высоту окна равными половине ширины и высоты экрана.
Отображает черные границы для компенсации соотношения сторон видео (с
большинство ВО и без --no-keepaspect).

50% + 10 + 10
Устанавливает окно на половину ширины экрана и размещает его на 10 пикселей
внизу / слева от верхнего левого угла экрана.

Смотрите также --автоподбор и --автофит-больше для подгонки окна до заданного размера
без изменения соотношения сторон.

--autofit = <[Ш [xH]]>
Установите начальный размер окна на максимальный размер, указанный в WxH, без изменения
соотношение сторон окна. Размер измеряется в пикселях, или, если число
за которым следует знак процента (%), в процентах от размера экрана.

Этот параметр никогда не изменяет соотношение сторон окна. Если соотношение сторон
несоответствия, размер окна уменьшается до тех пор, пока не будет соответствовать указанному размеру.

Положение окна не учитывается и не изменяется этой опцией (
оконный менеджер по-прежнему может размещать окно по-разному в зависимости от размера). Использовать
--геометрия для изменения положения окна. Его эффекты применяются после этого.
опцию.

Посмотреть --геометрия для получения подробной информации о том, как это делается при настройке с несколькими мониторами.

Используйте --автофит-больше вместо этого, если вы просто хотите ограничить максимальный размер
window, а не всегда форсировать размер окна.

Используйте --геометрия если вы хотите установить ширину и высоту окна на определенную
размер.

ПРИМЕЧАНИЕ:
Обычно поддерживается только ВО с графическим интерфейсом. Игнорируется при кодировании.

Примеры

70% Сделайте ширину окна 70% от размера экрана, сохраняя соотношение сторон.

1000 Установите ширину окна на 1000 пикселей, сохраняя соотношение сторон.

70%: 60%
Сделайте окно как можно больше, но не шире 70%
ширина экрана или более 60% от высоты экрана.

--autofit-large = <[Ш [xВ]]>
Эта опция ведет себя точно так же, как --автоподбор, за исключением того, что изменяется только размер окна
если окно будет больше указанного размера.

Пример

90% x80%
Если размер видео превышает 90% ширины или 80% экрана
высоту, уменьшайте окно до тех пор, пока его ширина не составит 90% от
экран, либо его высота составляет 80% экрана.

--autofit-less = <[Ш [xH]]>
Эта опция ведет себя точно так же, как --автоподбор, за исключением того, что он устанавливает минимальный размер
окно (так же, как --автофит-больше устанавливает максимум).

Пример

500x500
Сделайте окно шириной не менее 500 пикселей и высотой 500 пикселей (в зависимости от
при соотношении сторон видео ширина или высота будет больше 500 дюймов
чтобы соотношение сторон оставалось неизменным).

--window-scale =
Измените размер окна видео до кратного (или дробного) размера видео. Этот вариант
применяется до --автоподбор и другие параметры применяются (поэтому они отменяют это
опция).

Например, --window-scale = 0.5 будет отображать окно с половиной размера видео.

--cursor-autohide =
Сделать так, чтобы курсор мыши автоматически скрывался через заданное количество миллисекунд. нет предусматривает
отключить автоматическое скрытие курсора. всегда означает, что курсор останется скрытым.

-Cursor-Autohide-Fs только
Если задана эта опция, курсор всегда виден в оконном режиме. В
полноэкранный режим, курсор отображается или скрывается в зависимости от --cursor-autohide.

--нет-фикс-во, --fixed-vo
--no-fixed-vo принудительное закрытие и повторное открытие окна видео для нескольких файлов
(одна (не) инициализация для каждого файла).

--force-rgba-osd-рендеринг
Измените способ отображения экранного меню и текстовых субтитров на некоторых видеовыходах. Это не
изменить внешний вид субтитров и влияет только на производительность. Для ВО
которые поддерживают рендеринг ASS (например, вдпау, OpenGL, direct3d), это может быть
немного быстрее или медленнее, в зависимости от драйверов графического процессора и оборудования. Для других ВО:
это просто замедляет рендеринг.

--force-window-position
Принудительно переместить окно вывода видео mpv в место по умолчанию, когда есть
изменение параметров видео, видеопотока или файла. Раньше это было по умолчанию
поведение. В настоящее время влияет только на ВО X11.

--heartbeat-cmd =
Команда, которая выполняется каждые 30 секунд во время воспроизведения через система() - т.е. используя
оболочка. Время между командами можно настроить с помощью
- интервал сердцебиения вариант. Команда не запускается, пока воспроизведение приостановлено.

ПРИМЕЧАНИЕ:
mpv использует эту команду без какой-либо проверки. Вы обязаны обеспечить
это не вызывает проблем с безопасностью (например, убедитесь, что используете полные пути, если "."
на вашем пути, как в Windows). Это также работает только при воспроизведении видео (т.е. не
--нет видео но работает с -vo = ноль).

Это может быть «неправильно использовано» для отключения экранных заставок, которые не поддерживают надлежащий X API.
(См. также --stop-скринсейвер). Если вам кажется, что это слишком сложно, спросите автора
программы-заставки для поддержки правильных X API. Обратите внимание, что
--stop-скринсейвер вообще не влияет на код сердцебиения.

Пример для xscreensaver

MPV --heartbeat-cmd = "xscreensaver-команда -деактивировать " файл

Пример заставки GNOME

MPV --heartbeat-cmd = "команда-заставка-gnome -п" файл

--heartbeat-interval =
Время между --heartbeat-cmd вызовы в секундах (по умолчанию: 30).

ПРИМЕЧАНИЕ:
Это никак не влияет на нормальную работу заставки.

--no-keepaspect, --сохранять
--no-keepaspect всегда будет растягивать видео до размера окна и отключать
подсказки оконного менеджера, которые задают соотношение сторон окна. (Игнорируется в полноэкранном режиме
Режим.)

--no-keepaspect-окно, --keepaspect-окно
--keepaspect-окно (по умолчанию) размер окна будет привязан к формату видео.
--no-keepaspect-окно отключает это поведение и вместо этого добавляет черные полосы, если
Несоответствие соотношения сторон окна и видео. Действительно ли это работает, зависит от
Бэкэнд VO. (Игнорируется в полноэкранном режиме.)

--monitoraspect =
Установите соотношение сторон монитора или экрана телевизора. Значение 0 отключает предыдущий
настройки (например, в файле конфигурации). Отменяет --monitorpixelaspect установка, если
включен.

Смотрите также --monitorpixelaspect и --видео-аспект.

Примеры

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

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

--monitorpixelaspect =
Установите соотношение сторон одного пикселя вашего монитора или экрана телевизора (по умолчанию: 1). Ценность
1 означает квадратные пиксели (верно для (почти?) всех ЖК-дисплеев). Смотрите также --монитораспект
и --видео-аспект.

--stop-скринсейвер, --no-stop-скринсейвер
Выключает заставку (или средство отключения экрана и аналогичные механизмы) при запуске и
снова включает его при выходе (по умолчанию: да). Заставка всегда включается повторно, когда
игрок приостановлен.

Это поддерживается не на всех видеовыходах или платформах. Иногда бывает
реализовано, но не работает (часто бывает в GNOME). Вы могли бы
работать над этим, используя --heartbeat-cmd .

--wid =
Это говорит mpv присоединиться к существующему окну. Если выбран ВО, поддерживающий
эта опция будет использовать это окно для вывода видео. mpv масштабирует видео до
размер этого окна и добавит черные полосы, чтобы компенсировать соотношение сторон
видео разные.

На X11 идентификатор интерпретируется как Окно на X11. В отличие от MPlayer / mplayer2, mpv
всегда создает собственное окно и устанавливает окно wid в качестве родительского. Окно будет
всегда изменять размер, чтобы полностью закрыть родительское окно. Значение 0 интерпретируется
специально, и mpv будет рисовать прямо в корневом окне.

В win32 идентификатор интерпретируется как ХВНД. Передайте его как значение, приведенное к intptr_t. MPV
создаст собственное окно и установит окно wid как родительское, как в X11.

В OSX / Cocoa идентификатор интерпретируется как NSView *. Передайте его как значение, приведенное к intptr_t.
mpv создаст свое собственное представление. Поскольку OSX не поддерживает встраивание окон
внешние процессы, это работает только с libmpv и приведет к сбою при использовании из
командная строка.

- без перетаскивания окна
Не перемещайте окно, щелкая по нему и перемещая указатель мыши.

--x11-имя
Задайте имя класса окна для методов вывода видео на основе X11.

--x11-netwm =
(Только X11) Управляйте использованием функций протокола NetWM.

Это может помочь, а может и не помочь с неработающими оконными менеджерами. Это дает некоторые
функциональность, которая была реализована теперь удаленным --fstype вариант. Фактически,
Разработчикам неизвестно, в какой степени эта опция была нужна, поэтому
обратная связь приветствуется.

В частности, Да заставит использовать полноэкранную поддержку NetWM, даже если
рекламируется WM. Это может быть полезно для WM, которые специально взломаны, например
XMonad. (Предполагается, что XMonad не рекламирует полноэкранную поддержку, потому что Flash использует
Это. Очевидно, приложения, которые все равно хотят использовать полноэкранный режим, должны
либо игнорируйте подсказки поддержки NetWM, либо предлагайте обходной путь. Позор XMonad за
преднамеренное нарушение протоколов X (как будто X уже недостаточно плох).

По умолчанию поддержка NetWM определяется автоматически (автоматический).

Эта опция может быть удалена в будущем.

--x11-байпас-композитор =
Если установлено на Да (по умолчанию), затем попросите композитора отменить перенаправление окна mpv. Этот
использует _NET_WM_BYPASS_COMPOSITOR намекать.

Диск Аппараты
--cdrom-device =
Укажите устройство CD-ROM (по умолчанию: / DEV / CDROM).

--dvd-device =
Укажите устройство DVD или имя файла .iso (по умолчанию: / dev / dvd). Вы также можете указать
каталог, содержащий файлы, ранее скопированные непосредственно с DVD (например,
вобкопия).

Пример

MPV dvd: // --dvd-device = / путь / к / DVD /

--bluray-device =
(Только для Blu-ray) Укажите расположение диска Blu-ray. Должен быть каталог с Blu-ray
структуры.

Пример

MPV bd: // --bluray-device = / путь / к / bd /

- синий-угол =
Некоторые диски Blu-ray содержат сцены, которые можно просматривать под разными углами. Этот
опция сообщает MPV, какой угол использовать (по умолчанию: 1).

--cdda -...
Эти параметры можно использовать для настройки функции чтения компакт-дисков в формате mpv.

--cdda-speed =
Установите скорость отжима компакт-диска.

--cdda-paranoia = <0-2>
Установите уровень паранойи. Значения, отличные от 0, похоже, нарушают воспроизведение чего-либо, кроме
первый трек.

0 отключить проверку (по умолчанию)

1 только проверка перекрытия

2 полная корректировка и проверка данных

--cdda-размер-сектора =
Установите размер атомарного чтения.

--cdda-overlap =
Принудительный поиск минимального перекрытия во время проверки на секторов.

--cdda-toc-bias
Предположим, что начальное смещение дорожки 1, как указано в оглавлении, будет
адресуется как LBA 0. Некоторым дискам это необходимо для правильного определения границ дорожек.

--cdda-toc-offset =
Добавить секторов к значениям, сообщаемым при адресации дорожек. Может быть
отрицательный.

--cdda-skip =
(Никогда) не принимайте несовершенную реконструкцию данных.

--cdda-cdtext =
Распечатать CD-текст. По умолчанию это отключено, потому что это снижает производительность с помощью
Приводы CD-ROM по неизвестным причинам.

--dvd-speed =
Попробуйте ограничить скорость DVD (по умолчанию: 0, без изменений). Базовая скорость DVD составляет 1385 кБ / с, поэтому
Накопитель 8x может читать со скоростью до 11080 кБ / с. Более низкие скорости делают поездку более приятной
тихий. Для просмотра DVD 2700 кБ / с должно быть достаточно тихим и быстрым. mpv сбрасывает
скорость до значения привода по умолчанию при закрытии. Значения не менее 100 средней скорости в
кБ / с. Значения меньше 100 означают кратные 1385 кБ / с, т. Е. --dvd-speed = 8 выбирает
11080 кБ / с.

ПРИМЕЧАНИЕ:
Чтобы изменить скорость, вам потребуется доступ для записи на DVD-устройство.

--dvd-angle =
Некоторые DVD содержат сцены, которые можно просматривать под разными углами. Этот вариант
сообщает MPV, какой угол использовать (по умолчанию: 1).

балансир
--brightness = <-100-100>
Отрегулируйте яркость видеосигнала (по умолчанию: 0). Не поддерживается всем видео
драйверы вывода.

--contrast = <-100-100>
Отрегулируйте контрастность видеосигнала (по умолчанию: 0). Не поддерживается всем видео
драйверы вывода.

--насыщенность = <-100-100>
Отрегулируйте насыщенность видеосигнала (по умолчанию: 0). Вы можете получить оттенки серого
вывод с этой опцией. Поддерживается не всеми драйверами вывода видео.

--gamma = <-100-100>
Отрегулируйте гамму видеосигнала (по умолчанию: 0). Не поддерживается всем видео
драйверы вывода.

--hue = <-100-100>
Отрегулируйте оттенок видеосигнала (по умолчанию: 0). Вы можете получить цветной негатив
изображение с этой опцией. Поддерживается не всеми драйверами вывода видео.

Демультиплексор
--demuxer = <[+] имя>
Принудительный тип демультиплексора. Используйте "+" перед именем, чтобы заставить его; это пропустит некоторые
чеки. Дайте демультиплексору имя, напечатанное --demuxer = помощь.

--demuxer-lavf-analysisuration =
Максимальная длина в секундах для анализа свойств потока.

--demuxer-lavf-probescore = <1-100>
Минимальный требуемый тестовый балл libavformat. Более низкие значения потребуют меньшего количества данных.
загружен (ускоряет запуск потоков), но делает определение формата файла менее надежным.
Может использоваться для принудительного автоматического определения демультиплексоров libavformat, даже если libavformat
считает обнаружение недостаточно надежным. (По умолчанию: 26.)

--demuxer-lavf-allow-mimetype =
Разрешить вывод формата из типа HTTP MIME (по умолчанию: да). Установите это на нет в
случае загадочно не удается воспроизвести вещи через HTTP, хотя те же файлы работают
с локального диска.

Это значение по умолчанию для уменьшения задержки при открытии потоков HTTP.

--demuxer-lavf-format =
Заставить конкретный демультиплексор libavformat.

--demuxer-lavf-hacks =
По умолчанию некоторые форматы будут обрабатываться иначе, чем другие форматы.
явно проверяя их. Большинство из них компенсируют странные или несовершенные
поведение из демультиплексоров libavformat. Проходящий нет отключает их. Для отладки и
только тестирование.

--demuxer-lavf-genpts-mode =
Режим для получения значений PTS пропущенного пакета из DTS пакета. лавф позволяет
libavformat's Genpts опцию. нет отключает это. Раньше это было включено по умолчанию,
но потом посчитали, что это больше не нужно. Включение этого может помочь с
проблемы с отметкой времени или усугубляют их.

--demuxer-lavf-o = знак равно [, знак равно [, ...]]
Передайте AVOptions в демультиплексор libavformat.

Обратите внимание, патч, чтобы сделать o= ненужные и передать все неизвестные параметры через
Система AVOption приветствуется. Полный список AVOptions можно найти в FFmpeg
руководство. Обратите внимание, что некоторые параметры могут конфликтовать с параметрами mpv.

Пример

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

--demuxer-lavf-probesize =
Максимальный объем данных для проверки на этапе обнаружения. В случае MPEG-TS
это значение определяет максимальное количество пакетов TS для сканирования.

--demuxer-lavf-buffersize =
Размер буфера чтения потока, выделенного для libavformat, в байтах (по умолчанию: 32768).
Уменьшение размера может снизить задержку. Обратите внимание, что libavformat может перераспределить
буфер внутри, или использовать его не полностью.

--demuxer-lavf-cryptokey =
Ключ шифрования, который должен использовать демультиплексор. Это необработанные двоичные данные ключа
преобразован в шестнадцатеричную строку.

--demuxer-mkv-subtitle-preroll, --mkv-subtitle-preroll
Старайтесь больше показывать встроенные программные субтитры, когда куда-то ищете. Обычно это может
случается так, что субтитры в цели поиска не отображаются из-за того, что какой-то контейнер
форматы файлов разработаны. Субтитры появляются только при поиске до или точно
в позицию, в которой впервые появляется субтитр. Что еще хуже, субтитры часто
приурочен к появлению очень небольшого количества перед связанным видеокадром, так что
поиск видеокадра обычно не приводит к демультиплексированию субтитров в этой позиции.

Включение этой опции заставляет демультиплексор начать чтение данных немного до поиска.
target, чтобы субтитры отображались правильно. Обратите внимание, что это замедляет поиск,
и не всегда работает. Работает только в том случае, если субтитры достаточно близки
к цели поиска.

Работает только с внутренним демультиплексором Matroska. Всегда включен для абсолютного и
hr-seekks, и эта опция изменяет поведение только с относительными или неточными поисками.

Вы можете использовать --demuxer-mkv-subtitle-preroll-secs возможность указать, сколько данных
демультиплексор должен предварительно прочитать самое большее, чтобы найти пакеты субтитров, которые могут
перекрывать. Установка этого параметра на 0 фактически отключит этот механизм предварительной прокрутки. Параметр
очень большое значение может сделать поиск очень медленным, а очень большое значение
полностью перечитывать весь файл от начала до поиска цели при каждом поиске
может стать медленнее к концу файла. Детали запутаны, а ценность
фактически округляется до кластера с предыдущим ключевым кадром видео.

Некоторые файлы, особенно файлы, мультиплексированные с новыми версиями mkvmerge, содержат информацию
встроенный, который может использоваться для определения того, какие пакеты субтитров перекрываются с поиском
цель. В этих случаях mpv снизит объем считываемых данных до минимума.
(Хотя он все равно будет читать ВСЕ данные между кластером, который содержит первый
требуемый пакет субтитров и цель поиска.)

Смотрите также --hr-seek-demuxer-offset вариант. Этот вариант позволяет добиться аналогичного эффекта,
но только если активен hr-seek. Работает с любым демультиплексором, но требует много
медленнее, так как он должен декодировать аудио- и видеоданные, а не просто пропускать их.

--mkv-subtitle-preroll является устаревшим псевдонимом.

--demuxer-mkv-subtitle-preroll-secs =
Посмотреть --demuxer-mkv-subtitle-preroll.

--demuxer-mkv-probe-video-duration =
При открытии файла найдите его конец и проверьте, какая отметка времени была последней.
видео пакет имеет, и укажите это как длительность файла. Это строго для
совместимость только с Haali. В этом режиме возможно открытие
медленнее (особенно при воспроизведении через http) или такое поведение с поврежденными файлами
намного хуже. Так что не используйте эту опцию.

Команда Да режим просто использует индекс и читает небольшое количество блоков с конца
файла. В полный режим фактически просматривает весь файл и может сделать
надежная оценка даже без индекса (например, частичные файлы).

--demuxer-rawaudio-channels =
Количество каналов (или расположение каналов), если --demuxer = rawaudio используется (по умолчанию:
стерео).

--demuxer-rawaudio-format =
Пример формата для --demuxer = rawaudio (по умолчанию: s16le). Использовать
--demuxer-rawaudio-format = справка чтобы получить список всех форматов.

--demuxer-rawaudio-rate =
Частота дискретизации для --demuxer = rawaudio (по умолчанию: 44 кГц).

--demuxer-rawvideo-fps =
Скорость в кадрах в секунду для --demuxer = rawvideo (по умолчанию: 25.0).

--demuxer-rawvideo-w = , --demuxer-rawvideo-h =
Размер изображения в пикселях для --demuxer = rawvideo.

Пример

Воспроизвести необработанный образец YUV:

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

--demuxer-rawvideo-format =
Цветовое пространство (fourcc) в шестнадцатеричном или строковом формате для --demuxer = rawvideo (дефолт: YV12).

--demuxer-rawvideo-mp-format =
Цветовое пространство по внутреннему видеоформату для --demuxer = rawvideo. Используйте
--demuxer-rawvideo-mp-format = справка для списка возможных форматов.

--demuxer-rawvideo-codec =
Установите видеокодек вместо выбора кодека rawvideo при использовании
--demuxer = rawvideo. Здесь используются те же значения, что и имена кодеков в --vd (но это так
не принимать имена декодеров).

--demuxer-rawvideo-size =
Размер кадра в байтах при использовании --demuxer = rawvideo.

--demuxer-max-packets = , --demuxer-max-bytes =
Это контролирует, сколько демультиплексору разрешено буферизовать вперед. Демультиплексор будет
обычно старайтесь читать вперед столько, сколько необходимо, или столько, сколько требуется с
--demuxer-readahead-secs, --demuxer-max -... параметры могут использоваться для ограничения
максимальная читаемость. Это ограничивает чрезмерное опережающее чтение в случае поврежденных файлов или
десинхронизированное воспроизведение. Демультиплексор перестанет читать дополнительные пакеты, как только один
лимитов достигнут. (Пределы все еще могут быть немного превышены из-за
технические причины.)

Установите эти пределы выше, если вы получаете предупреждение о переполнении очереди пакетов и думаете, что
нормальное воспроизведение было бы возможно с большей очередью пакетов.

Посмотреть --список-опций для значений по умолчанию и диапазона значений.

--demuxer-thread =
Запустите демультиплексор в отдельном потоке и позвольте ему предварительно загрузить определенное количество
пакеты (по умолчанию: да). Включение этого параметра может привести к более плавному воспроизведению, но на
с другой стороны, можно добавить задержки при поиске или переключении треков.

--demuxer-readahead-secs =
If --demuxer-поток включен, это контролирует, сколько демультиплексор должен буферизовать
вперед в секундах (по умолчанию: 1). Пока нет пакета с разницей в отметках времени
выше, чем количество опережающего чтения относительно последнего пакета, возвращенного в
декодер, демультиплексор продолжает чтение.

Обратите внимание, что --кэш-сек опция переопределит это значение, если кеш включен,
и значение больше.

(Это значение имеет тенденцию быть нечетким, потому что многие форматы файлов не хранят линейные
отметки времени.)

--force-seekable =
Если игрок считает, что носитель недоступен для поиска (например, играет с трубы или
это поток http с сервером, который не поддерживает запросы диапазона), поиск будет
быть отключенным. Эта опция может принудительно включить его. Для поиска в кеше,
есть хорошие шансы на успех.

вход
--native-keyrepeat
Используйте системные настройки для задержки и скорости повторения клавиш вместо --input-ar-delay и
--input-ar-скорость. (Применимо ли это, зависит от серверной части VO и того, как она обрабатывает
ввод с клавиатуры. Не относится к входу терминала.)

--input-ar-delay
Задержка в миллисекундах перед тем, как мы начнем автоповтор ключа (0 для отключения).

--input-ar-скорость
Количество нажатий клавиш, генерируемых в секунду при автоповторе.

--input-conf =
Укажите файл конфигурации ввода, отличный от расположения по умолчанию в MPV
каталог конфигурации (обычно ~ / .config / mpv / input.conf).

--no-input-default-bindings
Отключить привязку клавиш по умолчанию (встроенную) mpv.

--input-cmdlist
Печатает все команды, которые могут быть связаны с клавишами.

--input-doubleclick-time =
Время в миллисекундах для распознавания двух последовательных нажатий кнопок как двойного щелчка
(по умолчанию: 300).

--Input-KeyList
Печатает все ключи, которые могут быть связаны с командами.

--input-key-fifo-size = <2-65000>
Укажите размер FIFO, который буферизует ключевые события (по умолчанию: 7). Если это тоже
small некоторые события могут быть потеряны. Главный недостаток установки очень большой
значение состоит в том, что если вы удерживаете нажатой клавишу, запускающую какую-то особенно медленную команду, то
игрок может не отвечать, пока он обрабатывает все команды в очереди.

--вход-тест
Входной тестовый режим. Вместо того, чтобы выполнять команды при нажатии клавиш, mpv покажет
клавиши и связанные команды на экранном меню. Должен использоваться с фиктивным видео, а
обычные способы выйти из плеера не будут работать (привязки клавиш, которые обычно выходят, будут
отображаться только в экранном меню, как и любая другая привязка). Видеть ВХОД.КОНФ.

--input-file =
Прочитать команды из данного файла. В основном полезно с FIFO. Начиная с mpv 0.7.0 также
понимает команды JSON (см. JSON IPC), но вы не можете получать ответы или события. Использовать
--input-unix-сокет для чего-то двунаправленного. В MS Windows команды JSON
не доступны.

Это также может указать прямой дескриптор файла с fd: // N (Только для UNIX). В этом
В этом случае ответы JSON будут записаны, если FD доступен для записи.

ПРИМЕЧАНИЕ:
Когда данный файл является FIFO, mpv открывает оба конца, поэтому вы можете сделать несколько эхо
"искать 10 " > mp_pipe и труба останется действующей.

- вход-терминал, --нет-терминал ввода
--нет-терминал ввода не позволяет игроку читать ключевые события из стандартных
Вход. Полезно при чтении данных со стандартного ввода. Это автоматически включается
когда - находится в командной строке. Бывают ситуации, когда нужно его установить
вручную, например, если вы открываете / dev / stdin (или аналог в вашей системе), используйте stdin
в плейлисте или собираетесь читать из стандартного ввода позже через файл загрузки или список загрузки
подчиненные команды.

--input-unix-socket =
Включите поддержку IPC и создайте прослушивающий сокет по заданному пути.

Посмотреть JSON IPC для получения информации.

Недоступно в MS Windows.

--input-appleremote =
(Только OS X) Включение / отключение поддержки Apple Remote. Включено по умолчанию (кроме
либмпв).

- ввод-курсор, --нет-ввод-курсор
Разрешить mpv получать события указателя, сообщаемые драйвером вывода видео. Необходимый
для использования OSC или для выбора кнопок в меню DVD. Поддержка зависит от ВО
в использовании.

--input-media-keys =
(Только OS X) Включение / отключение поддержки мультимедийных ключей. Включено по умолчанию (кроме
либмпв).

--input-right-alt-gr, --no-input-right-alt-gr
(Только для какао и Windows) Используйте правую клавишу Alt в качестве Alt Gr для создания специальных
символы. Если отключено, считайте правый Alt как клавишу-модификатор Alt. Включено
по умолчанию.

--input-vo-keyboard =
Отключить весь ввод с клавиатуры для ВО, которые не могут участвовать в правильной клавиатуре
входная диспетчеризация. Не может повлиять на все ВО. Обычно используется только для встраивания.

На X11 подокно с включенным вводом захватывает весь ввод с клавиатуры, пока он
1. дочерний элемент сфокусированного окна и 2. мышь находится внутри подокна. В
может украсть весь ввод с клавиатуры из приложения, встраивающего окно mpv,
и, с другой стороны, окно mpv не получит ввода, если мышь находится за пределами
окна mpv, даже если mpv имеет фокус. Современные инструменты позволяют решить эту проблему.
странное поведение X11, но наивное встраивание посторонних окон нарушает его.

Единственный способ справиться с этим разумно - использовать протокол XEmbed, который был
предназначен для решения этих проблем. GTK предоставляет GtkSocket, который поддерживает XEmbed. Qt
похоже, ничего не работает в более новых версиях.

Если устройство для внедрения поддерживает XEmbed, ввод должен работать с настройками по умолчанию и с
эта опция отключена. Обратите внимание, что привязки по умолчанию для ввода по умолчанию отключено в
libmpv также - он должен быть включен, если вам нужны привязки клавиш по умолчанию для mpv.

(Этот вариант был переименован из --input-x11-клавиатура.)

--input-app-events =
(Только OS X) Включение / отключение событий клавиатуры для всего приложения, чтобы клавиатура
ярлыки можно обрабатывать без окна. Включено по умолчанию (кроме
либмпв).

OSD
--оск, - no-osc
Следует ли загружать экранный контроллер (по умолчанию: да).

--нет экранного меню, --osd-бар
Отключить отображение панели OSD. Это заставит некоторые вещи (например, поиск) использовать OSD
текстовые сообщения вместо панели.

Вы можете настроить это для каждой команды в input.conf, используя OSD- префиксы,
посмотреть вход команду префиксы. Если вы хотите полностью отключить экранное меню, используйте
--osd-level = 0.

--osd-duration =
Установите длительность сообщений OSD в мс (по умолчанию: 1000).

--osd-font = , --sub-text-font =
Укажите шрифт для использования в экранном меню и для субтитров, которые сами по себе не содержат
конкретный шрифт. По умолчанию без засечек.

Примеры

· --osd-font = 'Битовый поток Vera Sans '

· --osd-font = 'MS Комический Sans '

ПРИМЕЧАНИЕ:
Команда --подтекстовый шрифт вариант (и большинство других --подтекст- опции) игнорируются, когда
ASS-субтитры отображаются, если только - без задницы опция указана.

Используется для поддержки шаблонов fontconfig. Начиная с libass 0.13.0, это
перестал работать.

--osd-font-size = , --sub-text-font-size =
Укажите размер шрифта OSD / дополнительного шрифта. Единица измерения - это размер окна в масштабированных пикселях.
высота 720. Фактический размер пикселя масштабируется с высотой окна: если
высота окна больше или меньше 720, фактический размер текста увеличивается
или также уменьшается.

По умолчанию: 55.

--osd-msg1 =
Показать эту строку как сообщение в экранном меню с уровнем экранного меню 1 (отображается по умолчанию). В
сообщение будет отображаться по умолчанию, и пока его не охватывает другое сообщение, а
Уровень OSD не меняется (см. --osd-уровень). Расширяет свойства; видеть Объект
расширение.

--osd-msg2 =
Подобно как --osd-msg1, но для уровня OSD 2. Если это пустая строка (по умолчанию),
затем отображается время воспроизведения.

--osd-msg3 =
Подобно как --osd-msg1, но для уровня OSD 3. Если это пустая строка (по умолчанию),
затем отображается время воспроизведения, продолжительность и некоторая дополнительная информация.

Это также используется для show_progress команда (по умолчанию сопоставлена ​​с P) или в
некоторые нестандартные случаи при поиске.

--OSD-статус-сообщение является устаревшим эквивалентом (но с небольшими отличиями).

--osd-status-msg =
Показывать настраиваемую строку во время воспроизведения вместо стандартного текста состояния. Этот
отменяет текст статуса, используемый для --osd-level = 3, при использовании show_progress
команда (по умолчанию сопоставлена ​​с P) или в некоторых нестандартных случаях при поиске.
Расширяет свойства. Видеть Объект расширение.

Эта опция была заменена на --osd-msg3. Единственная разница в том, что это
опция неявно включает $ {osd-sym-cc}. Эта опция игнорируется, если --osd-msg3 is
не пусто.

--osd-play-msg =
Показывать сообщение в экранном меню при запуске воспроизведения. Строка раскрывается для свойств,
или --osd-plays-msg = 'файл: $ {имя_файла} ' покажет сообщение файл: последующей
пробел и имя текущего воспроизводимого файла.

Посмотреть Объект расширение.

--osd-bar-align-x = <-1-1>
Положение панели экранного меню. -1 - крайний левый, 0 - центральный, 1 - крайний правый. Дробное
допустимы значения (например, 0.5).

--osd-bar-align-y = <-1-1>
Положение панели экранного меню. -1 - вверху, 0 - по центру, 1 - внизу. Дробные значения
(например, 0.5) разрешены.

--osd-bar-w = <1-100>
Ширина панели OSD в процентах от ширины экрана (по умолчанию: 75). Ценность
50 означает, что ширина полосы составляет половину экрана.

--osd-bar-h = <0.1-50>
Высота панели экранного меню в процентах от высоты экрана (по умолчанию: 3.125).

--osd-back-color = , --sub-text-back-color =
Посмотреть --osd-цвет. Цвет, используемый для фона экранного меню / дополнительного текста.

--osd-blur = <0..20.0>, --sub-text-blur = <0..20.0>
Фактор размытия по Гауссу. 0 означает, что размытие не применяется (по умолчанию).

--osd-жирный = , --sub-text-bold =
Отформатируйте текст полужирным шрифтом.

--osd-границы-цвет = , --sub-text-border-цвет =
Посмотреть --osd-цвет. Цвет, используемый для границы экранного меню / дополнительного шрифта.

ПРИМЕЧАНИЕ:
игнорируется, когда --osd-задний цвет/--sub-text-back-color указано (или более
точно: когда этот параметр не установлен на полную прозрачность).

--osd-границы-размер = , --sub-text-border-size =
Размер границы экранного меню / дополнительного шрифта в масштабированных пикселях (см. --osd-размер-шрифта для более подробной информации).
Значение 0 отключает границы.

По умолчанию: 3.

--osd-color = , --sub-text-color =
Укажите цвет, используемый для OSD / текстовых субтитров без стиля.

Цвет указан в форме г / г / б, где указана каждая цветовая составляющая
как число в диапазоне от 0.0 до 1.0. Также можно указать прозрачность
с помощью г / г / б / а, где значение альфа 0 означает полную прозрачность, а 1.0 означает
непрозрачный. Если альфа-компонент не указан, цвет будет 100% непрозрачным.

При передаче одного числа параметру экранное меню становится серым, а форма серый / а
позволяет дополнительно указать альфа-канал.

Примеры

· --osd-color = 1.0 / 0.0 / 0.0 установите для OSD непрозрачный красный цвет

· --osd-color = 1.0 / 0.0 / 0.0 / 0.75 установите для OSD непрозрачный красный цвет с альфа-каналом 75%

· --osd-color = 0.5 / 0.75 установите OSD на 50% серого с 75% альфа

В качестве альтернативы цвет может быть указан как шестнадцатеричный триплет RGB в форме #RRGGBB,
где каждая 2-значная группа выражает значение цвета в диапазоне 0 (00) до 255 (FF).
Например, #FF0000 красный. Это похоже на веб-цвета. Альфа задается с помощью
#ААРРГГББ.

Примеры

· --osd-color = '# FF0000' установите для OSD непрозрачный красный цвет

· --osd-color = '# C0808080' установите OSD на 50% серого с 75% альфа

--osd-фракции
Отображение времени экранного меню в долях секунды (с точностью до миллисекунды). Полезно видеть
точная метка времени видеокадра.

--osd-level = <0-3>
Определяет, в каком режиме должно запускаться экранное меню.

0 Экранное меню полностью отключено (только субтитры)

1 включен (отображается только при взаимодействии с пользователем)

2 включено + текущее время отображается по умолчанию

3 включен + --OSD-статус-сообщение (текущее время и статус по умолчанию)

--osd-margin-x = , --sub-text-margin-x =
Левая и правая поля экрана для OSD / подпрограмм в масштабированных пикселях (см. --osd-размер-шрифта
для более подробной информации).

Эта опция определяет расстояние OSD слева, а также, на каком
расстояние от правой границы длинный текст OSD будет разорван.

По умолчанию: 25.

--osd-margin-y = , --sub-text-margin-y =
Верхнее и нижнее поля экрана для OSD / подпрограмм в масштабированных пикселях (см. --osd-размер-шрифта
для более подробной информации).

Этот параметр определяет вертикальные поля экранного меню. Это также используется для
текстовые субтитры без стиля. Если вы просто хотите поднять вертикальное положение субтитров,
используют - подпункт.

По умолчанию: 22.

--osd-align-x = , --sub-text-align-x = ...
Укажите, по какому углу экрана должны быть выровнены экранное меню или текстовые субтитры.
(дефолт: центр для подводных лодок, оставил для экранного меню).

Никогда не применялся к субтитрам ASS, кроме - без задницы режим. Точно так же
не применяется к субтитрам к изображениям.

--osd-align-y = --sub-text-align-y = ...
Вертикальное положение (по умолчанию: нижний для подводных лодок, топ для экранного меню). Подробности см.
--osd-выравнивание-х.

--osd-scale =
Множитель размера шрифта OSD, умноженный на --osd-размер-шрифта значения.

--osd-масштаб по окну =
Масштабировать ли OSD в соответствии с размером окна (по умолчанию: да). Если это отключено,
--osd-размер-шрифта и другие параметры экранного меню, в которых используются масштабированные пиксели, всегда актуальны.
пикселей. Эффект заключается в том, что изменение размера окна не влияет на размер шрифта OSD.

--osd-тень-цвет = , --sub-text-shadow-цвет =
Посмотреть --osd-цвет. Цвет, используемый для тени OSD / дополнительного текста.

--osd-тень-смещение = , --sub-text-shadow-offset =
Смещение тени OSD / подтекста в масштабированных пикселях (см. --osd-размер-шрифта для
Детали). Значение 0 отключает тени.

По умолчанию: 0.

--osd-spacing = , --sub-text-spacing =
Горизонтальный интервал OSD / субшрифта в масштабированных пикселях (см. --osd-размер-шрифта для более подробной информации).
Это значение добавляется к обычному межбуквенному интервалу. Допускаются отрицательные значения.

По умолчанию: 0.

Скриншот
--screenshot-format =
Установите тип файла изображения, используемого для сохранения снимков экрана.

Доступные варианты:

PNG PNG

частей на миллион ЦБК

МПГ PGM

пгмьюв PGM с форматом пикселей YV12

TGA TARGA

JPG JPEG (по умолчанию)

JPEG JPEG (то же, что и jpg, но с окончанием файла .jpeg)

--screenshot-tag-colorspace =
Пометьте снимки экрана соответствующим цветовым пространством.

Обратите внимание, что не все форматы поддерживаются.

По умолчанию: нет.

--screenshot-high-bit-depth =
По возможности пишите скриншоты с битовой глубиной, аналогичной исходному видео.
(по умолчанию: да). Это особенно интересно для PNG, так как иногда
запускает запись 16-битных PNG с огромными размерами файлов.

--screenshot-template =
Укажите шаблон имени файла, используемый для сохранения снимков экрана. В шаблоне указывается
имя файла без расширения файла и может содержать спецификаторы формата, которые будут
подставляется при снятии скриншота. По умолчанию шаблон mpv-выстрел% n, который
приводит к таким именам файлов, как mpv-shot0012.png например.

Шаблон может начинаться с относительного или абсолютного пути, чтобы указать
каталог, в котором должны быть сохранены скриншоты.

Если имя файла последнего снимка экрана указывает на уже существующий файл, файл будет
не перезаписываться. Скриншот либо не сохранится, либо если шаблон
содержит %n, сохранены с использованием нового сгенерированного имени файла.

Допустимые спецификаторы формата:

% [#] [0X] п
Порядковый номер, дополненный нулями до длины X (по умолчанию: 04). Например
передача формата % 04n будет давать 0012 на 12-м скриншоте. Номер
увеличивается каждый раз, когда делается снимок экрана или если файл уже
существуют. Длина X должно быть в диапазоне 0–9. С необязательным знаком # mpv.
будет использовать наименьший доступный номер. Например, если вы возьмете три
скриншоты - 0001, 0002, 0003 - и удалите первые два, следующие два
скриншоты будут не 0004 и 0005, а снова 0001 и 0002.

%f Имя файла воспроизводимого в данный момент видео.

%F Такой же как %f, но уберите расширение файла, включая точку.

%x Путь к каталогу воспроизводимого в данный момент видео. Если видео нет на
файловая система (но, например, http://), это расширяется до пустой строки.

% X {резерв}
Такой же как %x, но если видеофайл отсутствует в файловой системе, вернуть
резервная строка внутри {...}.

%p Текущее время воспроизведения в том же формате, что и в экранном меню. Результат
строка вида «ЧЧ: ММ: СС». Например, если видео в то время
положение 5 минут 34 секунды, %p будет заменено на "00:05:34".

%P Похожий на что %p, но увеличено время воспроизведения в миллисекундах. это
форматируется как «ЧЧ: ММ: СС.ммм», где «ммм» - часть миллисекунды
время воспроизведения.

ПРИМЕЧАНИЕ:
Это простой способ получить уникальные временные метки для каждого кадра. (Рамка
числа будут более интуитивно понятными, но их нелегко реализовать, потому что
форматы контейнеров обычно используют метки времени для идентификации фреймов.)

% wX Укажите текущее время воспроизведения, используя строку формата X. %p , как
% вес:% вес:% вес и %P , как % вес:% вес:% вес.% вес..

Действительный формат спецификаторы:

% wH час (с дополнением от 0 до двух цифр)

% wh час (без подкладки)

% wM минут (00-59)

% wm всего минут (включая часы, в отличие от % wM)

% wS секунды (00-59)

% ws общее количество секунд (включая часы и минуты)

% wf " У аборигенов % ws, но как float

% wT миллисекунды (000-999)

% tX Укажите текущую местную дату / время в формате X. Этот формат
спецификатор использует UNIX strftime () функции внутри, и вставляет
результат передачи "% X" в стрфтайм, Например, % tm вставит номер
текущего месяца в виде числа. Вы должны использовать несколько % tX спецификаторы для
построить полную строку даты / времени.

% {prop [: резерв текст]}
Вставьте значение свойства slave 'prop'. Например %{имя файла} та же
as %f. Если свойство не существует или недоступно, отображается текст ошибки.
вставлен, если не указан запасной вариант.

%% Заменено на % сам персонаж.

--screenshot-directory =
Храните скриншоты в этом каталоге. К этому пути добавляется имя файла
Сгенерированно с помощью - скриншот-шаблон. Если имя файла шаблона уже является абсолютным,
каталог игнорируется.

Если каталог не существует, он создается на первом скриншоте. Если это
не каталог, при попытке написать скриншот выдает ошибку.

Этот параметр не установлен по умолчанию, поэтому скриншоты будут записаны в каталог.
с которого был запущен mpv. В режиме псевдо-графического интерфейса (см. ПСЕВДО Графический интерфейс пользователя РЕЖИМ), это установлено
на рабочий стол.

--screenshot-jpeg-quality = <0-100>
Установите уровень качества JPEG. Чем выше, тем лучше качество. По умолчанию 90.

--screenshot-jpeg-source-chroma =
Записывайте файлы JPEG с той же подвыборкой цветности, что и видео (по умолчанию: да). Если
отключено, используется libjpeg по умолчанию.

--screenshot-png-сжатие = <0-9>
Установите уровень сжатия PNG. Чем выше, тем лучше сжатие. Это повлияет
размер файла записанного файла скриншота и время, необходимое для записи
снимок экрана. Слишком сильное сжатие может занять достаточно процессорного времени для прерывания
воспроизведение. По умолчанию - 7.

--screenshot-png-filter = <0-5>
Установите фильтр, применяемый до сжатия PNG. 0 - нет, 1 - «под», 2 - «вверх»,
3 - «средний», 4 - «Paeth» и 5 - «смешанный». Это влияет на уровень
сжатие, которое может быть достигнуто. Для большинства изображений лучше всего подходит "смешанный".
степень сжатия, следовательно, это значение по умолчанию.

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ Scaler
--sws-scaler =
Укажите алгоритм программного масштабирования, который будет использоваться с --vf = масштаб. Это также влияет
драйверы вывода видео, в которых отсутствует аппаратное ускорение, например x11. См. также
--vf = масштаб.

Чтобы получить список доступных средств масштабирования, запустите --sws-scaler = помощь.

По умолчанию: бикубический.

--sws-lgb = <0-100>
Программный скалер, фильтр размытия по Гауссу (яркость). Видеть --sws-масштабатор.

--sws-cgb = <0-100>
Программный скалер, фильтр размытия по Гауссу (цветность). Видеть --sws-масштабатор.

--sws-ls = <-100-100>
Программный скалер, фильтр резкости (яркости). Видеть --sws-масштабатор.

--sws-cs = <-100-100>
Программный скейлер, фильтр резкости (цветность). Видеть --sws-масштабатор.

--sws-chs =
Программный скейлер с горизонтальным смещением цветности. Видеть --sws-масштабатор.

--sws-cvs =
Программный скейлер с вертикальным смещением цветности. Видеть --sws-масштабатор.

Терминал
--тихий
Сделайте вывод консоли менее подробным; в частности, предотвращает появление строки состояния (например, AV:
3.4 (00: 00: 03.37) / 5320.6 ...) не отображается. Особенно полезно на медленных
клеммы или сломанные, которые не обрабатывают возврат каретки должным образом (т. е. \r).

Также см - действительно тихо и --msg-уровень.

- действительно тихо
Отображать даже меньше сообщений о выходе и состоянии, чем с --тихий.

--нетерминальный, --Терминал
Отключите любое использование терминала и stdin / stdout / stderr. Это полностью заглушает
вывод любого сообщения.

В отличие от - действительно тихо, это также отключает инициализацию ввода и терминала.

--no-msg-цвет
Отключить цветной вывод консоли на терминалах.

--msg-level =
Детальность управления непосредственно для каждого модуля. В ВСЕ модуль изменяет многословие
все модули, явно не указанные в командной строке.

Запустите mpv с --msg-level = все = трассировка чтобы увидеть все сообщения, выводимые mpv. Вы можете использовать
имена модулей, напечатанные в выводе (с префиксом для каждой строки в [...]), чтобы ограничить
вывод в интересные модули.

ПРИМЕЧАНИЕ:
Некоторые сообщения печатаются до анализа командной строки и поэтому
не затронутый --msg-уровень. Чтобы управлять этими сообщениями, вы должны использовать
MPV_VERBOSE переменная окружения; видеть ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ для получения информации.

Доступные уровни:

нет полная тишина

роковой только фатальные сообщения

ошибка Сообщения об ошибках

предупреждать предупреждающие сообщения

info информационные сообщения

статус сообщения о состоянии (по умолчанию)

v подробные сообщения

отлаживать сообщения отладки

прослеживать очень шумные отладочные сообщения

--term-OSD, --без термина OSD, --term-osd = сила
Отображать сообщения OSD на консоли, когда видеовыход недоступен. Включено
по умолчанию.

сила включает экранное меню терминала, даже если создано видеоокно.

--term-osd-бар, --no-term-osd-bar
Включите печать индикатора выполнения под строкой состояния на терминале. (Отключено
дефолт.)

--term-osd-bar-chars =
Настройте --term-osd-бар особенность. Предполагается, что строка будет состоять из 5
символы (начало, левый пробел, индикатор позиции, правый пробел, конец). Ты можешь использовать
Символы Юникода, но обратите внимание, что символы двойной ширины не обрабатываются.
правильно.

По умолчанию: [- + -].

--term-playing-msg =
Распечатайте строку после начала воспроизведения. Строка раскрывается для свойств,
или --term-plays-msg = 'файл: $ {имя_файла} ' напечатает строку файл: последующей
пробел и имя текущего воспроизводимого файла.

Посмотреть Объект расширение.

--term-status-msg =
Распечатайте настраиваемую строку во время воспроизведения вместо стандартной строки состояния.
Расширяет свойства. Видеть Объект расширение.

--msg-модуль
Добавляйте имя модуля к каждому сообщению консоли.

--msg-время
Добавляйте информацию о времени к каждому сообщению консоли.

TV
--телевидение-...
Эти параметры настраивают различные свойства модуля ТВ-захвата. Для просмотра телевизора
с mpv используйте ТВ:// or ТВ:// или даже ТВ:// (См.
вариант телевизионные каналы для Название канала ниже) в качестве URL-адреса СМИ. Вы также можете использовать
ТВ:/// чтобы начать просмотр видео с композитного или S-Video входа (см.
вариант вход для более подробной информации).

--tv-device =
Укажите устройство ТВ (по умолчанию: / dev / video0).

--tv-channel =
Настройте тюнер на канал.

--нет-тв-аудио
нет звука

--tv-automute = <0-255> (v4l и v4l2 только)
Если уровень сигнала, сообщаемый устройством, меньше этого значения, аудио и видео будут
быть отключенным. В большинстве случаев будет достаточно automute = 100. По умолчанию 0 (автоматическое отключение
отключен).

--tv-driver =
Посмотреть --tv = драйвер = помощь список встроенных драйверов ввода ТВ. в наличии: манекен,
v4l2 (по умолчанию: автоматическое определение)

--tv-input =
Укажите вход (по умолчанию: 0 (TV), доступные входы см. В выводе консоли).

--tv-freq =
Укажите частоту для настройки тюнера (например, 511.250). Не совместим с
параметр каналов.

--tv-outfmt =
Укажите выходной формат тюнера с предустановленным значением, поддерживаемым V4L.
драйвер (YV12, UYVY, YUY2, I420) или произвольный формат, заданный как шестнадцатеричное значение.

--tv-width =
ширина окна вывода

--tv-height =
высота окна вывода

--tv-fps =
частота кадров для захвата видео (кадров в секунду)

--tv-buffersize =
максимальный размер буфера захвата в мегабайтах (по умолчанию: динамический)

--tv-norm =
См. Вывод на консоль для получения списка всех доступных норм, также см. нормальный
вариант ниже.

--tv-normid = (v4l2 только)
Устанавливает телевизионную норму для данного числового идентификатора. Норма ТВ зависит от карты захвата.
См. Вывод на консоль для получения списка доступных норм телевидения.

--tv-chanlist =
доступно: аргентина, австралия, китай-bcast, европа-восток, европа-запад, франция,
Ирландия, Италия, Япония-Bcast, Япония-Кабель, Новая Зеландия, Россия, Южная Африка,
us-bcast, us-кабель, us-кабель-hrc

--tv-каналы = - знак равно ], - знак равно ], ...
Задайте имена для каналов.

ПРИМЕЧАНИЕ:
Если является целым числом больше 1000, оно будет рассматриваться как частота (в
кГц), а не имя канала из таблицы частот. Используйте _ для пробелов в именах
(или поиграйте с цитированием ;-)). Имена каналов будут записаны в экранном меню.
и подчиненные команды tv_step_channel, tv_set_channel и tv_last_channel предусматривает
быть пригодным для дистанционного управления. Не совместим с частота Параметр.

ПРИМЕЧАНИЕ:
Номер канала будет тогда позицией в списке «каналов», начиная с
с 1.

Примеры

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

--tv- [яркость | контраст | оттенок | насыщенность] = <-100-100>
Установите на карту эквалайзер изображения.

--tv-audiorate =
Установите частоту дискретизации входного аудио.

--tv-forceaudio
Захватывайте звук, даже если v4l не сообщает об источниках звука.

---Альс-Альса
Захват из ALSA.

--tv-amode = <0-3>
Выберите звуковой режим:

0 моно

1 стерео

2 язык 1

3 язык 2

--tv-forcechan = <1-2>
По умолчанию количество записанных аудиоканалов определяется автоматически
запрос аудио режима с ТВ-карты. Эта опция позволяет форсировать стерео / моно
запись независимо от параметра amode и значений, возвращаемых v4l. Это может
использоваться для устранения неполадок, когда ТВ-карта не может сообщить о текущем звуке.
Режим.

--tv-adevice =
Установите аудиоустройство. должно быть / dev / xxx для OSS и идентификатор оборудования для ALSA.
Вы должны заменить любой ":" на "." в идентификаторе оборудования для ALSA.

--tv-audioid =
Выберите аудиовыход карты захвата, если на ней несколько.

--tv- [громкость | низкие частоты | высокие частоты | баланс] = <0-100>
Эти параметры устанавливают параметры микшера на плате видеоввода. Они будут
не действуют, если на вашей карте его нет. Для v4l2 50 карт по умолчанию
значение элемента управления, сообщенное водителем.

--tv-gain = <0-100>
Установите регулятор усиления для видеоустройств (обычно веб-камер) на желаемое значение и
выключить автоматическое управление. Значение 0 включает автоматическое управление. Если это
опция опущена, регулировка усиления не будет изменена.

--tv-momentmode =
Значение 0 означает одновременный захват и буферизацию аудио и видео. Значение 1
(по умолчанию) означает только захват видео и пропускание звука по шлейфу
кабель от ТВ-карты к звуковой карте.

--tv-mjpeg
Используйте аппаратное сжатие MJPEG (если карта это поддерживает). При использовании этой опции
вам не нужно указывать ширину и высоту окна вывода, потому что mpv
определит его автоматически по значению прореживания (см. ниже).

--tv-decimation = <1 | 2 | 4>
выбрать размер картинки, которая будет сжата аппаратным MJPEG
сжатие:

1 полный размер

· 704x576 ПАЛ

· 704 x 480 NTSC

2 средний размер

· 352x288 ПАЛ

· 352 x 240 NTSC

4 маленький размер

· 176x144 ПАЛ

· 176 x 120 NTSC

--tv-quality = <0-100>
Выберите качество сжатия JPEG (рекомендуется <60 для полного размера).

--tv-сканирование-автозапуск
Начните сканирование каналов сразу после запуска (по умолчанию: отключено).

--tv-scan-period = <0.1-2.0>
Укажите задержку в секундах перед переключением на следующий канал (по умолчанию: 0.5). Ниже
Значения приведут к более быстрому сканированию, но могут определять неактивные телеканалы как активные.

--tv-scan-threshold = <1-100>
Пороговое значение мощности сигнала (в процентах), сообщаемое устройством.
(по умолчанию: 50). Уровень сигнала выше этого значения будет указывать на то, что
в настоящий момент сканируемый канал активен.

Кэш
--cache =
Установите размер кеша в килобайтах, отключите с помощью нет, или автоматически включить
это при необходимости с автоматический (дефолт: автоматический). С участием автоматический, кеш обычно будет
включен для сетевых потоков, используя размер, установленный --кэш-по умолчанию. С Да,
кеш всегда будет включен с размером, установленным --кэш-по умолчанию (если только
поток не может быть кэширован, или --кэш-по умолчанию отключает кеширование).

Может быть полезно при воспроизведении файлов с медленных носителей, но также может иметь отрицательные
эффекты, особенно с форматами файлов, которые требуют большого поиска, такими как MP4.

Обратите внимание, что половина размера кеша будет использоваться для быстрого возврата. Это тоже
причина, по которой полный кеш обычно не сообщается как заполненный на 100%. Заполнение кеша
display не включает часть кеша, зарезервированную для обратного поиска. В
фактический максимальный процент обычно представляет собой соотношение между опережающим чтением и
размеры бэкбуфера.

--cache-default =
Установите размер кеша в килобайтах (по умолчанию: 75000 КБ). С использованием нет не будет
автоматически включить кеш, например, при воспроизведении из сетевого потока. Обратите внимание, что
через --кэш всегда будет отменять эту опцию.

--cache-initial =
Воспроизведение начнется, когда кэш будет заполнен таким количеством килобайт
данные (по умолчанию: 0).

--cache-seek-min =
Если нужно найти позицию внутри размера кеш-памяти из
текущая позиция, mpv будет ждать, пока кеш будет заполнен до этой позиции, а не
чем при поиске потока (по умолчанию: 500).

Это важно для небольших форвардов. С медленными потоками (особенно потоками HTTP)
существует компромисс между пропуском данных между текущей позицией и поиском
пункт назначения или выполнение фактического поиска. В зависимости от ситуации, любой из
они могут быть медленнее, чем другой метод. Эта опция позволяет контролировать это.

--cache-backbuffer =
Размер заднего буфера кеша (по умолчанию: 75000 КБ). Это добавит к общему кешу
размер и зарезервировал сумму для возврата. Зарезервированная сумма не будет
используется для опережения чтения и вместо этого сохраняет уже прочитанные данные, чтобы обеспечить быстрый поиск
назад.

--cache-file =
Создайте файл кеша в файловой системе.

Есть два способа использовать это:

1. Передача пути (имени файла). Файл всегда будет перезаписан. Когда
общий кеш включен, этот файловый кеш будет использоваться для хранения всего прочитанного
из исходного потока.

Это всегда будет перезаписывать файл кеша, и вы не сможете использовать существующий кеш.
файл, чтобы возобновить воспроизведение потока. (Технически MPV даже не знает, какой
блоки в файле действительны, а какие нет.)

Результирующий файл не обязательно будет содержать все данные исходного потока.
Например, если вы ищете, пропущенные части никогда не читаются и
следовательно, не записываются в кеш. Пропущенные части заполняются
с нулями. Это означает, что файл кеша не обязательно соответствует
полная загрузка исходного потока.

Обе эти проблемы можно решить, если есть интерес для пользователей.

ПРЕДУПРЕЖДЕНИЕ:
Вызывает случайное повреждение при использовании с упорядоченными главами или с
--audio-файл.

2. Передача строки TMP. Это не будет интерпретировано как имя файла. Вместо этого
невидимый временный файл создается. Это зависит от вашей библиотеки C, где это
файл создается (обычно / tmp /) и отображается ли имя файла ( tmpfile ()
функция используется). В некоторых системах автоматическое удаление файла кеша может
не гарантируется.

Если вы хотите использовать файловый кеш, рекомендуется этот режим, потому что он не
нарушить заказанные главы или --audio-файл. Эти режимы открывают несколько потоков кеша,
и использование для них одного и того же файла явно противоречит.

Также см - размер-кеш-файла.

--cache-file-size =
Максимальный размер файла, созданного с помощью --cache-файл. Для доступа для чтения выше этого
размер, кеш просто не используется.

Имейте в виду, что некоторые варианты использования, такие как воспроизведение упорядоченных глав с включенным кешем,
фактически создаст несколько файлов кеша, каждый из которых будет использовать до этого количества
дисковое пространство.

(По умолчанию: 1048576, 1 ГБ.)

--без кеша
Отключите кеширование входного потока. Видеть --кэш.

--cache-secs =
Сколько секунд аудио / видео нужно предварительно выбрать, если кеш активен. Это отменяет
--demuxer-readahead-secs параметр тогда и только тогда, когда кеш включен и
значение больше. (По умолчанию: 10.)

--кэш-пауза, --без кеша-пауза
Должен ли проигрыватель автоматически приостанавливаться при низком уровне кеша и возобновляться
снова доступны данные («буферизация»).

Cеть
--user-agent =
Используйте как пользовательский агент для потоковой передачи HTTP.

--печенье, --нет печенья
Поддержка файлов cookie при выполнении HTTP-запросов. По умолчанию отключено.

--cookies-file =
Прочитать файлы cookie HTTP из . Предполагается, что файл имеет формат Netscape.

--http-header-fields =
Установите настраиваемые поля HTTP при доступе к потоку HTTP.

Пример

mpv --http-header-fields = 'Поле1: значение1', 'Поле2: значение2' \
http://localhost: 1234

Сгенерирует HTTP-запрос:

GET / HTTP / 1.0
Хост: localhost: 1234
Пользовательский агент: MPlayer
Ледяные метаданные: 1
Поле1: значение1
Поле2: значение2
Подключение: закрыть

--tls-ca-file =
Файл базы данных центра сертификации для использования с TLS. (Тихо терпит неудачу со старым
Версии FFmpeg или Libav.)

--tls-проверить
Проверяйте одноранговые сертификаты при использовании TLS (например, с https://...). (Тихо терпит неудачу
со старыми версиями FFmpeg или Libav.)

--tls-файл-сертификата
Файл, содержащий сертификат для использования при рукопожатии с одноранговым узлом.

--tls-файл-ключ
Файл, содержащий закрытый ключ для сертификата.

--referrer =
Укажите путь реферера или URL-адрес для HTTP-запросов.

--network-timeout =
Укажите время ожидания сети в секундах. Это влияет как минимум на HTTP. Специальный
значение 0 (по умолчанию) использует значения по умолчанию для FFmpeg / Libav. Если используется протокол,
не поддерживает тайм-ауты, этот параметр автоматически игнорируется.

--rtsp-transport =
Выберите метод передачи RTSP (по умолчанию: tcp). Это выбирает базовую сеть
транспорт во время игры rtsp: // ... URL-адреса. Значение лавф оставляет решение
libavformat.

--hls-bitrate = >
Если воспроизводятся потоки HLS, этот параметр определяет, какие потоки выбираются
дефолт. Опция допускает следующие параметры:

нет Ничего особенного не делай. Обычно это просто выбирает первый
аудио / видео потоки, которые он может найти.

мин Выберите потоки с самым низким битрейтом.

Макс То же самое, но самый высокий битрейт. (Дефолт.)

Кроме того, если параметр представляет собой число, поток с наивысшей скоростью равен или
ниже выбрано значение параметра.

Используемый битрейт отправляется сервером, и нет никакой гарантии, что он действительно
осмысленный.

DVB
--dvbin-card = <1-4>
Указывает с использованием номера карты 1–4 (по умолчанию: 1).

--dvbin-file =
Указывает mpv читать список каналов из . По умолчанию используется mpv.
каталог конфигурации (обычно ~ / .config / mpv) с именем файла
каналы.conf. {sat, ter, cbl, atsc} (в зависимости от типа вашей карты) или каналы.conf как
Крайнее средство. Для карт DVB-S / 2 рекомендуется список каналов формата VDR 1.7.x как
он позволяет настраиваться на каналы DVB-S2, включать субтитры и декодировать PMT (который
значительно улучшает демультиплексирование). Списки каналов в классическом формате mplayer все еще
поддерживается (без этих улучшений), а для других типов карт - только ограниченный VDR
реализована поддержка списка каналов формата (патчи приветствуются). Для каналов с
динамическое переключение PID или неполное каналы.conf, --dvbin-полный транспондер или
волшебный PID 8192 рекомендуется.

--dvbin-timeout = <1-30>
Максимальное количество секунд ожидания при попытке настроить частоту, прежде чем отказаться
(по умолчанию: 30).

--dvbin-полный-транспондер =
Не применяйте фильтры к программным PID, только настройтесь на частоту и пропустите полный транспондер
в демультиплексор. Это полезно для записи нескольких программ на один транспондер или
обойти проблемы в каналы.conf. Также рекомендуется использовать это для
каналы, которые переключают PID на лету, например, для региональных новостей.

По умолчанию: нет

Прочее
--display-tags = tag1, tags2, ...
Задайте список тегов, которые должны отображаться на терминале. Теги, которые есть в
список, но отсутствует в проигрываемом файле, не будет отображаться. Если значение заканчивается
*, все теги совпадают по префиксу (хотя общего подстановки нет). Просто
прохождение * по сути фильтрующий.

По умолчанию включает общий список тегов, вызовите mpv с помощью --список-опций чтобы увидеть это.

--mc =
Максимальная коррекция синхронизации AV на кадр (в секундах)

--autosync =
Постепенно регулирует синхронизацию A / V на основе измерений задержки звука. Указание
--autosync = 0, значение по умолчанию, приведет к тому, что синхронизация кадра будет полностью основана на аудио
измерения задержки. Указание --autosync = 1 будет делать то же самое, но будет тонко
изменить алгоритм коррекции A / V. Неравномерная частота кадров в видео, которая
отлично играет с --нет-аудио часто можно помочь, установив здесь целочисленное значение
больше 1. Чем выше значение, тем ближе время к --нет-аудио.
Попытка --autosync = 30 чтобы сгладить проблемы со звуковыми драйверами, которые не реализуют
идеальное измерение задержки звука. С этим значением, если большие смещения A / V синхронизации
возникают, им потребуется всего 1-2 секунды, чтобы успокоиться. Эта задержка в
время реакции на внезапные смещения A / V должно быть единственным побочным эффектом включения этого
опция включена для всех звуковых драйверов.

--video-sync =
Как плеер синхронизирует аудио и видео.

Режимы, начинающиеся с дисплей попробуйте вывести кадры видео полностью
синхронно с дисплеем, используя обнаруженную частоту вертикального обновления дисплея в качестве
Подскажите, насколько быстро в среднем будут отображаться кадры. Эти режимы изменяют скорость видео
немного, чтобы соответствовать дисплею. Видеть --видео-синхронизация -... варианты тонкой настройки. В
устойчивость этого режима еще больше снижается за счет некоторых идеализированных предположений,
что не всегда может быть применимо в реальности. Поведение может зависеть от VO и
видео и аудио драйверы системы. Медиа-файлы должны иметь постоянную частоту кадров.
VFR по разделам может также работать с некоторыми форматами контейнеров (но не, например, с mkv).
Если код синхронизации обнаруживает серьезную рассинхронизацию A / V или частоту кадров определить невозможно,
игрок автоматически возвращается к аудио режим на какое-то время или постоянно.

Режимы с рассинхронизация в их именах не пытаются синхронизировать аудио / видео.
Они будут медленно (или быстро) рассинхронизироваться, пока, например, не произойдет следующий поиск. Эти режимы
предназначены для тестирования, а не для серьезного использования.

аудио Синхронизируйте кадры видео с аудио. Это самый надежный режим, потому что игрок
не нужно ничего предполагать о поведении дисплея. В
недостатком является то, что это может привести к случайному падению или повторению кадров. Если
звук отключен, используются системные часы. Это режим "по умолчанию".

отображение-ресемпл
Передискретизируйте звук, чтобы он соответствовал видео. В этом режиме также будет попытаться настроить звук.
скорость, чтобы компенсировать другой занос. (Это означает, что он будет воспроизводить звук на
время от времени меняйте скорость, чтобы уменьшить разницу A / V.)

дисплей-resample-vdrop
Передискретизируйте звук, чтобы он соответствовал видео. Отбросьте видеокадры, чтобы компенсировать
дрейф.

дисплей-resample-desync
Как и в предыдущем режиме, но без компенсации A / V.

дисплей-vdrop
Отбрасывайте или повторяйте видеокадры, чтобы компенсировать рассинхронизацию видео. (Хотя это
должен иметь те же эффекты, что и аудио, реализация очень
разные.)

Display-Adrop
Отбросьте или повторите аудиоданные, чтобы компенсировать рассинхронизацию видео. Видеть
--video-sync-adrop-size. Этот режим вызовет серьезные звуковые артефакты, если
реальная частота обновления монитора слишком отличается от заявленной или принудительной частоты.

десинхронизация дисплея
Синхронизируйте видео для отображения и позвольте аудио воспроизводиться самостоятельно.

рассинхронизация Синхронизируйте видео по системным часам и позвольте аудио воспроизводиться самостоятельно.

--video-sync-max-video-change =
Максимальная разница в скорости в процентах, которая применяется к видео с
--video-sync = дисплей -... (по умолчанию: 1). Режим синхронизации дисплея будет отключен, если
способы обновления монитора и видео не совпадают в указанном диапазоне. Он пытается
кратно: воспроизведение видео со скоростью 30 кадров в секунду на экране 60 Гц будет дублировать каждое
второй кадр. Воспроизведение видео со скоростью 24 кадра в секунду на экране 60 Гц будет воспроизводить видео в
2-3-2-3 -... узор.

Настройки по умолчанию недостаточны для ускорения видео с 23.976 кадра в секунду до 25 кадров в секунду.
Мы считаем изменение высоты звука слишком резким, чтобы допускать такое поведение по умолчанию. Набор
этот параметр на значение 5 чтобы включить его.

Обратите внимание, что в --video-sync = display-resample режим, скорость звука будет дополнительно
можно немного изменить, если необходимо для синхронизации аудио / видео. Видеть
--video-sync-max-audio-change.

--video-sync-max-audio-change =
Максимальный дополнительный разница в скорости в процентах, которая применяется к аудио с
--video-sync = дисплей -... (по умолчанию: 0.125). Обычно проигрыватель воспроизводит звук на
скорость видео. Но если разница между положением аудио и видео
слишком высоко, например, из-за дрейфа или других ошибок синхронизации, он будет пытаться ускориться или
замедлить звук этим дополнительным фактором. Слишком низкие значения могут привести к кадру видео.
падение или повторение, если рассинхронизация A / V не может быть компенсирована, слишком высокие значения
может привести к хаотическому падению кадра из-за "перерегулирования" звука и пропуска
несколько видеокадров до того, как логика синхронизации сможет среагировать.

--video-sync-adrop-size =
Для того, чтобы получить --video-sync = display-adrop режим. Этот режим дублирует / отбрасывает аудиоданные на
синхронизировать звук с видео. Чтобы избежать звуковых артефактов из-за джиттера (что могло бы
добавлять / удалять сэмплы постоянно), это делается в относительно больших фиксированных единицах,
контролируется этой опцией. Единица измерения - секунды.

--mf-fps =
Частота кадров, используемая при декодировании из нескольких файлов PNG или JPEG с mf: // (дефолт:
1).

--mf-тип =
Тип входного файла для mf: // (доступно: jpeg, png, tga, sgi). По умолчанию это
угадал по расширению файла.

--stream-capture =
Позволяет захватывать основной поток (не дополнительные аудиодорожки или другой вид
streams) в данный файл. Захват также можно запускать и останавливать, изменив
имя файла с захват потока рабская собственность. Обычно это не будет
производить полезные результаты для чего-либо, кроме MPEG или необработанных потоков, если только захват
включает заголовки файлов и не прерывается. Обратите внимание, что из-за кеша
задержки, захваченные данные могут начинаться и заканчиваться с некоторой задержкой по сравнению с тем, что вы
см. отображаемое.

Файл назначения всегда добавляется. (До mpv 0.8.0 файл был
перезаписан.)

--stream-dump =
Такой же как --stream-захват, но не запускайте воспроизведение. Вместо этого весь файл
свалил.

--stream-lavf-o = opt1 = значение1, opt2 = значение2, ...
Установите AVOptions для потоков, открытых с помощью libavformat. Неизвестные или написанные с ошибками варианты:
молча игнорируется. (Они упоминаются в выводе терминала в подробном режиме, т.е.
--v. Как правило, мы не можем печатать ошибки, потому что другие параметры, такие как, например, пользователь
агент недоступен для всех протоколов, и ошибки печати для неизвестных параметров
будет слишком шумно.)

--vo-mmcss-profile =
(Только для Windows.) Установите профиль MMCSS для потока видеорендерера (по умолчанию:
Воспроизведение).

--priority =
(Только для Windows.) Установите приоритет процесса для MPV в соответствии с предопределенным
приоритеты доступны под Windows.

Возможные значения : холостой ход | ниже нормы | нормально | выше нормы | высокий | в реальном времени

ПРЕДУПРЕЖДЕНИЕ:
Использование приоритета в реальном времени может привести к зависанию системы.

--force-media-title =
Заставить содержимое медиа-заголовок свойство к этому значению. Полезно для скриптов
которые хотят установить заголовок, не переопределяя настройки пользователя в --заглавие.

АУДИО ВЫВОД ВОДИТЕЛИ

Драйверы вывода звука - это интерфейсы для различных устройств вывода звука. Синтаксис:

--ao =
Укажите список приоритетов используемых драйверов вывода звука.

Если в конце списка есть ",", mpv вернется к драйверам, которых нет в списке.
Подопции не являются обязательными и в большинстве случаев могут быть опущены.

Вы также можете установить значения по умолчанию для каждого драйвера. Значения по умолчанию применяются перед обычным
параметры драйвера.

--ao-defaults =
Установите значения по умолчанию для каждого драйвера.

ПРИМЕЧАНИЕ:
Посмотреть --ao = помощь для списка встроенных драйверов вывода звука. Водитель --ao = alsa is
предпочтительным. --ao = пульс предпочтительнее в системах, где используется PulseAudio. В Windows
--ao = васапи предпочтительнее, хотя иногда это может вызвать проблемы, и в этом случае
--ao = dsound должен быть использован. В системах BSD --ao = oss or --ao = sndio` может работать (
последний экспериментальный). В системах OS X используйте --ao = coreaudio.

Примеры

· --ao = alsa, oss, Попробуйте драйвер ALSA, затем драйвер OSS, затем другие.

· --ao = alsa: resample = yes: device = [plughw: 0,3] Позволяет ALSA передискретить и устанавливает
имя-устройства как первая карта, четвертое устройство.

Доступные драйверы вывода звука:

альса (Линукс только)
Драйвер вывода звука ALSA

устройство =
Устанавливает имя устройства. Для вывода ac3 через S / PDIF используйте iec958 или spdif
устройства, если вы действительно не знаете, как его правильно настроить.

resample = да
Включите плагин передискретизации ALSA. (По умолчанию это отключено, потому что некоторые
в некоторых случаях драйверы сообщают о неправильной задержке звука.)

микшер-устройство =
Установите используемое микшерное устройство с --no-софтвол (дефолт: по умолчанию).

имя-микшера =
Задайте имя элемента микшера (по умолчанию: Эталонный). Это например PCM
or Эталонный.

смеситель-индекс =
Установите индекс канала микшера (по умолчанию: 0). Рассмотрим вывод
"миксер прокрутки", то индекс - это номер, следующий за названием
элемент.

не чередующийся
Разрешить вывод форматов без чередования (если аудиодекодер использует это
формат). В настоящее время отключено по умолчанию, потому что некоторые популярные плагины ALSA
полностью нарушены форматами без чередования.

игнорировать-chmap
Не читайте и не устанавливайте карту каналов устройства ALSA - только запрашивайте
необходимое количество каналов, а затем передать звук как есть. Этот
вариант скорее всего не стоит использовать. Это может быть полезно для отладки или
для статических установок со специально разработанной конфигурацией ALSA (в этом
случае вы всегда должны принудительно использовать один и тот же макет с помощью --аудиоканалы, или это
будет работать только для файлов, которые используют макет, неявный для вашего устройства ALSA).

ПРИМЕЧАНИЕ:
MPlayer и mplayer2 потребовали от вас заменить любые символы ',' на '.' и любой ':' с
'=' в имени устройства ALSA. mpv больше этого не делает. Вместо этого процитируйте
имя устройства:
--ao = alsa: device = [plug: Surround50]

Обратите внимание, что [ и ] просто укажите название устройства. С некоторыми оболочками (например, zsh),
вы должны заключить строку параметра в кавычки, чтобы оболочка не интерпретировала
скобки вместо того, чтобы передавать их в mpv.

На самом деле вы должны использовать --аудио-устройство вариант, вместо того, чтобы устанавливать
устройство напрямую.

ПРЕДУПРЕЖДЕНИЕ:
Обработка многоканального / объемного звука изменена в mpv 0.8.0 из поведения
в MPlayer / mplayer2 и более старых версиях mpv.

Старое поведение заключается в том, что проигрыватель всегда по умолчанию понижает микширование до стерео. В
--аудиоканалы (или --каналы до этого) параметр должен был быть установлен, чтобы получить
многоканальное аудио. Тогда для воспроизведения стерео будет использоваться по умолчанию устройство (которое
обычно позволяет нескольким программам одновременно воспроизводить звук через dmix),
при воспроизведении чего-либо с большим количеством каналов открывается одно из устройств
устройства, например, через окружать51 псевдоним (обычно с монопольным доступом).
Будет ли проигрыватель использовать монопольный доступ или нет, будет зависеть от файла
играют.

Новое поведение, начиная с mpv 0.8.0, всегда включает многоканальный звук, т.е.
--audio-каналы = авто по умолчанию. Однако, поскольку ALSA не дает хорошего способа
для воспроизведения многоканального звука неисключительным способом (без блокировки других
приложений от использования звука), проигрыватель ограничен возможностями
по умолчанию устройство по умолчанию, что означает, что оно поддерживает только стерео и моно (при
по крайней мере, с текущими типичными конфигурациями ALSA). Но если аппаратное устройство
выбрано, то обычно будет работать многоканальный звук.

Вкратце: если вам нужен многоканальный звук с ALSA, используйте --аудио-устройство
для выбора устройства (используйте --audio-device = помощь получить список всех устройств и
их название mpv).

Вы также можете попробовать через микширование плагин. Эта настройка позволяет использовать многоканальный звук.
на по умолчанию устройство с автоматическим повышающим микшированием с общим доступом, поэтому игра
стерео и многоканальный звук одновременно будут работать как положено.

нам Драйвер вывода звука OSS


Устанавливает устройство вывода звука (по умолчанию: / dev / dsp).


Устанавливает устройство аудиомикшера (по умолчанию: / dev / микшер).


Устанавливает канал аудиомикшера (по умолчанию: РСМ). Другие допустимые значения включают объем
ПКМ, линия. Полный список опций ищите SOUND_DEVICE_NAMES in
/usr/include/linux/soundcard.h.

домкрат Драйвер вывода звука JACK (Jack Audio Connection Kit)

порт =
Подключается к портам с заданным именем (по умолчанию: физические порты).

имя =
Имя клиента, передаваемое в JACK (по умолчанию: MPV). Полезно, если вы хотите
установить определенные соединения автоматически.

(нет-) автозапуск
При необходимости автоматически запускать jackd (по умолчанию: отключено). Обратите внимание, что это
имеет тенденцию быть ненадежным и будет наводнять stdout сообщениями сервера.

(нет-) подключиться
Автоматически создавать подключения к выходным портам (по умолчанию: включено). Когда
включено, максимальное количество выходных каналов будет ограничено числом
доступных портов вывода.

std-channel-layout = waveext | любой
Выберите стандартную компоновку канала (по умолчанию: waveext). Сам JACK не имеет
понятие компоновки каналов (т. е. определение того, какой динамик является
должен быть сопоставлен) - он просто принимает все, что выводит приложение, и
перенаправляет его на то, что определяет пользователь. Это означает, что пользователь и
За макет канала отвечает приложение. длина волны использования
Порядок WAVE_FORMAT_EXTENSIBLE, который, несмотря на то, что он был определен
Microsoft является стандартом для многих систем. Значение любое заставляет ДЖЕКА принять
все, что поступает из цепочки аудиофильтров, независимо от расположения каналов и
без повторного заказа. Этот режим, вероятно, не очень полезен, кроме как для
отладка или при использовании с фиксированными настройками.

Coreaudio (Мак OS X только)
Собственный драйвер вывода звука Mac OS X с использованием AudioUnits и звука CoreAudio
сервера.

Автоматически перенаправляет на coreaudio_exclusive при воспроизведении сжатых форматов.

изменить-физический-формат =
Измените физический формат на тот, который похож на запрошенный аудиоформат
(по умолчанию: нет). Это имеет то преимущество, что многоканальный аудиовыход будет
на самом деле работают. Недостаток в том, что он изменит общесистемный звук.
настройки. Это эквивалентно изменению Формат установка в Аудио
Аппараты диалог в Аудио MIDI Установка полезность. Обратите внимание, что это не
влияет на выбранную настройку динамиков.

эксклюзив
Используйте доступ в монопольном режиме. Это просто перенаправляет на coreaudio_exclusive, Но
следует предпочесть прямому использованию этого АО.

coreaudio_exclusive (Мак OS X только)
Собственный драйвер вывода звука Mac OS X с использованием прямого доступа к устройству и эксклюзивного режима
(обходит звуковой сервер).

открытый Экспериментальный драйвер вывода звука OpenAL

ПРИМЕЧАНИЕ:
Этот драйвер не очень полезен. Воспроизведение с ним многоканального звука происходит медленно.

импульс Драйвер вывода звука PulseAudio

[ ] [: раковина>]
Укажите хост и, при необходимости, выходной приемник для использования. Пустой нить
использует локальное соединение, "localhost" использует передачу по сети (скорее всего, не
что ты хочешь).

буфер = <1-2000 | родной>
Установите размер аудиобуфера в миллисекундах. Более высокое значение буферизует больше данных,
и имеет меньшую вероятность опустошения буфера. Меньшее значение делает
аудиопоток быстрее реагирует, например, на изменение скорости воспроизведения. По умолчанию: 250.

латентность-хаки =
Включите хаки для обхода ошибок синхронизации PulseAudio (по умолчанию: нет). Если включено,
mpv самостоятельно произведет сложные вычисления задержки. Если отключено, это будет
используйте PulseAudio, автоматически обновляемую информацию о времени. Отключение этого
может помочь, например, с сетевым аудио или некоторыми плагинами, включив его
может помочь в некоторых неизвестных ситуациях (раньше требовалось, чтобы
поведение на старых версиях PulseAudio).

Если у вас заикается видео при использовании пульса, попробуйте включить эту опцию.
(Или, как вариант, попробуйте обновить PulseAudio.)

dsound (Windows только)
Драйвер вывода звука DirectX DirectSound

ПРИМЕЧАНИЕ:
Этот драйвер предназначен для совместимости со старыми системами.

устройство =
Устанавливает номер используемого устройства. Воспроизведение файла с -v покажет список
доступные устройства.

Buffersize =
Размер буфера DirectSound в миллисекундах (по умолчанию: 200).

СДЛ Драйвер вывода звука SDL 1.2+. Должен работать на любой платформе, поддерживаемой SDL 1.2, но
может потребоваться SDL_AUDIODRIVER переменная среды, которая должна быть установлена ​​соответствующим образом для
вашей системы.

ПРИМЕЧАНИЕ:
Этот драйвер предназначен для совместимости с чрезвычайно иностранными средами, такими как
системы, в которых нет других драйверов.

buflen =
Устанавливает длину аудиобуфера в секундах. Используется только как подсказка звуком
система. Воспроизведение файла с -v покажет запрошенный и полученный точный
размер буфера. Значение 0 выбирает звуковую систему по умолчанию.

bufcnt =
Устанавливает количество дополнительных аудио буферов в mpv. Обычно менять не нужно.

нуль Не выводит звук, но поддерживает скорость воспроизведения видео. Использовать --ao = null: без указания времени
для сравнительного анализа.

несвоевременный
Не имитируйте синхронизацию идеального аудиоустройства. Это означает декодирование звука
будет идти как можно быстрее, а не синхронизировать его с системными часами.

буфер Длина смоделированного буфера в секундах.

взрыв
Смоделированный размер блока в выборках.

скорость Смоделированная скорость воспроизведения звука как множитель. Обычно реальное аудиоустройство
не будет идти точно так же быстро, как системные часы. Он отклонится только на
немного, и этот вариант помогает смоделировать это.

задержка
Имитация задержки устройства. Это дополнительно к EOF.

сломанный
Имитируйте неисправные аудиодрайверы, которые всегда добавляют фиксированную задержку устройства к
сообщенная позиция воспроизведения звука.

нарушенная задержка
Имитируйте неисправные аудиодрайверы, которые неправильно сообщают о задержке.

схемы каналов
Если не пусто, это , разделенный список раскладок каналов, разрешенных АО.
Это можно использовать для проверки выбора компоновки каналов.

РСМ Аудиовыход для записи файлов Raw PCM / WAVE

(нет) волновой заголовок
Включать или не включать заголовок WAVE (по умолчанию: включен). Когда нет
включен, будет сгенерирован необработанный PCM.

файл =
Напишите звук в вместо по умолчанию аудиодамп.wav. Если
без волнового заголовка указан, по умолчанию аудиодамп.pcm.

(нет-) добавить
Добавить в файл, а не перезаписывать его. Всегда используйте это с
без волнового заголовка вариант - с волновой заголовок он сломан, потому что он напишет
Заголовок WAVE каждый раз при открытии файла.

звук Аудиовыход для демона RSound

ПРИМЕЧАНИЕ:
Совершенно бесполезно, если вы не собираетесь запускать RSound. Не путать с
RoarAudio, что-то совсем другое.

host =
Установите адрес сервера (по умолчанию: localhost). Может быть как сеть
имя хоста для TCP-соединений или путь к сокету домена Unix, начинающийся с '/'.

порт =
Установите TCP-порт, используемый для подключения к серверу (по умолчанию: 12345). Нет
используется при подключении к сокету домена Unix.

Sndio Аудиовыход в звуковую систему OpenBSD sndio

ПРИМЕЧАНИЕ:
Экспериментальный. Есть известные ошибки и проблемы.

(Примечание: поддерживает только моно, стерео, 4.0, 5.1 и 7.1-канальные схемы.)

устройство =
sndio устройство для использования (по умолчанию: $ АУДИОДЕВИСсоответственно. snd0).

васапи Аудиовыход в Windows Audio Session API.

эксклюзив
Запрашивает эксклюзивный прямой доступ к оборудованию. По определению предотвращает звук
воспроизведение любой другой программы до выхода из mpv.

устройство =
Использует запрошенную конечную точку вместо конечной звуковой точки системы по умолчанию.
Действительны как порядковый номер (0,1,2, ...), так и строка GUID; GUID
Строка гарантированно не изменится, если драйвер не будет удален.

Также поддерживает поиск активных устройств по понятным для человека именам. Если больше чем
одно устройство совпадает с названием, отказывается его загружать.

Этот вариант в основном не рекомендуется в пользу более общего
--аудио-устройство вариант. Тем не менее, --audio-device = помощь даст список
допустимые GUID устройства (с префиксом васапи /), а также их удобочитаемость
имена, которые должны работать здесь.

ВИДЕО ВЫВОД ВОДИТЕЛИ

Драйверы вывода видео - это интерфейсы к различным средствам вывода видео. Синтаксис:

--vo =
Укажите список приоритетов используемых драйверов вывода видео.

Если в конце списка есть ",", mpv вернется к драйверам, которых нет в списке.
Подопции не являются обязательными и в большинстве случаев могут быть опущены.

Вы также можете установить значения по умолчанию для каждого драйвера. Значения по умолчанию применяются перед обычным
параметры драйвера.

--vo-defaults =
Установите значения по умолчанию для каждого драйвера.

ПРИМЕЧАНИЕ:
Посмотреть --vo = помощь список встроенных драйверов вывода видео.

Рекомендуемый драйвер вывода: --vo = opengl-hq. Все остальные драйверы предназначены для
совместимость или специальные цели. По умолчанию, --vo = opengl используется, но если это появляется
чтобы не работать, это откат к другим драйверам (в том же порядке, что и --vo = помощь).

Доступные драйверы вывода видео:

xv (Х11 только)
Использует расширение XVideo для включения аппаратного ускорения отображения. Это самый
совместимый VO на X, но может быть низкого качества и иметь проблемы с экранным меню и субтитрами
дисплей.

ПРИМЕЧАНИЕ:
Этот драйвер предназначен для совместимости со старыми системами.

адаптер =
Выберите конкретный адаптер XVideo (проверьте результаты xvinfo).

порт =
Выберите конкретный порт XVideo.

ck =
Выберите источник, из которого берется цветовой ключ (по умолчанию: cur).

задница По умолчанию используется цветовой ключ, установленный в настоящее время в Xv.

используют Используйте, но не устанавливайте цветовой ключ из mpv (используйте -цветок вариант
чтобы изменить это).

набор То же, что и при использовании, но также устанавливает поставляемый цветовой ключ.

ck-method =
Устанавливает метод рисования цветовых ключей (по умолчанию: man).

человек Нарисуйте цветовой ключ вручную (в некоторых случаях уменьшает мерцание).

bg Установите цветовой ключ в качестве фона окна.

автоматический Пусть Xv нарисует цветной ключ.

colorkey =
Изменяет цветовой ключ на значение RGB по вашему выбору. 0x000000 черный и
0xffffff белый.

без цвета
Отключает цветовое кодирование.

буферы =
Количество буферов изображений, используемых для внутреннего кольцевого буфера (по умолчанию: 2).
Увеличение этого параметра потребует больше памяти, но может не помочь с X-сервером.
реагирует достаточно быстро, если частота кадров видео близка или выше, чем
частота обновления дисплея.

x11 (Х11 только)
Драйвер вывода видео с общей памятью без аппаратного ускорения, который работает в любое время
X11 присутствует.

ПРИМЕЧАНИЕ:
Это только запасной вариант, и обычно его не следует использовать.

вдпау (Х11 только)
Использует интерфейс VDPAU для отображения и, при необходимости, декодирования видео. Аппаратное обеспечение
декодирование используется с --hwdec = vdpau.

ПРИМЕЧАНИЕ:
Более ранние версии mpv (и MPlayer, mplayer2) предоставляли дополнительные параметры для настройки
постобработка vdpau, например дент, точить, DeNoise, определение цветности, подтягивание,
масштабирование. Эти подпараметры устарели, и вам следует использовать вдпаупп
видео фильтр вместо этого.

резкость = <-1-1>
(Не рекомендуется. См. Примечание о вдпаупп.)

Для положительных значений примените алгоритм повышения резкости к видео, для отрицательных
определяет алгоритм размытия (по умолчанию: 0).

шумоподавление = <0-1>
(Не рекомендуется. См. Примечание о вдпаупп.)

Примените к видео алгоритм шумоподавления (по умолчанию: 0; без шума
снижение).

deint = <-4-4>
(Не рекомендуется. См. Примечание о вдпаупп.)

Выберите режим деинтерлейсинга (по умолчанию: 0). В более старых версиях (а также
MPlayer / mplayer2) вы можете использовать эту опцию для включения деинтерлейсинга. Этот
больше не работает, а деинтерлейсинг включен с помощью d ключ (автор
по умолчанию сопоставлено с командой цикл деинтерлейсинг), или --деинтерлейсинг
вариант. Кроме того, чтобы выбрать режим определения по умолчанию, вы должны использовать что-то
" У аборигенов --vf-defaults = vdpaupp: deint-mode = temporal вместо этого подварианта.

0 Выберите вдпаупп видеофильтр по умолчанию, что соответствует 3.

1 Показать только первое поле.

2 Боб деинтерлейсинг.

3 Адаптивный к движению временной деинтерлейсинг. Может привести к рассинхронизации A / V с
медленное видеооборудование и / или высокое разрешение.

4 Адаптивный к движению временный деинтерлейсинг с пространственным управлением по краям
интерполяция. Требуется быстрое видеооборудование.

определение цветности
(Не рекомендуется. См. Примечание о вдпаупп.)

Заставляет временные деинтерлейсеры работать как с яркостью, так и с цветностью (по умолчанию). Использовать
no-chroma-deint, чтобы использовать исключительно яркость и ускорить расширенный деинтерлейсинг.
Полезно при медленной видеопамяти.

подтягивание (Не рекомендуется. См. Примечание о вдпаупп.)

Попробуйте применить обратный телесин, нужен адаптивный к движению временной деинтерлейсинг.

hqscaling = <0-9>
(Не рекомендуется. См. Примечание о вдпаупп.)

0 Использовать масштабирование VDPAU по умолчанию (по умолчанию).

1-9 Примените высококачественное масштабирование VDPAU (требуется соответствующее оборудование).

fps =
Отменить автоматически определенное значение частоты обновления дисплея (это значение необходимо для
framedrop, чтобы обеспечить скорость воспроизведения видео выше, чем частота обновления дисплея,
и для настройки синхронизации кадров с учетом vsync). По умолчанию 0 означает использование
автоматически определяемое значение. Положительное значение интерпретируется как частота обновления в Гц.
и отменяет автоматически определенное значение. Отрицательное значение отключает все время
регулировка и логика кадрирования.

составное обнаружение
Текущая реализация VDPAU NVIDIA ведет себя несколько иначе под
композитинг оконного менеджера и не дает точной синхронизации кадров
Информация. Если эта опция включена, игрок пытается определить,
оконный менеджер композитинга активен. Если он обнаружен, игрок
отключает корректировку времени, как если бы пользователь указал кадров в секунду = -1 (как они
будет основано на неправильном вводе). Это означает, что время несколько меньше
точнее, чем без композитинга, но с поведением композитного режима
драйвер NVIDIA, нет жесткого ограничения скорости воспроизведения даже без
отключенная логика. Включено по умолчанию, используйте без составного обнаружения отключить.

queuetime_windowed = и queuetime_fs =
Используйте функцию очереди презентаций VDPAU, чтобы поставить в очередь будущий видеокадр
изменяется максимум на это количество миллисекунд (по умолчанию: 50). Увидеть ниже
для дополнительной информации.

output_surfaces = <2-15>
Выделите это количество выходных поверхностей для отображения видеокадров (по умолчанию: 3). Видеть
ниже для дополнительной информации.

colorkey = <# RRGGBB | #AARRGGBB>
Установите цвет фона очереди презентации VDPAU, который на практике является
colorkey используется, если VDPAU работает в режиме наложения (по умолчанию: #020507, некоторые
оттенок черного). Если альфа-компонент этого значения равен 0, значение по умолчанию
Вместо этого будет использоваться цветовой ключ VDPAU (обычно зеленый).

форс-юв
Никогда не принимайте входной сигнал RGBA. Это означает, что mpv вставит фильтр для преобразования в
Формат YUV до VO. Иногда полезно для принудительной доступности определенных
Функции только для YUV, такие как видеоэквалайзер или деинтерлейсинг.

Использование функции очереди кадров VDPAU, управляемой параметрами очереди
делает время переворота кадра mpv менее чувствительным к загрузке системного процессора и позволяет mpv
начать декодирование следующего кадра (ов) немного раньше, что может уменьшить дрожание, вызванное
отдельными кадрами с медленным декодированием. Однако графические драйверы NVIDIA могут
другое поведение окна, такое как прерывистое движение окна, если VDPAU использует очередь blit
(в основном это происходит, если у вас включено составное расширение), и эта функция
активный. Если это происходит в вашей системе и вас это беспокоит, вы можете установить
значение queuetime равным 0, чтобы отключить эту функцию. Параметры для использования в оконных и
полноэкранный режим отдельный, потому что не должно быть причин отключать его для
полноэкранный режим (так как проблема с драйвером не должна влиять на само видео).

Вы можете поставить в очередь больше кадров вперед, увеличив значения времени ожидания и
выходные_поверхности count (чтобы обеспечить достаточное количество поверхностей для буферизации видео в течение определенного времени
впереди вам понадобится как минимум столько поверхностей, сколько кадров в видео за это время,
плюс два). В некоторых случаях это может помочь сделать видео более плавным. Основные минусы
увеличиваются требования к видеопамяти для поверхностей и замедляется отклик дисплея
для пользовательских команд (изменения отображения становятся видимыми только через некоторое время после того, как они
в очереди). Реализация графического драйвера также может иметь ограничения на длину
максимальное время в очереди или количество поверхностей в очереди, которые работают хорошо или вообще.

Direct3d_shaders (Windows только)
Драйвер вывода видео, использующий интерфейс Direct3D.

ПРИМЕЧАНИЕ:
Этот драйвер предназначен для совместимости с системами, в которых отсутствует надлежащий OpenGL.
водители.

предпочитать-растягивать
Используйте IDirect3DDevice9 :: StretchRect по возможности, по сравнению с другими методами.

отключить-растягивать
Никогда не рендеринг видео с использованием IDirect3DDevice9 :: StretchRect.

отключить текстуры
Никогда не выполняйте рендеринг видео с использованием рендеринга текстур D3D. Рендеринг с текстурами
+ шейдер по-прежнему будет разрешен. Добавлять отключить шейдеры полностью отключить
рендеринг видео с текстурами.

отключить шейдеры
Никогда не используйте шейдеры при рендеринге видео.

только-8bit
Никогда не визуализируйте видео YUV с более чем 8 битами на компонент. Использование этого флага
приведет к преобразованию программного обеспечения в 8-битное.

отключить выравнивание текстуры
Обычно размеры текстуры всегда равны 16. Если этот параметр включен,
видео текстура всегда будет иметь тот же размер, что и видео
себя.

Варианты отладки. Они могут быть неправильными, могут быть удалены в будущем, могут
сбой, может вызвать замедление и т. д. Свяжитесь с разработчиками, если вам действительно нужны
из них для производительности или правильной работы.

сила-сила-2
Всегда устанавливайте текстуры в степень 2, даже если устройство сообщает
поддерживаемые размеры текстур не равные степени 2.

текстура-память =
Влияет только на работу с включенными шейдерами / текстурированием и (E) OSD. Возможный
ценности:

по умолчанию (По умолчанию)
Используйте D3DPOOL_DEFAULT, С D3DPOOL_SYSTEMMEM текстура для блокировки. Если
драйвер поддерживает D3DDEVCAPS_TEXTURESYSTEMMEMORY, D3DPOOL_SYSTEMMEM
используется напрямую.

пул по умолчанию
Используйте D3DPOOL_DEFAULT. (Нравится по умолчанию, но никогда не используйте теневую текстуру.)

тень пула по умолчанию
Используйте D3DPOOL_DEFAULT, С D3DPOOL_SYSTEMMEM текстура для блокировки.
(Подобно по умолчанию, но всегда форсируйте теневую текстуру.)

управляемого
Используйте D3DPOOL_MANAGED.

поцарапать
Используйте D3DPOOL_SCRATCH, С D3DPOOL_SYSTEMMEM текстура для блокировки.

обменять-отбросить
Используйте D3DSWAPEFFECT_DISCARD, который может быть быстрее. Может быть и медленнее, так как
он должен (?) очищать каждый кадр.

точный буфер
Всегда изменяйте размер заднего буфера до размера окна.

direct3d (Windows только)
Такой же как Direct3d_shaders, но с опциями отключить текстуры и отключить шейдеры
принужденный.

ПРИМЕЧАНИЕ:
Этот драйвер предназначен для совместимости со старыми системами.

OpenGL Драйвер вывода видео OpenGL. Он поддерживает расширенные методы масштабирования, дизеринг и
Управление цветом.

По умолчанию он пытается использовать быстрые и надежные настройки. Используйте псевдоним opengl-hq в
используйте этот драйвер с настройками по умолчанию для высококачественного рендеринга.

Требуется как минимум OpenGL 2.1.

Некоторые функции доступны только с графическими драйверами с поддержкой OpenGL 3 (или если
имеются необходимые расширения).

Также поддерживаются OpenGL ES 2.0 и 3.0.

Аппаратное декодирование через OpenGL-interop в некоторой степени поддерживается. Обратите внимание, что в
В этом режиме некоторые угловые случаи могут быть обработаны некорректно, а цветовое пространство
преобразование и повышающая дискретизация цветности обычно находятся в руках аппаратного декодера
API-интерфейсы.

OpenGL по умолчанию использует FBO. Иногда можно добиться лучшего качества или
производительность путем изменения fbo-формат подопция к rgb16f, rgb32f or RGB, Известный
проблемы включают Mesa / Intel не принимают RGB16, Меса иногда не компилируется
с поддержкой текстуры с плавающей запятой, а некоторые установки OS X очень медленные с RGB16 но
быстро с rgb32f. Если у вас возникли проблемы, вы также можете попробовать пройти тупой режим = да
подвариант.

тупой режим =
Этот режим чрезвычайно ограничен и отключит большинство расширенных OpenGL.
Особенности. Это включает в себя высококачественные средства масштабирования и настраиваемые шейдеры!

Он предназначен для оборудования, которое не поддерживает FBO (включая GLES,
который поддерживает его в недостаточной степени), или чтобы получить больше производительности от
плохое или старое оборудование.

Этот режим включается автоматически при необходимости, и этот параметр в основном
полезно для отладки. Он также включается автоматически, если ничего не использует
функции, требующие FBO.

В будущем этот параметр может быть автоматически удален.

масштаб =

билинейной
Билинейная аппаратная фильтрация текстур (самая быстрая, очень низкое качество). Это
значение по умолчанию из соображений совместимости.

шлиц36
Среднее качество и скорость. Это значение по умолчанию при использовании opengl-hq.

Lanczos
Шкала Ланцоша. Обеспечивает среднее качество и скорость. Вообще хуже чем
шлиц36, но в результате получается немного более резкое изображение, что хорошо для
некоторые типы контента. Количество нажатий можно регулировать с помощью
масштаб-радиус, но лучше оставить без изменений.

Этот фильтр соответствует старому ланцош3 псевдоним, если радиус по умолчанию
используется, в то время как ланцош2 соответствует радиусу 2.

(Этот фильтр является псевдонимом для синк-windowed синк)

ева_ланчос
Эллиптическое средневзвешенное масштабирование Ланцоша. Также известен как Jinc.
Сравнительно медленно, но очень хорошего качества. Радиус можно регулировать с помощью
масштаб-радиус. Увеличение радиуса делает фильтр более резким, но добавляет
более звонкий.

(Этот фильтр является псевдонимом для джин-windowed джин)

ewa_lanczossharp
Слегка заостренная версия ewa_lanczos, предварительно настроенная для использования
идеальный радиус и параметр. Если ваше оборудование может его запустить, вероятно, это
что вы должны использовать по умолчанию.

Митчелл
Митчелл-Нетравали. В B и C параметры могут быть установлены с помощью масштаб-парам1
и масштаб-парам2. Этот фильтр очень хорош при уменьшении масштаба (см. масштаб).

избыточная выборка
Версия ближайшего соседа, которая (наивно) передискретизирует пиксели, так что
перекрывающиеся края пикселей интерполируются линейно, а не округляются.
Это существенно удаляет мелкие дефекты и артефакты дрожания.
вызванный интерполяцией ближайшего соседа, в обмен на добавление некоторого
размытие. Этот фильтр хорош для временной интерполяции и также известен как
"плавное движение" (см. масштаб).

изготовленный на заказ Пользовательский настраиваемый шейдер (см. масштабный шейдер).

Есть еще несколько фильтров, но большинство из них не так полезны. Для полного списка,
pass помощь как значение, например:

mpv --vo = opengl: scale = help

масштаб-параметр1 = , масштаб-параметр2 =
Установите параметры фильтра. Игнорируется, если фильтр не настраивается. В настоящее время,
это влияет на следующие параметры фильтра:

bcspline
Параметры сплайна (B и C). По умолчанию для обоих установлено значение 0.5.

гауссово
Параметр масштаба (t). Увеличение делает результат более размытым.
По умолчанию 1.

избыточная выборка
Минимальное расстояние до кромки до использования интерполяции. Параметр
это значение 0 всегда будет интерполировать края, тогда как установка его на 0.5
никогда не будет интерполировать, таким образом ведя себя так, как если бы обычный ближайший
был использован алгоритм соседа. По умолчанию 0.0.

масштаб-размытие =
Коэффициент масштабирования ядра (также известный как коэффициент размытия). Уменьшение этого делает
результат резче, увеличение делает его более размытым (по умолчанию 0). Если установлено на
0 используется предпочтительный для ядра коэффициент размытия. Обратите внимание, что установка этого тоже
низкий (например, 0.5) приводит к плохим результатам. Обычно рекомендуется придерживаться
значения от 0.8 до 1.2.

масштаб-радиус =
Радиус установки для фильтров, перечисленных ниже, должен быть числом с плавающей запятой от 0.5 до
16.0. По умолчанию используется предпочтительный радиус фильтра, если он не указан.
синк и производные, джин и производные, гауссово, ящик и треугольник

Обратите внимание, что в зависимости от деталей реализации фильтра и масштабирования видео
соотношение, фактически используемый радиус может быть другим (скорее всего
немного увеличивается).

масштаб-антикольцо =
Установите силу подавления помех. Это пытается устранить звон, но может
ввести в процесс другие артефакты. Должно быть число с плавающей запятой от 0.0.
и 1.0. Значение по умолчанию 0.0 полностью отключает защиту от шума.

Учтите, что это не влияет на специальные фильтры. билинейной и bicubic_fast.

масштаб окна =
(Только для опытных пользователей) Выберите настраиваемую оконную функцию для ядра.
Если не задано, по умолчанию используется предпочтительное окно фильтра. Использовать масштаб окна = справка в
получить список поддерживаемых оконных функций.

масштаб-wparam =
(Только для опытных пользователей) Настройте параметр для данной функции окна.
by масштабное окно. Игнорируется, если окно не настраивается. В настоящее время это
влияет на следующие параметры окна:

кайзер Параметр окна (альфа). По умолчанию 6.33.

Blackman
Параметр окна (альфа). По умолчанию 0.16.

гауссово
Масштабный параметр (t). Увеличение делает окно шире.
По умолчанию 1.

scaler-lut-size = <4..10>
Установите размер текстуры поиска для ядер масштабатора (по умолчанию: 6). В
фактический размер текстуры 2 ^ N для стоимости опциона N. Итак, поиск
текстура с настройкой по умолчанию использует 64 сэмпла.

Все веса билинейно интерполируются из этих выборок, поэтому увеличение
размер таблицы поиска может повысить точность масштабатора.

масштабирование только изменение размера
Отключите средство масштабирования, если размер видеоизображения не изменился. В этом случае, билинейной
вместо этого используется то, что установлено с лестница. Билинейно воспроизведет
исходное изображение идеально, если не выполняется масштабирование. Обратите внимание, что эта опция
никогда не влияет cscale.

ПБО Разрешить использование PBO. Это немного быстрее, но иногда может привести к
спорадическое и временное повреждение изображения (теоретически, потому что повторная загрузка не
повторяется, когда он терпит неудачу), и, возможно, фактически запускает более медленные пути с
драйверы, которые не поддерживают PBO должным образом.

глубина дизеринга =
Установите целевую глубину дизеринга на N. По умолчанию: нет.

нет Отключите дизеринг, сделанный mpv.

автоматический Автоматический выбор. Если выходная битовая глубина не может быть определена, 8 бит
на компонент.

8 Дизеринг до 8-битного вывода.

Обратите внимание, что глубина подключенного устройства отображения видео не может быть
обнаружен. Часто ЖК-панели создают дизеринг самостоятельно, что противоречит
OpenGLдизеринг и приводит к некрасивому результату.

размер-фрукт = <2-8>
Установите размер матрицы дизеринга (по умолчанию: 6). Фактический размер
матрица (2 ^ N) x (2 ^ N) для стоимости опциона N, поэтому значение 6 дает
размер 64x64. Матрица создается во время запуска, а большая матрица
вычисление может занять довольно много времени (секунды).

Используется в дизеринг = фрукты только режим.

дизеринг =
Выберите алгоритм дизеринга (по умолчанию: фруктовый). (Обычно глубина дизеринга
опция определяет, включен ли дизеринг.)

темпоральный дизеринг
Включить временное сглаживание. (Активен, только если дизеринг включен в целом.)
Это переключает между 8 различными шаблонами дизеринга на каждом кадре, изменяя
ориентация мозаичной матрицы дизеринга. К сожалению, это может привести
мигать на ЖК-дисплеях, так как они имеют большое время реакции.

временной-период-дизеринга = <1-128>
Определяет, как часто шаблон дизеринга обновляется, когда темпоральный дизеринг
уже используется. 1 (по умолчанию) будет обновляться на каждом кадре видео, 2 на каждом
другая рама и т. д.

отлаживать Проверьте наличие ошибок OpenGL, т.е. вызовите glGetError (). Также запросите отладку OpenGL
контекст (который ничего не делает с текущими графическими драйверами на данный момент
письмо).

интерполяция
Уменьшите заикание, вызванное несоответствием частоты кадров видео и обновления дисплея
скорость (также известная как дрожание).

ПРЕДУПРЕЖДЕНИЕ:
Для этого необходимо установить --видео-синхронизация вариант к одному из дисплей
режимах, иначе он будет отключен без уведомления. Этого не требовалось до mpv.
0.14.0. Воспользуйтесь функционалом

По сути, это попытка интерполировать отсутствующие кадры путем свертывания
видео по временной оси. Используемый фильтр можно контролировать с помощью
масштаб установка.

Обратите внимание, что это зависит от vsync для работы, см. интервал обмена для большего
Информация.

swapinterval =
Интервал в отображаемых кадрах между двумя заменами буфера. 1 эквивалентен
включить VSYNC, 0 - отключить VSYNC. По умолчанию 1, если не указано.

Обратите внимание, что это зависит от правильной поддержки OpenGL vsync. На некоторых платформах и
драйверов, это работает надежно только в полноэкранном режиме. Это может также
требуются специальные хаки для драйвера при использовании нескольких мониторов, чтобы обеспечить mpv
синхронизируется с правым. Составление оконных менеджеров также может привести к плохому
результаты, а также может отсутствовать или неверно отображать информацию о FPS (см.
--display-fps).

dscale =
Подобно лестница, но вместо этого примените эти фильтры при уменьшении масштаба. Если этот вариант
не установлен, фильтр подразумевается лестница будет применяться.

cscale =
As лестница, но для интерполяции информации цветности. Если изображение не
subampled, этот параметр полностью игнорируется.

tscale =
Фильтр, используемый для интерполяции временной оси (кадров). Это только
используется, если интерполяция включен. Единственный допустимый выбор для масштаб
разделяемые фильтры свертки (используйте tscale = помощь получить список). По умолчанию
is Митчелл.

Обратите внимание, что максимальный поддерживаемый радиус фильтра в настоящее время составляет 3 из-за
ограничение количества загружаемых видеотекстур
одновременно.

шкала-зажим
Зажмите масштаб диапазон значений ядра фильтра до [0-1]. Это снижает
чрезмерные звонкие артефакты во временной области (которые обычно проявляются
сами по себе как короткие вспышки или полосы черного цвета, в основном вокруг движущихся краев)
в обмен на возможное добавление размытия.

dscale-радиус, cscale-радиус, tscale-радиус, и так далее
Установите параметры фильтра для масштаб, cscale и масштаб, Соответственно.

См. Соответствующие параметры для лестница.

линейное масштабирование
Масштаб в линейном свете. Его следует использовать только с fbo-формат что есть на
минимум 16-битной точности.

правильное уменьшение
При использовании фильтров на основе свертки увеличивайте размер фильтра, когда
уменьшение масштаба. Повышает качество, но снижает производительность при уменьшении масштаба.

Это будет работать несколько неоптимально для анаморфного видео (но все же
лучше, чем без него), так как он увеличит размер, чтобы соответствовать только
более мягкий масштабный коэффициент между осями.

предварительная шкала =
Эта опция предоставляет фильтры без свертки для апскейлинга. Эти
фильтры изменяют размер видео до кратного исходного размера (все в настоящее время
поддерживаемые предделители могут выполнять дублирование изображения только за один проход).
Как правило, будет применяться другой фильтр на основе свертки (основной масштабатор).
после предделителя, чтобы он соответствовал целевому размеру дисплея.

нет Отключите все предделители. Это значение по умолчанию.

суперxbr
Относительно быстрый прескалер, изначально разработанный для пиксельной графики.

Некоторые параметры можно настроить с помощью сверхвысокая резкость и
superxbr-край-прочность настройки.

ннеди3 Деинтерлейсер на основе искусственной нейронной сети, который можно использовать для
высококлассные изображения.

Чрезвычайно медленный и требует недавней видеокарты среднего или высокого класса для
работают бесперебойно (по состоянию на 2015 год).

Обратите внимание, что все вышеперечисленные фильтры предназначены (или реализованы) для обработки
только плоскость яркости и, вероятно, не будет работать так, как предполагалось для видео в формате RGB.

prescale-Pass = <1..5>
Количество проходов для применения предварительного делителя (по умолчанию 1). Установка его
to 2 выполнит 4-кратное масштабирование.

prescale-downscaling-threshold = <0..32>
Эта опция предотвращает чрезмерное использование предделителей, которое может быть вызвано
неправильная конфигурация или пользователь пытается воспроизвести видео гораздо большего размера. С участием
этот параметр, пользователь может указать максимально допустимый коэффициент масштабирования в обоих
измерение. Для этого количество проходов для предварительного делителя частоты будет
уменьшен, а при необходимости также можно отключить предварительный делитель.

Значение по умолчанию - 2.0, и оно должно быть в состоянии предотвратить большинство, казалось бы,
необоснованное использование предделителей. Большинство пользователей, вероятно, захотят установить его на
меньшее значение от 1.0 до 1.5 для лучшей производительности.

Значение меньше 1.0 отключит проверку.

nnedi3-neurons=<16|32|64|128>
Укажите нейроны для предварительного масштабирования nnedi3 (по умолчанию 32). Рендеринг
ожидается, что время будет линейно пропорционально количеству нейронов.

nnedi3-window=<8x4|8x6>
Укажите размер локального окна для выборки при предварительном масштабировании nnedi3 (по умолчанию
быть 8x4). 8x6 Окно дает более четкие изображения, но работает медленнее.

nnedi3-upload =
Укажите, как загружать веса NN в GPU. В зависимости от видеокарты,
драйвер, компилятор шейдера и настройки nnedi3, оба метода могут быть быстрее или
помедленнее.

убо Загрузите эти веса через однородные буферные объекты. Это значение по умолчанию.
(требуется OpenGL 3.1 / GLES 3.0)

шейдеров Жестко закодируйте все веса в исходный код шейдера. (требует
OpenGL 3.3/ГЛЕС 3.0)

предварительные шейдеры = , пост-шейдеры = , масштаб-шейдер =
Пользовательские шейдеры фрагментов GLSL.

пре-шейдеры (список)
Они применяются после преобразования в RGB и до линеаризации.
и апскейлинг. Работает с нелинейным RGB (как вход). Это
лучшее место для установки таких вещей, как фильтры резкости.

масштабный шейдер
Это используется вместо scale / cscale, когда для этих параметров установлено значение
изготовленный на заказ. Цветовое пространство, в котором он работает, зависит от значений
линейное масштабирование и сигмовидное апскейлинг, поэтому никаких предположений быть не должно.
сделано здесь.

пост-шейдеры (список)
Они применяются после масштабирования и смешивания субтитров (когда
смесь субтитров включен), но до управления цветом. Работает
на линейном RGB, если линейное масштабирование действует, иначе нелинейный
RGB. Это лучшее место для преобразований цветового пространства (например,
отображение насыщенности).

Эти файлы должны определять функцию со следующей подписью:

Пример vec4 (sampler2D tex, vec2 pos, vec2 tex_size)

Значения параметров следующие:

сэмплер2D текс
Исходная текстура для шейдера.

век2 пост
Позиция для выборки в координатном пространстве [0-1].

век2 tex_size
Размер текстуры в пикселях. Это может отличаться от image_size,
например. для субдискретизированного контента или для пост-шейдеров.

В дополнение к этим параметрам, следующие униформы также являются глобально
доступны:

плавать случайный
Случайное число в диапазоне [0–1], различное для каждого кадра.

Int рама
Простое количество отрисованных кадров, увеличивается на один за кадр и
никогда не сбрасывается (независимо от поиска).

век2 Размер изображения
Размер входного изображения в пикселях.

Например, шейдер, инвертирующий цвета, может выглядеть так:

Пример vec4 (sampler2D tex, vec2 pos, vec2 tex_size)
{
vec4 color = texture (tex, pos);
вернуть vec4 (1.0 - color.rgb, color.a);
}

дебанд Включите алгоритм отладки. Это значительно уменьшает количество видимых
полосатость, блокировка и другие артефакты квантования по очень высокой цене.
слегка размывая некоторые из мельчайших деталей. На практике это практически
всегда улучшение - единственная причина отключить его - это
производительность.

deband-iterations = <1..16>
Количество шагов по удалению бандажа, которые необходимо выполнить для каждого образца. Каждый шаг немного сокращается
больше полос, но требуется время, чтобы вычислить. Обратите внимание, что сила каждого шага
отваливается очень быстро, поэтому большие числа (> 4) практически бесполезны.
(По умолчанию 1)

deband-threshold = <0..4096>
Порог отсечки дебандангового фильтра. Более высокие числа увеличивают
уменьшение силы резкости, но постепенное уменьшение деталей изображения.
(По умолчанию 64)

диапазон-дебанд = <1..64>
Начальный радиус фильтра дебандинга. Радиус линейно увеличивается при
каждая итерация. Чем выше радиус, тем больше градиентов, но с меньшим радиусом.
сгладит более агрессивно. (По умолчанию 16)

Если вы увеличите deband-итерации, вам, вероятно, следует уменьшить это значение до
компенсировать.

deband-зерно = <0..4096>
Добавьте дополнительный шум к изображению. Это значительно помогает скрыть
оставшиеся артефакты квантования. Чем больше число, тем больше шума. (Дефолт
48)

сигмовидное апскейлинг
При апскейлинге используйте сигмоидальное преобразование цвета, чтобы избежать выделения звона.
артефакты. Это также подразумевает линейное масштабирование.

сигмовидный центр
Центр сигмовидной кривой, используемой для сигмовидное апскейлинг, должно быть плавающее
от 0.0 до 1.0. Если не указано иное, значение по умолчанию - 0.75.

сигмовидный наклон
Наклон сигмовидной кривой, используемой для сигмовидное апскейлинг, должно быть плавающее
от 1.0 до 20.0. Если не указано иное, значение по умолчанию - 6.5.

резкость =
Если установлено значение, отличное от 0, включите нерезкий маскирующий фильтр. Положительный
значения сделают изображение более резким (но добавят больше звона и сглаживания). Отрицательный
значения будут размывать изображение. Если ваш графический процессор достаточно мощный, подумайте о
альтернативы, такие как ewa_lanczossharp масштабный фильтр или масштабное размытие
подвариант.

(Эта функция является заменой старого точить3 и точить5 скалеры.)

глфиниш
Позвонить glFinish () до и после замены буферов (по умолчанию: отключено).
Медленнее, но может помочь получить лучшие результаты при кадрировании. Может
полностью испортить производительность. Детали полностью зависят от OpenGL.
Водитель.

ожиданиеvsync
Позвонить glXWaitVideoSyncSGI после каждой подкачки буфера (по умолчанию: отключено). Этот
может помочь или не помочь с точностью синхронизации видео и падением кадров. Возможно
что это замедляет вывод видео или не оказывает никакого влияния.

Только X11 / GLX.

vsync-fences =
Синхронизируйте ЦП с N-м прошедшим кадром, используя GL_ARB_sync расширение. А
значение 0 отключает это поведение (по умолчанию). Значение 1 означает, что
синхронизировать с текущим кадром после его рендеринга. Нравится глфиниш и
ожиданиеvsync, это может снизить или испортить производительность. Его преимущество в том, что он может
охватывают несколько кадров и эффективно ограничивают количество кадров графического процессора
очереди впереди (что также влияет на vsync).

dwmflush =
Объявления ДвмФлеш после замены буферов в Windows (по умолчанию: авто). Это также
Наборы Интервал свопа(0) игнорировать время OpenGL. Значения: нет (отключено),
оконный (только в оконном режиме), да (также в полноэкранном режиме).

Значение автоматический попытается определить, активен ли наборщик, и
призывы ДвмФлеш только если кажется.

Это может помочь получить более постоянные интервалы между кадрами, особенно с
клипы с высокой частотой кадров - что также может уменьшить количество пропущенных кадров. Обычно значение
of оконная должно быть достаточно, так как полный экран может обойти DWM.

Только Windows.

sw Продолжить, даже если обнаружен программный рендерер.

backend =
Значение автоматический (по умолчанию) выбирает серверную часть окон. Вы также можете
pass помощь чтобы получить полный список скомпилированных в бэкэндах (отсортированных по
заказ автопробега).

автоматический автоматический выбор (по умолчанию)

какао Какао / OS X

выиграть Win32 / WGL

угол Direct3D11 через уровень трансляции OpenGL ES ANGLE. Этот
поддерживает почти все выиграть бэкэнд, кроме профилей ICC,
видеовход с высокой битовой глубиной и ннеди3 предварительный делитель.

dxinterop (Экспериментальный)
Win32, использующий WGL для рендеринга и Direct3D 9Ex для презентации.
Работает только на Nvidia и AMD.

x11 X11 / GLX

Wayland
Wayland / EGL

дрм-эгл
DRM / EGL

x11egl X11 / EGL

es =
Выберите, использовать ли GLES:

Да Попробуйте предпочесть ES над Desktop GL

нет Попробуйте предпочесть настольный GL вместо ES

автоматический Использовать значение по умолчанию для каждой серверной части (по умолчанию)

fbo-format =
Выбирает внутренний формат текстур, используемых для FBO. Формат может
влияют на производительность и качество вывода видео. FMT может быть одним из:
RGB, RGBB, RGB8, RGB10, RGB10_A2, RGB16, RGB16F, RGB32F, RGBBA12, RGBBA16,
rgba16f, rgba32f. Дефолт: автоматический, который сопоставляется с rgba16 на настольном GL, и
rgb10_a2 на GLES (например, ANGLE).

гамма = <0.1..2.0>
Установите значение гаммы (по умолчанию: 1.0). Если гамма регулируется другими способами (например,
с --гамма опции или привязки клавиш и гамма свойство), значение
умножается на другое значение гаммы.

Рекомендуемые значения, основанные на яркости окружающей среды:

1.0 Ярко подсвечивается (по умолчанию)

0.9 Слегка тусклый

0.8 Черная комната

гамма-авто
Автоматически корректирует значение гаммы в зависимости от окружающего освещения
условия (добавление усиления гаммы для темных комнат).

При внешней освещенности 64 люкс mpv выберет значение гаммы 1.0 (нет
boost) и немного увеличьте усиление до 0.8 для 16lux.

ПРИМЕЧАНИЕ. Реализовано только в OS X.

target-prim =
Задает основные цвета дисплея. Цвета видео будут адаптированы к этому
цветовое пространство при необходимости. Допустимые значения:

автоматический Отключить любую адаптацию (по умолчанию)

бт.470м
МСЭ-R BT.470 M

бт.601-525
ITU-R BT.601 (системы SD с 525 строками, например, NTSC), SMPTE 170M / 240M

бт.601-625
ITU-R BT.601 (системы SD с 625 строками, например, PAL / SECAM), ITU-R BT.470 B / G

709 бат ITU-R BT.709 (HD), IEC 61966-2-4 (sRGB), SMPTE RP177, приложение B

2020 бат
МСЭ-R BT.2020 (UHD)

яблоко Яблоко RGB

саман AdobeRGB (1998)

Prophoto
ProPhoto RGB (ПЗУ)

cie1931
CIE 1931 RGB (не путать с CIE XYZ)

цель-trc =
Определяет передаточные характеристики (гамму) дисплея. Цвета видео
будет настроен на эту кривую. Допустимые значения:

автоматический Отключить любую адаптацию (по умолчанию)

1886 бат
Кривая ITU-R BT.1886, без падения яркости (прибл. 1.961)

srgb МЭК 61966-2-4 (sRGB)

линейный Линейный световой поток

gamma1.8
Кривая чистой мощности (гамма 1.8), также используется для Apple RGB

gamma2.2
Кривая чистой мощности (гамма 2.2)

gamma2.8
Кривая чистой мощности (гамма 2.8), также используется для BT.470-BG

Prophoto
ProPhoto RGB (ПЗУ)

icc-profile =
Загрузите профиль ICC и используйте его для преобразования линейного RGB в вывод на экран.
Требуется поддержка LittleCMS 2, скомпилированная. Этот параметр отменяет
Target-Prim, цель-trc и icc-профиль-авто настройки.

icc-профиль-авто
Автоматически выбирать профиль отображения ICC, указанный в настоящее время
отображать настройки операционной системы.

ПРИМЕЧАНИЕ. В Windows профилем по умолчанию должен быть профиль ICC. Профили WCS
не поддерживаются.

icc-cache-dir =
Сохраните и загрузите 3D LUT, созданные из профиля ICC, в этом каталоге.
Это можно использовать для ускорения загрузки, так как LittleCMS 2 может занять некоторое время, чтобы
создать 3D LUT. Обратите внимание, что эти файлы содержат несжатые LUT. Их
размер зависит от 3длут-размер, и может быть очень большим.

ПРИМЕЧАНИЕ. Это не очищается автоматически, поэтому старые неиспользуемые файлы кэша могут
оставаться здесь до бесконечности.

icc-intent =
Задает намерение ICC, используемое для преобразования цвета (при использовании
icc-профиль).

0 перцепционный

1 относительный колориметрический (по умолчанию)

2 насыщение

3 абсолютный колориметрический

3dlut-size = Икс Икс
Размер 3D LUT, созданного из профиля ICC в каждом измерении.
По умолчанию 128x256x64. Размеры должны быть степенью двойки и не более 512.

blend-subtitles =
Наложение субтитров непосредственно на масштабированные видеокадры перед интерполяцией
и / или управление цветом (по умолчанию: нет). Включение этого параметра приводит к отображению субтитров.
зависит от icc-профиль, Target-Prim, цель-trc, интерполяция, гамма и
пост-шейдер. Это также увеличивает производительность субтитров при использовании
интерполяция.

Обратной стороной включения этого режима является то, что он ограничивает субтитры видимыми
часть видео, поэтому у вас не может быть субтитров на черных полях
под видео (например).

If XNUMX году выбрано, поведение аналогично Да, но подпрограммы отрисовываются в
собственное разрешение видео и масштабируется вместе с видео.

ПРЕДУПРЕЖДЕНИЕ:
Это меняет способ обработки цветов субтитров. Обычно субтитры
предполагается, что цвета находятся в формате sRGB, и управление цветом осуществляется соответствующим образом. Включение этого
вместо этого обрабатывает их как находящиеся в цветовом пространстве видео. Это
хорошо, если вы хотите, чтобы такие вещи, как знаки задницы с мягкой подкладкой, соответствовали видео
цвета, но может привести к тому, что субтитры SRT или что-то подобное будут выглядеть немного неаккуратно.

альфа =
Решает, что делать, если на входе есть альфа-компонент (по умолчанию: blend).

бленд или сингл ориджин Растушуйте рамку на черном фоне.

Да Попробуйте создать фреймбуфер с альфа-компонентом. Это только делает
смысл, если видео содержит альфа-информацию (что чрезвычайно
редкий). Может поддерживаться не на всех платформах. Если альфа-кадры
недоступны, он молча возвращается к обычному буферу кадра. Примечание
что если вы установите fbo-формат параметр на значение, отличное от значения по умолчанию,
должен быть указан формат с альфа-каналом, иначе это не сработает.

нет Игнорировать альфа-компонент.

прямоугольные текстуры
Принудительное использование прямоугольных текстур (по умолчанию: нет). Обычно этого не должно быть
никаких преимуществ перед обычными текстурами. Обратите внимание, что аппаратное декодирование отменяет
этот флаг.

фон =
Цвет, используемый для рисования частей окна mpv, не покрываемых видео. Видеть
--osd-цвет вариант, как определяются цвета.

opengl-hq
Такой же как OpenGL, но с настройками по умолчанию для высококачественного рендеринга.

Это эквивалентно:

--vo = opengl: scale = spline36: cscale = spline36: dscale = mitchell: dither-depth = auto: right-downscaling: sigmoid-upscaling: pbo: deband: es = no

Обратите внимание, что некоторые более дешевые ЖК-дисплеи имеют дизеринг, который серьезно мешает OpenGL's
дизеринг. Отключение дизеринга с помощью dither-depth = нет pomaga.

СДЛ Драйвер вывода видео SDL 2.0+ Render, в зависимости от системы с оборудованием или без него
ускорение. Должен работать на всех платформах, поддерживаемых SDL 2.0. Для настройки см.
к вашей копии файла SDL_hints.h.

ПРИМЕЧАНИЕ:
Этот драйвер предназначен для совместимости с системами, которые не предоставляют надлежащую графику.
драйверы, или которые поддерживают только GLES.

sw Продолжить, даже если обнаружен программный рендерер.

режим переключения
Укажите SDL переключить видеорежим монитора при переходе в полноэкранный режим.

ваапи Драйвер вывода видео Intel VA API с поддержкой аппаратного декодирования. Обратите внимание, что
нет абсолютно никаких причин использовать это, кроме желания использовать оборудование
декодирование для экономии энергии на ноутбуках или, возможно, предотвращение разрыва видео с некоторыми
расстановок.

ПРИМЕЧАНИЕ:
Этот драйвер предназначен для совместимости с дрянными системами. Вы можете использовать оборудование vaapi
декодирование с помощью --vo = opengl тоже.

масштабирование =

по умолчанию
Драйвер по умолчанию (также по умолчанию mpv).

быстро Быстро, но некачественно.

hq Неуказанный драйвер зависит от высококачественного масштабирования, медленно.

NLA нелинейный анаморфотная масштабирование

deint-mode =
Выберите алгоритм деинтерлейсинга. Обратите внимание, что по умолчанию деинтерлейсинг
изначально всегда выключен, и его необходимо включить с помощью d ключ (ключ по умолчанию
обязательный для цикл деинтерлейсинг).

Этот параметр не применяется, если libva поддерживает постобработку видео (vpp). В
этом случае по умолчанию для режим деинтирования is нети включение деинтерлейсинга через
взаимодействие с пользователем с использованием упомянутых выше методов фактически вставляет
вавпп видео фильтр. Если vpp на самом деле не поддерживается серверной частью libva
при использовании вы можете использовать эту опцию, чтобы принудительно включить деинтерлейсинг на основе VO.

нет Не разрешать деинтерлейсинг (по умолчанию для новых libva).

первое поле
Показать только первое поле (переходя --поле-доминирование).

зерно bob деинтерлейсинг (по умолчанию для старых libva).

масштабируемый OSD =
Если включено, экранное меню отображается с разрешением видео и масштабируется до
разрешение экрана. По умолчанию это отключено, и экранное меню отображается в
разрешение экрана, если драйвер его поддерживает.

нуль Видео не выводится. Полезно для сравнительного анализа.

Обычно лучше отключить видео с помощью --нет видео .

fps =
Имитация отображения FPS. Это искусственно ограничивает количество кадров ВО
принимает в секунду.

Caca Драйвер вывода цветного изображения ASCII art, работающий на текстовой консоли.

ПРИМЕЧАНИЕ:
Этот водитель - шутка.

изображение Вывод каждого кадра в файл изображения в текущем каталоге. Каждый файл занимает
номер кадра, дополненный ведущими нулями в качестве имени.

формат=
Выберите формат файла изображения.

JPG Файлы JPEG, расширение .jpg. (Дефолт.)

JPEG Файлы JPEG, расширение .jpeg.

PNG PNG файлы.

частей на миллион Портативный растровый формат.

МПГ Портативный формат серой карты.

пгмьюв Портативный формат карты серого с использованием формата пикселей YV12.

TGA Truevision ТГА.

png-сжатие = <0-9>
Коэффициент сжатия PNG (компромисс скорости и размера файла) (по умолчанию: 7)

png-фильтр=<0-5>
Фильтр, примененный перед сжатием PNG (0 = нет; 1 = подчиненный; 2 = верхний; 3 =
средний; 4 = Паэт; 5 = смешанный) (по умолчанию: 5)

jpeg-качество=<0-100>
Коэффициент качества JPEG (по умолчанию: 90)

(нет-)jpeg-прогрессивный
Укажите стандартный или прогрессивный JPEG (по умолчанию: нет).

(нет-)jpeg-базовый уровень
Укажите использование базовой линии JPEG или нет (по умолчанию: да).

jpeg-оптимизировать=<0-100>
Коэффициент оптимизации JPEG (по умолчанию: 100)

jpeg-гладкий=<0-100>
коэффициент плавности (по умолчанию: 0)

jpeg-dpi=<1->
JPEG DPI (по умолчанию: 72)

outdir =
Укажите каталог для сохранения файлов изображений (по умолчанию: ./).

Wayland (Вэйланд только)
Видеовыход с общей памятью Wayland в качестве запасного варианта для OpenGL.

ПРИМЕЧАНИЕ:
Этот драйвер предназначен для совместимости с системами, не поддерживающими работающий OpenGL.
водители.

альфа Используйте формат буфера, который поддерживает видео и изображения с альфа-информацией

RGB565 Используйте RGB565 в качестве формата буфера. Этот формат реализован на большинстве платформ,
особенно на встроенных, где он намного эффективнее, чем RGB8888.

тройная буферизация
Используйте 3 буфера вместо 2. Это может привести к более плавному воспроизведению, но использует
больше памяти.

opengl-cb
Для использования с libmpv для прямого встраивания OpenGL; бесполезна в любых других контекстах. (Видеть
.)

Это также поддерживает многие из подопций OpenGL ВО есть. Бегать MPV
--vo=opengl-cb:помощь для списка.

Это также поддерживает vo_cmdline команда.

RPI (Малина Число Пи)
Собственный видеовыход на Raspberry Pi с использованием MMAL API.

дисплей =
Выберите номер дисплея, на котором должно отображаться наложение видео.
(по умолчанию: 0).

слой=
Выберите слой dispmanx, на котором должно отображаться наложение видео.
(по умолчанию: -10). Обратите внимание, что mpv также будет использовать 2 слоя над выбранным
слой для обработки фона окна и экранного меню. Фактический рендеринг видео будет
происходит на слое над выбранным слоем.

фон =
Отображать ли черный фон позади видео (по умолчанию: нет).
Обычно вместо этого лучше убить фреймбуфер консоли, что дает
лучшая производительность.

OSD=
Включено по умолчанию. Если отключено с нет, уровень OSD не создается. Это также
означает, что субтитры отображаться не будут.

DRM (Прямой Рендеринг Менеджер)
Драйвер вывода видео с помощью настройки режима ядра / диспетчера прямого рендеринга. Должен
использоваться, когда вы не хотите устанавливать полноценную графическую среду (например, нет
ИКС). Не поддерживает аппаратное ускорение (если вам это нужно, проверьте дрм-эгл
серверная часть для OpenGL В.О.).

соединитель =
Выберите используемый разъем (обычно это монитор). Если установлено значение -1, mpv
визуализирует вывод на первом доступном соединителе. (по умолчанию: -1)

devpath=
Путь к устройству с графической картой. (по умолчанию: /dev/dri/card0)

режим=
Идентификатор режима для использования (разрешение, битовая глубина и частота кадров). (по умолчанию: 0)

АУДИО ФИЛЬТРЫ

Аудио фильтры позволяют изменять аудиопоток и его свойства. Синтаксис:

--af =
Настройте цепочку звуковых фильтров.

ПРИМЕЧАНИЕ:
Чтобы получить полный список доступных аудиофильтров, см. --af=помощь.

Кроме того, имейте в виду, что наиболее актуальные фильтры доступны через лавфи обертка, которая
дает вам доступ к большинству фильтров libavfilter. Сюда входят все фильтры, которые
был перенесен с MPlayer на libavfilter.

Вы также можете установить значения по умолчанию для каждого фильтра. Значения по умолчанию применяются перед обычным
параметры фильтра.

--af-по умолчанию=
Установите значения по умолчанию для каждого фильтра.

Аудио фильтры управляются списками. Есть несколько команд для управления списком фильтров:

--af-добавить=
Добавляет фильтры, указанные в качестве аргументов, в список фильтров.

--af-пре=
Добавляет фильтры, указанные в качестве аргументов, к списку фильтров.

--af-дель=
Удаляет фильтры по указанным индексам. Номера индексов начинаются с 0, отрицательные
числа обращаются к концу списка (-1 - последний).

--af-clr
Полностью очищает список фильтров.

Доступные фильтры:

lavrresample[=опция1:опция2:...]
Этот фильтр использует libavresample (или libswresample, в зависимости от сборки) для изменения
частота дискретизации, формат выборки или расположение каналов аудиопотока. Этот фильтр
автоматически включается, если аудиовыход не поддерживает аудиоконфигурацию
воспроизводимого файла.

Он поддерживает только следующие образцы форматов: u8, s16, s32, float.

размер фильтра =
Длина фильтра по отношению к более низкой частоте дискретизации. (по умолчанию: 16)

фазовый сдвиг =
Log2 количества многофазных записей. (..., 10->1024, 11->2048, 12->4096,
...) (по умолчанию: 10-> 1024)

отсечка=
Частота среза (0.0-1.0), по умолчанию устанавливается в зависимости от длины фильтра.

линейный Если установлено, то фильтры будут линейно интерполироваться между многофазными записями.
(по умолчанию: нет)

неотсоединяемый
Не отсоединяйте, если входной и выходной аудиоформат/скорость/каналы совпадают. (Если ты
просто хочу установить значения по умолчанию для этого фильтра, которые будут использоваться даже
автоматически вставленные экземпляры lavrresample, вы должны предпочесть установку
их с --af-defaults=lavrresample:....)

нормализовать =
Следует ли нормализовать при повторном микшировании макетов каналов (по умолчанию: да). Это
например, применяется при микшировании окружающего звука в стерео. Преимущество в том, что
это гарантирует невозможность отсечения. К сожалению, это также может
привести к слишком низким уровням громкости. Независимо от того, включаете ли вы или отключаете это
в основном дело вкуса, но по умолчанию используется более безопасный вариант.

о =
Установите AVOptions в SwrContext или AVAudioResampleContext. Это должно быть
задокументировано FFmpeg или Libav.

lavcac3enc[=tospdif[:битрейт[:минч]]]
Кодируйте многоканальный звук в AC-3 во время выполнения с помощью libavcodec. Поддерживает 16 бит
формат ввода с прямым порядком байтов, максимум 6 каналов. Вывод будет прямым порядком байтов, когда
вывод необработанного потока AC-3, с собственным порядком байтов при выводе в S/PDIF. Если вход
частота дискретизации не 48 кГц, 44.1 кГц или 32 кГц, она будет передискретизирована до 48 кГц.

tospdif=
Выводить необработанный поток AC-3, если нет, вывод в S/PDIF для сквозной передачи, если Да
(по умолчанию).

битрейт =
Битрейт используется для потока AC-3. Установите его на 384, чтобы получить 384 кбит/с.

Значение по умолчанию — 640. Некоторые приемники могут не справиться с этим.

Допустимые значения: 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320,
384, 448, 512, 576, 640.

Особая ценность автоматический выбирает битрейт по умолчанию на основе входного канала
номер:

1ch 96

2ch 192

3ch 224

4ch 384

5ch 448

6ch 448

Минч =
Если номер входного канала меньше , фильтр отсоединится
сам (по умолчанию: 3).

эквалайзер=g1:g2:g3:...:g10
10-октавный графический эквалайзер, реализованный с использованием 10 полосовых БИХ-фильтров. Этот
означает, что он работает независимо от того, какой звук воспроизводится. В
центральные частоты для 10 полос:

┌────┬────────────┐
│Нет. │ частота │
├────┼────────────┤
│0 │ 31.25 Гц │
├────┼────────────┤
│1 │ 62.50 Гц │
├────┼────────────┤
│2 │ 125.00 Гц │
├────┼────────────┤
│3 │ 250.00 Гц │
├────┼────────────┤
│4 │ 500.00 Гц │
├────┼────────────┤
│5 │ 1.00 кГц │
├────┼────────────┤
│6 │ 2.00 кГц │
├────┼────────────┤
│7 │ 4.00 кГц │
├────┼────────────┤
│8 │ 8.00 кГц │
├────┼────────────┤
│9 │ 16.00 кГц │
└────┴────────────┘

Если частота дискретизации воспроизводимого звука ниже, чем центральная частота для
частотный диапазон, тогда этот диапазон будет отключен. Известная ошибка этого фильтра:
что характеристики для самой верхней полосы не полностью симметричны, если
частота дискретизации близка к центральной частоте этой полосы. Эта проблема может быть
обошлось путем повышения частоты дискретизации звука с помощью фильтра передискретизации до того, как он достигнет
этот фильтр.

: : : ...:
числа с плавающей запятой, представляющие усиление в дБ для каждой полосы частот
(-12-12)

Пример

MPV --af=equalizer=11:11:10:5:0:-12:0:5:12:12 медиа.avi
Усилит звук в верхней и нижней частотной области, пока
почти полностью отменяя его на частоте около 1 кГц.

каналы=нк[:маршруты]
Может использоваться для добавления, удаления, маршрутизации и копирования аудиоканалов. Если только
задан, используется маршрутизация по умолчанию. Это работает следующим образом: если число выходных
каналов больше, чем количество входных каналов, вставляются пустые каналы
(за исключением микширования из моно в стерео; тогда моноканал дублируется). Если
количество выходных каналов меньше количества входных каналов,
превышающие каналы обрезаются.

количество выходных каналов (1-8)


Список стран, , отдельные маршруты в виде от 1 до 1, от 2 до 2,.... Каждая пара
определяет, куда направить каждый канал. Маршрутов может быть не более 8. Без
этот аргумент, используется маршрутизация по умолчанию. С , также используется для разделения
фильтры, вы должны указать этот аргумент с [...] или подобный раздел.

Примеры

MPV --af=channels=4:[0-1,1-0,2-2,3-3] медиа.avi
Изменил бы количество каналов на 4 и настроил бы 4 маршрута, которые меняются местами
канал 0 и канал 1 и оставить каналы 2 и 3 нетронутыми. Обратите внимание, что
если воспроизводится носитель, содержащий два канала, каналы 2 и 3 будут
содержат тишину, но 0 и 1 все равно поменяются местами.

MPV --af=channels=6:[0-0,0-1,0-2,0-3] медиа.avi
Изменил бы количество каналов на 6 и настроил бы 4 маршрута, которые копируют
с канала 0 на каналы с 0 по 3. На каналах 4 и 5 будет тишина.

ПРИМЕЧАНИЕ:
Вероятно, вам не следует использовать этот фильтр. Если вы хотите изменить вывод
расположение каналов, попробуйте формат фильтр, который может автоматически поднимать и
стандартные макеты каналов с понижающим микшированием.

format=format:srate:каналы:out-format:out-srate:out-каналы
Сам не выполняет преобразование формата. Скорее, это может привести к тому, что система фильтрации
вставьте необходимые фильтры преобразования до или после этого фильтра, если это необходимо. это
в первую очередь полезно для управления аудиоформатом, поступающим в другие фильтры. К
указать формат аудиовыхода, см. --аудио-формат, --аудио-сэмплрейт и
--аудиоканалы. Этот фильтр может форсировать определенный формат, в то время как
--аудио-* может быть переопределен АО на основе совместимости вывода.

Все параметры являются необязательными. Первые 3 параметра ограничивают то, что фильтр
принимает на вход. Поэтому они вызовут вставку фильтров конверсии.
перед этим. То вне- параметры сообщают фильтрам или аудиовыходам следующие
этот фильтр, как интерпретировать данные без фактического преобразования. Параметр
они, вероятно, просто сломают вещи, если вы действительно не знаете, что хотите этого для некоторых
причине, такой как тестирование или работа с поврежденным носителем.


Принудительное преобразование в этот формат. Использовать --af=формат=формат=помощь получить список
допустимых форматов.


Принудительное преобразование к определенной частоте дискретизации. Ставка является целым числом, 48000
например.


Принудительное микширование к определенному расположению каналов. Видеть --аудиоканалы вариант для
возможные значения.







ЗАМЕТКА: этот фильтр раньше назывался сила, Старый формат фильтр раньше делал
само преобразование, в отличие от этого, которое позволяет системе фильтров обрабатывать
преобразование.

объем[= [:...]]
Реализует программную регулировку громкости. Используйте этот фильтр с осторожностью, так как он может
уменьшить отношение сигнал/шум звука. В большинстве случаев лучше использовать
Эталонный регулятор громкости вашей звуковой карты или регулятор громкости на вашем усилителе.

ЗАМЕТКА: этот фильтр не является реентерабельным и поэтому может быть включен только один раз для каждого
аудиопоток.


Устанавливает желаемое усиление в дБ для всех каналов в потоке от -200 дБ до
+60 дБ, где -200 дБ полностью отключает звук, а +60 дБ соответствует усилению
1000 (по умолчанию: 0).

replaygain-трек
Отрегулируйте усиление громкости в соответствии со значением усиления воспроизведения трека, сохраненным в
метаданные файла.

повторный альбом
Как replaygain-track, но вместо этого используется значение альбомного усиления.

replaygain-предусилитель
Усиление предварительного усиления в дБ для применения к выбранному усилению воспроизведения
(по умолчанию: 0).

replaygain-клип = да | нет
Предотвратите отсечение, вызванное усилением повторного воспроизведения, путем автоматического снижения усиления.
(дефолт). Использовать replaygain-клип = нет чтобы отключить это.

replaygain-резервный вариант
Усиление в дБ для применения, если в файле нет тегов усиления воспроизведения. Этот вариант
всегда применяется, если логика повторного воспроизведения почему-то неактивна. Если это
применяется, никакие другие параметры переигровки не применяются.

софтклип
Включает мягкое отсечение. Мягкое отсечение может сделать звук более гладким, если
используются высокие уровни громкости. Включите эту опцию, если динамический диапазон
динамики очень низкие.

ПРЕДУПРЕЖДЕНИЕ: эта функция создает искажения и ее следует рассматривать в последнюю очередь.
курорт.

s16 Принудительно использовать формат образца S16, если он установлен. Более низкое качество, но может быть быстрее в некоторых
ситуации.

DETACH Удалите фильтр, если громкость не изменилась во время настройки аудиофильтра.
Полезно с replaygain: если в текущем файле нет тегов replaygain, то
фильтр будет удален, если эта опция включена. (Если --softvol=да используется
и регуляторы громкости плеера используются во время воспроизведения, другая громкость
фильтр будет вставлен.)

Пример

MPV --af=объем=10.1 медиа.avi
Будет усиливать звук на 10.1 дБ и жестко обрезать, если уровень звука
слишком высоко.

панорамирование=н:[ ]
Произвольное микширование каналов. В основном комбинация громкости и каналов
фильтр, который можно использовать для понижающего микширования многих каналов в несколько, например, стерео в
моно или изменить «ширину» центрального динамика в системе объемного звучания. Этот
фильтр сложен в использовании и потребует некоторой доработки, прежде чем будет достигнут желаемый результат.
полученный. Количество опций для этого фильтра зависит от количества выходных
каналы. Пример того, как микшировать шестиканальный файл на два канала с помощью этого
фильтр можно найти в разделе примеров в конце.

Количество выходных каналов (1-8).


Список ценностей [L00,L01,L02,...,L10,L11,L12,...,Ln0,Ln1,Ln2,...], Где
каждый элемент Лидж означает, какая часть входного канала i смешивается с выходным
канал j (диапазон 0-1). Итак, в принципе у вас сначала есть n чисел, говорящих, что
сделать с первым входным каналом, затем n чисел, которые действуют на второй
входной канал и т. д. Если вы не укажете номера для некоторых входных
каналы, предполагается 0. Обратите внимание, что значения разделены ,, Которая является
уже используется синтаксическим анализатором параметров для разделения фильтров. Вот почему вы должны
процитировать список значений с [...] или подобный раздел.

Примеры

MPV --af=pan=1:[0.5,0.5] медиа.avi
Будет даунмикс из стерео в моно.

MPV --af=pan=3:[1,0,0.5,0,1,0.5] медиа.avi
Дает 3-канальный выход, оставляя каналы 0 и 1 нетронутыми, и смешивает
каналы 0 и 1 в выходной канал 2 (который может быть отправлен на
например сабвуфер).

ПРИМЕЧАНИЕ:
Если вы просто хотите принудительно выполнить повторное микширование для определенного макета выходного канала, это
легче использовать формат фильтр. Например, MPV '--af=format=каналы=5.1'
'--аудио-каналы = 5.1' всегда будет принудительно ремикшировать звук в 5.1 и выводить его
как это.

задержка[=[ch1,ch2,...]]
Задерживает звук до громкоговорителей таким образом, чтобы звук из разных
каналов поступает в позицию прослушивания одновременно. Это полезно, только если вы
иметь более 2 динамиков.

[ч1, ч2,...]
Задержка в мс, которая должна быть наложена на каждый канал (с плавающей запятой
число от 0 до 1000).

Чтобы рассчитать требуемую задержку для разных каналов, сделайте следующее:

1. Измерьте расстояние до громкоговорителей в метрах по отношению к вашему прослушиванию.
положение, давая вам расстояния от s1 до s5 (для системы 5.1). Здесь нет
точка в компенсации сабвуфера (разницы не услышишь
так или иначе).

2. Вычтите расстояния от s1 до s5 из максимального расстояния, т.е. s [i] = макс(ы) -
с [я]; i = 1 5 ....

3. Рассчитайте требуемые задержки в мс как д[я] = 1000*с[i]/342; i = 1 5 ....

Пример

MPV --af=задержка=[10.5,10.5,0,0,7,0] медиа.avi
Будет задерживать передние левый и правый каналы на 10.5 мс, два тыловых канала и
сабвуфер на 0 мс и центральный канал на 7 мс.

дрк[=метод:цель]
Применяет сжатие динамического диапазона. Это максимизирует громкость за счет сжатия
динамический диапазон звукового сигнала. (ранее назывался волнорм.)


Устанавливает используемый метод.

1 Используйте один образец для сглаживания вариаций с помощью стандарта
средневзвешенное значение по прошлым выборкам (по умолчанию).

2 Используйте несколько образцов, чтобы сгладить вариации с помощью стандартного
средневзвешенное значение по прошлым выборкам.


Устанавливает целевую амплитуду как долю от максимума для данного типа образца.
(по умолчанию: 0.25).

ПРИМЕЧАНИЕ:
Этот фильтр может вызвать искажение аудиосигналов с очень большой амплитудой.
динамический диапазон.

scaletempo [= option1: option2: ...]
Масштабирует темп звука без изменения высоты звука, опционально синхронизируется со скоростью воспроизведения
(по умолчанию).

Это работает, проигрывая 'шаг' мс звука с нормальной скоростью, а затем потребляя
'шаг*масштаб' мс входного аудио. Он соединяет шаги вместе, смешивая
«перекрытие»% шага со звуком, следующим за предыдущим шагом. Это опционально
выполняет краткий статистический анализ следующего «поиска» аудио, чтобы определить
лучшее положение перекрытия.

масштаб =
Номинальное значение для изменения темпа. Масштабирует это количество в дополнение к скорости.
(по умолчанию: 1.0)

шаг =
Длина в миллисекундах для вывода каждого шага. Слишком большое значение вызовет
заметные пропуски при больших значениях масштаба и эхо при малых значениях масштаба.
Очень низкие значения изменяют высоту тона. Увеличение повышает производительность. (дефолт:
60)

перекрытие =
Процент шага для перекрытия. Уменьшение повышает производительность. (дефолт:
.20)

поиск =
Длина в миллисекундах для поиска наилучшего положения перекрытия. Уменьшение
значительно повышает производительность. В медленных системах вы, вероятно, захотите установить
это очень низко. (по умолчанию: 14)

скорость =
Установите реакцию на изменение скорости.

время Масштабирование темпа синхронно со скоростью (по умолчанию).

шаг Отменяет действие фильтра. Изменяет высоту тона без изменения темпа. Добавлять
это твоему input.conf шагать по музыкальным полутонам:

[ скорость умножения 0.9438743126816935
] умножить скорость 1.059463094352953

ПРЕДУПРЕЖДЕНИЕ:
Теряет синхронизацию с видео.

изоферменты печени Масштабируйте как темп, так и высоту тона.

нет Игнорировать изменения скорости.

Примеры

MPV --af=масштабный темп --скорость=1.2 СМИ.ogg
Будет воспроизводить мультимедиа со скоростью, в 1.2 раза превышающей нормальную, со звуком с нормальной высотой тона.
Изменение скорости воспроизведения приведет к соответствующему изменению темпа звука.

MPV --af=scaletempo=масштаб=1.2:скорость=нет --скорость=1.2 СМИ.ogg
Будет воспроизводить мультимедиа со скоростью, в 1.2 раза превышающей нормальную, со звуком с нормальной высотой звука, но
изменение скорости воспроизведения не повлияет на темп звука.

MPV --af=scaletempo=шаг=30:перекрытие=.50:поиск=10 СМИ.ogg
Подкрутил бы параметры качества и производительности.

MPV --af=format=плавающая, шкала темпа СМИ.ogg
Заставил бы scaletempo использовать код с плавающей запятой. Может быть быстрее на некоторых платформах.

MPV --af=scaletempo=масштаб=1.2:скорость=высота тона аудио.ogg
Будет воспроизводить мультимедиа со скоростью, в 1.2 раза превышающей нормальную, со звуком с нормальной высотой тона.
Изменение скорости воспроизведения приведет к изменению высоты тона, оставив темп звука на уровне 1.2x.

резинка
Высококачественная коррекция высоты тона с помощью librubberband. Это можно использовать вместо
масштаб, и будет использоваться для регулировки высоты тона звука при воспроизведении на разных скоростях.
от нормального.

Этот фильтр имеет ряд подопций. Вы можете перечислить их с помощью MPV
--af=резинка=помощь. Это также покажет значения по умолчанию для каждой опции. То
опции здесь не задокументированы, потому что они просто передаются в librubberband.
Посмотрите документацию librubberband, чтобы узнать, что делает каждая опция:
http://breakfastquay.com/rubberband/code-doc/classRubberBand_1_1RubberBandStretcher.html
(Сопоставление имен и значений подпараметров фильтра резиновой ленты mpv с именами и значениями
librubberband следует простой схеме: «Вариант» + Имя + Значение.)

лавфи = график
Фильтруйте аудио с помощью libavfilter FFmpeg.


График libavfilter. Видеть лавфи видео фильтр для деталей - синтаксис графика
тоже самое.

ПРЕДУПРЕЖДЕНИЕ:
Не забудьте процитировать графики libavfilter, как описано в видео lavfi.
раздел фильтра.

о =
AV-опции.

ВИДЕО ФИЛЬТРЫ

Видео фильтры позволяют изменять видеопоток и его свойства. Синтаксис:

--vf =
Настройте цепочку видеофильтров.

Вы также можете установить значения по умолчанию для каждого фильтра. Значения по умолчанию применяются перед обычным
параметры фильтра.

--vf-по умолчанию=
Установите значения по умолчанию для каждого фильтра.

ПРИМЕЧАНИЕ:
Чтобы получить полный список доступных видеофильтров, см. --vf=помощь.

Кроме того, имейте в виду, что наиболее актуальные фильтры доступны через лавфи обертка, которая
дает вам доступ к большинству фильтров libavfilter. Сюда входят все фильтры, которые
был перенесен с MPlayer на libavfilter.

Видео фильтры управляются списками. Есть несколько команд для управления списком фильтров.

--vf-добавить =
Добавляет фильтры, указанные в качестве аргументов, в список фильтров.

--vf-пре=
Добавляет фильтры, указанные в качестве аргументов, к списку фильтров.

--vf-дел =
Удаляет фильтры по указанным индексам. Номера индексов начинаются с 0, отрицательные
числа обращаются к концу списка (-1 - последний).

--vf-clr
Полностью очищает список фильтров.

С фильтрами, которые его поддерживают, вы можете получить доступ к параметрам по их имени.

--vf= = помощь
Печатает имена параметров и диапазоны значений параметров для определенного фильтра.

--vf=
Устанавливает именованный параметр в заданное значение. Используйте вкл и выкл или да и нет, чтобы установить флаг
параметры.

Доступные фильтры:

обрезать [= w: h: x: y]
Обрезает данную часть изображения и отбрасывает остальное. Полезно для удаления черного
полосы из широкоформатных видео.

,
Обрезанные ширина и высота, по умолчанию исходные ширина и высота.

,
Положение кадрированного изображения по умолчанию по центру.

развернуть [= ш: ч: х: у: аспект: круглый]
Увеличивает (не масштабирует) разрешение видео до заданного значения и помещает немасштабированное
оригинал в координатах x, y.

,
Расширенная ширина, высота (по умолчанию: исходная ширина, высота). Отрицательные значения для
w и h рассматриваются как смещения исходного размера.

Пример

развернуть = 0: -50: 0: 0
Добавляет рамку в 50 пикселей в нижнюю часть изображения.

,
положение исходного изображения на развернутом изображении (по умолчанию: по центру)


Расширяется, чтобы соответствовать аспекту, а не разрешению (по умолчанию: 0).

Пример

расширить=800::::4/3
Расширяется до 800x600, если разрешение источника не более высокое, в
в этом случае он расширяется, чтобы заполнить аспект 4/3.


Округляет в большую сторону, чтобы ширина и высота делились на (по умолчанию: 1).

флип Переворачивает изображение вверх ногами.

зеркало Зеркально отображает изображение по оси Y.

повернуть[=0|90|180|270]
Поворачивает изображение на кратное 90 градусов по часовой стрелке.

масштаб[=w:h:param:param2:chr-drop:noup:arnd
Масштабирует изображение с помощью программного скейлера (медленно) и выполняет цвет YUV<->RGB.
преобразование пространства (см. также --sss).

Все параметры необязательны.

:
масштабированная ширина / высота (по умолчанию: исходная ширина / высота)

0 масштабируется d_width/d_height

-1 исходная ширина/высота

-2 Вычислите w/h, используя другое измерение и предварительно масштабированный аспект
отношение.

-3 Вычислите w/h, используя другое измерение и исходный аспект
отношение.

-(п+8) Аналогично -n выше, но с округлением размера до ближайшего кратного
16. Воспользуйтесь функционалом

[: ] (См. причислены --свс)
Установите некоторые параметры масштабирования в зависимости от типа масштабирующего устройства, выбранного с помощью
--sss:

--sws=2 (бикубический): B (размытие) и C (звон)
0.00: 0.60 по умолчанию
0.00: 0.75 "точный бикубический" VirtualDub
0.00: 0.50 шлиц Катмулла-Рома
0.33: 0.33 шлиц Митчелла-Нетравали
1.00: 0.00 кубический B-шлиц

--sws=7 (по Гауссу): резкость (0 (мягкая) - 100 (резкая))

--sws=9 (Lanczos): длина фильтра (1-10)


пропуск цветности

0 Используйте все доступные входные строки для цветности (по умолчанию).

1 Используйте только каждую 2. строку ввода для цветности.

2 Используйте только каждую 4. строку ввода для цветности.

3 Используйте только каждую 8. строку ввода для цветности.

Запретить масштабирование сверх исходных размеров.

0 Разрешить масштабирование (по умолчанию).

1 Запретить масштабирование, если одно измерение превышает исходное значение.

2 Запретить масштабирование, если оба размера превышают исходные значения.

Точное округление для вертикального масштабатора, которое может быть быстрее или медленнее
чем округление по умолчанию.

нет Отключить точное округление (по умолчанию).

Да Включите точное округление.

dsize[=w:h:аспект-метод:r:аспект]
Изменяет предполагаемый размер / аспект отображения в произвольной точке цепочки фильтров.
Аспект может быть выражен дробью (4/3) или числом с плавающей запятой (1.33).
В качестве альтернативы вы можете указать точную желаемую ширину и высоту отображения. Примечание
что этот фильтр делает делать любое масштабирование самостоятельно; это просто влияет на то, что более поздние скейлеры
(программное или аппаратное обеспечение) будет работать при автоматическом масштабировании до правильного соотношения сторон.

,
Новая ширина и высота дисплея.

Также могут быть эти специальные значения:

0 исходная ширина и высота дисплея

-1 исходная ширина и высота видео (по умолчанию)

-2 Вычислить w/h, используя другое измерение и исходный дисплей
соотношение сторон.

-3 Вычислите w/h, используя другое измерение и формат исходного видео.
отношение.

Пример

размер = 800: -2
Указывает разрешение экрана 800x600 для видео с соотношением сторон 4/3,
или 800x450 для видео с соотношением сторон 16/9.


Изменяет ширину и высоту в соответствии с исходными пропорциями.

-1 Игнорировать исходное соотношение сторон (по умолчанию).

0 Сохраняйте соотношение сторон экрана, используя и как максимальное разрешение.

1 Сохраняйте соотношение сторон экрана, используя и как минимальное разрешение.

2 Сохраняйте соотношение сторон видео, используя и как максимальное разрешение.

3 Сохраняйте соотношение сторон видео, используя и как минимальное разрешение.

Пример

dsize = 800: 600: 0
Задает разрешение экрана не более 800 x 600 или меньше в
чтобы сохранить аспект.

Округляет в большую сторону, чтобы ширина и высота делились на (по умолчанию: 1).


Принудительное соотношение сторон.

формат = ФМТ = :colormatrix= :...
Ограничивает цветовое пространство для следующего фильтра без преобразования. Использовать
вместе с масштабным фильтром для реального преобразования.

ПРИМЕЧАНИЕ:
Список доступных форматов см. формат = ФМТ = помощь.

Название формата, например, rgb15, bgr24, 420p и т. д. (по умолчанию: не изменять).


Имя формата, которое следует заменить для вывода. Если у них нет
те же байты на пиксель и субдискретизацию цветности, это не удастся.


Управляет преобразованием цветового пространства YUV в RGB при воспроизведении видео. Есть
различные стандарты. Обычно для SD-видео следует использовать BT.601, а для SD-видео — BT.709.
для HD-видео. (Это делается по умолчанию.) Использование неправильного цветового пространства приводит к
в немного менее или более насыщенных и сдвинутых цветах.

Эти параметры не всегда поддерживаются. Различные видеовыходы обеспечивают
разная степень поддержки. То OpenGL и вдпау драйверы видеовыхода
обычно предлагают полную поддержку. То xv вывод может установить цветовое пространство, если
системный видеодрайвер поддерживает его, но не уровни ввода и вывода. То лестница
видеофильтр может настраивать цветовое пространство и входные уровни, но только если
формат вывода — RGB (если драйвер вывода видео поддерживает вывод RGB, вы
может заставить это с -vf масштаб, формат = rgba).

Если для этого параметра установлено значение автоматический (по умолчанию), цвет видео
будет использоваться космический флаг. Если этот флаг не установлен, цветовое пространство будет
выбирается автоматически. Это делается с помощью простой эвристики, которая пытается
различать SD и HD видео. Если видео больше 1279x576 пикселей,
Будет использоваться BT.709 (HD); в противном случае выбирается BT.601 (SD).

Доступные цветовые пространства:

автоматический автоматический выбор (по умолчанию)

601 бат МСЭ-R BT.601 (SD)

709 бат МСЭ-R BT.709 (HD)

бт.2020-нкл
Система непостоянной яркости ITU-R BT.2020

бт.2020-кл
Система постоянной яркости ITU-R BT.2020

смпте-240м
СМПТЭ-240М


Уровни цвета YUV, используемые при преобразовании YUV в RGB. Этот вариант только
необходим при воспроизведении битых файлов, которые не соответствуют стандартному цвету
уровни или которые помечены неправильно. Если в видео не указан его цвет
диапазон, предполагается, что диапазон ограничен.

Те же ограничения, что и при подать заявление.

Доступные цветовые диапазоны:

автоматический автоматический выбор (обычно ограниченный диапазон) (по умолчанию)

ограниченный
ограниченный диапазон (16-235 для яркости, 16-240 для цветности)

полный полный диапазон (0-255 для яркости и цветности)


Основные цвета RGB, с которыми был закодирован исходный файл. В норме это должно быть
устанавливается в заголовке файла, но при воспроизведении битых файлов или файлов с ошибочными тегами это
можно использовать для переопределения настройки.

Этот параметр влияет только на драйверы видеовыхода, которые выполняют цветопередачу.
управление, например OpenGL с Target-Prim or icc-профиль
набор подопций.

Если для этого параметра установлено значение автоматический (значение по умолчанию), видео
будет использоваться флаг праймериз. Если этот флаг не установлен, цветовое пространство
выбираться автоматически с использованием следующей эвристики: если
устанавливается или определяется как BT.2020 или BT.709,
используются соответствующие основные цвета. В противном случае, если высота видео
именно 576 (PAL), используется BT.601-625. Если это точно 480 или 486 (NTSC),
Используется ВТ.601-525. Если разрешение видео другое, BT.709
используемый.

Доступные праймериз:

автоматический автоматический выбор (по умолчанию)

бт.601-525
ITU-R BT.601 (SD) 525-строчные системы (NTSC, SMPTE-C)

бт.601-625
ITU-R BT.601 (SD) 625-строчные системы (PAL, SECAM)

709 бат ITU-R BT.709 (HD) (те же основные цвета, что и sRGB)

2020 бат
МСЭ-R BT.2020 (UHD)

яблоко Яблоко RGB

саман AdobeRGB (1998)

Prophoto
ProPhoto RGB (ПЗУ)

cie1931
МКО 1931 RGB


Гамма-функция, которой был закодирован исходный файл. Обычно это должно
быть установлен в заголовке файла, но при воспроизведении поврежденных файлов или файлов с ошибочными тегами
это можно использовать для переопределения настройки.

Этот параметр влияет только на драйверы видеовыхода, которые выполняют цветопередачу.
управления.

Если для этого параметра установлено значение автоматический (значение по умолчанию), гамма будет
установить на BT.1886 для контента YCbCr, sRGB для контента RGB и Linear
для контента XYZ.

Доступные гамма-функции:

автоматический автоматический выбор (по умолчанию)

1886 бат
ITU-R BT.1886 (аппроксимация кривой BT.601/BT.709/BT.2020)

srgb МЭК 61966-2-4 (sRGB)

линейный Линейный свет

gamma1.8
Кривая чистой мощности (гамма 1.8)

gamma2.2
Кривая чистой мощности (гамма 2.2)

gamma2.8
Кривая чистой мощности (гамма 2.8)

Prophoto
Кривая ProPhoto RGB (ROMM)


Установите стереофонический режим, в котором предположительно закодировано видео.
ценности как --видео-стерео-режим опцию.


Установите стереофонический режим, в котором должно отображаться видео. Принимает те же значения
как --видео-стерео-режим опцию.


Задайте угол поворота, с которым предполагается кодировать видео, в градусах. То
особая ценность -1 использует формат ввода.

,
Установите размер дисплея. Обратите внимание, что установка размера экрана таким образом, чтобы видео
масштабируется в обоих направлениях, а не просто меняет соотношение сторон.
детали реализации и могут измениться позже.

Установите соотношение сторон экрана для видеокадра. Это число с плавающей запятой, но значения
как [16: 9] тоже можно пройти([...] для цитирования, чтобы предотвратить вариант
парсер от интерпретации : персонаж).

без формата[=fmt]
Ограничивает цветовое пространство для следующего фильтра без преобразования. в отличие
фильтр формата, это позволит использовать любое цветовое пространство, кроме указанного вами.

ПРИМЕЧАНИЕ:
Список доступных форматов см. noformat=fmt=помощь.

Название формата, например, rgb15, bgr24, 420p и т. д. (по умолчанию: 420p).

lavfi=граф[:sws-flags[:o=opts]]
Фильтруйте видео, используя libavfilter FFmpeg.


Строка графика libavfilter. Фильтр должен иметь одну панель видеовхода.
и одна панель видеовыхода.

Посмотреть https://ffmpeg.org/ffmpeg-filters.html для синтаксиса и доступных фильтров.

ПРЕДУПРЕЖДЕНИЕ:
Если вы хотите использовать полный синтаксис фильтра с этой опцией, вы должны
процитируйте график фильтра, чтобы предотвратить синтаксис mpv и фильтр
синтаксис графа от конфликтов.

Примеры

-vf lavfi=[gradfun=20:30,vflip]
Gradfun фильтр с бессмысленными параметрами, за которым следует вфлип
фильтр. (Это демонстрирует, как libavfilter берет график, а не
только один фильтр.) Строка графика фильтра заключена в кавычки [
и ]. Это не требует дополнительных кавычек или экранирования с некоторыми
оболочки (например, bash), в то время как другие (например, zsh) требуют дополнительных "
кавычки вокруг строки параметра.

'--vf=lavfi="gradfun=20:30,vflip"'
То же, что и раньше, но использует цитирование, которое должно быть безопасным для всех
снаряды. Внешний ' кавычки убедитесь, что оболочка не
удалить " цитаты, необходимые для mpv.

'--vf=lavfi=graph="gradfun=radius=30:strength=20,vflip"'
То же, что и раньше, но для всего используются именованные параметры.


Если libavfilter вставляет фильтры для преобразования формата пикселей, этот параметр
дает флаги, которые должны быть переданы в libswscale. Этот параметр является числовым
и принимает побитовую комбинацию SWS_ флаги.

Посмотреть http://git.videolan.org/?p=ffmpeg.git;a=blob;f=libswscale/swscale.h.

Установите параметры AVFilterGraph. Они должны быть задокументированы FFmpeg.

Пример

'--vf=lavfi=yadif:o="threads=2,thread_type=slice"'
форсирует определенную конфигурацию потоков.

eq[=гамма:контраст:яркость:насыщенность:rg:gg:bg:вес]
Программный эквалайзер, использующий справочные таблицы (медленно), позволяющий корректировать гамму в
в дополнение к простой регулировке яркости и контрастности. Параметры даны как
значения с плавающей запятой.

<0.1-10>
начальное значение гаммы (по умолчанию: 1.0)

<-2-2> начальный контраст, где отрицательные значения приводят к отрицательному изображению (по умолчанию:
1.0)

<-1-1> начальная яркость (по умолчанию: 0.0)

<0-3> начальная насыщенность (по умолчанию: 1.0)

<0.1-10>
значение гаммы для красного компонента (по умолчанию: 1.0)

<0.1-10>
значение гаммы для зеленого компонента (по умолчанию: 1.0)

<0.1-10>
значение гаммы для синего компонента (по умолчанию: 1.0)

<0-1> Параметр веса может использоваться для уменьшения эффекта высокого значения гаммы.
на ярких участках изображения, например, не допускайте их чрезмерного увеличения и просто
простой белый. Значение 0.0 полностью уменьшает гамма-коррекцию.
в то время как 1.0 оставляет его на полную мощность (по умолчанию: 1.0).

подтяжка [= jl: jr: jt: jb: sb: mp]
Реверсивный фильтр Pulldown (обратный телесин), способный обрабатывать смешанные
жесткий телесин, прогрессивный контент 24000/1001 кадр/с и прогрессивный контент 30000/1001 кадр/с.
Команда подтягивание filter использует будущий контекст при принятии решений. это
апатрид в том смысле, что он не привязан к образцу, которому нужно следовать, но он
вместо этого ожидает следующих полей, чтобы идентифицировать совпадения и
перестроить прогрессивные кадры.

Дж, младший, джт, и jb
Эти параметры устанавливают количество игнорируемого мусора слева, справа, вверху,
и нижнюю часть изображения соответственно. Левый/правый в единицах 8 пикселей,
в то время как верх/низ находятся в единицах из 2 строк. По умолчанию 8 пикселей на каждом
стороны.

sb (строгое брейки)
Установка этого параметра в 1 уменьшит вероятность подтягивание создание
случайное несовпадение кадров, но это также может привести к чрезмерному количеству
кадры, которые следует отбрасывать во время последовательностей с высоким движением. И наоборот, установив его
до -1 сделает подтягивание сопоставлять поля проще. Это может помочь в обработке
видео, где есть небольшое размытие между полями, но также может вызвать
на выходе должны быть чересстрочные кадры.

mp (метрическая самолет)
Этот параметр может быть установлен на u or v использовать плоскость цветности вместо яркости
самолет для выполнения подтягиваниерасчеты. Это может повысить точность на очень
чистый исходный материал, но, скорее всего, снизит точность, особенно если
есть цветной шум (эффект радуги) или любое видео в градациях серого. Главный
цель установки mp в плоскость цветности, чтобы уменьшить нагрузку на процессор и сделать
pulllup можно использовать в реальном времени на медленных машинах.

yadif=[режим:только чересстрочный]
Еще один фильтр деинтерлейсинга



рама Выведите 1 кадр для каждого кадра.

поле Выведите по 1 кадру для каждого поля.

каркасно-пространственный
Подобно рама но пропускает проверку пространственного чередования.

поле-нопространственный
Подобно поле но пропускает проверку пространственного чередования.



нет Деинтерлейсировать все кадры (по умолчанию).

Да Только деинтерлейсные кадры, помеченные как чересстрочные (по умолчанию, если этот фильтр
вставляется через деинтерлейсинг имущество).

Этот фильтр автоматически вставляется при использовании d ключ (или любой другой ключ,
переключает деинтерлейсинг имущества или при использовании --деинтерлейсинг переключатель), предполагая
видеовыход не имеет встроенной поддержки деинтерлейсинга.

Если вы просто хотите установить режим по умолчанию, поместите этот фильтр и его параметры в
--vf-по умолчанию вместо этого и включите деинтерлейсинг с помощью d or --деинтерлейсинг.

Также обратите внимание, что d ключ достаточно глуп, чтобы вставить деинтерлейсер дважды, когда
вставка yadif с --vf, поэтому рекомендуется использовать вышеуказанные методы.

sub=[=нижнее поле:верхнее поле]
Перемещает рендеринг субтитров в произвольную точку в цепочке фильтров или принудительно
рендеринг субтитров в видеофильтре вместо использования экранного меню видеовыхода
.


Добавляет черную полосу внизу рамки. Средство визуализации SSA / ASS может размещать
субтитры там (с --sub-use-margins).


Черная полоса сверху для заголовков (с --sub-use-margins).

Примеры

--vf=sub,eq
Перемещает вспомогательный рендеринг перед фильтром эквалайзера. Это поместит оба подзаголовка
цвета и видео под влиянием настроек эквалайзера видео.

стерео3д [= вход: выход]
Stereo3d преобразует различные форматы стереоскопических изображений.

Входной формат стереоскопического изображения. Возможные значения:

сбсл or side_by_side_left_first
бок о бок параллельно (левый глаз левый, правый глаз правый)

сбср or side_by_side_right_first
бок о бок перекрестие (правый глаз левый, левый глаз правый)

ABL or выше_ниже_слева_первый
вверху-внизу (левый глаз вверху, правый глаз внизу)

абр or выше_ниже_справа_первый
вверху-внизу (правый глаз вверху, левый глаз внизу)

AB2L or выше_ниже_половина_высоты_слева_первый
сверху-снизу с разрешением половинной высоты (левый глаз вверху, правый глаз
ниже)

ab2r or выше_ниже_половина_высоты_право_первого
сверху-снизу с разрешением половинной высоты (правый глаз вверху, левый глаз
ниже)

Формат вывода стереоскопического изображения. Возможные значения - все входные
форматы, а также:

дуга or анаглиф_red_cyan_gray
анаглифный красный / голубой серый (красный фильтр на левом глазу, голубой фильтр справа
глаз)

арка or анаглиф_red_cyan_half_color
анаглиф красный / голубой полуцвет (красный фильтр на левом глазу, голубой фильтр
на правый глаз)

ARCC or анаглиф_red_cyan_color
анаглифный красный/голубой цвет (красный фильтр на левом глазу, голубой фильтр на правом
глаз)

дуга or анаглиф_red_cyan_dubois
анаглифный красный/голубой цвет, оптимизированный с помощью проекции по методу наименьших квадратов
Дюбуа (красный фильтр на левом глазу, голубой фильтр на правом глазу)

АГМГ or анаглиф_зеленый_пурпурный_серый
анаглифный зеленый/пурпурно-серый (зеленый фильтр на левом глазу, пурпурный фильтр
на правый глаз)

ага or анаглиф_зеленый_пурпурный_половина_цвета
анаглиф зеленый / пурпурный наполовину (зеленый фильтр на левом глазу,
пурпурный фильтр на правом глазу)

АГМК or анаглиф_зеленый_пурпурный_цвет
анаглиф зеленый / пурпурный (зеленый фильтр на левом глазу, пурпурный
фильтр на правый глаз)

айбг or анаглиф_желтый_синий_серый
анаглиф желтый / сине-серый (желтый фильтр на левом глазу, синий фильтр на
правый глаз)

айбх or анаглиф_желтый_синий_половина_цвета
анаглиф желтый / синий полуокрашенный (желтый фильтр на левом глазу, синий
фильтр на правый глаз)

айбк or анаглиф_желтый_синий_цвет
анаглиф желто-синего цвета (желтый фильтр на левом глазу, синий фильтр
на правый глаз)

Irl or interleave_rows_left_first
Чередующиеся строки (левый глаз имеет верхний ряд, правый глаз начинается со следующего ряда)

IRR or interleave_rows_right_first
Чередующиеся строки (правый глаз имеет верхний ряд, левый глаз начинается со следующего ряда)

ml or моно_лево
моно выход (только левый глаз)

mr or моно_право
моно выход (только правый глаз)

gradfun[=сила[:радиус|:размер= ]]
Исправьте артефакты полос, которые иногда появляются в почти плоских областях из-за
усечение до 8-битной глубины цвета. Интерполирует градиенты, которые должны идти туда, где
полосы есть, и дизерит их.


Максимальная величина, на которую фильтр изменит любой пиксель. Так же
порог обнаружения почти плоских областей (по умолчанию: 1.5).


Окрестности, к которым подходит градиент. Больший радиус делает более плавным
градиентов, но также не позволяет фильтру изменять пиксели, близкие к детализированным
регионы (по умолчанию: отключено).

размер фильтра в процентах от размера диагонали изображения. Это используется для
рассчитать окончательный размер радиуса (по умолчанию: 1).

dlopen=dll[:a0[:a1[:a2[:a3]]]]
Загружает внешнюю библиотеку для фильтрации изображения. Интерфейс библиотеки — это
vf_dlopen интерфейс, указанный с помощью libmpcodecs/vf_dlopen.h.

ПРЕДУПРЕЖДЕНИЕ:
Этот фильтр устарел.

dll=
Укажите библиотеку для загрузки. Для этого может потребоваться полный путь к файловой системе в
некоторые случаи. Этот аргумент является обязательным.

а0=
Укажите первый параметр для передачи в библиотеку.

а1=
Укажите второй параметр для передачи в библиотеку.

а2=
Укажите третий параметр для передачи в библиотеку.

а3=
Укажите четвертый параметр для передачи в библиотеку.

vapursynth = файл: буферизованные кадры: параллельные кадры
Загружает скрипт фильтра VapourSynth. Это предназначено для потоковой обработки: mpv
фактически предоставляет исходный фильтр вместо использования собственного видео VapourSynth
источник. Источник mpv будет отвечать на запросы кадра только в пределах небольшого окна
рамки (размер этого окна регулируется буферизованные кадры параметр),
и запросы вне этого будут возвращать ошибки. Таким образом, вы не можете использовать полный
мощность VapourSynth, но вы можете использовать определенные фильтры.

Если вы просто хотите воспроизвести видео, сгенерированное VapourSynth (т. е. используя собственный
источник видео VapourSynth), лучше использовать вспайп и FIFO для подачи видео
к мпв. То же самое применимо, если сценарий фильтра требует произвольного доступа к кадру (см.
буферизованные кадры параметр).

Этот фильтр является экспериментальным. Если окажется, что он хорошо работает и используется, он
будет портирован на libavfilter. В противном случае он будет просто удален.

файл Имя файла источника скрипта. В настоящее время это всегда скрипт Python.
Переменная видео_в установлен на источник видео mpv, и ожидается
что скрипт читает видео с него. (В противном случае mpv не будет декодировать видео,
и очередь видеопакетов переполнится, что в конечном итоге приведет к отключению звука.
остановлен.) Также ожидается, что сценарий будет передавать временные метки, используя
_DurationNum и _Durationden свойства кадра.

Пример:

импортировать vapursynth как против
ядро = vs.get_core()
core.std.AddBorders(video_in, 10, 10, 20, 20).set_output()

ПРЕДУПРЕЖДЕНИЕ:
Скрипт будет перезагружаться при каждом поиске. Это делается для сброса
правильно фильтровать разрывы.

буферизованные кадры
Максимальное количество декодированных видеокадров, которые должны быть буферизованы до
фильтр (по умолчанию: 4). Указывает максимальное количество кадров, которые скрипт
может запрашивать в обратном порядке. Например, если буферизованные кадры = 5, а скрипт просто
запрошенный кадр 15, он все еще может запросить кадр 10, но кадр 9 не
доступны больше. Если он запрашивает кадр 30, mpv декодирует еще 15 кадров,
и оставить только кадры 25-30.

Фактическое количество буферизованных кадров также зависит от значения параметра
параллельные кадры вариант. В настоящее время оба значения параметра умножаются на
получить окончательный размер буфера.

(Обычно исходные фильтры VapourSynth должны обеспечивать произвольный доступ, но mpv
был создан для воспроизведения и не обеспечивает произвольный доступ с точностью до кадра. То
то, как работает этот видеофильтр, является компромиссом для того, чтобы заставить работать простые фильтры.
в любом случае.)

параллельные кадры
Количество кадров, которые следует запрашивать параллельно. Уровень
параллелизм зависит от фильтра и от того, насколько быстро mpv может декодировать видео в
кормить фильтр. Вероятно, это значение должно быть пропорционально количеству
ядра на вашей машине. Большую часть времени, что делает его выше, чем количество ядер
на самом деле может сделать это медленнее.

По умолчанию используется специальное значение автоматический, который устанавливает параметр в
количество обнаруженных логических ядер ЦП.

Следующие переменные определяются mpv:

видео_в
Источник видео mpv в виде клипа vapursynth. Обратите внимание, что здесь не задана длина,
что сбивает с толку многие фильтры. С использованием Отделка на клипсе с большой длиной манекена
может превратить его в конечный клип.

видео_in_dw, video_in_dh
Отображение размера видео. Может отличаться от размера видео, если видео
не использует квадратные пиксели (например, DVD).

контейнер_fps
Значение FPS, указанное в заголовках файлов. Это значение может быть неправильным или полностью
сломан (например, 0 или NaN). Даже если значение правильное, если другой фильтр
изменяет реальный FPS (отбрасывая или вставляя кадры), значение этого
переменная может оказаться бесполезной. Обратите внимание, что - кадров в секунду опция командной строки
отменяет это значение.

Полезно для некоторых фильтров, которые настаивают на наличии FPS.

display_fps
Частота обновления текущего дисплея. Обратите внимание, что это значение может быть равно 0.

ленивый
Такой же как вейпорсинт, но не загружает скрипты Python. Вместо этого настраиваемый бэкэнд
с использованием Lua и необработанного API VapourSynth. Синтаксис совсем другой,
и абсолютно никаких удобных функций не предусмотрено. Нет проверки типов
либо, и вы можете вызвать сбои.

Пример:

video_out = invoke("morpho", "Open", {clip = video_in})

Специальная переменная видео_в является источником видео mpv, а специальная переменная
видео выход используется для чтения видео с. 1-й аргумент — это плагин (запрошенный с помощью
getPluginByNs), 2-й — имя фильтра, а 3-й аргумент — таблица с
аргументы. Позиционные аргументы не поддерживаются. Типы должны совпадать
точно. Поскольку Lua ужасен и не может отличить целые числа от чисел с плавающей запятой, целые
аргументы должны иметь префикс i_, в этом случае префикс удаляется, а
аргумент приводится к целому числу. Должно ли имя аргумента начинаться с i_, Вы
повезло.

Клипы (VSNodeRef) передаются как легкие пользовательские данные, поэтому попытка передать любой другой
тип пользовательских данных приведет к серьезным сбоям.

вавпп Постобработка видео VA-AP-API. Работает с --vo = vaapi и --vo = opengl только.
На данный момент деинтерлейс. Этот фильтр автоматически вставляется, если деинтерлейсинг включен.
запрашивается (либо с помощью d клавиша, по умолчанию сопоставленная с командой цикл
деинтерлейсинг, или --деинтерлейсинг опция).

deint=
Выберите алгоритм деинтерлейсинга.

нет Не выполняйте деинтерлейсинг.

первое поле
Показать только первое поле (переходя --поле-доминирование).

зерно Боб деинтерлейсинг (по умолчанию).

ткать адаптивный к движению, с компенсацией движения
Расширенные алгоритмы деинтерлейсинга. Действительно ли они работают
зависит от аппаратного обеспечения графического процессора, драйверов графического процессора, ошибок драйверов и mpv
ошибки.



нет Деинтерлейсинг всех кадров.

Да Только деинтерлейсные кадры, помеченные как чересстрочные (по умолчанию).

вдпаупп
Постобработка видео ВДПАУ. Работает с --vo = vdpau и --vo = opengl Только. Этот
фильтр автоматически вставляется, если требуется деинтерлейсинг (либо с помощью d
клавиша, по умолчанию сопоставленная с командой цикл деинтерлейсинг, или --деинтерлейсинг
вариант). При включении деинтерлейсинга всегда предпочтительнее программного
фильтры деинтерлейсера, если вдпау используется ВО, а также если OpenGL используется и
хотя бы раз было активировано аппаратное декодирование (т.е. загружалась вдпау).

резкость = <-1-1>
Для положительных значений примените алгоритм повышения резкости к видео, для отрицательных
определяет алгоритм размытия (по умолчанию: 0).

шумоподавление = <0-1>
Примените к видео алгоритм шумоподавления (по умолчанию: 0; без шума
снижение).

deint=
Включен ли деинтерлейсинг (по умолчанию: нет). Если он включен, он будет использовать
режим, выбранный с помощью режим деинтирования.

deint-режим =
Выберите режим деинтерлейсинга (по умолчанию: временной). Все режимы уважения
--поле-доминирование.

Обратите внимание, что в настоящее время существует механизм, который позволяет вдпау ВО изменить
режим деинтирования автоматически вставленных вдпаупп фильтры. Во избежание путаницы это
рекомендуется не использовать --vo = vdpau подопции, связанные с фильтрацией.

первое поле
Показать только первое поле.

зерно Боб деинтерлейсинг.

временной
Адаптивный к движению временной деинтерлейсинг. Может привести к рассинхронизации A / V с
медленное видеооборудование и / или высокое разрешение.

временно-пространственный
Адаптивный к движению временный деинтерлейсинг с пространственным управлением по краям
интерполяция. Требуется быстрое видеооборудование.

определение цветности
Заставляет временные деинтерлейсеры работать как с яркостью, так и с цветностью (по умолчанию). Использовать
no-chroma-deint, чтобы использовать исключительно яркость и ускорить расширенный деинтерлейсинг.
Полезно при медленной видеопамяти.

подтягивание Попробуйте применить обратный телесин, нужен адаптивный к движению временной деинтерлейсинг.

только чересстрочная развертка =
If Да (по умолчанию), деинтерлейсируются только кадры, помеченные как чересстрочные.

hqscaling = <0-9>

0 Использовать масштабирование VDPAU по умолчанию (по умолчанию).

1-9 Примените высококачественное масштабирование VDPAU (требуется соответствующее оборудование).

вдпаурб
Видео ВДПАУ прочитано. Работает с --vo = vdpau и --vo = opengl Только. Этот фильтр
будет считывать кадры, декодированные VDPAU, чтобы другие фильтры, не
обычно совместим с VDPAU, может использоваться как обычно. Этот фильтр должен быть
указано ранее вдпаупп в цепочке фильтров, если вдпаупп используется.

буфер=
Buffer кадров в цепочке фильтров. Этот фильтр, вероятно, довольно бесполезен,
кроме отладки. (Обратите внимание, что это не поможет сгладить задержки с
декодирование, потому что фильтр никогда не выдаст кадр, если буфер не заполнен,
кроме EOF.)

КОДИРОВАНИЕ

С помощью этого средства вы можете кодировать файлы из одного формата/кодека в другой.

--о=
Включает режим кодирования и указывает имя выходного файла.

--of=
Указывает выходной формат (отменяет автоматическое определение по расширению имени файла
файл, указанный -o). Это может быть список возможных форматов, разделенных запятыми.
пытаться. Видеть --of=помощь полный список поддерживаемых форматов.

--ofopts=
Указывает параметры выходного формата для libavformat. Видеть --ofopts=помощь для полного
список поддерживаемых опций.

Опции управляются списками. Есть несколько команд для управления списком опций.

--ofopts-добавить =
Добавляет параметры, заданные в качестве аргументов, в список параметров.

--ofopts-pre=
Добавляет параметры, заданные в качестве аргументов, в список параметров.

--ofopts-дел =
Удаляет опции по заданным индексам. Номера индексов начинаются с 0, отрицательный
числа обращаются к концу списка (-1 - последний).

--ofopts-clr
Полностью очищает список опций.

--ofps= значение>
Определяет базу времени выходного формата (по умолчанию: 24000). Низкие значения, такие как предел 25
видео кадров в секунду путем пропуска кадров.

--oautofps
Устанавливает временную базу выходного формата на предполагаемую частоту кадров входного видео.
(имитирует поведение MEncoder, полезно для AVI; может вызвать выпадение кадров). Обратите внимание, что
не все кодеки и не все форматы поддерживают кодирование VFR, а некоторые из них поддерживают
баги при указании целевого битрейта - используйте --ofps or --oautofps заставить CFR
кодирование в этих случаях.

--omaxfps= значение>
Определяет минимальное расстояние между соседними кадрами (по умолчанию: 0, что означает не задано).
Контент с более низкой частотой кадров не перенастраивается на эту частоту кадров; содержание высшего
частота кадров сокращается до этой частоты кадров.

--oharddup
Если установлено, частота кадров, заданная --ofps достигается не пропуском временных кодов, а
путем дублирования кадров (режим с постоянной частотой кадров).

--oneeverdrop
Если установлено, кадры никогда не удаляются. Вместо этого временные коды видео перенастраиваются на
всегда увеличивайте. Однако это может привести к рассинхронизации AV; чтобы обойти это, используйте
временная база с высокой частотой кадров с использованием --ofps и абсолютно избегать --oautofps.

--oac=
Определяет выходной аудиокодек. Это может быть разделенный запятыми список возможных
кодеки попробовать. Видеть --oac=помощь полный список поддерживаемых кодеков.

--oaoffset=
Сдвигает аудиоданные на заданное время (в секундах), добавляя/удаляя сэмплы в
начать.

--oacopts=
Указывает параметры выходного аудиокодека для libavcodec. Видеть --oacopts=помощь для
полный список поддерживаемых опций.

Пример

-OAC = libmp3lame --oacopts=b=128000
выбирает кодировку MP128 со скоростью 3 кбит/с.

Опции управляются списками. Есть несколько команд для управления списком опций.

--oacopts-добавить =
Добавляет параметры, заданные в качестве аргументов, в список параметров.

--oacopts-pre=
Добавляет параметры, заданные в качестве аргументов, в список параметров.

--oacopts-дель=
Удаляет опции по заданным индексам. Номера индексов начинаются с 0, отрицательный
числа обращаются к концу списка (-1 - последний).

--oacopts-clr
Полностью очищает список опций.

--oafirst
Заставьте аудиопоток стать первым потоком на выходе. По умолчанию
порядок не указан.

--ovc=
Указывает выходной видеокодек. Это может быть разделенный запятыми список возможных
кодеки попробовать. Видеть --ovc=помощь полный список поддерживаемых кодеков.

--ovoffset=
Сдвигает видеоданные на заданное время (в секундах) путем сдвига значений точек.

--ovcopts
Указывает параметры выходного видеокодека для libavcodec. См. --ovcopts=help для
полный список поддерживаемых опций.

Примеры

"--ovc=mpeg4 --ovcopts=qscale=5"
выбирает постоянную шкалу квантователя 5 для кодирования MPEG-4.

"--ovc=libx264 --ovcopts=crf=23"
выбирает коэффициент качества VBR 23 для кодирования H.264.

Опции управляются списками. Есть несколько команд для управления списком опций.

--ovcopts-добавить =
Добавляет параметры, заданные в качестве аргументов, в список параметров.

--ovcopts-pre=
Добавляет параметры, заданные в качестве аргументов, в список параметров.

--ovcopts-del=
Удаляет опции по заданным индексам. Номера индексов начинаются с 0, отрицательный
числа обращаются к концу списка (-1 - последний).

--ovcopts-clr
Полностью очищает список опций.

--ovfirst
Заставьте видеопоток стать первым потоком на выходе. По умолчанию
порядок не указан.

--окопиты
Копирует входные точки в выходное видео (не поддерживается некоторыми выходными контейнерами).
форматы, например AVI). Неполадки по-прежнему исправлены. По умолчанию звуковые точки установлены
время воспроизведения и точки видео синхронизируются с точками аудио, так как некоторые выходные
форматы не поддерживают ничего другого.

--orawts
Копирует входные точки в выходное видео (не поддерживается некоторыми выходными контейнерами).
форматы, например AVI). В этом режиме разрывы не фиксируются и все точки
прошел как есть. Никогда не ищите назад и не используйте несколько входных файлов в этом
Режим!

--no-ометаданные
Отключает копирование метаданных из входных файлов в выходные файлы при кодировании (что
по умолчанию включен).

КОМАНДА ИНТЕРФЕЙС

Ядром mpv можно управлять с помощью команд и свойств. Несколько способов взаимодействия
с плеером используйте их: привязки клавиш (input.conf), OSD (отображение информации с помощью
свойства), JSON IPC, клиентский API (библиотека libmpv) и классический подчиненный режим.

input.conf
Файл input.conf состоит из списка привязок клавиш, например:

s screenshot # сделать снимок экрана с помощью клавиши s
LEFT seek 15 # сопоставьте клавишу со стрелкой влево для перехода вперед на 15 секунд

Каждая строка сопоставляет клавишу с командой ввода. Ключи указаны с их буквальным значением
(верхний регистр в сочетании с Shift) или имя для специальных ключей. Например, a карты для
a клавиша без сдвига, и A карты для a со сдвигом.

Файл находится в каталоге конфигурации mpv (обычно в
~ / .config / mpv / input.conf в зависимости от платформы). Привязки по умолчанию определяются здесь:

https://github.com/mpv-player/mpv/blob/master/etc/input.conf

Список специальных ключей можно получить с помощью
MPV --Input-KeyList

Как правило, ключи можно комбинировать с Shift, Ctrl и другой:

ctrl+q выйти

MPV можно запустить в тестовом режиме ввода, в котором отображаются привязки клавиш и команды
они привязаны к экранному меню, а не к выполнению команд:

mpv --input-test --force-window --idle

(Только закрытие окна сделает MPV выйти, нажатие обычных клавиш просто отобразит
привязка, даже если сопоставлена ​​с выходом.)

Общие вход Command Синтаксис
[Shift+][Ctrl+][Alt+][Meta+] [{ }] [ ] ( )* [;
]

Обратите внимание, что по умолчанию правая клавиша Alt может использоваться для создания специальных символов, и, таким образом,
не регистрируется как модификатор. Опция --no-input-right-alt-gr меняет это поведение.

Новые строки всегда начинают новую привязку. # начинает комментарий (за пределами строки в кавычках
аргументы). Для привязки команд к # ключ, SHARP может быть использован.

является литеральным символом, создаваемым клавишей (символ ASCII или Unicode), или
символическое имя (как напечатано --Input-KeyList).

(скрепленный с { и }) является разделом ввода для этой команды.

Аргументы разделяются пробелом. Это относится даже к строковым аргументам. Для этого
причине, строковые аргументы должны быть заключены в кавычки ". Внутри кавычек можно использовать экранирование в стиле C.
используемый.

Вы можете привязать несколько команд к одной клавише. Например:
шоу-текст "команда 1" ; показать текст "команда 2"

Также возможно привязать команду к последовательности клавиш:
abc show-text "команда запускается после нажатия a, b, c"

(Это не показано в общем синтаксисе команды.)

If a or ab or b уже привязаны, это запустит первую совпадающую команду, а
многоклавишная команда никогда не будет вызываться. Промежуточные клавиши можно переназначить на игнорировать in
чтобы избежать этой проблемы. Максимальное количество (немодифицирующих) клавиш для комбинаций составляет
сейчас 4.

Список of вход Команды
игнорировать Используйте это, чтобы «заблокировать» ключи, которые должны быть развязаны, и ничего не делать. Полезный для
отключение привязок по умолчанию, без отключения всех привязок с помощью
--no-input-default-bindings.

искать [относительный|абсолютный|абсолютный процент|относительный процент|точный|ключевые кадры]
Измените положение воспроизведения. По умолчанию ищет относительное количество секунд.

Второй аргумент состоит из флагов, управляющих режимом поиска:

относительный (По умолчанию)
Поиск относительно текущей позиции (отрицательное значение выполняет поиск назад).

абсолютный
Ищите заданное время.

абсолютный процент
Стремитесь к заданной процентной позиции.

относительный процент
Искать относительно текущей позиции в процентах.

ключевые кадры
Всегда перезапускать воспроизведение на границах ключевых кадров (быстро).

точный Всегда выполняйте точный/часовой/точный поиск (медленно).

Можно комбинировать несколько флагов, например: абсолютные+ключевые кадры.

По умолчанию ключевые кадры используется для относительных поисков, и точный используется для абсолютного
ищет.

До mpv 0.9 ключевые кадры и точный флаги должны были быть переданы как 3-й параметр
(по сути, используя пробел вместо +). Третий параметр все еще анализируется, но
считается устаревшим.

поиск возврата [Режим]
Отменяет искать команда и некоторые другие команды, которые ищут (но не обязательно все
их). Однократный вызов этой команды приведет к переходу к позиции воспроизведения до
искать. Повторный вызов отменяет поиск возврата сама команда. Только это
работает в одном файле.

Первый аргумент является необязательным и может изменить поведение:

отметка Отметьте текущую временную позицию. Следующий нормальный поиск возврата команда будет
искать обратно в эту точку, независимо от того, сколько поисков произошло с прошлого раза.

Использование его без каких-либо аргументов дает вам поведение по умолчанию.

шаг кадра
Воспроизведение одного кадра, затем пауза. Ничего не делает с воспроизведением только аудио.

кадр назад-шаг
Вернитесь на один кадр назад, затем сделайте паузу. Обратите внимание, что это может быть очень медленным (он пытается
точный, а не быстрый) и иногда не работает должным образом. Насколько хорошо это работает
зависит от того, правильно ли работает точный поиск (например, см.
--hr-seek-demuxer-offset вариант). Видеофильтры или другие средства постобработки видео,
изменяет синхронизацию кадров (например, деинтерлейсинг) обычно должно работать, но может
backstepping молча ведет себя неправильно в крайних случаях. С использованием
--hr-seek-framedrop=нет должно помочь, хотя это может замедлить точный поиск.

Это не работает с воспроизведением только аудио.

набор
Установите для данного свойства заданное значение.

добавить [ ]
Добавьте заданное значение к свойству. При переполнении или недостатке зафиксируйте свойство
до максимума. Если опущен, предположим 1.

цикл [вверх|вниз]
Зациклить заданное свойство. up и вниз задать направление цикла. При переполнении установите
верните свойство к минимуму, при потере значимости установите его на максимум. Если up or вниз is
опущен, предположим up.

размножаться
Умножает значение свойства на числовой коэффициент.

Скриншот [субтитры|видео|окно|- [одиночный|каждый кадр]]
Сделайте снимок экрана.

Первый аргумент:

(По умолчанию)
Сохраните видеоизображение в исходном разрешении и с субтитрами. Немного
видеовыходы могут по-прежнему включать экранное меню в выходной сигнал при определенных условиях.
обстоятельствах.


Подобно субтитры, но обычно без экранного меню или субтитров. Точное поведение
зависит от выбранного видеовыхода.


Сохраните содержимое окна mpv. Обычно масштабируется, с OSD и
субтитры. Точное поведение зависит от выбранного видеовыхода, и если
поддержка недоступна, это будет действовать как XNUMX году .


Делайте скриншот каждого кадра. Введите эту команду еще раз, чтобы прекратить прием
скриншоты. Обратите внимание, что вы должны отключить отбрасывание кадров при использовании этого
режим - или вы можете получить дубликаты изображений в случаях, когда кадр был
упавший. Этот флаг можно комбинировать с другими флагами, например
видео+каждый кадр.

скриншот в файл [субтитры|видео|окно]
Сделайте снимок экрана и сохраните его в указанный файл. Формат файла будет
угадывается по расширению (и --скриншот-формат игнорируется - поведение, когда
расширение отсутствует или неизвестно произвольно).

Второй аргумент подобен первому аргументу Скриншот.

Если файл уже существует, он перезаписывается.

Как и все входные параметры команды, имя файла подлежит расширению свойства, т.к.
описанный в Объект расширение.

плейлист-следующий [слабая|сила]
Перейти к следующей записи в списке воспроизведения.

слабый (По умолчанию)
Если в данный момент воспроизводится последний файл в списке воспроизведения, ничего не делайте.

сила Прекратите воспроизведение, если в списке воспроизведения больше нет файлов.

плейлист-пред. [слабая|сила]
Перейти к предыдущей записи в плейлисте.

слабый (По умолчанию)
Если в данный момент воспроизводится первый файл в списке воспроизведения, ничего не делайте.

сила Остановить воспроизведение, если воспроизводится первый файл.

файл загрузки [заменить|добавить|добавить-играть [опции]]
Загрузите данный файл и воспроизведите его.

Второй аргумент:

(По умолчанию)
Остановить воспроизведение текущего файла и немедленно воспроизвести новый файл.


Добавьте файл в список воспроизведения.


Добавьте файл и, если в данный момент ничего не воспроизводится, начните воспроизведение.
(Всегда запускается с добавленным файлом, даже если плейлист не был пуст
перед выполнением этой команды.)

Третий аргумент — это список опций и значений, которые должны быть установлены во время
файл воспроизводится. Он имеет форму вариант1=значение1, вариант2=значение2,... Не все варианты могут
быть изменен таким образом. Некоторые опции требуют перезагрузки плеера.

список загрузки [заменить|добавить]
Загрузите данный файл списка воспроизведения (например, - плейлист).

плейлист-очистить
Очистить список воспроизведения, кроме воспроизводимого в данный момент файла.

плейлист-удалить текущий|
Удалить запись плейлиста по данному индексу. Значения индекса начинают отсчет с 0.
Особая ценность текущий удаляет текущую запись. Обратите внимание, что удаление текущего
запись также останавливает воспроизведение и начинает воспроизведение следующей записи.

плейлист-движение
Переместите запись списка воспроизведения в index1, чтобы она заняла место записи index2.
(Парадоксально, но перемещенная запись плейлиста не будет иметь значение индекса index2 после
перемещение, если index1 был ниже, чем index2, потому что index2 ссылается на целевую запись,
а не индекс, который запись будет иметь после перемещения.)

плейлист-перемешивание
Перемешайте плейлист. Это похоже на то, что делается при запуске, если - перемешать
опция используется.

пробег команду arg1 arg2 ...
Запустите данную команду. В отличие от MPlayer/mplayer2 и более ранних версий mpv
(0.2.x и старше) это не вызывает оболочку. Вместо этого запускается команда
напрямую, каждый аргумент передается отдельно. Каждый аргумент расширяется, как в
Объект расширение. Обратите внимание, что существует статический предел (на момент написания этой статьи) 9
аргументы (это ограничение может быть увеличено по запросу).

Программа запускается в автономном режиме. mpv не ждет, пока команда
завершен, но продолжает воспроизведение сразу после его создания.

Чтобы получить старое поведение, используйте / Бен / ш и -c в качестве первых двух аргументов.

Пример

пробег "/ Бен / ш" "-c" "эхо $ {Название} > /tmp/играет"

Это не очень хороший пример, потому что он не обрабатывает
побега, а специально подготовленный файл может позволить злоумышленнику
выполнять произвольные команды оболочки. Рекомендуется написать небольшой
сценарий оболочки и вызовите его с помощью пробег.

выход [ ]
Выйти из плеера. Если указан аргумент, он используется как код выхода процесса.

выйти-смотреть-позже [ ]
Выйдите из плеера и сохраните текущую позицию воспроизведения. Воспроизведение этого файла позже приведет к поиску
в предыдущее положение при запуске. Аргумент (необязательный) точно такой же, как в
выход команда.

поддобавить [ [ [ ]]]
Загрузите данный файл субтитров. Он выбирается как текущий субтитр после загрузки.

Команда Флаги args — одно из следующих значений:


Выберите субтитры немедленно.


Не выбирайте субтитры. (Или в некоторых особых ситуациях, пусть по умолчанию
решает механизм выбора потока.)


Выберите субтитры. Если субтитры с таким же именем файла уже были добавлены,
этот выбран, вместо того, чтобы загружать повторяющуюся запись. (В таком случае,
название/язык игнорируются, и если они были изменены с момента загрузки, эти
изменения не будут отражены.)

Команда название Аргумент задает название трека в пользовательском интерфейсе.

Команда Ланг аргумент устанавливает язык трека, а также может влиять на выбор потока
Флаги установлен в автоматический.

суб-удалить [ ]
Удалить указанную дорожку субтитров. Если id аргумент отсутствует, удалите текущий
отслеживать. (Работает только с внешними файлами субтитров.)

дополнительная перезагрузка [ ]
Перезагрузите указанные дорожки субтитров. Если id аргумент отсутствует, перезагрузите текущий
отслеживать. (Работает только с внешними файлами субтитров.)

Это работает путем выгрузки и повторного добавления дорожки субтитров.

подшаг
Измените синхронизацию субтитров таким образом, чтобы событие субтитров после следующего подзаголовок
отображаются события. может быть отрицательным, чтобы сделать шаг назад.

суб-искать
Переход к следующему (пропуск установлен на 1) или предыдущему (пропуск установлен на -1) субтитру. Этот
аналогично подшаг, за исключением того, что он ищет видео и аудио вместо настройки
задержка субтитров.

Для встроенных субтитров (например, с Matroska) это работает только с событиями субтитров.
которые уже были отображены или находятся в пределах короткого диапазона предварительной выборки.

экранное [ ]
Переключить уровень экранного меню. Если указан, установите режим экранного меню (см. --osd-уровень для
действительные значения).

печатный текст
Вывести текст на стандартный вывод. Строка может содержать свойства (см. Объект расширение).

показать текст [ |- [ ]]
Показать текст на экранном меню. Строка может содержать свойства, которые раскрываются как
описанный в Объект расширение. Это можно использовать для отображения времени воспроизведения, имени файла,
и т. д.


Время в мс для отображения сообщения. По умолчанию используется то же значение
as --osd-длительность.


Минимальный уровень экранного меню для отображения текста (см. --osd-уровень).

шоу-прогресс
Показать индикатор выполнения, прошедшее время и общую продолжительность файла на
экранное меню.

запись-смотреть-позже-config
Напишите файл конфигурации возобновления, который выйти-смотреть-позже команда пишет, но продолжает
нормальное воспроизведение.

остановить Остановите воспроизведение и очистите список воспроизведения. С настройками по умолчанию это по сути похоже на
выход. Полезно для клиентского API: воспроизведение можно остановить, не прерывая
игрок.

мышь [ [одинарный|двойной]]
Отправить событие мыши с заданной координатой (, ).

Второй аргумент:


Номер кнопки нажатой кнопки мыши. Это должен быть один из 0-19. Если
опущен, будет обновлена ​​только позиция.

Третий аргумент:

(По умолчанию)
Событие мыши представляет собой обычный одиночный щелчок.


Событие мыши представляет собой двойной щелчок.

нажатие клавиши
Отправьте ключевое событие через обработчик ввода mpv, вызывая любое поведение
настроен на этот ключ. имя_ключа использует input.conf схема именования ключей и
модификаторы. Полезно для клиентского API: ключевые события можно отправлять в libmpv для обработки.
внутренне.

нажатие клавиши
Похожий на что нажатие клавиши, но устанавливает КЕЙДАУН флаг, чтобы, если ключ привязан к
повторяемая команда, она будет выполняться повторно с временем повторения ключа mpv до тех пор, пока
клавиатура команда называется.

клавиатура [ ]
Установить КЕЙУП флаг, останавливающий любое повторяющееся поведение, которое было запущено.
имя_ключа не является обязательным. Если имя_ключа не задано или является пустой строкой, КЕЙУП будет
установить на все клавиши. В противном случае, КЕЙУП будет установлен только на ключ, указанный
имя_ключа.

аудио-добавить [ [ [ ]]]
Загрузите данный аудиофайл. Видеть поддобавить команда.

аудио-удалить [ ]
Удалить указанную звуковую дорожку. Видеть суб-удалить команда.

аудио-перезагрузка [ ]
Перезагрузите указанные звуковые дорожки. Видеть дополнительная перезагрузка команда.

пересканировать-внешние-файлы [ ]
Пересканировать внешние файлы в соответствии с текущими --суб-авто и --аудио-файл-авто
настройки. Это можно использовать для автоматической загрузки внешних файлов. после файл был загружен.

Команда Режим аргумент является одним из следующих:

(По умолчанию)
Выберите потоки аудио и субтитров по умолчанию, которые обычно
внешние файлы с наивысшим предпочтением. (Реализация не идеальна,
и могут быть улучшены по запросу.)


Не изменять текущий выбор дорожек.

вход Команды которые Возможно Тема в Изменить
af установить|добавить|переключить|удалить|clr фильтр1=параметры,фильтр2,...
Изменить цепочку аудиофильтров. Видеть vf команда.

vf установить|добавить|переключить|удалить|clr фильтр1=параметры,фильтр2,...
Изменить цепочку видеофильтров.

Первый аргумент решает, что происходит:

набор Перезаписать предыдущую цепочку фильтров новой.

добавить Добавьте новую цепочку фильтров к предыдущей.

тумблер Проверить, есть ли данный фильтр (с точными параметрами) уже в
видео цепочка. Если да, снимите фильтр. Если нет, добавьте фильтр. (Если несколько
в команду передаются фильтры, это делается для каждого фильтра.)

из Удалить указанные фильтры из цепочки видео. В отличие от других случаев,
второй параметр представляет собой список имен фильтров, разделенных запятыми, или целое число.
индексов. 0 будет обозначать первый фильтр. Отрицательные индексы начинаются с
последний фильтр и -1 обозначает последний фильтр.

ясно или небольшая облачность Удалите все фильтры. Обратите внимание, что, как и другие подкоманды, это не
управлять автоматически вставленными фильтрами.

Вы можете назначать метки для фильтрации, добавляя к ним префикс @название: (где имя - это
выбранный пользователем произвольный идентификатор). Метки могут использоваться для обращения к фильтрам по имени.
во всех командах модификации цепочки фильтров. За добавить, используя уже использованный
ярлык заменит существующий фильтр.

Команда vf Команда показывает список запрошенных фильтров в экранном меню после изменения
цепочка фильтров. Это примерно эквивалентно показать текст ${vf}, Обратите внимание, что
автоматически вставляемые фильтры для конвертации форматов не отображаются в списке, только те, которые
был запрошен пользователем.

Обычно команды проверяют, воссоздана ли цепочка видео.
успешно и отменит операцию в случае неудачи. Если команда выполняется до
видео настроено (может случиться, если команда запускается сразу после открытия
файла и до того, как видеокадр будет декодирован), эта проверка не может быть запущена. Тогда он может
случается, что создание цепочки видео не удается.

Пример для input.conf

· a vf набор флип перевернуть видео вверх ногами a ключ

· b vf набор "" удалить все видеофильтры на b

· c vf тумблер лавфи = градфан включить удаление полос c

значения цикла ["!обеспечить регресс"] ...
Циклический просмотр списка значений. Каждый вызов команды будет устанавливать заданный
к следующему значению в списке. Команда поддерживает внутренний счетчик
какое значение выбрать следующим, а какое изначально равно 0. Оно сбрасывается на 0 после последнего
значение достигнуто.

Внутренний счетчик связан с использованием имени свойства и списка значений. Если
несколько команд (привязанных к разным клавишам) используют одно и то же имя и список значений, они
поделится внутренним счетчиком.

Особый аргумент !обеспечить регресс можно использовать для циклического перебора списка значений в обратном порядке.
По сравнению с командой, которая просто выводит значение в обратном порядке, эта команда будет
фактически совместно использовать внутренний счетчик с привязкой клавиш прямого цикла (пока
так как остальные аргументы те же).

Обратите внимание, что существует статический предел (на момент написания этой статьи) в 10 аргументов (этот предел
могут быть подняты по требованию).

включить раздел [флаги]
Включите все привязки клавиш в именованном разделе ввода.

Включенные разделы ввода образуют стек. Крепления в секциях в верхней части
стек предпочтительнее нижних секций. Эта команда помещает раздел поверх
куча. Если секция уже была в стеке, она неявно удаляется
заранее. (Раздел не может находиться в стеке более одного раза.)

Команда Флаги параметр может быть комбинацией (разделенной +) из следующих флагов:


Все разделы, включенные до нового включенного раздела, отключены. Они
будут снова включены, как только все эксклюзивные разделы над ними будут удалены.
Другими словами, новый раздел затеняет все предыдущие разделы.


Эту функцию нельзя использовать через общедоступный API.


Одна и та же.

отключить раздел
Отключите именованный раздел ввода. Отменяет включить раздел.

определить раздел [по умолчанию|принудительно]
Создайте именованный раздел ввода или замените содержимое уже существующего ввода
раздел. фактов параметр использует тот же синтаксис, что и input.conf файл (кроме
что использование синтаксиса раздела в нем не допускается), в том числе необходимость разделения
привязки с символом новой строки.

Если же линия индикатора фактов параметр - пустая строка, секция удалена.

Раздел с названием по умолчанию является нормальной входной секцией.

Как правило, разделы ввода должны быть включены с помощью включить раздел команда, или
они игнорируются.

Последний параметр имеет следующее значение:

(В том числе использовал if параметр опущен)
Используйте привязку клавиш, определенную в этом разделе, только если пользователь еще не
привязал этот ключ к команде.


Всегда связывайте ключ. (Секция ввода, которая была активизирована последним
выигрывает, если есть неясности.)

оверлей-добавить
Добавьте наложение OSD, полученное из необработанных данных. Это может быть полезно для скриптов и
приложения, управляющие mpv, и которые хотят отображать что-то поверх видео
окно.

Оверлеи обычно отображаются в разрешении экрана, но с некоторыми VO
разрешение уменьшено до разрешения видео. Вы можете прочитать OSD-ширина и
OSD-высота характеристики. По крайней мере, с --vo-xv и анаморфотное видео (например, DVD),
OSD-пар также должны быть прочитаны, а наложение должно быть с компенсацией аспектов.
(Будущие направления: возможно, MPV должен позаботиться о некоторых из этих вещей
автоматически, но трудно сказать, где провести черту.)

id представляет собой целое число от 0 до 63, идентифицирующее элемент наложения. Идентификатор может быть
используется для добавления нескольких частей наложения, обновите часть с помощью этой команды с
уже существующий идентификатор, или удалить часть с наложение-удалить. Используя ранее
неиспользуемый идентификатор добавит новый оверлей, а повторное использование идентификатора обновит его. (Будущее
направления: должно быть что-то, чтобы обеспечить различные программы, желающие
создавать наложения, не конфликтующие друг с другом, если это когда-либо понадобится.)

x и y укажите положение, в котором должно отображаться экранное меню.

файл указывает файл, из которого считываются необработанные данные изображения. Это может быть либо числовое
Дескриптор файла UNIX с префиксом @ (например @4), или имя файла. Файл будет
отображается в памяти с mmap (). Некоторые ВО передают сопоставленный указатель непосредственно
отображать API (например, opengl или vdpau), поэтому фактическое копирование не требуется. Усечение
исходный файл при активном оверлее приведет к сбою проигрывателя. Вы не должны
изменять данные, пока активен оверлей, потому что данные по существу
доступ в случайных точках. Вместо этого позвоните оверлей-добавить снова (желательно с
другую область памяти, чтобы предотвратить разрыв).

Также можно передать необработанный адрес памяти для использования в качестве растровой памяти с помощью
передача адреса памяти в виде целого числа с префиксом & персонаж. Прохождение
неправильная вещь здесь приведет к сбою игрока. Этот режим может быть полезен для использования с
либмпв. То смещение параметр просто добавляется к адресу памяти (поскольку mpv
0.8.0, ранее игнорировался).

смещение — смещение в байтах первого пикселя в исходном файле. (Электрический ток
реализация всегда mmap представляет весь файл с позиции 0 до конца
изображения, поэтому следует избегать больших смещений. До mpv 0.8.0 смещение было
фактически перешел непосредственно к ММАП, но он был изменен, чтобы упростить его использование.)

FMT это строка, идентифицирующая формат изображения. В настоящее время только бгра определено. Этот
Формат имеет 4 байта на пиксель, по 8 бит на компонент. Наименее значимый 8
биты выделены синим цветом, а старшие 8 битов — альфа-каналом (в
компоненты - BGRA, с B в качестве первого байта). Здесь используется предварительно умноженная альфа: каждый
компонент цвета уже умножен на альфа-компонент. Это означает
числовое значение каждого компонента равно или меньше альфа-компонента.
(Нарушение этого правила приведет к разным результатам для разных ВО: числовые
переполнения, возникающие в результате смешивания сломанных альфа-значений, считаются чем-то, что
не должно происходить, и, следовательно, реализации не гарантируют, что вы получите
предсказуемое поведение в этом случае.)

w, h и шаг указать размер наложения. w видимая ширина
наложение, в то время как шаг дает ширину в байтах в памяти. В простом случае и
с бгра формат, шаг==4*ш. В общем, общий объем доступной памяти
is шаг * h. (Технически минимальный размер будет шаг * (h - 1) + w * 4,
но для простоты игроку будут доступны все шаг * h байтов.)

Предупреждение

При обновлении оверлея следует подготовить вторую общую память
регион (например, используйте параметр смещения) и добавьте его как наложение,
вместо повторного использования одной и той же памяти каждый раз. В противном случае вы можете получить
эквивалент разрыва, когда ваше приложение и mpv пишут/читают
буфер одновременно. Кроме того, имейте в виду, что mpv может получить доступ к
память оверлея в случайные моменты времени всякий раз, когда он чувствует необходимость сделать это, для
пример при перерисовке экрана.

наложение-удалить
Удалить наложение, добавленное с помощью оверлей-добавить и тот же идентификатор. Ничего не делает, если нет
оверлей с этим идентификатором существует.

скрипт-сообщение ...
Отправьте сообщение всем клиентам и передайте ему следующий список аргументов. Что
это сообщение означает, сколько аргументов оно принимает, и что означают аргументы
полностью зависит от получателя и отправителя. Каждый клиент получает сообщение, так что будьте
будьте осторожны с конфликтами имен (или используйте script_message_to).

сценарий-сообщение-к ...
Такой же как script_message, но отправить его только клиенту с именем . Каждый клиент
(скрипты и т.д.) имеет уникальное имя. Например, Lua-скрипты могут получить свое имя через
mp.get_script_name().

привязка сценария
Вызвать привязку клавиш, предоставленную сценарием. Это можно использовать для переназначения привязок клавиш
предоставляется внешними сценариями Lua.

Аргумент — это имя привязки.

При желании к нему можно добавить префикс имени сценария, используя / как разделитель,
или script_binding имя сценария/имя привязки.

Для полноты, вот как эта команда работает внутри. Детали могут
изменить в любое время. При любом соответствующем ключевом событии script_message_to or script_message is
вызывается (в зависимости от того, включено ли имя скрипта), где первый аргумент
это строка связывание ключей, второй аргумент — это имя привязки, а
третий аргумент — это состояние ключа в виде строки. Ключевое состояние состоит из ряда
буквы. Первая буква одна из d (клавиша была нажата), u (был выпущен), r
(клавиша все еще нажата и повторяется; только если для этого включен повтор клавиши
обязательное), p (клавиша была нажата; происходит, если вверх/вниз нельзя отследить). Секунда
письмо, исходит ли событие от мыши, либо m (кнопка мыши) или -
(что-то другое).

ab-петля
Циклическое переключение между состояниями петли AB. Первая команда установит A точка (
аб-петля-а имущество); второй B точку, а третья очистит обе точки.

vo-cmdline
Сбросить подопцию текущего ВО. В настоящее время работает с OpenGL (В том числе
opengl-hq). Аргумент представляет собой строку подопции, обычно передаваемую ВО на
командная строка. Не все подопции могут быть установлены, но те, которые могут быть сброшены
даже если они не появляются в аргументе. Эта команда может быть изменена или
удалено в будущем.

дроп-буферы
Удалите буферы аудио/видео/демультиплексора и перезапустите заново. Может помочь с
неуловимые потоки, которые выходят из синхронизации. Эта команда может быть изменена или
удалено в будущем.

необработанный скриншот [субтитры|видео|окно]
Вернуть скриншот в память. Это можно использовать только через клиентский API. То
MPV_FORMAT_NODE_MAP, возвращаемый этой командой, имеет w, h, шаг поля установлены на
очевидное содержание. А формат поле установлено на бгр0 по умолчанию. Этот формат
организован как Б8Г8Р8Х8 (где B это LSB). Содержимое заполнения X is
неопределенный. То данным поле имеет тип MPV_FORMAT_BYTE_ARRAY с фактическим изображением
данные. Изображение освобождается, как только освобождается узел результата.

Недокументированные команды: тв-последний канал (только ТВ/DVB), АО-перезагрузка (экспериментальный/внутренний).

Крючки
Хуки — это синхронные события между ядром проигрывателя и скриптом или чем-то подобным. Это относится к
клиентский API (включая интерфейс сценариев Lua). Обычно события должны быть
асинхронный, а API-интерфейс ловушки предоставляет неуклюжий и неясный способ обработки событий, которые
требуют более строгой координации. Гарантий стабильности API нет. Не подписан
протокол точно может заставить игрока зависнуть случайным образом. В принципе, никто не должен использовать
этот API.

Здесь задействованы две специальные команды. Кроме того, клиент должен прослушивать клиентские сообщения.
(MPV_EVENT_CLIENT_MESSAGE в C API).

крюк-добавить
Подпишитесь на ловушку, идентифицированную первым аргументом (в основном, именем
событие). То id аргумент представляет собой произвольное целое число, выбранное пользователем. приоритет is
используется для глобальной сортировки всех обработчиков ловушек для всех клиентов. Каждый клиент может
зарегистрировать несколько обработчиков хуков (даже для одного и того же имени хука). Как только крючок
зарегистрирован, его нельзя отменить.

Когда происходит определенное событие, все зарегистрированные обработчики запускаются последовательно. Это использует
протокол, которому каждый клиент должен следовать явно. Когда запускается обработчик ловушки,
сообщение клиента (MPV_EVENT_CLIENT_MESSAGE) отправляется клиенту, зарегистрировавшему
крюк. Это сообщение имеет следующие аргументы:

1. строка крючок_run

2. id аргумент, с которым хук был зарегистрирован как строка (его можно использовать для
правильно обрабатывать несколько ловушек, зарегистрированных одним и тем же клиентом, если id
аргумент уникален в клиенте)

3. что-то неопределенное, используемое механизмом ловушек для отслеживания выполнения ловушек.
(в настоящее время это имя хука, но оно может измениться без предупреждения)

Получив это сообщение, клиент может обработать событие. При этом,
Ядро проигрывателя по-прежнему будет реагировать на запросы, но обычно воспроизведение будет остановлено.

Когда клиент завершит работу, он должен продолжить выполнение ловушки ядра, запустив
крючок команда.

крючок
Запустите следующий хук в глобальной цепочке хуков. Аргумент является третьим аргументом
клиентское сообщение, запускающее выполнение ловушки для текущего клиента.

В настоящее время определены следующие хуки:

в процессе
Вызывается, когда файл должен быть открыт, прежде чем что-либо будет сделано. Например,
Вы могли читать и писать имя-файла-открытия-потока свойство для перенаправления URL-адреса на
что-то еще (подумайте о поддержке потоковых сайтов, которые редко дают пользователю
прямой URL-адрес мультимедиа), или вы можете установить параметры для каждого файла, установив свойство
локальные параметры файла/ имя>. Игрок будет ждать, пока не будут запущены все хуки.

on_unload
Выполнить перед закрытием файла и перед фактической деинициализацией всего. Это не
можно возобновить воспроизведение в этом состоянии.

вход Command Приставки
Эти префиксы помещаются между именем ключа и фактической командой. Несколько префиксов могут
быть указано. Они разделены пробелом.

OSD-авто (По умолчанию)
Используйте поведение по умолчанию для этой команды.

нет OSD Не используйте OSD для этой команды.

OSD-бар
Если возможно, покажите панель с помощью этой команды. Команды поиска покажут прогресс
bar, команды изменения свойств могут отображать новое установленное значение.

OSD-MSG
Если возможно, покажите сообщение OSD с помощью этой команды. Команда Seek показывает текущую
время воспроизведения, команды изменения свойства отображают новое установленное значение в виде текста.

OSD-MSG-бар
Объедините osd-bar и osd-msg.

сырье Не раскрывайте свойства в строковых аргументах. (Нравится "${имя-свойства}".)

развернуть-свойства (По умолчанию)
Все строковые аргументы расширяются, как описано в Объект расширение.

повторяемый
Для некоторых команд удерживание клавиши нажатой не приводит к повторному запуску команды. Этот
префикс заставляет повторять ключ в любом случае.

Все префиксы osd по-прежнему переопределяются глобальным --osd-уровень настройки.

вход Разделы
Разделы ввода группируют набор привязок и включают или отключают их одновременно. В
input.conf, каждая привязка клавиш назначается разделу ввода, а не фактически
явные текстовые разделы.

Также см включить_раздел и отключить_раздел команды.

Предопределенные привязки:

по умолчанию
Привязки без раздела ввода неявно назначаются этому разделу. это
включен по умолчанию во время обычного воспроизведения.

шифровать Раздел, активный в режиме кодирования. Он включен исключительно, так что
привязки в по умолчанию разделы игнорируются.

НЕДВИЖИМОСТИ
Свойства используются для установки параметров mpv во время выполнения или для запроса произвольной информации.
Ими можно манипулировать с помощью набор/добавить/цикл команды и извлекается с помощью показать текст или
все остальное, что использует расширение свойства. (Видеть Объект расширение.)

Имя свойства снабжено аннотацией RW, чтобы указать, является ли свойство обычно
доступный для записи.

Если указан параметр, свойство обычно принимает/возвращает точно такие же значения.
как вариант. В этих случаях свойства — это просто способ изменить параметр во время выполнения.

Объект список
OSD-уровень (РВ)
Посмотреть --osd-уровень.

OSD-шкала (РВ)
Множитель размера шрифта OSD, см. --osd-шкала.

поиска (РВ)
Посмотреть --петля.

циклический файл (РВ)
Посмотреть --loop-файл (использование Да/нет).

скорость (РВ)
Посмотреть --скорость.

коррекция скорости звука, коррекция скорости видео
Коэффициент, умноженный на скорость при котором проигрыватель пытается воспроизвести файл. Как правило
это ровно 1. (Режим синхронизации дисплея сделает это полезным.)

Форматирование экранного меню отобразит его в виде + 1.23456%, с номером (сырье
- 1) * 100 для данного необработанного значения свойства.

дисплей-синхронизация-активный
Вернуть ли --video-sync=дисплей на самом деле активен.

имя файла
Воспроизводимый в данный момент файл с удаленным путем. Если это URL, попробуйте отменить процент
также кодирование. (Результат не обязательно правильный, но выглядит лучше для
дисплейные цели. Использовать путь свойство, чтобы получить неизмененное имя файла.)

размер файла
Длина в байтах исходного файла/потока. (Это то же самое, что ${конец потока}. Для
упорядоченные главы и т. д., возвращается размер воспроизводимого в данный момент сегмента.)

расчетное количество кадров
Общее количество кадров в текущем файле.

ПРИМЕЧАНИЕ:
Это только оценка. (Он вычисляется из двух ненадежных величин: fps и
длина потока.)

предполагаемое число кадров
Номер текущего кадра в текущем потоке.

ПРИМЕЧАНИЕ:
Это только оценка. (Он вычисляется из двух ненадежных величин: fps и
возможно округленные временные метки.)

путь Полный путь к воспроизводимому в данный момент файлу. Обычно это та же самая строка, которую вы
передать в командной строке mpv или файл загрузки команда, даже если это относительный путь.
Если вы ожидаете абсолютный путь, вам придется определить его самостоятельно, например
с помощью рабочий каталог имущество.

медиа-заголовок
Если текущий воспроизводимый файл имеет название тег, используйте его.

В противном случае, если тип носителя — DVD, вернуть идентификатор тома DVD.

В противном случае верните имя файла имущество.

формат файла
Символьное имя формата файла. В некоторых случаях это список, разделенный запятыми.
названия форматов, например, mp4 mov,mp4,m4a,3gp,3g2,mj2 (список может увеличиться в будущем
для любого формата).

демультиплексор
Имя текущего демультиплексора. (Это бесполезно.)

поток-путь
Имя файла (полный путь) имени файла слоя потока. (Вероятно, это бесполезно.
похоже, что это может отличаться от путь только при использовании, например, упорядоченных глав.)

поток-pos (РВ)
Необработанная позиция байта в исходном потоке.

конец потока
Необработанная конечная позиция в байтах в исходном потоке.

продолжительность
Длительность текущего файла в секундах. Если продолжительность неизвестна, свойство
недоступен. Обратите внимание, что продолжительность файла не всегда точно известна, поэтому
оценка.

Это заменяет свойство, которое устарело после выпуска mpv 0.9.
(Семантика та же.)

авсинк Последняя разница синхронизации аудио/видео. Недоступно, если звук или видео отключены.

общее изменение avsync
Выполнена полная коррекция синхронизации AV. Недоступно, если звук или видео отключены.

количество пропущенных кадров
Видеокадры отбрасываются декодером, потому что видео слишком сильно отстает от звука (при использовании
--framedrop=декодер). Иногда это может быть увеличено в других ситуациях, например
когда видеопакеты повреждены или декодер не следует обычным правилам.
Недоступно, если видео отключено.

vo-дроп-количество кадров
Кадры, пропущенные VO (при использовании --framedrop=во).

неправильный подсчет кадров
Количество видеокадров, которые не были правильно синхронизированы в режиме синхронизации дисплея для
ради сохранения синхронизации A/V. Сюда не входят внешние обстоятельства, такие как
рендеринг видео слишком медленный или графический драйвер каким-то образом пропускает вертикальную синхронизацию. Это
также не включает ошибки округления (что может случиться, особенно при плохом
временные метки источника). Например, с помощью десинхронизация дисплея режим никогда не должен меняться
это значение от 0.

vsync-коэффициент
За какое количество vsync в среднем отображается кадр. Это доступно, если
синхронизация дисплея активна только. Для видео с частотой 30 кадров в секунду на экране с частотой 60 Гц это будет 2.
Это скользящее среднее того, что на самом деле было запланировано, то есть 24 кадра в секунду на частоте 60 Гц.
никогда не останется ровно на 2.5, а дрожит в зависимости от последнего отображаемого кадра.

количество кадров с задержкой vo
Расчетное количество кадров, задержанных из-за внешних обстоятельств при синхронизации дисплея
режим. Обратите внимание, что в общем случае mpv должен догадаться, что это происходит, и догадка
может быть неточным.

процент-поз (РВ)
Позиция в текущем файле (0-100). Преимущество перед использованием этого вместо
вычисление его из других свойств заключается в том, что оно правильно возвращается к оценке
позицию воспроизведения из позиции байта, если продолжительность файла неизвестна.

время-поз (РВ)
Позиция в текущем файле в секундах.

начало времени
Устарело. Всегда возвращает 0. До mpv 0.14 это использовалось для возврата времени начала.
файла (может повлиять, например, на транспортные потоки). Видеть --rebase-время начала опцию.

оставшееся время
Оставшаяся длина файла в секундах. Обратите внимание, что продолжительность файла не всегда
точно известно, так что это оценка.

оставшееся время воспроизведения
оставшееся время масштабируется по текущему скорость.

время воспроизведения (РВ)
Позиция в текущем файле в секундах. в отличие время-поз, время зажато до
диапазон файла. (Неточная продолжительность файла и т. д. может привести к тому, что он выйдет за пределы допустимого диапазона.
Также полезно, когда пользователь пытается выполнить поиск за пределами файла, поскольку цель поиска
время считается текущей позицией во время поиска.)

глава (РВ)
Текущий номер главы. Номер первой главы 0.

edition (РВ)
Текущий номер редакции MKV. Установка для этого свойства другого значения приведет к перезапуску.
воспроизведение. Номер первого издания 0.

названия дисков
Количество заголовков BD/DVD.

Это имеет ряд подсвойств. Заменять N с индексом издания, начинающимся с 0.

названия дисков/количество
Количество титулов.

названия дисков/идентификатор
Идентификатор заголовка в виде целого числа. В настоящее время это то же самое, что и указатель заголовков.

названия дисков/длина
Длина в секундах. Может быть недоступен в ряде случаев (в настоящее время
работает только для libdvdnav).

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (для каждого издания)
"идентификатор" MPV_FORMAT_INT64
"длина" MPV_FORMAT_DOUBLE

список названий дисков
Список названий BD/DVD.

название диска (РВ)
Текущий номер заголовка BD/DVD. Письмо работает только для dvdnav: // и bd: // (И
псевдонимы для них).

главы
Количество глав.

Издания
Количество редакций MKV.

список изданий
Список изданий, отмечена текущая запись. В настоящее время необработанное значение свойства равно
бесполезный.

Это имеет ряд подсвойств. Заменять N с индексом издания, начинающимся с 0.

список/количество изданий
Количество выпусков. Если выпусков нет, это может быть 0 или 1 (1, если
есть бесполезное фиктивное издание).

список-изданий/N/id
Идентификатор издания в виде целого числа. Используйте это, чтобы установить edition имущество. В настоящее время,
это то же самое, что индекс издания.

список-изданий/N/по умолчанию
Да если это издание по умолчанию, нет в противном случае.

список-изданий/N/название
Название издания, сохраненное в файле. Не всегда доступно.

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (для каждого издания)
"идентификатор" MPV_FORMAT_INT64
"название" MPV_FORMAT_STRING
"по умолчанию" MPV_FORMAT_FLAG

аб-петля-а, аб-петля-б (РВ)
Установка/получение точек петли AB. См. соответствующие опции и ab_loop команда.
особая ценность нет в любом из этих свойств отключает зацикливание.

угол (РВ)
Текущий угол DVD.

метаданных
Пары ключ/значение метаданных.

Если доступ к свойству осуществляется с помощью Lua mp.get_property_native, это возвращает таблицу
с сопоставлением ключей метаданных со значениями метаданных. Если к нему обращаются с клиентом
API, это возвращает MPV_FORMAT_NODE_MAP, с сопоставлением ключей тегов со значениями тегов.

Для OSD возвращает отформатированный список. Попытка получить это свойство как необработанное
строка не работает.

Это имеет ряд подсвойств:

метаданные/по ключу/
Значение записи метаданных .

метаданные/список/количество
Количество записей метаданных.

метаданные/список/N/ключ
Ключевое имя N-й записи метаданных. (Первая запись 0).

метаданные/список/N/значение
Значение N-й записи метаданных.

метаданные/
Старая версия метаданные/по ключу/. Использование не рекомендуется, поскольку
Строка ключа метаданных может конфликтовать с другими подсвойствами.

Планировка этого свойства может быть изменена. Предложения приветствуются, как
именно это свойство должно работать.

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_MAP
(ключ и строковое значение для каждой записи метаданных)

отфильтрованные метаданные
Подобно метаданных, но включает только поля, перечисленные в --display-теги вариант. Этот
это тот же набор тегов, который выводится на терминал.

метаданные главы
Метаданные текущей главы. Работает аналогично метаданных имущество. Это также позволяет
одинаковые методы доступа (используя подсвойства).

Метаданные по главам встречаются очень редко. Обычно указывается только название главы (название) установлен.

Для доступа к другой информации, такой как начало главы, см. список глав имущество.

vf-метаданные/
Метаданные добавляются видеофильтрами. Доступ к метке фильтра, которая, если не
явно указано с помощью @filter-метка: синтаксис будет NN.

Работает аналогично метаданных имущество. Он допускает те же методы доступа (используя
подсвойства).

Примером таких метаданных являются параметры обрезки, добавленные
--vf=lavfi=кропдетект.

аф-метаданные/
Эквивалентно vf-метаданные/, но для аудиофильтров.

Пауза (РВ)
Статус паузы. Обычно это Да or нет. Посмотреть --Пауза.

холостой ход ВОЗВРАТ Да если ни один файл не загружается, но проигрыватель не работает из-за
--праздный опцию.

бездействие ядра
ВОЗВРАТ Да если ядро ​​воспроизведения поставлено на паузу, иначе нет. Это может быть разным
Пауза в особых ситуациях, например, когда проигрыватель ставит себя на паузу из-за низкого
сетевой кеш.

Это также возвращает Да если воспроизведение перезапускается или вообще ничего не воспроизводится. В
Другими словами, это всего лишь нет если на самом деле воспроизводится видео. (Поведение после mpv
0.7.0.)

кэш Состояние заполнения сетевого кэша (0-100.0).

размер кэша (РВ)
Размер сетевого кэша в КБ. Это похоже на --кэш. Это позволяет установить кеш
размер во время выполнения. В настоящее время невозможно включить или отключить кеш на
время выполнения, использующее это свойство, просто для изменения размера существующего кеша.

Это не включает размер заднего буфера (измененный после mpv 0.10.0).

Обратите внимание, что это пытается максимально сохранить содержимое кеша. Чтобы сделать это
проще, код изменения размера кеша будет выделять новый кеш, в то время как старый кеш
еще выделили.

Не используйте это при воспроизведении DVD или Blu-ray.

без кеша (R)
Общий размер свободного кэша в КБ.

использованный кеш (R)
Общий размер используемого кэша в КБ.

бездействующий кэш (R)
Returns Да если кеш простаивает, это означает, что кеш заполнен настолько, насколько
возможно, и в настоящее время не читает больше данных.

демультиплексор-кеш-продолжительность
Приблизительная продолжительность видео, буферизованного в демультиплексоре, в секундах. Догадка
очень ненадежны, и часто свойство будет вообще недоступно, даже если данные
буферизуется.

демультиплексор-кэш-время
Приблизительное время буферизации видео в демультиплексоре в секундах. Такой же как
демультиплексор-кеш-продолжительность но возвращает последнюю метку времени буферизованных данных в демультиплексоре.

демультиплексор-кэш-бездействие
Returns Да если демультиплексор простаивает, это означает, что кэш демультиплексора заполнен до
запрошенная сумма, и в настоящее время не считывает больше данных.

приостановлено для кеша
Returns Да когда воспроизведение приостановлено из-за ожидания кэша.

кэш-буферизация-состояние
Возвращает процент (0-100) статуса заполнения кеша, пока игрок не
снять паузу (относится к приостановлено для кеша).

недостигнутый
Returns Да если был достигнут конец воспроизведения, нет в противном случае. Обратите внимание, что это обычно
интересно только если - держать открытым включен, иначе проигрыватель
немедленно воспроизвести следующий файл (или выйти или войти в режим ожидания), и в этих случаях
недостигнутый свойство будет логически очищено сразу после его установки.

поиск
Returns Да если игрок в данный момент ищет или иным образом пытается перезапустить
воспроизведение. (Возможно, что он возвращается Да во время загрузки файла или когда
переключение упорядоченных сегментов главы. Это потому, что один и тот же базовый код
используется для поиска и повторной синхронизации.)

час-искать (РВ)
Посмотреть --hr-искать.

объем (РВ)
Текущий объем (см. --объем для более подробной информации).

немой (РВ)
Текущий статус отключения звука (Да/нет).

аудио-задержка (РВ)
Посмотреть --аудио-задержка.

аудиокодек
Аудиокодек выбран для декодирования.

имя аудиокодека
Аудио кодек.

аудио-параметры
Формат аудио, выводимый аудиодекодером. Это имеет ряд подсвойств:

аудио-параметры/формат
Образец формата в виде строки. Здесь используются те же имена, что и в других
места мпв.

аудио-параметры/частота дискретизации
Частота дискретизации.

аудио-параметры/каналы
Макет канала в виде строки. Это похоже на то, что --аудиоканалы
принимает.

аудио-параметры/час-каналы
As каналы, но вместо возможно загадочного фактического макета, отправленного в
аудиоустройство, верните, надеюсь, более удобочитаемую форму. (обычно только
параметры аудиовыхода/час-каналы имеет смысл.)

аудио-параметры/количество каналов
Количество аудиоканалов. Это избыточно для каналы поле описано
выше.

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_MAP
"формат" MPV_FORMAT_STRING
"частота дискретизации" MPV_FORMAT_INT64
"каналы" MPV_FORMAT_STRING
"число каналов" MPV_FORMAT_INT64
"ч-каналы" MPV_FORMAT_STRING

параметры аудиовыхода
Такой же как аудио-параметры, но формат данных, записываемых в аудио API.

помощь (РВ)
Текущая звуковая дорожка (аналогично --помогать).

аудио (РВ)
Псевдоним для помощь.

(баланс) (РВ)
Баланс аудиоканалов. (Реализация этой функции довольно странная.
не изменяет громкость каждого канала, а вместо этого устанавливает матрицу панорамирования для микширования
левый и правый каналы).

полноэкранный режим (РВ)
Посмотреть --полноэкранный.

деинтерлейсинг (РВ)
Посмотреть --деинтерлейсинг.

преобладание поля (РВ)
Посмотреть --поле-доминирование

цветовая матрица (R)
Перенаправления на видеопараметры/цветовая матрица. Этот параметр (как и аналогичные) может
быть отвергнутым формат видео фильтр.

цветовая матрица-диапазон ввода (R)
Посмотреть цветовая матрица.

видео-выход-уровни (РВ)
Посмотреть --видео-выходные уровни,

основные цвета матрицы (R)
Посмотреть цветовая матрица.

наверх (РВ)
Посмотреть --наверху.

граница (РВ)
Посмотреть --граница.

на всех рабочих местах (РВ)
Посмотреть --на всех рабочих пространствах. Снятие с охраны может работать не на всех WM.

рамка (РВ)
Посмотреть --framedrop.

гамма (РВ)
Посмотреть --гамма.

яркость (РВ)
Посмотреть - яркость.

контраст (РВ)
Посмотреть - контраст.

насыщение (РВ)
Посмотреть --насыщенность.

оттенок (РВ)
Посмотреть - оттенок.

hwdec (РВ)
Отражает --hwdec опцию.

Запись в него может изменить используемый в настоящее время аппаратный декодер, если это возможно.
(Внутри проигрыватель может повторно инициализировать декодер и выполнить поиск
обновите видео должным образом.) Вы можете просмотреть другие свойства hwdec, чтобы увидеть
было ли это успешным.

В отличие от mpv 0.9.x и ранее, это не возвращает текущее активное оборудование.
декодер.

hwdec-активный
ВОЗВРАТ Да or нет, в зависимости от того, используется ли фактически какой-либо тип аппаратного декодирования.
использовать.

hwdec-обнаружено
Если программное декодирование активно, возвращается используемый аппаратный декодер.
В противном случае он возвращает либо нетили, если применимо, текущее загруженное оборудование
API декодирования. Это известно только после открытия ВО (а возможно и позже). С участием
некоторые VO (например, OpenGL), это никогда не известно заранее, а только тогда, когда декодер
попытка создать аппаратный декодер успешно. Кроме того, аппаратные декодеры с -копию
суффикс вернется нет пока видео не декодируется. Все это отражает то, как
обнаружение аппаратных декодеров обнаруживается и используется внутри mpv.

панскан (РВ)
Посмотреть --panscan.

видео-формат
Формат видео в виде строки.

видео кодек
Видеокодек, выбранный для декодирования.

ширина, высота
Размер видео. При этом используется размер видео в том виде, в каком он был декодирован, или если нет видеокадра.
еще не расшифрован, контейнер (возможно, неправильный) указал размер.

видео-параметры
Параметры видео, выводимые декодером (с переопределениями, такими как соотношение сторон и т. д.
применяемый). Это имеет ряд подсвойств:

видео-параметры/формат пикселя
Формат пикселей в виде строки. Здесь используются те же имена, что и в других местах.
из мвв.

видео-параметры/средний бит/сек
Среднее количество бит на пиксель в виде целого числа. Планарные форматы с субдискретизацией используют другой
разрешение, поэтому это значение иногда может быть нечетным или
сбивает с толку. Может быть недоступен для некоторых форматов.

видеопараметры/глубина плоскости
Битовая глубина для каждого компонента цвета в виде целого числа. Это выставлено только для
планарных или однокомпонентных форматах и ​​недоступен для других форматов.

видео-параметры/w, видеопараметров/ч
Размер видео в виде целых чисел без применения коррекции соотношения сторон.

видео-параметры/dw, видео-параметры/dh
Размер видео в виде целых чисел, отмасштабированных для правильного соотношения сторон.

видео-параметры/формат
Отображать соотношение сторон как плавающее.

видео-параметры/пар
Соотношение сторон пикселя.

видеопараметры/цветовая матрица
Цветовая матрица используется как строка. (Точные значения могут быть изменены.)

видео-параметры/уровни цвета
Уровни цвета в виде строки. (Точные значения могут быть изменены.)

видео-параметры/основные
Основные цвета используются в качестве строки. (Точные значения могут быть изменены.)

видео-параметры/гамма
Гамма-функция используется как строка. (Точные значения могут быть изменены.)

видеопараметры/цветность-местоположение
Расположение цветности в виде строки. (Точные значения могут быть изменены.)

видео-параметры/поворот
Предполагаемый поворот дисплея в градусах (по часовой стрелке).

видеопараметры/стерео-вход
Исходный файл стерео 3D режим. (Видеть --видео-стерео-режим опция).

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_MAP
"формат пикселя" MPV_FORMAT_STRING
"ж" MPV_FORMAT_INT64
"ч" MPV_FORMAT_INT64
"дв" MPV_FORMAT_INT64
"дч" MPV_FORMAT_INT64
"аспект" MPV_FORMAT_DOUBLE
"пар" MPV_FORMAT_DOUBLE
"цветовая матрица" MPV_FORMAT_STRING
"уровни цвета" MPV_FORMAT_STRING
"основные" MPV_FORMAT_STRING
"расположение цветности" MPV_FORMAT_STRING
"повернуть" MPV_FORMAT_INT64
"стерео-вход" MPV_FORMAT_STRING

ширина, высота
Размер экрана видео. Это размер видео после применения фильтров и масштабирования.
было применено. Фактический размер видеоокна может отличаться от этого, например
если пользователь вручную изменил размер видеоокна.

Они имеют те же значения, что и параметры видеовыхода/dw и параметры видеовыхода/dh.

параметры видеовыхода
Такой же как видео-параметры, но после применения видеофильтров. если нет
используемые видео фильтры, это будет содержать те же значения, что и видео-параметры, Обратите внимание, что
это еще не обязательно то, что использует видеоокно, так как пользователь может изменить
размер окна, и все реальные VO делают свое собственное масштабирование независимо от
цепочка фильтров.

Имеет те же подсвойства, что и видео-параметры.

информация о видеокадре
Приблизительная информация о текущем кадре. Обратите внимание, что если какой-либо из них используется на
OSD, информация может отличаться на несколько кадров из-за перерисовки OSD и
дисплей несколько отключен, и вам, возможно, придется сделать паузу и принудительно
перерисовать.

Дополнительные свойства:

информация о видеокадре/тип изображения информация о видеокадре/чересстрочная развертка видео-кадр-информация/tff
видео-кадр-информация/повтор

кадров в секунду Контейнер ФПС. Это может легко содержать фиктивные значения. Для видео, в которых используются современные
контейнерные форматы или видеокодеки, это часто будет неправильным.

расчетный vf-fps
Расчетный/измеренный FPS на выходе цепочки видеофильтров. (Если фильтры не используются,
это соответствует выходу декодера.) Здесь используется среднее значение 10 последних кадров.
продолжительность для расчета FPS. Это будет неточно, если задействовано отбрасывание кадров
(например, когда фреймдроп явно включен или после точного поиска). Файлы
с неточными метками времени (например, Matroska) может привести к нестабильным результатам.

масштаб окна (РВ)
Множитель размера окна. Установка этого параметра изменит размер окна видео на значения
содержалась в ширина и высота умножается на значение, установленное этим свойством.
настройка 1 изменит размер до исходного размера видео (или, если быть точным, до размера видео
выходные данные фильтров). 2 установит двойной размер, 0.5 вдвое меньше.

свернутое окно
Возвращает, свернуто ли видеоокно или нет.

отображаемые имена
Имена дисплеев, которые покрывает окно mpv. На X11 это xrandr
имена (LVDS1, HDMI1, DP1, VGA1 и т. д.).

дисплей-fps (РВ)
Частота обновления текущего дисплея. На данный момент это самый низкий FPS из всех
дисплей, охваченный видео, полученный базовыми системными API (например,
xrandr на X11). Это не измеренный FPS. Это не обязательно доступно для всех
платформы. Обратите внимание, что любой из перечисленных фактов может измениться в любое время без предупреждения.

расчетный-дисплей-fps
Доступно только в режиме синхронизации дисплея (выбранном --видео-синхронизация) активен.
Возвращает фактическую скорость обновления экрана, измеренную
Системное время.

vsync-джиттер
Предполагаемый коэффициент отклонения продолжительности вертикальной синхронизации.

видео-аспект (РВ)
Видео аспект см. --видео-аспект.

OSD-ширина, OSD-высота
Последняя известная ширина OSD (может быть 0). Это необходимо, если вы хотите использовать overlay_add
команда. Это дает вам фактический размер экранного меню, который может отличаться от размера окна.
Размер в некоторых случаях.

OSD-пар
Последнее известное соотношение пикселей экранного меню (может быть равно 0).

VID (РВ)
Текущая видеодорожка (аналогично --вид).

XNUMX году (РВ)
Псевдоним для VID.

видео-выравнивание-х, видео-выравнивание-y (РВ)
Посмотреть --video-align-x и --video-align-y.

видео-пан-х, видео-пан-у (РВ)
Посмотреть --видео-пан-х и --video-пан-у.

видео-зум (РВ)
Посмотреть --видео-зум.

видео без масштабирования (W)
Посмотреть --video-немасштабированный.

программа (W)
Программа Switch TS (только запись).

SID (РВ)
Текущая дорожка субтитров (аналогично --сид).

вторичная сторона (РВ)
Вторичная дорожка субтитров (см. - вторичный-сид).

ниже (РВ)
Псевдоним для SID.

дополнительная задержка (РВ)
Посмотреть --подзадержка.

субпозиции (РВ)
Посмотреть - подпункт.

дополнительная видимость (РВ)
Посмотреть --sub-видимость.

только под принудительное (РВ)
Посмотреть --sub-force-only.

подшкала (РВ)
Множитель размера шрифта субтитров.

задница-форс-маржа (РВ)
Посмотреть --ass-force-margins.

маржа субиспользования (РВ)
Посмотреть --sub-use-margins.

assfilter-аспект-compat (РВ)
Посмотреть --ass-vsfilter-аспект-совместимость.

задница-стиль переопределить (РВ)
Посмотреть --ass-стиль-переопределить.

захват потока (РВ)
Имя файла, см. --stream-захват. Установка этого параметра запустит захват с использованием заданного
имя файла. Установка его в пустую строку остановит его.

ТВ-яркость, тв-контраст, тв-насыщенность, тв-оттенок (РВ)
ТВ вещи.

плейлист-pos (РВ)
Текущая позиция в плейлисте. Первая запись находится в позиции 0. Запись в
свойство перезапустит воспроизведение с записанной записи.

количество плейлистов
Общее количество записей в плейлисте.

плейлист
Плейлист, текущая запись отмечена. В настоящее время необработанное значение свойства бесполезно.

Это имеет ряд подсвойств. Заменять N с записью плейлиста на основе 0
индекса.

плейлист/количество
Количество записей в плейлисте (такое же, как количество плейлистов).

плейлист/N/имя файла
Имя файла N-й записи.

плейлист/N/текущий, плейлист/N/играет
Да если эта запись в настоящее время воспроизводится (или загружается). Недоступно или нет
в противном случае. При смене файлов текущий и игры может быть разным,
потому что текущий воспроизводимый файл еще не выгружен; в таком случае,
текущий относится к новому выбору. (Начиная с mpv 0.7.0.)

плейлист/N/название
Имя N-й записи. Доступно только в том случае, если файл списка воспроизведения содержит такие
полей и только в том случае, если парсер mpv поддерживает его для данного формата плейлиста.

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (для каждой записи плейлиста)
"имя файла" MPV_FORMAT_STRING
"текущий" MPV_FORMAT_FLAG (может отсутствовать; начиная с mpv 0.7.0)
"играет" MPV_FORMAT_FLAG (то же самое)
"заголовок" MPV_FORMAT_STRING (необязательно)

трек-лист
Список аудио/видео/субтреков, отмечена текущая запись. В настоящее время сырое имущество
ценность бесполезна.

Это имеет ряд подсвойств. Заменять N с отсчитываемым от 0 индексом дорожки.

трек-лист/количество
Общее количество дорожек.

трек-лист/N/id
Идентификатор, как он используется для -сид/--помогать/--вид. Это уникально среди треков
того же типа (саб/аудио/видео), но в остальном нет.

трек-лист/N/тип
Строка, описывающая тип носителя. Один из аудио, XNUMX году , ниже.

список треков/N/src-id
Идентификатор дорожки, используемый в исходном файле. Не всегда доступно.

трек-лист/N/название
Название дорожки в том виде, в каком оно хранится в файле. Не всегда доступен.

трек-лист/N/язык
Отслеживайте язык, указанный в файле. Не всегда доступен.

трек-лист/N/аудио-каналы
Для аудиодорожек количество аудиоканалов в аудиопотоке. Нет
всегда точно (зависит от подсказок контейнера). Не всегда доступно.

трек-лист/N/альбом
Да если это видеодорожка, состоящая из одной картинки, нет or
иначе недоступны. Используется для видеотреков, которые действительно
прикрепленные изображения в аудиофайлах.

трек-лист/N/по умолчанию
Да если у трека в файле установлен флаг по умолчанию, нет в противном случае.

трек-лист/N/принудительно
Да если у трека в файле установлен принудительный флаг, нет в противном случае.

трек-лист/N/кодек
Имя кодека, используемого этой дорожкой, например h264. Недоступно в некоторых
редкие случаи.

трек-лист/N/внешний
Да если трек является внешним файлом, нет в противном случае. Это установлено для отдельного
файлы субтитров.

трек-лист/N/внешнее-имя-файла
Имя файла, если дорожка взята из внешнего файла, иначе недоступно.

трек-лист/N/выбрано
Да если трек в данный момент декодируется, нет в противном случае.

трек-лист/N/ff-указатель
Индекс потока, обычно используемый утилитами FFmpeg. Обратите внимание, что это может
быть потенциально неверным, если демультиплексор, отличный от libavformat (--демультиплексор=лавф) является
использовал. Для файлов mkv индекс обычно совпадает, даже если по умолчанию
(встроенный) демультиплексор используется, но жесткой гарантии нет.

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (для каждой дорожки)
"идентификатор" MPV_FORMAT_INT64
"тип" MPV_FORMAT_STRING
"идентификатор источника" MPV_FORMAT_INT64
"название" MPV_FORMAT_STRING
"язык" MPV_FORMAT_STRING
"аудио-каналы" MPV_FORMAT_INT64
"альбом" MPV_FORMAT_FLAG
"по умолчанию" MPV_FORMAT_FLAG
"принудительно" MPV_FORMAT_FLAG
"внешний" MPV_FORMAT_FLAG
"внешнее имя файла" MPV_FORMAT_STRING
"кодек" MPV_FORMAT_STRING

список глав
Список глав, текущая запись отмечена. В настоящее время необработанное значение свойства равно
бесполезный.

Это имеет ряд подсвойств. Заменять N с индексом главы, начинающимся с 0.

список глав/количество
Количество глав.

список-глав/N/название
Название главы, сохраненное в файле. Не всегда доступно.

список глав/N/время
Время начала главы в секундах как float.

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (для каждой главы)
"название" MPV_FORMAT_STRING
"время" MPV_FORMAT_DOUBLE

af (РВ)
Посмотреть --аф и af команда.

vf (РВ)
Посмотреть --vf и vf команда.

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (для каждой записи фильтра)
"имя" MPV_FORMAT_STRING
"метка" MPV_FORMAT_STRING [необязательно]
«параметры» MPV_FORMAT_NODE_MAP [необязательно]
"ключ" MPV_FORMAT_STRING
"значение" MPV_FORMAT_STRING

Также возможно записать свойство, используя этот формат.

видео-поворот (РВ)
Посмотреть --видео-поворот опцию.

доступный
Возвращает, возможно ли вообще искать в текущем файле.

частично доступный для поиска
ВОЗВРАТ Да если текущий файл считается доступным для поиска, но только потому, что кеш
активен. Это означает, что небольшие относительные поиски могут быть приемлемыми, но более крупные поиски могут привести к сбою.
так или иначе. Будет ли поиск успешным или нет, как правило, заранее неизвестно.

Если это свойство возвращает значение true, доступный также вернет true.

прерывание воспроизведения
Вернуть, остановлено ли воспроизведение или должно быть остановлено. (Полезно в неясных
ситуации, как во время в процессе обработка хука, когда пользователь может остановить воспроизведение,
но скрипт должен явно завершить обработку.)

курсор-автоскрытие (РВ)
Посмотреть --cursor-autohide. Установка нового значения всегда будет обновлять курсор,
и сбросить внутренний таймер.

OSD-сим-cc
Вставляет текущий символ экранного меню в виде непрозрачного управляющего кода экранного меню (cc). Это имеет смысл
только с показать текст команда или параметры, которые устанавливают сообщения экранного меню. Контроль
код зависит от реализации и бесполезен ни для чего другого.

OSD-ass-cc
${osd-ass-cc/0} отключает экранирование последовательностей текста ASS в экранном меню, ${osd-ass-cc/1}
включает его снова. По умолчанию последовательности ASS экранируются, чтобы избежать случайного
форматирование, и это свойство может отключить это поведение. Обратите внимание, что свойства
вернуть непрозрачный код управления OSD, который имеет смысл только для показать текст команду
или параметры, которые устанавливают сообщения OSD.

Пример

· --osd-status-msg='Это is ${osd-ass-cc/0}{\\b1}жирный шрифт текст'

· показать текст "Это is ${osd-ass-cc/0}{\b1}жирный шрифт текст"

Можно использовать любые теги переопределения ASS, понятные libass.

Обратите внимание, что вам нужно избежать \ символ, потому что строка обрабатывается для C
escape-последовательности перед передачей их в код OSD.

Список тегов можно найти здесь: http://docs.aegisub.org/latest/ASS_Tags/

vo-настроенный
Вернуть, настроено ли ВО прямо сейчас. Обычно это соответствует тому,
видно окно видео. Если --force-окно вариант используется, это обычно
всегда возвращается Да.

видео-битрейт, аудио битрейт, суббитрейт
Значения битрейта рассчитываются на уровне пакетов. Это работает путем деления размера бита
всех пакетов между двумя ключевыми кадрами по расстоянию между временными метками их представления.
(При этом используются временные метки, хранящиеся в файле, поэтому, например, скорость воспроизведения не
влияют на возвращаемые значения.) В частности, битрейт видео будет обновляться только
на ключевой кадр и показать «прошлый» битрейт. Чтобы сделать свойство более удобным для пользовательского интерфейса,
обновления этих свойств регулируются определенным образом.

Единицей является бит в секунду. Форматирование OSD превращает эти значения в килобиты (или
мегабит, если это необходимо), чего можно избежать, используя необработанное значение свойства,
например, с ${=битрейт видео}.

Обратите внимание, что на точность этих свойств влияет несколько факторов. Если
базовый демультиплексор перезаписывает пакеты при демультиплексировании (выполняется для некоторых форматов файлов),
битрейт может быть немного выключен. Если временные метки плохие или дрожащие (как в
Matroska), даже потоки с постоянным битрейтом могут показывать колеблющийся битрейт.

То, как именно рассчитываются эти значения, может измениться в будущем.

В более ранних версиях mpv эти свойства возвращали статическое (но плохое) предположение.
используя совершенно другой метод.

пакетный видео битрейт, пакетный аудио битрейт, пакетный суббитрейт
Старые и устаревшие свойства для битрейт видео, аудио битрейт, суббитрейт. Они
ведут себя точно так же, но возвращают значение в килобитах. Кроме того, у них нет никаких
Форматирование экранного меню, хотя того же можно добиться, например, с помощью ${=битрейт видео}.

Эти свойства больше не должны использоваться.

список аудиоустройств
Вернуть список обнаруженных аудиоустройств. Это в основном для использования с клиентом
API и отражает то, что --audio-device = помощь с возвратом плеера из командной строки.

При запросе свойства с помощью клиентского API с помощью MPV_FORMAT_NODEили с Луа
mp.get_property_native, это вернет mpv_node со следующим содержимым:

MPV_FORMAT_NODE_ARRAY
MPV_FORMAT_NODE_MAP (для каждой записи устройства)
"имя" MPV_FORMAT_STRING
"описание" MPV_FORMAT_STRING

Команда имя это то, что должно быть передано --аудио-устройство вариант (и часто довольно
загадочный идентификатор, специфичный для аудио API), в то время как описание читаемый человеком текст в свободной форме.
Описание представляет собой пустую строку, если оно не было получено.

Специальная запись с именем, установленным на автоматический выбирает драйвер вывода звука по умолчанию
и устройство по умолчанию.

Свойство можно наблюдать с помощью механизма наблюдения за свойствами в клиенте.
API и в скриптах Lua. (Технически уведомление об изменении включается в первый раз
это свойство читается.)

аудио-устройство (РВ)
Установите аудиоустройство. Это напрямую читает/записывает --аудио-устройство вариант, но на
доступ для записи, аудиовыход будет запланирован для перезагрузки.

Запись этого свойства, когда аудиовыход не активен, не будет включаться автоматически.
аудио. (Это также верно в случае, когда звук был отключен из-за
сбой повторной инициализации после предыдущего доступа на запись к аудио-устройство.)

Это свойство также не сообщает вам, какое звуковое устройство используется на самом деле.

Способ обработки этих деталей может измениться в будущем.

ток-во
Текущий драйвер вывода видео (имя, используемое с --во).

ток-ао
Текущий драйвер вывода звука (имя, используемое с --ао).

аудио-выход-обнаруженное-устройство
Вернуть аудиоустройство, выбранное драйвером AO (реализовано только для некоторых
водители: в настоящее время только Coreaudio).

рабочий каталог
Вернуть рабочий каталог процесса mpv. Может быть полезно для пользователей JSON IPC,
потому что проигрыватель командной строки обычно работает с относительными путями.

протокол-список
Список префиксов протокола, потенциально распознаваемых игроком. они возвращаются
без отставания :/ / суффикс (который по-прежнему всегда требуется). В некоторых случаях
протокол на самом деле не будет поддерживаться (учитывайте протокол HTTPS если ffmpeg не скомпилирован
с поддержкой TLS).

mpv-версия
Возвращает версию mpv/строку авторских прав. В зависимости от того, как был построен двоичный файл, он
может содержать либо релизную версию, либо просто git-хеш.

MPV-конфигурация
Возвращает аргументы конфигурации, которые были переданы в систему сборки (обычно
пути ./ваф конфигурировать ... был вызван).

опции/ (РВ)
Доступ только для чтения к значению параметра --. Большинство параметров можно изменить в
во время выполнения, записав в это свойство. Обратите внимание, что многие параметры требуют перезагрузки
файл, чтобы изменения вступили в силу. Если есть эквивалентное свойство, предпочтительнее установить
вместо этого свойство.

локальные параметры файла/
Похожий на что опции/, но при установке параметра через это свойство
Параметр сбрасывается до своего старого значения после прекращения воспроизведения текущего файла. Пытающийся
запись параметра, когда файл не воспроизводится (или не загружается), приводит к
ошибка.

(Обратите внимание, что если параметр помечен как локальный для файла, даже опции/ получит доступ к
местное значение и старый значение, которое будет восстановлено по окончании воспроизведения, не может
быть прочитан или записан до конца воспроизведения.)

опция-информация/
Дополнительная информация для каждой опции.

Это имеет ряд подсвойств. Заменять с именем высшего уровня
вариант. Ни одно из этих подсвойств не гарантирует стабильности — они
может кардинально измениться в характеристике.

опция-информация/ /название
Возвращает имя опции.

опция-информация/ /тип
Возвращает имя типа опции, например строка or Целое. Для многих
сложные типы, это не очень точно.

опция-информация/ / установить из командной строки
ВОЗВРАТ Да если опция была установлена ​​из командной строки mpv, нет в противном случае.
Что это установлено, если опция, например, изменена во время выполнения, остается
undefined (это означает, что это может измениться в будущем).

опция-информация/ / установить-локально
ВОЗВРАТ Да если опция была установлена ​​для каждого файла. Это случай с
автоматически загружаемые профили, конфиги файлов и каталогов и другие случаи. Это значит
значение параметра будет восстановлено до значения до начала воспроизведения, когда
воспроизведение заканчивается.

опция-информация/ /значение по умолчанию
Значение параметра по умолчанию. Не всегда может быть доступен.

опция-информация/ /мин, опция-информация/ /Максимум
Целочисленные минимальные и максимальные значения, разрешенные для опции. Доступно только если
опции являются числовыми, а минимум/максимум задается внутри.
Также возможно, что установлен только один из них.

опция-информация/ /выбор
Если вариант является вариантом выбора, возможные варианты. Выбор, который
целые числа могут быть включены или не включены (они могут подразумеваться мин и Макс).
Обратите внимание, что параметры, которые ведут себя как варианты выбора, но не являются фактическими
варианты выбора внутри, может быть недоступна эта информация.

список свойств
Вернуть список свойств верхнего уровня.

Объект расширение
Все строковые аргументы для команд ввода, а также некоторые параметры (например,
--term-playing-msg) подлежат расширению собственности. Обратите внимание, что расширение свойства
не работает в местах, где, например, ожидаются числовые параметры. (Например, добавить
Команда не расширяет свойства. То набор команда является исключением, а не общим
правило.)

Пример для input.conf

i показать текст Имя файла: ${имя файла}
показывает имя файла текущего файла при нажатии кнопки i ключ

В input.conf, расширение собственности можно затормозить, поставив сырье префикс перед
команд.

Поддерживаются следующие расширения:

$ {NAME}
Расширяется до значения свойства ИМЯ. Если получить свойство не удается, разверните
в строку ошибки. (Использовать ${ИМЯ:} с замыкающим : расширить до пустой строки
вместо этого.) Если ИМЯ с префиксом =, разверните исходное значение свойства (см.
раздел ниже).

${ИМЯ:STR}
Расширяется до значения свойства ИМЯ или STR если имущество не может быть
извлечен. STR расширяется рекурсивно.

${?ИМЯ:STR}
Расширяется до STR (рекурсивно), если свойство ИМЯ доступна.

${!ИМЯ:STR}
Расширяется до STR (рекурсивно), если свойство ИМЯ не может быть восстановлено.

${?ИМЯ==ЗНАЧЕНИЕ:STR}
Расширяется до STR (рекурсивно), если свойство ИМЯ расширяется до строки, равной
VALUE. Вы можете префикс ИМЯ = чтобы сравнить необработанное значение свойства
(см. раздел ниже). Если свойство недоступно или возникают другие ошибки при
извлекая его, значение никогда не считается равным. Обратите внимание, что VALUE не может содержать
любой из персонажей : or }. Также возможно, что побег с " or % может быть
будут добавлены в будущем, если в этом возникнет необходимость.

${!ИМЯ==ЗНАЧЕНИЕ:STR}
То же, что и с ? вариант, но STR расширяется, если значение не равно. (С использованием
та же семантика, что и с ?.)

$$ Расширяется до $.

$} Расширяется до }. (Для создания этого символа внутри рекурсивного расширения.)

$> Отключить расширение свойств и специальную обработку $ для остальной части строки.

В местах, где разрешено расширение свойства, также часто принимаются escape-последовательности в стиле C.
Пример:

· \n становится символом новой строки

· \\ расширяется до \

Сырье и Отформатированный НЕДВИЖИМОСТИ
Обычно свойства форматируются как удобочитаемый текст, предназначенный для отображения в экранном меню или на экране.
на терминале. Можно получить неформатированное (необработанное) значение из свойства с помощью
добавив к своему имени префикс =. Эти необработанные значения могут анализироваться другими программами и следовать
те же соглашения, что и параметры, связанные со свойствами.

Примеры

· ${время-поз} расширяется до 00:14:23 (если позиция воспроизведения 14 минут 23 секунды)

· ${=время-позиция} расширяется до 863.4 (то же время, плюс 400 миллисекунд - миллисекунды
обычно не отображается в отформатированном случае)

Иногда разница в количестве информации, которую несет необработанное и отформатированное свойство
значения могут быть довольно большими. В некоторых случаях необработанные значения содержат больше информации, например более высокие значения.
точность, чем секунды с время-поз. Иногда наоборот, например помощь сериал
название трека и язык в отформатированном случае, но только номер трека, если он необработанный.

ON ЭКРАН КОНТРОЛЛЕР

Экранный контроллер (сокращенно: OSC) — это минимальный графический интерфейс, интегрированный с mpv и предлагающий основные
управляемость мышью. Он предназначен для облегчения взаимодействия с новыми пользователями и
обеспечивают точный и прямой поиск.

OSC включен по умолчанию, если mpv был скомпилирован с поддержкой Lua. Его можно отключить
полностью используя --osc=нет опцию.

. OSC
По умолчанию OSC будет отображаться всякий раз, когда мышь перемещается внутри окна проигрывателя и
скроется, если мышь не будет перемещена за пределы OSC в течение 0.5 секунды или если мышь покинет
окно.

Команда Интерфейс
+------------------+------------+------------------ --+
| плейлист предыдущая | название | плейлист следующий |
+-------+------+---+--+------+-+----+------+------ --+
| аудио | пропустить | искать | | искать | пропустить | полный |
+-------+ назад | назад | играть | вперед | вперед | экран |
| суб | | | | | | |
+-------+------+------+------+------+------+------ --+
| панель поиска |
+-----------------+---------------+---------------- --+
| прошло время | состояние кэша | оставшееся время |
+-----------------+---------------+---------------- --+

плейлист Предыдущая

┌──────────────┬──────────────────────────────────
│щелкнуть левой кнопкой мыши │ воспроизвести предыдущий файл в плейлисте │
├──────────────┼──────────────────────────────────
│shift+L-щелчок │ показать плейлист │
└──────────────┴──────────────────────────────────

название
Отображает текущий медиа-заголовок или имя файла

┌────────────┬─────────────────────────────────────
│щелчок левой кнопкой мыши │ показать позицию плейлиста и │
│ │ длина и полное название │
├────────────┼────────────────────────────────────
│правый клик │ показать имя файла │
└────────────┴─────────────────────────────────────

плейлист следующий

┌──────────────┬───────────────────────────
│щелкнуть левой кнопкой мыши │ воспроизвести следующий файл в плейлисте │
├──────────────┼───────────────────────────
│shift+L-щелчок │ показать плейлист │
└──────────────┴───────────────────────────

аудио и ниже
Отображает выбранный трек и количество доступных треков

┌──────────────┬───────────────────────────────────── ┐
│щелчок левой кнопкой мыши │ прокрутка аудио/вспомогательных дорожек вперед │
├──────────────┼───────────────────────────────────── ┤
│щелкнуть правой кнопкой мыши │ перемотать аудио/вспомогательные дорожки назад │
├──────────────┼───────────────────────────────────── ┤
│shift+L-щелчок │ показать доступные аудио/поддорожки │
└──────────────┴───────────────────────────────────── ┘

пропускать назад

┌──────────────┬───────────────────────────────────── ┐
│щелкнуть левой кнопкой мыши │ перейти к началу главы / │
│ │ предыдущая глава │
├──────────────┼───────────────────────────────────── ┤
│shift+L-клик │ показать главы │
└──────────────┴───────────────────────────────────── ┘

искать назад

┌───────────────┬──────────────────────┐
│щелкнуть левой кнопкой мыши │ вернуться на 5 секунд назад │
├───────────────┼─────────────────────┤
│щелчок правой кнопкой мыши │ вернуться на 30 секунд назад │
├───────────────┼─────────────────────┤
│shift-L-щелчок │ перейти на 1 кадр назад │
└───────────────┴──────────────────────┘

играть

┌───────────┬────────────────────┐
│щелчок левой кнопкой мыши │ переключение воспроизведения/паузы │
└───────────┴────────────────────┘

искать вперед

┌──────────────┬──────────────────────── ─┐
│щелкнуть левой кнопкой мыши │ перейти на 10 секунд вперед │
├──────────────┼──────────────────────── ─┤
│щелкнуть правой кнопкой мыши │ перейти на 60 секунд вперед │
├──────────────┼──────────────────────── ─┤
│shift-L-щелчок │ перейти на 1 кадр вперед │
└──────────────┴──────────────────────────

пропускать вперед

┌───────────────┬────────────────────┐
│щелкнуть левой кнопкой мыши │ перейти к следующей главе │
├───────────────┼────────────────────┤
│shift+L-клик │ показать главы │
└───────────────┴────────────────────┘

полноэкранный режим

┌───────────┬────────────────────┐
│щелкнуть левой кнопкой мыши │ включить полноэкранный режим │
└───────────┴────────────────────┘

полоса поиска
Указывает текущую позицию воспроизведения и позицию разделов

┌───────────┬───────────────────┐
│щелкнуть левой кнопкой мыши │ перейти к позиции │
└───────────┴───────────────────┘

время Прошло
Показывает временную метку текущей позиции воспроизведения

┌───────────┬────────────────────────────────────
│щелчок левой кнопкой мыши │ переключение отображения тайм-кодов с помощью │
│ │ миллисекунды │
└───────────┴────────────────────────────────────

кэш статус
Показывает текущий статус заполнения кеша (виден только при уровне ниже 45%).

время осталось
Показывает отметку времени оставшегося времени воспроизведения

┌───────────┬────────────────────────────────────
│щелчок левой кнопкой мыши │ переключение между общим и │
│ │ оставшееся время │
└───────────┴────────────────────────────────────

Основные Наручники
Эти привязки клавиш активны по умолчанию, если к этим клавишам уже не привязано ничего другого.
В случае коллизии функция должна быть привязана к другой клавише. См. Сценарий
Команды .

┌────┬────────────────────────────────── ┐
│del │ Скрыть OSC навсегда, пока │
│ │ mpv перезапускается. │
└────┴────────────────────────────────── ┘

Конфигурация
OSC предлагает ограниченную настройку через файл конфигурации. lua-настройки/osc.conf помещен в
пользовательский каталог mpv и через --script-opts параметр командной строки. Варианты, предоставляемые через
командная строка переопределит настройки из файла конфигурации.

Конфиг Синтаксис
Файл конфигурации должен точно следовать следующему синтаксису:

# это комментарий
опцияA=значение1
опцияB=значение2

# можно использовать только в начале строки и не должно быть пробелов вокруг = or
где-нибудь еще.

Командная строка Синтаксис
Чтобы избежать коллизий с другими сценариями, все параметры должны иметь префикс оск-.

Пример:

--script-opts=osc-optionA=значение1,osc-optionB=значение2

конфигурируемый Возможности
витрина
По умолчанию: да
Включить OSC в окне

показать на весь экран
По умолчанию: да
Включить OSC в полноэкранном режиме

масштабоконный
По умолчанию: 1.0
Масштабный коэффициент OSC в оконном режиме

полноэкранный масштаб
По умолчанию: 1.0
Масштабный коэффициент OSC при полноэкранном режиме

шкалафорсированное окно
По умолчанию: 2.0
Масштабный коэффициент OSC при рендеринге в принудительном (фиктивном) окне

видеошкала
По умолчанию: да
Масштабируйте OSC с видео
нет пытается сохранить размер OSC постоянным настолько, насколько позволяет размер окна

доблестный
По умолчанию: 0.8
Выравнивание по вертикали, от -1 (сверху) до 1 (снизу)

Halign
По умолчанию: 0.0
Выравнивание по горизонтали, от -1 (слева) до 1 (справа)

коробкаальфа
По умолчанию: 80
Альфа фонового окна, от 0 (непрозрачный) до 255 (полностью прозрачный)

тайм-аут скрытия
По умолчанию: 500
Продолжительность в мс, пока OSC не скроется, если нет движения мыши, отрицательное значение
отключает автоматическое скрытие

продолжительность затухания
По умолчанию: 200
Продолжительность затухания в мс, 0 = нет затухания

размер мертвой зоны
По умолчанию: 0
Размер мертвой зоны. Мертвая зона — это область, которая заставляет мышь действовать.
как выйти из окна. Движение там не заставит OSC появиться и
он немедленно скроется, если мышь войдет в него. Мертвая зона начинается
на границе окна, противоположной OSC, а размер определяет, насколько
окна он будет охватывать. Значения от 0 до 1.

minmousemove
По умолчанию: 3
Минимальное количество пикселей, на которое мышь должна перемещаться между тиками, чтобы сделать
появляется OSC

макет
По умолчанию: поле
Макет для OSC. На данный момент доступны: бокс, слимбокс,
нижняя и верхняя панели.

стиль поиска
По умолчанию: ползунок
Устанавливает стиль панели поиска, ползунка (ромбовидный маркер) или полосы (заливка).

общее время
По умолчанию: нет
Показывать общее время вместо оставшегося времени

тайминги
По умолчанию: нет
Отображение тайм-кодов в миллисекундах

Сценарий Команды
Сценарий OSC слушает определенные команды сценария. Эти команды могут быть привязаны к input.conf,
или отправленные другими скриптами.

включить-osc
Отменяет отключить-оск или эффект от из .

отключить-оск
Скрыть OSC навсегда. Это также то, что из ключ делает.

osc-сообщение
Показать сообщение на экране с помощью OSC. Первый аргумент это сообщение, второй
продолжительность в секундах.

Пример

Вы могли бы поместить это в input.conf чтобы скрыть OSC с помощью a ключ и показать его с помощью b:

a script_message отключить-osc
b script_message Enable-OSC

LUA СЦЕНАРИЕВ

mpv может загружать скрипты Lua. Скрипты переданы в --скрипт вариант или найти в скрипты
подкаталог каталога конфигурации mpv (обычно ~ / .config / mpv / scripts /) будет
загружается при запуске программы. mpv также добавляет скрипты подкаталог в конец Lua
путь, чтобы вы могли импортировать скрипты и оттуда. Так как он добавлен в конец, не называйте
скрипты, которые вы хотите импортировать так же, как библиотеки Lua, потому что они будут омрачены
их.

mpv предоставляет встроенный модуль mp, который содержит функции для отправки команд в MPV
ядра и для получения информации о состоянии воспроизведения, пользовательских настройках, информации о файле,
и т. д.

Эти скрипты можно использовать для управления mpv аналогично ведомому режиму. Технически,
Код Lua использует клиентский API внутри.

Пример
Скрипт, который выходит из полноэкранного режима, когда плеер поставлен на паузу:

функция on_pause_change (имя, значение)
если значение == истина, то
mp.set_property("полноэкранный режим", "нет")
конец
конец
mp.observe_property («пауза», «логическое значение», on_pause_change)

Подробнее on скрипт инициализация и Жизненный цикл
Ваш скрипт будет загружен плеером при старте программы с скрипты конфигурация
подкаталога или по пути, указанному с помощью --скрипт вариант. Некоторые скрипты загружены
внутри (как -OSC). Каждый скрипт работает в своем потоке. Ваш скрипт сначала запускается "как
is", и как только это будет сделано, включится цикл событий. Этот цикл событий отправит
события, полученные mpv, и вызвать свои собственные обработчики событий, которые вы зарегистрировали
mp.register_event, или таймеры, добавленные с помощью mp.add_timeout или подобный раздел.

Когда игрок выходит, все скрипты будут заблокированы. Это происходит через выключение
событие, которое по умолчанию возвращает цикл обработки событий. Если ваш скрипт попал в
бесконечный цикл, mpv, вероятно, будет вести себя нормально во время воспроизведения (если только плеер не
приостановлено, см. mp.suspend), но он не завершится при выходе, потому что ожидает
ваш сценарий.

Внутренне код C вызовет функцию Lua mp_event_loop после загрузки Lua
сценарий. Эта функция обычно определяется прелюдией по умолчанию, загружаемой перед вашим скриптом.
(См. плеер/lua/defaults.lua в исходниках mpv). Цикл событий будет ожидать событий и
отправка событий, зарегистрированных с помощью mp.register_event. Он также будет обрабатывать таймеры, добавленные с помощью
mp.add_timeout и подобные (путем ожидания с тайм-аутом).

Начиная с mpv 0.6.0, игрок будет ждать, пока скрипт полностью загрузится, прежде чем продолжить.
Нормальная операция. Плеер считает скрипт полностью загруженным, как только он запускается
ожидание событий mpv (или он выходит). На практике это означает, что игрок более или менее
висеть до тех пор, пока скрипт не вернется из основного чанка (и mp_event_loop называется) или
вызовы сценария mp_event_loop or mp.dispatch_events напрямую. Это делается для того, чтобы
сценарий может полностью настроить обработчики событий и т. д. до фактического начала воспроизведения.
В старых версиях mpv это происходило асинхронно.

mp Функции
Команда mp модуль предварительно загружен, хотя его можно загрузить вручную с помощью требовать 'мп', Это
предоставляет основной клиентский API.

mp.command(строка)
Запустите данную команду. Это похоже на команды, используемые в input.conf. Видеть
Список of вход Команды.

По умолчанию это покажет что-то в экранном меню (в зависимости от команды), как если бы
он был использован в input.conf. Посмотреть вход Command Приставки как повлиять на использование OSD
за команду.

Returns правда при успехе, или ноль, ошибка при ошибке.

mp.commandv(arg1, аргумент2, ...)
Похожий на что mp.команда, но передайте каждый аргумент команды как отдельный параметр. Этот
имеет то преимущество, что вам не нужно заботиться о цитировании и экранировании в некоторых
случаи.

Пример:

mp.command("loadfile " .. имя файла .. " добавить")
mp.commandv ("загрузить файл", имя файла, "добавить")

Эти две команды эквивалентны, за исключением того, что первая версия прерывается, если
имя файла содержит пробелы или определенные специальные символы.

Обратите внимание, что свойства расширен. Вы можете использовать либо mp.команда,
развернуть-свойства префикс или mp.get_property семейство функций.

В отличие от mp.команда, это также не будет использовать экранное меню по умолчанию (за исключением некоторых
команды экранного меню).

mp.command_native(таблица [, определение])
Похожий на что mp.commandv, но передайте список аргументов в виде таблицы. Это имеет преимущество
что, по крайней мере, в некоторых случаях аргументы могут передаваться как собственные типы.

Возвращает таблицу результатов в случае успеха (обычно пустую) или деф, ошибка при ошибке. защиту is
второй параметр, предоставленный функции, и равен нулю, если он отсутствует.

mp.get_property(имя [, определение])
Вернуть значение данного свойства в виде строки. Это те же свойства, что и
используется в input.conf. Видеть НЕДВИЖИМОСТИ для списка свойств. Возвращаемая строка
отформатировано аналогично ${=имя} (См. Объект расширение).

Возвращает строку в случае успеха или деф, ошибка при ошибке. защиту второй параметр
предоставляется функции, и равен нулю, если он отсутствует.

mp.get_property_osd(имя [, определение])
Похожий на что mp.get_property, но вернуть значение свойства, отформатированное для OSD. Этот
это та же строка, что и напечатанная с помощью $ {имя} при использовании в input.conf.

Возвращает строку в случае успеха или деф, ошибка при ошибке. защиту второй параметр
предоставляется функции и является пустой строкой, если она отсутствует. в отличие
get_property (), присвоение возвращаемого значения переменной всегда будет
строка.

mp.get_property_bool (имя [, определение])
Похожий на что mp.get_property, но возвращайте значение свойства как Boolean.

Возвращает логическое значение в случае успеха или деф, ошибка при ошибке.

mp.get_property_number(имя [, определение])
Похожий на что mp.get_property, но вернуть значение свойства как число.

Обратите внимание, что хотя Lua не различает целые числа и числа с плавающей запятой, внутренности mpv
делать. Эта функция просто запрашивает у mpv двойное число с плавающей запятой, и mpv обычно
преобразовать целочисленные значения свойств в число с плавающей запятой.

Возвращает число в случае успеха или деф, ошибка при ошибке.

mp.get_property_native(имя [, определение])
Похожий на что mp.get_property, но вернуть значение свойства, используя лучший тип Lua
для собственности. В большинстве случаев это возвращает строку, логическое значение или число. Немного
свойства (например, список глав) возвращаются в виде таблиц.

Возвращает значение в случае успеха или деф, ошибка по ошибке. Обратите внимание, что ноль может быть
возможно, действительное значение тоже в некоторых крайних случаях.

mp.set_property(имя, стоимость)
Установите данное свойство в заданное строковое значение. Видеть mp.get_property и
НЕДВИЖИМОСТИ для получения дополнительной информации о свойствах.

Возвращает true в случае успеха или ноль, ошибка при ошибке.

mp.set_property_bool (имя, стоимость)
Похожий на что mp.set_property, но установите для данного свойства заданное логическое значение.

mp.set_property_number(имя, стоимость)
Похожий на что mp.set_property, но установите для данного свойства заданное числовое значение.

Обратите внимание, что хотя Lua не различает целые числа и числа с плавающей запятой, внутренности mpv
делать. Эта функция проверит, может ли число быть представлено как целое число, и
если это так, он передаст целочисленное значение в mpv, в противном случае — двойное число с плавающей запятой.

mp.set_property_native(имя, стоимость)
Похожий на что mp.set_property, но установите данное свойство, используя его собственный тип.

Поскольку есть несколько типов данных, которые не могут быть изначально представлены в Lua, этот
может не всегда работать так, как ожидалось. Например, в то время как оболочка Lua может выполнять некоторые
догадки, чтобы решить, является ли таблица Lua массивом или картой, это не удастся с
пустые столы. Также не так много свойств, для которых имеет смысл использовать
это вместо set_property, set_property_bool, set_property_number. Для этих
причинам, этой функции, вероятно, следует избегать на данный момент, за исключением свойств
которые изначально используют таблицы.

mp.get_time()
Возвращает текущее внутреннее время mpv в секундах в виде числа. Это в основном
системное время с произвольным смещением.

mp.add_key_binding(ключ, имя|фн [, фн [,флаги]])
Зарегистрируйте обратный вызов для запуска привязки ключа. Привязка будет сопоставлена ​​с
данный ключ, представляющий собой строку, описывающую физический ключ. Здесь используется тот же ключ
имена, как в input.conf, а также допускает комбинации (например, ctrl + a).

После вызова этой функции нажатие клавиш приведет к вызову функции fn быть позванным
(если только пользователь не переназначил ключ с другой привязкой).

Команда имя аргумент должен быть короткой символьной строкой. Это позволяет пользователю переназначить
привязка ключа через input.conf с использованием script_message команду и имя
привязка клавиш (см. пример ниже). Имя должно быть уникальным среди других
привязки в том же скрипте — если нет, будет использоваться предыдущая привязка с тем же именем.
быть перезаписан. Имя можно не указывать, в этом случае генерируется случайное имя.
внутренне.

Последний аргумент используется для необязательных флагов. Это таблица, которая может иметь
следующие записи:

повторяемый
Если установлено на правда, включает повтор ключа для этой конкретной привязки.

комплекс
Если установлено на правда, то fn вызывается как при нажатии клавиш, так и при нажатии клавиш (а также
как повтор ключа, если он включен), при этом первым аргументом является таблица. Этот
стол имеет мероприятие запись, которая установлена ​​в одну из строк вниз,
повторять, up or нажмите (последнее, если клавиша вверх/вниз не может быть отслежена). Это
также имеет is_mouse запись, которая сообщает, было ли событие вызвано
кнопкой мыши.

Внутри привязки клавиш отправляются через script_message_to or script_binding
ввод команд и mp.register_script_message.

Попытка сопоставить несколько команд с ключом по существу предпочтет случайную привязку,
в то время как другие привязки не вызываются. Гарантируется, что пользователь определяет
привязки в центральном input.conf предпочтительнее привязок, добавленных с этим
функция (но см. mp.add_forced_key_binding).

Пример:

функция something_handler()
print("клавиша была нажата")
конец
mp.add_key_binding("x", "что-то", something_handler)

Это напечатает сообщение ключ законопроект прессованный когда x был нажат.

Пользователь может переназначить эти привязки клавиш. Затем пользователь должен ввести следующее в
его input.conf, чтобы переназначить команду на y ключ:

y script_binding что-то

Это напечатает сообщение, когда ключ y нажимается. (x будет работать, если только
пользователь переназначает его.)

Вы также можете явно отправить сообщение только именованному сценарию. Предположим, что выше
скрипт использовал имя файла fooscript.lua:

у script_binding fooscript.something

mp.add_forced_key_binding(...)
Это работает почти так же, как mp.add_key_binding, но регистрирует привязку ключа в
способ, который перезапишет пользовательские привязки пользователя в его input.conf.
(mp.add_key_binding перезаписывает только привязки клавиш по умолчанию, но не
пользовательский ввод.conf.)

mp.remove_key_binding(имя)
Удалить привязку клавиш, добавленную с помощью mp.add_key_binding or mp.add_forced_key_binding.
Используйте то же имя, которое вы использовали при добавлении привязок. Невозможно удалить
привязки, для которых вы опустили имя.

mp.register_event(имя, фн)
Вызов определенной функции, когда происходит событие. Имя события представляет собой строку, а
function fn является значением функции Lua.

Некоторые события имеют связанные данные. Это помещается в таблицу Lua и передается как
аргумент фн. Таблица Lua по умолчанию содержит имя поле, представляющее собой строку
содержащий название события. Если событие связано с ошибкой, ошибка поле
устанавливается в строку, описывающую ошибку, в случае успеха она не устанавливается.

Если для одного и того же события зарегистрировано несколько функций, они запускаются в
порядок регистрации, в котором первая зарегистрированная функция запускается перед всеми
остальные.

Возвращает true, если такое событие существует, иначе false.

Посмотреть Мероприятия и Список of События для получения информации.

mp.unregister_event(фн)
расстегивать mp.register_event(..., фн). Это удаляет все обработчики событий, равные
fn параметр. Это использует обычный Lua == сравнение, так что будьте осторожны при общении
с замыканиями.

mp.observe_property (имя, типа, фн)
Следите за изменениями свойства. Если свойство имя изменяется, то функция
фн(имя) будет называться. напишите может быть нольили установить один из нет, родной, BOOL,
string или номер. нет такой же как ноль. Для всех остальных значений новое значение
свойство будет передано в качестве второго аргумента fn, С помощью mp.get_property_
чтобы получить его. Это означает, что если напишите например string, fn примерно так называется
in фн(имя, mp.get_property_string(имя)).

Если возможно, события изменения объединяются. Если свойство изменяется несколько раз
в строке только последнее изменение запускает функцию изменения. (точное поведение
зависит от времени и прочего)

В некоторых случаях функция не вызывается даже при изменении свойства. Ли
это может произойти в зависимости от свойства.

Если же линия индикатора напишите is нет or нольвозможны спорадические изменения свойств. Этот
означает функцию изменения fn может быть вызван, даже если свойство на самом деле не
измениться.

mp.unobserve_property(фн)
расстегивать mp.observe_property(..., фн). Это удаляет все обработчики свойств, которые
равно fn параметр. Это использует обычный Lua == сравнение, так что будьте осторожны, когда
работа с замыканиями.

mp.add_timeout (секунды, фн)
Вызвать данную функцию fn, когда истекло заданное количество секунд. Обратите внимание, что
количество секунд может быть дробным. На данный момент разрешение таймера может быть таким
всего 50 мс, хотя в будущем этот показатель будет улучшен.

Это одноразовый таймер: он будет удален при срабатывании.

Возвращает объект таймера. Видеть mp.add_ periodic_timer для получения информации.

mp.add_periodic_timer (секунды, фн)
Периодически вызывайте данную функцию. Это как mp.add_timeout, но таймер
повторно добавляется после запуска функции fn.

Returns a таймер объект. Команда таймер объект приводит после методы:

стоп() Отключите таймер. Ничего не делает, если таймер уже отключен.
Это запомнит текущее прошедшее время при остановке, так что
резюме() по существу останавливает таймер.

убийство() Отключите таймер. Сбрасывает прошедшее время. резюме() перезапустит
таймер.

резюме()
Перезапустите таймер. Если таймер был отключен с помощью стоп(), это будет
возобновить работу в то время, когда она была остановлена. Если таймер был отключен с помощью
убийство(), или если это ранее сработавший одноразовый таймер (добавляется с помощью
add_timeout()), это запускает таймер с самого начала, используя
изначально настроенный тайм-аут.

Тайм-аут (РВ)
Это поле содержит текущий период ожидания. Это значение не
обновляется с течением времени. Он используется только для расчета, когда
таймер должен срабатывать, когда таймер истекает.

Если вы напишете это, вы можете позвонить т: убить () ; т: возобновить () сбросить
текущий тайм-аут к новому. (т: стоп () не будет использовать новый тайм-аут.)

OneShot (РВ)
Является ли таймер периодическим (ложный) или срабатывает только один раз (правда). Это
значение используется, когда таймер истекает (но перед обратным вызовом таймера
выполняется функция fn).

Обратите внимание, что это метод, и вы должны вызывать их, используя : вместо . (Ссылаться
в http://www.lua.org/manual/5.2/manual.html#3.4.9 .)

Пример:

секунд = 0
таймер = mp.add_periodic_timer(1, функция()
print("вызывается каждую секунду")
# остановить через 10 секунд
секунды = секунды + 1
если секунды >= 10, то
таймер: убить ()
конец
конец)

mp.get_opt(ключ)
Вернуть настройку из --script-opts вариант. Это зависит от пользователя и сценария
как используется этот механизм. В настоящее время все скрипты имеют одинаковый доступ к этому, поэтому вы
следует быть осторожным в отношении столкновений.

mp.get_script_name()
Возвращает имя текущего скрипта. Имя обычно состоит из имени файла
скрипт с удаленным каталогом и расширением файла. Если скриптов несколько
который будет иметь такое же имя, он станет уникальным путем добавления номера.

Пример

Сценарий /путь/к/fooscript.lua становится фускрипт.

mp.osd_message(текст [,продолжительность])
Показать сообщение OSD на экране. продолжительность указывается в секундах и является необязательным (использует
--osd-длительность по умолчанию).

Фильтр mp Функции
Эти тоже живут в mp модуль, но задокументированы отдельно, так как они полезны только в
особые ситуации.

mp.suspend()
Приостановите основной цикл MPV. В C API есть многословное объяснение этого.
функция mpv_suspend(). Короче говоря, это не позволяет игроку отображать следующее
видеокадр, чтобы вас не заблокировали при попытке доступа к плееру.

Это автоматически вызывается обработчиком событий.

mp.resume()
Отменить один mp.suspend() вызов. mp.suspend() увеличивает внутренний счетчик и
mp.resume() уменьшает его. При достижении 0 проигрыватель фактически возобновляется.

mp.resume_all()
Это сбрасывает внутренний счетчик приостановки и возобновляет воспроизведение проигрывателя. (Это как звонить
mp.resume() пока игрок не возобновится.)

Возможно, вам захочется вызвать это, если вы собираетесь сделать что-то, что займет много времени,
но на самом деле не нуждается в доступе к плееру (как сетевая операция). Обратите внимание, что
вы по-прежнему можете получить доступ к плееру в любое время.

mp.get_wakeup_pipe()
Объявления mpv_get_wakeup_pipe() и возвращает считанный конец канала пробуждения. (Видеть
клиент.ч для деталей.)

mp.get_next_timeout()
Возвращает относительное время в секундах, когда следующий таймер (mp.add_timeout и
аналогично) истекает. Если таймера нет, вернуться ноль.

mp.dispatch_events([allow_wait])
Это можно использовать для запуска пользовательских циклов событий. Если вы хотите иметь прямой контроль над тем, что
сценарий Lua (вместо того, чтобы вызываться циклом событий по умолчанию), вы можете
установить глобальную переменную mp_event_loop к вашей собственной функции, запускающей цикл событий.
Из вашего цикла событий вы должны позвонить mp.dispatch_events() убрать из очереди и отправить
мпв события.

Если же линия индикатора разрешить_ожидание параметр установлен в правда, функция будет заблокирована до следующего
событие получено или истекает следующий таймер. В противном случае (и это по умолчанию
поведение), он возвращается, как только цикл обработки событий опустеет. это сильно
рекомендуется использовать mp.get_next_timeout() и mp.get_wakeup_pipe() если ты
интересует правильно работающее оповещение о новых событиях и работающие таймеры.

Эта функция вызывает mp.suspend() и mp.resume_all() самостоятельно.

mp.enable_messages (уровень)
Установите минимальный уровень журнала, при котором вывод сообщения mpv должен быть получен. Эти сообщения
обычно выводятся на терминал. Вызывая эту функцию, вы можете установить
минимальный уровень журнала сообщений, которые должны быть получены с лог-сообщение мероприятие.
Подробности смотрите в описании этого события. Уровень представляет собой строку, см. msg.log
для разрешенных уровней журнала.

mp.register_script_message(имя, фн)
Это помощник для отправки script_message or script_message_to обращения к Lua
функции. fn называется, если script_message or script_message_to (с этим сценарием как
пункт назначения) запускается с имя как первый параметр. Остальные параметры передаются
в fn. Если сообщение с данным именем уже зарегистрировано, оно перезаписывается.

Использован mp.add_key_binding, поэтому будьте осторожны с конфликтами имен.

mp.unregister_script_message(имя)
Отменить предыдущую регистрацию с помощью mp.register_script_message. Ничего не делает, если
имя не был зарегистрирован.

mp.msg Функции
Этот модуль позволяет выводить сообщения на терминал и может быть загружен с требовать
'mp.msg'.

msg.log(уровень, ...)
Параметр level является приоритетом сообщения. Это строка и одна из роковой, ошибка,
предупреждать, info, v, отлаживать. Настройки пользователя будут определять, какое из этих сообщений
будет видно. Обычно видны все сообщения, кроме v и отлаживать.

После этого все параметры преобразуются в строки. Пробелы вставляются в
разделить несколько параметров.

Вам не нужно добавлять новые строки.

сообщение.фатальный(...), сообщение.ошибка(...), сообщение.предупреждать(...), сообщение.информация(...), msg.verbose(...),
msg.debug(...)
Все это ярлыки и эквивалентны соответствующим msg.log(уровень, ...)
вызов.

mp.options Функции
mpv поставляется со встроенным модулем для управления параметрами из конфигурационных файлов и командной строки.
Все, что вам нужно сделать, это предоставить таблицу с параметрами по умолчанию для функции read_options.
Функция перезапишет значения по умолчанию значениями, найденными в конфигурационном файле и
командная строка (именно в таком порядке).

options.read_options (таблица [, идентификатор])
A (см. таблицу ниже) с парами ключ-значение. Тип значений по умолчанию важен для
преобразование значений, считанных из файла конфигурации или командной строки, обратно. Не используй
ноль как значение по умолчанию!

Команда идентификатор используется для идентификации конфигурационного файла и параметров командной строки.
Они должны быть уникальными, чтобы избежать коллизий с другими скриптами. По умолчанию
mp.get_script_name().

Пример реализации:

требуют «mp.options»
локальные параметры = {
опцияA = "значение по умолчаниюA",
вариант Б = -0.5,
вариант C = правда,
}
read_options(опции, "myscript")
печать (параметры. вариант А)

Файл конфигурации будет храниться в lua-настройки/идентификатор.conf в пользовательской папке mpv.
Строки комментариев можно начинать с символа #, а лишние пробелы не удаляются. Логические значения будут
быть представлено да/нет.

Пример конфигурации:

# комментарий
optionA=Привет, мир
опцияB=9999
опцияC=нет

Параметры командной строки считываются из --script-opts параметр. Во избежание столкновений все
ключи должны иметь префикс идентификатор-.

Пример командной строки:

--script-opts=myscript-optionA=ТЕСТ,myscript-optionB=0,myscript-optionC=yes

mp.utils кредита
Этот встроенный модуль предоставляет общие вспомогательные функции для Lua и, строго говоря,
ничего общего с mpv или воспроизведением видео/аудио. Они предусмотрены для удобства. Большинство
компенсировать скудную стандартную библиотеку Lua.

Имейте в виду, что любая из этих функций может исчезнуть в любое время. Они не являются строго частью
гарантированного API.

utils.getcwd()
Возвращает каталог, из которого был запущен mpv. При ошибке, ноль, ошибка возвращается.

utils.readdir(путь [, фильтр])
Перечислить все записи по заданному пути в файловой системе и вернуть их как
множество. Каждая запись является записью каталога (без пути). Список не отсортирован
(в любом порядке, в котором его возвращает операционная система).

Если же линия индикатора фильтр задан аргумент, он должен быть одной из следующих строк:

файлов Список только обычные файлы. Это исключает каталоги, специальные файлы (например,
файлы устройств UNIX или FIFO) и мертвые символические ссылки. Он включает символические ссылки UNIX
в обычные файлы.

каталоги Только список каталогов или символические ссылки на каталоги. . и .. не
включены.

"обычные" Включите результаты обоих файлов и каталоги. (Это значение по умолчанию.)

ВСЕ Перечислите все записи, даже файлы устройств, мертвые символические ссылки, FIFO и . и
.. записей.

При ошибке ноль, ошибка возвращается.

utils.split_path(путь)
Разделите путь на компонент каталога и компонент имени файла и верните их. То
первым возвращаемым значением всегда является каталог. Второе возвращаемое значение — это трейлинг
часть пути, запись каталога.

utils.join_path (p1, р2)
Верните конкатенацию двух путей. Пытается быть умным. Например, если `p2 is
абсолютный путь, p2 возвращается без изменений.

utils.subprocess(т)
Запускает внешний процесс и ждет его завершения. Возвращает статус процесса и
захваченный вывод.

Параметр t это стол. Функция считывает следующие записи:

арг Массив строк. Первая запись массива является исполняемым файлом. Это может быть
либо абсолютный путь, либо имя файла без компонентов пути, в котором
дело PATH переменная среды используется для разрешения исполняемого файла. То
другие элементы массива передаются как аргументы командной строки.

сократимый
По желанию. Если установлено на правда (по умолчанию), то если пользователь остановит воспроизведение или
переходит к следующему файлу во время выполнения процесса, процесс будет
убит.

макс_размер
По желанию. Максимальный размер в байтах данных, которые могут быть получены из
стандартный выход. (По умолчанию: 16 МБ.)

В результате функция возвращает таблицу со следующими записями:

статус Необработанный статус выхода процесса. В случае ошибки он будет отрицательным.

стандартный вывод Захваченный поток вывода в виде строки, ограниченный макс_размер.

ошибка ноль на успех. Струна убитый если процесс был остановлен в
Необычный способ. Струна инициализации если процесс не может быть запущен.

В Windows, убитый возвращается только тогда, когда процесс был убит
MPV в результате сократимый установлен на правда.

kill_by_us
Установить правда если процесс был убит mpv в результате
сократимый установлен на правда.

Во всех случаях, mp.resume_all() называется неявно.

utils.parse_json (ул. [, тащить])
Разбирает заданный строковый аргумент как JSON и возвращает его как таблицу Lua. При ошибке,
Возвращает ноль, ошибка. (В настоящее время, ошибка это просто чтение строки ошибка, потому что там
не является детальным отчетом об ошибках любого рода.)

Возвращаемое значение использует те же соглашения, что и mp.get_property_native() в
различать пустые объекты и массивы.

Если же линия индикатора след параметр правда (или любое значение, равное правда), затем замыкающий
текст без пробелов допускается функцией, и завершающий текст возвращается
как третье возвращаемое значение. (Третье возвращаемое значение всегда есть, но с след набор, нет
возникает ошибка.)

utils.format_json(v)
Отформатируйте данную таблицу Lua (или значение) как строку JSON и верните ее. При ошибке,
Возвращает ноль, ошибка. (Ошибки обычно случаются только с типами значений, несовместимыми с
JSON.)

Значение аргумента использует те же соглашения, что и mp.set_property_native() в
различать пустые объекты и массивы.

utils.to_string(v)
Превратите заданное значение в строку. Форматирует таблицы и их содержимое. Это не
сделать что-нибудь особенное; это нужно только потому, что Lua ужасен.

Мероприятия
События — это уведомления от ядра игрока к скриптам. Вы можете зарегистрировать обработчик событий
mp.register_event.

Обратите внимание, что все сценарии (и другие части проигрывателя) получают события одинаково, и
нет такой вещи, как блокирование других сценариев от получения событий.

Пример:

функция my_fn(событие)
print("Начало воспроизведения!")
конец

mp.register_event("файл загружен", my_fn)

Список of События
стартовый файл
Происходит непосредственно перед загрузкой нового файла. Когда вы получаете это, игрок
загрузка файла (или, возможно, уже сделанного с ним).

конечный файл
Происходит после того, как файл был выгружен. Обычно плеер загружает следующий файл
сразу или выйти, если это был последний файл.

Мероприятие имеет причина поле, которое принимает одно из следующих значений:

ВФ Файл закончился. Это может (но не обязательно) включать неполные файлы
или разорванные сетевые соединения при определенных обстоятельствах.

остановить Воспроизведение было остановлено командой.

выход Воспроизведение завершалось отправкой команды quit.

ошибка Произошла ошибка. В этом случае ошибка поле присутствует с ошибкой
строка.

переориентировать
Бывает с плейлистами и т.п. Подробности см. MPV_END_FILE_REASON_REDIRECT
в C API.

неизвестный
Неизвестный. Обычно этого не происходит, если только Lua API не синхронизирован с
С API. (Аналогичным образом может случиться так, что ваш сценарий получит строки причин,
еще не существовало на момент написания вашего сценария.)

загруженный файл
Происходит после загрузки файла и начала воспроизведения.

искать Бывает при поиске. (Это может включать случаи, когда игрок ищет внутри,
даже без взаимодействия с пользователем. Сюда входят, например, изменения сегментов при воспроизведении
упорядоченные главы файлов Matroska.)

воспроизведение-перезагрузка
Начало воспроизведения после поиска или после загрузки файла.

холостой ход Режим ожидания введен. Это происходит, когда воспроизведение закончилось, а плеер был запущен
--праздный or --force-окно. Этот режим неявно завершается, когда стартовый файл or
выключение события происходят.

клещ Вызывается после отображения видеокадра. Это взлом, и вам следует избегать
используй это. Вместо этого используйте таймеры и, возможно, следите за приостановкой/возобновлением событий, чтобы избежать
трата ресурсов процессора, когда проигрыватель стоит на паузе.

выключение
Отправляется, когда игрок выходит, и скрипт должен завершиться. Обычно обрабатывается
автоматически. Видеть Подробнее on скрипт инициализация и Жизненный цикл.

лог-сообщение
Получает сообщения, включенные с помощью mp.enable_messages. Данные сообщения содержатся в
таблица передается в качестве первого параметра обработчику событий. Таблица содержит, в
в дополнение к полям событий по умолчанию, следующие поля:

префикс Префикс модуля идентифицирует отправителя сообщения. Это то, что
терминальный плеер ставит перед текстом сообщения при использовании --v вариант,
а также то, что используется для --msg-уровень.

уровень Уровень журнала в виде строки. Видеть msg.log для возможных имен уровней журнала. Примечание
что более поздние версии mpv могут добавлять новые уровни или удалять (недокументированные)
существующие.

текст Сообщение журнала. Текст будет заканчиваться символом новой строки. Иногда это
может содержать несколько строк.

Имейте в виду, что эти сообщения предназначены для людей. Тебе не следует
анализировать их, и префикс/уровень/текст сообщений может измениться в любое время.

получить-свойство-ответ
Недокументирован (бесполезен для Lua-скриптов).

установить-свойство-ответ
Недокументирован (бесполезен для Lua-скриптов).

команда-ответ
Недокументирован (бесполезен для Lua-скриптов).

клиентское сообщение
Недокументировано (используется для внутреннего использования).

видео-реконфигурация
Происходит при видеовыходе или перенастройке фильтра.

аудио-реконфигурация
Происходит при аудиовыходе или перенастройке фильтра.

Также происходят следующие события, но они устарели: треки изменены, с переключением треков,
Пауза, снять паузу, обновление метаданных, смена главы. Используйте mp.observe_property() .

экстракт
Документирует экспериментальные функции или функции, которые «слишком особенные», чтобы гарантировать
стабильный интерфейс.

mp.add_hook (тип, приоритет, фн)
Добавьте обратный вызов ловушки для напишите (строка, идентифицирующая определенный вид крючка). Эти
хуки позволяют игроку вызывать скриптовые функции и ждать их результата
(обычно скриптовый интерфейс Lua асинхронен с точки зрения
ядро игрока). приоритет это произвольное целое число, которое позволяет упорядочивать хуки
такого же рода. В качестве нейтрального значения по умолчанию рекомендуется использовать значение 50. fn is
функция, которая будет вызываться во время выполнения хука.

Посмотреть Крючки для существующих на данный момент хуков и того, что они делают - доступен только список хуков
интересный; обработка выполнения хука выполняется функцией скрипта Lua
автоматически.

JSON IPC

mpv может управляться внешними программами с использованием протокола IPC на основе JSON. Это может быть
включается путем указания пути к unix-сокету с помощью опции --input-unix-сокет.
Клиенты могут подключаться к этому сокету и отправлять команды игроку или получать события от
его.

ПРЕДУПРЕЖДЕНИЕ:
Это не предназначено для использования в качестве безопасного сетевого протокола. Это явно небезопасно: там
нет ни аутентификации, ни шифрования, да и сами команды тоже небезопасны. За
Например, пробег доступна команда, которая может запускать произвольные системные команды. То
вариант использования — локальное управление игроком. Это ничем не отличается от MPlayer
подчиненный протокол.

Сокат пример
Вы можете использовать Сокат инструмент для отправки команд (и получения ответа) из оболочки. Предполагая
mpv был запущен с:

mpv-файл.mkv --input-unix-socket=/tmp/mpvsocket

Затем вы можете управлять им с помощью socat:

> echo '{ "command": ["get_property", "время воспроизведения"] }' | сокат - /tmp/mpvsocket
{"данные": 190.482000, "ошибка": "успешно"}

В этом случае socat копирует данные между stdin/stdout и соединением сокета mpv.

Смотрите пост в --праздный вариант, как заставить mpv запускаться без немедленного выхода или воспроизведения файла.

Также можно отправлять только текстовые команды в стиле input.conf:

> echo 'show_text ${время воспроизведения}' | сокат - /tmp/mpvsocket

Но вы не получите ответ через сокет. (Эта конкретная команда показывает воспроизведение
время на экранном меню проигрывателя.)

протокол
Клиенты могут выполнять команды на проигрывателе, отправляя сообщения JSON следующего вида:

{ "команда": ["имя_команды", "параметр1", "параметр2", ...] }

в котором имя_команды имя выполняемой команды, за которым следует список
параметры. Параметры должны быть отформатированы как исходные значения JSON (целые числа, строки,
булевы значения, ...). Каждое сообщение Чёрный быть прекращено с \n, Кроме того, \n не должен появляться
в любом месте сообщения. На практике это означает, что сообщения должны быть минимизированы.
перед отправкой в ​​mpv.

Затем mpv отправит ответ, указывающий, была ли команда выполнена правильно, и
дополнительное поле, содержащее возвращаемые данные для конкретной команды (оно также может быть нулевым).

{ "ошибка": "успех", "данные": ноль}

mpv также будет отправлять события клиентам с сообщениями JSON следующего вида:

{ "событие": "имя_события" }

в котором название события это название события. Дополнительные поля, относящиеся к конкретному событию, также могут быть
настоящее время. Видеть Список of События для списка всех поддерживаемых событий.

Поскольку события могут произойти в любое время, иногда может быть трудно определить, какие из них
ответ идет с какой командой. Команды могут дополнительно включать request_id который, если
указанный в командном запросе, будет дословно скопирован в ответ. MPV не
интерпретировать request_id в любом случае; он предназначен исключительно для использования запрашивающей стороной.

Например, этот запрос:

{ "command": ["get_property", "time-pos"], "request_id": 100 }

Будет генерировать этот ответ:

{ "ошибка": "успех", "данные": 1.468135, "request_id": 100}

Все команды, ответы и события отделяются друг от друга разрывом строки.
персонаж (\n).

Если первый символ (после пропуска пробела) не {, команда будет
интерпретируются как текстовая команда, отличная от JSON, поскольку они используются в input.conf (или
mpv_command_string() в клиентском API). Кроме того, строка, начинающаяся с # и пусто
строки игнорируются.

В настоящее время встроенные 0 байтов завершают текущую строку, но на это полагаться не следует.

Команды
В дополнение к командам, описанным в Список of вход Команды, несколько дополнительных команд
также может использоваться как часть протокола:

имя клиента
Вернуть имя клиента в виде строки. это строка мпк-н где N является
целое число.

get_time_us
Возвращает текущее внутреннее время mpv в микросекундах в виде числа. Это в основном
системное время с произвольным смещением.

get_property
Возвращает значение данного свойства. Значение будет отправлено в поле данных
повторное сообщение.

Пример:

{ "команда": ["get_property", "volume"] }
{ "данные": 50.0, "ошибка": "успешно"}

get_property_string
Подобно get_property, но результирующие данные всегда будут строкой.

Пример:

{ "команда": ["get_property_string", "объем"] }
{ "данные": "50.000000", "ошибка": "успешно" }

set_property
Установите для данного свойства заданное значение. Видеть НЕДВИЖИМОСТИ чтобы получить больше информации
о свойствах.

Пример:

{ "команда": ["set_property", "pause", true] }
{ "ошибка": "успех" }

set_property_string
Подобно set_property, но значение аргумента должно быть передано в виде строки.

Пример:

{ "команда": ["set_property_string", "пауза", "да"] }
{ "ошибка": "успех" }

наблюдать_свойство
Следите за изменениями свойства. Если данное свойство изменяется, то событие
напишите изменение собственности будет создан

Пример:

{ "команда": ["observe_property", 1, "volume"] }
{ "ошибка": "успех" }
{ "событие": "изменение свойства", "id": 1, "данные": 52.0, "имя": "том" }

наблюдать_свойство_строка
Подобно наблюдать_свойство, но результирующие данные всегда будут строкой.

Пример:

{ "команда": ["observe_property_string", 1, "volume"] }
{ "ошибка": "успех" }
{ "событие": "изменение свойства", "id": 1, "данные": "52.000000", "имя": "том" }

unobserve_property
расстегивать наблюдать_свойство or наблюдать_свойство_строка. Для этого требуется числовой идентификатор
передается команде наблюдения в качестве аргумента.

Пример:

{ "команда": ["unobserve_property", 1] }
{ "ошибка": "успех" }

request_log_messages
Включить вывод сообщений журнала mpv. Они будут получены как события. Параметр
этой команде является лог-уровень (см. mpv_request_log_messages API-функция C).

Вывод сообщений журнала предназначен только для людей (в основном для отладки). Пытаться
извлекать информацию путем разбора этих сообщений просто приведет к поломкам с
будущие выпуски MPV. Вместо этого сделайте запрос функции и попросите надлежащее событие
который возвращает нужную информацию.

включить_событие, отключить_событие
Включает или отключает именованное событие. Зеркала mpv_request_event Функция C API.
Если строка ВСЕ используется вместо имени события, все события включены или
отключен.

По умолчанию большинство событий включены, и от этой команды мало толку.

приостановить
Приостановите основной цикл MPV. В C API есть многословное объяснение этого.
функция mpv_suspend(). Короче говоря, это не позволяет игроку отображать следующее
видеокадр, чтобы вас не заблокировали при попытке доступа к плееру.

продолжить Отменить один приостановить вызов. приостановить увеличивает внутренний счетчик и продолжить
уменьшает его. При достижении 0 проигрыватель фактически возобновляется.

get_version
Возвращает версию клиентского API, которую предоставляет C API удаленного экземпляра mpv. (Также
посмотреть ДОКУМЕНТЫ/client-api-changes.rst.)

UTF-8
Обычно все строки в кодировке UTF-8. Иногда может случиться так, что строки находятся в некоторых
нарушенная кодировка (часто случается с файловыми тегами и т. д., а имена файлов на многих Unix-системах
также не требуется кодировка UTF-8). Это означает, что mpv иногда отправляет неверный JSON. Если
это проблема парсера клиентского приложения, он должен фильтровать необработанные данные для
недопустимые последовательности UTF-8 и выполнить требуемую замену перед подачей данных в
его парсер JSON.

mpv не будет пытаться создать неверный UTF-8 с поврежденными escape-последовательностями.

CHANGELOG

Настоящего журнала изменений нет, но вы можете посмотреть на следующие вещи:

· Журнал изменений релиза, который должен содержать большинство видимых пользователями изменений, включая новые
функции и исправления ошибок:

https://github.com/mpv-player/mpv/releases

· Журнал git, который является «настоящим» журналом изменений

· Файл mplayer-changes.rst в DOCS подкаталог в репозитории git, который использовал
быть на месте этого раздела. Он документирует некоторые изменения, произошедшие со времен mplayer2.
развилка MPlayer.

ВСТУПЛЕНИЕ INTO ДРУГИЕ ПРОГРАММЫ (ЛИБМПВ)

mpv можно встраивать в другие программы в качестве бэкенда для воспроизведения видео/аудио. Рекомендуемый
способ сделать это с помощью libmpv. Видеть libmpv/client.h в репозитории исходного кода mpv. Этот
предоставляет C API. Могут быть доступны привязки для других языков (см. вики).

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

Существует ряд переменных среды, которые можно использовать для управления поведением
MPV.

ГЛАВНАЯ, XDG_CONFIG_HOME
Используется для определения каталога конфигурации mpv. Если XDG_CONFIG_HOME не установлен,
$HOME/.config/mpv используется.

$HOME/.mpv всегда добавляется в список путей поиска конфига с более низким
приоритет.

XDG_CONFIG_DIRS
Если установлено, используются каталоги конфигурации системы в стиле XDG. В противном случае UNIX
конвенция (ПРЕФИКС/etc/mpv/) используется.

СРОК Используется для определения типа терминала.

MPV_HOME
Каталог, в котором mpv ищет пользовательские настройки. Переопределяет ГЛАВНАЯ, и mpv попытается
загрузить файл конфигурации как $MPV_HOME/mpv.conf.

MPV_VERBOSE (См. причислены -v и --msg-уровень)
Установите начальный уровень детализации для всех модулей сообщений (по умолчанию: 0). Это
целое число, а результирующая многословность соответствует количеству --v кредита
передается в командную строку.

MPV_LEAK_REPORT
Если установлено на 1, включите внутреннюю отчетность об утечке Talloc. Обратите внимание, что это может вызвать
проблемы с многопоточностью, поэтому использовать это должны только разработчики.

LADSPA_PATH
Указывает путь поиска плагинов LADSPA. Если он не установлен, полный путь
должны использоваться имена.

ДИСПЛЕЙ
Стандартное отображаемое имя X11 для использования.

FFmpeg/библиотека:
Эта библиотека обращается к различным переменным среды. Однако они не
документируются централизованно, и документирование их не является нашей работой. Поэтому этот список
неполный.

Известные переменные окружения:

http_proxy
URL для прокси для http:// и https:// URL-адрес.

нет_прокси
Список шаблонов доменов, для которых не следует использовать прокси. Записи списка
разделены по ,. Шаблоны могут включать *.

libdvdcss:

DVDCSS_CACHE
Укажите каталог, в котором будут храниться значения ключей заголовка. Это ускорит
дескремблирование DVD-дисков, находящихся в кэше. То DVDCSS_CACHE каталог
создается, если он не существует, и создается подкаталог с именем
Название DVD или дата изготовления. Если DVDCSS_CACHE не установлен или пуст,
libdvdcss будет использовать значение по умолчанию, которое ${HOME}/.dvdcss/ под Unix
и перемещаемый каталог данных приложения (% APPDATA%) под Windows. То
специальное значение "off" отключает кеширование.

Dvdcss_method
Устанавливает метод аутентификации и расшифровки, который libdvdcss будет использовать для
читать скрэмбл-диски. Может быть одним из название, ключ or диск.

ключ является методом по умолчанию. libdvdcss будет использовать набор рассчитанных плееров
ключи, чтобы попытаться получить ключ диска. Это может привести к сбою, если диск не
распознать любую из клавиш игрока.

диск является резервным методом, когда ключ не работает. Вместо использования плеера
keys, libdvdcss взломает ключ диска, используя грубую силу
алгоритм. Этот процесс интенсивно использует ЦП и требует 64 МБ памяти.
для хранения временных данных.

название является запасным вариантом, когда все другие методы не сработали. Это не зависит
при обмене ключами с DVD-приводом, а использует криптоатаку
чтобы угадать ключ заголовка. В редких случаях это может не сработать, потому что
недостаточно зашифрованных данных на диске для выполнения статистического
атаки, но с другой стороны это единственный способ расшифровать DVD
хранится на жестком диске или DVD с неправильным регионом на RPC2
езды.

DVDCSS_RAW_DEVICE
Укажите необработанное устройство для использования. Точное использование будет зависеть от вашей операционной
системы, утилита Linux для настройки необработанных устройств сырье(8) например.
Обратите внимание, что в большинстве операционных систем использование необработанного устройства требует
высоко выровненные буферы: Linux требует выравнивания 2048 байт (что является
размер сектора DVD).

DVDCSS_VERBOSE
Устанавливает уровень детализации libdvdcss.

0 Не выводит вообще никаких сообщений.

1 Выводит сообщения об ошибках в stderr.

2 Выводит сообщения об ошибках и отладочные сообщения в stderr.

DVDREAD_NOKEYS
Пропустить получение всех ключей при запуске. В настоящее время отключен.

ГЛАВНАЯ FIXME: Задокументируйте это.

ВЫХОД КОДЫ

Обычная стоимость MPV возвращает 0 в качестве кода выхода после успешного завершения воспроизведения. Если ошибки
случиться, могут быть возвращены следующие коды выхода:

1 Ошибка инициализации mpv. Это также возвращается, если неизвестные параметры передаются в
MPV.

2 Файл, переданный в mpv, не может быть воспроизведен. Это несколько нечетко: в настоящее время
воспроизведение файла считается успешным, если инициализация в основном
успешно, даже если воспроизведение завершается ошибкой сразу после инициализации.

3 Были некоторые файлы, которые можно было воспроизвести, и некоторые файлы, которые не могли (используя
определение успеха сверху).

4 Выйти по сигналу, Ctrl+c в окне VO (по умолчанию) или из стандартного
выйти из привязки клавиш в режиме кодирования.

Обратите внимание, что выход из проигрывателя вручную всегда приводит к коду выхода 0, переопределяющему
код выхода, который будет возвращен в обычном режиме. Так же выход команда ввода может принять выход
код: в этом случае возвращается этот код выхода.

Используйте mpv онлайн с помощью сервисов onworks.net