.\" 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 "Infotopam User Manual" 0 "22 March 2024" "netpbm documentation"

.SH "نام (NAME)"
infotopam \- تبدیل آیکون‌های info. در Amiga به PAM

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBinfotopam\fP
[\fB-forcecolor\fP]
[\fB-numcolors\fP \fInumcolors\fP]
[\fB-selected\fP]
[\fB-verbose\fP]
[\fIindex\fP \fIcolor\fP ...]
[\fIfilename\fP]
.PP
کوتاه‌ترین اختصار یکتای هر گزینه پذیرفته می‌شود. می‌توانید به جای یک خط پیوند، از دو خط پیوند برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسهٔ فاصله برای جدا کردن نام یک گزینه از مقدار آن استفاده کنید.

.UN examples
.SH "مثال‌ها (EXAMPLES)"

.nf
  \f(CW
    $ infotopam amiga.info > amiga.first.pam
  \fP
.fi
.PP
از گزینهٔ \fI-selected\fP برای تبدیل نسخهٔ «انتخاب‌شده» آیکون به جای نسخهٔ معمولی آن استفاده کنید. در این حالت، \fBinfotopam\fP از ورودی استاندارد می‌خواند:

.nf
  \f(CW
    infotopam -selected < amiga.info > amiga.second.pam
  \fP
.fi
.PP
از \fI-numcolors\fP برای تغییر دادن رنگ‌ها استفاده کنید.

.nf
  \f(CW
    infotopam -numcolors 2 0 green 3 rgb:FF/00/00 icon.info > icon.pam
  \fP
.fi
.PP
از آنجا که نمایشگرهای Amiga از پیکسل‌های مربعی استفاده نمی‌کنند، ممکن است برخی آیکون‌ها فشرده یا لهیده به نظر برسند. پالودن خروجی از طریق \fBpamscale\fP می‌تواند این مشکل را برطرف کند:

.nf
  \f(CW
    $ infotopam squish.info | pamtopnm | pamscale -yscale 1.7 > normal.pnm
  \fP
.fi


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBinfotopam\fP یک تصویر info. (آیکون) Amiga را به یک تصویر PAM تبدیل می‌کند.
\fBinfotopam\fP فایل info. را از \fIfilename\fP، یا در صورت مشخص نکردن نام فایل از ورودی استاندارد می‌خواند و تصویر تبدیل‌شدهٔ PAM را در خروجی استاندارد می‌نویسد.
.PP
دستور \fBinfotopam\fP از آیکون‌های ۱ و ۲ صفحه‌بیتی (bit-plane) پشتیبانی می‌کند. اگر آیکون info. تنها ۱ صفحه‌بیت داشته باشد، \fBinfotopam\fP یک تصویر PAM سیاه‌وسفید تولید می‌کند؛ در غیر این صورت یک تصویر PAM رنگی تولید خواهد کرد. در حالت اخیر، می‌توانید رنگ‌ها را سفارشی‌سازی کنید یا رنگ‌های استاندارد و اصلی Amiga را حفظ نمایید. همچنین می‌توانید با گزینهٔ \fB-forcecolor\fP، دستور \fBinfotopam\fP را وادار کنید تا برای ورودی‌های ۱ صفحه‌بیتی نیز PAM رنگی تولید کند.
  

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


.TP
\fB-numcolors\fP \fInumcolors\fP
این گزینه باعث می‌شود برنامه در فرایند تبدیل، رنگ‌ها را تغییر دهد. یک تصویر آیکون ۲ صفحه‌بیتی Amiga دارای چهار رنگ است که از ۰ تا ۳ شماره‌گذاری شده‌اند. این رنگ‌ها به شرح زیر هستند:


.TP
0
      
آبی   (00, 55, AA)
.TP
1
      
سفید  (FF, FF, FF)
.TP
2
      
سیاه  (00, 00, 20)
.TP
3
      
نارنجی (FF, 8A, 00)

.sp
برای مشخص کردن تغییرات، تعداد رنگ‌هایی را که قصد جایگزینی آن‌ها را دارید به عنوان آرگومان \fB-numcolors\fP مشخص کنید و برای هر رنگ، یک جفت آرگومان خط فرمان بیاورید؛ آرگومان نخست نمایهٔ رنگ از ۰ تا ۳ و دومی رنگ جایگزین خواهد بود. رنگ (\fIcolor\fP) را همان‌طور که برای
    
.UR libnetpbm_image.html#colorname
آرگومان تابع کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
\& شرح داده شده است، تعیین نمایید.
.sp
\fBاین آرگومان‌ها قبل از آرگومان نام فایل ورودی (در صورت وجود) قرار می‌گیرند\fP. این یک نحو نامعمول برای برنامه‌های Netpbm است.

.TP
\fB-selected\fP

    
یک تصویر info. در Amiga شامل دو نسخه از آیکون است: یکی برای نمایش معمولی و دیگری برای نمایش در زمانی که شیء متناظر با آیکون انتخاب شده است. به صورت پیش‌فرض، \fBinfotopam\fP آیکون معمولی را تبدیل می‌کند، اما این گزینه باعث می‌شود که در عوض نسخهٔ انتخاب‌شده تبدیل شود.

.TP
\fB-forcecolor\fP
.sp
این گزینه باعث می‌شود \fBinfotopam\fP آیکون‌های ۱ صفحه‌بیتی را به جای تصاویر سیاه‌وسفید، به تصاویر PAM رنگی تبدیل کند. رنگ‌ها شامل رنگ نمایهٔ ۲ برای سیاه و رنگ نمایهٔ ۱ برای سفید خواهند بود.

.TP
\fB-verbose\fP
.sp
این گزینه باعث می‌شود \fBinfotopam\fP پیام‌های اطلاع‌رسانی دربارهٔ فرایند تبدیل صادر کند.
.sp
این گزینه در Netpbm 11.06 (مارس ۲۰۲۴) اضافه شد.


.PP
تمامی گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.PP
.BR "pam" (1)\c
\&
.BR "pamtopnm" (1)\c
\&
.BR "pamscale" (1)\c
\&


.UN notes
.SH "نکات (NOTES)"
.PP
با تشکر از افراد زیر در comp.sys.amiga.programmer بابت راهنمایی‌ها و نکاتشان در رابطه با رمزگشایی ساختار فایل info.:


.IP \(bu
Ben Hutchings
.IP \(bu
Thomas Richter
.IP \(bu
Kjetil Svalastog Matheussen
.IP \(bu
Anders Melchiorsen
.IP \(bu
Dirk Stoecker
.IP \(bu
Ronald V.D.

.PP
قالب فایل info. در Amiga به شرح زیر است:

.nf
    DiskObject header            78 bytes
    Optional DrawerData header   56 bytes
    First icon header            20 bytes
    First icon data              Varies
    Second icon header           20 bytes
    Second icon data             Varies  
.fi
.PP
سربرگ DiskObject شامل مواردی از قبیل عدد جادویی (0xE310)، پهنا و بلندی شیء (درون سربرگ تعبیه‌شدهٔ Gadget) و نسخه است.
.PP
هر سربرگ آیکون شامل پهنا و بلندی آیکون (که می‌تواند از پهنا و بلندی شیء کوچک‌تر باشد) و تعداد صفحه‌بیت‌ها است.
.PP
داده‌های آیکون ساختار زیر را دارند:

.RS
    
.PP
تعداد \fIBIT-PLANE\fP صفحه، هر کدام با \fIHEIGHT\fP ردیف به طول ۲ * 16 / (\fIWIDTH\fP + 15) بایت.
.RE
.PP
بنابراین اگر آیکونی با ابعاد 9x3x2 داشته باشید، داده‌های آیکون به این شکل خواهند بود:

.nf
    aaaa aaaa a000 0000
    aaaa aaaa a000 0000
    aaaa aaaa a000 0000
    bbbb bbbb b000 0000
    bbbb bbbb b000 0000
    bbbb bbbb b000 0000
.fi
.PP
که در آن \fIa\fP یک بیت برای نخستین صفحه‌بیت، \fIb\fP یک بیت برای دومین صفحه‌بیت، و \fI0\fP پرکننده (padding) است. باز هم با تشکر از Ben Hutchings بابت ارسال بسیار مفیدش!

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBinfotopam\fP در Netpbm 10.22 (آوریل ۲۰۰۴) اضافه شد.

.UN limitations
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
دستور \fBinfotopam\fP در حال حاضر تنها از آیکون‌های ۱ و ۲ صفحه‌بیتی پشتیبانی می‌کند.
.PP
هیچ دستور \fBpamtoinfo\fP وجود ندارد، زیرا فایل‌های info. حاوی اطلاعاتی بسیار فراتر از صرفاً داده‌های آیکون هستند و نگاشت رنگ‌ها نیز دشوار خواهد بود.

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