.\" Hey, EMACS: -*- nroff -*- .TH GIF2WEBP 1 "November 4, 2024" .SH "نام (NAME)" gif2webp \- تبدیل تصاویر و پویانمایی‌های GIF به فرمت فشرده WebP .SH "خلاصه دستور (SYNOPSIS)" .B gif2webp .RI [ گزینه‌ها ] " input_file.gif \-o output_file.webp .br .SH "توضیحات (DESCRIPTION)" این صفحه راهنما دستور .B gif2webp را مستند می‌کند. .PP دستور \fBgif2webp\fP تصاویر و پویانمایی‌های GIF را به فرمت WebP تبدیل می‌کند. .SH "گزینه‌ها (OPTIONS)" گزینه‌های پایه عبارتند از: .TP .BI \-o " string نام فایل خروجی WebP را مشخص می‌کند. اگر تعیین نشود، \fBgif2webp\fP تبدیل را انجام می‌دهد اما فقط آمار و اطلاعات را گزارش می‌کند. استفاده از "\-" به عنوان نام خروجی، داده‌ها را به خروجی استاندارد (stdout) هدایت می‌کند. .TP .BI \-\- " string به طور صریح فایل ورودی را مشخص می‌کند. این گزینه زمانی مفید است که نام فایل ورودی برای مثال با '\-' شروع شود. این گزینه باید \fBدر انتها\fP بیاید. تمام گزینه‌های دیگر پس از آن نادیده گرفته می‌شوند. اگر فایل ورودی "\-" باشد، داده‌ها به جای فایل از ورودی استاندارد (\fIstdin\fP) خوانده می‌شوند. .TP .B \-h, \-help اطلاعات نحوه استفاده و راهنما را نمایش می‌دهد. .TP .B \-version شماره نسخه را (به صورت major.minor.revision) چاپ کرده و خارج می‌شود. .TP .B \-lossy تصویر را با استفاده از فشرده‌سازی بااتلاف (lossy) کدگذاری می‌کند. .TP .B \-mixed حالت فشرده‌سازی ترکیبی: فشرده‌سازی تصویر را با انتخاب ابتکاری (heuristically) فشرده‌سازی بااتلاف یا بدون‌اتلاف برای هر فریم بهینه‌سازی می‌کند. .TP .BI \-near_lossless " int سطح پیش‌پردازش تصویر شبه‌بدون‌اتلاف (near\-lossless) را مشخص می‌کند. این گزینه مقادیر پیکسل‌ها را برای کمک به فشرده‌سازی بهتر تنظیم می‌کند، اما کمترین تاثیر را بر کیفیت بصری دارد. این گزینه حالت فشرده‌سازی بدون‌اتلاف را به طور خودکار فعال می‌کند. محدوده مجاز از 0 (حداکثر پیش‌پردازش) تا 100 (بدون پیش‌پردازش، حالت پیش‌فرض) است. مقدار معمول حدود 60 است. توجه داشته باشید که حالت بااتلاف با گزینه \fB\-q 100\fP گاهی اوقات می‌تواند نتایج بهتری به دست دهد. .TP .B \-sharp_yuv از تبدیل دقیق‌تر و واضح‌تر RGB->YUV استفاده می‌کند. توجه داشته باشید که این فرایند نسبت به تبدیل پیش‌فرض و سریع RGB->YUV کندتر است. .TP .BI \-q " float ضریب فشرده‌سازی برای کانال‌های RGB را بین 0 و 100 مشخص می‌کند. مقدار پیش‌فرض 75 است. .br در حالت فشرده‌سازی بدون‌اتلاف (پیش‌فرض)، ضریب کوچک‌تر سرعت فشرده‌سازی بالاتری فراهم می‌کند، اما فایلی با حجم بزرگ‌تر تولید می‌کند. حداکثر فشرده‌سازی با مقدار 100 حاصل می‌شود. .br در حالت فشرده‌سازی بااتلاف (که با گزینه \-lossy مشخص می‌شود)، ضریب کوچک‌تر فایلی با حجم کمتر و کیفیت پایین‌تر تولید می‌کند. بهترین کیفیت با مقدار 100 به دست می‌آید. .TP .BI \-m " int روش فشرده‌سازی مورد استفاده را مشخص می‌کند. این پارامتر تعادل بین سرعت کدگذاری و حجم و کیفیت فایل فشرده‌شده را کنترل می‌کند. مقادیر ممکن از 0 تا 6 متغیر است. مقدار پیش‌فرض 4 است. هنگامی که مقادیر بالاتری استفاده شود، انکودر زمان بیشتری را صرف بررسی حالت‌های ممکن برای کدگذاری و ارزیابی افزایش کیفیت می‌کند. مقادیر کمتر می‌توانند زمان پردازش سریع‌تری به همراه داشته باشند، اما به قیمت حجم فایل بزرگ‌تر و کیفیت فشرده‌سازی پایین‌تر. .TP .BI \-min_size تصویر را برای رسیدن به کمترین حجم ممکن کدگذاری می‌کند. این گزینه درج فریم‌های کلیدی (key frames) را غیرفعال کرده و روش بازنشانی فریم (dispose method) را انتخاب می‌کند که کمترین حجم خروجی را برای هر فریم به همراه داشته باشد. این گزینه به صورت پیش‌فرض از فشرده‌سازی بدون‌اتلاف استفاده می‌کند، اما می‌تواند با گزینه‌های \-q، \-m، \-lossy یا \-mixed ترکیب شود. .TP .BI \-kmin " int .TP .BI \-kmax " int حداقل و حداکثر فاصله بین فریم‌های کلیدی متوالی (فریم‌هایی که مستقل از دیگر فریم‌ها قابل رمزگشایی هستند) را در پویانمایی خروجی مشخص می‌کند. این ابزار در صورت نیاز تعدادی فریم کلیدی در پویانمایی خروجی درج می‌کند تا این معیار برآورده شود. .br مقدار 'kmax' برابر با 0 درج فریم‌های کلیدی را غیرفعال می‌کند. مقدار 'kmax' برابر با 1 باعث می‌شود تمام فریم‌ها به عنوان فریم کلیدی ذخیره شوند. در هر دوی این حالت‌های خاص، مقدار 'kmin' نادیده گرفته می‌شود. مقادیر معمول در محدوده 3 تا 30 هستند. مقادیر پیش‌فرض برای فشرده‌سازی بدون‌اتلاف kmin = 9 و kmax = 17 و برای فشرده‌سازی بااتلاف kmin = 3 و kmax = 5 است. .br این دو گزینه فقط برای تصاویر متحرک با تعداد فریم‌های زیاد (بیش از 50) کاربرد دارند. .br هنگامی که از مقادیر کمتری استفاده شود، فریم‌های بیشتری به فریم کلیدی تبدیل می‌شوند. این امر ممکن است منجر به کاهش تعداد فریم‌های مورد نیاز برای رمزگشایی یک فریم به طور میانگین شده و کارایی رمزگشایی را بهبود بخشد، اما ممکن است حجم فایل خروجی را کمی افزایش دهد. مقادیر بالاتر ممکن است عملکرد رمزگشایی را کاهش دهند، اما منجر به حجم فایل کوچک‌تری می‌شوند. .br برخی محدودیت‌ها: .br (i) kmin < kmax, .br (ii) kmin >= kmax / 2 + 1 و .br (iii) kmax - kmin <= 30. .br اگر هر یک از این محدودیت‌ها رعایت نشود، به صورت خودکار اعمال خواهند شد. .TP .BI \-metadata " string فهرستی از متادیتاها (جداشده با کاما) که در صورت وجود، از ورودی به خروجی کپی می‌شوند. مقادیر معتبر: \fBall\fP، \fBnone\fP، \fBicc\fP، \fBxmp\fP. مقدار پیش‌فرض \fBxmp\fP است. .TP .BI \-f " int فقط برای کدگذاری بااتلاف (مشخص‌شده با گزینه \-lossy). شدت فیلتر حذف بلوک (deblocking filter) را بین 0 (بدون فیلتر) و 100 (حداکثر فیلترینگ) مشخص می‌کند. مقدار 0 هرگونه فیلترینگ را غیرفعال می‌کند. مقدار بالاتر شدت فرایند فیلترینگ اعمال‌شده پس از رمزگشایی تصویر را افزایش می‌دهد. هرچه مقدار بالاتر باشد، تصویر روان‌تر و نرم‌تر به نظر می‌رسد. مقادیر معمول معمولاً در محدوده 20 تا 50 هستند. .TP .B \-mt در صورت امکان، از چندریسمانی (multi-threading) برای کدگذاری استفاده می‌کند. .TP .B \-loop_compatibility در صورت فعال بودن، اطلاعات حلقه تکرار (loop) را به روشی سازگار با نسخه‌های کروم قبل از M62 (شامل خود آن) و فایرفاکس مدیریت می‌کند. .TP .B \-v اطلاعات اضافی و جزئیات را چاپ می‌کند. .TP .B \-quiet هیچ پیامی چاپ نمی‌کند. .SH "وضعیت خروج (EXIT STATUS)" اگر هیچ مشکلی در حین اجرا پیش نیاید، \fBgif2webp\fP با مقدار ثابت سی \fBEXIT_SUCCESS\fP خارج می‌شود. این مقدار معمولاً صفر است. .PP اگر خطایی رخ دهد، \fBgif2webp\fP با مقدار ثابت سی \fBEXIT_FAILURE\fP خارج می‌شود. این مقدار معمولاً یک است. .SH "مثال‌ها (EXAMPLES)" gif2webp picture.gif \-o picture.webp .br gif2webp \-q 70 picture.gif \-o picture.webp .br gif2webp \-lossy \-m 3 picture.gif \-o picture_lossy.webp .br gif2webp \-lossy \-f 50 picture.gif \-o picture.webp .br gif2webp \-q 70 \-o picture.webp \-\- \-\-\-picture.gif .br cat picture.gif | gif2webp \-o \- \-\- \- > output.webp .SH "نویسندگان (AUTHORS)" دستور \fBgif2webp\fP بخشی از libwebp است و توسط تیم WebP نوشته شده است. .br آخرین درخت کد منبع در نشانی زیر در دسترس است: https://chromium.googlesource.com/webm/libwebp .PP این صفحه راهنما توسط Urvang Joshi برای پروژه دبیان نوشته شده است (و ممکن است توسط دیگران استفاده شود). .SH "گزارش باگ‌ها (REPORTING BUGS)" لطفاً تمام باگ‌ها را به سامانه پیگیری مشکلات گزارش دهید: https://issues.webmproject.org .br از وصله‌ها استقبال می‌شود! برای شروع این صفحه را ببینید: https://www.webmproject.org/code/contribute/submitting\-patches .SH "همچنین ببینید (SEE ALSO)" .BR cwebp (1), .BR dwebp (1), .BR webpmux (1) .br برای اطلاعات بیشتر لطفاً به https://developers.google.com/speed/webp مراجعه کنید.