mkvinfo -- Vypisovat informace o prvcích v souborech Matroska

mkvinfo -- Vypisovat informace o prvcích v souborech Matroska(tm)

# 1. Přehled

mkvinfo options {source-filename}

# 2. Popis

Tento program vypisuje všechny prvky obsažené v souboru Matroska(tm). Výstup lze omezit na seznam stop v souboru včetně informací o použitých kodecích.

Option | Description
--- | ---
-a, --all | Ve výchozím stavu se mkvinfo(1) zastaví při prvním clusteru. Navíc nezobrazuje některé často se vyskytující prvky. S touto volbou bude mkvinfo(1) pokračovat ve zpracování bez ohledu na úroveň podrobnosti a zobrazí všechny prvky.
-c, --checksums | Vypočítá a zobrazí kontrolní součet Adler-32 pro každý snímek. Užitečné pouze pro ladění.
-o, --continue | Ve výchozím stavu se mkvinfo(1) zastaví při prvním clusteru. S touto volbou bude mkvinfo(1) pokračovat ve zpracování bez ohledu na úroveň podrobnosti.
-p, --hex-positions | Zobrazí pozice všech prvků šestnáctkově bez ohledu na úroveň podrobnosti.
-P, --positions | Zobrazí pozice všech prvků desítkově bez ohledu na úroveň podrobnosti.
-s, --summary | Zobrazí pouze stručný souhrn toho, co mkvinfo(1) najde, nikoli každý prvek.
-t, --track-info | V podrobném režimu zobrazí statistiky každé stopy. Pokud byla úroveň podrobnosti dříve 0, nastaví ji také na 1.
-x, --hexdump | Zobrazit prvních 16 bajtů každého snímku v šestnáctkové soustavě.
-X, --full-hexdump | Zobrazit všechny bajty každého snímku v šestnáctkové soustavě.
-z, --size | Zobrazit velikost každého prvku včetně jeho hlavičky.
--command-line-charset character-set | Nastavuje znakovou sadu, ze které se převádějí řetězce zadané na příkazovém řádku. Výchozí je znaková sada daná aktuálním národním prostředím systému.
--output-charset character-set | Nastavuje znakovou sadu, do které se převádějí řetězce určené k výstupu. Výchozí je znaková sada daná aktuálním národním prostředím systému.
-r, --redirect-output file-name | Zapíše všechny zprávy do souboru file-name místo na konzoli. Ačkoli to lze snadno provést přesměrováním výstupu, tato volba je potřeba v případech, kdy terminál výstup před zápisem do souboru znovu interpretuje. Je respektována znaková sada nastavená pomocí --output-charset.
--no-bom | Textové soubory vytvořené & kódované v některé z variant UTF obvykle začínají značkou pořadí bajtů (BOM). Tato volba zakáže zápis této značky pořadí bajtů.
--ui-language code | Vynutí použití překladů pro jazyk code (např. 'de_DE' pro německé překlady). Zadáním 'list' jako code program vypíše seznam dostupných překladů.
--abort-on-warnings | Ukončí program po vydání prvního upozornění. Návratový kód programu bude 1.
--debug topic | Zapne ladění určité funkce. Tato volba je užitečná pouze pro vývojáře.
--engage feature | Zapne experimentální funkce. Seznam dostupných funkcí lze vyžádat pomocí mkvinfo --engage list. Tyto funkce nejsou určeny pro běžné použití.
--gui-mode | Zapne režim GUI. V tomto režimu mohou být vypisovány speciálně formátované řádky, které řídicímu GUI sdělují, co se děje. Tyto zprávy mají formát '#GUI#message'. Za zprávou mohou následovat dvojice klíč/hodnota jako v '#GUI#message#key1=value1#key2=value2…'. Zprávy ani klíče se nikdy nepřekládají a vždy jsou vypisovány anglicky.
-v, --verbose | Vypisuje podrobnější informace. Popis informací vypisovaných na jednotlivých úrovních naleznete v oddílu úrovně podrobnosti.
-h, --help | Zobrazí informace o použití a ukončí se.
-V, --version | Zobrazí informace o verzi a ukončí se.
@options-file.json | Načte další argumenty příkazového řádku ze souboru options-file. Úplné vysvětlení podporovaných formátů takových souborů naleznete v oddílu „Option files“ manuálové stránky mkvmerge(1).

# 3. Úrovně podrobnosti

Volbu -v lze použít ke zvýšení úrovně podrobnosti programu mkvinfo(1) a výpisu dalších informací o aktuálním souboru.

Na úrovni 0 mkvinfo(1) vypíše pouze nalezené hlavičky stop a jejich typy. mkvinfo(1) skončí, jakmile jsou hlavičky zcela analyzovány (technicky: jakmile je nalezen první cluster). Na této úrovni se položky hlavičky vyhledávání ani indexy nezobrazí, ani když jsou umístěny před informacemi o stopách.

Na úrovni 1 mkvinfo(1) vypíše také všechny nalezené prvky Matroska(tm) pro celý soubor kromě položek hlavičky vyhledávání a indexů. Je-li povolen režim souhrnu, mkvinfo(1) vypíše také pozici snímku.

Stejného účinku lze dosáhnout volbou --continue.

Na úrovni 2 mkvinfo(1) vypíše také položky hlavičky vyhledávání, položky indexů a pozici v souboru, na které lze nalézt každý prvek Matroska(tm).

Stejného účinku lze dosáhnout volbami --all --positions.

Na úrovni 3 a vyšší bude mkvinfo(1) vypisovat některé informace, které přímo nesouvisejí s prvkem Matroska(tm). Na všech ostatních úrovních vypisuje pouze informace o právě nalezených prvcích. Úroveň 3 přidává metainformace usnadňující ladění (tj. je určena pouze pro vývojáře). Všechny řádky vypisované na úrovni 3 jsou uzavřeny v hranatých závorkách, aby je bylo možné snadno odfiltrovat.

# 4. 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).

# 5. Návratové kódy

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

- 0 – Tento návratový kód znamená, že běh programu byl úspěšně dokončen.

- 1 – V tomto případě mkvinfo(1) vypsal alespoň jedno upozornění, ale běh pokračoval. Upozornění má předponu 'Warning:'.

- 2 – Tento návratový kód se použije po výskytu chyby. mkvinfo(1) se ukončí hned po vypsání chybové zprávy. Chybové zprávy sahají od chybných argumentů příkazového řádku přes chyby čtení a zápisu až po poškozené soubory.

# 6. Proměnné prostředí

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

Option | Description
--- | ---
MKVINFO_DEBUG, MKVTOOLNIX_DEBUG a její zkrácený tvar MTX_DEBUG | Obsah se zpracuje, jako by byl předán pomocí volby --debug.
MKVINFO_ENGAGE, MKVTOOLNIX_ENGAGE a její zkrácený tvar MTX_ENGAGE | Obsah se zpracuje, jako by byl předán pomocí volby --engage.

# 7. Viz také

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

# 8. WWW

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