نام (NAME)

pnmtoy4m - تبدیل تصاویر خام PNM/PPM به جریان ویدئویی YUV4MPEG2

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

pnmtoy4m [گزینه‌ها] [نام‌فایل]

توضیحات (DESCRIPTION)

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

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

ورودی یک تصویر با قالب خام PNM است که از ورودی استاندارد (stdin) یا از نام‌فایل اختیاری خوانده می‌شود. ورودی ممکن است شامل چندین تصویر متوالی PNM باشد که به یکدیگر چسبانده شده‌اند؛ pnmtoy4m آن‌ها را به ترتیب می‌خواند و پردازش می‌کند. تمام تصاویر باید اندازه و قالب یکسانی داشته باشند. تصاویر ورودی را می‌توان به صورت فریم‌های کامل پیش‌رونده (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)، خروجی باید علاوه بر این به برنامه‌ای مانند y4mscaler هدایت شود.

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

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

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

گزینه‌ها (OPTIONS)

دستور pnmtoy4m گزینه‌های زیر را می‌پذیرد:

-o num

آفست فریم: از ارسال num فریم اول در خروجی صرف‌نظر می‌کند. (پیش‌فرض: 0)

-n num

در مجموع تعداد num فریم در خروجی تولید می‌کند. مقدار '0' برای مشخص کردن همه فریم‌ها به کار می‌رود. (پیش‌فرض: 0)

-B

داده‌ها را به جای RGB به صورت BGR تفسیر می‌کند.

-r

آخرین فریم ورودی را تا زمان تکمیل خروجی تکرار می‌کند. اگر گزینه -n 0 نیز مشخص شده باشد، آخرین فریم ورودی تا ابد تکرار خواهد شد.

-D x

با هر تصویر PNM به عنوان یک فیلد تکی (تفکیک‌شده) به جای یک فریم کامل رفتار می‌کند. آرگومان نحوه تفسیر را مشخص می‌کند:

t - نخستین تصویر یک فیلد بالایی (top-field) است
b - نخستین تصویر یک فیلد پایینی (bottom-field) است

با این گزینه، برای هر فریم خروجی دو تصویر ورودی لازم خواهد بود. مراقب باشید: عدم تطابق گزینه‌های -I و -D می‌تواند ترتیب زمانی یا مکانی فیلدها (یا هر دو) را معکوس کند.

-F n:d

نرخ فریم کدگذاری‌شده در جریان خروجی را به صورت نسبت صحیح دقیق تنظیم می‌کند. (پیش‌فرض: 30000:1001) نرخ‌های متداول عبارتند از:

24000:1001 - فیلم تبدیل‌شده با تبدیل NTSC 3:2 pulldown
      24:1 - فیلم بومی (native film)
      25:1 - سیستم PAL/SECAM
30000:1001 - ویدئوی NTSC
      50:1 - نرخ فیلد PAL
60000:1001 - نرخ فیلد NTSC

-A n:d

نسبت ابعاد پیکسل کدگذاری‌شده در جریان خروجی را به صورت نسبت صحیح دقیق تنظیم می‌کند. (پیش‌فرض: 1:1) نسبت‌های متداول عبارتند از:

 1:1  - پیکسل‌های مربعی (گرافیک کامپیوتر)
10:11 - CCIR-601 NTSC
59:54 - CCIR-601 PAL

-I x

حالت درهم‌تنیدگی خروجی کدگذاری‌شده در جریان خروجی را تعیین می‌کند. (پیش‌فرض مطابقت با -D در صورت تعیین آن، یا 'p' در غیر این صورت است.)

p - پیش‌رونده، غیر درهم‌تنیده (progressive)
t - درهم‌تنیده با اولویت فیلد بالایی/فوقانی (top-field-first)
b - درهم‌تنیده با اولویت فیلد پایینی/تحتانی (bottom-field-first)

-v [0,1,2]

سطح پرگویی خروجی را تعیین می‌کند.

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

مثال‌ها (EXAMPLES)

برای تبدیل فایلی حاوی یک تصویر PPM به جریانی از ۱۵ فریم (یکسان):

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

نویسنده (AUTHOR)

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

برای اطلاعات بیشتر، به وب‌سایت ما مراجعه کنید:

http://mjpeg.sourceforge.net

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

pam(5), pbm(5), pgm(5), pnm(5), ppm(5), y4mtopnm(1), mjpegtools(1), mpeg2enc(1), y4mscaler(1), yuv2lav(1), yuvplay(1)