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