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

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

.SH "توضیحات (DESCRIPTION)"
\fBy4mtoppm\fP یک جریان YUV4MPEG2 را به توالی‌ای
از تصاویر خام PPM تبدیل می‌کند.

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

ورودی مانند همه فیلترها و ابزارهای دیگر YUV4MPEG2 از ورودی استاندارد (stdin) خوانده می‌شود.
جریان‌های YUV4MPEG2 حاوی فریم‌هایی با استفاده از فضای رنگی Y'CbCr
(استاندارد ITU-R BT.601) هستند.
\fBy4mtoppm\fP هر پیکسل را به فضای رنگی معمول R'G'B' که برای
گرافیک رایانه‌ای استفاده می‌شود تبدیل می‌کند.

جریان‌های YUV4MPEG2 ممکن است (اغلب!) صفحه‌های کرومای زیرنمونه‌برداری‌شده (subsampled) داشته باشند.
\fBy4mtoppm\fP می‌تواند جریان‌های «4:2:0 JPEG» را با استفاده از یک الگوریتم
ساده و ابتدایی بیش‌نمونه‌برداری (upsample) کند. نتایج بهتر با استفاده از فیلترهایی مانند
\fBy4mscaler\fP(1) حاصل می‌شود که قادر به انجام عملیات زیرنمونه‌برداری با کاربرد
عمومی هستند. \fBy4mtoppm\fP روی جریان‌هایی که حالت زیرنمونه‌برداری کرومای آن‌ها
چیزی غیر از 4:4:4 یا 4:2:0-JPEG باشد با خطا متوقف می‌شود.

برای جریان‌های درهم‌بافته (interlaced)، این عملیات روی هر میدان
به صورت جداگانه انجام می‌شود. میدان‌ها می‌توانند به صورت تصاویر مجزای PPM با ترتیب زمانی
(پیش‌فرض) یا به صورت درهم‌آمیخته درون تصاویر تمام‌فریم خروجی داده شوند.

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

\fBy4mtoppm\fP و \fBppmtoy4m\fP معکوس یکدیگر هستند؛ می‌توانید
خروجی یکی را با لوله‌کشی (pipe) به دیگری بفرستید، و برعکس. توجه داشته باشید که
عملیات فضای رنگی (و زیرنمونه‌برداری) در هر دو جهت اتلافی هستند. همچنین،
هنگام تبدیل به PPM، اطلاعات مربوط به درهم‌بافی و نسبت ابعاد نمونه
از بین می‌رود (اما با دادن آرگومان‌های خط فرمان به
\fBppmtoy4m\fP قابل بازسازی است).


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

.TP 5
.BI \-L
برای جریان‌های درهم‌بافته، برای هر فریم یک تصویر واحد PPM خروجی می‌دهد که حاوی
دو میدان درهم‌آمیخته است.
(در غیر این صورت، برای هر فریم دو تصویر PPM تولید می‌شود؛ یکی برای هر میدان.)
.TP 5
.BI \-v " [0,1,2]"
تنظیم سطح پرگویی (verbosity).  
 0 = فقط هشدارها و خطاها.
 1 = افزودن پیام‌های اطلاع‌رسانی.
 2 = افزودن پیام‌های پرگوی اشکال‌زدایی.

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

.RS 5
lav2yuv -f 15 your-video.avi | y4mtoppm | pnmsplit - "your-video-%d.ppm"
.RE

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

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

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