'\" t
.\"     Title: mkvpropedit
.\"    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 "MKVPROPEDIT" "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"
mkvpropedit \- Úprava vlastností existujících souborů Matroska(TM) bez úplného opětovného multiplexování
.SH "PřEHLED"
.HP \w'\fBmkvpropedit\fR\ 'u
\fBmkvpropedit\fR [options] {source\-filename} {actions}
.SH "POPIS"
.PP
Tento program analyzuje existující soubor
Matroska(TM)
a upraví některé jeho vlastnosti\&. Změny poté zapíše do existujícího souboru\&. Mezi upravitelné vlastnosti patří prvky informací o úseku (např\&. název) a hlavičky stop (např\&. kód jazyka, příznak \(Bqvýchozí stopa\(lq nebo název)\&.
.PP
Volby:
.PP
\fB\-l\fR, \fB\-\-list\-property\-names\fR
.RS 4
Vypíše všechny známé a upravitelné názvy vlastností, jejich typ (řetězec, celé číslo, logická hodnota atd\&.) a stručný popis\&. Program poté skončí\&. Parametr
\fIsource\-filename\fR
proto není nutné zadávat\&.
.RE
.PP
\fB\-p\fR, \fB\-\-parse\-mode\fR \fImode\fR
.RS 4
Nastaví režim analýzy\&. Parametr \*(Aq\fImode\fR\*(Aq může mít hodnotu \*(Aqfast\*(Aq (ta je zároveň výchozí) nebo \*(Aqfull\*(Aq\&. Režim \*(Aqfast\*(Aq neanalyzuje celý soubor, ale k nalezení požadovaných prvků zdrojového souboru používá prvky hlavičky vyhledávání\&. V 99 % případů to stačí\&. U souborů, které prvky hlavičky vyhledávání neobsahují nebo jsou poškozené, však uživatel možná bude muset nastavit režim analýzy \*(Aqfull\*(Aq\&. Úplná kontrola souboru může trvat několik minut, zatímco rychlá kontrola trvá jen několik sekund\&.
.RE
.PP
Akce pracující s vlastnostmi hlaviček stop a informací o úseku:
.PP
\fB\-e\fR, \fB\-\-edit\fR \fIselector\fR
.RS 4
Nastaví oddíl souboru
Matroska(TM)
(informace o úseku nebo hlavičky určité stopy), se kterým budou pracovat všechny následující akce
přidání,
nastavení
a
odstranění\&. Tuto volbu lze použít vícekrát, a upravit tak více než jeden prvek\&.
.sp
Ve výchozím nastavení bude
\fBmkvpropedit\fR(1)
upravovat oddíl informací o úseku\&.
.sp
Úplný popis syntaxe najdete v oddílu o
selektorech úprav\&.
.RE
.PP
\fB\-a\fR, \fB\-\-add\fR \fIname\fR=\fIvalue\fR
.RS 4
Přidá vlastnost
\fIname\fR
s hodnotou
\fIvalue\fR\&. Vlastnost se přidá i v případě, že už taková vlastnost existuje\&. Většina vlastností je jedinečná a nemůže se vyskytovat vícekrát\&.
.RE
.PP
\fB\-s\fR, \fB\-\-set\fR \fIname\fR=\fIvalue\fR
.RS 4
Nastaví všechny výskyty vlastnosti
\fIname\fR
na hodnotu
\fIvalue\fR\&. Pokud taková vlastnost neexistuje, přidá se\&.
.RE
.PP
\fB\-d\fR, \fB\-\-delete\fR \fIname\fR
.RS 4
Odstraní všechny výskyty vlastnosti
\fIname\fR\&. Některé vlastnosti jsou povinné a nelze je odstranit\&.
.RE
.PP
Akce pracující se štítky a kapitolami:
.PP
\fB\-t\fR, \fB\-\-tags\fR \fIselector\fR:\fIfilename\fR
.RS 4
Přidá nebo nahradí štítky v souboru štítky ze souboru
filename, případně je odstraní, je\-li
filename
prázdný\&.
\fBmkvpropedit\fR(1)
načítá stejný formát štítků XML jako
\fBmkvmerge\fR(1)\&.
.sp
Parametr
\fIselector\fR
musí být jedno ze slov
\fBall\fR,
\fBglobal\fR
nebo
\fBtrack\fR\&. Při hodnotě
\fBall\fR
\fBmkvpropedit\fR(1)
nahradí nebo odstraní všechny štítky v souboru\&. Při hodnotě
\fBglobal\fR
nahradí nebo odstraní pouze globální štítky\&.
.sp
Při hodnotě
\fBtrack\fR
\fBmkvpropedit\fR(1)
nahradí štítky konkrétní stopy\&. Štítky načtené ze souboru
filename
budou navíc přiřazeny stejné stopě\&. Stopa se zadává stejným způsobem jako
selektory úprav
(viz níže), například
\-\-tags track:a1:new\-audio\-tags\&.xml\&.
.RE
.PP
\fB\-\-add\-track\-statistics\-tags\fR
.RS 4
Vypočítá statistiky všech stop v souboru a přidá pro ně nové statistické štítky\&. Pokud soubor takové štítky již obsahuje, aktualizují se\&.
.RE
.PP
\fB\-\-delete\-track\-statistics\-tags\fR
.RS 4
Odstraní ze souboru všechny existující statistické štítky stop\&. Pokud soubor statistické štítky stop neobsahuje, nezmění se\&.
.RE
.PP
\fB\-c\fR, \fB\-\-chapters\fR \fIfilename\fR
.RS 4
Přidá nebo nahradí kapitoly v souboru kapitolami ze souboru
filename, případně je odstraní, je\-li
filename
prázdný\&.
\fBmkvpropedit\fR(1)
načítá stejné formáty XML a jednoduchých kapitol jako
\fBmkvmerge\fR(1)\&.
.RE
.PP
Akce pro práci s přílohami:
.PP
\fB\-\-add\-attachment\fR \fIfilename\fR
.RS 4
Přidá novou přílohu ze souboru
\fIfilename\fR\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-name\fR, použije se její hodnota jako název nové přílohy\&. Jinak se název odvodí z parametru
\fIfilename\fR\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-mime\-type\fR, použije se její hodnota jako typ MIME nové přílohy\&. Jinak se typ automaticky zjistí z obsahu souboru
\fIfilename\fR\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-description\fR, použije se její hodnota jako popis nové přílohy\&. Jinak se žádný popis nenastaví\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-uid\fR, použije se její hodnota jako UID nové přílohy\&. Jinak se automaticky vytvoří náhodné UID\&.
.RE
.PP
\fB\-\-replace\-attachment\fR \fIselector\fR:\fIfilename\fR
.RS 4
Nahradí jednu či více příloh odpovídajících parametru
\fIselector\fR
souborem
\fIfilename\fR\&. Odpovídá\-li parametru
\fIselector\fR
více existujících příloh, obsah všech se nahradí obsahem souboru
\fIfilename\fR\&.
.sp
Parametr
\fIselector\fR
může mít jeden ze čtyř tvarů\&. Ty jsou vysvětleny níže v oddílu
selektory příloh\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-name\fR, nastaví se její hodnota jako nový název každé upravené přílohy\&. Jinak se názvy nezmění\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-mime\-type\fR, nastaví se její hodnota jako nový typ MIME každé upravené přílohy\&. Jinak se typy MIME nezmění\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-description\fR, nastaví se její hodnota jako nový popis každé upravené přílohy\&. Jinak se popisy nezmění\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-uid\fR, nastaví se její hodnota jako nové UID každé upravené přílohy\&. Jinak se UID nezmění\&.
.RE
.PP
\fB\-\-update\-attachment\fR \fIselector\fR
.RS 4
Nastaví vlastnosti jedné či více příloh odpovídajících parametru
\fIselector\fR\&. Odpovídá\-li parametru
\fIselector\fR
více existujících příloh, aktualizují se vlastnosti všech\&.
.sp
Parametr
\fIselector\fR
může mít jeden ze čtyř tvarů\&. Ty jsou vysvětleny níže v oddílu
selektory příloh\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-name\fR, nastaví se její hodnota jako nový název každé upravené přílohy\&. Jinak se názvy nezmění\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-mime\-type\fR, nastaví se její hodnota jako nový typ MIME každé upravené přílohy\&. Jinak se typy MIME nezmění\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-description\fR, nastaví se její hodnota jako nový popis každé upravené přílohy\&. Jinak se popisy nezmění\&.
.sp
Byla\-li před touto volbou použita volba
\fB\-\-attachment\-uid\fR, nastaví se její hodnota jako nové UID každé upravené přílohy\&. Jinak se UID nezmění\&.
.RE
.PP
\fB\-\-delete\-attachment\fR \fIselector\fR
.RS 4
Odstraní jednu či více příloh odpovídajících parametru
\fIselector\fR\&.
.sp
Parametr
\fIselector\fR
může mít jeden ze čtyř tvarů\&. Ty jsou vysvětleny níže v oddílu
selektory příloh\&.
.RE
.PP
Volby pro akce s přílohami:
.PP
\fB\-\-attachment\-name\fR \fIname\fR
.RS 4
Nastaví název, který se použije pro následující operaci
\fB\-\-add\-attachment\fR
nebo
\fB\-\-replace\-attachment\fR\&.
.RE
.PP
\fB\-\-attachment\-mime\-type\fR \fImime\-type\fR
.RS 4
Nastaví typ MIME, který se použije pro následující operaci
\fB\-\-add\-attachment\fR
nebo
\fB\-\-replace\-attachment\fR\&.
.RE
.PP
\fB\-\-attachment\-description\fR \fIdescription\fR
.RS 4
Nastaví popis, který se použije pro následující operaci
\fB\-\-add\-attachment\fR
nebo
\fB\-\-replace\-attachment\fR\&.
.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 přidávání nových příloh i nahrazování existujících příloh, ale pouze tehdy, není\-li zadán nový typ
MIME\&. Ostatní existující přílohy se nezmění\&.
.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
.PP
Další volby:
.PP
\fB\-\-disable\-language\-ietf\fR
.RS 4
Za běžných okolností
\fBmkvpropedit\fR(1)
při požadavku uživatele na změnu vlastnosti hlavičky stopy \*(Aqlanguage\*(Aq použije stejnou změnu také na nový prvek hlavičky stopy
LanguageIETF, vedle staršího prvku
Language\&. Při použití této volby se změna použije pouze na starší prvek
Language\&.
.sp
Tato volba nemá vliv na změny požadované prostřednictvím vlastnosti hlavičky stopy \*(Aqlanguage\-ietf\*(Aq\&.
.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\&.
.sp
Tato normalizace se použije pouze na prvky, které se skutečně mění:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Při úpravách hlaviček stop jsou ovlivněny pouze ty jazykové prvky stop, které jsou nastaveny prostřednictvím specifikací úprav\&. Jazyky neupravovaných stop se nezmění\&. Jazyk neovlivní ani úprava stopy, při které se nastavují pouze jiné vlastnosti než jazyk\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Při úpravách kapitol jsou ovlivněny všechny jazykové prvky všech prvků kapitol, protože existující kapitoly se vždy zcela nahrazují\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Při úpravách štítků jsou ovlivněny pouze jazykové prvky skutečně nahrazovaných štítků\&. Když například nahradíte globální štítky, existující štítky stop nebudou ovlivněny\&.
.RE
.sp
Nejlépe se všechny existující jazykové značky v souboru normalizují jeho opětovným multiplexováním pomocí
\fBmkvmerge\fR(1)
s volbou \*(Aq\-\-normalize\-language\-ietf\*(Aq nastavenou na požadovaný režim\&.
.RE
.PP
\fB\-\-command\-line\-charset\fR \fIcharacter\-set\fR
.RS 4
Nastavuje znakovou sadu, ze které se převádějí řetězce zadané na příkazovém řádku\&. Výchozí je znaková sada daná aktuálním národním prostředím systému\&.
.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\-\-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\-\-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 pomocí
\fBmkvpropedit \-\-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\-v\fR, \fB\-\-verbose\fR
.RS 4
Vypisuje podrobné informace a zobrazuje všechny důležité prvky
Matroska(TM)
při jejich čtení\&.
.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
.PP
\fB@\fR\fIoptions\-file\&.json\fR
.RS 4
Načte další argumenty příkazového řádku ze souboru
\fIoptions\-file\fR\&. Úplné vysvětlení podporovaných formátů takových souborů naleznete v oddílu \(BqOption files\(lq manuálové stránky
\fBmkvmerge\fR(1)\&.
.RE
.SH "SELEKTORY úPRAV"
.PP
Volba
\fB\-\-edit\fR
nastaví oddíl souboru
Matroska(TM)
(informace o úseku nebo hlavičky určité stopy), se kterým budou pracovat všechny následující akce
přidání,
nastavení
a
odstranění\&. Nastavení zůstává platné až do nalezení další volby
\fB\-\-edit\fR\&. Argument této volby se nazývá selektor úprav\&.
.PP
Ve výchozím nastavení bude
\fBmkvpropedit\fR(1)
upravovat oddíl informací o úseku\&.
.SS "Informace o úseku"
.PP
Informace o úseku lze vybrat jedním z těchto tří slov: \*(Aqinfo\*(Aq, \*(Aqsegment_info\*(Aq nebo \*(Aqsegmentinfo\*(Aq\&. Obsahují vlastnosti, jako je název úseku nebo
UID
úseku\&.
.SS "Hlavičky stop"
.PP
Hlavičky stop lze vybrat o něco složitějším selektorem\&. Všechny varianty začínají řetězcem \*(Aqtrack:\*(Aq\&. Vlastnosti hlavičky stopy zahrnují prvky, jako je kód jazyka, příznak \(Bqvýchozí stopa\(lq nebo název stopy\&.
.PP
\fBtrack:\fR\fIn\fR
.RS 4
Je\-li parametr
\fIn\fR
číslo, vybere se stopa s pořadovým číslem
\fIn\fR\&. Pořadí stop je stejné jako ve výstupu volby
\fB\-\-identify\fR
programu
\fBmkvmerge\fR(1)\&.
.sp
Číslování začíná od 1\&.
.RE
.PP
\fBtrack:\fR\fIt\fR\fIn\fR
.RS 4
Začíná\-li parametr jediným znakem
\fIt\fR
následovaným číslem
\fIn\fR, vybere se stopa s pořadovým číslem
\fIn\fR
v rámci daného typu\&. Parametr typu stopy
\fIt\fR
musí být jeden z těchto čtyř znaků: \*(Aqa\*(Aq pro zvukovou stopu, \*(Aqb\*(Aq pro tlačítkovou stopu, \*(Aqs\*(Aq pro titulkovou stopu a \*(Aqv\*(Aq pro video stopu\&. Pořadí stop je stejné jako ve výstupu volby
\fB\-\-identify\fR
programu
\fBmkvmerge\fR(1)\&.
.sp
Číslování začíná od 1\&.
.RE
.PP
\fBtrack:\fR=\fIuid\fR
.RS 4
Začíná\-li parametr znakem \*(Aq=\*(Aq následovaným číslem
\fIuid\fR, vybere se stopa, jejíž prvek
UID
stopy se rovná zadanému
\fIuid\fR\&. Hodnoty
UIDs
stop lze získat pomocí
\fBmkvinfo\fR(1)\&.
.RE
.PP
\fBtrack:\fR@\fInumber\fR
.RS 4
Začíná\-li parametr znakem \*(Aq@\*(Aq následovaným číslem
\fInumber\fR, vybere se stopa, jejíž prvek s číslem stopy se rovná tomuto parametru
\fInumber\fR\&. Čísla stop lze získat pomocí
\fBmkvinfo\fR(1)\&.
.RE
.SS "Poznámky"
.PP
Vzhledem k povaze selektorů úprav stop může několik selektorů ve skutečnosti odpovídat téže hlavičce stopy\&. V takových případech se všechny akce pro tyto selektory úprav spojí a provedou v pořadí, v němž jsou uvedeny na příkazovém řádku\&.
.SH "SELEKTORY PříLOH"
.PP
Selektor příloh se používá se dvěma akcemi
\fB\-\-replace\-attachment\fR
a
\fB\-\-delete\-attachment\fR\&. Může mít jeden z následujících čtyř tvarů:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Výběr podle ID přílohy\&. V tomto tvaru je selektorem jednoduše číslo: ID přílohy vypsané identifikačním příkazem programu
\fBmkvmerge\fR(1)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
Výběr podle UID přílohy (jedinečného ID)\&. V tomto tvaru je selektorem rovnítko
=
následované číslem: jedinečným ID přílohy vypsaným podrobným identifikačním příkazem programu
\fBmkvmerge\fR(1)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
Výběr podle názvu přílohy\&. V tomto tvaru je selektorem doslovný řetězec
name:
následovaný názvem existující přílohy\&. Použije\-li se tento selektor s volbou
\fB\-\-replace\-attachment\fR, musí být dvojtečky v porovnávaném názvu zapsány pomocí escape sekvence
\ec\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
Výběr podle typu MIME\&. V tomto tvaru je selektorem doslovný řetězec
mime\-type:
následovaný typem MIME existující přílohy\&. Použije\-li se tento selektor s volbou
\fB\-\-replace\-attachment\fR, musí být dvojtečky v porovnávaném typu MIME zapsány pomocí escape sekvence
\ec\&.
.RE
.SH "ZPRACOVáNí JAZYKů"
.PP
\fBmkvpropedit\fR(1)
se ve výchozím nastavení většinou snaží postupovat správně\&. Změna vlastnosti
\fBlanguage\fR
proto způsobí, že
\fBmkvpropedit\fR(1)
použije stejnou změnu pro nový prvek \(BqLanguageIETF\(lq i starší prvek \(BqLanguage\(lq, podobně jako
\fBmkvmerge\fR(1)
nastavuje jazyk v obou prvcích\&. Při použití příkazu
mkvpropedit movie\&.mkv \-\-edit track:2 \-\-set language=zh\-TW
se například prvek \(BqLanguageIETF\(lq nastaví na
zh\-TW
a starší prvek \(BqLanguage\(lq na
chi\&.
.PP
Kromě toho existuje nová vlastnost hlavičky stopy nazvaná
\fBlanguage\-ietf\fR, kterou lze nastavit nebo odstranit\&. Změny této vlastnosti se vztahují pouze na nový prvek hlavičky stopy \(BqLanguageIETF\(lq\&. Komplikací je, že starší prvek hlavičky stopy \(BqLanguage\(lq je v Matrosce povinný \(em i když tedy v souboru není přítomen, má stále předpokládanou hodnotu\&. Nastaví\-li uživatel pouze vlastnost
\fBlanguage\-ietf\fR, ale nikoli vlastnost
\fBlanguage\fR,
\fBmkvpropedit\fR(1)
proto v určitých případech přidá starší prvek \(BqLanguage\(lq & nastaví jej na
und
(tedy \(Bqneurčeno\(lq), protože uživatel jeho hodnotu nezadal\&.
.PP
Při načítání souborů XML s kapitolami nebo štítky pracuje
\fBmkvpropedit\fR(1)
stejně jako
\fBmkvmerge\fR(1)\&.
.PP
Vytváření nových prvků lze zcela zakázat volbou příkazového řádku `\-\-disable\-language\-ietf`, která se vztahuje 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 "PříKLADY"
.PP
Následující příklad upravuje soubor nazvaný \*(Aqmovie\&.mkv\*(Aq\&. Nastaví název úseku a změní kód jazyka zvukové a titulkové stopy\&. Tento příklad lze zkrátit vynecháním první volby
\fB\-\-edit\fR, protože úprava prvku informací o úseku je výchozí pro všechny volby uvedené před první volbou
\fB\-\-edit\fR\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-edit info \-\-set "title=The movie" \-\-edit track:a1 \-\-set language=fre \-\-edit track:a2 \-\-set language=ita
.fi
.if n \{\
.RE
.\}
.PP
Druhý příklad odstraní příznak \(Bqvýchozí stopa\(lq z první titulkové stopy a nastaví jej pro druhou\&. Upozorňujeme, že
\fBmkvpropedit\fR(1)
na rozdíl od
\fBmkvmerge\fR(1)
automaticky nenastaví příznak \(Bqvýchozí stopa\(lq ostatních stop na \(Bq0\(lq, když je u jiné stopy nastaven na \(Bq1\(lq\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-edit track:s1 \-\-set flag\-default=0 \-\-edit track:s2 \-\-set flag\-default=1
.fi
.if n \{\
.RE
.\}
.PP
Nahrazení štítků druhé titulkové stopy v souboru vypadá takto:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-tags track:s2:new\-subtitle\-tags\&.xml
.fi
.if n \{\
.RE
.\}
.PP
Při odstraňování všech štítků je nutné vynechat název souboru:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-tags all:
.fi
.if n \{\
.RE
.\}
.PP
Nahrazení kapitol v souboru vypadá takto:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-chapters new\-chapters\&.xml
.fi
.if n \{\
.RE
.\}
.PP
Při odstraňování všech kapitol je nutné vynechat název souboru:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-chapters \*(Aq\*(Aq
.fi
.if n \{\
.RE
.\}
.PP
Přidání souboru písma (Arial\&.ttf) jako přílohy:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-add\-attachment Arial\&.ttf
.fi
.if n \{\
.RE
.\}
.PP
Přidání souboru písma (89719823\&.ttf) jako přílohy a uvedení několika informací, protože ve skutečnosti jde pouze o Arial:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-attachment\-name Arial\&.ttf \-\-attachment\-description \*(AqThe Arial font as a TrueType font\*(Aq \-\-attachment\-mime\-type application/x\-truetype\-font \-\-add\-attachment 89719823\&.ttf
.fi
.if n \{\
.RE
.\}
.PP
Nahrazení jednoho přiloženého souboru písma (Comic\&.ttf) jiným (Arial\&.ttf):
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-attachment\-name Arial\&.ttf \-\-attachment\-description \*(AqThe Arial font as a TrueType font\*(Aq \-\-replace\-attachment name:Comic\&.ttf:Arial\&.ttf
.fi
.if n \{\
.RE
.\}
.PP
Odstranění druhého přiloženého souboru bez ohledu na to, o jaký soubor jde:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-delete\-attachment 2
.fi
.if n \{\
.RE
.\}
.PP
Odstranění všech přiložených písem podle typu MIME:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvpropedit movie\&.mkv \-\-delete\-attachment mime\-type:application/x\-truetype\-font
.fi
.if n \{\
.RE
.\}
.SH "NáVRATOVé KóDY"
.PP
\fBmkvpropedit\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 úprava byla úspěšně dokončena\&.
.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ě
\fBmkvpropedit\fR(1)
vypsal alespoň jedno upozornění, ale úprava pokračovala\&. Upozornění má předponu \*(AqWarning:\*(Aq\&. V závislosti na daných problémech mohou, ale nemusí být výsledné soubory v pořádku\&. Uživatel by měl zkontrolovat upozornění i výsledné soubory\&.
.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\&.
\fBmkvpropedit\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 "TEXTOVé SOUBORY A PřEVODY ZNAKOVýCH SAD"
.PP
Podrobnou diskusi o způsobu, jakým všechny nástroje sady MKVToolNix pracují s převody znakových sad, kódováním vstupu/výstupu, příkazového řádku a konzole, naleznete ve stejnojmenném oddílu manuálové stránky
\fBmkvmerge\fR(1)\&.
.SH "PROMěNNé PROSTřEDí"
.PP
\fBmkvpropedit\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
\fIMKVPROPEDIT_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
\fIMKVPROPEDIT_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
\fBmkvmerge\fR(1),
\fBmkvinfo\fR(1),
\fBmkvextract\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[1]\d\s+2\&.
.SH "AUTHOR"
.PP
\fBMoritz Bunkus\fR <\&moritz@bunkus\&.org\&>
.RS 4
Vývojář
.RE
.SH "NOTES"
.IP " 1." 4
domovské stránce MKVToolNix
.RS 4
\%https://mkvtoolnix.download/
.RE