NAME¶
mkvinfo - Vypisovat informace o prvcích v souborech
Matroska(TM)
PřEHLED¶
mkvinfo [options] {source-filename}
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.
-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).
Ú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.
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).
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.
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é:
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.
WWW¶
Nejnovější verzi lze vždy najít
na domovské stránce MKVToolNix[1].
AUTHOR¶
Moritz Bunkus <moritz@bunkus.org>
Vývojář
NOTES¶
- 1.
- domovské stránce MKVToolNix