.\" 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 "Ppmtowinicon User Manual" 0 "01 May 2004" "netpbm documentation"

.SH "نام (NAME)"
ppmtowinicon \- تبدیل تصویر PPM به یک فایل .ico ویندوز

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

\fBppmtowinicon\fP

[\fB-andpgms\fP]

[\fB-output=\fP\fIoutput.ico\fP]

[\fIppmfile\fP [\fIandfile\fP] ...]

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


.IP \(bu
16 x 16 - 4 bpp
.IP \(bu
32 x 32 - 4 bpp
.IP \(bu
48 x 48 - 8 bpp

.PP
اگر هیچ فایل ورودی را مشخص نکنید، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود.
.PP
خروجی به خروجی استاندارد (Standard Output) ارسال می‌شود، مگر اینکه گزینه \fB-output\fP را مشخص کنید.

.UN transparency
.SS "شفافیت (Transparency)"
.PP
اگر گزینه \fB-andmask\fP را مشخص کنید، آیکون‌های (تا حدی) شفاف دریافت خواهید کرد. در این حالت، آرگومان‌های شما جفت‌هایی از نام فایل‌ها خواهند بود، که فایل نخست تصویر اصلی و فایل دوم یک ماسک شفافیت استاندارد PGM در Netpbm است (به
.BR "pgm format specification" (1)\c
\& مراجعه کنید).
.PP
در یک فایل .ico، چیزی به نام شفافیت جزئی یا نیمه‌شفافی (translucency) وجود ندارد. هر جا که ماسک PGM کاملاً کدر (opaque) باشد، آیکون کدر خواهد بود. در هر جای دیگر، آیکون شفاف خواهد بود. توجه داشته باشید که مانند هر برنامه Netpbm، می‌توانید از یک تصویر PBM نیز برای ماسک شفافیت استفاده کنید و \fBppmtowinicon\fP با آن مانند یک PGM رفتار خواهد کرد.
.PP
ماسک AND شبیه به یک ماسک شفافیت است، با این تفاوت که در نواحی «غیرکدر» معنای متفاوتی دارد. در حالت معمول، تصویر پیش‌زمینه در آن نواحی سیاه است و در نتیجه آن نواحی کاملاً شفاف می‌شوند \-\- یعنی پس‌زمینه از میان آیکون نمایان می‌شود. اما به طور کلی، یک پیکسل غیرکدر بیانگر این است که پس‌زمینه و پیش‌زمینه باید به این ترتیب با یکدیگر ادغام شوند: شدت مؤلفه‌های رنگ در پیش‌زمینه و پس‌زمینه به صورت اعداد دودویی نمایش داده می‌شوند، سپس بیت‌های متناظر شدت‌های پس‌زمینه و پیش‌زمینه با یکدیگر XOR (یا exclusive-or) می‌شوند. بنابراین نوعی جلوه تصویر معکوس (reverse video) ایجاد می‌شود.
.PP
اگر این جلوه خاص را نمی‌خواهید و در عوض خواهان شفافیت مستقیم و ساده هستید، از گزینه \fB-truetransparent\fP استفاده کنید. این گزینه باعث می‌شود \fBppmtowinicon\fP تصویر پایه را در هر جایی که ماسک شفافیت مشخص کرده، صرف‌نظر از رنگ تصویر ورودی در آن نقطه، کاملاً سیاه کند.
.PP
اگر \fB-andmask\fP را مشخص نکنید، \fBppmtowinicon\fP ماسک‌های AND کاملاً کدر را در فایل .ico قرار می‌دهد.

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


.TP
\fB-andpgms\fP
اطلاعات شفافیت را در آیکون‌ها می‌گنجاند. به
.UR #transparency
بخش شفافیت
.UE
\& مراجعه کنید.
     
.TP
\fB-output=\fP\fIoutput.ico\fP
نام فایل خروجی. به طور پیش‌فرض، \fBppmtowinicon\fP آیکون را در خروجی استاندارد می‌نویسد.

.TP
\fB-truetransparent\fP
شفافیت در آیکون را به جای جلوه ویژه تصویر معکوس، به صورت عادی درمی‌آورد. به
.UR #transparency
بخش شفافیت
.UE
\& مراجعه کنید.
     


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamtowinicon" (1)\c
\&،
.BR "winicontoppm" (1)\c
\&،
.BR "ppm" (1)\c
\&،
.BR "pgm" (1)\c
\&

.UN author
.SH "نویسندگان (AUTHORS)"

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