نام (NAME)

ffmpeg-scaler - توصیف کتابخانه و گزینه‌های مقیاس‌بندی تصویر در FFmpeg

توضیحات (DESCRIPTION)

مقیاس‌بندی‌کننده FFmpeg یک رابط سطح بالا برای ابزارهای تبدیل تصویر کتابخانه libswscale فراهم می‌کند. به‌ویژه، به کاربر امکان می‌دهد مقیاس‌بندی مجدد تصویر و تبدیل قالب پیکسل (pixel format) را انجام دهد.

گزینه‌های مقیاس‌بندی (SCALER OPTIONS)

مقیاس‌بندی‌کننده ویدیو از گزینه‌های نام‌گذاری‌شده زیر پشتیبانی می‌کند.

گزینه‌ها می‌توانند با مشخص کردن -option value در ابزارهای FFmpeg تعیین شوند، به استثنای چند مورد فقط مخصوص API که در زیر به آن‌ها اشاره شده است. برای استفاده برنامه‌نویسی، می‌توان آن‌ها را به‌صورت صریح در گزینه‌های "SwsContext" یا از طریق رابط برنامه‌نویسی libavutil/opt.h تنظیم کرد.

scaler, scaler_sub: انتخاب الگوریتم مقیاس‌بندی مورد استفاده. مقدار پیش‌فرض برای هر دو auto است. مقادیر زیر را می‌پذیرد:

auto: انتخاب خودکار. برای scaler_sub، این به معنای همان الگوریتم scaler است. برای scaler، به طور پیش‌فرض روی پرچم مقیاس‌بندی انتخاب‌شده توسط sws_flags قرار می‌گیرد.
bilinear: فیلتر دوخطی (Bilinear) (معروف به فیلتر مثلثی / triangle filter).
bicubic: اسپلاین مکعبی دوتپ BC (معروف به اسپلاین Mitchell-Netravali). پارامترهای B و C را می‌توان با تنظیم "param0" و "param1" پیکربندی کرد که مقادیر پیش‌فرض آن‌ها به ترتیب 0.0 و 0.6 است.
point, neighbor: نمونه‌برداری نقطه‌ای (معروف به نزدیک‌ترین همسایه / nearest neighbor).
area: میانگین‌گیری ناحیه‌ای. معادل bilinear برای افزایش مقیاس (upscaling).
gaussian: تقریب فیلتر گاوسی دوتپ. پارامتر وضوح (sharpness) را می‌توان با تنظیم "param0" پیکربندی کرد که مقدار پیش‌فرض آن 3.0 است.
sinc: فیلتر sinc بدون پنجره.
lanczos: نمونه‌برداری مجدد لانچوس (sinc با پنجره sinc). تعداد تپ‌های فیلتر را می‌توان با تنظیم "param0" پیکربندی کرد که مقدار پیش‌فرض آن 3 است.
spline: اسپلاین دومکعبی طبیعی بدون پنجره.

sws_flags: تنظیم پرچم‌های مقیاس‌بندی‌کننده. این گزینه برای تنظیم الگوریتم مقیاس‌بندی نیز استفاده می‌شود، هرچند این کاربرد منسوخ شده و استفاده از scaler توصیه می‌شود. تنها یک الگوریتم منفرد می‌تواند انتخاب شود. مقدار پیش‌فرض bicubic است.
مقادیر زیر را می‌پذیرد:

fast_bilinear: انتخاب الگوریتم مقیاس‌بندی دوخطی سریع (Fast bilinear). (منسوخ‌شده)
bilinear: انتخاب الگوریتم مقیاس‌بندی دوخطی (Bilinear). (منسوخ‌شده)
bicubic: انتخاب الگوریتم مقیاس‌بندی دومکعبی (Bicubic). (منسوخ‌شده)
experimental: انتخاب الگوریتم مقیاس‌بندی آزمایشی. (منسوخ‌شده)
neighbor: انتخاب الگوریتم مقیاس‌بندی مجدد نزدیک‌ترین همسایه (Nearest neighbor). (منسوخ‌شده)
area: انتخاب الگوریتم مقیاس‌بندی مجدد میانگین‌گیری ناحیه‌ای. (منسوخ‌شده)
bicublin: انتخاب الگوریتم مقیاس‌بندی دومکعبی برای مؤلفه روشنایی (luma) و دوخطی برای مؤلفه‌های رنگ (chroma). (منسوخ‌شده)
gauss: انتخاب الگوریتم مقیاس‌بندی مجدد گاوسی (Gaussian). (منسوخ‌شده)
sinc: انتخاب الگوریتم مقیاس‌بندی مجدد sinc. (منسوخ‌شده)
lanczos: انتخاب الگوریتم مقیاس‌بندی مجدد لانچوس (Lanczos). پهنای پیش‌فرض (alpha) برابر ۳ است و می‌تواند با تنظیم "param0" تغییر کند. (منسوخ‌شده)
spline: انتخاب الگوریتم مقیاس‌بندی مجدد اسپلاین دومکعبی طبیعی. (منسوخ‌شده)
print_info: فعال‌سازی چاپ/ثبت لاگ‌های اشکال‌زدایی (debug logging).
accurate_rnd: فعال‌سازی گرد کردن دقیق (accurate rounding).
full_chroma_int: فعال‌سازی درون‌یابی کامل کروما (full chroma interpolation).
full_chroma_inp: انتخاب ورودی کروما کامل (full chroma input).
bitexact: فعال‌سازی خروجی با دقت بیت‌به‌بیت (bitexact).
unstable: اجازه استفاده از کدهای آزمایشی جدید. ممکن است اندکی بر خروجی تأثیر بگذارد یا حتی نتایج نادرست تولید کند. صرفاً برای آزمایش.

