.TH "pgmtoy4m" "1" "16 December 2003" "y4mutils" "MJPEG tools manual"
.SH "نام (NAME)"
pgmtoy4m \- تبدیل خروجی pgm و pgmpipe ابزار mpeg2dec به YUV4MPEG2
.SH "خلاصه دستور (SYNOPSIS)"
.B pgmtoy4m
.RI [ گزینه‌ها ]
.SH "توضیحات (DESCRIPTION)"
\fBpgmtoy4m\fP خروجی PGM را از \fBmpeg2dec\fP مجدداً در قالب YUV4MPEG2 4:2:0p بسته‌بندی می‌کند.
هیچ تغییر واقعی در داده‌ها اعمال نمی‌شود. داده‌ها از قالب شبه-PGM باز شده
و با نسبت ابعاد نمونه (sample aspect)، نرخ فریم و ترتیب فیلد مشخص‌شده، در قالب
YUV4MPEG2 قرار می‌گیرند.
خروجی باید به یک لوله (pipe) یا یک فایل هدایت شود؛ باقی گذاشتن stdout روی
ترمینال خطایی ایجاد کرده و برنامه خارج خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
\fBpgmtoy4m\fP گزینه‌های زیر را می‌پذیرد:
.TP 5
.BI \-v " num"
تنظیم سطح پرگویی (verbosity).
(پیش‌فرض: 0)
.TP 5 
.BI \-h
چاپ خلاصهٔ نحوهٔ استفاده و خروج.
.TP 5
.BI \-i " t|b|p"
تنظیم حالت درهم‌بافی (interlacing). فیلد بالایی در ابتدا (t)، فیلد پایینی در ابتدا (b) یا 
پیش‌رونده/هیچ‌کدام (p).
(پیش‌فرض: t)
.TP 5
.BI \-a " sar"
تنظیم نسبت ابعاد نمونه (sample aspect ratio).
(پیش‌فرض: 10:11)
.TP 5
.BI \-r " frame rate"
تنظیم نرخ فریم.
(پیش‌فرض: 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)"
این برنامه به طور خاص برای کار با خروجی mpeg2dec طراحی شده است
و یک ابزار عمومی PGM (NetPBM) \fBنیست\fP!
.sp
از بخش مقدمه در فایل منبع:
.sp
.nf
 * یادداشت: mpeg2dec از گونه‌ای از قالب PGM استفاده می‌کند \- آن‌ها در واقع
 * "Grey Maps" نیستند، بلکه الحاقی از داده‌های 420P هستند (که معمولاً
 * "YUV" نامیده می‌شوند). نوع آن P5 ("raw") است و تعداد سطرها در واقع
 * مجموع ارتفاع‌های Y'، Cb و Cr است. داده‌های Cb و Cr به یکدیگر «متصل»
 * شده‌اند. پس از سطرهای Y'، به ازای هر «سطر» از داده‌های PGM، ۱ سطر Cb و ۱ سطر Cr
 * خواهید داشت.

 * نکته: ممکن است لازم باشد ترتیب فیلد (ابتدا فیلد بالایی/پایینی)،
 *      نسبت ابعاد نمونه و نرخ فریم را بدانید، زیرا قالب PGM هیچ‌یک
 *      از این اطلاعات را ارائه نمی‌دهد!
.fi
.SH "نویسندگان (AUTHORS)"
این صفحهٔ راهنما توسط Steven Schultz (sms at 2bsd dot com) نوشته شده است.
.SH "گزارش باگ‌ها (BUGS)"
احتمال آن وجود دارد، اما در حال حاضر موردی شناخته شده نیست.