summaryrefslogtreecommitdiffstats
path: root/multimedia/tstools/man/ps2ts.1
blob: 783e082e58a41c958423f7526a763f4c81cc9c68 (plain)
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
.TH PS2TS "1" "November 2008" "ps2ts 1.11" "User Commands"
.SH NAME
ps2ts \- Convert an H.222 program stream to H.222 transport stream
.SH SYNOPSIS
.B ps2ts
[\fIswitches\fR] \fI<infile>\fR \fI<outfile>\fR
.SH DESCRIPTION
.IP
TS tools version 1.11, ps2ts built Nov 11 2008 17:15:47
.IP
Convert an H.222 program stream to H.222 transport stream.
.IP
This program does not make use of any Program Stream Map packets
in the data (mainly because I have yet to see data with any). This
means that the program has to determine the stream type of the data
based on the first few ES units.
.IP
This program does not output more than one video and one audio
stream. If the program stream data contains more than one of each,
the first will be used, and the others ignored (with a message
indicating this).
.IP
It is assumed that the video stream will contain DTS values in its
PES packets at reasonable intervals, which can be used as PCR values
in the transport stream, and thus the video stream's PID can be used
as the PCR PID in the transport stream.
.SS "Files:"
.TP
<infile>
is a file containing the program stream data
(but see \fB\-stdin\fR below)
.TP
<outfile>
is an transport stream file
(but see \fB\-stdout\fR and \fB\-host\fR below)
.SS "Input switches:"
.TP
\fB\-stdin\fR
Take input from <stdin>, instead of a named file
.TP
\fB\-dvd\fR
The PS data is from a DVD. This is the default.
This switch has no effect on MPEG\-1 PS data.
.TP
\fB\-notdvd\fR, \fB\-nodvd\fR
The PS data is not from a DVD.
The DVD specification stores AC\-3 (Dolby), DTS and
other audio in a specialised manner in private_stream_1.
.TP
\fB\-vstream\fR <n>
Take video from video stream <n> (0..7).
The default is the first video stream found.
.TP
\fB\-astream\fR <n>
Take audio from audio stream <n> (0..31).
The default is the first audio stream found
(this includes private_stream_1 on non\-DVD streams).
.TP
\fB\-ac3stream\fR <n>
Take audio from AC3 substream <n> (0..7), from
private_stream_1. This implies \fB\-dvd\fR.
(If audio is being taken from a substream, the user
is assumed to have determined which one is wanted,
e.g., using psreport)
.SS "Output switches:"
.TP
\fB\-stdout\fR
Write output to <stdout>, instead of a named file
Forces \fB\-quiet\fR.
.TP
\fB\-host\fR <host>, \fB\-host\fR <host>:<port>
Writes output (over TCP/IP) to the named <host>,
instead of to a named file. If <port> is not
specified, it defaults to 88.
.TP
\fB\-vpid\fR <pid>
<pid> is the video PID to use for the data.
Use '\-vpid 0x<pid>' to specify a hex value.
Defaults to 0x68.
.TP
\fB\-apid\fR <pid>
<pid> is the audio PID to use for the data.
Use '\-apid 0x<pid>' to specify a hex value.
Defaults to 0x67.
.TP
\fB\-noaudio\fR
Don't output the audio data
.TP
\fB\-pmt\fR <pid>
<pid> is the PMT PID to use.
Use '\-pmt 0x<pid>' to specify a hex value.
Defaults to 0x66
.TP
\fB\-prepeat\fR <n>
Output the program data (PAT/PMT) after every <n>
PS packs. Defaults to 100.
.TP
\fB\-pad\fR <n>
Pad the start with <n> filler TS packets, to allow
a TS reader to synchronize with the datastream.
Defaults to 8.
.SS "General switches:"
.TP
\fB\-verbose\fR, \fB\-v\fR
Print a 'v' for each video packet and an 'a' for
each audio packet, as it is read
.TP
\fB\-quiet\fR, \fB\-q\fR
Only output error messages
.TP
\fB\-max\fR <n>, \fB\-m\fR <n>
Maximum number of PS packs to read
.SS "Stream type:"
.IP
When the TS data is being output, it is flagged to indicate whether
it conforms to H.262, H.264, etc. It is important to get this right, as
it will affect interpretation of the TS data.
.IP
If input is from a file, then the program will look at the start of
the file to determine if the stream is H.264 or H.262 data. This
process may occasionally come to the wrong conclusion, in which case
the user can override the choice using the following switches.
.IP
If input is from standard input (via \fB\-stdin\fR), then it is not possible
for the program to make its own decision on the input stream type.
Instead, it defaults to H.262, and relies on the user indicating if
this is wrong.
.TP
\fB\-h264\fR, \fB\-avc\fR
Force the program to treat the input as MPEG\-4/AVC.
.TP
\fB\-h262\fR
Force the program to treat the input as MPEG\-2.
.TP
\fB\-mp42\fR
Force the program to treat the input as MPEG\-4/Part 2.
.TP
\fB\-vtype\fR <type>
Force the program to treat the input as video of
stream type <type> (e.g., 0x42 means AVS video). It is
up to the user to specify a valid <type>.
.IP
If the audio stream being output is Dolby (AC\-3), then the stream type
used to output it differs for DVB (European) and ATSC (USA) data. It
may be specified as follows:
.TP
\fB\-dolby\fR dvb
Use stream type 0x06 (the default)
.TP
\fB\-dolby\fR atsc
Use stream type 0x81
.IP
TS tools version 1.11, ps2ts built Nov 11 2008 17:15:47
.IP
Convert an H.222 program stream to H.222 transport stream.
.IP
This program does not make use of any Program Stream Map packets
in the data (mainly because I have yet to see data with any). This
means that the program has to determine the stream type of the data
based on the first few ES units.
.IP
This program does not output more than one video and one audio
stream. If the program stream data contains more than one of each,
the first will be used, and the others ignored (with a message
indicating this).
.IP
It is assumed that the video stream will contain DTS values in its
PES packets at reasonable intervals, which can be used as PCR values
in the transport stream, and thus the video stream's PID can be used
as the PCR PID in the transport stream.
.SS "Files:"
.TP
<infile>
is a file containing the program stream data
(but see \fB\-stdin\fR below)
.TP
<outfile>
is an transport stream file
(but see \fB\-stdout\fR and \fB\-host\fR below)
.SS "Input switches:"
.TP
\fB\-stdin\fR
Take input from <stdin>, instead of a named file
.TP
\fB\-dvd\fR
The PS data is from a DVD. This is the default.
This switch has no effect on MPEG\-1 PS data.
.TP
\fB\-notdvd\fR, \fB\-nodvd\fR
The PS data is not from a DVD.
The DVD specification stores AC\-3 (Dolby), DTS and
other audio in a specialised manner in private_stream_1.
.TP
\fB\-vstream\fR <n>
Take video from video stream <n> (0..7).
The default is the first video stream found.
.TP
\fB\-astream\fR <n>
Take audio from audio stream <n> (0..31).
The default is the first audio stream found
(this includes private_stream_1 on non\-DVD streams).
.TP
\fB\-ac3stream\fR <n>
Take audio from AC3 substream <n> (0..7), from
private_stream_1. This implies \fB\-dvd\fR.
(If audio is being taken from a substream, the user
is assumed to have determined which one is wanted,
e.g., using psreport)
.SS "Output switches:"
.TP
\fB\-stdout\fR
Write output to <stdout>, instead of a named file
Forces \fB\-quiet\fR.
.TP
\fB\-host\fR <host>, \fB\-host\fR <host>:<port>
Writes output (over TCP/IP) to the named <host>,
instead of to a named file. If <port> is not
specified, it defaults to 88.
.TP
\fB\-vpid\fR <pid>
<pid> is the video PID to use for the data.
Use '\-vpid 0x<pid>' to specify a hex value.
Defaults to 0x68.
.TP
\fB\-apid\fR <pid>
<pid> is the audio PID to use for the data.
Use '\-apid 0x<pid>' to specify a hex value.
Defaults to 0x67.
.TP
\fB\-noaudio\fR
Don't output the audio data
.TP
\fB\-pmt\fR <pid>
<pid> is the PMT PID to use.
Use '\-pmt 0x<pid>' to specify a hex value.
Defaults to 0x66
.TP
\fB\-prepeat\fR <n>
Output the program data (PAT/PMT) after every <n>
PS packs. Defaults to 100.
.TP
\fB\-pad\fR <n>
Pad the start with <n> filler TS packets, to allow
a TS reader to synchronize with the datastream.
Defaults to 8.
.SS "General switches:"
.TP
\fB\-verbose\fR, \fB\-v\fR
Print a 'v' for each video packet and an 'a' for
each audio packet, as it is read
.TP
\fB\-quiet\fR, \fB\-q\fR
Only output error messages
.TP
\fB\-max\fR <n>, \fB\-m\fR <n>
Maximum number of PS packs to read
.SS "Stream type:"
.IP
When the TS data is being output, it is flagged to indicate whether
it conforms to H.262, H.264, etc. It is important to get this right, as
it will affect interpretation of the TS data.
.IP
If input is from a file, then the program will look at the start of
the file to determine if the stream is H.264 or H.262 data. This
process may occasionally come to the wrong conclusion, in which case
the user can override the choice using the following switches.
.IP
If input is from standard input (via \fB\-stdin\fR), then it is not possible
for the program to make its own decision on the input stream type.
Instead, it defaults to H.262, and relies on the user indicating if
this is wrong.
.TP
\fB\-h264\fR, \fB\-avc\fR
Force the program to treat the input as MPEG\-4/AVC.
.TP
\fB\-h262\fR
Force the program to treat the input as MPEG\-2.
.TP
\fB\-mp42\fR
Force the program to treat the input as MPEG\-4/Part 2.
.TP
\fB\-vtype\fR <type>
Force the program to treat the input as video of
stream type <type> (e.g., 0x42 means AVS video). It is
up to the user to specify a valid <type>.
.IP
If the audio stream being output is Dolby (AC\-3), then the stream type
used to output it differs for DVB (European) and ATSC (USA) data. It
may be specified as follows:
.TP
\fB\-dolby\fR dvb
Use stream type 0x06 (the default)
.TP
\fB\-dolby\fR atsc
Use stream type 0x81
.SH "SEE ALSO"
The full documentation for
.B ps2ts
is maintained as a Texinfo manual.
Please check http://tstools.berlios.de for more information.