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

.SH "خلاصه دستور (SYNOPSIS)"
.B y4mtopnm
.RI [ options ]

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

خروجی به stdout فرستاده می‌شود (اما می‌توانید از طریق پوسته آن را به یک فایل هدایت کنید).

ورودی مانند همه پالایه‌ها و ابزارهای دیگر YUV4MPEG2 از stdin خوانده می‌شود. جریان‌های YUV4MPEG2 حاوی فریم‌هایی با استفاده از فضای رنگی Y'CbCr (استاندارد ITU-R BT.601) هستند. برای جریان‌های 4:4:4 (رنگی)، \fBy4mtopnm\fP هر پیکسل را به فضای رنگی معمول R'G'B' که برای گرافیک رایانه‌ای استفاده می‌شود تبدیل کرده و تصاویر PPM تولید می‌کند. جریان‌های «MONO» (تنها حاوی روشنایی یا luma) به طیف خاکستری با دامنه کامل [0,255] تبدیل شده و به صورت تصاویر PGM خروجی داده می‌شوند.

جریان‌های YUV4MPEG2 ممکن است (اغلب!) دارای صفحه‌های کروما با زیرنمونه‌برداری (subsampled) باشند، اما \fBy4mtopnm\fP آن‌ها را پردازش نخواهد کرد (مگر در حالت ویژه «flatten»؛ در زیر ببینید). جریان‌های زیرنمونه‌برداری‌شده باید با استفاده از ابزاری مانند \fBy4mscaler\fP به 4:4:4 تبدیل شوند.

اگر به \fBy4mtopnm\fP یک جریان «444ALPHA» (ویدئوی 4:4:4 همراه با یک کانال آلفای ۸ بیتی) داده شود، نتایج بستگی به این دارد که گزینه «-P» مشخص شده باشد یا خیر. با «-P»، تصاویر PAM با TUPLTYPE از نوع RGB_ALPHA تولید می‌کند که حاوی داده‌های هر دو کانال رنگ و آلفا هستند. بدون «-P»، جفت‌تصاویری از PPM و PGM تولید خواهد کرد: یک PPM برای پیکسل‌های رنگی و در پی آن یک PGM برای داده‌های کانال آلفا. (چنین توالی درهم‌آمیخته‌ای از تصاویر PPM و PGM را بعداً نمی‌توان دوباره توسط \fBpnmtoy4m\fP پردازش کرد. این ویژگی بیشتر برای اشکال‌زدایی سریع و ساده جریان است.)

اگر چندین تصویر خروجی تولید شوند، به سادگی یکی پس از دیگری در خروجی قرار می‌گیرند. اگر می‌خواهید چنین جریان/فایل «چند تصویری» را به فایل‌های مجزا تبدیل کنید، از \fBpnmsplit\fP استفاده کنید. (برخی پالایه‌های PNM می‌توانند فایل‌ها/جریان‌های چند تصویری را پردازش کنند؛ با این حال، بسیاری از مواردی که قبل از ژوئن ۲۰۰۰ نوشته شده‌اند تنها تصویر اول را پردازش خواهند کرد.)

\fBy4mtopnm\fP و \fBpnmtoy4m\fP معکوس یکدیگر هستند؛ معمولاً می‌توانید خروجی یکی را با لوله‌کشی (pipe) به دیگری بفرستید، و برعکس (به جز مورد «444ALPHA» که در بالا ذکر شد و مورد «mixed-mode» که در زیر به آن اشاره شده است). توجه داشته باشید که عملیات فضای رنگی ممکن است در هر دو جهت اتلافی (lossy) باشد (به دلیل فشرده‌سازی دامنه و/یا کوانتیزاسیون). همچنین هنگام تبدیل به PNM، اطلاعات مربوط به درهم‌بافی (interlacing) و نسبت ابعاد نمونه (sample aspect ratio) یک جریان از بین می‌رود (اما با دادن آرگومان‌های خط فرمان به \fBpnmtoy4m\fP قابل بازسازی است).

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

