Tcdemux

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 Ostreich.

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 pay-
	      load.  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 fea-
	      ture 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 infor-
	      mation 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	presenta-
	      tion  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  sup-
	      ported).	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 Ostreich
       <ostreich@theorie.physik.uni-goettingen.de> with contribu-
       tions from many others.	See AUTHORS for details.

SEE ALSO

       avifix(1),  avimerge(1),	 avisplit(1),  tcdecode(1), tcde-
       mux(1), tcextract(1), tccat(1), tcscan(1), transcode(1)