From ad1efd85f590da755ce7bebdfecf1c75cc00afd5 Mon Sep 17 00:00:00 2001
From: Moritz Bunkus $D^FPgPIcR_!+G$x3-m>b6-1r(Q~cid*dCS5{vh5xE!x!&T=?IsI>8c9UMn=
zLP^{7=lw?BpSV7@`efTEF)eTN@R?Ur-w%ggj7r*`H##bPCtA;AwhSBoS`h_fY?JTF
z+Oc(ZamsjN19JWAn_Eg3ABU2 The only thing that mmg needs to know is the location of the
- mkvmerge binary. Under normal circumstances it will be found
- automatically. But if not then you can select the binary to use on the
- Settings tab. The only thing that mmg needs to know is the location of the
+ mkvmerge binary. Under normal circumstances it will be
+ found automatically. But if not then you can select the binary
+ to use on the Settings tab.
$;>Kj21
zz!H4^vaNlRk@8pI3VHyN3-}O%kQej-q!#WwLSE1V&>={x4E3ITQJb2qdnvz5FX#an
z?W74d{>uFyTV}86f5|wc#zyv6nEys%*DUFGeF`NTw
z1tl(Db=yFiz8M+_y6N`3%cBrS+HFX@jSfky*;!Fo(vn&qrSxyJ7@In`I0W)%|9)
Q`tblzj;=>4k%6iI1lH1N7ytkO
literal 0
HcmV?d00001
diff --git a/doc/images/audiotrackoptions.png b/doc/images/audiotrackoptions.png
new file mode 100644
index 0000000000000000000000000000000000000000..ac7a0b426c1060bbb8b4fa5dde828abdd5da9ca4
GIT binary patch
literal 4635
zcmZWt2{fBo|9*qom5xrUEu|Q=)u1ZI7L;kL8rs@w32NVxC?X9K(RQlSR@>2OtVPGy
zC@Rzv6=E5xmRc%EBZ4lW68jcJ_+rlYpZ|95dEa~Ad+vSjJ-_ojzvsF4x64lF6=V;~
z0sx@kaKZj60D!hc?Pt=GqBm{qf{Cb-3~)Se5A5ug0$R~iQIAaY1README
files that are included in the mkvtoolnix
package.
+
+
+
+
+
+
+
+
+
+ Use this button to select the path to the
+ mkvmerge program.
+
@@ -214,223 +228,365 @@
When mmg starts up it shows the first and probably most - important tab: the input tab. Here you see four different - elements. The topmost input box lists all input files. Directly - under this box are options that apply to the currently selected input - file.
+
- The two buttons to the right of the upper list box can be used to - add files to the list box with the + button and to remove the - selected entry with the - button. +When mmg starts up it shows the first and probably + most important tab: the input tab. Here you see four + different elements. The topmost input box lists all input + files. Directly under this box are options that apply + to the currently selected input file. + +The two buttons to the right of the upper list box can be + used to add files to the list box with the + button and + to remove the selected entry with the - button. + + |
+ + |
+
+ + Use these buttons to add and remove + files. + |
+
+ Once the user selects an input file in the upper list + box the second list box will contains all tracks that can + be read from this file. Each track is ENabled by default + and will be muxed into the resulting file. However, you can + change that by simply clicking on the checkbox right in front of + the track's name in the second list box. For each of these + tracks the user can select track specific options with the input + boxes and check boxes below the track listing. These options + will be described in the following sections. + |
+ + |
+
+ + Three enabled tracks and one disabled track. The fourth track will + not be copied into the output file. + |
+
+
Once the user selects an input file in the upper list box - the second list box will contains all tracks that can be read - from this file. Each track is ENabled by default and will be - muxed into the resulting file. However, you can change that by simply - clicking on the checkbox right in front of the track's name in the - second list box. For each of these tracks the user can select - track specific options with the input boxes and check boxes below the - track listing. These options will be described in the following - sections.
Once the user has added and selected an input file he can set
- options that apply to this specific file. At the moment only one such
- option has been implemented: No chapters
. If this option
- is checked then mkvmerge will not try to copy chapters from
- this source file. More information about chapters can be found in the
- section about the chapter
- editor in this document and in mkvmerge's own
- documentation.
No chapters
and No
+ attachments
. These options tell mkvmerge not to copy any
+ chapters / attachments from the current source file.
+
+ More information about chapters can be found in the section about + the chapter editor in + this document and in mkvmerge's own documentation.
Depending on the type of the currently selected track (audio,
video, subtitles) and even depending on the contents of the track only
a subset of all the track specific options are availbale. The options
- are:
-
-
Language:
The user can select the language for each
- track regardless of its type. This language is coded in the ISO639-2
- language code. The drop-down box contains all ISO639-2 codes so the
- user does not have to worry about selecting the wrong language
- code.Track name:
The user can set a name for the current
- track. This name is a free-form string. Practical examples could be
- 'director's comments' or 'aeriel view of Seattle'. Note that these
- names are not meant to contain the movie title!Cues:
The cues are for Matroska what the
- index is for AVI files. They contain links to the key
- frames. Usually this option should be left on the value
- 'default'. mkvmerge will automatically chose the best method
- for any given track type. A full explanantion of tracks can be found
- in mkvmerge's documentation.Aspect ratio:
With this option the user can set the
- aspect ratio that should be used upon playback. It defaults to the
- aspect ratio that the movie was encoded with but can be changed,
- e.g. for anamorphic encodings. The GUI expects the format to be
- either a floating point number (e.g. '2.33') or a fraction
- (e.g. '16/9').
- FourCC:
Matroska does not normally store the FourCC
- which is used in other containers to identify the codec
- used. Matroska has its own format, called CodecID, but it
- also has an AVI compatibility mode. In thise mode the FourCC is also
- stored. With this option the FourCC can be forced to a different
- value. However, you cannot change the CodecID used by
- mkvmerge.
- Delay (in ms):
In some cases audio and video are
- not synchronized properly. With this option the user can offset the
- audio track by a given amount, either positive or
- negative. mkvmerge will either remove samples at the
- beginning or insert silence at the beginning to adjust the track.
- Stretch by:
In some cases audio and video slowly
- drift apart during playback. This can be fixed by supplying a factor
- of how much the timecodes should be stretched by mkvmerge. If
- nothing is given then '1.0' is assumed which does not alter the
- timecodes. Please note that this option has not been implemented for
- all audio track types yet.
- Subtitle charset:
Some text subtitle formats do not
- store the charset that they were creted with. This is important
- because text subtitles are auomatically converted to the UTF-8
- charset during muxing. mkvmerge will normally assume that the
- system's current charset is the same that the subtitle file was
- written in. But in case this is not true the user can select the
- correct charset.
- Make default track:
Matroska knows a flag which
- tells the player that a specific track should be preferred upon
- playback if the user does not chose another one. Of course each
- track type has its own default track - e.g. the default audio
- track is the English one, and the default subtitle track is the
- French one. If no track is set to be the default track then
- mkvmerge will promote the first track of each type that it
- finds to be the default track. This is consistent with the behaviour
- of various media players.AAC is SBR/HE-AAC/AAC+:
The new technology called
- 'high efficiency AAC' has some drawbacks when it is being stored in
- .AAC
files: it is not possible to detect the HE-AAC
- part for these files. Therefore the user has to check this option
- manually if it applies. Please note that this problem does not exist
- for HE-AAC stored in .MP4
files.
+
|
+ + |
+
+
+
+
+
+
+ |
+
Matroska files can also contain other files, called - attachments. This works basically just like with your favourite email - program. The idea is to provide additional information about the - file. Some examples could be cover photos for a CD rip, additional - background information in text form about the movie or even some - compressed fonts for the subtitles.
+
- Every attachment needs two things: the file name (obviously) and - the MIME type that should be associated with the file. The usage is - very easy and similar to adding files on the input tab. +Matroska files can also contain other files, called + attachments. This works basically just like with your + favourite email program. The idea is to provide additional + information about the file. Some examples could be cover + photos for a CD rip, additional background information in text + form about the movie or even some compressed fonts for the + subtitles. -On the second tab of the GUI, the attachment tab, you can - add a file with the + button and remove the selected attachment - with the - button. Once an attachment has been selected the - other controls on this tab will be available. You do have to select a - MIME type for each attachment, but the description is optional - - although it is a good idea to always provide a description. This makes - it easier for others to identify what you've attached to this Matroska - file. +Every attachment needs two things: the file name (obviously) + and the MIME type that should be associated with the file. The + usage is very easy and similar to adding files on the + input tab. -The last option, On the second tab of the GUI, the attachment tab, you + can add a file with the + button and remove the + selected attachment with the - button. Once an + attachment has been selected the other controls on this tab + will be available. You do have to select a MIME type for each + attachment, but the description is optional - although it is a + good idea to always provide a description. This makes it + easier for others to identify what you've attached to this + Matroska file. + +The last option, |
+ + |
+
+
+
+
+ |
+
The third tab, Global, is packed full of options that apply - to the complete file and not just to one or more tracks.
+ to the complete file and not just to one or more tracks. -
-
File/segment title-Automatic splitting and file linking+
The
|
+ + |
+
+
+ |
+
+ Automatic splitting and file linking +-
The
Matroska supports file linking which simply says that a specific - file is the predecessor or successor of the current file. To be - precise, it's not really the files that are linked but the Matroska - segments. As most files will probably only contain one Matroska - segment I simply say 'file linking' although 'segment linking' would - be more appropriate. +Each segment is identified by a unique 128 bit wide segment - UID. This UID is automatically generated by mkvmerge. The - linking is done primarily via putting the segment UIDs of the - previous/next file into the segment header information. mkvinfo - prints these UIDs if it finds them. +If a file is split into several smaller ones and linking is used
- then the timecodes will not start at 0 again but will continue where
- the last file has left off. This way the absolute time is kept even if
- the previous files are not available (e.g. when streaming). If no
- linking is used then the timecodes should start at 0 for each file. By
- default mkvmerge uses file linking. If you don't want that you
- can turn it off by enabling this
Manual file/segment linking+Matroska supports file linking which simply says that a + specific file is the predecessor or successor of the current + file. To be precise, it's not really the files that are linked + but the Matroska segments. As most files will probably only + contain one Matroska segment I simply say 'file linking' + although 'segment linking' would be more appropriate. -Regardless of whether splitting is active or not the user can tell
- mkvmerge to link the produced files to specific UIDs. This is
- done by entering a valid segment UID into the two input boxes,
- Each segment is identified by a unique 128 bit wide segment + UID. This UID is automatically generated by + mkvmerge. The linking is done primarily via putting the + segment UIDs of the previous/next file into the segment header + information. mkvinfo prints these UIDs if it finds + them. -If splitting is used then the first file is linked to the UID given
- in the If a file is split into several smaller ones and linking is
+ used then the timecodes will not start at 0 again but will
+ continue where the last file has left off. This way the
+ absolute time is kept even if the previous files are not
+ available (e.g. when streaming). If no linking is used then
+ the timecodes should start at 0 for each file. By default
+ mkvmerge uses file linking. If you don't want that you
+ can turn it off by enabling this Manual file/segment linking+ +Regardless of whether splitting is active or not the user can tell
+ mkvmerge to link the produced files to specific
+ UIDs. This is done by entering a valid segment UID into the
+ two input boxes, If splitting is used then the first file is linked to the UID
+ given in the |
+ + |
+
+
+ |
+