1. Szablon linii komend#
2. Opis#
Ten program wyświetla wszystkie elementy zawarte w pliku Matroska(tm). Wyjście można ograniczyć do listy ścieżek w pliku wraz z informacjami o użytych kodekach.
| Option | Description |
|---|---|
| -a, --all# |
Domyślnie mkvinfo(1) zatrzymuje się po napotkaniu pierwszego klastra. Ponadto nie wyświetla niektórych często występujących elementów. Z tą opcją mkvinfo(1) będzie kontynuować przetwarzanie niezależnie od poziomu szczegółowości i wyświetli wszystkie elementy. |
| -c, --checksums# |
Oblicza i wyświetla sumę kontrolną Adler-32 dla każdej klatki. Opcja przydatna wyłącznie do debugowania. |
| -o, --continue# |
Domyślnie mkvinfo(1) zatrzymuje się po napotkaniu pierwszego klastra. Z tą opcją mkvinfo(1) będzie kontynuować przetwarzanie niezależnie od poziomu szczegółowości. |
| -p, --hex-positions# |
Pokaż pozycje wszystkich elementów w systemie szesnastkowym, niezależnie od poziomu szczegółowości. |
| -P, --positions# |
Pokaż pozycje wszystkich elementów w systemie dziesiętnym, niezależnie od poziomu szczegółowości. |
| -s, --summary# |
Pokaż tylko zwięzłe podsumowanie tego, co znalazł mkvinfo(1), a nie każdy element. |
| -t, --track-info# |
Wyświetla statystyki dla każdej ścieżki w trybie szczegółowym. Ustawia również poziom szczegółowości na 1, jeśli wcześniej był ustawiony na 0. |
| -x, --hexdump# |
Pokaż pierwsze 16 bajtów każdej klatki jako zrzut szesnastkowy. |
| -X, --full-hexdump# |
Pokaż wszystkie bajty każdej klatki jako zrzut szesnastkowy. |
| -z, --size# |
Pokaż rozmiar każdego elementu łacznie z jego nagłówkiem. |
| --command-line-charset zestaw-znaków# |
Ustawia zestaw znaków, z którego konwertowane są ciągi znaków podane w wierszu poleceń. Domyślnie jest to zestaw znaków określony przez bieżącą lokalizację systemu. |
| --output-charset zestaw-znaków# |
Ustawia zestaw znaków, do którego konwertowane są ciągi znaków przeznaczone do wyprowadzenia. Domyślnie jest to zestaw znaków określony przez bieżącą lokalizację systemu. |
| -r, --redirect-output nazwa-pliku# |
Zapisuje wszystkie powiadomienia do pliku nazwa-pliku zamiast do konsoli. Podczas gdy może być to robione łatwo z przekierowaniem wyjścia, są przypadki, gdy ta opcja właśnie jest potrzebna: gdy terminal ponownie interpretuje plik wyjściowy przed zapisaniem do pliku. Uznawany będzie zestaw znaków ustawiony z opcją --output-charset. |
| --no-bom# |
Zazwyczaj pliki tekstowe utworzone i zakodowane w jednym z wariantów UTF rozpoczynają się od znacznika kolejności bajtów (BOM). Użycie tej opcji wyłącza zapisywanie tego znacznika kolejności bajtów. |
| --ui-language kod# |
Wymusza użycie tłumaczeń dla kodu parameter języka (np. "de_DE” dla tłumaczeń na język niemiecki). Wprowadzenie "list” jako kodu parameter spowoduje, że program wyświetli listę dostępnych tłumaczeń. |
| --abort-on-warnings# |
Nakazuje programowi przerwanie po wyemitowaniu pierwszego ostrzeżenia. Kodem wyjścia programu będzie 1. |
| --debug temat# |
Włącz debugowanie dla konkretnej funkcji. Ta opcja jest użyteczna tylko dla deweloperów. |
| --engage funkcja# |
Włącz funkcje eksperymentalne. Listę dostępnych funkcji można uzyskać za pomocą komendy mkvinfo --engage list. Te funkcje nie są przeznaczone do użytku w normalnych sytuacjach. |
| --gui-mode# |
Włącza tryb GUI. W tym trybie mogą być generowane specjalnie sformatowane linie, które informują interfejs GUI o aktualnym stanie rzeczy. Komunikaty te mają formatt '#GUI#message'. Po komunikacie mogą następować pary klucz/wartość, np '#GUI#message#key1=value1#key2=value2…'. Ani komunikaty, ani klucze nie są tłumaczone i zawsze są wyświetlane w języku angielskim. |
| -v, --verbose# |
Wyświetla więcej informacji. Opis tego, jakie informacje są wyświetlane na poszczególnych poziomach, znajduje się w sekcji dotyczącej poziomów szczegółowości. |
| -h, --pomoc# |
Pokaż informację o sposobie użycia opcji i wyjdź. |
| -V, --wersja# |
Pokaż informację o wersji i wyjdź. |
| @options-file.json# |
Odczytuje dodatkowe argumenty wiersza poleceń z pliku options-file. Pełny opis obsługiwanych formatów takich plików znajduje się w sekcji „Pliki opcji” na stronie man programu &mkvmerge;. |
3. Poziomy szczegółowości#
Opcja -v służy do zwiększania poziomu szczegółowości mkvinfo(1) i wyświetlania większej ilości informacji o bieżącym pliku.
Na poziomie 0 mkvinfo(1) wyświetla tylko znalezione nagłówki ścieżek i ich typy. mkvinfo(1) kończy działanie natychmiast po całkowitym przeanalizowaniu nagłówków (mówiąc bardziej technicznie: po napotkaniu pierwszego klastra). Na tym poziomie wpisy seek head i punkty cue nie są wyświetlane — nawet jeśli znajdują się przed informacjami o ścieżkach.
Na poziomie 1 mkvinfo(1) wyświetla również wszystkie elementy Matroska(tm) znalezione w całym pliku, z wyjątkiem wpisów seek head i wpisów cue. Jeśli włączony jest tryb podsumowania, mkvinfo(1) wyświetli również pozycję klatki.
Ten sam efekt można uzyskać za pomocą opcji --continue.
Na poziomie 2 mkvinfo(1) wyświetla również wpisy seek head, wpisy cue oraz pozycję w pliku, pod którą można znaleźć każdy element Matroska(tm).
Ten sam efekt można uzyskać za pomocą opcji --all --positions.
Na poziomie 3 i wyższym mkvinfo(1) wyświetla dodatkowe informacje, które nie są bezpośrednio związane z elementem Matroska(tm). Na wszystkich pozostałych poziomach wyświetlane są tylko informacje o właśnie znalezionych elementach. Poziom 3 dodaje metainformacje ułatwiające debugowanie (czyli informacje przeznaczone wyłącznie dla programistów). Wszystkie wiersze zapisywane na poziomie 3 są ujęte w nawiasy kwadratowe, aby można je było łatwo odfiltrować.
4. Pliki tekstowe i konwersje zestawów znaków#
Szczegółowe omówienie sposobu, w jaki wszystkie narzędzia w pakiecie MKVToolNix obsługują konwersję zestawu znaków, kodowanie wejściowe/wyjściowe, kodowanie linii komend i kodowanie konsoli, można znaleźć w sekcji o identycznej nazwie na mkvmerge(1) stronie podręcznika.
5. Kody zakończenia#
mkvpropedit(1) kończy działanie z jednym z trzech kodów wyjścia:
-
0 -- Ten kod zakończenia oznacza, że praca została zakończona powodzeniem.
-
1 -- W tym przypadku mkvinfo(1) wyświetlił co najmniej jedno ostrzeżenie, ale działanie było kontynuowane. Ostrzeżenie jest poprzedzone tekstem „Warning:”.
-
2 – Ten kod wyjścia jest używany po wystąpieniu błędu. mkvpropedit(1) przerywa działanie zaraz po wyświetleniu komunikatu o błędzie. Komunikaty o błędach obejmują błędne argumenty wiersza poleceń, błędy odczytu/zapisu, a nawet uszkodzone pliki.
6. Zmienne środowiskowe#
mkvpropedit(1) używa domyślnych zmiennych, które określają ustawienia regionalne systemu (np. LANG i rodzina LC_*). Dodatkowe zmienne:
| Option | Description |
|---|---|
| MKVINFO_DEBUG, MKVTOOLNIX_DEBUG i jego skrócona forma MTX_DEBUG# |
Zawartość jest traktowana tak, jakby została przekazana za pomocą opcji --debug. |
| MKVINFO_ENGAGE, MKVTOOLNIX_ENGAGE i jego skrócona forma MTX_ENGAGE# |
Zawartość jest traktowana tak, jakby została przekazana za pomocą opcji --engage. |
7. Zobacz także#
mkvmerge(1), mkvextract(1), mkvpropedit(1), mkvtoolnix-gui(1)
8. Strona www#
Najnowsza wersja jest zawsze dostępna pod adresem domowym MKVToolNix.