mkvinfo -- Запись информации об элементах в файлы Matroska(tm)

# 1. Краткое содержание

mkvinfo параметры {исходный-файл}

# 2. Описание

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

Option | Description
--- | ---
-a, --all | By default mkvinfo(1) stops when it encounters the first cluster. Additionally it doesn't show certain often occurring elements. With this option mkvinfo(1) will continue processing regardless of the verbosity level and show all elements.
-c, --checksums | Вычисляет и отображает контрольную сумму Adler-32 для каждого кадра. Полезно только для отладки.
-o, --continue | По умолчанию mkvinfo(1) останавливается, когда он обнаруживает первый кластер. С помощью этого параметра mkvinfo(1) будет продолжать обработку независимо от уровня детализации.
-p, --hex-positions | Показывать позицию каждого элемента в шестнадцатеричном виде вне зависимости от уровня детализации.
-P, --positions | Показывать позицию каждого элемента в десятичном виде вне зависимости от уровня детализации.
-s, --summary | Показывать только краткую информацию и не каждый элемент в результатах поиска mkvinfo(1).
-t, --track-info | Показать статистику для каждой дорожки в расширенном режиме. Также устанавливает режим расширенности в 1, если он был 0 до этого.
-x, --hexdump | Показать 16 первых байтов каждого кадра в шестнадцатеричном виде.
-X, --full-hexdump | Показать все байты каждого кадра в шестнадцатеричном виде.
-z, --size | Показать размер каждого элемента, в том числе его заголовка.
--command-line-charset кодировка | Устанавливает кодировку для конвертации строк, указанных в командной строке. Стандартная кодировка привязана с системной локализации.
--output-charset кодировка | Указывает кодировку, в которую конвертируются выходные строки. По умолчанию используется текущая кодировка системного языка.
-r, --redirect-output имя-файла | Все сообщения записываются в файл имя-файла вместо консоли. Хотя это можно сделать и через перенаправление вывода, есть отдельные случаи применения именно этого параметра: когда терминал интерпретирует в другой способ вывод перед записью файла. Набор символов, заданный через --output-charset, учитывается.
--ui-language код | Принудительно использовать перевод на код языка (напр. "de_DE" для немецкого). Если указать "list" вместо кода, то отобразится список доступных переводов.
--abort-on-warnings | Указывает mkvmerge прерывание после появления первого предупреждения. Код завершения программы будет 1.
--debug тематика | Включить режим отладки для указанной функции. Этот параметр полезен только для разработчиков.
--engage функция | Включить экспериментальные функции. Список доступных функций может быть вызван с помощью mkvinfo --engage list. Эти функции не предназначены для повседневного использования.
--gui-mode | Включает режим графического интерфейса. В этом режиме могут отображаться специально отформатированные линии для отправки управляющих сообщений интерфейсу. Формат сообщений — '#GUI#message'. За сообщением огут быть указаны пары ключа и значения, например '#GUI#message#key1=value1#key2=value2…'. Сообщения и ключи не переводятся и всегда выводятся на английском.
-v, --verbose | Больше подробностей. Смотрите секцию об уровнях детализации с описанием информации, выводимой на каждом уровне.
-h, --help | Показать сведения об использовании и выйти.
-V, --version | Показать сведения о версии и выйти.
@файл-параметров.json | Считывает дополнительные аргументы командной строки из файла options-file. Полное описание поддерживаемых форматов для таких файлов смотрите в разделе "Файлы параметров" на странице документации mkvmerge(1).

# 3. Уровни детализации

Параметр -v может быть использован для повышения уровня детализации mkvinfo(1) и для вывода большей информации о текущем файле.

At level 0 mkvinfo(1) will print only the track headers it finds and their types. mkvinfo(1) will exit as soon as the headers are parsed completely (more technical: as soon as the first cluster is encountered). In this level the seek head entries and the cues will not be displayed -- even if they're located in front of the track information.

At level 1 mkvinfo(1) will also print all Matroska(tm) elements encountered for the complete file but the seek head entries and the cue entries. If the summary mode is enabled then mkvinfo(1) will output the frame position as well.

Тот же эффект достигается параметром --continue.

На уровне 2 mkvinfo(1) также выведет записи заголовков поиска, записи cue и позицию в файле, на которой каждый элемент Matroska(tm) может быть найден.

Тот же эффект достигается параметром --all --positions.

At level 3 and above mkvinfo(1) will print some information that is not directly connected to a Matroska(tm) element. All other elements only print stuff about the elements that were just found. Level 3 adds meta information to ease debugging (read: it's intended for developers only). All lines written by level 3 are enclosed in square brackets to make filtering them out easy.

# 4. Преобразование текстовых файлов и кодировок

For an in-depth discussion about how all tools in the MKVToolNix suite handle character set conversions, input/output encoding, command line encoding and console encoding please see the identically-named section in the mkvmerge(1) man page.

# 5. Коды завершения

mkvinfo(1) завершается с одним из трёх кодов:

- 0 -- Этот код завершения означает, что запуск закончился успешно.

- 1 -- В этом случае mkvinfo(1) выдал хотя бы одно предупреждение, однако процесс продолжился. Предупреждению предшествует текст 'Warning:'.

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

# 6. Переменные среды

mkvinfo(1) использует стандартные переменные, определяющие системный язык (например: LANG и семейство LC_*). Дополнительные переменные:

Option | Description
--- | ---
MKVINFO_DEBUG, MKVTOOLNIX_DEBUG и его краткая форма MTX_DEBUG | Содержимое обрабатывается так, как если бы оно было передано с помощью параметра --debug.
MKVINFO_ENGAGE, MKVTOOLNIX_ENGAGE и его краткая форма MTX_ENGAGE | Содержимое обрабатывается так, как если бы оно было передано с помощью параметра --engage.

# 7. Смотрите также

mkvmerge(1), mkvextract(1), mkvpropedit(1), mkvtoolnix-gui(1)

# 8. Домашняя страница

Последняя версия программы всегда доступна на домашней странице MKVToolNix.