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.

Table of contents