'\" t
.\"     Title: mkvinfo
.\"    Author: Moritz Bunkus <moritz@bunkus.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2024-03-10
.\"    Manual: 使用者命令
.\"    Source: MKVToolNix 83.0
.\"  Language: Chinese
.\"
.TH "MKVINFO" "1" "2024\-03\-10" "MKVToolNix 83\&.0" "使用者命令"
.\" -----------------------------------------------------------------
.\" * 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 "名称"
mkvinfo \- 输出关于 Matroska(TM) 文件中各轨的信息
.SH "概要"
.HP \w'\fBmkvinfo\fR\ 'u
\fBmkvinfo\fR [選項] {輸入檔名}
.SH "摘要說明"
.PP
本程序可列出
Matroska(TM)文件中包含的所有轨道，输出信息可以限定为文件的轨道列表以及所用编解码器的信息。
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
默认情况下，\fBmkvinfo\fR(1)
会在读取到首个簇时停下来。它也不会显示某些元素（通常是反复出现的元素）。通过此选项可以让
\fBmkvinfo\fR(1)
忽略冗余级别继续处理，并显示所有元素。
.RE
.PP
\fB\-c\fR, \fB\-\-checksums\fR
.RS 4
计算并显示各帧的
\fBAdler\-32\fR
校验码。仅当调试时有用处。
.RE
.PP
\fB\-o\fR, \fB\-\-continue\fR
.RS 4
默认情况下，\fBmkvinfo\fR(1)
会在读取到首个簇时停下来。通过此选项可以让
\fBmkvinfo\fR(1)
忽略冗余级别继续处理。
.RE
.PP
\fB\-p\fR, \fB\-\-hex\-positions\fR
.RS 4
忽略冗余级别，以十六进制显示所有元素的位置。
.RE
.PP
\fB\-P\fR, \fB\-\-positions\fR
.RS 4
忽略冗余级别，以十进制显示所有元素的位置。
.RE
.PP
\fB\-s\fR, \fB\-\-summary\fR
.RS 4
仅显示
\fBmkvinfo\fR(1)
所获取信息的简要概述，而非各元素。
.RE
.PP
\fB\-t\fR, \fB\-\-track\-info\fR
.RS 4
在\(lq详细\(rq模式下为各轨道显示统计信息。如果\(lq详细\(rq程度为 0 级，则将同时将级别设为 1。
.RE
.PP
\fB\-x\fR, \fB\-\-hexdump\fR
.RS 4
以十六進位轉儲形式顯示每影格的前 16 位元組。
.RE
.PP
\fB\-X\fR, \fB\-\-full\-hexdump\fR
.RS 4
以十六進位轉儲形式顯示每影格的全部位元組。
.RE
.PP
\fB\-z\fR, \fB\-\-size\fR
.RS 4
顯示每個元件包含表頭的大小。
.RE
.PP
\fB\-\-command\-line\-charset\fR \fI字元集\fR
.RS 4
設定在命令列顯示的字串字元集，以轉換為其他字元集。預設為目前系統所在位置指定的字元集。
.RE
.PP
\fB\-\-output\-charset\fR \fI字元集\fR
.RS 4
設定要轉換為輸出字串的字元集。預設為目前系統所在位置指定的字元集。
.RE
.PP
\fB\-r\fR, \fB\-\-redirect\-output\fR \fI檔名\fR
.RS 4
將所有訊息寫入到檔案
\fI檔名\fR
而不是命令列。儘管使用輸出重新導向可以輕鬆完成此操作，但在某些情況下需要使用此選項: 當終端在將輸出寫入文件之前重新解釋（覆蓋）輸出時。 優先使用通過
\fB\-\-output\-charset\fR
設定字元集。
.RE
.PP
\fB\-\-ui\-language\fR \fI語言碼\fR
.RS 4
強制使用語言
\fI編碼\fR
對應的的翻譯(例如 \*(Aqzh_TW\*(Aq 為臺灣正體中文翻譯)。 在\fI編碼\fR欄位中輸入\*(Aqlist\*(Aq 讓程式輸出時使用可用的對應翻譯清單。
.RE
.PP
\fB\-\-abort\-on\-warnings\fR
.RS 4
發出第一個警告後，終止程式。程式的結束碼為 1 。
.RE
.PP
\fB\-\-debug\fR \fI主題\fR
.RS 4
針對特定功能開啟除錯。此選項適用於開發者。
.RE
.PP
\fB\-\-engage\fR \fI功能\fR
.RS 4
開啟實驗中功能。 透過\fBmkvinfo \-\-engage list\fR啟用可用的列表。這些功能不會在正常情況下使用。
.RE
.PP
\fB\-\-gui\-mode\fR
.RS 4
開啟 GUI 模式。在這種模式中，可能會輸出特殊格式的行數，可以呈現控制的 GUI 發生什麼事。這些訊息會以 \*(Aq#GUI#訊息\*(Aq呈現。訊息可能包含機碼/值，例如 \*(Aq#GUI#訊息#機碼1=值1#機碼2=值2\&...\*(Aq。 無論是訊息或是機碼都不會轉為譯文，而且永遠使用 *英語* 輸出。
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
使输出更详尽。请参阅关于
\(lq详细\(rq程度
的段落获取在哪些层级将输出哪些信息的描述。
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
顯示使用方式並退出。
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
顯示版本資訊並離開。
.RE
.PP
\fB@\fR\fIoptions\-file\&.json\fR
.RS 4
從\fI檔案選項\fR檔讀取其他命令列引數。有關此類檔案支援格式的完整說明，請參閱
\fBmkvmerge\fR(1)
文件中的 "選項檔案" 章節。
.RE
.SH "詳細資訊層級"
.PP
\fB\-v\fR
选项可以使
\fBmkvinfo\fR(1)
增强其\(lq详细\(rq程度并输出关于当前文件的更多信息。
.PP
在 level 0
\fBmkvinfo\fR(1)
仅输出它发现的轨道头及其类型。头部解析完毕后（更专业地：遇到首个簇时），\fBmkvinfo\fR(1)
将退出执行。在此层级，定位头项与 cue 索引不会显示出来\(em\(em即使它们位于轨道信息之前。
.PP
在 level 1
\fBmkvinfo\fR(1)
同样将输出在整个文件中遇到的所有
Matroska(TM)
元素，此外还将输出定位头项与 cue 索引项。如果启用了简要模式，\fBmkvinfo\fR(1)
还将输出各帧位置。
.PP
通过选项「\fB\-\-continue\fR」可以实现相同的效果。
.PP
在 level 2
\fBmkvinfo\fR(1)
同样将输出定位头项与 cue 索引项，以及文件中各
Matroska(TM)
元素被发现的位置。
.PP
通过选项「\fB\-\-all \-\-positions\fR」可以实现相同的结果。
.PP
在 level 3 及更高层级
\fBmkvinfo\fR(1)
将输出一些与
Matroska(TM)
元素不直接相连的信息。对于其他元素，将只输出发现的基本信息。Level 3 增加了元信息以便调试（换句话说：它是为开发人员设计的）。Level 3 输出的所有行都以方括号嵌套以便过滤。
.SH "文字檔案與字元集轉換"
.PP
关于 MKVToolNix 套件中所有工具如何处理字符集转换、输入/输出编码、命令行编码及控制台编码的深入讨论，请参见
\fBmkvmerge\fR(1)
手册中相对应名称的段落。
.SH "結束代碼"
.PP
使用三個之一的結束代碼結束
\fBmkvinfo\fR(1)
：
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB0\fR
\-\- 此結束代碼表示執行已成功完成。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB1\fR
\-\- 在此情況下
\fBmkvinfo\fR(1)
輸出時至少有一則警告，但動作仍然進行。警告訊息會在前端出現 \*(Aq警告:\*(Aq 字樣。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB2\fR
\-\- 此結束代碼用於發生錯誤後。
\fBmkvinfo\fR(1)
在輸出錯誤訊息後立即中止動作。錯誤訊息的範圍包含從錯誤命令列參數的讀/寫至檔案損壞。
.RE
.SH "環境變數"
.PP
\fBmkvinfo\fR(1)
使用決定系統的地區設定的變數 (例如：
\fILANG\fR
與
\fILC_*\fR
系列)。 附加變數：
.PP
\fIMKVINFO_DEBUG\fR, \fIMKVTOOLNIX_DEBUG\fR 與其的簡短形式 \fIMTX_DEBUG\fR
.RS 4
視為通過
\fB\-\-debug\fR
選項傳遞的內容。
.RE
.PP
\fIMKVINFO_ENGAGE\fR, \fIMKVTOOLNIX_ENGAGE\fR 與其的簡短形式 \fIMTX_ENGAGE\fR
.RS 4
視為通過
\fB\-\-engage\fR
選項傳遞的內容。
.RE
.SH "參閱"
.PP
\fBmkvmerge\fR(1),
\fBmkvextract\fR(1),
\fBmkvpropedit\fR(1),
\fBmkvtoolnix-gui\fR(1)
.SH "網路"
.PP
永遠可在
\m[blue]\fBMKVToolNix 首頁\fR\m[]\&\s-2\u[1]\d\s+2
找到最新版。
.SH "作者"
.PP
\fBMoritz Bunkus\fR <\&moritz@bunkus\&.org\&>
.RS 4
開發人員
.RE
.SH "备注"
.IP " 1." 4
MKVToolNix 首頁
.RS 4
\%https://mkvtoolnix.download/
.RE