.\"
.TH "pnmtoy4m" "1" "28 April 2004" "MJPEG Tools Team" "MJPEG tools manual"
.SH "نام (NAME)"
pnmtoy4m \- تبدیل تصاویر خام PNM/PPM به جریان ویدئویی YUV4MPEG2

.SH "خلاصه دستور (SYNOPSIS)"
.B pnmtoy4m
[\fIگزینه‌ها\fR]
[\fIنام‌فایل\fR]

.SH "توضیحات (DESCRIPTION)"
دستور
\fBpnmtoy4m\fP
یک یا چند تصویر خام PPM، PGM، PBM یا PAM را به یک جریان YUV4MPEG2 تبدیل می‌کند که آماده پردازش‌های بعدی توسط دیگر ابزارهای ویدئویی است.
این سه (یا چهار) قالب تصویری در مجموع به عنوان «تصاویر PNM» شناخته می‌شوند.

خروجی به صورت استاندارد (stdout) ارسال می‌شود تا ارسال مستقیم از طریق لوله (pipe) به دیگر ابزارهای MJPEG تسهیل گردد.
اندازه فریم(های) خروجی بر اساس (نخستین) تصویر ورودی تعیین می‌شود.

ورودی یک تصویر با قالب خام PNM است که از ورودی استاندارد (stdin) یا از نام‌فایل اختیاری خوانده می‌شود. ورودی ممکن است شامل چندین تصویر متوالی PNM باشد که به یکدیگر چسبانده شده‌اند؛
\fBpnmtoy4m\fP
آن‌ها را به ترتیب می‌خواند و پردازش می‌کند. تمام تصاویر باید اندازه و قالب یکسانی داشته باشند. تصاویر ورودی را می‌توان به صورت فریم‌های کامل پیش‌رونده (progressive)، جفت‌های فیلد درهم‌تنیده (interleaved fields)، یا فیلدهای متوالی (خوانده شده در جفت‌های تصویری) تفسیر کرد تا به عنوان فریم‌های درهم‌تنیده (interlaced) یا پیش‌رونده در خروجی تولید شوند.
تصاویر PPM و PGM باید ۸ بیت در هر کانال داشته باشند (یعنی مقدار 'maxval' باید ۲۵۵ باشد).

تصاویر ورودی PPM باید در فضای رنگی معمول R'G'B' باشند. آن‌ها قبل از ارسال به یک جریان YUV4MPEG2 از نوع "4:4:4" (بدون زیرنمونه‌برداری)، به فضای رنگی Y'CbCr (استاندارد ITU-R BT.601) تبدیل می‌شوند. اگر زیرنمونه‌برداری کروما مورد نیاز باشد (برای مثال به 4:2:0 برای MPEG)، خروجی باید علاوه بر این به برنامه‌ای مانند
\fBy4mscaler\fP
هدایت شود.

تصاویر PGM باید در فضای رنگی استاندارد طیف خاکستری با دامنه کامل ([0,255]) باشند. تصاویر PGM و PBM به لومای BT.601 تبدیل شده و به صورت جریان‌های YUV4MPEG2 تک‌رنگ ("MONO" - فقط لوما) در خروجی ارسال می‌شوند.

قالب PAM یک ابرمجموعه جدیدتر از قالب‌های PNM است؛ محتوای دقیق یک تصویر PAM توسط برچسب هدر TUPLTYPE مشخص می‌شود.
\fBpnmtoy4m\fP
مقدار TUPLTYPE از نوع "GRAYSCALE" را به عنوان PGM، "RGB" را به عنوان PPM، و "RGB_ALPHA" را به عنوان PPM با یک کانال آلفای ۸ بیتی پردازش می‌کند (کانال آلفا متناسب با جریان‌های YUV4MPEG2 به لومای BT.601 تبدیل می‌شود).

دستورهای
\fBpnmtoy4m\fP
و
\fBy4mtopnm\fP
معکوس یکدیگر هستند؛ می‌توانید خروجی یکی را به دیگری لوله‌کشی کنید و بالعکس. توجه داشته باشید که عملیات تبدیل فضای رنگی در هر دو جهت با افت کیفیت (lossy) همراه است. همچنین هنگام تبدیل به PNM، اطلاعات مربوط به درهم‌تنیدگی (interlacing) و نسبت ابعاد نمونه (sample aspect ratio) از دست می‌رود (اما می‌توان آن را با دادن آرگومان‌های خط فرمان به
\fBpnmtoy4m\fP
دوباره بازسازی کرد).


.SH "گزینه‌ها (OPTIONS)"
دستور
\fBpnmtoy4m\fP
گزینه‌های زیر را می‌پذیرد:

