yuvscaler(1) MJPEG tools manual yuvscaler(1)

yuvscaler - افزایش یا کاهش مقیاس جریان YUV4MPEG2 به قالبی مشخص

yuvscaler [-I input_keyword] [-M mode_keyword] [-O output_keyword] [-n p|s|n] [-v 0-2] [-h]

برنامه yuvscaler یک ابزار عمومی تغییر مقیاس (افزایش یا کاهش مقیاس / UP یا DOWN) است که برای تبدیل بین قالب‌های ویدیویی مختلف ارائه شده است. این ابزار یک جریان داده با قالب YUV4MPEG2 را از stdin می‌خواند (مانند جریانی که توسط lav2yuv تولید می‌شود) و چنین جریانی را به stdout می‌فرستد (برای نمونه جهت مصرف توسط mpeg2enc). رایج‌ترین کاربرد yuvscaler، تولید ورودی مناسب برای کدگذاری MPEG در قالب‌های VCD یا SVCD با استفاده از mpeg2enc(1) است.

برنامه yuvscaler به صورت خودکار استانداردهای PAL/SECAM و NTSC و همچنین قالب عریض (16:9) و درهم‌بافی (interlacing) را در نظر می‌گیرد. استفاده از yuvscaler به‌گونه‌ای طراحی شده است که ساده و سرراست باشد.

کدگذاری VCD:
lav2yuv my-file.avi | yuvscaler -O VCD | mpeg2enc -f 1 -o vcd.%d.m1v

کدگذاری SVCD:
lav2yuv my-file.qt | yuvscaler -O SVCD | mpeg2enc -f 4 -o svcd.%d.m2v

کدگذاری 16:9 آنامورفیک به‌صورت VCD دارای نوار سیاه (letterboxed):
lav2yuv my-ana16-9.eli | yuvscaler -M WIDE2VCD | mpeg2enc -f 1 -o letterbox_vcd.%d.m1v

کدگذاری 16:9 آنامورفیک به‌صورت SVCD دارای نوار سیاه (letterboxed):
lav2yuv my-ana16-9.eli | yuvscaler -M WIDE2STD -O SVCD | mpeg2enc -f 4 -o letterbox_svcd.%d.m2v

کدگذاری 16:9 آنامورفیک به‌صورت DVD دارای نوار سیاه (letterboxed):
lav2yuv my-ana16-9.eli | yuvscaler -M WIDE2STD -O DVD | mpeg2enc -f 8 -o letterbox_dvd.%d.m2v

