mkvpropedit(1) | Команды пользователя | mkvpropedit(1) |
НАЗВАНИЕ¶
mkvpropedit - Изменяет свойства существующих файлов Matroska без сложного ремультиплексирования
КРАТКОЕ СОДЕРЖАНИЕ¶
mkvpropedit [параметры] {имя-исходного-файла} {действия}
ОПИСАНИЕ¶
This program analyses an existing Matroska file and modifies some of its properties. Then it writes those modifications to the existing file. Among the properties that can be changed are the segment information elements (e.g. the title) and the track headers (e.g. the language code, 'default track' flag or the name).
Параметры:
-l, --list-property-names
-p, --parse-mode режим
Действия для работы с дорожками и свойствами информационных сегментов:
-e, --edit selector
По умолчанию mkvpropedit(1) будет править секцию информации о сегменте.
Смотрите секцию редактирование селекторов для полного описания синтаксиса.
-a, --add name=значение
-s, --set name=значение
-d, --delete name
Действия для работы с тегами и главами:
-t, --tags selector:имя-файла
The selector must be one of the words all, global or track. For all mkvpropedit(1) will replace or remove all tags in a file. With global only global tags will be replaced or removed.
With track mkvpropedit(1) will replace tags for a specific track. Additionally the tags read from filename will be assigned to the same track. The track is specified in the same way edit selectors are specified (see below), e.g. --tags track:a1:new-audio-tags.xml.
--add-track-statistics-tags
--delete-track-statistics-tags
-c, --chapters имя-файла
Действия для обработки вложений:
--add-attachment имя-файла
Если параметр --attachment-name использовался до этого параметра, его значение используется как имя нового вложения. Иначе он является производным от filename.
Если параметр --attachment-mime-type использовался до этого параметра, его значение используется как тип MIME нового вложения. Иначе он автоматически обнаруживается из содержимого filename.
If the option --attachment-description has been used prior to this option then its value is used as the new attachment's description. Otherwise no description will be set.
If the option --attachment-uid has been used prior to this option then its value is used as the new attachment's UID. Otherwise a random UID will be generated automatically.
--replace-attachment селектор:имя-файла
The selector can have one of four forms. They're explained below in the section attachment selectors.
Если параметр --attachment-name использовался до этого параметра, его значение устанавливается в виде нового имени для каждого изменённого вложения. Иначе имена не меняются.
Если параметр --attachment-mime-type использовался до этого параметра, его значение устанавливается в виде нового типа MIME для каждого изменённого вложения. Иначе типы MIME не меняются.
Если параметр --attachment-description использовался до этого параметра, его значение устанавливается в виде нового описания для каждого изменённого вложения. Иначе описания не меняются.
Если параметр --attachment-uid использовался до этого параметра, его значение устанавливается в виде нового UID для каждого изменённого вложения. Иначе UID не меняются.
--update-attachment селектор
The selector can have one of four forms. They're explained below in the section attachment selectors.
Если параметр --attachment-name использовался до этого параметра, его значение устанавливается в виде нового имени для каждого изменённого вложения. Иначе имена не меняются.
Если параметр --attachment-mime-type использовался до этого параметра, его значение устанавливается в виде нового типа MIME для каждого изменённого вложения. Иначе типы MIME не меняются.
Если параметр --attachment-description использовался до этого параметра, его значение устанавливается в виде нового описания для каждого изменённого вложения. Иначе описания не меняются.
Если параметр --attachment-uid использовался до этого параметра, его значение устанавливается в виде нового UID для каждого изменённого вложения. Иначе UID не меняются.
--delete-attachment селектор
The selector can have one of four forms. They're explained below in the section attachment selectors.
Параметры действий над вложениями:
--attachment-name имя
--attachment-mime-type тип-mime
--attachment-description описание
--enable-legacy-font-mime-types
This affects both adding new attachments and replacing existing attachments, but only if the new MIME type isn't specified. Other existing attachments aren't changed.
Затрагиваются типы MIME: «font/sfnt», «font/ttf» и «font/collection»; они сопоставляются с «application/x-truetype-fonts» и «font/otf», который сопоставляется с «application/vnd .ms-opentype».
Прочие параметры:
--disable-language-ietf
Этот параметр не влияет на изменения, запрашиваемые через свойство 'language-ietf' заголовка дорожки.
--normalize-language-ietf режим
В канонической форме все подтеги, для которых существуют предпочтительные значения, заменяются этими предпочтительными значениями. Это преобразует, например, «zh-yue-jyutping» в «yue-jyutping» или «fr-FX» в «fr-FR».
Для формы расширенных языковых подтегов изначально строится каноническая форма. После этого все основные языки, для которых существует расширенный языковой подтег, заменяются этим расширенным языковым подтегом и его префиксом. Это преобразует, например, «yue-jyutping» обратно к «zh-yue-jyutping», но не влияет на «fr-FR», потому что «fr» не является расширенным языковым подтегом.
Эта нормализация применяется только к элементам, которые фактически изменены:
The best way to normalize all existing language tags in a file is to remux it with mkvmerge(1) and set its '--normalize-language-ietf' option to the desired mode.
--command-line-charset кодировка
--output-charset кодировка
-r, --redirect-output имя-файла
--ui-language код
--abort-on-warnings
--debug тематика
--engage функция
--gui-mode
-v, --verbose
-h, --help
-V, --version
@файл-параметров.json
РЕДАКТИРОВАНИЕ СЕЛЕКТОРОВ¶
The --edit option sets the Matroska file section (segment information or a certain track's headers) that all following add, set and delete actions operate on. This stays valid until the next --edit option is found. The argument to this option is called the edit selector.
По умолчанию mkvpropedit(1) будет править секцию информации о сегменте.
Информация о сегментах¶
The segment information can be selected with one of these three words: 'info', 'segment_info' or 'segmentinfo'. It contains properties like the segment title or the segment UID.
Заголовки дорожки¶
Track headers can be selected with a slightly more complex selector. All variations start with 'track:'. The track header properties include elements like the language code, 'default track' flag or the track's name.
track:n
Нумерация начинается с 1.
track:tn
Нумерация начинается с 1.
track:=uid
track:@номер
Примечания¶
Due to the nature of the track edit selectors it is possible that several selectors actually match the same track headers. In such cases all actions for those edit selectors will be combined and executed in the order in which they're given on the command line.
СЕЛЕКТОРЫ ВЛОЖЕНИЙ¶
Селектор вложений используется для двух действий: --replace-attachment и --delete-attachment. Он может принимать одну из следующих четырех форм:
ПРИМЕРЫ¶
The following example edits a file called 'movie.mkv'. It sets the segment title and modifies the language code of an audio and a subtitle track. Note that this example can be shortened by leaving out the first --edit option because editing the segment information element is the default for all options found before the first --edit option anyway.
$ mkvpropedit фильм.mkv --edit info --set "title=Фильм" --edit track:a1 --set language=fre --edit track:a2 --set language=ita
The second example removes the 'default track flag' from the first subtitle track and sets it for the second one. Note that mkvpropedit(1), unlike mkvmerge(1), does not set the 'default track flag' of other tracks to '0' if it is set to '1' for a different track automatically.
$ mkvpropedit фильм.mkv --edit track:s1 --set flag-default=0 --edit track:s2 --set flag-default=1
Замена тегов во второй дорожке субтитров файла выглядит так:
$ mkvpropedit фильм.mkv --tags track:s2:new-subtitle-tags.xml
Удаление всех тегов требует указания имени файла:
$ mkvpropedit фильм.mkv --tags all:
Замена глав в файле выглядит так:
$ mkvpropedit фильм.mkv --chapters новые-главы.xml
Удаление всех глав происходит без указания имени выходного файла:
$ mkvpropedit фильм.mkv --chapters ''
Добавление файла шрифта (Arial.ttf) в виде вложения:
$ mkvpropedit фильм.mkv --add-attachment Arial.ttf
Добавление файла шрифта (89719823.ttf) в виде вложения и описание информации, что это Arial:
$ mkvpropedit фильм.mkv --attachment-name Arial.ttf --attachment-description 'Шрифт Arial в виде шрифта TrueType' --attachment-mime-type application/x-truetype-font --add-attachment 89719823.ttf
Замена вложенного файла шрифта (Comic.ttf) другим (Arial.ttf):
$ mkvpropedit фильм.mkv --attachment-name Arial.ttf --attachment-description 'Шрифт Arial в виде шрифта TrueType' --replace-attachment name:Comic.ttf:Arial.ttf
Удаление второго вложенного файла, неважно какого именно:
$ mkvpropedit фильм.mkv --delete-attachment 2
Удаление всех вложенных шрифтов по типу MIME:
$ mkvpropedit фильм.mkv --delete-attachment mime-type:application/x-truetype-font
КОДЫ ЗАВЕРШЕНИЯ¶
mkvpropedit(1) завершается с одним из трёх кодов:
ПРЕОБРАЗОВАНИЕ ТЕКСТОВЫХ ФАЙЛОВ И КОДИРОВОК¶
Подробное обсуждение того, как все инструменты пакета MKVToolNix обрабатывают преобразование наборов символов, кодировку ввода / вывода, кодировку командной строки и кодировку консоли, смотрите в разделе с идентичным названием в справочной странице mkvmerge(1).
ПЕРЕМЕННЫЕ СРЕДЫ¶
mkvpropedit(1) использует стандартные переменные, определяющие системный язык (например: LANG и семейство LC_*). Дополнительные переменные:
MKVPROPEDIT_DEBUG, MKVTOOLNIX_DEBUG и его краткая форма MTX_DEBUG
MKVPROPEDIT_ENGAGE, MKVTOOLNIX_ENGAGE и его краткая форма MTX_ENGAGE
СМОТРИТЕ ТАКЖЕ¶
ДОМАШНЯЯ СТРАНИЦА¶
Последняя версия программы всегда доступна на домашней странице MKVToolNix[1].
АВТОР¶
Мориц Бункус <moritz@bunkus.org>
ПРИМЕЧАНИЯ¶
- 1.
- домашней странице MKVToolNix
2022-08-14 | MKVToolNix 70.0.0 |