'\" t
.\"     Title: mkvmerge
.\"    Author: Moritz Bunkus <moritz@bunkus.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2026-09-14
.\"    Manual: Uživatelské příkazy
.\"    Source: MKVToolNix 102.0
.\"  Language: English
.\"
.TH "MKVMERGE" "1" "2026\-09\-14" "MKVToolNix 102\&.0" "Uživatelské příkazy"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
mkvmerge \- Spojit multimediální proudy do souboru Matroska(TM)
.SH "PřEHLED"
.HP \w'\fBmkvmerge\fR\ 'u
\fBmkvmerge\fR [global\ options] {\-o\ out} [options1] {file1} [[options2]\ {file2}] [@options\-file\&.json]
.SH "POPIS"
.PP
Tento program načte vstup z několika mediálních souborů a spojí jejich proudy (všechny nebo pouze výběr) do souboru
Matroska(TM); viz
\m[blue]\fBweb Matroska(TM)\fR\m[]\&\s-2\u[1]\d\s+2\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBImportant\fR
.ps -1
.br
.PP
Pořadí voleb příkazového řádku je důležité\&. Pokud program používáte poprvé, přečtěte si oddíl
"Pořadí voleb"\&.
.sp .5v
.RE
.SS "Globální volby"
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
Zvýšit podrobnost\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
Potlačit stav výstupu\&.
.RE
.PP
\fB\-o\fR, \fB\-\-output\fR \fIfile\-name\fR
.RS 4
Zapíše do souboru
\fIfile\-name\fR\&. Použije\-li se rozdělení, s tímto parametrem se zachází trochu jinak\&. Podrobnosti viz vysvětlení volby
\fB\-\-split\fR\&.
.RE
.PP
\fB\-w\fR, \fB\-\-webm\fR
.RS 4
Vytvoří soubor odpovídající WebM\&. Režim se rovněž zapne, pokud přípona názvu výstupního souboru je "webm"\&. Tento režim vynucuje několik omezení\&. Jedinými povolenými kodeky jsou video VP8 a VP9 a zvukové stopy Opus a Vorbis\&. Položka hlavičky DocType se změní na "webm"\&.
.sp
Pro kapitoly a štítky je povolena pouze podmnožina prvků\&.
\fBmkvmerge\fR(1)
automaticky odstraní všechny prvky, které specifikace nepovoluje\&.
.RE
.PP
\fB\-\-title\fR \fItitle\fR
.RS 4
Nastavuje obecný název výstupního souboru, například název filmu\&.
.RE
.PP
\fB\-\-default\-language\fR \fIlanguage\-code\fR
.RS 4
Nastavuje výchozí jazykový kód použitý pro stopy, pro něž není jazyk nastaven volbou
\fB\-\-language\fR
a pro něž zdrojový kontejner neposkytuje jazyk\&.
.sp
Výchozí jazykový kód je pro \(Bqneurčeno\(lq
und\&.
.RE
.SS "Zpracování informací o úseku (globální volby)"
.PP
\fB\-\-segmentinfo\fR \fIfilename\&.xml\fR
.RS 4
Načte informace o úseku ze souboru
XML\&. Tento soubor může obsahovat prvky
UID
rodiny úseků,
UID
úseku,
UID
předchozího a následujícího úseku\&. Ukázkový soubor a
DTD
jsou součástí distribuce MKVToolNix\&.
.sp
Podrobnosti viz níže v oddílu
soubory XML s informacemi o úseku\&.
.RE
.PP
\fB\-\-segment\-uid\fR \fISID1,SID2,\&.\&.\&.\fR
.RS 4
Nastavuje UID úseků, která se mají použít\&. Jde o čárkami oddělený seznam 128bitových UID úseků v obvyklé podobě UID: šestnáctkové číslice s předponou "0x" nebo bez ní, s mezerami nebo bez nich, přesně 32 číslic\&.
.sp
Začíná\-li SID znakem =, zbytek se interpretuje jako název souboru Matroska, jehož UID úseku se načte a použije\&.
.sp
Každý vytvořený soubor obsahuje jeden úsek a každý úsek má jedno UID úseku\&. Je\-li zadáno více UID úseků než vytvořených úseků, přebytečná UID se ignorují\&. Je\-li zadáno méně UID než vytvořených úseků, vytvoří se pro ně náhodná UID\&.
.RE
.SS "Zpracování kapitol a štítků (globální volby)"
.PP
\fB\-\-chapter\-language\fR \fIlanguage\-code\fR
.RS 4
Nastavuje jazykový kód ISO 639\-2 zapisovaný pro každou položku kapitoly\&. Výchozí je
eng\&. Podrobnosti viz níže v oddílu
kapitoly\&.
.sp
Tuto volbu lze použít jak pro jednoduché soubory kapitol, tak pro zdrojové soubory obsahující kapitoly, ale žádné informace o jazyku kapitol, například soubory MP4 a OGM\&.
.sp
Jazyk nastavený touto volbou se použije také při vytváření kapitol volbou
\fB\-\-generate\-chapters\fR\&.
.RE
.PP
\fB\-\-chapter\-charset\fR \fIcharacter\-set\fR
.RS 4
Nastavuje znakovou sadu použitou pro převod jednoduchých souborů kapitol do UTF\-8\&. Vysvětlení převodů mezi znakovými sadami programem
\fBmkvmerge\fR(1)
naleznete v oddílu
textové soubory a znakové sady\&.
.sp
Tato volba platí také pro kapitoly kopírované z určitých typů kontejnerů, například souborů Ogg/OGM a MP4\&. Podrobnosti viz níže v oddílu o kapitolách\&.
.RE
.PP
\fB\-\-chapter\-sync\fR \fId\fR\fI[,o[/p]]\fR
.RS 4
Upraví časová razítka kapitol v následujícím zdrojovém souboru o
\fId\fR
ms\&. Alternativně lze použít volbu
\fB\-\-sync\fR
se zvláštním ID stopy
\fB\-2\fR
(viz oddíl
zvláštní ID stop)\&.
.sp
\fIo\fR/\fIp\fR: upraví časová razítka o
\fIo\fR/\fIp\fR, aby opravil lineární posuny\&. Není\-li
\fIp\fR
uvedeno, výchozí je 1\&. Hodnoty
\fIo\fR
i
\fIp\fR
mohou být čísla s pohyblivou řádovou čárkou\&.
.sp
Výchozí: žádná ruční oprava synchronizace (což je stejné jako
\fId\fR
=
\fB0\fR
a
\fIo\fR/\fIp\fR
=
\fB1\&.0\fR)\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-generate\-chapters\fR \fImode\fR
.RS 4
\fBmkvmerge\fR(1)
může vytvářet kapitoly automaticky\&. V současnosti jsou podporovány následující dva režimy:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\*(Aqwhen\-appending\*(Aq \(en Tento režim vytvoří jednu kapitolu na začátku a jednu kapitolu pokaždé, když je připojen soubor\&.
.sp
Tento režim funguje také s režimy rozdělení \*(Aqparts:\*(Aq a \*(Aqparts\-frames:\*(Aq\&. V těchto režimech se vytvoří jedna kapitola pro každý připojený rozsah časových razítek (ty, jejichž počáteční časové razítko má předponu \*(Aq+\*(Aq)\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
\fBmkvmerge\fR(1)
vyžaduje přítomnost video nebo zvukové stopy, aby mohl určit, kdy je připojen nový soubor\&. Jsou\-li multiplexovány jedna nebo více video stop, použije se první z nich\&. Jinak se použije první zvuková stopa\&.
.sp .5v
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\*(Aqinterval:\fItime\-spec\fR\*(Aq \(en Tento režim vytváří jednu kapitolu v pevných intervalech určených
\fItime\-spec\fR\&. Formát je buď
\fIHH:MM:SS\&.nnnnnnnnn\fR, nebo číslo následované jednou z jednotek \*(Aqs\*(Aq, \*(Aqms\*(Aq či \*(Aqus\*(Aq\&.
.sp
Příklad:
\-\-generate\-chapters interval:45s
.RE
.sp
Názvy nových kapitol řídí volba
\-\-generate\-chapters\-name\-template\&. Jazyk nastavuje volba
\-\-chapter\-language, která musí být uvedena před
\fB\-\-generate\-chapters\fR\&.
.RE
.PP
\fB\-\-generate\-chapters\-name\-template\fR \fItemplate\fR
.RS 4
Nastavuje šablonu názvů kapitol vytvářených volbou
\-\-generate\-chapters\&. Není\-li volba použita, použije se výchozí \*(AqChapter <NUM:2>\*(Aq\&.
.sp
V šabloně lze použít několik proměnných, které se při vytvoření kapitoly nahradí skutečnými hodnotami\&. Řetězec \*(Aq<NUM>\*(Aq se nahradí číslem kapitoly\&. Řetězec \*(Aq<START>\*(Aq se nahradí počátečním časovým razítkem kapitoly\&.
.sp
Řetězce
\*(Aq<FILE_NAME>\*(Aq
a
\*(Aq<FILE_NAME_WITH_EXT>\*(Aq
se vyplní pouze při vytváření kapitol pro připojené soubory\&. Nahradí se názvem připojeného souboru bez přípony, resp\&. s příponou\&. Vkládá se pouze základní název a přípona souboru, nikoli součásti adresáře nebo jednotky\&.
.sp
Minimální počet míst pro číslo kapitoly můžete určit pomocí \*(Aq<NUM:places>\*(Aq, například \*(Aq<NUM:3>\*(Aq\&. Má\-li číslo méně míst než je zadáno, doplní se počátečními nulami\&.
.sp
Formát počátečního časového razítka lze řídit pomocí
<START:format>\&. Není\-li formát zadán, výchozí je \*(Aq%H:%M:%S\*(Aq\&. Platné kódy formátu jsou:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
%h
\(en hodiny
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
%H
\(en hodiny doplněné počátečními nulami na dvě místa
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
%m
\(en minuty
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
%M
\(en minuty doplněné počátečními nulami na dvě místa
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
%s
\(en sekundy
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
%S
\(en sekundy doplněné počátečními nulami na dvě místa
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
%n
\(en nanosekundy s devíti místy
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
%<1\-9>n
\(en nanosekundy až s devíti místy (např\&. tři místa pomocí
%3n)
.RE
.sp
Řetězec \*(Aq<TITLE>\*(Aq se vyplní pouze při vytváření kapitol pro připojené soubory\&. Je\-li k dispozici, nahradí se názvem připojeného souboru\&.
.RE
.PP
\fB\-\-cue\-chapter\-name\-format\fR \fIformat\fR
.RS 4
\fBmkvmerge\fR(1)
podporuje načítání
CUE
sheetů zvukových souborů a jejich použití jako podkladu pro kapitoly\&.
CUE
sheety obvykle obsahují u každé položky indexu údaje
\fIPERFORMER\fR
a
\fITITLE\fR\&.
\fBmkvmerge\fR(1)
používá tyto dva řetězce k sestavení názvu kapitoly\&. Touto volbou lze nastavit formát použitý pro tento název\&.
.sp
Není\-li tato volba zadána,
\fBmkvmerge\fR(1)
používá výchozí formát \*(Aq%p \- %t\*(Aq (interpret, za ním mezera, pomlčka, další mezera a název)\&.
.sp
Je\-li formát zadán, vše kromě následujících metaznaků se zkopíruje beze změny a metaznaky se nahradí takto:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI%p\fR
se nahradí řetězcem
\fIPERFORMER\fR
aktuální položky,
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI%t\fR
se nahradí řetězcem
\fITITLE\fR
aktuální položky,
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI%n\fR
se nahradí aktuálním číslem stopy a
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI%N\fR
se nahradí aktuálním číslem stopy doplněným zleva nulou, je\-li < 10\&.
.RE
.RE
.PP
\fB\-\-chapters\fR \fIfile\-name\fR
.RS 4
Načte informace o kapitolách ze souboru
\fIfile\-name\fR\&. Podrobnosti viz níže v oddílu o
kapitolách\&.
.RE
.PP
\fB\-\-global\-tags\fR \fIfile\-name\fR
.RS 4
Načte globální štítky ze souboru
\fIfile\-name\fR\&. Podrobnosti viz níže v oddílu o
štítcích\&.
.RE
.SS "Obecné řízení výstupu (pokročilé globální volby)"
.PP
\fB\-\-track\-order\fR \fIFID1:TID1,FID2:TID2,\&.\&.\&.\fR
.RS 4
Tato volba mění pořadí, v němž se vytvářejí stopy vstupního souboru\&. Argumentem je seznam dvojic ID oddělených čárkami\&. Každá dvojice obsahuje nejprve ID souboru (\fIFID1\fR), což je jednoduše číslo souboru na příkazovém řádku počínaje 0\&. Druhým údajem je ID stopy (\fITID1\fR) z daného souboru\&. Jsou\-li některá ID stop vynechána, příslušné stopy se vytvoří až po stopách uvedených touto volbou\&.
.sp
Není\-li tato volba zadána, stopy se seřadí nejprve podle typu & poté podle pořadí jejich zdrojových souborů\&. Nejdříve budou video stopy, po nich zvukové & titulkové stopy\&. Ostatní zřídka používané typy stop budou zařazeny nakonec\&.
.RE
.PP
\fB\-\-cluster\-length\fR \fIspec\fR
.RS 4
Omezí počet datových bloků nebo délku dat v každém clusteru\&. Parametr
\fIspec\fR
může být buď číslo
\fIn\fR
bez jednotky, nebo číslo
\fId\fR
s příponou \*(Aqms\*(Aq\&.
.sp
Není\-li použita jednotka,
\fBmkvmerge\fR(1)
vloží do každého clusteru nejvýše
\fIn\fR
datových bloků\&. Maximální počet bloků je 65535\&.
.sp
Je\-li číslo
\fId\fR
zakončeno příponou \*(Aqms\*(Aq,
\fBmkvmerge\fR(1)
vloží do každého clusteru nejvýše
\fId\fR
milisekund dat\&. Minimální hodnota parametru
\fId\fR
je \*(Aq100ms\*(Aq a maximální \*(Aq32000ms\*(Aq\&.
.sp
\fBmkvmerge\fR(1)
ve výchozím nastavení vkládá do clusteru nejvýše 65535 datových bloků a 5000ms dat\&.
.sp
Programy hledající určitý snímek se mohou přesunout přímo pouze na cluster a poté musí přečíst celý cluster\&. Vytváření větších clusterů proto může vést k nepřesnému nebo pomalému vyhledávání\&.
.RE
.PP
\fB\-\-clusters\-in\-meta\-seek\fR
.RS 4
Určuje programu
\fBmkvmerge\fR(1), aby na konci souboru vytvořil prvek hlavičky vyhledávání obsahující všechny clustery\&. Viz také oddíl o
uspořádání souboru Matroska(TM)\&.
.RE
.PP
\fB\-\-timestamp\-scale\fR \fIfactor\fR
.RS 4
Vynutí nastavení faktoru měřítka časových razítek na hodnotu
\fIfactor\fR\&. Platné hodnoty jsou v rozsahu
\fB1000\fR\&.\&.\fB10000000\fR
nebo zvláštní hodnota
\fB\-1\fR\&.
.sp
\fBmkvmerge\fR(1)
běžně používá hodnotu
\fB1000000\fR, což znamená, že časová razítka a délky mají přesnost 1 ms\&. U souborů bez video stopy, avšak alespoň s jednou zvukovou stopou,
\fBmkvmerge\fR(1)
automaticky zvolí faktor měřítka časových razítek tak, aby všechna časová razítka a délky měla přesnost jednoho zvukového vzorku\&. Zvyšuje to režii, ale umožňuje přesné vyhledávání a extrakci\&.
.sp
Použije\-li se zvláštní hodnota
\fB\-1\fR,
\fBmkvmerge\fR(1)
použije přesnost na jeden vzorek i v případě, že je přítomna video stopa\&.
.RE
.PP
\fB\-\-enable\-durations\fR
.RS 4
Zapíše délky všech bloků\&. Tím se zvětší velikost souboru a v současnosti to přehrávačům nepřináší žádnou další výhodu\&.
.RE
.PP
\fB\-\-no\-cues\fR
.RS 4
Určuje programu
\fBmkvmerge\fR(1), aby nevytvářel ani nezapisoval data indexu, která lze přirovnat k indexu v souboru AVI\&. Soubory
Matroska(TM)
lze přehrávat i bez dat indexu, vyhledávání však bude pravděpodobně nepřesné a pomalejší\&. Tuto volbu použijte pouze tehdy, pokud nutně potřebujete ušetřit místo, nebo k testování\&. Viz také volba
\fB\-\-cues\fR, kterou lze zadat pro každý vstupní soubor\&.
.RE
.PP
\fB\-\-no\-date\fR
.RS 4
Ve výchozím nastavení
\fBmkvmerge\fR(1)
nastavuje pole "date" v informacích o úseku na čas & datum zahájení multiplexování\&. Při použití této volby se pole vůbec nezapíše\&.
.RE
.PP
\fB\-\-date\fR \fItimestamp\fR
.RS 4
Nastaví pole
DateUTC
zapisované do informací o úseku\&. Časové razítko musí mít formát podobný ISO 8601:
YYYY\-mm\-ddTHH:MM:SSZ
pro UTC nebo s posunem
\(+-HH:MM
(místo
T
lze použít také mezeru), např\&.
2017\-03\-28T17:28:00Z
nebo
2017\-03\-28 17:28:00+02:00\&. Použije\-li se spolu s
\fB\-\-no\-date\fR, má
\fB\-\-no\-date\fR
přednost a žádné datum se nezapíše\&.
.RE
.PP
\fB\-\-disable\-lacing\fR
.RS 4
Zakáže svazování pro všechny stopy\&. Tím se zvětší velikost souboru, zejména pokud obsahuje mnoho zvukových stop\&. Tato volba není určena pro běžné použití\&.
.RE
.PP
\fB\-\-disable\-track\-statistics\-tags\fR
.RS 4
\fBmkvmerge\fR(1)
běžně zapisuje určité štítky se statistikami pro každou stopu\&. Pokud takové štítky již existují, budou přepsány\&. Jde o štítky
\fBBPS\fR,
\fBDURATION\fR,
\fBNUMBER_OF_BYTES\fR
a
\fBNUMBER_OF_FRAMES\fR\&.
.sp
Zapnutí této volby zabrání programu
\fBmkvmerge\fR(1)
zapisovat tyto štítky a měnit existující štítky se stejnými názvy\&.
.RE
.PP
\fB\-\-disable\-language\-ietf\fR
.RS 4
\fBmkvmerge\fR(1)
běžně zapisuje nové jazykové prvky IETF BCP 47 vedle zastaralých jazykových prvků v hlavičkách stop, kapitolách a štítcích\&. Při použití této volby se zapisují pouze zastaralé prvky\&.
.RE
.PP
\fB\-\-normalize\-language\-ietf\fR \fImode\fR
.RS 4
Povolí normalizaci všech jazykových značek IETF BCP 47 buď na jejich kanonickou podobu v režimu \*(Aqcanonical\*(Aq, na podobu rozšířených jazykových podznaček v režimu \*(Aqextlang\*(Aq, nebo ji vypne režimem \*(Aqoff\*(Aq\&. Ve výchozím nastavení se používá normalizace na kanonickou podobu\&.
.sp
V kanonické podobě se všechny podznačky, pro něž existují upřednostňované hodnoty, nahradí těmito hodnotami\&. Tím se např\&. \*(Aqzh\-yue\-jyutping\*(Aq převede na \*(Aqyue\-jyutping\*(Aq nebo \*(Aqfr\-FX\*(Aq na \*(Aqfr\-FR\*(Aq\&.
.sp
Pro podobu rozšířených jazykových podznaček se nejprve vytvoří kanonická podoba\&. Poté se všechny primární jazykové podznačky, pro něž existuje rozšířená jazyková podznačka, nahradí touto rozšířenou jazykovou podznačkou a její předponou\&. Tím se např\&. \*(Aqyue\-jyutping\*(Aq převede zpět na \*(Aqzh\-yue\-jyutping\*(Aq, na \*(Aqfr\-FR\*(Aq to však nemá vliv, protože \*(Aqfr\*(Aq není rozšířená jazyková podznačka\&.
.RE
.PP
\fB\-\-stop\-after\-video\-ends\fR
.RS 4
Po skončení primární video stopy zastaví zpracování a zahodí všechny zbývající pakety ostatních stop\&.
.RE
.SS "Rozdělení souborů, propojování, připojování a zřetězování (další globální volby)"
.PP
\fB\-\-split\fR \fIspecification\fR
.RS 4
Rozdělí výstupní soubor po dosažení zadané velikosti nebo po uplynutí zadané doby\&. Upozorňujeme, že stopy lze rozdělovat pouze bezprostředně před klíčovým snímkem\&. Bod rozdělení se proto může od zadání uživatele mírně lišit\&.
.sp
V současnosti
\fBmkvmerge\fR(1)
podporuje následující režimy:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Rozdělení podle velikosti\&.
.sp
Syntaxe:
\fB\-\-split\fR
[size:]\fId\fR[k|m|g]
.sp
Příklady:
\-\-split size:700m
nebo
\-\-split 150000000
.sp
Parametr
\fId\fR
může končit písmenem \*(Aqk\*(Aq, \*(Aqm\*(Aq nebo \*(Aqg\*(Aq, čímž se určí velikost v KB, MB, respektive GB\&. Jinak se předpokládá velikost v bajtech\&. Jakmile aktuální výstupní soubor dosáhne tohoto limitu velikosti, začne se vytvářet nový výstupní soubor\&.
.sp
Předponu \*(Aqsize:\*(Aq lze z důvodů kompatibility vynechat\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Rozdělení po uplynutí doby\&.
.sp
Syntaxe:
\fB\-\-split\fR
[duration:]\fIHH:MM:SS\&.nnnnnnnnn\fR|\fId\fRs
.sp
Příklady:
\-\-split duration:00:60:00\&.000
nebo
\-\-split 3600s
.sp
Parametr musí mít buď tvar
\fIHH:MM:SS\&.nnnnnnnnn\fR
pro zadání trvání s přesností až na nanosekundy, nebo musí jít o číslo
\fId\fR
následované písmenem \*(Aqs\*(Aq pro trvání v sekundách\&.
\fIHH\fR
je počet hodin,
\fIMM\fR
počet minut,
\fISS\fR
počet sekund a
\fInnnnnnnnn\fR
počet nanosekund\&. Počet hodin i počet nanosekund lze vynechat\&. Za desetinnou tečkou může být až devět číslic\&. Jakmile trvání obsahu aktuálního výstupního souboru dosáhne tohoto limitu, začne se vytvářet nový výstupní soubor\&.
.sp
Předponu \*(Aqduration:\*(Aq lze z důvodů kompatibility vynechat\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
Rozdělení za konkrétními časovými razítky\&.
.sp
Syntaxe:
\fB\-\-split\fR
timestamps:\fIA\fR[,\fIB\fR[,\fIC\fR\&.\&.\&.]]
.sp
Příklad:
\-\-split timestamps:00:45:00\&.000,01:20:00\&.250,6300s
.sp
Parametry
\fIA\fR,
\fIB\fR,
\fIC\fR
atd\&. musí mít stejný formát jako hodnoty délky (viz výše)\&. Seznam časových razítek je oddělen čárkami\&. Jakmile vstupní proud dosáhne časového razítka aktuálního bodu rozdělení, vytvoří se nový soubor\&. Poté se použije další bod rozdělení uvedený v seznamu\&.
.sp
Předpona \*(Aqtimestamps:\*(Aq se nesmí vynechat\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
Zachování určitých částí určením rozsahů časových razítek při vyřazení ostatních\&.
.sp
Syntaxe:
\fB\-\-split\fR
parts:\fIstart1\fR\-\fIend1\fR[,[+]\fIstart2\fR\-\fIend2\fR[,[+]\fIstart3\fR\-\fIend3\fR\&.\&.\&.]]
.sp
Příklady:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
\-\-split parts:00:01:20\-00:02:45,00:05:50\-00:10:30
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
\-\-split parts:00:01:20\-00:02:45,+00:05:50\-00:10:30
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
\-\-split parts:\-00:02:45,00:05:50\-
.RE
.sp
Režim
parts
určuje programu
\fBmkvmerge\fR(1), aby zachoval určité rozsahy časových razítek a ostatní zahodil\&. Zachovávané rozsahy musí být uvedeny za klíčovým slovem
parts:
a odděleny čárkami\&. Každý rozsah se skládá z počátečního a koncového časového razítka ve stejném formátu, jaký přijímají ostatní varianty
\fI\-\-split\fR
(např\&.
00:01:20
a
80s
označují stejné časové razítko)\&.
.sp
Je\-li počáteční časové razítko vynecháno, použije se ve výchozím nastavení koncové časové razítko předchozího rozsahu\&. Nebyl\-li předchozí rozsah, použije se začátek souboru (viz příklad 3)\&.
.sp
Je\-li koncové časové razítko vynecháno, použije se ve výchozím nastavení konec zdrojových souborů, čímž se programu
\fBmkvmerge\fR(1)
v podstatě určí, aby zachoval zbytek (viz příklad 3)\&.
.sp
Každý rozsah se běžně zapíše do nového souboru\&. To lze změnit tak, aby se po sobě jdoucí rozsahy zapisovaly do stejného souboru\&. Uživatel proto musí před počáteční časové razítko vložit
+\&. Touto předponou se programu
\fBmkvmerge\fR(1)
určí, aby nevytvářel nový soubor, ale připojil rozsah ke stejnému souboru, do něhož byl zapsán předchozí rozsah\&. Časová razítka se upraví tak, aby ve výstupním souboru nebyla mezera, i když mezi oběma rozsahy ve vstupním souboru mezera byla\&.
.sp
V příkladu 1
\fBmkvmerge\fR(1)
vytvoří dva soubory\&. První bude obsahovat část obsahu od
00:01:20
do
00:02:45\&. Druhý soubor bude obsahovat část obsahu od
00:05:50
do
00:10:30\&.
.sp
V příkladu 2
\fBmkvmerge\fR(1)
vytvoří pouze jeden soubor\&. Tento soubor bude obsahovat části obsahu od
00:01:20
do
00:02:45
a od
00:05:50
do
00:10:30\&.
.sp
V příkladu 3
\fBmkvmerge\fR(1)
vytvoří dva soubory\&. První bude obsahovat část obsahu od začátku zdrojových souborů do
00:02:45\&. Druhý soubor bude obsahovat část obsahu od
00:05:50
do konce zdrojových souborů\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
Upozorňujeme, že
\fBmkvmerge\fR(1)
rozhoduje o rozdělení pouze na pozicích klíčových snímků\&. To platí pro začátek i konec každého rozsahu\&. I když tedy koncové časové razítko leží mezi dvěma klíčovými snímky,
\fBmkvmerge\fR(1)
bude nadále zapisovat snímky až po následující klíčový snímek, ten však už nezahrne\&.
.sp .5v
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
Zachování určitých částí zadáním rozsahů čísel snímků/půlsnímků a vyřazení ostatních\&.
.sp
Syntaxe:
\fB\-\-split\fR
parts\-frames:\fIstart1\fR\-\fIend1\fR[,[+]\fIstart2\fR\-\fIend2\fR[,[+]\fIstart3\fR\-\fIend3\fR\&.\&.\&.]]
.sp
Příklady:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
\-\-split parts\-frames:137\-258,548\-1211
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
\-\-split parts\-frames:733\-912,+1592\-2730
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
\-\-split parts\-frames:\-430,2512\-
.RE
.sp
Režim
parts\-frames
určuje programu
\fBmkvmerge\fR(1), aby zachoval určité rozsahy čísel snímků/půlsnímků a ostatní zahodil\&. Zachovávané rozsahy musí být uvedeny za klíčovým slovem
parts\-frames:
a odděleny čárkami\&. Každý rozsah se skládá z počátečního a koncového čísla snímku/půlsnímku\&. Číslování začíná od 1\&.
.sp
Je\-li počáteční číslo vynecháno, použije se ve výchozím nastavení koncové číslo předchozího rozsahu\&. Nebyl\-li předchozí rozsah, použije se začátek souboru (viz příklad 3)\&.
.sp
Je\-li koncové číslo vynecháno, použije se ve výchozím nastavení konec zdrojových souborů, čímž se programu
\fBmkvmerge\fR(1)
v podstatě určí, aby zachoval zbytek (viz příklad 3)\&.
.sp
Každý rozsah se běžně zapíše do nového souboru\&. To lze změnit tak, aby se po sobě jdoucí rozsahy zapisovaly do stejného souboru\&. Uživatel proto musí před počáteční číslo vložit
+\&. Touto předponou se programu
\fBmkvmerge\fR(1)
určí, aby nevytvářel nový soubor, ale připojil rozsah ke stejnému souboru, do něhož byl zapsán předchozí rozsah\&. Časová razítka se upraví tak, aby ve výstupním souboru nebyla mezera, i když mezi oběma rozsahy ve vstupním souboru mezera byla\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
Upozorňujeme, že
\fBmkvmerge\fR(1)
rozhoduje o rozdělení pouze na pozicích klíčových snímků\&. To platí pro začátek i konec každého rozsahu\&. I když tedy koncové číslo snímku/půlsnímku leží mezi dvěma klíčovými snímky,
\fBmkvmerge\fR(1)
bude nadále zapisovat snímky až po následující klíčový snímek, ten však už nezahrne\&.
.sp .5v
.RE
V příkladu 1
\fBmkvmerge\fR(1)
vytvoří dva soubory\&. První bude obsahovat část obsahu počínaje prvním klíčovým snímkem s číslem
137
nebo vyšším a konče těsně před prvním klíčovým snímkem s číslem
258
nebo vyšším\&. Druhý soubor bude obsahovat část obsahu od
548
do
1211\&.
.sp
V příkladu 2
\fBmkvmerge\fR(1)
vytvoří pouze jeden soubor\&. Tento soubor bude obsahovat části obsahu od
733
do
912
a od
1592
do
2730\&.
.sp
V příkladu 3
\fBmkvmerge\fR(1)
vytvoří dva soubory\&. První bude obsahovat část obsahu od začátku zdrojových souborů do
430\&. Druhý soubor bude obsahovat část obsahu od
2512
do konce zdrojových souborů\&.
.sp
Tento režim zohledňuje pouze první výstupní video stopu\&. Není\-li výstupní žádná video stopa, nedojde k rozdělení\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
Čísla zadaná pomocí tohoto argumentu se interpretují podle počtu výstupních bloků
Matroska(TM)\&. Jeden blok
Matroska(TM)
obsahuje buď celý snímek (u progresivního obsahu), nebo jedno pole (u prokládaného obsahu)\&. mkvmerge mezi nimi nerozlišuje a jednoduše počítá bloky\&. Příklad: chcete\-li prokládaný obsah rozdělit po 25\&. celém snímku, je nutné jako bod rozdělení použít
50
(dvě pole na celý snímek)\&.
.sp .5v
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
Rozdělení za konkrétními snímky/půlsnímky\&.
.sp
Syntaxe:
\fB\-\-split\fR
frames:\fIA\fR[,\fIB\fR[,\fIC\fR\&.\&.\&.]]
.sp
Příklad:
\-\-split frames:120,237,891
.sp
Parametry
\fIA\fR,
\fIB\fR,
\fIC\fR
atd\&. musí být kladná celá čísla\&. Číslování začíná od 1\&. Seznam čísel snímků/půlsnímků je oddělen čárkami\&. Jakmile vstupní proud dosáhne čísla snímku/pole aktuálního bodu rozdělení, vytvoří se nový soubor\&. Poté se použije další bod rozdělení uvedený v seznamu\&.
.sp
Předpona \*(Aqframes:\*(Aq se nesmí vynechat\&.
.sp
Tento režim zohledňuje pouze první výstupní video stopu\&. Není\-li výstupní žádná video stopa, nedojde k rozdělení\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
Čísla zadaná pomocí tohoto argumentu se interpretují podle počtu výstupních bloků
Matroska(TM)\&. Jeden blok
Matroska(TM)
obsahuje buď celý snímek (u progresivního obsahu), nebo jedno pole (u prokládaného obsahu)\&. mkvmerge mezi nimi nerozlišuje a jednoduše počítá bloky\&. Příklad: chcete\-li prokládaný obsah rozdělit po 25\&. celém snímku, je nutné jako bod rozdělení použít
50
(dvě pole na celý snímek)\&.
.sp .5v
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  7." 4.2
.\}
Rozdělení před konkrétními kapitolami\&.
.sp
Syntaxe:
\fB\-\-split\fR
chapters:all
nebo
\fB\-\-split\fR
chapters:\fIA\fR[,\fIB\fR[,\fIC\fR\&.\&.\&.]]
.sp
Příklad:
\-\-split chapters:5,8
.sp
Parametry
\fIA\fR,
\fIB\fR,
\fIC\fR
atd\&. musí být kladná celá čísla\&. Číslování začíná od 1\&. Seznam čísel kapitol je oddělen čárkami\&. K rozdělení dojde těsně před prvním klíčovým snímkem, jehož časové razítko je stejné nebo vyšší než počáteční časové razítko kapitol s uvedenými čísly\&. Kapitola začínající v čase 0s se při rozdělení nikdy nezohlední a bez upozornění se zahodí\&.
.sp
Klíčové slovo
all
lze použít místo ručního výpisu všech čísel kapitol\&.
.sp
Předpona \*(Aqchapters:\*(Aq se nesmí vynechat\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
Formát souborů
Matroska(TM)
podporuje libovolně hluboce vnořené struktury kapitol nazývané \*(Aqpoložky edice\*(Aq a \*(Aqatomy kapitol\*(Aq\&. Tento režim však zohledňuje jen nejvyšší úroveň kapitol ve všech položkách edice\&.
.sp .5v
.RE
.RE
.sp
V tomto režimu rozdělení se s názvem výstupního souboru zachází jinak než při běžném zpracování\&. Může obsahovat výraz ve stylu
\fBprintf\fR
\*(Aq%d\*(Aq včetně volitelné šířky pole, např\&. \*(Aq%02d\*(Aq\&. Pokud jej obsahuje, aktuální číslo souboru se odpovídajícím způsobem naformátuje a vloží na dané místo názvu souboru\&. Není\-li takový vzor přítomen, před příponou souboru se předpokládá vzor \*(Aq\-%03d\*(Aq: \*(Aq\-o output\&.mkv\*(Aq vytvoří \*(Aqoutput\-001\&.mkv\*(Aq atd\&. Nemá\-li název příponu, \*(Aq\-%03d\*(Aq se připojí k názvu\&.
.sp
Dalším možným vzorem je \*(Aq%c\*(Aq, který se nahradí názvem první kapitoly v souboru\&. Je\-li přítomen \*(Aq%c\*(Aq, vzor \*(Aq\-%03d\*(Aq se nepřidá automaticky\&.
.RE
.PP
\fB\-\-link\fR
.RS 4
Při rozdělení výstupního souboru vzájemně propojí soubory\&. Podrobnosti viz níže v oddílu o
propojování souborů\&.
.RE
.PP
\fB\-\-link\-to\-previous\fR \fIsegment\-UID\fR
.RS 4
Propojí první výstupní soubor s úsekem, jehož UID je zadáno parametrem
\fIsegment\-UID\fR\&. Podrobnosti viz níže v oddílu o
propojování souborů\&.
.sp
Začíná\-li SID znakem =, zbytek se interpretuje jako název souboru Matroska, jehož UID úseku se načte a použije\&.
.RE
.PP
\fB\-\-link\-to\-next\fR \fIsegment\-UID\fR
.RS 4
Propojí poslední výstupní soubor s úsekem, jehož UID je zadáno parametrem
\fIsegment\-UID\fR\&. Podrobnosti viz níže v oddílu o
propojování souborů\&.
.sp
Začíná\-li SID znakem =, zbytek se interpretuje jako název souboru Matroska, jehož UID úseku se načte a použije\&.
.RE
.PP
\fB\-\-append\-mode\fR \fImode\fR
.RS 4
Určuje způsob výpočtu časových razítek při připojování souborů\&. Parametr
\fImode\fR
může mít dvě hodnoty: \*(Aqfile\*(Aq, která je také výchozí, a \*(Aqtrack\*(Aq\&.
.sp
Když mkvmerge připojí stopu (dále \*(Aqtrack2_1\*(Aq) z druhého souboru (dále \*(Aqfile2\*(Aq) ke stopě (dále \*(Aqtrack1_1\*(Aq) z prvního souboru (dále \*(Aqfile1\*(Aq), musí všechna časová razítka stopy \*(Aqtrack2_1\*(Aq posunout o určitou hodnotu\&. V režimu \*(Aqfile\*(Aq je touto hodnotou nejvyšší časové razítko nalezené v \*(Aqfile1\*(Aq, i když pocházelo z jiné stopy než \*(Aqtrack1_1\*(Aq\&. V režimu \*(Aqtrack\*(Aq se jako posun použije nejvyšší časové razítko stopy \*(Aqtrack1_1\*(Aq\&.
.sp
mkvmerge bohužel nedokáže spolehlivě zjistit, který režim použít\&. Proto je výchozí režim \*(Aqfile\*(Aq\&. Režim \*(Aqfile\*(Aq obvykle funguje lépe pro soubory vytvořené nezávisle na sobě, např\&. při připojování souborů
AVI
nebo
MP4\&. Režim \*(Aqtrack\*(Aq může fungovat lépe pro zdroje, které jsou v podstatě pouze částmi jednoho velkého souboru, např\&. pro soubory
VOB
a
EVO\&.
.sp
S titulkovými stopami se vždy zachází, jako by byl aktivní režim \*(Aqfile\*(Aq, i když je ve skutečnosti aktivní režim \*(Aqtrack\*(Aq\&.
.RE
.PP
\fB\-\-append\-to\fR \fISFID1:STID1:DFID1:DTID1\fR\fI[,\&.\&.\&.]\fR
.RS 4
Tato volba určuje, ke které stopě se připojí jiná stopa\&. Každá specifikace obsahuje čtyři ID: ID souboru, ID stopy, ID druhého souboru a ID druhé stopy\&. První dvojice, \(BqID zdrojového souboru\(lq a \(BqID zdrojové stopy\(lq, určuje stopu, která se má připojit\&. Druhá dvojice, \(BqID cílového souboru\(lq a \(BqID cílové stopy\(lq, určuje stopu, ke které se první stopa připojí\&.
.sp
Je\-li tato volba vynechána, použije se standardní mapování\&. Při něm se každá stopa z aktuálního souboru připojí ke stopě z předchozího souboru se stejným ID stopy\&. Pokud byl film rozdělen na dvě části a oba soubory mají stejný počet stop i stejná ID stop, umožňuje to jejich snadné připojení příkazem
\fBmkvmerge \-o output\&.mkv part1\&.mkv +part2\&.mkv\fR\&.
.RE
.PP
\fB+\fR
.RS 4
Jediný znak \*(Aq+\*(Aq způsobí, že se následující soubor připojí namísto přidání\&. Znak \*(Aq+\*(Aq lze také umístit před název následujícího souboru\&. Následující dva příkazy jsou proto rovnocenné:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o full\&.mkv file1\&.mkv + file2\&.mkv
$ mkvmerge \-o full\&.mkv file1\&.mkv +file2\&.mkv
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB[\fR \fIfile1\fR \fIfile2\fR \fB]\fR
.RS 4
Je\-li v páru hranatých závorek uvedeno více názvů souborů, druhý a všechny následující soubory se připojí k prvnímu souboru uvedenému v závorkách\&.
.sp
Toto je alternativní syntaxe k použití znaku \*(Aq+\*(Aq mezi názvy souborů\&. Následující dva příkazy jsou proto ekvivalentní:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o full\&.mkv file1\&.mkv + file2\&.mkv
$ mkvmerge \-o full\&.mkv \*(Aq[\*(Aq file1\&.mkv file2\&.mkv \*(Aq]\*(Aq
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB=\fR
.RS 4
U určitých typů souborů (programové proudy MPEG = VOB)
\fBmkvmerge\fR(1)
za běžných okolností hledá ve stejném adresáři jako vstupní soubor další soubory se stejným základním názvem, které se liší pouze pořadovým číslem (např\&. \*(AqVTS_01_1\&.VOB\*(Aq, \*(AqVTS_01_2\&.VOB\*(Aq, \*(AqVTS_01_3\&.VOB\*(Aq atd\&.), a zachází se všemi těmito soubory, jako by byly zřetězeny do jednoho velkého souboru\&. Tato volba, jediný znak \*(Aq=\*(Aq, způsobí, že mkvmerge tyto další soubory hledat nebude\&.
.sp
Znak \*(Aq=\*(Aq lze také umístit před název následujícího souboru\&. Následující dva příkazy jsou proto ekvivalentní:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o full\&.mkv = file1\&.vob
$ mkvmerge \-o full\&.mkv =file1\&.vob
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB(\fR \fIfile1\fR \fIfile2\fR \fB)\fR
.RS 4
Je\-li v páru kulatých závorek uvedeno více názvů souborů, bude s těmito soubory zacházeno, jako by byly zřetězeny do jednoho velkého souboru tvořeného obsahem jednotlivých souborů v uvedeném pořadí\&.
.sp
To lze použít například pro soubory VOB pocházející z DVD nebo pro transportní proudy MPEG\&. Nelze to použít, pokud každý soubor obsahuje vlastní sadu hlaviček, což bývá případ samostatných souborů, jako jsou AVI nebo MP4\&.
.sp
Umístění názvu souboru do kulatých závorek také způsobí, že
\fBmkvmerge\fR(1)
nebude hledat další soubory se stejným základním názvem, jak je popsáno u
volby \fB=\fR\&. Následující dva příkazové řádky jsou proto rovnocenné:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o out\&.mkv = file\&.mkv
$ mkvmerge \-o out\&.mkv \*(Aq(\*(Aq file\&.mkv \*(Aq)\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
Je třeba vzít v úvahu několik věcí:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Za otevírací i před zavírací závorkou musí být mezery\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Každý parametr mezi kulatými závorkami se vykládá jako název souboru\&. Všechny volby vztahující se k tomuto logickému souboru proto musí být uvedeny před otevírací závorkou\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
Některé shelly považují závorky za zvláštní znaky\&. Proto je nutné je eskapovat nebo uzavřít do uvozovek, jak ukazuje uvedený příklad\&.
.RE
.RE
.SS "Podpora příloh (další globální volby)"
.PP
\fB\-\-attachment\-description\fR \fIdescription\fR
.RS 4
Prostý textový popis následující přílohy\&. Platí pro následující volbu
\fB\-\-attach\-file\fR
nebo
\fB\-\-attach\-file\-once\fR\&.
.RE
.PP
\fB\-\-attachment\-mime\-type\fR \fIMIME type\fR
.RS 4
Typ
MIME
následující přílohy\&. Platí pro následující volbu
\fB\-\-attach\-file\fR
nebo
\fB\-\-attach\-file\-once\fR\&. Seznam oficiálně registrovaných typů
MIME
najdete například na
\m[blue]\fBdomovské stránce IANA\fR\m[]\&\s-2\u[2]\d\s+2\&. Typ
MIME
je pro přílohu povinný\&.
.sp
Není\-li pro přílohu uveden žádný typ
MIME, její typ se zjistí automaticky\&.
.RE
.PP
\fB\-\-attachment\-name\fR \fIname\fR
.RS 4
Nastaví název, který se pro tuto přílohu uloží do výstupního souboru\&. Není\-li tato volba zadána, název se odvodí z názvu souboru přílohy zadaného volbou
\fB\-\-attach\-file\fR
nebo
\fB\-\-attach\-file\-once\fR\&.
.RE
.PP
\fB\-\-attach\-file\fR \fIfile\-name\fR, \fB\-\-attach\-file\-once\fR \fIfile\-name\fR
.RS 4
Vytvoří uvnitř souboru
Matroska(TM)
přílohu\&. Rozdíl mezi oběma podobami spočívá v tom, že při rozdělení se soubory přiložené pomocí
\fB\-\-attach\-file\fR
připojí ke všem výstupním souborům, zatímco soubory přiložené pomocí
\fB\-\-attach\-file\-once\fR
pouze k prvnímu vytvořenému souboru\&. Není\-li rozdělení použito, obě podoby se chovají stejně\&.
.sp
\fBmkvextract\fR(1)
lze použít k extrahování připojených souborů ze souboru
Matroska(TM)\&.
.RE
.PP
\fB\-\-enable\-legacy\-font\-mime\-types\fR
.RS 4
Povolí používání zastaralých typů
MIME
pro určité typy příloh písem\&. Například pro písma TrueType se použije \*(Aqapplication/x\-truetype\-font\*(Aq namísto \*(Aqfonts/ttf\*(Aq\&.
.sp
Týká se to jak nových příloh, pokud se jejich typ
MIME
zjišťuje automaticky, tak existujících příloh, jejichž uložené typy
MIME
se přemapují na zastaralé typy\&.
.sp
Dotčenými typy
MIME
jsou \*(Aqfont/sfnt\*(Aq, \*(Aqfont/ttf\*(Aq a \*(Aqfont/collection\*(Aq, které se všechny mapují na \*(Aqapplication/x\-truetype\-fonts\*(Aq, a \*(Aqfont/otf\*(Aq, který se mapuje na \*(Aqapplication/vnd\&.ms\-opentype\*(Aq\&.
.RE
.SS "Volby, které lze použít pro každý vstupní soubor"
.PP
\fB\-a\fR, \fB\-\-audio\-tracks\fR \fI[!]\fR\fIn,m,\&.\&.\&.\fR
.RS 4
Zkopíruje zvukové stopy
\fIn\fR,
\fIm\fR
atd\&. Čísla jsou ID stop, která lze získat volbou
\fB\-\-identify\fR\&. Nejde pouze o čísla stop (viz oddíl
ID stop)\&. Výchozí: zkopírují se všechny zvukové stopy\&.
.sp
Místo ID stop lze zadat také jazykové kódy ISO 639\-2\&. Funguje to pouze pro zdrojové soubory, které pro své stopy poskytují jazykové značky\&.
.sp
Výchozí: zkopírovat všechny stopy tohoto druhu\&.
.sp
Mají\-li ID předponu
!, význam se obrátí: zkopírují se všechny stopy tohoto druhu kromě stop uvedených za
!\&.
.RE
.PP
\fB\-d\fR, \fB\-\-video\-tracks\fR \fI[!]\fR\fIn,m,\&.\&.\&.\fR
.RS 4
Zkopíruje video stopy
\fIn\fR,
\fIm\fR
atd\&. Čísla jsou ID stop, která lze získat volbou
\fB\-\-identify\fR\&. Nejde pouze o čísla stop (viz oddíl
ID stop)\&. Výchozí: zkopírují se všechny video stopy\&.
.sp
Místo ID stop lze zadat také jazykové kódy ISO 639\-2\&. Funguje to pouze pro zdrojové soubory, které pro své stopy poskytují jazykové značky\&.
.sp
Mají\-li ID předponu
!, význam se obrátí: zkopírují se všechny stopy tohoto druhu kromě stop uvedených za
!\&.
.RE
.PP
\fB\-s\fR, \fB\-\-subtitle\-tracks\fR \fI[!]\fR\fIn,m,\&.\&.\&.\fR
.RS 4
Zkopíruje titulkové stopy
\fIn\fR,
\fIm\fR
atd\&. Čísla jsou ID stop, která lze získat volbou
\fB\-\-identify\fR\&. Nejde pouze o čísla stop (viz oddíl
ID stop)\&. Výchozí: zkopírují se všechny titulkové stopy\&.
.sp
Místo ID stop lze zadat také jazykové kódy ISO 639\-2\&. Funguje to pouze pro zdrojové soubory, které pro své stopy poskytují jazykové značky\&.
.sp
Mají\-li ID předponu
!, význam se obrátí: zkopírují se všechny stopy tohoto druhu kromě stop uvedených za
!\&.
.RE
.PP
\fB\-b\fR, \fB\-\-button\-tracks\fR \fI[!]\fR\fIn,m,\&.\&.\&.\fR
.RS 4
Zkopíruje stopy tlačítek
\fIn\fR,
\fIm\fR
atd\&. Čísla jsou ID stop, která lze získat volbou
\fB\-\-identify\fR\&. Nejde pouze o čísla stop (viz oddíl
ID stop)\&. Výchozí: zkopírují se všechny stopy tlačítek\&.
.sp
Místo ID stop lze zadat také jazykové kódy ISO 639\-2\&. Funguje to pouze pro zdrojové soubory, které pro své stopy poskytují jazykové značky\&.
.sp
Mají\-li ID předponu
!, význam se obrátí: zkopírují se všechny stopy tohoto druhu kromě stop uvedených za
!\&.
.RE
.PP
\fB\-\-track\-tags\fR \fI[!]\fR\fIn,m,\&.\&.\&.\fR
.RS 4
Zkopíruje štítky stop
\fIn\fR,
\fIm\fR
atd\&. Čísla jsou ID stop, která lze získat volbou
\fB\-\-identify\fR
(viz oddíl
ID stop)\&. Nejde pouze o čísla stop\&. Výchozí: zkopírují se štítky všech stop\&.
.sp
Mají\-li ID předponu
!, význam se obrátí: zkopíruje se vše kromě ID uvedených za
!\&.
.RE
.PP
\fB\-m\fR, \fB\-\-attachments\fR \fI[!]\fR\fIn\fR\fI[:all|first]\fR\fI,m\fR\fI[:all|first]\fR\fI,\&.\&.\&.\fR
.RS 4
Zkopíruje přílohy s ID
\fIn\fR,
\fIm\fR
atd\&. do všech výstupních souborů, nebo pouze do prvního\&. Za každým ID může následovat \*(Aq:all\*(Aq (výchozí hodnota, není\-li zadána žádná z obou možností) nebo \*(Aq:first\*(Aq\&. Je\-li aktivní rozdělení, přílohy s ID zadanými pomocí \*(Aq:all\*(Aq se zkopírují do všech výsledných výstupních souborů, zatímco ostatní pouze do prvního výstupního souboru\&. Není\-li rozdělení aktivní, mají obě varianty stejný účinek\&.
.sp
Ve výchozím stavu se všechny přílohy zkopírují do všech výstupních souborů\&.
.sp
Mají\-li ID předponu
!, význam se obrátí: zkopíruje se vše kromě ID uvedených za
!\&.
.RE
.PP
\fB\-A\fR, \fB\-\-no\-audio\fR
.RS 4
Z tohoto souboru nekopírovat žádnou zvukovou stopu\&.
.RE
.PP
\fB\-D\fR, \fB\-\-no\-video\fR
.RS 4
Z tohoto souboru nekopírovat žádnou video stopu\&.
.RE
.PP
\fB\-S\fR, \fB\-\-no\-subtitles\fR
.RS 4
Z tohoto souboru nekopírovat žádnou titulkovou stopu\&.
.RE
.PP
\fB\-B\fR, \fB\-\-no\-buttons\fR
.RS 4
Z tohoto souboru nekopírovat žádnou stopu tlačítek\&.
.RE
.PP
\fB\-T\fR, \fB\-\-no\-track\-tags\fR
.RS 4
Z tohoto souboru nekopírovat žádné štítky specifické pro stopu\&.
.RE
.PP
\fB\-\-no\-chapters\fR
.RS 4
Z tohoto souboru nekopírovat kapitoly\&.
.RE
.PP
\fB\-M\fR, \fB\-\-no\-attachments\fR
.RS 4
Z tohoto souboru nekopírovat přílohy\&.
.RE
.PP
\fB\-\-no\-global\-tags\fR
.RS 4
Z tohoto souboru nekopírovat globální štítky\&.
.RE
.PP
\fB\-\-regenerate\-track\-uids\fR
.RS 4
Při použití této volby pro zdrojový soubor Matroska vytvoří
\fBmkvmerge\fR(1)
nová náhodná jedinečná ID stop namísto zachování ID existujících v souboru\&. Existující UID stop v kapitolách & štítcích načtených ze stejného souboru se přemapují na nově vytvořené hodnoty\&.
.sp
Toto chování se automaticky povoluje pro soubory Matroska vytvořené programem MakeMKV\&. Důvodem je, že MakeMKV používá jako UID po sobě jdoucí čísla (1, 2, 3\&...) namísto generování náhodných hodnot\&.
.RE
.PP
\fB\-y\fR, \fB\-\-sync\fR \fITID:d\fR\fI[,o[/p]]\fR
.RS 4
Upraví časová razítka stopy s ID
\fITID\fR
o
\fId\fR
ms\&. ID stop jsou stejná jako ID uváděná volbou
\fB\-\-identify\fR
(viz oddíl
ID stop)\&.
.sp
\fIo\fR/\fIp\fR: upraví časová razítka o
\fIo\fR/\fIp\fR, aby opravil lineární posuny\&. Není\-li
\fIp\fR
uvedeno, výchozí je 1\&. Hodnoty
\fIo\fR
i
\fIp\fR
mohou být čísla s pohyblivou řádovou čárkou\&.
.sp
Výchozí: žádná ruční oprava synchronizace (což je stejné jako
\fId\fR
=
\fB0\fR
a
\fIo\fR/\fIp\fR
=
\fB1\&.0\fR)\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-cues\fR \fITID:none|iframes|all\fR
.RS 4
Určuje, pro které bloky se pro danou stopu vytvoří položky indexu (viz oddíl
ID stop)\&. Hodnota \*(Aqnone\*(Aq vytváření položek indexu zakáže\&. Při hodnotě \*(Aqiframes\*(Aq se do indexu vloží pouze bloky bez zpětných nebo dopředných referencí (= snímky I ve video stopách)\&. Hodnota \*(Aqall\*(Aq způsobí, že
\fBmkvmerge\fR(1)
vytvoří položky indexu pro všechny bloky, čímž soubor výrazně naroste\&.
.sp
Výchozí hodnotou je \*(Aqiframes\*(Aq pro video a titulkové stopy a \*(Aqnone\*(Aq pro zvukové stopy\&. Viz také volba
\fB\-\-no\-cues\fR, která zakáže vytváření položek indexu bez ohledu na použité volby
\fB\-\-cues\fR\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-default\-track\-flag\fR \fITID\fR\fI[:bool]\fR
.RS 4
Nastaví příznak "výchozí stopa" pro danou stopu (viz oddíl
ID stop), je\-li volitelný argument
\fIbool\fR
nastaven na
\fB1\fR
nebo není\-li přítomen\&. Příznak se nastaví, pokud zdrojový kontejner tuto informaci neposkytuje a uživatel ji nezadá touto volbou\&.
.sp
Nevybere\-li uživatel během přehrávání stopu výslovně, měl by přehrávač vybrat jednu ze stop s nastaveným příznakem "výchozí stopa" a zohlednit přitom uživatelské předvolby, například upřednostňovaný jazyk\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-track\-enabled\-flag\fR \fITID\fR\fI[:bool]\fR
.RS 4
Nastaví příznak "povolená stopa" pro danou stopu (viz oddíl
ID stop) na zadanou hodnotu
\fIbool\fR
(0 nebo 1; není\-li zadána, výchozí je 1)\&. Ve výchozím nastavení jsou stopy povoleny, pokud pro ně není zadána žádná volba a zdrojový kontejner tuto informaci rovněž neposkytuje\&.
.sp
Při přehrávání se mají zohlednit pouze stopy, pro něž je nastaven příznak "povolená stopa"\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-forced\-display\-flag\fR \fITID\fR\fI[:bool]\fR
.RS 4
Nastaví příznak "vynucené zobrazení" pro danou stopu (viz oddíl
ID stop), je\-li volitelný argument
\fIbool\fR
nastaven na
\fB1\fR
nebo není\-li přítomen\&. Použijte jej pro stopy obsahující text zobrazovaný na obrazovce nebo dialogy v cizím jazyce\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-hearing\-impaired\-flag\fR \fITID\fR\fI[:bool]\fR
.RS 4
Nastaví příznak "sluchové postižení" pro danou stopu (viz oddíl
ID stop), je\-li volitelný argument
\fIbool\fR
nastaven na
\fB1\fR
nebo není\-li přítomen\&. Tento příznak lze nastavit, je\-li stopa vhodná pro uživatele se sluchovým postižením\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-visual\-impaired\-flag\fR \fITID\fR\fI[:bool]\fR
.RS 4
Nastaví příznak "zrakové postižení" pro danou stopu (viz oddíl
ID stop), je\-li volitelný argument
\fIbool\fR
nastaven na
\fB1\fR
nebo není\-li přítomen\&. Tento příznak lze nastavit, je\-li stopa vhodná pro uživatele se zrakovým postižením\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-text\-descriptions\-flag\fR \fITID\fR\fI[:bool]\fR
.RS 4
Nastaví příznak "textové popisy" pro danou stopu (viz oddíl
ID stop), je\-li volitelný argument
\fIbool\fR
nastaven na
\fB1\fR
nebo není\-li přítomen\&. Tento příznak lze nastavit, obsahuje\-li stopa textové popisy video obsahu vhodné k přehrávání systémem převodu textu na řeč pro uživatele se zrakovým postižením\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-original\-flag\fR \fITID\fR\fI[:bool]\fR
.RS 4
Nastaví příznak "původní jazyk" pro danou stopu (viz oddíl
ID stop), je\-li volitelný argument
\fIbool\fR
nastaven na
\fB1\fR
nebo není\-li přítomen\&. Tento příznak lze nastavit, je\-li stopa v původním jazyce obsahu (nejde o překlad)\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-commentary\-flag\fR \fITID\fR\fI[:bool]\fR
.RS 4
Nastaví příznak "komentář" pro danou stopu (viz oddíl
ID stop), je\-li volitelný argument
\fIbool\fR
nastaven na
\fB1\fR
nebo není\-li přítomen\&. Tento příznak lze nastavit, obsahuje\-li stopa komentář\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-\-track\-name\fR \fITID:name\fR
.RS 4
Nastaví název dané stopy (viz oddíl
ID stop) na
\fIname\fR\&.
.RE
.PP
\fB\-\-language\fR \fITID:language\fR
.RS 4
Nastaví jazyk dané stopy (viz oddíl
ID stop)\&. Povoleny jsou jazykové kódy ISO 639\-2 i kódy zemí ISO 639\-1\&. Kódy zemí se automaticky převedou na jazykové kódy\&. Všechny jazyky včetně jejich kódů ISO 639\-2 lze vypsat volbou
\fB\-\-list\-languages\fR\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.PP
\fB\-t\fR, \fB\-\-tags\fR \fITID:file\-name\fR
.RS 4
Načte štítky pro stopu s číslem
\fITID\fR
ze souboru
\fIfile\-name\fR\&. Podrobnosti najdete níže v oddílu o
štítcích\&.
.RE
.PP
\fB\-\-aac\-is\-sbr\fR \fITID\fR\fI[:0|1]\fR
.RS 4
Určuje programu
\fBmkvmerge\fR(1), že stopa s ID
\fITID\fR
je
SBR AAC
(známá také jako
HE\-AAC
nebo
AAC+)\&. Tato volba je nutná, pokud a) je zdrojovým souborem soubor
AAC
(\fInikoli\fR
soubor
Matroska(TM)) a b) soubor
AAC
obsahuje data
SBR AAC\&. Důvodem této volby je, že běžná data
AAC
nelze automaticky odlišit od dat
SBR AAC
bez dekódování celého snímku
AAC\&. Protože s dekodéry
AAC
souvisí několik patentových problémů,
\fBmkvmerge\fR(1)
tuto fázi dekódování nikdy obsahovat nebude\&. Pro soubory
SBR AAC
je proto tato volba povinná\&. Při jejím vynechání se výsledný soubor nemusí přehrát správně, nebo vůbec\&.
.sp
Je\-li zdrojovým souborem soubor
Matroska(TM), měl by
CodecID
stačit k rozpoznání
SBR AAC\&. Je\-li však
CodecID
chybný, lze tuto volbu použít k jeho opravě\&.
.sp
Rozpozná\-li mkvmerge chybně soubor
AAC
jako
SBR, můžete k ID stopy přidat \*(Aq:0\*(Aq\&.
.RE
.PP
\fB\-\-audio\-emphasis\fR \fITID:n|symbolic\-name\fR
.RS 4
Nastaví zdůraznění zvuku pro stopu s ID
\fITID\fR\&. Režim může být buď číslo
\fIn\fR
(určité hodnoty mezi
\fB0\fR
a
\fB16\fR), nebo symbolický název\&. Všechna platná čísla & symbolické názvy lze vypsat volbou
\fB\-\-list\-audio\-emphasis\fR\&.
.RE
.PP
\fB\-\-reduce\-to\-core\fR \fITID\fR
.RS 4
Některé zvukové kodeky mají ztrátové jádro a volitelná rozšíření umožňující bezeztrátové dekódování\&. Tato volba způsobí, že
\fBmkvmerge\fR(1)
zkopíruje pouze jádro, nikoli rozšíření\&. Ve výchozím nastavení
\fBmkvmerge\fR(1)
kopíruje jádro i rozšíření\&.
.sp
V současnosti se tato volba týká pouze stop
DTS\&. Stopy TrueHD obsahující vložené jádro
AC\-3
se namísto toho zobrazují jako dvě samostatné stopy, z nichž může uživatel vybrat, kterou zkopírovat\&. U
DTS
by takové řešení nefungovalo, protože rozšíření HD nelze na rozdíl od dat TrueHD dekódovat samostatně\&.
.RE
.PP
\fB\-\-remove\-dialog\-normalization\-gain\fR \fITID\fR
.RS 4
Některé zvukové kodeky obsahují pole hlavičky, která dekodéru nebo přehrávači určují použití zesílení (obvykle se zápornou hodnotou) pro normalizaci dialogů\&. Tato volba způsobí, že
\fBmkvmerge\fR(1)
toto zesílení odstraní nebo minimalizuje úpravou příslušných polí hlavičky\&.
.sp
V současnosti se tato volba týká pouze stop
AC\-3,
DTS
a
TrueHD\&.
.RE
.PP
\fB\-\-timestamps\fR \fITID:file\-name\fR
.RS 4
Načte ze souboru
\fIfile\-name\fR
časová razítka, která se mají použít pro konkrétní ID stopy\&. Tato časová razítka vynuceně přepíší časová razítka, která
\fBmkvmerge\fR(1)
běžně vypočítává\&. Přečtěte si oddíl o
externích souborech časových razítek\&.
.RE
.PP
\fB\-\-default\-duration\fR \fITID:x\fR
.RS 4
Vynutí výchozí délku dané stopy na zadanou hodnotu\&. Rovněž upraví časová razítka stopy tak, aby odpovídala výchozí délce\&. Argument
\fIx\fR
musí mít příponu \*(Aqs\*(Aq, \*(Aqms\*(Aq, \*(Aqus\*(Aq, \*(Aqns\*(Aq, \*(Aqfps\*(Aq, \*(Aqp\*(Aq nebo \*(Aqi\*(Aq; tyto přípony v uvedeném pořadí určují výchozí délku v sekundách, milisekundách, mikrosekundách, nanosekundách, \*(Aqsnímcích za sekundu\*(Aq, \*(Aqprogresivních snímcích za sekundu\*(Aq nebo \*(Aqprokládaných snímcích za sekundu\*(Aq\&. Samotné číslo
\fIx\fR
může být desetinné číslo nebo zlomek\&.
.sp
Není\-li výchozí délka vynucena, pokusí se mkvmerge u určitých typů stop, např\&. AVC/H\&.264 nebo MPEG\-2, odvodit výchozí délku stopy z kontejneru nebo zakódovaného bitového toku, případně z obou\&.
.sp
Touto volbou lze také změnit
FPS
video stop, aniž by bylo nutné použít externí soubor časových razítek\&.
.RE
.PP
\fB\-\-fix\-bitstream\-timing\-information\fR \fITID\fR\fI[:0|1]\fR
.RS 4
Za běžných okolností
\fBmkvmerge\fR(1)
nemění časovací informace (frekvenci snímků/půlsnímků) uložené v bitovém toku videa\&. Touto volbou se tyto informace upraví tak, aby odpovídaly časovacím informacím kontejneru\&. Ty mohou pocházet z různých zdrojů: z příkazového řádku (viz volba
\fB\-\-default\-duration\fR), ze zdrojového kontejneru nebo mohou být odvozeny z bitového toku\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
Dosud je to implementováno pouze pro video stopy AVC/H\&.264\&.
.sp .5v
.RE
.RE
.PP
\fB\-\-compression\fR \fITID:n\fR
.RS 4
Vybere metodu komprese, která se má použít pro stopu\&. Tuto metodu musí podporovat také přehrávač\&. Platné hodnoty jsou \*(Aqnone\*(Aq, \*(Aqzlib\*(Aq a \*(Aqmpeg4_p2\*(Aq/\*(Aqmpeg4p2\*(Aq\&.
.sp
Metoda komprese \*(Aqmpeg4_p2\*(Aq/\*(Aqmpeg4p2\*(Aq je zvláštní metoda zvaná \*(Aqodstranění hlavičky\*(Aq, která je dostupná pouze pro video stopy
MPEG4
část 2\&.
.sp
Pro některé typy titulků je výchozí komprese \*(Aqzlib\*(Aq\&. Tuto metodu komprese podporuje také většina, ne\-li všechny přehrávací aplikace\&. Podpora jiných metod komprese než \*(Aqnone\*(Aq není zaručena\&.
.RE
.SS "Volby, které se vztahují pouze na video stopy"
.PP
\fB\-f\fR, \fB\-\-fourcc\fR \fITID:FourCC\fR
.RS 4
Vynutí
FourCC
na zadanou hodnotu\&. Funguje pouze pro video stopy v \*(Aqrežimu kompatibility s MS\*(Aq\&.
.RE
.PP
\fB\-\-display\-dimensions\fR \fITID:widthxheight\fR
.RS 4
Soubory
Matroska(TM)
obsahují dvě hodnoty, podle nichž má přehrávač při přehrávání škálovat obraz: šířku zobrazení a výšku zobrazení\&. Tyto hodnoty lze nastavit touto volbou, např\&. \*(Aq1:640x480\*(Aq\&.
.sp
Hodnoty lze zadat také volbou
\fB\-\-aspect\-ratio\fR
nebo
\fB\-\-aspect\-ratio\-factor\fR
(viz níže)\&. Tyto volby se navzájem vylučují\&.
.RE
.PP
\fB\-\-aspect\-ratio\fR \fITID:ratio|width/height\fR
.RS 4
Soubory
Matroska(TM)
obsahují dvě hodnoty, podle nichž má přehrávač při přehrávání škálovat obraz: šířku zobrazení a výšku zobrazení\&. Touto volbou
\fBmkvmerge\fR(1)
automaticky vypočítá šířku a výšku zobrazení podle původní šířky a výšky obrazu a poměru stran zadaného touto volbou\&. Poměr lze zadat buď jako desetinné číslo
\fIratio\fR, nebo jako zlomek \*(Aq\fIwidth\fR/\fIheight\fR\*(Aq, např\&. \*(Aq16/9\*(Aq\&.
.sp
Hodnoty lze zadat také volbami
\fB\-\-aspect\-ratio\-factor\fR
nebo
\fB\-\-display\-dimensions\fR
(viz výše a níže)\&. Tyto volby se navzájem vylučují\&.
.RE
.PP
\fB\-\-aspect\-ratio\-factor\fR \fITID:factor|n/d\fR
.RS 4
Poměr stran lze nastavit také zadáním
\fIfactor\fR\&. Původní poměr stran se nejprve vynásobí tímto
\fIfactor\fR
a výsledek se použije jako cílový poměr stran\&.
.sp
Hodnoty lze zadat také volbami
\fB\-\-aspect\-ratio\fR
nebo
\fB\-\-display\-dimensions\fR
(viz výše)\&. Tyto volby se navzájem vylučují\&.
.RE
.PP
\fB\-\-cropping\fR \fITID:left,top,right,bottom\fR
.RS 4
Nastavuje parametry oříznutí pixelů video stopy na zadané hodnoty\&.
.RE
.PP
\fB\-\-color\-matrix\-coefficients\fR \fITID:n\fR
.RS 4
Nastaví koeficienty matice videa používané k odvození hodnot jasu a chrominance z červených, zelených a modrých primárních barev\&. Parametr
\fIn\fR
je celé číslo v rozsahu od
\fB0\fR
do
\fB10\fR\&.
.sp
Platné hodnoty a jejich význam jsou:
.sp
\fB0\fR: GBR,
\fB1\fR: BT709,
\fB2\fR: neurčeno,
\fB3\fR: vyhrazeno,
\fB4\fR: FCC,
\fB5\fR: BT470BG,
\fB6\fR: SMPTE 170M,
\fB7\fR: SMPTE 240M,
\fB8\fR: YCOCG,
\fB9\fR: BT2020 s nekonstantním jasem,
\fB10\fR: BT2020 s konstantním jasem
.RE
.PP
\fB\-\-color\-bits\-per\-channel\fR \fITID:n\fR
.RS 4
Nastaví počet kódovaných bitů pro barevný kanál\&. Hodnota
\fB0\fR
označuje, že počet bitů není určen\&.
.RE
.PP
\fB\-\-chroma\-subsample\fR \fITID:hori,vert\fR
.RS 4
Počet pixelů, které se mají odebrat v kanálech Cr a Cb na každý pixel, který se neodebere vodorovně/svisle\&.
.sp
Příklad: U videa s podvzorkováním chrominance 4:2:0 má být parametr nastaven na
\fITID\fR:\fB1\fR,\fB1\fR\&.
.RE
.PP
\fB\-\-cb\-subsample\fR \fITID:hori,vert\fR
.RS 4
Počet pixelů, které se mají v kanálu Cb odstranit na každý pixel neodstraněný ve vodorovném/svislém směru\&. Tato hodnota se přičítá k
\fB\-\-chroma\-subsample\fR\&.
.sp
Příklad: U videa s podvzorkováním chrominance 4:2:1 má být parametr
\fB\-\-chroma\-subsample\fR
nastaven na
\fITID\fR:\fB1\fR,\fB0\fR
a podvzorkování Cb na
\fITID\fR:\fB1\fR,\fB0\fR\&.
.RE
.PP
\fB\-\-chroma\-siting\fR \fITID:hori,vert\fR
.RS 4
Nastaví způsob vodorovného/svislého umístění chrominance (\fB0\fR: neurčeno,
\fB1\fR: společně umístěno nahoře,
\fB2\fR: poloviční posun)\&.
.RE
.PP
\fB\-\-color\-range\fR \fITID:n\fR
.RS 4
Nastaví oříznutí barevných rozsahů (\fB0\fR: neurčeno,
\fB1\fR: vysílací rozsah,
\fB2\fR: plný rozsah (bez oříznutí),
\fB3\fR: určeno pomocí MatrixCoefficients/TransferCharacteristics)\&.
.RE
.PP
\fB\-\-color\-transfer\-characteristics\fR \fITID:n\fR
.RS 4
Přenosové charakteristiky videa\&.
.sp
Platné hodnoty a jejich význam jsou:
.sp
\fB0\fR: vyhrazeno,
\fB1\fR: ITU\-R BT\&.709,
\fB2\fR: neurčeno,
\fB3\fR: vyhrazeno,
\fB4\fR: křivka gama 2\&.2,
\fB5\fR: křivka gama 2\&.8,
\fB6\fR: SMPTE 170M,
\fB7\fR: SMPTE 240M,
\fB8\fR: lineární,
\fB9\fR: log,
\fB10\fR: odmocnina z log,
\fB11\fR: IEC 61966\-2\-4,
\fB12\fR: rozšířený barevný gamut ITU\-R BT\&.1361,
\fB13\fR: IEC 61966\-2\-1,
\fB14\fR: ITU\-R BT\&.2020 10 bitů,
\fB15\fR: ITU\-R BT\&.2020 12 bitů,
\fB16\fR: SMPTE ST 2084,
\fB17\fR: SMPTE ST 428\-1;
\fB18\fR: ARIB STD\-B67 (HLG)
.RE
.PP
\fB\-\-color\-primaries\fR \fITID:n\fR
.RS 4
Nastavuje primární barvy videa\&.
.sp
Platné hodnoty a jejich význam jsou:
.sp
\fB0\fR: vyhrazeno,
\fB1\fR: ITU\-R BT\&.709,
\fB2\fR: neurčeno,
\fB3\fR: vyhrazeno,
\fB4\fR: ITU\-R BT\&.470M,
\fB5\fR: ITU\-R BT\&.470BG,
\fB6\fR: SMPTE 170M,
\fB7\fR: SMPTE 240M,
\fB8\fR: FILM,
\fB9\fR: ITU\-R BT\&.2020,
\fB10\fR: SMPTE ST 428\-1,
\fB22\fR: luminofory JEDEC P22
.RE
.PP
\fB\-\-max\-content\-light\fR \fITID:n\fR
.RS 4
Nastaví maximální jas jednoho pixelu (Maximum Content Light Level) v kandelách na metr čtvereční (cd/m\(S2)\&. Hodnota
\fIn\fR
musí být nezáporné celé číslo\&.
.RE
.PP
\fB\-\-max\-frame\-light\fR \fITID:n\fR
.RS 4
Nastaví maximální jas jednoho celého snímku (Maximum Frame\-Average Light Level) v kandelách na metr čtvereční (cd/m\(S2)\&. Hodnota
\fIn\fR
musí být nezáporné celé číslo\&.
.RE
.PP
\fB\-\-chromaticity\-coordinates\fR \fITID:red\-x,red\-y,green\-x,green\-y,blue\-x,blue\-y\fR
.RS 4
Nastavuje souřadnice chromatičnosti červené/zelené/modré podle CIE 1931\&.
.RE
.PP
\fB\-\-white\-color\-coordinates\fR \fITID:x,y\fR
.RS 4
Nastavuje souřadnice chromatičnosti bílé podle CIE 1931\&.
.RE
.PP
\fB\-\-max\-luminance\fR \fITID:float\fR
.RS 4
Nastavuje maximální jas v kandelách na metr čtvereční (cd/m\(S2)\&. Hodnota by měla být menší než 9999\&.99\&.
.RE
.PP
\fB\-\-min\-luminance\fR \fITID:float\fR
.RS 4
Nastavuje minimální jas v kandelách na metr čtvereční (cd/m\(S2)\&. Hodnota by měla být menší než 999\&.9999\&.
.RE
.PP
\fB\-\-projection\-type\fR \fITID:method\fR
.RS 4
Nastaví použitou metodu projekce videa\&. Platné hodnoty jsou 0 (obdélníková projekce), 1 (ekvirektangulární projekce), 2 (projekce mapy krychle) a 3 (síťová projekce)\&.
.RE
.PP
\fB\-\-projection\-private\fR \fITID:data\fR
.RS 4
Nastaví soukromá data platná pouze pro určitou projekci\&. Data musí být zadána jako šestnáctková čísla s předponou "0x" nebo bez ní a s mezerami nebo bez nich\&.
.RE
.PP
\fB\-\-projection\-pose\-yaw\fR \fITID:float\fR
.RS 4
Určuje rotaci projekce v ose yaw\&.
.RE
.PP
\fB\-\-projection\-pose\-pitch\fR \fITID:float\fR
.RS 4
Určuje rotaci projekce v ose pitch\&.
.RE
.PP
\fB\-\-projection\-pose\-roll\fR \fITID:float\fR
.RS 4
Určuje rotaci projekce v ose roll\&.
.RE
.PP
\fB\-\-field\-order\fR \fITID:n\fR
.RS 4
Nastaví pořadí půlsnímků video stopy s ID stopy
\fITID\fR\&. Pořadí musí být jedno z následujících čísel:
.sp
\fB0\fR: progresivní;
\fB1\fR: prokládané, horní půlsnímek se zobrazí jako první a uloží jako první;
\fB2\fR: neurčené pořadí půlsnímků;
\fB6\fR: prokládané, dolní půlsnímek se zobrazí jako první a uloží jako první;
\fB9\fR: prokládané, dolní půlsnímek se zobrazí jako první a horní půlsnímek se uloží jako první;
\fB14\fR: prokládané, horní půlsnímek se zobrazí jako první a dolní půlsnímek se uloží jako první
.RE
.PP
\fB\-\-stereo\-mode\fR \fITID:n|symbolic\-name\fR
.RS 4
Nastaví režim sterea video stopy s ID stopy
\fITID\fR\&. Režim může být buď číslo
\fIn\fR
mezi
\fB0\fR
a
\fB14\fR, nebo symbolický název\&. Všechna platná čísla & názvy lze vypsat volbou
\fB\-\-list\-stereo\-modes\fR\&.
.RE
.SS "Volby, které platí pouze pro textové titulkové stopy"
.PP
\fB\-\-sub\-charset\fR \fITID:character\-set\fR
.RS 4
Nastaví pro dané ID stopy znakovou sadu používanou při převodu titulků do UTF\-8\&. Není\-li zadána, odvodí se znaková sada z aktuálního nastavení národního prostředí\&. Pro titulky načtené ze souborů
Matroska(TM)
nebo z proudů Kate není znaková sada potřeba, protože jsou vždy uloženy v UTF\-8\&. Vysvětlení, jak
\fBmkvmerge\fR(1)
převádí mezi znakovými sadami, najdete v oddílu o
textových souborech a znakových sadách\&.
.sp
Tuto volbu lze pro vstupní soubor použít vícekrát; pokaždé lze vybrat jiné ID stopy, takže platí pro několik stop\&.
.RE
.SS "Další volby"
.PP
\fB\-i\fR, \fB\-\-identify\fR \fIfile\-name\fR
.RS 4
Nechá
\fBmkvmerge\fR(1)
prozkoumat jediný soubor a oznámit jeho typ, stopy obsažené v souboru a jejich ID stop\&. Při použití této volby je jediným dalším povoleným argumentem název souboru\&.
.sp
Výstupní formát výsledku lze změnit volbou
\-\-identification\-format\&.
.RE
.PP
\fB\-J\fR \fIfile\-name\fR
.RS 4
Toto je pohodlný alias pro "\-\-identification\-format json \-\-identify file\-name"\&.
.RE
.PP
\fB\-F\fR, \fB\-\-identification\-format\fR \fIformat\fR
.RS 4
Určuje výstupní formát používaný
volbou \-\-identify\&. Podporovány jsou následující formáty:
text
(výchozí, není\-li tato volba použita) a
json\&.
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Formát
text
je stručný a čitelný pro člověka\&. Skládá se z jednoho řádku pro každou nalezenou položku (kontejner, stopy, přílohy atd\&.)\&.
.sp
Tento formát není určen ke strojovému zpracování\&. Výstup se přeloží do jazyka používaného programem
\fBmkvmerge\fR(1)
(viz také
\-\-ui\-language)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Formát
json
vypisuje strojově čitelnou reprezentaci JSON\&. Tento formát se řídí schématem JSON popsaným v následujícím souboru:
.sp
\m[blue]\fBmkvmerge\-identification\-output\-schema\-v20\&.json\fR\m[]\&\s-2\u[3]\d\s+2
.sp
Všechny verze schématu JSON jsou dostupné online i ve vydaných archivech zdrojového kódu\&.
.RE
.RE
.PP
\fB\-\-probe\-range\-percentage\fR \fIpercentage\fR
.RS 4
Typy souborů, jako jsou programové a transportní proudy MPEG (\&.vob,
\&.m2ts), vyžadují analýzu určitého množství dat, aby bylo možné rozpoznat všechny stopy obsažené v souboru\&. Toto množství činí 0,3 % velikosti zdrojového souboru nebo 10 MB podle toho, která hodnota je větší\&.
.sp
Je\-li známo, že stopy jsou přítomny, ale nebyly nalezeny, lze touto volbou změnit procento prohledávaných dat\&. Minimum 10 MB je pevně vestavěno a nelze je změnit\&.
.RE
.PP
\fB\-\-list\-audio\-emphasis\fR
.RS 4
Vypíše všechna platná čísla & jejich odpovídající symbolické názvy pro volbu
\fB\-\-audio\-emphasis\fR\&.
.RE
.PP
\fB\-\-list\-languages\fR
.RS 4
Vypíše všechny jazyky a jejich kódy ISO 639\-2, které lze použít s volbou
\fB\-\-language\fR\&.
.RE
.PP
\fB\-\-list\-stereo\-modes\fR
.RS 4
Vypíše všechna platná čísla & jejich odpovídající symbolické názvy pro volbu
\fB\-\-stereo\-mode\fR\&.
.RE
.PP
\fB\-l\fR, \fB\-\-list\-types\fR
.RS 4
Vypíše podporované typy vstupních souborů\&.
.RE
.PP
\fB\-\-priority\fR \fIpriority\fR
.RS 4
Nastaví prioritu procesu, s níž
\fBmkvmerge\fR(1)
běží\&. Platné hodnoty jsou \*(Aqlowest\*(Aq, \*(Aqlower\*(Aq, \*(Aqnormal\*(Aq, \*(Aqhigher\*(Aq a \*(Aqhighest\*(Aq\&. Není\-li zadána žádná hodnota, použije se \*(Aqnormal\*(Aq\&. Na systémech podobných Unixu používá
\fBmkvmerge\fR(1)
funkci
\fBnice\fR(2)\&. Hodnoty \*(Aqhigher\*(Aq a \*(Aqhighest\*(Aq proto může použít pouze superuživatel\&. V systému Windows může všechny hodnoty použít každý uživatel\&.
.sp
Výběr hodnoty \*(Aqlowest\*(Aq způsobí, že
\fBmkvmerge\fR(1)
vedle nejnižší možné priority procesu zvolí také prioritu I/O v režimu nečinnosti\&.
.RE
.PP
\fB\-\-command\-line\-charset\fR \fIcharacter\-set\fR
.RS 4
Nastaví znakovou sadu, ze které se mají převádět řetězce zadané na příkazovém řádku\&. Výchozí je znaková sada určená aktuálním národním prostředím systému\&. Toto nastavení platí pro argumenty následujících voleb:
\fB\-\-title\fR,
\fB\-\-track\-name\fR
a
\fB\-\-attachment\-description\fR\&.
.RE
.PP
\fB\-\-output\-charset\fR \fIcharacter\-set\fR
.RS 4
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\&.
.RE
.PP
\fB\-r\fR, \fB\-\-redirect\-output\fR \fIfile\-name\fR
.RS 4
Zapíše všechny zprávy do souboru
\fIfile\-name\fR
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í
\fB\-\-output\-charset\fR\&.
.RE
.PP
\fB\-\-no\-bom\fR
.RS 4
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ů\&.
.RE
.PP
\fB\-\-flush\-on\-close\fR
.RS 4
Dává programu pokyn, aby při zavírání souborů otevřených pro zápis vyprázdnil na úložiště všechna data uložená v paměti\&. Lze tím zabránit ztrátě dat při výpadku napájení nebo obejít určité problémy v operačním systému či ovladačích\&. Nevýhodou je, že multiplexování bude trvat déle, protože mkvmerge před ukončením čeká na zápis všech dat na úložiště\&. Podrobnou diskusi o výhodách a nevýhodách najdete v hlášeních č\&. 2469 a 2480 ve sledování chyb MKVToolNix\&.
.RE
.PP
\fB\-\-ui\-language\fR \fIcode\fR
.RS 4
Vynutí použití překladů pro jazyk
\fIcode\fR
(např\&. \*(Aqde_DE\*(Aq pro německé překlady)\&. Zadáním \*(Aqlist\*(Aq jako
\fIcode\fR
program vypíše seznam dostupných překladů\&.
.RE
.PP
\fB\-\-abort\-on\-warnings\fR
.RS 4
Ukončí program po vydání prvního upozornění\&. Návratový kód programu bude 1\&.
.RE
.PP
\fB\-\-deterministic\fR \fIseed\fR
.RS 4
Povolí vytváření bajtově shodných souborů, pokud se použije stejná verze
\fBmkvmerge\fR(1)
se stejnými zdrojovými soubory, stejnou sadou voleb a stejnou počáteční hodnotou\&. V tomto režimu se nezapisuje pole \(Bqdate\(lq v informacích o úseku\&.
.sp
Počáteční hodnota může být libovolný řetězec a nemusí být číslem\&.
.sp
Výsledek bajtově shodných souborů je zaručen pouze při následujících podmínkách:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Používá se stejná verze
\fBmkvmerge\fR(1)
sestavená se stejnými verzemi libEBML a libMatroska\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Použité zdrojové soubory jsou bajtově shodné\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
Použijí se stejné volby příkazového řádku ve stejném pořadí (s významnou výjimkou
\fI\-\-output \&...\fR)\&.
.RE
.sp
Použití jiných verzí
\fBmkvmerge\fR(1)
nebo jiných voleb příkazového řádku může vést ke stejnému bajtově shodnému souboru, není to však zaručeno\&.
.RE
.PP
\fB\-\-debug\fR \fItopic\fR
.RS 4
Zapne ladění určité funkce\&. Tato volba je užitečná pouze pro vývojáře\&.
.RE
.PP
\fB\-\-engage\fR \fIfeature\fR
.RS 4
Zapne experimentální funkce\&. Seznam dostupných funkcí lze vyžádat příkazem
\fBmkvmerge \-\-engage list\fR\&. Tyto funkce nejsou určeny pro běžné použití\&.
.RE
.PP
\fB\-\-gui\-mode\fR
.RS 4
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 \*(Aq#GUI#message\*(Aq\&. Za zprávou mohou následovat dvojice klíč/hodnota jako v \*(Aq#GUI#message#key1=value1#key2=value2\&...\*(Aq\&. Zprávy ani klíče se nikdy nepřekládají a vždy jsou vypisovány anglicky\&.
.RE
.PP
\fB@\fR\fIoptions\-file\&.json\fR
.RS 4
Načte další argumenty příkazového řádku ze souboru
\fIoptions\-file\fR\&. Další informace najdete v oddílu o
souborech voleb\&.
.sp
Chcete\-li použít znak
@
jako první znak argumentu volby, například \*(Aq\-\-title\*(Aq, musíte jej zdvojit přidáním druhého znaku
@\&. Příklad:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o midnight\-s01e01\&.mkv \-\-title @@midnight midnight\-s01e01\&.mp4
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-\-capabilities\fR
.RS 4
Vypíše informace o volitelných funkcích zahrnutých při kompilaci a skončí\&. První řádek výstupu bude obsahovat informace o verzi\&. Každý následující řádek bude obsahovat právě jedno slovo, jehož přítomnost označuje, že daná funkce byla zahrnuta při kompilaci\&. Jde o tyto funkce:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\*(AqFLAC\*(Aq \-\- čtení samostatných souborů
FLAC
a zpracování stop
FLAC
v jiných kontejnerech, např\&.
Ogg(TM)
nebo
Matroska(TM)\&.
.RE
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Zobrazí informace o použití a ukončí se\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
Zobrazí informace o verzi a ukončí se\&.
.RE
.SH "POUžITí"
.PP
U každého souboru může uživatel vybrat, které stopy má
\fBmkvmerge\fR(1)
převzít\&. Všechny se vloží do souboru zadaného volbou
\fB\-o\fR\&. Seznam známých (a podporovaných) zdrojových formátů lze získat volbou
\fB\-l\fR\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBImportant\fR
.ps -1
.br
.PP
Pořadí voleb příkazového řádku je důležité\&. Pokud program používáte poprvé, přečtěte si oddíl
"Pořadí voleb"\&.
.sp .5v
.RE
.SH "POřADí VOLEB"
.PP
Pořadí, v němž se zadávají volby, je u některých voleb důležité\&. Volby spadají do dvou kategorií:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Volby, které ovlivňují celý program a nejsou svázány s žádným vstupním souborem\&. Patří mezi ně mimo jiné
\fB\-\-command\-line\-charset\fR,
\fB\-\-output\fR
nebo
\fB\-\-title\fR\&. Na příkazovém řádku mohou být uvedeny kdekoli\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Volby, které ovlivňují jeden vstupní soubor nebo jednu stopu ve vstupním souboru\&. Všechny tyto volby platí pro následující vstupní soubor na příkazovém řádku\&. Všechny volby platné pro stejný vstupní soubor (nebo pro stopy ze stejného vstupního souboru) lze zapsat v libovolném pořadí, pokud jsou všechny uvedeny před názvem tohoto vstupního souboru\&. Příklady voleb platných pro vstupní soubor jsou
\fB\-\-no\-chapters\fR
nebo
\fB\-\-chapter\-charset\fR\&. Příklady voleb platných pro jednu stopu jsou
\fB\-\-default\-duration\fR
nebo
\fB\-\-language\fR\&.
.RE
.PP
Volby se zpracovávají zleva doprava\&. Objeví\-li se volba ve stejném rozsahu vícekrát, použije se její poslední výskyt\&. V následujícím příkladu se proto název nastaví na "Something else":
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o output\&.mkv \-\-title \*(AqThis and that\*(Aq input\&.avi \-\-title \*(AqSomething else\*(Aq
.fi
.if n \{\
.RE
.\}
.PP
Následující příklad ukazuje, že dvojí použití volby
\fB\-\-language\fR
je v pořádku, protože je použita v různých rozsazích\&. Přestože se obě použití vztahují ke stejnému ID stopy, platí pro různé vstupní soubory, a mají proto různé rozsahy:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o output\&.mkv \-\-language 0:fre français\&.ogg \-\-language 0:deu deutsch\&.ogg
.fi
.if n \{\
.RE
.\}
.SH "PříKLADY"
.PP
Předpokládejme, že máte soubor MyMovie\&.avi a zvukovou stopu v samostatném souboru, např\&. \*(AqMyMovie\&.wav\*(Aq\&. Nejprve chcete zvuk zakódovat do
OggVorbis(TM):
.sp
.if n \{\
.RS 4
.\}
.nf
$ oggenc \-q4 \-oMyMovie\&.ogg MyMovie\&.wav
.fi
.if n \{\
.RE
.\}
.PP
Po několika minutách můžete spojit video a zvuk:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o MyMovie\-with\-sound\&.mkv MyMovie\&.avi MyMovie\&.ogg
.fi
.if n \{\
.RE
.\}
.PP
Obsahuje\-li váš soubor
AVI
již zvukovou stopu, zkopíruje se také (pokud
\fBmkvmerge\fR(1)
daný zvukový formát podporuje)\&. Chcete\-li tomu zabránit, jednoduše použijte
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o MyMovie\-with\-sound\&.mkv \-A MyMovie\&.avi MyMovie\&.ogg
.fi
.if n \{\
.RE
.\}
.PP
Po chvíli přemýšlení vyextrahujete další zvukovou stopu, například komentář režiséra nebo stopu v jiném jazyce, do souboru \*(AqMyMovie\-add\-audio\&.wav\*(Aq\&. Znovu ji zakódujte a spojte s druhým souborem:
.sp
.if n \{\
.RS 4
.\}
.nf
$ oggenc \-q4 \-oMyMovie\-add\-audio\&.ogg MyMovie\-add\-audio\&.wav
$ mkvmerge \-o MM\-complete\&.mkv MyMovie\-with\-sound\&.mkv MyMovie\-add\-audio\&.ogg
.fi
.if n \{\
.RE
.\}
.PP
Stejného výsledku lze dosáhnout pomocí
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o MM\-complete\&.mkv \-A MyMovie\&.avi MyMovie\&.ogg MyMovie\-add\-audio\&.ogg
.fi
.if n \{\
.RE
.\}
.PP
Nyní spusťte
mplayer(TM)
a užívejte si výsledek\&. Máte\-li více zvukových stop (nebo dokonce video stop), můžete programu
mplayer(TM)
volbami \*(Aq\fB\-vid\fR\*(Aq a \*(Aq\fB\-aid\fR\*(Aq určit, kterou stopu má přehrát\&. Číslování začíná od 0 a nerozlišuje mezi videem a zvukem\&.
.PP
Potřebujete\-li zvukovou stopu synchronizovat, lze to snadno provést\&. Nejprve zjistěte ID stopy Vorbis pomocí
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-\-identify outofsync\&.ogg
.fi
.if n \{\
.RE
.\}
.PP
Nyní můžete toto ID použít v následujícím příkazovém řádku:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o goodsync\&.mkv \-A source\&.avi \-y 12345:200 outofsync\&.ogg
.fi
.if n \{\
.RE
.\}
.PP
Tím by se na začátek zvukové stopy s ID
\fB12345\fR
převzaté ze souboru \*(Aqoutofsync\&.ogg\*(Aq přidalo 200 ms ticha\&.
.PP
Některé filmy začínají správně synchronizované, ale postupně se rozcházejí\&. Pro takové filmy lze zadat faktor zpoždění, který se použije na všechna časová razítka \-\- žádná data se nepřidají ani neodeberou\&. Je\-li faktor příliš velký nebo příliš malý, bude výsledek chybný\&. Například jedna mnou překódovaná epizoda byla
\fB0\&.2\fR
sekundy mimo synchronizaci na konci filmu, který měl
\fB77340\fR
snímků\&. Při
\fB29\&.97fps\fR
odpovídá
\fB0\&.2\fR
sekundy přibližně
\fB6\fR
snímkům\&. Použil jsem tedy
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o goodsync\&.mkv \-y 23456:0,77346/77340 outofsync\&.mkv
.fi
.if n \{\
.RE
.\}
.PP
Výsledek byl v pořádku\&.
.PP
Volby synchronizace lze stejným způsobem použít i pro titulky\&.
.PP
Pro textové titulky můžete použít buď některý program pro Windows (například
SubRipper(TM)), nebo balíček
subrip(TM), který se nachází ve zdrojích programu
\fBtranscode\fR(1)
v adresáři \*(Aqcontrib/subrip\*(Aq\&. Obecný postup je následující:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
extrahovat ze zdroje nezpracovaný proud titulků:
.sp
.if n \{\
.RS 4
.\}
.nf
$ tccat \-i /path/to/copied/dvd/ \-T 1 \-L | tcextract \-x ps1 \-t vob \-a 0x20 | subtitle2pgm \-o mymovie
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
převést výsledné obrázky PGM na text pomocí gocr:
.sp
.if n \{\
.RS 4
.\}
.nf
$ pgm2txt mymovie
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
zkontrolovat pravopis výsledných textových souborů:
.sp
.if n \{\
.RS 4
.\}
.nf
$ ispell \-d american *txt
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
převést textové soubory na soubor SRT:
.sp
.if n \{\
.RS 4
.\}
.nf
$ srttool \-s \-w \-i mymovie\&.srtx \-o mymovie\&.srt
.fi
.if n \{\
.RE
.\}
.RE
.PP
Výsledný soubor lze použít jako další vstupní soubor pro
\fBmkvmerge\fR(1):
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o mymovie\&.mkv mymovie\&.avi mymovie\&.srt
.fi
.if n \{\
.RE
.\}
.PP
Chcete\-li zadat jazyk určité stopy, lze to snadno provést\&. Nejprve zjistěte kód ISO 639\-2 svého jazyka\&.
\fBmkvmerge\fR(1)
vám může všechny tyto kódy vypsat:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-\-list\-languages
.fi
.if n \{\
.RE
.\}
.PP
Vyhledejte v seznamu potřebné jazyky\&. Předpokládejme, že jste do souboru
Matroska(TM)
vložili dvě zvukové stopy, chcete nastavit jejich jazykové kódy a jejich ID stop jsou 2 a 3\&. Lze to provést příkazem
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o with\-lang\-codes\&.mkv \-\-language 2:ger \-\-language 3:dut without\-lang\-codes\&.mkv
.fi
.if n \{\
.RE
.\}
.PP
Jak vidíte, volbu
\fB\-\-language\fR
lze použít vícekrát\&.
.PP
Možná také chcete, aby přehrávač ve výchozím nastavení používal nizozemštinu\&. Máte rovněž další titulky, například anglické a francouzské, a chcete, aby přehrávač ve výchozím nastavení zobrazoval francouzské\&. Lze to provést příkazem
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o with\-lang\-codes\&.mkv \-\-language 2:ger \-\-language 3:dut \-\-default\-track\-flag 3 without\-lang\-codes\&.mkv \-\-language 0:eng english\&.srt \-\-default\-track\-flag 0 \-\-language 0:fre french\&.srt
.fi
.if n \{\
.RE
.\}
.PP
Nevidíte\-li ve výstupu
\fBmkvinfo\fR(1)
zadané příznaky jazyka nebo výchozí stopy, přečtěte si oddíl o
výchozích hodnotách\&.
.PP
Vypne kompresi pro vstupní soubor\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o no\-compression\&.mkv \-\-compression \-1:none MyMovie\&.avi \-\-compression \-1:none mymovie\&.srt
.fi
.if n \{\
.RE
.\}
.SH "ID STOP"
.SS "Běžná ID stop"
.PP
Některé volby
\fBmkvmerge\fR(1)
vyžadují ID stopy k určení, na kterou stopu se mají použít\&. Tato ID stop vypisují čtečky při demultiplexování aktuálního vstupního souboru nebo se vypíší při spuštění
\fBmkvmerge\fR(1)
s volbou
\fB\-\-identify\fR\&. Příklad takového výstupu:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-i v\&.mkv
File \*(Aqv\&.mkv\*(Aq: container: Matroska(TM)
Track ID 0: video (V_MS/VFW/FOURCC, DIV3)
Track ID 1: audio (A_MPEG/L3)
.fi
.if n \{\
.RE
.\}
.PP
Nezaměňujte ID přiřazená stopám vkládaným do výstupního souboru MKV s ID stop vstupních souborů\&. Pro volby vyžadující tyto hodnoty se používají pouze ID stop vstupních souborů\&.
.PP
Každý vstupní soubor má navíc vlastní sadu ID stop\&. ID stop souboru \*(Aqfile1\&.ext\*(Aq oznámená příkazem \*(Aqmkvmerge \-\-identify\*(Aq se proto nemění bez ohledu na počet ostatních vstupních souborů nebo pozici, na které je \*(Aqfile1\&.ext\*(Aq použit\&.
.PP
ID stop se přiřazují takto:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Soubory
AVI: video stopa má ID 0\&. Zvukové stopy dostávají ID vzestupně od 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Soubory
AAC,
AC\-3,
MP3,
SRT
a
WAV: jediná \*(Aqstopa\*(Aq v takovém souboru dostane ID 0\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Většina ostatních souborů: ID stop se přiřazují v pořadí, v jakém se stopy v souboru najdou, od 0\&.
.RE
.PP
ID stop se používají u voleb, jejichž popis obsahuje \*(AqTID\*(Aq\&. Používají je také následující volby:
\fB\-\-audio\-tracks\fR,
\fB\-\-video\-tracks\fR,
\fB\-\-subtitle\-tracks\fR,
\fB\-\-button\-tracks\fR
a
\fB\-\-track\-tags\fR\&.
.SS "Zvláštní ID stop"
.PP
Existuje několik ID se zvláštním významem, která se nevyskytují ve výstupu identifikace\&.
.PP
Zvláštní ID stopy \*(Aq\fB\-1\fR\*(Aq je zástupný znak a použije zadanou volbu na všechny stopy načtené ze vstupního souboru\&.
.PP
Zvláštní ID stopy \*(Aq\fB\-2\fR\*(Aq odkazuje na kapitoly ve zdrojovém souboru\&. Toto zvláštní ID v současnosti používá pouze volba
\fB\-\-sync\fR\&. Jako alternativu k
\fB\-\-sync \-2:\&...\fR
lze použít volbu
\fB\-\-chapter\-sync \&...\fR\&.
.SH "ZPRACOVáNí JAZYKů"
.PP
Matroska(TM)
podporuje dva různé typy jazykových prvků: starý, zastaralý prvek "Language" obsahující třípísmenné kódy ISO 639\-2 a nové značky "LanguageIETF" obsahující jazykové značky IETF BCP 47\&. Všechny volby
\fBmkvmerge\fR(1), které přijímají jazyk, přijímají jazykovou značku BCP 47\&. Kdykoli je to možné,
\fBmkvmerge\fR(1)
odvodí hodnotu zastaralého prvku "Language" z jazykových značek BCP 47\&.
.PP
Při identifikaci souboru v režimu JSON se existující prvky "LanguageIETF" v hlavičkách stop vypíší jako vlastnost stopy
language_ietf\&.
.PP
Při zápisu souboru
\fBmkvmerge\fR(1)
vždy zapíše prvky "LanguageIETF", "ChapLanguageIETF" a "TagLanguageIETF" (poslední dva pouze tehdy, zapisují\-li se kapitoly, respektive štítky)\&. Vedle těchto prvků se zapíší odpovídající staré prvky, které budou nastaveny na část jazykové značky BCP 47 tvořenou kódem ISO 639\-2\&. Je\-li například jazyk stopy nastaven na
sr\-Cyrl\-RS, "LanguageIETF" se nastaví na
sr\-Cyrl\-RS
a starý prvek "Language" na
srp\&.
.PP
Při čtení existujících souborů (souborů Matroska, souborů kapitol nebo štítků XML atd\&.), které již obsahují prvky "\&...LanguageIETF", se tyto prvky zachovají\&. Jinak se prvky "\&...LanguageIETF" přidají na základě voleb příkazového řádku a ostatních existujících zastaralých prvků "\&...Language"\&.
.PP
Vytváření nových prvků lze zcela zakázat volbou příkazového řádku
\fB\-\-disable\-language\-ietf\fR, která působí na všechny tři nové prvky\&.
.PP
Parametrem
\fB\-\-normalize\-language\-ietf\fR
lze zvolit metodu normalizace používanou pro rozšířené jazykové podznačky\&.
.SH "TEXTOVé SOUBORY A PřEVODY ZNAKOVýCH SAD"
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
Tento oddíl platí pro všechny programy v MKVToolNix, i když zmiňuje pouze
\fBmkvmerge\fR(1)\&.
.sp .5v
.RE
.SS "Úvod"
.PP
Veškerý text v souboru
Matroska(TM)
je kódován v UTF\-8\&.
\fBmkvmerge\fR(1)
proto musí převádět každý načtený textový soubor i každý text zadaný na příkazovém řádku z určité znakové sady do UTF\-8\&. Zároveň to znamená, že výstup
\fBmkvmerge\fR(1)
musí být z UTF\-8 převeden zpět do této znakové sady, například při použití jiného než anglického překladu s volbou
\fB\-\-ui\-language\fR
nebo u textu pocházejícího ze souboru
Matroska(TM)\&.
.PP
\fBmkvmerge\fR(1)
tento převod provádí automaticky podle přítomnosti značky pořadí bajtů (zkráceně
BOM) nebo aktuálního národního prostředí systému\&. Způsob odvození znakové sady z národního prostředí závisí na operačním systému, na kterém
\fBmkvmerge\fR(1)
běží\&.
.SS "Značky pořadí bajtů (BOM)"
.PP
Textové soubory začínající značkou BOM jsou již zakódovány v některé reprezentaci UTF\&.
\fBmkvmerge\fR(1)
podporuje následujících pět režimů: UTF\-8, UTF\-16 s pořadím bajtů Little Endian a Big Endian a UTF\-32 s pořadím bajtů Little Endian a Big Endian\&. Textové soubory s BOM se automaticky převádějí do UTF\-8\&. Všechny parametry, které by jinak nastavovaly znakovou sadu takového souboru (např\&.
\fB\-\-sub\-charset\fR), se bez upozornění ignorují\&.
.SS "Linux a systémy podobné Unixu včetně macOS"
.PP
Na systémech podobných Unixu používá
\fBmkvmerge\fR(1)
systémové volání
\fBsetlocale\fR(3), které používá proměnné prostředí
\fILANG\fR,
\fILC_ALL\fR
a
\fILC_CTYPE\fR\&. Výslednou znakovou sadou je často UTF\-8 nebo některá ze sady ISO\-8859\-*; používá se pro všechny operace s textovými soubory, pro kódování řetězců na příkazovém řádku i pro výstup do konzole\&.
.SS "Windows"
.PP
V systému Windows se výchozí znaková sada používaná k převodu textových souborů určuje voláním systémové funkce
\fBGetACP()\fR\&.
.PP
Příkazový řádek se načítá funkcí
\fBGetCommandLineW()\fR, která již vrací řetězec Unicode\&. Volba
\fB\-\-command\-line\-charset\fR
se proto v systému Windows ignoruje\&.
.PP
Při výstupu do konzole nastávají tři případy:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Je\-li výstup přesměrován volbou
\fB\-\-redirect\-output\fR, je výchozí znakovou sadou UTF\-8\&. Lze ji změnit volbou
\fB\-\-output\-charset\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Je\-li výstup přesměrován samotným programem
\fBcmd\&.exe\fR, např\&. pomocí
mkvinfo file\&.mkv > info\&.txt, je znakovou sadou vždy UTF\-8 a nelze ji změnit\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
Jinak (při zápisu přímo do konzole) se používá funkce Windows
\fBWriteConsoleW()\fR
a volba
\fB\-\-output\-charset\fR
se ignoruje\&. Konzole by měla umět vypsat všechny znaky Unicode, pro něž je nainstalována odpovídající jazyková podpora (např\&. čínské znaky se nemusí zobrazit v anglických verzích Windows)\&.
.RE
.SS "Volby příkazového řádku"
.PP
Pro zadání znakových sad jsou k dispozici následující volby:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-sub\-charset\fR
pro textové soubory titulků a pro textové titulkové stopy uložené v kontejnerových formátech, u nichž nelze znakovou sadu jednoznačně určit (např\&. soubory Ogg),
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-chapter\-charset\fR
pro textové soubory kapitol a pro kapitoly a názvy souborů uložené v kontejnerových formátech, u nichž nelze znakovou sadu jednoznačně určit (např\&. soubory Ogg pro informace o kapitolách, názvy stop a souborů atd\&.; soubory MP4 pro informace o kapitolách),
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-command\-line\-charset\fR
pro všechny řetězce na příkazovém řádku,
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-output\-charset\fR
pro všechny řetězce zapisované do konzole nebo do souboru, je\-li výstup přesměrován volbou
\fB\-\-redirect\-output\fR\&. Na systémech jiných než Windows je výchozí znakovou sadou výstupu aktuální znaková sada systému\&. V systému Windows je výchozí UTF\-8 jak při přesměrování volbou
\fB\-\-redirect\-output\fR, tak při přesměrování samotným programem
\fBcmd\&.exe\fR, např\&.
mkvinfo file\&.mkv > info\&.txt\&.
.RE
.SH "SOUBORY VOLEB"
.PP
Soubor voleb je soubor, ze kterého může
\fBmkvmerge\fR(1)
načíst další argumenty příkazového řádku\&. Lze jím obejít určitá omezení shellu nebo operačního systému při spouštění externích programů, například omezenou délku příkazového řádku\&.
.PP
Soubor voleb obsahuje data ve formátu JSON\&. Jeho obsah musí být platné pole JSON tvořené výhradně řetězci JSON\&. Soubor musí být kódován v UTF\-8\&. Neměl by začínat značkou pořadí bajtů (BOM), je\-li však přítomna, přeskočí se\&.
.PP
Pravidla pro uvozování zvláštních znaků uvnitř JSON stanovuje oficiální specifikace JSON,
\m[blue]\fBRFC 7159\fR\m[]\&\s-2\u[4]\d\s+2\&.
.PP
Samotný název souboru voleb musí být zadán jako argument příkazového řádku s předponou tvořenou znakem \*(Aq@\*(Aq\&.
.PP
Příkazový řádek \*(Aq\fBmkvmerge \-o "my file\&.mkv" \-A "a movie\&.avi" sound\&.ogg\fR\*(Aq lze převést na následující soubor voleb JSON nazvaný například \*(Aqoptions\&.json\*(Aq:
.sp
.if n \{\
.RS 4
.\}
.nf
[
  "\-o",
  "c:\e\eMatroska\e\emy file\&.mkv",
  "\-\-title",
  "#65",
  "\-A",
  "a movie\&.avi",
  "sound\&.ogg"
]
.fi
.if n \{\
.RE
.\}
.PP
Odpovídající příkaz by potom byl \*(Aq\fBmkvmerge @options\&.json\fR\*(Aq\&.
.SH "PROPOJOVáNí SOUBORů"
.PP
Matroska(TM)
podporuje propojování souborů, jímž se jednoduše určuje, že určitý soubor je předchůdcem nebo následníkem aktuálního souboru\&. Přesněji řečeno nejsou ve skutečnosti propojeny soubory, ale úseky
Matroska(TM)\&. Protože většina souborů bude pravděpodobně obsahovat pouze jeden úsek
Matroska(TM), používají následující vysvětlení pojem \*(Aqpropojování souborů\*(Aq, přestože přesnější by bylo \*(Aqpropojování úseků\*(Aq\&.
.PP
Každý úsek je identifikován jedinečným 128bitovým UID úseku\&. Toto UID automaticky vytváří
\fBmkvmerge\fR(1)\&. Propojení se provádí především vložením UID úseků (zkráceně
SID) předchozího/následujícího souboru do informací v hlavičce úseku\&.
\fBmkvinfo\fR(1)
tyto identifikátory
SIDs
vypíše, pokud je najde\&.
.PP
Je\-li soubor rozdělen na několik menších a použije se propojování, časová razítka nezačnou znovu od 0, ale pokračují od místa, kde skončil předchozí soubor\&. Tím se zachová absolutní čas, i když předchozí soubory nejsou dostupné (např\&. při streamování)\&. Není\-li propojování použito, měla by časová razítka každého souboru začínat od 0\&. Ve výchozím nastavení
\fBmkvmerge\fR(1)
propojování souborů nepoužívá\&. Chcete\-li je použít, můžete je zapnout volbou
\fB\-\-link\fR\&. Tato volba má význam pouze tehdy, je\-li aktivováno také rozdělení\&.
.PP
Bez ohledu na to, zda je rozdělení aktivní, může uživatel programu
\fBmkvmerge\fR(1)
určit, aby vytvořené soubory propojil s konkrétními
SIDs\&. K tomu slouží volby
\fB\-\-link\-to\-previous\fR
a
\fB\-\-link\-to\-next\fR\&. Tyto volby přijímají
SID
úseku ve formátu vypisovaném programem
\fBmkvinfo\fR(1): 16 šestnáctkových čísel mezi
\fB0x00\fR
a
\fB0xff\fR, z nichž každé má předponu \*(Aq0x\*(Aq, např\&. \*(Aq0x41 0xda 0x73 0x66 0xd9 0xcf 0xb2 0x1e 0xae 0x78 0xeb 0xb4 0x5e 0xca 0xb3 0x93\*(Aq\&. Alternativně lze použít kratší podobu: 16 šestnáctkových čísel mezi
\fB0x00\fR
a
\fB0xff\fR
bez předpon \*(Aq0x\*(Aq a bez mezer, např\&. \*(Aq41da7366d9cfb21eae78ebb45ecab393\*(Aq\&.
.PP
Je\-li použito rozdělení, první soubor se propojí s
SID
zadaným volbou
\fB\-\-link\-to\-previous\fR
a poslední soubor s
SID
zadaným volbou
\fB\-\-link\-to\-next\fR\&. Není\-li rozdělení použito, jediný výstupní soubor se propojí s oběma identifikátory
SIDs\&.
.SH "VýCHOZí HODNOTY"
.PP
Specifikace
Matroska(TM)
stanovuje pro některé prvky výchozí hodnotu\&. Je\-li hodnota prvku rovna jeho výchozí hodnotě, prvek se do souboru obvykle nezapisuje, aby se šetřilo místem\&. Prvky, které může uživatel postrádat ve výstupu
\fBmkvinfo\fR(1), jsou
\fIlanguage\fR
a
\fIdefault track flag\fR\&. Výchozí hodnotou prvku
\fIlanguage\fR
je angličtina (\*(Aqeng\*(Aq) a výchozí hodnotou prvku
\fIdefault track flag\fR
je
\fItrue\fR\&. Použijete\-li tedy pro stopu
\fB\-\-language 0:eng\fR, ve výstupu
\fBmkvinfo\fR(1)
se neobjeví\&.
.SH "PříLOHY"
.PP
Možná chcete se souborem
Matroska(TM)
uchovat také fotografie nebo používáte titulky
SSA
a potřebujete zvláštní, velmi vzácné písmo
TrueType(TM)\&. V takových případech lze tyto soubory přiložit k souboru
Matroska(TM)\&. Nebudou k souboru pouze připojeny, ale vloží se do něj\&. Přehrávač pak může tyto soubory zobrazit (v případě \*(Aqfotografií\*(Aq) nebo je použít k vykreslení titulků (v případě \*(Aqpísem
TrueType(TM)\*(Aq)\&.
.PP
Zde je příklad, jak k výstupnímu souboru přiložit fotografii a písmo
TrueType(TM):
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o output\&.mkv \-A video\&.avi sound\&.ogg \e
  \-\-attachment\-description "Me and the band behind the stage in a small get\-together" \e
  \-\-attachment\-mime\-type image/jpeg \e
  \-\-attach\-file me_and_the_band\&.jpg \e
  \-\-attachment\-description "The real rare and unbelievably good looking font" \e
  \-\-attachment\-mime\-type application/octet\-stream \e
  \-\-attach\-file really_cool_font\&.ttf
.fi
.if n \{\
.RE
.\}
.PP
Je\-li jako vstupní soubor použit soubor
Matroska(TM)
obsahující přílohy,
\fBmkvmerge\fR(1)
zkopíruje přílohy do nového souboru\&. Výběr příloh, které se mají zkopírovat a které nikoli, lze změnit volbami
\fB\-\-attachments\fR
a
\fB\-\-no\-attachments\fR\&.
.SH "KAPITOLY"
.PP
Systém kapitol
Matroska(TM)
je propracovanější než starší zavedený systém používaný v souborech
OGM\&. Úplnou specifikaci najdete na
\m[blue]\fBwebu Matroska(TM)\fR\m[]\&\s-2\u[1]\d\s+2\&.
.PP
\fBmkvmerge\fR(1)
podporuje jako vstup dva druhy souborů kapitol\&. První formát, nazývaný \(Bqjednoduchý formát kapitol\(lq, je stejný jako formát očekávaný nástroji
OGM\&. Druhý je formát kapitol založený na
XML, který podporuje všechny funkce kapitol
Matroska(TM)\&.
.PP
Kromě samostatných souborů kapitol umí
\fBmkvmerge\fR(1)
načítat kapitoly také z jiných formátů souborů (např\&. MP4, Ogg, Blu\-ray nebo DVD)\&.
.SS "Jednoduchý formát kapitol"
.PP
Tento formát se skládá z dvojic řádků začínajících v tomto pořadí \*(AqCHAPTERxx=\*(Aq a \*(AqCHAPTERxxNAME=\*(Aq\&. První obsahuje počáteční časové razítko a druhý název\&. Příklad:
.sp
.if n \{\
.RS 4
.\}
.nf
CHAPTER01=00:00:00\&.000
CHAPTER01NAME=Intro
CHAPTER02=00:02:30\&.000
CHAPTER02NAME=Baby prepares to rock
CHAPTER03=00:02:42\&.300
CHAPTER03NAME=Baby rocks the house
.fi
.if n \{\
.RE
.\}
.PP
\fBmkvmerge\fR(1)
převede každou dvojici řádků na jeden prvek
Matroska(TM)
ChapterAtom\&. Nenastaví žádný prvek
ChapterTrackNumber, což znamená, že všechny kapitoly platí pro všechny stopy v souboru\&.
.PP
Protože jde o textový soubor, může být nutný převod znakové sady\&. Vysvětlení převodu mezi znakovými sadami v programu
\fBmkvmerge\fR(1)
najdete v oddílu o
textových souborech a znakových sadách\&.
.SS "Formát kapitol založený na XML"
.PP
Formát kapitol založený na
XML
vypadá jako v následujícím příkladu:
.sp
.if n \{\
.RS 4
.\}
.nf
<?xml version="1\&.0" encoding="ISO\-8859\-1"?>
<!DOCTYPE Chapters SYSTEM "matroskachapters\&.dtd">
<Chapters>
  <EditionEntry>
    <ChapterAtom>
      <ChapterTimeStart>00:00:30\&.000</ChapterTimeStart>
      <ChapterTimeEnd>00:01:20\&.000</ChapterTimeEnd>
      <ChapterDisplay>
        <ChapterString>A short chapter</ChapterString>
        <ChapterLanguage>eng</ChapterLanguage>
      </ChapterDisplay>
      <ChapterAtom>
        <ChapterTimeStart>00:00:46\&.000</ChapterTimeStart>
        <ChapterTimeEnd>00:01:10\&.000</ChapterTimeEnd>
        <ChapterDisplay>
          <ChapterString>A part of that short chapter</ChapterString>
          <ChapterLanguage>eng</ChapterLanguage>
        </ChapterDisplay>
      </ChapterAtom>
    </ChapterAtom>
  </EditionEntry>
</Chapters>
.fi
.if n \{\
.RE
.\}
.PP
Tento formát umožňuje tři věci, které v jednoduchém formátu kapitol možné nejsou:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
lze nastavit časové razítko konce kapitoly,
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
kapitoly lze vnořovat,
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
lze nastavit jazyk a zemi\&.
.RE
.PP
Distribuce MKVToolNix obsahuje v podadresáři
doc
několik ukázkových souborů, které lze použít jako základ\&.
.PP
Následující seznam uvádí podporované značky XML, jejich datové typy a případně platný rozsah jejich hodnot:
.sp
.if n \{\
.RS 4
.\}
.nf
Chapters (hlavní)
  EditionEntry (hlavní)
    EditionUID (celé číslo bez znaménka, platný rozsah: 1 <= hodnota)
    EditionFlagHidden (celé číslo bez znaménka, platný rozsah: 0 <= hodnota <= 1)
    EditionFlagDefault (celé číslo bez znaménka, platný rozsah: 0 <= hodnota <= 1)
    EditionFlagOrdered (celé číslo bez znaménka, platný rozsah: 0 <= hodnota <= 1)
    ChapterAtom (hlavní)
      ChapterAtom (hlavní)
      ChapterUID (celé číslo bez znaménka, platný rozsah: 1 <= hodnota)
      ChapterTimeStart (celé číslo bez znaménka)
      ChapterTimeEnd (celé číslo bez znaménka)
      ChapterFlagHidden (celé číslo bez znaménka, platný rozsah: 0 <= hodnota <= 1)
      ChapterFlagEnabled (celé číslo bez znaménka, platný rozsah: 0 <= hodnota <= 1)
      ChapterSegmentUID (binární, platný rozsah: 1 <= délka v bajtech)
      ChapterSegmentEditionUID (celé číslo bez znaménka, platný rozsah: 1 <= hodnota)
      ChapterPhysicalEquiv (celé číslo bez znaménka)
      ChapterTrack (hlavní)
        ChapterTrackNumber (celé číslo bez znaménka, platný rozsah: 1 <= hodnota)
      ChapterDisplay (hlavní)
        ChapterString (řetězec UTF\-8)
        ChapterLanguage (řetězec UTF\-8)
        ChapterCountry (řetězec UTF\-8)
      ChapterProcess (hlavní)
        ChapterProcessCodecID (celé číslo bez znaménka)
        ChapterProcessPrivate (binární)
        ChapterProcessCommand (hlavní)
          ChapterProcessTime (celé číslo bez znaménka)
          ChapterProcessData (binární)
.fi
.if n \{\
.RE
.\}
.SS "Načítání kapitol z disků Blu\-ray"
.PP
\fBmkvmerge\fR(1)
umí načítat kapitoly z nešifrovaných disků Blu\-ray\&. K tomu lze parametru
\fI\-\-chapters\fR
předat cestu k některému seznamu stop MPLS\&.
.PP
Příklad:
\-\-chapters /srv/blurays/BigBuckBunny/BDMV/PLAYLIST/00001\&.mpls
.SS "Načítání kapitol z disků DVD"
.PP
Je\-li MKVToolNix zkompilován s knihovnou
libdvdread(TM), umí
\fBmkvmerge\fR(1)
načítat kapitoly z disků DVD\&. K tomu lze parametru
\fI\-\-chapters\fR
předat cestu k některému adresáři nebo souboru na DVD\&. Protože DVD může obsahovat více titulů a každý titul má vlastní sadu kapitol, lze na konec argumentu s názvem souboru připojit dvojtečku a požadované číslo titulu\&. Výchozí číslo titulu je 1\&.
.PP
Příklad:
\-\-chapters /srv/dvds/BigBuckBunny/VIDEO_TS:2
.SS "Obecné poznámky"
.PP
Při rozdělení souborů
\fBmkvmerge\fR(1)
správně upraví také kapitoly\&. Každý soubor tedy obsahuje pouze položky kapitol, které se na něj vztahují, a časová razítka se posunou tak, aby odpovídala novým časovým razítkům jednotlivých výstupních souborů\&.
.PP
\fBmkvmerge\fR(1)
umí kopírovat kapitoly ze zdrojových souborů
Matroska(TM), pokud to není výslovně zakázáno volbou
\fB\-\-no\-chapters\fR\&. Kapitoly ze všech zdrojů (souborů
Matroska(TM), souborů Ogg, souborů
MP4
a textových souborů kapitol) se obvykle neslučují, ale skončí v samostatných prvcích
ChapterEditions\&. Pouze pokud jsou kapitoly načteny z několika souborů
Matroska(TM)
nebo
XML, které sdílejí stejná UID edic, sloučí se do jediného prvku
ChapterEdition\&. Je\-li takové sloučení požadováno i v jiných případech, musí uživatel nejprve pomocí
\fBmkvextract\fR(1)
extrahovat kapitoly ze všech zdrojů, ručně sloučit soubory
XML
a poté je multiplexovat\&.
.SH "ŠTíTKY"
.SS "Úvod"
.PP
Systém štítků
Matroska(TM)
je podobný systémům jiných kontejnerů: jde o sadu dvojic
\fIKEY=VALUE\fR\&. V
Matroska(TM)
však mohou být tyto štítky také vnořené a
\fIKEY\fR
i
\fIVALUE\fR
jsou samostatné prvky\&. Ukázkový soubor
example\-tags\-2\&.xml
znázorňuje použití tohoto systému\&.
.SS "Rozsah platnosti štítků"
.PP
Štítky
Matroska(TM)
se automaticky nevztahují na celý soubor\&. Mohou se na něj vztahovat, ale mohou se také vztahovat na různé části souboru: na jednu či více stop, jednu či více kapitol, nebo dokonce na kombinaci obojího\&. Další podrobnosti uvádí
\m[blue]\fBspecifikace Matroska(TM)\fR\m[]\&\s-2\u[5]\d\s+2\&.
.PP
Důležité je, že štítky jsou se stopami nebo kapitolami propojeny prostřednictvím prvku štítku
Matroska(TM)
Targets
a že UID použitá k tomuto propojení
\fInejsou\fR
ID stop, která
\fBmkvmerge\fR(1)
používá na jiných místech\&. Používají se naopak UID, která
\fBmkvmerge\fR(1)
automaticky vypočítá (pochází\-li stopa z jiného formátu než
Matroska(TM)), nebo která zkopíruje ze zdrojového souboru, je\-li zdrojem stopy soubor
Matroska(TM)\&. Proto je obtížné před předáním souboru programu
\fBmkvmerge\fR(1)
zjistit, která UID v souboru štítků použít\&.
.PP
\fBmkvmerge\fR(1)
nabízí dvě volby pro přidávání štítků do souborů
Matroska(TM):
\fB\-\-global\-tags\fR
a
\fB\-\-tags\fR\&. Rozdíl spočívá v tom, že první volba,
\fB\-\-global\-tags\fR, odstraní všechny výše uvedené prvky
Targets, a štítky se proto budou vztahovat na celý soubor\&. Druhá volba,
\fB\-\-tags\fR, automaticky vloží UID, které
\fBmkvmerge\fR(1)
vytvoří pro stopu zadanou částí
\fITID\fR
volby
\fB\-\-tags\fR\&.
.SS "Příklad"
.PP
Předpokládejme, že chcete přidat štítky k video stopě načtené ze souboru
AVI\&. Příkaz
\fBmkvmerge \-\-identify file\&.avi\fR
oznámí, že ID video stopy (nezaměňujte toto ID s UID) je 0\&. Vytvoříte tedy soubor štítků, vynecháte všechny prvky
Targets
a spustíte
\fBmkvmerge\fR(1):
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \-o file\&.mkv \-\-tags 0:tags\&.xml file\&.avi
.fi
.if n \{\
.RE
.\}
.SS "Formát souboru štítků"
.PP
\fBmkvmerge\fR(1)
podporuje formát souboru štítků založený na
XML\&. Formát je velmi těsně odvozen od
\m[blue]\fBspecifikace Matroska(TM)\fR\m[]\&\s-2\u[5]\d\s+2\&. Binární i zdrojová distribuce MKVToolNix obsahují ukázkový soubor
example\-tags\-2\&.xml, který jednoduše uvádí všechny známé štítky a lze jej použít jako základ skutečných souborů štítků\&.
.PP
Základní pravidla:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Kořenovým prvkem musí být
<Tags>\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Jeden logický štítek je obsažen v jedné dvojici
<Tag>
značek
XML\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Bílé znaky bezprostředně před obsahem štítku a za ním se ignorují\&.
.RE
.SS "Datové typy"
.PP
Nový systém štítků
Matroska(TM)
zná pouze dva datové typy: řetězec UTF\-8 a binární typ\&. První se používá pro název štítku a prvek
<String>, zatímco binární typ se používá pro prvek
<Binary>\&.
.PP
Protože samotná binární data nelze vložit do souboru
XML, podporuje
\fBmkvmerge\fR(1)
dva jiné způsoby jejich uložení\&. Začíná\-li obsah značky
XML
znakem \*(Aq@\*(Aq, považuje se následující text za název souboru\&. Obsah odpovídajícího souboru se zkopíruje do prvku
Matroska(TM)\&.
.PP
Jinak se očekává, že data budou kódována pomocí Base64\&. Toto kódování převádí binární data na omezenou sadu znaků
ASCII
a používá se například v e\-mailových programech\&.
\fBmkvextract\fR(1)
vypíše binární prvky jako data kódovaná pomocí Base64\&.
.PP
Zastaralý systém štítků zná několik dalších datových typů, které jsou uvedeny v oficiální specifikaci štítků
Matroska(TM)\&. Protože
\fBmkvmerge\fR(1)
tento systém již nepodporuje, nejsou zde tyto typy popsány\&.
.SS "Známé značky pro formát souboru XML"
.PP
Následující seznam uvádí podporované značky XML, jejich datové typy a případně platný rozsah jejich hodnot:
.sp
.if n \{\
.RS 4
.\}
.nf
Tags (hlavní)
  Tag (hlavní)
    Targets (hlavní)
      TargetTypeValue (celé číslo bez znaménka)
      TargetType (řetězec UTF\-8)
      TrackUID (celé číslo bez znaménka)
      EditionUID (celé číslo bez znaménka)
      ChapterUID (celé číslo bez znaménka)
      AttachmentUID (celé číslo bez znaménka)
    Simple (hlavní)
      Simple (hlavní)
      Name (řetězec UTF\-8)
      TagLanguage (řetězec UTF\-8)
      DefaultLanguage (celé číslo bez znaménka)
      String (řetězec UTF\-8)
      Binary (binární)
.fi
.if n \{\
.RE
.\}
.SH "INFORMACE O úSEKU"
.PP
Pomocí souboru XML s informacemi o úseku lze nastavit určité hodnoty v poli hlavičky "informace o úseku" souboru
Matroska(TM)\&. Žádnou z těchto hodnot nelze nastavit jinými volbami příkazového řádku\&.
.PP
Jiná pole hlavičky "informace o úseku" lze nastavit volbami příkazového řádku, nikoli však souborem XML\&. Patří sem například volby
\fB\-\-title\fR
a
\fB\-\-timestamp\-scale\fR\&.
.PP
Některé další prvky nelze nastavit ani volbami příkazového řádku, ani soubory XML\&. Patří mezi ně následující prvky:
\fIDateUTC\fR
(známý také jako "datum multiplexování"),
\fIMuxingApp\fR,
\fIWritingApp\fR
a
\fIDuration\fR\&. Vždy je nastavuje samotný
\fBmkvmerge\fR(1)\&.
.PP
Následující seznam uvádí podporované značky XML, jejich datové typy a případně platný rozsah jejich hodnot:
.sp
.if n \{\
.RS 4
.\}
.nf
Info (hlavní)
  SegmentUID (binární, platný rozsah: délka v bajtech == 16)
  SegmentFilename (řetězec UTF\-8)
  PreviousSegmentUID (binární, platný rozsah: délka v bajtech == 16)
  PreviousSegmentFilename (řetězec UTF\-8)
  NextSegmentUID (binární, platný rozsah: délka v bajtech == 16)
  NextSegmentFilename (řetězec UTF\-8)
  SegmentFamily (binární, platný rozsah: délka v bajtech == 16)
  ChapterTranslate (hlavní)
    ChapterTranslateEditionUID (celé číslo bez znaménka)
    ChapterTranslateCodec (celé číslo bez znaménka)
    ChapterTranslateID (binární)
.fi
.if n \{\
.RE
.\}
.SH "USPOřáDáNí SOUBORU MATROSKA(TM)"
.PP
Uspořádání souboru
Matroska(TM)
je poměrně flexibilní\&.
\fBmkvmerge\fR(1)
vytvoří soubor předem stanoveným způsobem\&. Výsledný soubor vypadá takto:
.PP
[hlavička EBML] [úsek {hlavička vyhledávání č\&. 1} [informace o úseku] [informace o stopách] {přílohy} {kapitoly} [cluster 1] {cluster 2} \&.\&.\&. {cluster n} {indexy} {hlavička vyhledávání č\&. 2} {štítky}]
.PP
Prvky ve složených závorkách jsou volitelné a závisí na obsahu a použitých volbách\&. Několik poznámek:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Prvek hlavičky vyhledávání č\&. 1 obsahuje pouze malý počet prvků úrovně 1, a to jen tehdy, pokud skutečně existují: přílohy, kapitoly, indexy, štítky a prvek hlavičky vyhledávání č\&. 2\&. Starší verze
\fBmkvmerge\fR(1)
ukládaly do tohoto prvku hlavičky vyhledávání také clustery\&. Proto bylo nutné nepřesným odhadem vyhradit dostatek místa, což často selhalo\&. Nyní jsou clustery uloženy pouze v prvku hlavičky vyhledávání č\&. 2 a prvek hlavičky vyhledávání č\&. 1 odkazuje na prvek hlavičky vyhledávání č\&. 2\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Prvky příloh, kapitol a štítků jsou přítomny pouze tehdy, pokud byly přidány\&.
.RE
.PP
Nejkratší možný soubor
Matroska(TM)
by vypadal takto:
.PP
[hlavička EBML] [úsek [informace o úseku] [informace o stopách] [cluster 1]]
.PP
Tak tomu může být u souborů obsahujících pouze zvuk\&.
.SH "EXTERNí SOUBORY čASOVýCH RAZíTEK"
.PP
\fBmkvmerge\fR(1)
umožňuje uživateli zvolit časová razítka pro konkrétní stopu\&. To lze využít k vytváření souborů s videem s proměnlivou frekvencí snímků nebo k vkládání mezer do zvuku\&. Snímek je zde jednotka, kterou
\fBmkvmerge\fR(1)
vytváří samostatně pro každý blok
Matroska(TM)\&. U videa jde přesně o jeden snímek, u zvuku o jeden paket příslušného zvukového typu\&. Například u
AC\-3
by šlo o paket obsahující
\fB1536\fR
vzorků\&.
.PP
Soubory časových razítek používané při připojování stop k sobě se smějí zadat pouze pro první část řetězce stop\&. Pokud například připojujete dva soubory v1\&.avi a v2\&.avi a chcete použít časová razítka, musí příkazový řádek vypadat přibližně takto:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvmerge \&.\&.\&. \-\-timestamps 0:my_timestamps\&.txt v1\&.avi +v2\&.avi
.fi
.if n \{\
.RE
.\}
.PP
\fBmkvmerge\fR(1)
rozpoznává čtyři formáty\&. První řádek vždy obsahuje číslo verze\&. Prázdné řádky, řádky obsahující pouze bílé znaky a řádky začínající znakem \*(Aq#\*(Aq se ignorují\&.
.SS "Formát souboru časových razítek v1"
.PP
Tento formát začíná řádkem s verzí\&. Druhý řádek určuje výchozí počet snímků za sekundu\&. Všechny následující řádky obsahují tři čísla oddělená čárkami: počáteční snímek (\fB0\fR
je první snímek), koncový snímek a počet snímků za sekundu v tomto rozsahu\&. Hodnota
FPS
je číslo s plovoucí desetinnou čárkou, přičemž jako desetinný oddělovač se používá tečka \*(Aq\&.\*(Aq\&. Rozsahy mohou obsahovat mezery, pro které se použije výchozí hodnota
FPS\&. Příklad:
.sp
.if n \{\
.RS 4
.\}
.nf
# timestamp format v1
assume 27\&.930
800,1000,25
1500,1700,30
.fi
.if n \{\
.RE
.\}
.SS "Formát souboru časových razítek v2"
.PP
V tomto formátu obsahuje každý řádek časové razítko odpovídajícího snímku\&. Časové razítko musí být zadáno s přesností na milisekundy\&. Může jít o číslo s plovoucí desetinnou čárkou, ale nemusí\&.
\fIMusíte\fR
zadat alespoň tolik řádků s časovými razítky, kolik je ve stopě snímků\&. Časová razítka v tomto souboru musí být seřazena\&. Příklad pro 25 fps:
.sp
.if n \{\
.RS 4
.\}
.nf
# timestamp format v2
0
40
80
.fi
.if n \{\
.RE
.\}
.SS "Formát souboru časových razítek v3"
.PP
V tomto formátu každý řádek obsahuje délku v sekundách následovanou volitelným počtem snímků za sekundu\&. Obě hodnoty mohou být čísla s plovoucí desetinnou čárkou\&. Není\-li počet snímků za sekundu uveden, použije se výchozí hodnota\&. U zvuku byste měli nechat časová razítka snímků vypočítat samotný kodek\&. Proto použijte jako počet snímků za sekundu hodnotu
\fB0\&.0\fR\&. Mezery v proudu lze vytvořit také klíčovým slovem \*(Aqgap\*(Aq následovaným délkou mezery\&. Příklad pro zvukový soubor:
.sp
.if n \{\
.RS 4
.\}
.nf
# timestamp format v3
assume 0\&.0
25\&.325
7\&.530,38\&.236
gap, 10\&.050
2\&.000,38\&.236
.fi
.if n \{\
.RE
.\}
.SS "Formát souboru časových razítek v4"
.PP
Tento formát je totožný s formátem v2\&. Jediný rozdíl spočívá v tom, že časová razítka nemusejí být seřazena\&. Tento formát by se téměř nikdy neměl používat\&.
.SH "NáVRATOVé KóDY"
.PP
\fBmkvmerge\fR(1)
končí jedním ze tří návratových kódů:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB0\fR
\(en Tento návratový kód znamená, že multiplexování bylo úspěšně dokončeno\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB1\fR
\(en V tomto případě
\fBmkvmerge\fR(1)
vypsal alespoň jedno upozornění, ale multiplexování pokračovalo\&. Upozornění má předponu \*(AqWarning:\*(Aq\&. V závislosti na daných problémech může, ale nemusí být výsledný soubor v pořádku\&. Uživatel by měl zkontrolovat upozornění i výsledný soubor\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB2\fR
\(en Tento návratový kód se použije po výskytu chyby\&.
\fBmkvmerge\fR(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\&.
.RE
.SH "PROMěNNé PROSTřEDí"
.PP
\fBmkvmerge\fR(1)
používá výchozí proměnné určující národní prostředí systému (např\&.
\fILANG\fR
a rodinu
\fILC_*\fR)\&. Další proměnné:
.PP
\fIMKVMERGE_DEBUG\fR, \fIMKVTOOLNIX_DEBUG\fR a její zkrácený tvar \fIMTX_DEBUG\fR
.RS 4
Obsah se zpracuje, jako by byl předán pomocí volby
\fB\-\-debug\fR\&.
.RE
.PP
\fIMKVMERGE_ENGAGE\fR, \fIMKVTOOLNIX_ENGAGE\fR a její zkrácený tvar \fIMTX_ENGAGE\fR
.RS 4
Obsah se zpracuje, jako by byl předán pomocí volby
\fB\-\-engage\fR\&.
.RE
.SH "VIZ TAKé"
.PP
\fBmkvinfo\fR(1),
\fBmkvextract\fR(1),
\fBmkvpropedit\fR(1),
\fBmkvtoolnix-gui\fR(1)
.SH "WWW"
.PP
Nejnovější verzi lze vždy najít na
\m[blue]\fBdomovské stránce MKVToolNix\fR\m[]\&\s-2\u[6]\d\s+2\&.
.SH "AUTHOR"
.PP
\fBMoritz Bunkus\fR <\&moritz@bunkus\&.org\&>
.RS 4
Vývojář
.RE
.SH "NOTES"
.IP " 1." 4
web Matroska(TM)
.RS 4
\%https://www.matroska.org/
.RE
.IP " 2." 4
domovské stránce IANA
.RS 4
\%https://www.iana.org/assignments/media-types/
.RE
.IP " 3." 4
mkvmerge-identification-output-schema-v20.json
.RS 4
\%https://mkvtoolnix.download/doc/mkvmerge-identification-output-schema-v20.json
.RE
.IP " 4." 4
RFC 7159
.RS 4
\%https://tools.ietf.org/html/rfc7159
.RE
.IP " 5." 4
specifikace
Matroska(TM)
.RS 4
\%https://www.matroska.org/technical/specs/index.html
.RE
.IP " 6." 4
domovské stránce MKVToolNix
.RS 4
\%https://mkvtoolnix.download/
.RE