.TP 5
.BI \-P
تولید خروجی در قالب PAM به جای PPM و/یا PGM. قالب PAM می‌تواند ابرمجموعه‌ای از PNM را کدگذاری کند، اما هنوز توسط بسیاری از برنامه‌های گرافیکی شناخته‌شده نیست. (در واقع، به شکلی شگفت‌آور تعداد اندکی از ابزارهای NetPBM به نظر می‌رسد که آن را درک می‌کنند.)
.TP 5
.BI \-D
تولید یک تصویر خروجی مجزا برای هر میدان (field) از هر فریم. (در غیر این صورت، برای هر فریم یک تصویر واحد، حاوی دو میدان درهم‌بافته، ایجاد می‌شود.)

اگر جریان ورودی درهم‌بافته (interlaced) باشد، تصاویر میدان به ترتیب زمانی خروجی داده می‌شوند؛ یعنی اولین تصویر یک جریان bottom-field-first، میدان پایینی خواهد بود.
اگر جریان پیش‌رونده (progressive) باشد یا درهم‌بافی «حالت ترکیبی» (mixed-mode) داشته باشد، ترتیب زمانی مبهم خواهد بود و همیشه میدان بالایی ابتدا خروجی داده می‌شود.

توجه داشته باشید که بعداً بازسازی یک جریان «mixed-mode» از یک توالی تصاویر PNM/PAM با استفاده از \fBpnmtoy4m\fP امکان‌پذیر \fIنخواهد\fP بود.
.TP 5
.BI \-f
تولید یک خروجی ویژه «مسطح‌شده» (flattened)، که بیشترین کاربرد را برای تحلیل و اشکال‌زدایی جریان‌ها دارد. تمامی صفحه‌های یک فریم/میدان مانند تصویر زیر به صورت کاشی‌کاری‌شده در یک تصویر خروجی بزرگ‌شده PGM (یا PAM با مقیاس خاکستری) در کنار یکدیگر چیده می‌شوند:
.nf
               +-----+                    +-----+
       4:4:4   |  Y  |    4:4:4 w/alpha   |  Y  |
               +-----+                    +-----+
               |  Cb |                    |  Cb |
               +-----+                    +-----+
               |  Cr |                    |  Cr |
               +-----+                    +-----+
                                          |  A  |
               +-----+                    +-----+
       4:2:2,  |  Y  |
       4:2:0   +--+--+                    +-----+--+--+
               |Cb|Cr|            4:1:1   |  Y  |Cb|Cr|
               +--+--+                    +-----+--+--+
                            +-----+
                     MONO   |  Y  |
                            +-----+
.fi
در این حالت، هر قالب کرومای YUV4MPEG2 پذیرفته می‌شود، اما هیچ بیش‌نمونه‌برداری (upsampling) یا تبدیل فضای رنگی انجام نمی‌گیرد.
این حالت در اصل صرفاً بازآرایی/جایگشتی از داده‌های اصلی جریان ورودی درون یک ظرف تصویر PGM است.
تمام پرچم‌های دیگر خط فرمان همچنان تأثیر یکسانی روی خروجی خواهند داشت.
.TP 5
.BI \-v " [0,1,2]"
تنظیم سطح پرگویی (verbosity).
 0 = فقط هشدارها و خطاها.
 1 = افزودن پیام‌های اطلاع‌رسانی.
 2 = افزودن پیام‌های اشکال‌زدایی مفصل.

.SH "مثال‌ها (EXAMPLES)"
.hw y4mtopnm pnmsplit lav2yuv
برای تبدیل ۱۵ فریم اول یک فایل AVI (از نوع MJPEG یا DV) به فایل‌های مجزای PPM:

.RS 5
lav2yuv -f 15 your-video.avi | y4mscaler -O chromass=444 | y4mtopnm | pnmsplit - "your-video-%d.ppm"
.RE

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

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

.SH "همچنین ببینید (SEE ALSO)"
.BR pam (5),
.BR pgm (5),
.BR pnm (5),
.BR ppm (5),
.BR pnmtoy4m (1),
.BR mjpegtools (1),
.BR mpeg2enc (1),
.BR lav2yuv (1),
.BR pnmsplit (1),
.BR y4mscaler (1)