نام (NAME)

y4mtoppm - تبدیل جریان YUV4MPEG2 به تصاویر PPM

خلاصه دستور (SYNOPSIS)

y4mtoppm [options]

توضیحات (DESCRIPTION)

y4mtoppm یک جریان YUV4MPEG2 را به توالی‌ای از تصاویر خام PPM تبدیل می‌کند.

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

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

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

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

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

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

گزینه‌ها (OPTIONS)

y4mtoppm گزینه‌های زیر را می‌پذیرد:

-L

برای جریان‌های درهم‌بافته، برای هر فریم یک تصویر واحد PPM خروجی می‌دهد که حاوی دو میدان درهم‌آمیخته است. (در غیر این صورت، برای هر فریم دو تصویر PPM تولید می‌شود؛ یکی برای هر میدان.)

-v [0,1,2]

تنظیم سطح پرگویی (verbosity).
0 = فقط هشدارها و خطاها.
1 = افزودن پیام‌های اطلاع‌رسانی.
2 = افزودن پیام‌های پرگوی اشکال‌زدایی.

مثال‌ها (EXAMPLES)

برای تبدیل ۱۵ فریم نخست یک فایل AVI (از نوع MJPEG یا DV) به فایل‌های مجزای PPM:

نویسنده (AUTHOR)

این صفحه راهنما توسط Matt Marjanovic نوشته شده است.
اگر سؤال، نظر یا مشکلی دارید یا مایلید با توسعه‌دهندگان ارتباط برقرار کنید، فهرست پستی اصلی برای MJPEG-tools عبارت است از:
mjpeg-users@lists.sourceforge.net

برای اطلاعات بیشتر، از وبگاه ما دیدن کنید:

http://mjpeg.sourceforge.net

همچنین ببینید (SEE ALSO)

ppm(5), pnm(5), ppmtoy4m(1), mjpegtools(1), mpeg2enc(1), lav2yuv(1), pnmsplit(1), y4mscaler(1)