.\"                                      Hey, EMACS: -*- nroff -*-
.TH IMG2WEBP 1 "November 26, 2024"
.SH "نام (NAME)"
img2webp \- ساخت تصاویر متحرک WebP از توالی تصاویر ورودی
.SH "خلاصه دستور (SYNOPSIS)"
.B img2webp
[file_options] [[frame_options] frame_file]... [\-o webp_file]
.br
.B img2webp argument_file_name
.br
.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما دستور
.B img2webp
را توضیح می‌دهد.
.PP
دستور
\fBimg2webp\fP
توالی از تصاویر را با استفاده از فرمت WebP متحرک فشرده‌سازی می‌کند.
تصاویر ورودی می‌توانند PNG، JPEG، TIFF یا WebP باشند.
اگر یک نام فایل منفرد (که با نویسه «\-» شروع نمی‌شود) به عنوان آرگومان داده شود، آرگومان‌های خط فرمان در واقع از درون این فایل خوانده و تقطیع می‌شوند.
این ویژگی امکان اسکریپت‌نویسی آسان یا استفاده از تعداد زیادی آرگومان را فراهم می‌کند.
.SH "گزینه‌های سطح فایل (FILE-LEVEL OPTIONS)"
گزینه‌های سطح فایل در ابتدای فرآیند فشرده‌سازی و پیش از خواندن فریم‌های ورودی اعمال می‌شوند.
.TP
.BI \-o " string"
تعیین نام فایل خروجی WebP.
.TP
.BI \-min_size
کدگذاری تصاویر به منظور دستیابی به کمترین اندازه ممکن. این گزینه درج فریم‌های کلیدی را غیرفعال کرده و پارامترهایی را انتخاب می‌کند که کمترین حجم خروجی را برای هر فریم ایجاد می‌کنند. این گزینه به طور پیش‌فرض از فشرده‌سازی بدون اتلاف استفاده می‌کند، اما می‌تواند با گزینه‌های \-q، \-m، \-lossy یا \-mixed ترکیب شود.
.TP
.BI \-kmin " int"
.TP
.BI \-kmax " int"
تعیین حداقل و حداکثر فاصله بین فریم‌های کلیدی متوالی (فریم‌هایی با قابلیت رمزگشایی مستقل) در انیمیشن خروجی. این ابزار در صورت نیاز فریم‌های کلیدی لازم را در انیمیشن خروجی درج می‌کند تا این معیار برآورده شود.
.TP
.B \-mixed
حالت فشرده‌سازی ترکیبی: بهینه‌سازی فشرده‌سازی تصویر با انتخاب اکتشافی بین حالت‌های با اتلاف یا بدون اتلاف برای هر فریم. این گزینه سراسری گزینه‌های محلی \fB\-lossy\fP و \fB\-lossless\fP را غیرفعال می‌کند.
.TP
.BI \-near_lossless " int"
تعیین سطح پیش‌پردازش تصویر نزدیک به بدون اتلاف (near-lossless). این گزینه مقادیر پیکسل‌ها را برای کمک به فشرده‌پذیری بهتر تنظیم می‌کند، اما کمترین تأثیر را روی کیفیت بصری دارد. این گزینه حالت فشرده‌سازی بدون اتلاف را به طور خودکار فعال می‌کند. دامنه مقادیر از 0 (حداکثر پیش‌پردازش) تا 100 (بدون پیش‌پردازش، پیش‌فرض) است. مقدار معمول حدود 60 است. توجه داشته باشید که حالت با اتلاف همراه با \fB\-q 100\fP گاهی اوقات می‌تواند نتایج بهتری به همراه داشته باشد.
.TP
.B \-sharp_yuv
استفاده از تبدیل دقیق‌تر و شفاف‌تر RGB->YUV. توجه داشته باشید که این فرآیند از تبدیل پیش‌فرض و «سریع» RGB->YUV کندتر است.
.TP
.BI \-loop " int"
تعیین تعداد دفعاتی که انیمیشن باید تکرار (حلقه) شود. مقدار «0» به معنای «حلقه نامحدود» است.
.TP
.BI \-v
نمایش جزئیات بیشتر (Verbose).
.TP
.B \-h, \-help
نمایش خلاصه کوتاهی از نحوه استفاده.
.TP
.B \-version
چاپ شماره نسخه کتابخانه‌های مرتبط مورد استفاده.

