1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "MPEGCAT" "1" "28 October 2006" "" ""
.SH NAME
mpegcat \- Extracts structural information and PES streams from an MPEG2 video file
.SH SYNOPSIS
\fBmpegcat\fR { \fB\fIoptions\fB\fR } { \fB\fIfile\fB\fR }
.SH "DESCRIPTION"
.PP
\fBmpegcat\fR dumps detailed textual information about
an MPEG2 file. It also has an option for writing out a particular
Packetized Elementary Stream (PES) given its id.
.PP
The original purpose of \fBmpegcat\fR was for debugging stream parsing issues
in the gopchop cuts-only MPEG2 video editor, but it has more general utility.
.SH "OPTIONS"
.SS "GENERAL OPTIONS"
.TP
\fB-d,--debug\fR
Report debug info
.TP
\fB-D,--dvd-format\fR
Enable DVD packet extensions
.TP
\fB-h,-?,--help\fR
Help
.TP
\fB-w,--write \fIFILE\fB,\fI0xID\fB[,\fI0xSID\fB]\fR
Write \fIPES\fR with id \fIID\fR
(and subid \fISID\fR) to \fIFILE\fR\&.
Sub Picture Unit (SPU) streams such
as overlays, subtitles and DVD menus extracted using this option
can be displayed using the companion
\fBgtkspu\fR utility.
To find SPU streams in a .VOB ripped from a DVD:
.nf
$ \fBmpegcat \-iDa VTS_01_0.VOB | grep SPU\fR
131086: 0xBD: DVD Audio 0x20 (SPU 0): 2028 bytes (next marker @ 133120)
133134: 0xBD: DVD Audio 0x20 (SPU 0): 2028 bytes (next marker @ 135168)
137230: 0xBD: DVD Audio 0x20 (SPU 0): 190 bytes (next marker @ 137426)
...
.fi
To save a given stream:
.nf
$ \fBmpegcat \-iDaw dump.spu,0xBD,0x20 VTS_01_0.VOB > /dev/null\fR
.fi
(And to view the stream)
.nf
$ \fBgtkspu dump.spu 1\fR
$ \fBgtkspu dump.spu 2\fR
$ \fBgtkspu dump.spu 3\fR
...
.fi
.SS "PROCESSING TOGGLES"
.TP
\fB-V,--enter-video\fR
Process video packets (forced by \-t option)
.SS "GENERAL DISPLAY TOGGLES"
.TP
\fB-p,--pack\fR
Toggle Pack packet start display
.TP
\fB-v,--video\fR
Toggle video ES packet start display
.TP
\fB-a,--audio\fR
Toggle audio ES packet start display
.TP
\fB-o,--other\fR
Toggle other stream display (only show video & audio)
.TP
\fB-y,--system\fR
Toggle system header display
.TP
\fB-e,--errors\fR
Toggle packet errors
.TP
\fB-i,--invert\fR
Invert all display toggles
.SS "VIDEO DISPLAY TOGGLES"
.TP
\fB-s,--slices\fR
Toggle slice starts (default off)
.TP
\fB-q,--sequence\fR
Toggle sequence header display
.TP
\fB-g,--GOPs\fR
Toggle GOP header display
.TP
\fB-f,--frames\fR
Toggle Picture header display
.SS "SHORT CUTS"
.TP
\fB-F,--just-frames\fR
Show only video frames (same as '\-Vepvaoyq')
.SS "FILE OFFSET OPTIONS"
.TP
\fB-b,--begin=\fINUM\fB\fR
Start reading at offset \fINUM\fR
.TP
\fB-n,--num=\fINUM\fB\fR
Stop after reading \fINUM\fR bytes
.TP
\fB-t,--scan-stream\fR
Scan every byte of the stream instead of using PES offsets
(this can show erroneous 'start code emulation' codes)
.SH "AUTHOR"
.PP
Kees Cook, <kees@outflux.net>
.SH "SEE ALSO"
.PP
gopchop(1), gtkspu(1)
|
