نام (NAME)

img2webp - ساخت تصاویر متحرک WebP از توالی تصاویر ورودی

خلاصه دستور (SYNOPSIS)

img2webp [file_options] [[frame_options] frame_file]... [-o webp_file]
img2webp argument_file_name

توضیحات (DESCRIPTION)

این صفحه راهنما دستور img2webp را توضیح می‌دهد.

دستور img2webp توالی از تصاویر را با استفاده از فرمت WebP متحرک فشرده‌سازی می‌کند. تصاویر ورودی می‌توانند PNG، JPEG، TIFF یا WebP باشند. اگر یک نام فایل منفرد (که با نویسه «-» شروع نمی‌شود) به عنوان آرگومان داده شود، آرگومان‌های خط فرمان در واقع از درون این فایل خوانده و تقطیع می‌شوند. این ویژگی امکان اسکریپت‌نویسی آسان یا استفاده از تعداد زیادی آرگومان را فراهم می‌کند.

گزینه‌های سطح فایل (FILE-LEVEL OPTIONS)

گزینه‌های سطح فایل در ابتدای فرآیند فشرده‌سازی و پیش از خواندن فریم‌های ورودی اعمال می‌شوند.

-o string

تعیین نام فایل خروجی WebP.

-min_size

کدگذاری تصاویر به منظور دستیابی به کمترین اندازه ممکن. این گزینه درج فریم‌های کلیدی را غیرفعال کرده و پارامترهایی را انتخاب می‌کند که کمترین حجم خروجی را برای هر فریم ایجاد می‌کنند. این گزینه به طور پیش‌فرض از فشرده‌سازی بدون اتلاف استفاده می‌کند، اما می‌تواند با گزینه‌های -q، -m، -lossy یا -mixed ترکیب شود.

-kmin int

-kmax int

تعیین حداقل و حداکثر فاصله بین فریم‌های کلیدی متوالی (فریم‌هایی با قابلیت رمزگشایی مستقل) در انیمیشن خروجی. این ابزار در صورت نیاز فریم‌های کلیدی لازم را در انیمیشن خروجی درج می‌کند تا این معیار برآورده شود.

-mixed

حالت فشرده‌سازی ترکیبی: بهینه‌سازی فشرده‌سازی تصویر با انتخاب اکتشافی بین حالت‌های با اتلاف یا بدون اتلاف برای هر فریم. این گزینه سراسری گزینه‌های محلی -lossy و -lossless را غیرفعال می‌کند.

-near_lossless int

تعیین سطح پیش‌پردازش تصویر نزدیک به بدون اتلاف (near-lossless). این گزینه مقادیر پیکسل‌ها را برای کمک به فشرده‌پذیری بهتر تنظیم می‌کند، اما کمترین تأثیر را روی کیفیت بصری دارد. این گزینه حالت فشرده‌سازی بدون اتلاف را به طور خودکار فعال می‌کند. دامنه مقادیر از 0 (حداکثر پیش‌پردازش) تا 100 (بدون پیش‌پردازش، پیش‌فرض) است. مقدار معمول حدود 60 است. توجه داشته باشید که حالت با اتلاف همراه با -q 100 گاهی اوقات می‌تواند نتایج بهتری به همراه داشته باشد.

-sharp_yuv

استفاده از تبدیل دقیق‌تر و شفاف‌تر RGB->YUV. توجه داشته باشید که این فرآیند از تبدیل پیش‌فرض و «سریع» RGB->YUV کندتر است.

-loop int

تعیین تعداد دفعاتی که انیمیشن باید تکرار (حلقه) شود. مقدار «0» به معنای «حلقه نامحدود» است.

-v

نمایش جزئیات بیشتر (Verbose).

-h, -help

نمایش خلاصه کوتاهی از نحوه استفاده.

-version

چاپ شماره نسخه کتابخانه‌های مرتبط مورد استفاده.

گزینه‌های مربوط به هر فریم (PER-FRAME OPTIONS)

گزینه‌های مربوط به هر فریم برای تصاویری اعمال می‌شوند که پس از آن‌ها در خط فرمان قرار می‌گیرند. این گزینه‌ها را می‌توان به تعداد دفعات دلخواه قبل از هر تصویر ورودی خاص تغییر داد.

-d int

تعیین مدت زمان نمایش فریم بر حسب میلی‌ثانیه.

-lossless, -lossy

فشرده‌سازی تصویر (یا تصاویر) بعدی با استفاده از حالت بدون اتلاف یا با اتلاف. حالت پیش‌فرض، بدون اتلاف است.

-q float

تعیین ضریب فشرده‌سازی بین 0 تا 100. مقدار پیش‌فرض 75 است.

-m int

تعیین روش فشرده‌سازی مورد استفاده. این پارامتر مصالحه بین سرعت کدگذاری و حجم و کیفیت فایل فشرده‌شده را کنترل می‌کند. مقادیر مجاز بین 0 تا 6 هستند. مقدار پیش‌فرض 4 است. هنگامی که از مقادیر بالاتر استفاده می‌شود، رمزگذار زمان بیشتری را صرف بررسی احتمالات کدگذاری بیشتر و تصمیم‌گیری درباره افزایش کیفیت می‌کند. مقادیر پایین‌تر می‌توانند به زمان پردازش سریع‌تر به قیمت حجم فایل بیشتر و کیفیت فشرده‌سازی پایین‌تر منجر شوند.

-exact, -noexact

حفظ یا تغییر مقادیر RGB در نواحی شفاف. مقدار پیش‌فرض -noexact است تا به فشرده‌پذیری بهتر کمک کند. توجه داشته باشید که -noexact ممکن است در فریم‌های فشرده‌شده با -lossy اثرات نامطلوب مصنوعی (artifacts) ایجاد کند.

وضعیت خروج (EXIT STATUS)

در صورت اجرای موفقیت‌آمیز و بدون مشکل، img2webp با مقدار ثابت C یعنی EXIT_SUCCESS (معمولاً صفر) خارج می‌شود.

در صورت بروز خطا، img2webp با مقدار ثابت C یعنی EXIT_FAILURE (معمولاً یک) خارج می‌شود.

مثال‌ها (EXAMPLES)

img2webp -loop 2 in0.png -lossy in1.jpg -d 80 in2.tiff -o out.webp

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

دستور img2webp بخشی از libwebp است و توسط تیم WebP نوشته شده است.
آخرین درخت کد منبع در نشانی زیر در دسترس است: https://chromium.googlesource.com/webm/libwebp

این صفحه راهنما توسط Pascal Massimino <pascal.massimino@gmail.com> برای پروژه دبیان نوشته شده است (و ممکن است توسط دیگران استفاده شود).

گزارش باگ‌ها (REPORTING BUGS)

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

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

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