.TH "yuvscaler" "1" "26 Septembre 2001" "MJPEG Tools Team" "MJPEG tools manual"

.SH "نام (NAME)"
yuvscaler \- افزایش یا کاهش مقیاس جریان YUV4MPEG2 به قالبی مشخص

.SH "خلاصه دستور (SYNOPSIS)"
.B yuvscaler 
.RB [ -I
.IR input_keyword ]
.RB [ -M 
.IR mode_keyword ]
.RB [ -O
.IR output_keyword ]
.RB [ -n\ p | s | n ]
.RB [ -v\ 0 - 2 ]
.RB [ -h ]

.SH "توضیحات (DESCRIPTION)"
برنامه \fByuvscaler\fP یک ابزار عمومی تغییر مقیاس (افزایش یا کاهش مقیاس / UP یا DOWN) است که برای تبدیل بین قالب‌های ویدیویی مختلف ارائه شده است. این ابزار یک جریان داده با قالب YUV4MPEG2 را از stdin می‌خواند (مانند جریانی که توسط \fBlav2yuv\fP تولید می‌شود) و چنین جریانی را به stdout می‌فرستد (برای نمونه جهت مصرف توسط \fBmpeg2enc\fP).
رایج‌ترین کاربرد yuvscaler، تولید ورودی مناسب برای کدگذاری MPEG در قالب‌های VCD یا SVCD با استفاده از \fBmpeg2enc\fP(1) است.

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

.SH "مثال‌ها (EXAMPLES)"

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

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

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

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

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

.SH "گزینه‌ها (OPTIONS)"

.TP 
.B -I \fIinput_keyword\fP
.IP
گزینه‌های پردازش ورودی را مشخص می‌کند. گزینه‌های ورودی را می‌توان با استفاده از چندین پرچم \fB-I\fP با یکدیگر ترکیب کرد. مقادیر ممکن برای \fIinput_keyword\fP عبارتند از:

.IP
\fBUSE_WidthxHeight+WidthOffset+HeightOffset\fP برای انتخاب ناحیه مفید فریم ورودی (همگی مضرب ۲، و در صورت درهم‌بافته بودن، Height و HeightOffset مضرب ۴)، مابقی تصویر دور ریخته می‌شود.
.IP
\fBACTIVE_WidthxHeight+WidthOffset+HeightOffset\fP برای انتخاب ناحیه فعال فریم ورودی (همگی مضرب ۲، و در صورت درهم‌بافته بودن، Height و HeightOffset مضرب ۴)، مابقی تصویر سیاه می‌شود.

.TP 
.B -M \fImode_keyword\fP
.IP
گزینه‌های حالت مقیاس‌بندی را تنظیم می‌کند. گزینه‌های حالت مقیاس‌بندی می‌توانند با تعیین چند پرچم \fB-M\fP با یکدیگر ترکیب شوند. مقادیر ممکن عبارتند از:

.IP
\fBBICUBIC\fP \- استفاده از الگوریتم دو مکعبی (Mitchell-Netravalli) با کیفیت بالا برای افزایش و/یا کاهش مقیاس.
.IP
\fBRESAMPLE\fP \- استفاده از یک الگوریتم نمونه‌برداری مجدد کلاسیک \-فقط برای کاهش مقیاس\- که بسیار سریع‌تر از bicubic عمل می‌کند. به دلایل سازگاری، اگر تنها کاهش مقیاس نیاز باشد \fByuvscaler\fP از RESAMPLE استفاده می‌کند، و در غیر این صورت از BICUBIC استفاده خواهد کرد.
.IP
\fBWIDE2STD\fP \- تبدیل ویدیوی عریض ورودی آنامورفیک (16:9) به نوارسیاه‌دار یا letterbox (4:3) با ایجاد خطوط سیاه لازم. توجه داشته باشید برای برنامه‌های MPEG اگر \fIپخش‌کننده\fP شما می‌تواند ویدیوی آنامورفیک را به درستی رمزگشایی کند، ممکن است ترجیح دهید ویدیو را بدون تغییر مقیاس رها کرده و صرفاً قالب مناسب را در حین کدگذاری MPEG مشخص کنید (نگاه کنید به \fBmpeg2enc\fP(1)).
.IP
\fBRATIO_WidthIn_WidthOut_HeightIn_HeightOut\fP برای مشخص کردن نسبت‌های مقیاس‌بندی WidthIn/WidthOut برای پهنا و HeightIN/HeightOut برای ارتفاع جهت اِعمال روی ناحیه مفید. فریم‌های خروجی حاصل از مقیاس‌بندی می‌توانند قالبی متفاوت از قالب خروجی مشخص‌شده با گزینه(های) \fB-O\fP داشته باشند. در این صورت، \fByuvscaler\fP به طور خودکار خطوط و ستون‌های سیاه لازم را ایجاد کرده و/یا خطوط و ستون‌های لازم را حذف می‌کند تا تصویر مقیاس‌بندی‌شده در مرکز فریم خروجی قرار گیرد.
.IP
\fBWIDE2VCD\fP برای مقیاس‌بندی فریم‌های عریض آنامورفیک (16:9) به قالب VCD با نوار سیاه (معادل \-M WIDE2STD \-O VCD).
.IP
\fBFASTVCD\fP برای تبدیل (transcode) فریم‌های با اندازه کامل به VCD (معادل \-M RATIO_2_1_2_1 \-O VCD، در زیر را ببینید).
.IP
\fBFAST_WIDE2VCD\fP برای تبدیل فریم‌های آنامورفیک (16:9) با اندازه کامل به VCD با نوار سیاه (معادل \-M WIDE2STD \-M RATIO_2_1_2_1 \-O VCD، در زیر را ببینید).
.IP
\fBNO_HEADER\fP برای جلوگیری از تولید سرایند (header) جریان در خروجی.
.IP
\fBMMX\fP برای استفاده از توابع MMX در مقیاس‌بندی BICUBIC (قابلیت آزمایشی!).
.IP

