نام (NAME)

dwebp - فشرده‌زدایی یک فایل WebP به یک فایل تصویری

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

dwebp [options] input_file.webp

توضیحات (DESCRIPTION)

این صفحه راهنما دستور dwebp را مستند می‌کند.

دستور dwebp فایل‌های WebP را به تصاویر PNG، PAM، PPM یا PGM فشرده‌زدایی می‌کند. نکته: فایل‌های متحرک WebP پشتیبانی نمی‌شوند.

گزینه‌ها (OPTIONS)

گزینه‌های پایه عبارتند از:

-h

چاپ خلاصه نحوه استفاده.

-version

چاپ شماره نسخه (به صورت major.minor.revision) و خروج.

-o string

تعیین نام فایل خروجی (به‌طور پیش‌فرض در قالب PNG). استفاده از "-" به عنوان نام خروجی، خروجی را به 'stdout' هدایت می‌کند.

-- string

تعیین صریح فایل ورودی. این گزینه برای مثال زمانی مفید است که نام فایل ورودی با یک '-' آغاز شود. این گزینه باید در انتها بیاید. هر گزینه دیگری پس از آن نادیده گرفته خواهد شد. اگر فایل ورودی "-" باشد، داده‌ها به جای فایل از stdin خوانده خواهند شد.

-bmp

تغییر قالب خروجی به BMP فشرده‌نشده.

-tiff

تغییر قالب خروجی به TIFF فشرده‌نشده.

-pam

تغییر قالب خروجی به PAM (کانال آلفا حفظ می‌شود).

-ppm

تغییر قالب خروجی به PPM (کانال آلفا حذف می‌شود).

-pgm

تغییر قالب خروجی به PGM. خروجی به جای RGB شامل نمونه‌های luma/chroma با استفاده از چینش IMC4 است. این گزینه عمدتاً برای اهداف اعتبارسنجی و اشکال‌زدایی کاربرد دارد.

-yuv

تغییر قالب خروجی به YUV خام. خروجی به جای RGB شامل نمونه‌های luma/chroma-U/chroma-V است که به صورت متوالی به عنوان صفحه‌های مجزا ذخیره می‌شوند. این گزینه عمدتاً برای اهداف اعتبارسنجی و اشکال‌زدایی کاربرد دارد.

-nofancy

عدم استفاده از بزرگ‌نمای پیشرفته (fancy upscaler) برای YUV420. این کار ممکن است منجر به لبه‌های دندانه‌دار شود (به‌ویژه لبه‌های قرمز)، اما سریع‌تر خواهد بود.

-nofilter

عدم استفاده از فرایند پالایش درون‌حلقه‌ای (in-loop filtering) حتی اگر جریان بیت (bitstream) آن را الزامی کرده باشد. این کار ممکن است بلوک‌های قابل مشاهده‌ای در خروجی ناسازگار ایجاد کند، اما سرعت رمزگشایی را افزایش می‌دهد.

-dither strength

تعیین شدت دیترینگ (dithering) بین 0 و 100. دیترینگ یک افکت پس‌پردازش است که بر روی مولفه‌های کروما در فشرده‌سازی بااتلاف اعمال می‌شود. این کار با هموار کردن گرادیان‌ها و جلوگیری از ایجاد نوارها (banding artifacts) به بهبود کیفیت کمک می‌کند.

-alpha_dither

اگر فایل فشرده‌شده دارای یک صفحه شفافیت باشد که حین فشرده‌سازی کوانتیزه شده است، این پرچم اجازه می‌دهد تا صفحه بازسازی‌شده دیتر شود تا گرادیان‌های شفافیت هموارتری ایجاد گردند.

-nodither

غیرفعال‌سازی تمام دیترینگ‌ها (پیش‌فرض).

-mt

استفاده از چندریسمانی (multi-threading) برای رمزگشایی در صورت امکان.

-crop x_position y_position width height

برش تصویر رمزگشایی‌شده به یک مستطیل با گوشه بالا-چپ در مختصات (x_position, y_position) و اندازه width x height. این ناحیه برش باید به‌طور کامل درون مستطیل تصویر مبدا قرار گیرد. گوشه بالا-چپ در صورت نیاز به مختصات زوج منطبق (snap) می‌شود. این گزینه برای کاهش حافظه مورد نیاز جهت برش تصاویر بزرگ در نظر گرفته شده است. نکته: برش پیش از هرگونه مقیاس‌بندی اعمال می‌شود.

-flip

وارونه کردن عمودی تصویر رمزگشایی‌شده (می‌تواند برای مثال برای بافت‌های OpenGL کاربرد داشته باشد).

-resize, -scale width height

تغییر مقیاس تصویر رمزگشایی‌شده به ابعاد width x height. هدف اصلی این گزینه کاهش حافظه مورد نیاز برای رمزگشایی تصاویر بزرگ است، هنگامی که تنها به نسخه کوچکی از آن نیاز باشد (تصویر بندانگشتی، پیش‌نمایش و غیره). نکته: مقیاس‌بندی پس از برش اعمال می‌شود. اگر یکی از پارامترهای width یا height (نه هر دو) صفر باشد، مقدار دیگر با حفظ نسبت ابعاد محاسبه خواهد شد.

-quiet

عدم چاپ هرگونه پیام.

-v

چاپ اطلاعات بیشتر (به‌ویژه زمان رمزگشایی).

-noasm

غیرفعال‌سازی تمام بهینه‌سازی‌های اسمبلی.

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

اگر هیچ مشکلی در حین اجرا رخ ندهد، dwebp با مقدار ثابت C یعنی EXIT_SUCCESS خارج می‌شود. این مقدار معمولاً صفر است.

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

مثال‌ها (EXAMPLES)

dwebp picture.webp -o output.png
dwebp picture.webp -ppm -o output.ppm
dwebp -o output.ppm -- ---picture.webp
cat picture.webp | dwebp -o - -- - > output.ppm

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

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

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

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

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

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

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