.\"                                      Hey, EMACS: -*- nroff -*-
.TH DWEBP 1 "18 ژوئیه 2024"
.SH "نام (NAME)"
dwebp \- فشرده‌زدایی یک فایل WebP به یک فایل تصویری
.SH "خلاصه دستور (SYNOPSIS)"
.B dwebp
.RI [ options ] " input_file.webp
.br
.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما دستور
.B dwebp
را مستند می‌کند.
.PP
دستور \fBdwebp\fP فایل‌های WebP را به تصاویر PNG، PAM، PPM یا PGM فشرده‌زدایی می‌کند.
نکته: فایل‌های متحرک WebP پشتیبانی نمی‌شوند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های پایه عبارتند از:
.TP
.B \-h
چاپ خلاصه نحوه استفاده.
.TP
.B \-version
چاپ شماره نسخه (به صورت major.minor.revision) و خروج.
.TP
.BI \-o " string
تعیین نام فایل خروجی (به‌طور پیش‌فرض در قالب PNG).
استفاده از "-" به عنوان نام خروجی، خروجی را به 'stdout' هدایت می‌کند.
.TP
.BI \-\- " string
تعیین صریح فایل ورودی. این گزینه برای مثال زمانی مفید است که نام فایل ورودی با یک '\-' آغاز شود. این گزینه باید \fBدر انتها\fP بیاید.
هر گزینه دیگری پس از آن نادیده گرفته خواهد شد. اگر فایل ورودی "\-" باشد، داده‌ها به جای فایل از \fIstdin\fP خوانده خواهند شد.
.TP
.B \-bmp
تغییر قالب خروجی به BMP فشرده‌نشده.
.TP
.B \-tiff
تغییر قالب خروجی به TIFF فشرده‌نشده.
.TP
.B \-pam
تغییر قالب خروجی به PAM (کانال آلفا حفظ می‌شود).
.TP
.B \-ppm
تغییر قالب خروجی به PPM (کانال آلفا حذف می‌شود).
.TP
.B \-pgm
تغییر قالب خروجی به PGM. خروجی به جای RGB شامل نمونه‌های luma/chroma با استفاده از چینش IMC4 است. این گزینه عمدتاً برای اهداف اعتبارسنجی و اشکال‌زدایی کاربرد دارد.
.TP
.B \-yuv
تغییر قالب خروجی به YUV خام. خروجی به جای RGB شامل نمونه‌های luma/chroma-U/chroma-V است که به صورت متوالی به عنوان صفحه‌های مجزا ذخیره می‌شوند. این گزینه عمدتاً برای اهداف اعتبارسنجی و اشکال‌زدایی کاربرد دارد.
.TP
.B \-nofancy
عدم استفاده از بزرگ‌نمای پیشرفته (fancy upscaler) برای YUV420. این کار ممکن است منجر به لبه‌های دندانه‌دار شود (به‌ویژه لبه‌های قرمز)، اما سریع‌تر خواهد بود.
.TP
.B \-nofilter
عدم استفاده از فرایند پالایش درون‌حلقه‌ای (in-loop filtering) حتی اگر جریان بیت (bitstream) آن را الزامی کرده باشد. این کار ممکن است بلوک‌های قابل مشاهده‌ای در خروجی ناسازگار ایجاد کند، اما سرعت رمزگشایی را افزایش می‌دهد.
.TP
.BI \-dither " strength
تعیین \fBشدت\fP دیترینگ (dithering) بین 0 و 100. دیترینگ یک افکت پس‌پردازش است که بر روی مولفه‌های کروما در فشرده‌سازی بااتلاف اعمال می‌شود. این کار با هموار کردن گرادیان‌ها و جلوگیری از ایجاد نوارها (banding artifacts) به بهبود کیفیت کمک می‌کند.
.TP
.BI \-alpha_dither
اگر فایل فشرده‌شده دارای یک صفحه شفافیت باشد که حین فشرده‌سازی کوانتیزه شده است، این پرچم اجازه می‌دهد تا صفحه بازسازی‌شده دیتر شود تا گرادیان‌های شفافیت هموارتری ایجاد گردند.
.TP
.B \-nodither
غیرفعال‌سازی تمام دیترینگ‌ها (پیش‌فرض).
.TP
.B \-mt
استفاده از چندریسمانی (multi-threading) برای رمزگشایی در صورت امکان.
.TP
.BI \-crop " x_position y_position width height
برش تصویر رمزگشایی‌شده به یک مستطیل با گوشه بالا-چپ در مختصات (\fBx_position\fP, \fBy_position\fP) و اندازه \fBwidth\fP x \fBheight\fP. این ناحیه برش باید به‌طور کامل درون مستطیل تصویر مبدا قرار گیرد. گوشه بالا-چپ در صورت نیاز به مختصات زوج منطبق (snap) می‌شود. این گزینه برای کاهش حافظه مورد نیاز جهت برش تصاویر بزرگ در نظر گرفته شده است.
نکته: برش \fIپیش از\fP هرگونه مقیاس‌بندی اعمال می‌شود.
.TP
.B \-flip
وارونه کردن عمودی تصویر رمزگشایی‌شده (می‌تواند برای مثال برای بافت‌های OpenGL کاربرد داشته باشد).
.TP
\fB\-resize\fR, \fB\-scale\fI width height\fR
تغییر مقیاس تصویر رمزگشایی‌شده به ابعاد \fBwidth\fP x \fBheight\fP. هدف اصلی این گزینه کاهش حافظه مورد نیاز برای رمزگشایی تصاویر بزرگ است، هنگامی که تنها به نسخه کوچکی از آن نیاز باشد (تصویر بندانگشتی، پیش‌نمایش و غیره). نکته: مقیاس‌بندی \fIپس از\fP برش اعمال می‌شود.
اگر یکی از پارامترهای \fBwidth\fP یا \fBheight\fP (نه هر دو) صفر باشد، مقدار دیگر با حفظ نسبت ابعاد محاسبه خواهد شد.
.TP
.B \-quiet
عدم چاپ هرگونه پیام.
.TP
.B \-v
چاپ اطلاعات بیشتر (به‌ویژه زمان رمزگشایی).
.TP
.B \-noasm
غیرفعال‌سازی تمام بهینه‌سازی‌های اسمبلی.

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

.SH "مثال‌ها (EXAMPLES)"
dwebp picture.webp \-o output.png
.br
dwebp picture.webp \-ppm \-o output.ppm
.br
dwebp \-o output.ppm \-\- \-\-\-picture.webp
.br
cat picture.webp | dwebp \-o \- \-\- \- > output.ppm

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

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

.SH "همچنین ببینید (SEE ALSO)"
.BR cwebp (1),
.BR gif2webp (1),
.BR webpmux (1)
.br
لطفاً برای اطلاعات بیشتر به https://developers.google.com/speed/webp مراجعه کنید.
.SS جزئیات قالب فایل خروجی
PAM: http://netpbm.sourceforge.net/doc/pam.html
.br
PGM: http://netpbm.sourceforge.net/doc/pgm.html
.br
PPM: http://netpbm.sourceforge.net/doc/ppm.html
.br
PNG: http://www.libpng.org/pub/png/png-sitemap.html#info