.SH "گزینه‌های مربوط به هر فریم (PER-FRAME OPTIONS)"
گزینه‌های مربوط به هر فریم برای تصاویری اعمال می‌شوند که پس از آن‌ها در خط فرمان قرار می‌گیرند. این گزینه‌ها را می‌توان به تعداد دفعات دلخواه قبل از هر تصویر ورودی خاص تغییر داد.
.TP
.BI \-d " int"
تعیین مدت زمان نمایش فریم بر حسب میلی‌ثانیه.
.TP
.B \-lossless, \-lossy
فشرده‌سازی تصویر (یا تصاویر) بعدی با استفاده از حالت بدون اتلاف یا با اتلاف. حالت پیش‌فرض، بدون اتلاف است.
.TP
.BI \-q " float"
تعیین ضریب فشرده‌سازی بین 0 تا 100. مقدار پیش‌فرض 75 است.
.TP
.BI \-m " int"
تعیین روش فشرده‌سازی مورد استفاده. این پارامتر مصالحه بین سرعت کدگذاری و حجم و کیفیت فایل فشرده‌شده را کنترل می‌کند.
مقادیر مجاز بین 0 تا 6 هستند. مقدار پیش‌فرض 4 است.
هنگامی که از مقادیر بالاتر استفاده می‌شود، رمزگذار زمان بیشتری را صرف بررسی احتمالات کدگذاری بیشتر و تصمیم‌گیری درباره افزایش کیفیت می‌کند.
مقادیر پایین‌تر می‌توانند به زمان پردازش سریع‌تر به قیمت حجم فایل بیشتر و کیفیت فشرده‌سازی پایین‌تر منجر شوند.
.TP
.B \-exact, \-noexact
حفظ یا تغییر مقادیر RGB در نواحی شفاف. مقدار پیش‌فرض \fB\-noexact\fP است تا به فشرده‌پذیری بهتر کمک کند. توجه داشته باشید که \fB\-noexact\fP ممکن است در فریم‌های فشرده‌شده با \fB\-lossy\fP اثرات نامطلوب مصنوعی (artifacts) ایجاد کند.

.SH "وضعیت خروج (EXIT STATUS)"
در صورت اجرای موفقیت‌آمیز و بدون مشکل، \fBimg2webp\fP با مقدار ثابت C یعنی \fBEXIT_SUCCESS\fP (معمولاً صفر) خارج می‌شود.
.PP
در صورت بروز خطا، \fBimg2webp\fP با مقدار ثابت C یعنی \fBEXIT_FAILURE\fP (معمولاً یک) خارج می‌شود.

.SH "مثال‌ها (EXAMPLES)"
.EX
img2webp -loop 2 in0.png -lossy in1.jpg -d 80 in2.tiff -o out.webp
.EE

.SH "نویسندگان (AUTHORS)"
دستور \fBimg2webp\fP بخشی از libwebp است و توسط تیم WebP نوشته شده است.
.br
آخرین درخت کد منبع در نشانی زیر در دسترس است:
https://chromium.googlesource.com/webm/libwebp
.PP
این صفحه راهنما توسط Pascal Massimino <pascal.massimino@gmail.com> برای پروژه دبیان نوشته شده است (و ممکن است توسط دیگران استفاده شود).

.SH "گزارش باگ‌ها (REPORTING BUGS)"
لطفاً تمام باگ‌ها را به سامانه ردیابی مشکلات گزارش دهید:
https://issues.webmproject.org
.br
از ارسال وصله‌ها استقبال می‌شود! برای شروع این صفحه را ببینید:
https://www.webmproject.org/code/contribute/submitting\-patches

.SH "همچنین ببینید (SEE ALSO)"
.BR webpmux (1),
.BR gif2webp (1)
.br
برای اطلاعات تکمیلی لطفاً به https://developers.google.com/speed/webp مراجعه کنید.