.TP 
.B -O \fIoutput_keyword\fP

.IP
گزینه‌های قالب فریم خروجی را تعیین می‌کند. گزینه‌های قالب خروجی می‌توانند با تعیین چند پرچم \fB-O\fP با یکدیگر ترکیب شوند.
به‌طور پیش‌فرض، اندازه فریم‌های خروجی برابر با اندازه فریم‌های ورودی خواهد بود؛ وضعیت درهم‌بافی (interlacing) فریم‌های خروجی نیز در صورت سازگاری با مشخصات کلیدواژه خروجی حفظ می‌شود، در غیر این صورت به top_first تنظیم خواهد شد.

.IP
\fBMONOCHROME\fP برای تولید فریم‌های تک‌رنگ در خروجی. اطلاعات رنگ‌پذیری (chrominance) برای پیکسل‌های مقیاس‌بندی‌شده روی حالت خنثی (سفید) تنظیم می‌شود. کدگذاری MPEG ویدیوهای سیاه و سفید ناکارآمد خواهد بود \fIو\fP آرتیفکت‌های رنگی آزاردهنده‌ای نشان می‌دهد مگر اینکه این گزینه اعمال شود.
.IP
\fBVCD\fP برای تولید فریم‌های منطبق بر VCD در خروجی (با در نظر گرفتن استانداردهای PAL و NTSC). خروجی غیر درهم‌بافته (Non-interlaced).
.IP
\fBSVCD\fP برای تولید فریم‌های منطبق بر SVCD در خروجی (با در نظر گرفتن استانداردهای PAL و NTSC). فریم‌های درهم‌بافته با اولویت نیم‌فریم بالا (Top-field-first).
.IP
\fBDVD\fP برای تولید فریم‌های منطبق بر DVD در خروجی (با در نظر گرفتن استانداردهای PAL و NTSC). فریم‌های درهم‌بافته با اولویت نیم‌فریم بالا (Top-field-first).
.IP
\fBSIZE_WidthxHeight\fP برای تولید فریم‌هایی با اندازه WidthxHeight در خروجی (مضرب ۴).
.IP
اگر کلیدواژه‌های VCD، SVCD یا DVD استفاده نشوند، نوع درهم‌بافی خروجی همانند ورودی در نظر گرفته می‌شود. به‌طور پیش‌فرض، اندازه فریم خروجی برابر با اندازه فریم ورودی خواهد بود.
.IP

.TP 
.B -n p|s|n
(معمولاً لازم نیست) اگر استاندارد از جریان داده قابل تشخیص نباشد، استاندارد خروجی را برای VCD/SVCD تعیین می‌کند (p=pal, s=secam, n=ntsc).

.TP
.B -v 0|1|2
درجه پرگویی را مشخص می‌کند: 0=ساکت، 1=عادی، 2=پرگو/اشکال‌زدایی.

.TP
.B -h
خلاصه‌ای از ساختار دستوری خط فرمان را چاپ می‌کند.

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

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

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

.SH "همچنین ببینید (SEE ALSO)"
.BR mjpegtools (1),
.BR lavpipe (1),
.BR lav2yuv (1),
.BR mpeg2enc (1)