گزینه‌های پردازش ورودی را مشخص می‌کند. گزینه‌های ورودی را می‌توان با استفاده از چندین پرچم -I با یکدیگر ترکیب کرد. مقادیر ممکن برای input_keyword عبارتند از:
USE_WidthxHeight+WidthOffset+HeightOffset برای انتخاب ناحیه مفید فریم ورودی (همگی مضرب ۲، و در صورت درهم‌بافته بودن، Height و HeightOffset مضرب ۴)، مابقی تصویر دور ریخته می‌شود.
ACTIVE_WidthxHeight+WidthOffset+HeightOffset برای انتخاب ناحیه فعال فریم ورودی (همگی مضرب ۲، و در صورت درهم‌بافته بودن، Height و HeightOffset مضرب ۴)، مابقی تصویر سیاه می‌شود.
گزینه‌های حالت مقیاس‌بندی را تنظیم می‌کند. گزینه‌های حالت مقیاس‌بندی می‌توانند با تعیین چند پرچم -M با یکدیگر ترکیب شوند. مقادیر ممکن عبارتند از:
BICUBIC - استفاده از الگوریتم دو مکعبی (Mitchell-Netravalli) با کیفیت بالا برای افزایش و/یا کاهش مقیاس.
RESAMPLE - استفاده از یک الگوریتم نمونه‌برداری مجدد کلاسیک -فقط برای کاهش مقیاس- که بسیار سریع‌تر از bicubic عمل می‌کند. به دلایل سازگاری، اگر تنها کاهش مقیاس نیاز باشد yuvscaler از RESAMPLE استفاده می‌کند، و در غیر این صورت از BICUBIC استفاده خواهد کرد.
WIDE2STD - تبدیل ویدیوی عریض ورودی آنامورفیک (16:9) به نوارسیاه‌دار یا letterbox (4:3) با ایجاد خطوط سیاه لازم. توجه داشته باشید برای برنامه‌های MPEG اگر پخش‌کننده شما می‌تواند ویدیوی آنامورفیک را به درستی رمزگشایی کند، ممکن است ترجیح دهید ویدیو را بدون تغییر مقیاس رها کرده و صرفاً قالب مناسب را در حین کدگذاری MPEG مشخص کنید (نگاه کنید به mpeg2enc(1)).
RATIO_WidthIn_WidthOut_HeightIn_HeightOut برای مشخص کردن نسبت‌های مقیاس‌بندی WidthIn/WidthOut برای پهنا و HeightIN/HeightOut برای ارتفاع جهت اِعمال روی ناحیه مفید. فریم‌های خروجی حاصل از مقیاس‌بندی می‌توانند قالبی متفاوت از قالب خروجی مشخص‌شده با گزینه(های) -O داشته باشند. در این صورت، yuvscaler به طور خودکار خطوط و ستون‌های سیاه لازم را ایجاد کرده و/یا خطوط و ستون‌های لازم را حذف می‌کند تا تصویر مقیاس‌بندی‌شده در مرکز فریم خروجی قرار گیرد.
WIDE2VCD برای مقیاس‌بندی فریم‌های عریض آنامورفیک (16:9) به قالب VCD با نوار سیاه (معادل -M WIDE2STD -O VCD).
FASTVCD برای تبدیل (transcode) فریم‌های با اندازه کامل به VCD (معادل -M RATIO_2_1_2_1 -O VCD، در زیر را ببینید).
FAST_WIDE2VCD برای تبدیل فریم‌های آنامورفیک (16:9) با اندازه کامل به VCD با نوار سیاه (معادل -M WIDE2STD -M RATIO_2_1_2_1 -O VCD، در زیر را ببینید).
NO_HEADER برای جلوگیری از تولید سرایند (header) جریان در خروجی.
MMX برای استفاده از توابع MMX در مقیاس‌بندی BICUBIC (قابلیت آزمایشی!).
گزینه‌های قالب فریم خروجی را تعیین می‌کند. گزینه‌های قالب خروجی می‌توانند با تعیین چند پرچم -O با یکدیگر ترکیب شوند. به‌طور پیش‌فرض، اندازه فریم‌های خروجی برابر با اندازه فریم‌های ورودی خواهد بود؛ وضعیت درهم‌بافی (interlacing) فریم‌های خروجی نیز در صورت سازگاری با مشخصات کلیدواژه خروجی حفظ می‌شود، در غیر این صورت به top_first تنظیم خواهد شد.
MONOCHROME برای تولید فریم‌های تک‌رنگ در خروجی. اطلاعات رنگ‌پذیری (chrominance) برای پیکسل‌های مقیاس‌بندی‌شده روی حالت خنثی (سفید) تنظیم می‌شود. کدگذاری MPEG ویدیوهای سیاه و سفید ناکارآمد خواهد بود و آرتیفکت‌های رنگی آزاردهنده‌ای نشان می‌دهد مگر اینکه این گزینه اعمال شود.
VCD برای تولید فریم‌های منطبق بر VCD در خروجی (با در نظر گرفتن استانداردهای PAL و NTSC). خروجی غیر درهم‌بافته (Non-interlaced).
SVCD برای تولید فریم‌های منطبق بر SVCD در خروجی (با در نظر گرفتن استانداردهای PAL و NTSC). فریم‌های درهم‌بافته با اولویت نیم‌فریم بالا (Top-field-first).
DVD برای تولید فریم‌های منطبق بر DVD در خروجی (با در نظر گرفتن استانداردهای PAL و NTSC). فریم‌های درهم‌بافته با اولویت نیم‌فریم بالا (Top-field-first).
SIZE_WidthxHeight برای تولید فریم‌هایی با اندازه WidthxHeight در خروجی (مضرب ۴).
اگر کلیدواژه‌های VCD، SVCD یا DVD استفاده نشوند، نوع درهم‌بافی خروجی همانند ورودی در نظر گرفته می‌شود. به‌طور پیش‌فرض، اندازه فریم خروجی برابر با اندازه فریم ورودی خواهد بود.
(معمولاً لازم نیست) اگر استاندارد از جریان داده قابل تشخیص نباشد، استاندارد خروجی را برای VCD/SVCD تعیین می‌کند (p=pal, s=secam, n=ntsc).
درجه پرگویی را مشخص می‌کند: 0=ساکت، 1=عادی، 2=پرگو/اشکال‌زدایی.
خلاصه‌ای از ساختار دستوری خط فرمان را چاپ می‌کند.

نکته: کاربردی‌ترین نسبت‌های کاهش مقیاس با استفاده از توابع اختصاصی و بهینه‌شده مدیریت می‌شوند. آن‌ها عبارتند از:

RATIO_WidthIn_WidthOut_2_1 => کاهش مقیاس فریم تمام‌اندازه به VCD
RATIO_3_2_1_1 => کاهش مقیاس فریم تمام‌اندازه به SVCD
RATIO_1_1_4_3 => حالت کاهش مقیاس WIDE2STD
RATIO_WidthIn_WidthOut_1_1 => کاهش مقیاس فقط مربوط به پهنا است، نه ارتفاع
RATIO_1_1_HeightIn_HeightOut => کاهش مقیاس فقط مربوط به ارتفاع است، نه پهنا
RATIO_2_1_2_1 => حالت FASTVCD، دارای اعوجاج جزئی در پهنا (نسبت واقعی ۴۵ به ۲۲) اما کاهش مقیاس سریع‌تر فریم تمام‌اندازه به VCD (با مشخصه -M RATIO_2_1_2_1 -O VCD)
RATIO_WidthIn_WidthOut_8_3 => اختصاصی برای کاهش مقیاس WIDE2VCD (با مشخصه -M WIDE2STD -O VCD)
RATIO_2_1_8_3 => اختصاصی برای کاهش مقیاس FAST_WIDE2VCD (دارای اعوجاج جزئی) (با مشخصه -M WIDE2STD -M RATIO_2_1_2_1 -O VCD)
RATIO_1_1_1_1 => رونوشت بخش مفید ورودی از چند فایل احتمالی به فریم‌های خروجی

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

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

mjpegtools(1), lavpipe(1), lav2yuv(1), mpeg2enc(1)

26 Septembre 2001 MJPEG Tools Team