srcw (فقط API): تنظیم عرض منبع (source width).
srch (فقط API): تنظیم ارتفاع منبع (source height).
dstw (فقط API): تنظیم عرض مقصد (destination width).
dsth (فقط API): تنظیم ارتفاع مقصد (destination height).
src_format (فقط API): تنظیم قالب پیکسل منبع (باید به‌صورت یک عدد صحیح مشخص شود).
dst_format (فقط API): تنظیم قالب پیکسل مقصد (باید به‌صورت یک عدد صحیح مشخص شود).
src_range (بولی): اگر مقدار روی 1 تنظیم شود، نشان می‌دهد که منبع دارای دامنه کامل (full range) است. مقدار پیش‌فرض 0 است که نشان‌دهنده دامنه محدود (limited range) برای منبع است.
dst_range (بولی): اگر مقدار روی 1 تنظیم شود، دامنه کامل را برای مقصد فعال می‌کند. مقدار پیش‌فرض 0 است که دامنه محدود را فعال می‌کند.
gamma (بولی): اگر مقدار روی 1 تنظیم شود، مقیاس‌بندی با تصحیح گاما (gamma correct scaling) را فعال می‌کند. مقدار پیش‌فرض 0 است.
param0, param1: تنظیم پارامترهای الگوریتم مقیاس‌بندی. مقادیر مشخص‌شده مختص برخی الگوریتم‌های مقیاس‌بندی هستند و توسط برخی دیگر نادیده گرفته می‌شوند. مقادیر تعیین‌شده اعداد اعشاری (floating point) هستند.
sws_dither: تنظیم الگوریتم دیترینگ (dithering). یکی از مقادیر زیر را می‌پذیرد. مقدار پیش‌فرض auto است.

auto: انتخاب خودکار
none: بدون دیترینگ
bayer: دیترینگ بایر (bayer dither)
ed: دیترینگ انتشار خطا (error diffusion dither)
a_dither: دیترینگ حسابی، مبتنی بر جمع
x_dither: دیترینگ حسابی، مبتنی بر xor (دارای الگوی تصادفی‌تر / الگوهای کمتر مشهود نسبت به a_dither).

alphablend: تنظیم ترکیب آلفا (alpha blending) برای زمانی که ورودی دارای کانال آلفا است اما خروجی فاقد آن است. مقدار پیش‌فرض none است.

uniform_color: ترکیب روی یک رنگ پس‌زمینه یکدست
checkerboard: ترکیب روی صفحه شطرنجی
none: بدون ترکیب

sws_backends: تنظیم بک‌اندهای مجاز swscale. این یک گزینه از نوع پرچم (flags) است، بنابراین چند بک‌اند می‌توانند با هم ترکیب شوند.

auto: انتخاب خودکار. بسته به اینکه پرچم unstable تنظیم شده باشد یا خیر، برابر با stable یا all خواهد بود. این مقدار پیش‌فرض است.
stable: تمام بک‌اندهای پایدار (stable).
unstable: تمام بک‌اندهای ناپایدار (unstable).
all: تمام بک‌اندهای در دسترس.
legacy: کد قدیمی و موروثی swscale.
c: کد مرجع مبتنی بر الگو (template-based).
memcpy: مسیر سریع با استفاده از "memcpy" در libc.
x86: هسته‌های SIMD برای x86.
aarch64: هسته‌های NEON برای AArch64.
spirv: بک‌اند Vulkan SPIR-V.

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

ffmpeg(1), ffplay(1), ffprobe(1), libswscale(3)

نویسندگان (AUTHORS)

توسعه‌دهندگان FFmpeg.

برای جزئیات درباره نویسندگان، به تاریخچه گیت پروژه (https://git.ffmpeg.org/ffmpeg) مراجعه کنید، به عنوان مثال با تایپ دستور git log در دایرکتوری منبع FFmpeg، یا مرور مخزن آنلاین در https://git.ffmpeg.org/ffmpeg.

نگه‌دارنده‌های اجزای خاص در فایل MAINTAINERS در درخت کد منبع فهرست شده‌اند.