.\" 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 "Winicontopam User Manual" 0 "29 August 2020" "netpbm documentation"

.SH "نام (NAME)"

winicontopam \- تبدیل فایل آیکون مایکروسافت ویندوز به یک فایل Netpbm PAM


.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBwinicontopam\fP
[\fB-image=\fP\fIindex\fP | \fB-allimages\fP]
[\fB-andmasks\fP]
[\fB-verbose\fP]
[\fIicon_file\fP]
.PP
تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد.
می‌توانید برای مشخص کردن یک گزینه، به جای یک خط تیره از دو خط تیره استفاده کنید.
همچنین می‌توانید بین نام گزینه و مقدار آن از فاصله یا علامت مساوی استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBwinicontopam\fP یک فایل آیکون مایکروسافت ویندوز را می‌خواند و آن را به یک یا چند تصویر Netpbm PAM از نوع RGB_ALPHA تبدیل می‌کند.
.PP
دو نوع اطلاعات شفافیت (transparency) وجود دارد که یک آیکون ویندوز می‌تواند داشته باشد: ماسک AND و نگاشت شفافیت مدرج (graded transparency map). ماسک AND قدیمی‌تر است و برای هر پیکسل مشخص می‌کند که آیا کاملاً مات است یا کاملاً شفاف. نگاشت شفافیت مدرج می‌تواند مقادیر نیمه‌شفاف را نیز مشخص کند. نگاشت شفافیت مدرج در آیکون‌هایی وجود دارد که از کدگذاری PNG استفاده می‌کنند یا از کدگذاری BMP با ۳۲ بیت در هر پیکسل بهره می‌برند.
.PP
صفحه شفافیت در خروجی PAM دستور \fBwinicontopam\fP در صورت وجود، از نگاشت شفافیت مدرج و در غیر این صورت از ماسک AND گرفته می‌شود.
.PP
یک آیکون در عمل ممکن است هر دو نوع اطلاعات شفافیت را داشته باشد؛ به گزینهٔ
\fB-andmasks\fP مراجعه کنید.
.PP
خروجی به خروجی استاندارد (Standard Output) فرستاده می‌شود.
.PP
خروجی یک فایل PAM چندتصویری است. اگر می‌خواهید برای هر تصویر یک فایل جداگانه داشته باشید، از
.BR "\fBpamsplit\fP" (1)\c
\& استفاده کنید.


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



.TP
\fB-allimages\fP
تمام تصاویر موجود در ورودی را تبدیل می‌کند.
.sp
نمی‌توانید این گزینه را همراه با \fB-image\fP مشخص کنید.
.sp
به‌طور پیش‌فرض، \fBwinicontopam\fP تنها یک تصویر با «بهترین کیفیت» را تبدیل می‌کند (بزرگ‌ترین اندازه، و سپس بیشترین بیت در هر پیکسل).

.TP
\fB-image=\fP\fIindex\fP
تصویر شمارهٔ \fIindex\fP را تبدیل می‌کند (شروع از صفر).
.sp
نمی‌توانید این گزینه را همراه با \fB-allimages\fP مشخص کنید.
.sp
به‌طور پیش‌فرض، \fBwinicontopam\fP تصویر با «بهترین کیفیت» را تبدیل می‌کند (بزرگ‌ترین اندازه، و سپس بیشترین بیت در هر پیکسل).

.TP
\fB-andmasks\fP
اگر تصویری که باید استخراج شود هم شامل داده‌های شفافیت مدرج و هم ماسک AND باشد، یک تصویر Netpbm PAM پنج‌کاناله تولید می‌کند که در آن ماسک AND به عنوان صفحهٔ پنجم قرار می‌گیرد. تصویری که به صورت صوری داده‌های شفافیت مدرج دارد اما چیزی جز پیکسل‌های مات را نشان نمی‌دهد، فاقد داده‌های شفافیت مدرج در نظر گرفته می‌شود؛ بنابراین \fB-andmasks\fP هیچ اثری روی آن نخواهد داشت.

.TP
\fB-verbose\fP
پیام‌های بیشتری را نمایش می‌دهد.




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


.IP \(bu

.BR "\fBpamtowinicon\fP" (1)\c
\&
.IP \(bu

.BR "\fBwinicontoppm\fP" (1)\c
\&
.IP \(bu

.BR "\fBpamsplit\fP" (1)\c
\&
.IP \(bu

.BR "\fBpam\fP" (1)\c
\& 
.IP \(bu

.BR "\fBwinicon\fP" (1)\c
\&

.PP
برای اطلاعات دربارهٔ قالب PNG، به نشانی زیر مراجعه کنید:
.UR http://schaik.com/png
http://schaik.com/png
.UE
\&.


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


.UN author
.SH "نویسندگان (AUTHORS)"
.PP
حق نشر (C) ۲۰۱۳ متعلق به Ludolf Holzheid است.
.PP
توسط Bryan Henderson به سبک کدنویسی Netpbm بازنویسی شده است.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/winicontopam.html
.PP