NAME

mkvpropedit - Úprava vlastností existujících souborů Matroska(TM) bez úplného opětovného multiplexování

PřEHLED

mkvpropedit [options] {source-filename} {actions}

POPIS

Tento program analyzuje existující soubor Matroska(TM) a upraví některé jeho vlastnosti. Změny poté zapíše do existujícího souboru. Mezi upravitelné vlastnosti patří prvky informací o úseku (např. název) a hlavičky stop (např. kód jazyka, příznak „výchozí stopa“ nebo název).

Volby:

-l, --list-property-names

-p, --parse-mode mode

Akce pracující s vlastnostmi hlaviček stop a informací o úseku:

-e, --edit selector

-a, --add name=value

-s, --set name=value

-d, --delete name

Akce pracující se štítky a kapitolami:

-t, --tags selector:filename

--add-track-statistics-tags

--delete-track-statistics-tags

-c, --chapters filename

Akce pro práci s přílohami:

--add-attachment filename

--replace-attachment selector:filename

--update-attachment selector

--delete-attachment selector

Volby pro akce s přílohami:

--attachment-name name

--attachment-mime-type mime-type

--attachment-description description

--enable-legacy-font-mime-types

Další volby:

--disable-language-ietf

--normalize-language-ietf mode

--command-line-charset character-set

--output-charset character-set

-r, --redirect-output file-name

--no-bom

--ui-language code

--abort-on-warnings

--debug topic

--engage feature

--gui-mode

-v, --verbose

-h, --help

-V, --version

@options-file.json

SELEKTORY úPRAV

Volba --edit nastaví oddíl souboru Matroska(TM) (informace o úseku nebo hlavičky určité stopy), se kterým budou pracovat všechny následující akce přidání, nastavení a odstranění. Nastavení zůstává platné až do nalezení další volby --edit. Argument této volby se nazývá selektor úprav.

Ve výchozím nastavení bude mkvpropedit(1) upravovat oddíl informací o úseku.

SELEKTORY PříLOH

Selektor příloh se používá se dvěma akcemi --replace-attachment a --delete-attachment. Může mít jeden z následujících čtyř tvarů:

ZPRACOVáNí JAZYKů

mkvpropedit(1) se ve výchozím nastavení většinou snaží postupovat správně. Změna vlastnosti language proto způsobí, že mkvpropedit(1) použije stejnou změnu pro nový prvek „LanguageIETF“ i starší prvek „Language“, podobně jako mkvmerge(1) nastavuje jazyk v obou prvcích. Při použití příkazu mkvpropedit movie.mkv --edit track:2 --set language=zh-TW se například prvek „LanguageIETF“ nastaví na zh-TW a starší prvek „Language“ na chi.

Kromě toho existuje nová vlastnost hlavičky stopy nazvaná language-ietf, kterou lze nastavit nebo odstranit. Změny této vlastnosti se vztahují pouze na nový prvek hlavičky stopy „LanguageIETF“. Komplikací je, že starší prvek hlavičky stopy „Language“ je v Matrosce povinný — i když tedy v souboru není přítomen, má stále předpokládanou hodnotu. Nastaví-li uživatel pouze vlastnost language-ietf, ale nikoli vlastnost language, mkvpropedit(1) proto v určitých případech přidá starší prvek „Language“ & nastaví jej na und (tedy „neurčeno“), protože uživatel jeho hodnotu nezadal.

Při načítání souborů XML s kapitolami nebo štítky pracuje mkvpropedit(1) stejně jako mkvmerge(1).

Vytváření nových prvků lze zcela zakázat volbou příkazového řádku `--disable-language-ietf`, která se vztahuje na všechny tři nové prvky.

Parametrem --normalize-language-ietf lze zvolit metodu normalizace používanou pro rozšířené jazykové podznačky.

PříKLADY

Následující příklad upravuje soubor nazvaný 'movie.mkv'. Nastaví název úseku a změní kód jazyka zvukové a titulkové stopy. Tento příklad lze zkrátit vynecháním první volby --edit, protože úprava prvku informací o úseku je výchozí pro všechny volby uvedené před první volbou --edit.

$ mkvpropedit movie.mkv --edit info --set "title=The movie" --edit track:a1 --set language=fre --edit track:a2 --set language=ita

Druhý příklad odstraní příznak „výchozí stopa“ z první titulkové stopy a nastaví jej pro druhou. Upozorňujeme, že mkvpropedit(1) na rozdíl od mkvmerge(1) automaticky nenastaví příznak „výchozí stopa“ ostatních stop na „0“, když je u jiné stopy nastaven na „1“.

$ mkvpropedit movie.mkv --edit track:s1 --set flag-default=0 --edit track:s2 --set flag-default=1

Nahrazení štítků druhé titulkové stopy v souboru vypadá takto:

$ mkvpropedit movie.mkv --tags track:s2:new-subtitle-tags.xml

Při odstraňování všech štítků je nutné vynechat název souboru:

$ mkvpropedit movie.mkv --tags all:

Nahrazení kapitol v souboru vypadá takto:

$ mkvpropedit movie.mkv --chapters new-chapters.xml

Při odstraňování všech kapitol je nutné vynechat název souboru:

$ mkvpropedit movie.mkv --chapters ''

Přidání souboru písma (Arial.ttf) jako přílohy:

$ mkvpropedit movie.mkv --add-attachment Arial.ttf

Přidání souboru písma (89719823.ttf) jako přílohy a uvedení několika informací, protože ve skutečnosti jde pouze o Arial:

$ mkvpropedit movie.mkv --attachment-name Arial.ttf --attachment-description 'The Arial font as a TrueType font' --attachment-mime-type application/x-truetype-font --add-attachment 89719823.ttf

Nahrazení jednoho přiloženého souboru písma (Comic.ttf) jiným (Arial.ttf):

$ mkvpropedit movie.mkv --attachment-name Arial.ttf --attachment-description 'The Arial font as a TrueType font' --replace-attachment name:Comic.ttf:Arial.ttf

Odstranění druhého přiloženého souboru bez ohledu na to, o jaký soubor jde:

$ mkvpropedit movie.mkv --delete-attachment 2

Odstranění všech přiložených písem podle typu MIME:

$ mkvpropedit movie.mkv --delete-attachment mime-type:application/x-truetype-font

NáVRATOVé KóDY

mkvpropedit(1) končí jedním ze tří návratových kódů:

TEXTOVé SOUBORY A PřEVODY ZNAKOVýCH SAD

Podrobnou diskusi o způsobu, jakým všechny nástroje sady MKVToolNix pracují s převody znakových sad, kódováním vstupu/výstupu, příkazového řádku a konzole, naleznete ve stejnojmenném oddílu manuálové stránky mkvmerge(1).

PROMěNNé PROSTřEDí

mkvpropedit(1) používá výchozí proměnné určující národní prostředí systému (např. LANG a rodinu LC_*). Další proměnné:

MKVPROPEDIT_DEBUG, MKVTOOLNIX_DEBUG a její zkrácený tvar MTX_DEBUG

MKVPROPEDIT_ENGAGE, MKVTOOLNIX_ENGAGE a její zkrácený tvar MTX_ENGAGE

VIZ TAKé

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

WWW

Nejnovější verzi lze vždy najít na domovské stránce MKVToolNix[1].

AUTHOR

Moritz Bunkus <moritz@bunkus.org>

NOTES

1.

domovské stránce MKVToolNix