.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamtowinicon User Manual" 1 "12 April 2013" "netpbm documentation"

.SH "نام (NAME)"
pamtowinicon \- تبدیل تصاویر Netpbm PAM به یک فایل آیکون مایکروسافت ویندوز (.ico)

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"
\fBpamtowinicon\fP
[\fB\-pngthreshold=\fP\fIحد_آستانه\fP]
[\fB\-truetransparent\fP]
[\fB\-verbose\fP]
[\fIفایل_pam\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد.
می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه استفاده کنید. همچنین
می‌توانید بین نام یک گزینه و مقدار آن از فاصله یا علامت مساوی استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamtowinicon\fP یک فایل Netpbm PAM از نوع RGB_ALPHA را می‌خواند و آن را به یک
فایل آیکون مایکروسافت ویندوز تبدیل می‌کند.
.PP
خروجی به خروجی استاندارد (Standard Output) ارسال می‌شود.
.PP
ورودی یک فایل PAM چندتصویری است؛ هر تصویر به یک آیکون در فایل
خروجی تبدیل می‌شود. اگر تصاویر ورودی شما در چند فایل جداگانه قرار دارند، می‌توانید به‌سادگی
آن‌ها را با دستور \fBcat\fP ترکیب کرده و نتیجه را به \fBpamtowinicon\fP ارسال کنید.

.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک بین تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه
\fB\-quiet\fP، به
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
مراجعه کنید)، دستور \fBpamtowinicon\fP گزینه‌های خط فرمان زیر را می‌شناسد:

.TP
\fB\-pngthreshold=\fP\fIحد_آستانه\fP
دستور \fBpamtowinicon\fP تصاویری را که وضوح (رزولوشن) آن‌ها بزرگتر یا
مساوی \fIحد_آستانه\fP در \fIحد_آستانه\fP باشد، از طریق اجرای
.BR "\fBpnmtopng\fP" (1)\c
\& به صورت PNG کدگذاری می‌کند. سایر تصاویر را
با استفاده از فرمت سنتی‌تر BMP کدگذاری می‌نماید.
.sp
هنگامی که برنامه از کدگذاری PNG برای یک فایل PAM پنج‌کاناله با ماسک AND مجزا استفاده می‌کند (به زیر مراجعه کنید)، ماسک AND را نادیده می‌گیرد. از آنجا که PNG همواره قابلیت تعیین شفافیت را داشته است، قالب آیکون ویندوز در حالتی که آیکون با فرمت PNG کدگذاری شده باشد، ماسک AND جداگانه‌ای ارائه نمی‌دهد.
.sp
مقدار پیش‌فرض برای \fIحد_آستانه\fP برابر با ۱۲۸ است.

.TP
\fB\-truetransparent\fP
تمام پیکسل‌های خارج از ناحیه مات را سیاه می‌کند تا از معکوس‌سازی رنگ
و سایر جلوه‌ها روی پس‌زمینه تصویر جلوگیری شود
(به
.BR "Windows Icons" (1)\c
\& مراجعه کنید).

.TP
\fB\-verbose\fP
چاپ پیام‌های بیشتر با جزئیات کامل‌تر.

.UN images
.SH "تصاویر (IMAGES)"
.PP
دستور \fBpamtowinicon\fP یک فایل Netpbm PAM (چندتصویری) را به عنوان ورودی
می‌خواند و یک فایل آیکون ویندوز منفرد حاوی آن تصاویر را خروجی می‌دهد.
.PP
تصاویر در فایل آیکون به همان ترتیبی قرار می‌گیرند که در ورودی PAM آمده‌اند.

.UN paminput
.SS "ورودی PAM (PAM Input)"
.PP
دستور \fBpamtowinicon\fP تصاویر PAM را بر اساس تعداد کانال‌ها
به صورت زیر تفسیر می‌کند:

.TS
l l.
_
کانال‌ها	تصویر
1	تصویر کاملاً مات در مقیاس خاکستری (grayscale)
2	تصویر در مقیاس خاکستری به همراه کانال شفافیت
3	تصویر رنگی کاملاً مات
4	تصویر رنگی به همراه کانال شفافیت
5	تصویر رنگی به همراه کانال شفافیت و ماسک AND اضافی
.TE
.PP
نوع تاپل (tuple type) فایل‌های PAM اهمیتی ندارد.

.UN andmask
.SS "ماسک AND (AND Mask)"
اصطلاح موسوم به «ماسک AND» یک ویژگی خاص در آیکون‌های مایکروسافت
ویندوز است. این ماسک برای تمام تصاویر کدگذاری‌شده با فرمت BMP الزامی است. در
نگاه نخست، ماسک AND یک کانال شفافیت ۱ بیتی است، اما برای مواردی مانند سایه‌زدن آیکون هنگام کشیدن (drag) نیز
استفاده می‌شود. برای جزئیات به
.BR "Windows Icons" (1)\c
\& مراجعه کنید.
.PP
اگر ماسک AND صریحی وجود نداشته باشد اما داده‌های شفافیت در تصویر
ورودی موجود باشد، \fBpamtowinicon\fP ماسک AND را در نقاطی که نمونه موجود در کانال شفافیت کمتر از maxval باشد به صورت مات، و در سایر نقاط
به صورت شفاف تنظیم می‌کند.
.PP
اگر هیچ داده شفافیتی در تصویر ورودی وجود نداشته باشد،
\fBpamtowinicon\fP کل تصویر را کاملاً مات در نظر می‌گیرد.

.UN bmpoutput
.SS "خروجی BMP (BMP Output)"
هنگام کدگذاری یک تصویر به فرمت BMP، دستور \fBpamtowinicon\fP تلاش می‌کند تا از فشرده‌ترین
فرمت \fBBI_RGB\fP مجاز برای تصاویر آیکون با عمق رنگ
هشت بیت در هر کانال استفاده کند.
.PP
دستور \fBpamtowinicon\fP تصاویر کدگذاری‌شده BMP با فرمت ۱۶ بیتی \fBBI_RGB\fP یا
\fBBI_BITFIELDS\fP تولید نمی‌کند، حتی اگر مقدار maxval در فایل PAM
ورودی ۲۵۵ نباشد.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"

.IP \(bu
.BR "\fBwinicontopam\fP" (1)\c
\&
.IP \(bu
.BR "\fBppmtowinicon\fP" (1)\c
\&
.IP \(bu
.BR "\fBpam\fP" (1)\c
\&
.IP \(bu
.BR "\fBWindows Icons\fP" (1)\c
\&

.PP
برای اطلاعات درباره فرمت PNG، به
.UR http://schaik.com/png
http://schaik.com/png
.UE
مراجعه کنید.

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamtowinicon\fP در نگارش 10.63 نرم‌افزار Netpbm (ژوئن ۲۰۱۳) معرفی شد. این برنامه با ارائه قابلیت‌های بیشتر و سازگاری بهتر با
قراردادهای Netpbm، جایگزین \fBppmtowinicon\fP گردید.

.UN author
.SH "نویسنده (AUTHOR)"
.PP
حق نشر (C) ۲۰۱۳ متعلق به Ludolf Holzheid است.
.PP
ترجمه به سبک کدنویسی Netpbm توسط Bryan Henderson انجام شده است.

.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از روی منبع HTML
تولید شده است. مستندات اصلی در نشانی زیر قرار دارند:
.IP
.B http://netpbm.sourceforge.net/doc/pamtowinicon.html
.PP