.TP 5
.BI \-o " num"
آفست فریم: از ارسال
.I num
فریم اول در خروجی صرف‌نظر می‌کند. (پیش‌فرض: 0)
.TP 5
.BI \-n " num"
در مجموع تعداد
.I num
فریم در خروجی تولید می‌کند. مقدار '0' برای مشخص کردن همه فریم‌ها به کار می‌رود.
(پیش‌فرض: 0)
.TP 5
.BI \-B
داده‌ها را به جای RGB به صورت BGR تفسیر می‌کند.
.TP 5
.BI \-r
آخرین فریم ورودی را تا زمان تکمیل خروجی تکرار می‌کند. اگر گزینه
.B \-n 0
نیز مشخص شده باشد، آخرین فریم ورودی تا ابد تکرار خواهد شد.
.TP 5
.BI \-D " x"
با هر تصویر PNM به عنوان یک فیلد تکی (تفکیک‌شده) به جای یک فریم کامل رفتار می‌کند. آرگومان نحوه تفسیر را مشخص می‌کند:
.nf
 t - نخستین تصویر یک فیلد بالایی (top-field) است
 b - نخستین تصویر یک فیلد پایینی (bottom-field) است
.fi

با این گزینه، برای هر فریم خروجی دو تصویر ورودی لازم خواهد بود.
مراقب باشید: عدم تطابق گزینه‌های
.B \-I
و
.B \-D
می‌تواند ترتیب زمانی یا مکانی فیلدها (یا هر دو) را معکوس کند.
.TP 5
.BI \-F " n:d"
نرخ فریم کدگذاری‌شده در جریان خروجی را به صورت نسبت صحیح دقیق تنظیم می‌کند.
(پیش‌فرض: 30000:1001) نرخ‌های متداول عبارتند از:
.nf
 24000:1001 - فیلم تبدیل‌شده با تبدیل NTSC 3:2 pulldown
       24:1 - فیلم بومی (native film)
       25:1 - سیستم PAL/SECAM
 30000:1001 - ویدئوی NTSC
       50:1 - نرخ فیلد PAL
 60000:1001 - نرخ فیلد NTSC
.fi
.TP 5
.BI \-A " n:d"
نسبت ابعاد پیکسل کدگذاری‌شده در جریان خروجی را به صورت نسبت صحیح دقیق تنظیم می‌کند.
(پیش‌فرض: 1:1) نسبت‌های متداول عبارتند از:
.nf
     1:1  - پیکسل‌های مربعی (گرافیک کامپیوتر)
    10:11 - CCIR-601 NTSC
    59:54 - CCIR-601 PAL
.fi
.TP 5
.BI \-I " x"
حالت درهم‌تنیدگی خروجی کدگذاری‌شده در جریان خروجی را تعیین می‌کند.
(پیش‌فرض مطابقت با
.B \-D
در صورت تعیین آن، یا 'p' در غیر این صورت است.)
.nf
 p - پیش‌رونده، غیر درهم‌تنیده (progressive)
 t - درهم‌تنیده با اولویت فیلد بالایی/فوقانی (top-field-first)
 b - درهم‌تنیده با اولویت فیلد پایینی/تحتانی (bottom-field-first)
.fi
.TP 5
.BI \-v " [0,1,2]"
سطح پرگویی خروجی را تعیین می‌کند.
.nf
 0 = فقط هشدارها و خطاها.
 1 = افزودن پیام‌های اطلاع‌رسانی.
 2 = افزودن پیام‌های پرحرف اشکال‌زدایی.
.fi

.SH "مثال‌ها (EXAMPLES)"
.hw pnmtoy4m yuvplay tgatoppm
برای تبدیل فایلی حاوی یک تصویر PPM به جریانی از ۱۵ فریم (یکسان):

.RS 5
pnmtoy4m -n 15 -r some-image.ppm
.RE

برای تبدیل مجموعه‌ای از تصاویر قالب Targa (در دایرکتوری جاری) به جریان YUV4MPEG2 که توسط yuvplay نمایش داده شود:

.RS 5
ls *.tga | xargs -n1 tgatoppm | pnmtoy4m | yuvplay
.RE

.SH "نویسنده (AUTHOR)"
این صفحه راهنما توسط Matt Marjanovic نوشته شده است.
.br
اگر سؤال، نظر یا مشکلی دارید یا می‌خواهید با توسعه‌دهندگان تماس بگیرید، لیست ایمیل اصلی برای MJPEG\-tools عبارت است از:
  \fImjpeg\-users@lists.sourceforge.net\fP

.TP
برای اطلاعات بیشتر، به وب‌سایت ما مراجعه کنید:
.I http://mjpeg.sourceforge.net

.SH "همچنین ببینید (SEE ALSO)"
.BR pam (5),
.BR pbm (5),
.BR pgm (5),
.BR pnm (5),
.BR ppm (5),
.BR y4mtopnm (1),
.BR mjpegtools (1),
.BR mpeg2enc (1),
.BR y4mscaler (1),
.BR yuv2lav (1),
.BR yuvplay (1)