NAME
tcdemux - demultiplex a program stream
SYNOPSIS
tcdemux
-i name [ -t magic ] [ -x codec ] [ -S unit,[s1-s2] ] [ -a
ach,[vch] ] [ -s 0xnn ] [ -M mode ] [ -f fps ] [ -W ] [ -O ] [
-P name ] [ -A n[,m[,...]] ] [ -d verbosity ] [ -v ]
COPYRIGHT
tcdemux is Copyright (C) by Thomas Oestreich.
DESCRIPTION
tcdemux is part of and usually called by transcode.
However, it can also be used independently.
tcdemux reads source (from stdin if not explicitely defined) and prints
on the standard output.
OPTIONS
-i name
Specify input source. If ommited, stdin is assumed.
-x codec
Process only packets containing given codec as payload.
Examples are "mpeg2" for MPEG video or "ac3" for audio packets.
-t magic
Specify the input file type magic. Useful for using tcdemux in
pipelines. This is normally autodetected.
-a ach[,vch]
Process only packets containing given audio track ach and video
track vch. Most program stream feature multiple audio tracks
but only a single video stream. Default is "-a 0,0".
-s 0xnn
Select specific multimedia track using the standard identifier
0xnn. This useful to extract subtitle packets.
-f fps Specify the frame rate fps for subtitle meta information used by
external applications.
-S unit[,s1-s2]
Select a program unit unit and a selected GOP range s1-s2 for
processing. A unit is usually a set of GOPs that need to be
synchronized at the very beginning. This option can be used to
eleminate junk units at the beginning of the main presentation
or to select certain episodes of a TV series from a DVD. A GOP
is a logical unit to be properly decoded, i.e., decoding can
only start at the beginning of a GOP.
-O Do not skip initial sequence. Used internally by transcode.
-A n[,m[,...]]
Select packets using an identifier for extracting only selected
streams without processing. This is useful for size reduction of
your multimedia stream. Example:
tcdemux -i big_dvd.vob -A 0xe0,0x81,0x20 > small_dvd.vob
extracts all packets for the video stream, AC3 audio track (1)
and the first subtitle stream (0).
-M mode
Select synchronization strategy mode. This is how transcode
selects the beginning of a video and audio stream to assure both
streams are sychronized for further processing:
0 no synchronization. Packets are printed directly to stdout.
1 synchronization based on PTS information found in the
packet header. Audio packets are delayed until a suitable
starting point is found. Default for PAL videos.
2 NTSC adapted synchronization mode. Detailed information for
each GOP contained in the video stream are piped to a stdout to
be processed by the certain import modules. This enables
adjusting the frame rate or inverse telecine, if necessary.
3 more advanced synchronization mode 1 with msec granular
adjustment. Details delegated to transcode.
4 more advanced synchronization mode 2 with msec granular
adjustment for NTSC materail. Details delegated to transcode.
5-7 undocumented debugging modes for internal use.
-P file
Write GOP meta information to file instead of tdout.
-W Print a navigation log file for a given video stream to stdout.
This is used for transcode's "psu mode" and "cluster mode".
-d level
With this option you can specify a bitmask to enable different
levels of verbosity (if supported). You can combine several
levels by adding the corresponding values:
QUIET 0
INFO 1
DEBUG 2
STATS 4
WATCH 8
FLIST 16
VIDCORE 32
SYNC 64
COUNTER 128
PRIVATE 256
-v Print version information and exit.
NOTES
tcdemux is a front end for de-multiplexing program streams and is used
in transcode's import modules.
EXAMPLES
The command
tcprobe -i movie.vob -x mpeg2
extracts only MPEG video packets. Further processing, i.e., extracting
the elementary video stream is done by tcextract.
AUTHORS
tcdemux was written by Thomas Oestreich
<ostreich@theorie.physik.uni-goettingen.de> with contributions from
many others. See AUTHORS for details.
SEE ALSO
avifix(1), avimerge(1), avisplit(1), tcdecode(1), tcdemux(1),
tcextract(1), tccat(1), tcscan(1), transcode(1)