iso13818ts.1

mpeg 解复用

.\" Man page for iso13818ts
.\"
.\" Copyright (C) GPL 2001, Convergence Integrated Media GmbH
.\" Copyright (C) GPL 2004, Oskar Schirmer
.\"
.TH iso13818ts 1 "June 17th, 2004" "1.0.2" "Multiplexer"
.SH NAME
iso13818ts \- multiplexer for ISO 13818 transport streams
.SH SYNOPSIS
iso13818ts [COMMAND...]
.SH DESCRIPTION
Generates an ISO 13818-1 conforming transport stream from multiple
input streams.
The result is sent to \fIstdout\fR,
the input streams are read from explicitely opened files.
All of the following commands may also be fed to \fIstdin\fR during
operation by omitting the leading hyphen (e.g. \fBQ\fR) or
double-hyphen (e.g. \fBquit\fR).
.TP
\fB\-\-help\fR
Display this help.
.TP
\fB\-V\fR, \fB\-\-version\fR
Output version information.
.TP
\fB\-Q\fR, \fB\-\-quit\fR
Quit this program.
.TP
\fB\-v\fR, \fB\-\-verbose\fR [\fIlevel\fR]
Verbose mode, \fIlevel\fR = 0..6, default is 2 (providing warnings
concerning data errors), initial verbosity is 1 (providing only
program errors).
.TP
\fB\-p\fR, \fB\-\-pes\fR \fIfile\fR \fItarget_program\fR
Open a PES input \fIfile\fR,
output the contained stream as \fItarget_program\fR (range 0x0001..0xFFFF).
.TP
\fB\-p\fR, \fB\-\-pes\fR \fIfile\fR \fItarget_program\fR \fItarget_stream_id\fR
Open a PES input \fIfile\fR,
output the contained stream in \fItarget_program\fR (range 0x0001..0xFFFF)
with \fItarget_stream_id\fR (recommended range 0xBD..0xFE).
The \fIfile\fR may be specified as \fB=\fR to denote
the last previously mentioned file.
.TP
\fB\-P\fR, \fB\-\-ps\fR \fIfile\fR \fItarget_program\fR
Open a PS input \fIfile\fR,
output the contained program as \fItarget_program\fR (range 0x0001..0xFFFF).
.TP
\fB\-P\fR, \fB\-\-ps\fR \fIfile\fR \fItarget_program\fR \fIsource_stream_id\fR [\fItarget_stream_id\fR]
Open a PS input \fIfile\fR,
extract the stream with \fIsource_stream_id\fR (range 0x00..0xFF)
and output that stream in \fItarget_program\fR (range 0x0001..0xFFFF)
with \fItarget_stream_id\fR (recommended range 0xBD..0xFE).
If no \fItarget_stream_id\fR is given, \fIsource_stream_id\fR is used instead.
The \fIfile\fR may be specified as \fB=\fR to denote
the last previously mentioned file.
.TP
\fB\-T\fR, \fB\-\-ts\fR \fIfile\fR
Open a TS input \fIfile\fR,
extract all programs from it and output them.
Note, that additional SI data is not propagated,
see command \fB\-\-si\fR for further information.
.TP
\fB\-T\fR, \fB\-\-ts\fR \fIfile\fR \fIsource_program\fR [\fItarget_program\fR]
Open a TS input \fIfile\fR,
extract the program \fIsource_program\fR (range 0x0001..0xFFFF)
and output that program as \fItarget_program\fR (range 0x0001..0xFFFF).
If no \fItarget_program\fR is given,
don't change the \fIsource_program\fR number.
The \fIfile\fR may be specified as \fB=\fR to denote
the last previously mentioned file.
.TP
\fB\-T\fR, \fB\-\-ts\fR \fIfile\fR \fIsource_program\fR \fItarget_program\fR \fIsource_stream_id\fR [\fItarget_stream_id\fR]
Open a TS input \fIfile\fR,
extract the stream with \fIsource_stream_id\fR (range 0x00..0xFF)
from the program \fIsource_program\fR (range 0x0001..0xFFFF)
and output that stream as \fItarget_stream_id\fR (recommended range 0xBD..0xFE)
in program \fItarget_program\fR (range 0x0001..0xFFFF).
If no \fItarget_stream_id\fR is given, use \fIsource_stream_id\fR instead.
The \fIfile\fR may be specified as \fB=\fR to denote
the last previously mentioned file.
.TP
\fB\-T\fR, \fB\-\-ts\fR \fIfile\fR 0 \fItarget_program\fR \fIsource_stream_id\fR [\fItarget_stream_id\fR]
As before, but extract a stream with \fIsource_stream_id\fR (range 0x00..0xFF)
from a transport stream with broken or missing PAT/PMT information.
The stream is opened only, if there is \fBnot\fR any entry in the
tables for that stream.
Note, that if there is more than one stream with the given
\fIsource_stream_id\fR,
only one matching stream will be opened, and
the choice is not deterministic.
.TP
\fB\-c\fR, \fB\-\-close\fR \fIfile\fR
Close input \fIfile\fR, as if eof is reached.
In combination with \fB\-\-repeat\fR this causes the next repeatition
to start immediately.
Note, that the input data file is cut of as is, i.e. no attempt
is made to close the file on a clean audio or video frame boundary.
.TP
\fB\-a\fR, \fB\-\-append\fR \fIfile1\fR \fIfile2\fR [\fInum\fR]
Earmark another \fIfile2\fR to be opened as soon as \fIfile1\fR
comes to its end.
The appended \fIfile2\fR is foreseen to be repeated \fInum\fR
times, default is 1 (see \fB\-\-repeat\fR).
Both files must contain the same type of data,
as the data of both files is chained without considering clean
transition of audio or video sequences.
The \fIfile1\fR may be specified as \fB=\fR to denote
the last previously mentioned file.
.TP
\fB\-f\fR, \fB\-\-file\fR \fIreference_number\fR \fIfile_name\fR
The positive \fIreference_number\fR is associated with a \fIfile_name\fR.
For all following commands, the \fIreference_number\fR may be
used instead of the \fIfile_name\fR. This allows better control
over file handles, as the same file may be addressed via different
\fIreference_number\fRs.
.TP
\fB\-x\fR, \fB\-\-crop\fR \fItarget_program\fR [\fItarget_stream_id\fR]
Delete a stream given by \fItarget_stream_id\fR,
or a complete program given by \fItarget_program\fR
from the output.
The corresponding input file(s) will be closed, if not needed otherwise.
.TP
\fB\-r\fR, \fB\-\-repeat\fR \fIfile\fR \fInum\fR
Set the repeatition counter for \fIfile\fR to \fInum\fR
(or to infinite if \fInum\fR=0).
The file will be reset as soon as eof is reached
(or it is closed by the command \fB\-\-close\fR).
Note, that the file will be reset without considering clean transition
of audio or video sequences at the restart point.
The \fIfile\fR may be specified as \fB=\fR to denote
the last previously mentioned file.
.TP
\fB\-R\fR, \fB\-\-reopen\fR
This command shall precede one of the commands that open a new file
(i.e. \fB\-\-pes\fR, \fB\-\-ps\fR or \fB\-\-ts\fR must follow
\fIon the same line\fR).
The next file will be opened with a new file handle,
regardless of whether the same file is yet open or not.
.TP
\fB\-\-si\fR \fIfile\fR [\fIlower_bound\fR \fIupper_bound\fR]
In a TS \fIfile\fR, all TS pakets with PID in the range
from \fIlower_bound\fR to \fIupper_bound\fR
(possible range 0x0001..0x1FFE, recommended range 0x10..0x1F)
inclusive are handled as SI pakets (according to ETSI EN 300 468).
These pakets are bypassed and promoted to the output without further handling.
If no further data from the \fIfile\fR is in use,
the SI pakets are promoted \fIgreedy\fR, i.e. without any timing or delay. 
If \fIlower_bound\fR and \fIupper_bound\fR are omitted,
the special handling of SI pakets is turned off for the given \fIfile\fR.
\fBNOTE, that the \fIfile\fB must be opened with \-\-ts before!\fR
The \fIfile\fR may be specified as \fB=\fR to denote
the last previously mentioned file.
.TP
\fB\-\-sipid\fR \fItarget_program\fR [\fIpid\fR [\fIstream_type\fR]]
Manually add or delete entries to the target PMT for the given
\fItarget_program\fR.
To add an entry, all three parameters must be provided.
If an entry for the given \fIpid\fR (range 0x0001..0x1FFE) does exist,
the new \fIstream_type\fR (range 0x00..0xFF) is set
and all descriptors are cleared.
If no \fIstream_type\fR is given, a corresponding entry
in the PMT is deleted,
if it was added thru \fB\-\-sipid\fR earlier.
If no \fIpid\fR and no \fIstream_type\fR is given, all
entries for the \fItarget_program\fR in the PMT are deleted,
which have been added thru \fB\-\-sipid\fR earlier.
Note, that regular entries, i.e. those which are generated
automatically instead of using \fB\-\-sipid\fR,
cannot be changed.
Note, that entries added through \fB\-\-sipid\fR are
solely entries in the PMT, but there is not any corresponding
data stream created.
\fB\-\-sipid\fR is meant to be used in conjunction
with the \fB\-\-si\fR command, which in turn causes
data to arise in the target stream without listing it
in the PMT.
.TP
\fB\-\-descr\fR \fItarget_program\fR [\fIdescr_tag\fR [\fIdescr_length\fR \fIdata\fR...]]
Add, inhibit or delete in the PMT section a descriptor,
that does \fBnot\fR belong to a specific stream.
To add a descriptor, all parameters must be given,
\fIdescr_tag\fR (range 0x00..0xFF),
\fIdescr_length\fR (range 1..255),
and the appropriate amount of bytes given as \fIdata\fR (range 0x00..0xFF).
To inhibit any descriptor with a given \fIdescr_tag\fR,
\fIdescr_length\fR is set to \fB0\fR and no \fIdata\fR is given.
This causes matching descriptors from input streams to
be discarded instead of being copied to the target stream.
To delete the manual setting of a descriptor,
\fIdescr_length\fR is omitted. This causes descriptors
with matching \fIdescr_tag\fR to be passed from input to
the target stream.
To delete all manual settings for a \fItarget_program\fR,
that do \fBnot\fR belong to a specific stream,
the \fIdescr_tag\fR is omitted, too.
Note, that \fB\-\-descr\fR never modifies descriptors,
that belong to a specific stream.
To modify these, use the command \fB\-\-sdescr\fR or \fB\-\-pdescr\fR.
.TP
\fB\-\-sdescr\fR [\fItarget_program\fR [\fIstream_id\fR [\fIdescr_tag\fR [\fIdescr_length\fR \fIdata\fR...]]]]
Add, inhibit or delete in the PMT section a descriptor,
that does belong to a specific stream.
To add a descriptor, all parameters must be given,
\fIstream_id\fR (recommended range 0xBD..0xFE),
\fIdescr_tag\fR (range 0x00..0xFF),
\fIdescr_length\fR (range 1..255),
and the appropriate amount of bytes given as \fIdata\fR (range 0x00..0xFF).
To inhibit any descriptor with a given \fIdescr_tag\fR,
\fIdescr_length\fR is set to \fB0\fR and no \fIdata\fR is given.
This causes matching descriptors from the corresponding input streams to
be discarded instead of being copied to the target stream.
To delete the manual setting of a descriptor,
\fIdescr_length\fR is omitted. This causes descriptors
with matching \fIdescr_tag\fR to be passed from input to
the target stream.
To delete all manual settings for a \fIstream_id\fR in
the \fItarget_program\fR,
the \fIdescr_tag\fR is omitted, too.
To delete all manual settings for all streams \fBand\fR those
that do not belong to a specific stream,
the \fIstream_id\fR is omitted, too.
Finally, to delete all manual settings in all programs,
all parameters are omitted.
.TP
\fB\-\-pdescr\fR [\fItarget_program\fR [\fIpid\fR [\fIdescr_tag\fR [\fIdescr_length\fR \fIdata\fR...]]]]
Add, inhibit or delete in the PMT section a descriptor,
that does belong to a specific stream.
To add a descriptor, all parameters must be given,
\fIpid\fR (range 0x0001..0x1FFE),
\fIdescr_tag\fR (range 0x00..0xFF),
\fIdescr_length\fR (range 1..255),
and the appropriate amount of bytes given as \fIdata\fR (range 0x00..0xFF).
To inhibit any descriptor with a given \fIdescr_tag\fR,
\fIdescr_length\fR is set to \fB0\fR and no \fIdata\fR is given.
This causes matching descriptors from the corresponding input streams to
be discarded instead of being copied to the target stream.
To delete the manual setting of a descriptor,
\fIdescr_length\fR is omitted. This causes descriptors
with matching \fIdescr_tag\fR to be passed from input to
the target stream.
To delete all manual settings for a \fIpid\fR in
the \fItarget_program\fR,
the \fIdescr_tag\fR is omitted, too.
To delete all manual settings for all streams \fBand\fR those
that do not belong to a specific stream,
the \fIpid\fR is omitted, too.
Finally, to delete all manual settings in all programs,
all parameters are omitted.
Note, that, in contrast to \fB\-\-descr\fR and \fB\-\-sdescr\fR,
with \fB\-\-pdescr\fR it is possible to set
descriptors for PMT entries, that have been added using \fB\-\-sipid\fR.
.TP
\fB\-I\fR, \fB\-\-ident\fR \fItransport_stream_id\fR
Set the output \fItransport_stream_id\fR (range 0x0000..0xFFFF).
.TP
\fB\-B\fR, \fB\-\-busy\fR [\fInum\fR]
Set the busy flag to \fInum\fR (range 0..1, default is 1, initial is 0).
Whenever the program has no more data to handle and
the busy flag is not set, it stops.
.TP
\fB\-\-timed\fR
Force delay timing, even if solely disk files are in use.
If not so, if delay is to be awaited while processing regular files,
the delay is skipped instead and timing information in the resulting
file is adjusted accordingly.
.TP
\fB\-F\fR, \fB\-\-fpsi\fR \fItime\fR
Set the PSI table frequency to \fItime\fR msec
(or to infinite if \fItime\fR=0, initial value is infinite).
The PAT and PMT will be generated at more or less the given
frequency, even if the tables did not change.
In any case, the next tables will be generated immediately.
.TP
\fB\-\-trigin\fR \fItime\fR
Set the input buffer trigger timing to \fItime\fR.
For any input stream, that is newly opened
(or has to be retriggered, e.g. due to intermediate emptiness),
the buffer is triggered for promotion to the splice unit
with a delay of \fItime\fR msec compared to the time
of data entrance into the buffer.
For any stream yet triggered the timing is not changed
unless retriggering takes place.
Not affected by this value are the other trigger conditions,
mainly a certain buffer fullness
and cotriggering with a corresponding stream that is triggered.
.TP
\fB\-\-trigout\fR \fItime\fR
Set the output buffer trigger timing to \fItime\fR.
As the output buffer is triggered for promotion to \fIstdout\fR,
this is done with a delay of \fItime\fR msec compared to the time
of data entrance into the buffer.
The new timing is only valid if set before the first triggering
of the output buffer,
or if retriggering takes place, e.g. due to intermediate emptiness.
Not affected by this value is the trigger condition
of a certain buffer fullness.
.TP
\fB\-C\fR, \fB\-\-config\fR \fInum\fR
Order output configuration of target stream with \fInum\fR=1,
switch off with \fInum\fR=0.
Set \fInum\fR=2, to get information about descriptors, too.
When switched on, the configuration is printed each time it changes.
First, the number of programs is printed,