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
|
.TH "pgmtoy4m" "1" "16 December 2003" "y4mutils" "MJPEG tools manual"
.SH "NAME"
pgmtoy4m \- Convert mpeg2dec pgm and pgmpipe output to YUV4MPEG2
.SH "SYNOPSIS"
.B pgmtoy4m
.RI [ options ]
.SH "DESCRIPTION"
\fBpgmtoy4m\fP repacks the PGM output from \fBmpeg2dec\fP into YUV4MPEG2
4:2:0p. No actual changes to the data are made. The data is unpacked from
the quasi-PGM format and placed in YUV4MPEG2 format with the specified
sample aspect, frame rate and field order.
Output must be either to a pipe or a file, leaving stdout as a terminal will
elicit an error and the program will exit.
.SH "OPTIONS"
\fBpgmtoy4m\fP accepts the following options:
.TP 5
.BI \-v " num"
Set verbosity level.
(default: 0)
.TP 5
.BI \-h
Print a usage summary and exit.
.TP 5
.BI \-i " t|b|p"
Set the interlacing mode. Top field first (t), bottom field first (b) or
progressive/none (p).
(default: t)
.TP 5
.BI \-a " sar"
Set the sample aspect ratio.
(default: 10:11)
.TP 5
.BI \-r " frame rate"
Set the frame rate.
(default: 30000:1001)
.SH "EXAMPLES"
.nf
mpeg2dec -s -o pgmpipe file.mpg | pgmtoy4m -a 10:11 -r 24000:1001 -i b | yuvplay
.sp
mpeg2dec -s -o pgm file.mpg
cat *.pgm | pgmtoy4m -r 30000:1001 -i t | yuvplay
.fi
.SH "NOTES"
This program is specifically designed to work with the output of mpeg2dec
and is \fBNOT\fP a general PGM (NetPBM) tool!
.sp
From the introduction in the source file:
.sp
.nf
* Note: mpeg2dec uses a variation of the PGM format - they're really not
* "Grey Maps" but rather a catenation of the 420P data (commonly called
* "YUV"). The type is P5 ("raw") and the number of rows is really
* the total of the Y', Cb and Cr heights. The Cb and Cr data is "joined"
* together. After the Y' rows you have 1 row of Cb and 1 row of Cr per
* "row" of PGM data.
* NOTE: You MAY need to know the field order (top/bottom field first),
* sample aspect ratio and frame rate because the PGM format makes
* none of that information available!
.fi
.SH "AUTHOR"
This manpage was written by Steven Schultz (sms at 2bsd dot com).
.SH "BUGS"
Possible but none known at the present time.
|