نام (NAME)

infotopam - تبدیل آیکون‌های info. در Amiga به PAM

خلاصه دستور (SYNOPSIS)

infotopam [-forcecolor] [-numcolors numcolors] [-selected] [-verbose] [index color ...] [filename]

کوتاه‌ترین اختصار یکتای هر گزینه پذیرفته می‌شود. می‌توانید به جای یک خط پیوند، از دو خط پیوند برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسهٔ فاصله برای جدا کردن نام یک گزینه از مقدار آن استفاده کنید.

مثال‌ها (EXAMPLES)

  
    $ infotopam amiga.info > amiga.first.pam

از گزینهٔ -selected برای تبدیل نسخهٔ «انتخاب‌شده» آیکون به جای نسخهٔ معمولی آن استفاده کنید. در این حالت، infotopam از ورودی استاندارد می‌خواند:

  
    infotopam -selected < amiga.info > amiga.second.pam

از -numcolors برای تغییر دادن رنگ‌ها استفاده کنید.

  
    infotopam -numcolors 2 0 green 3 rgb:FF/00/00 icon.info > icon.pam

از آنجا که نمایشگرهای Amiga از پیکسل‌های مربعی استفاده نمی‌کنند، ممکن است برخی آیکون‌ها فشرده یا لهیده به نظر برسند. پالودن خروجی از طریق pamscale می‌تواند این مشکل را برطرف کند:

  
    $ infotopam squish.info | pamtopnm | pamscale -yscale 1.7 > normal.pnm

توضیحات (DESCRIPTION)

این برنامه بخشی از Netpbm(1) است.

دستور infotopam یک تصویر info. (آیکون) Amiga را به یک تصویر PAM تبدیل می‌کند. infotopam فایل info. را از filename، یا در صورت مشخص نکردن نام فایل از ورودی استاندارد می‌خواند و تصویر تبدیل‌شدهٔ PAM را در خروجی استاندارد می‌نویسد.

دستور infotopam از آیکون‌های ۱ و ۲ صفحه‌بیتی (bit-plane) پشتیبانی می‌کند. اگر آیکون info. تنها ۱ صفحه‌بیت داشته باشد، infotopam یک تصویر PAM سیاه‌وسفید تولید می‌کند؛ در غیر این صورت یک تصویر PAM رنگی تولید خواهد کرد. در حالت اخیر، می‌توانید رنگ‌ها را سفارشی‌سازی کنید یا رنگ‌های استاندارد و اصلی Amiga را حفظ نمایید. همچنین می‌توانید با گزینهٔ -forcecolor، دستور infotopam را وادار کنید تا برای ورودی‌های ۱ صفحه‌بیتی نیز PAM رنگی تولید کند.

گزینه‌ها (OPTIONS)

علاوه بر گزینه‌های مشترک در تمامی برنامه‌های مبتنی بر libnetpbm (به‌ویژه -quiet، به
گزینه‌های مشترک مراجعه کنید)، infotopam گزینه‌های خط فرمان زیر را می‌شناسد:

-numcolors numcolors

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

0

آبی (00, 55, AA)

1

سفید (FF, FF, FF)

2

سیاه (00, 00, 20)

3

نارنجی (FF, 8A, 00)

برای مشخص کردن تغییرات، تعداد رنگ‌هایی را که قصد جایگزینی آن‌ها را دارید به عنوان آرگومان -numcolors مشخص کنید و برای هر رنگ، یک جفت آرگومان خط فرمان بیاورید؛ آرگومان نخست نمایهٔ رنگ از ۰ تا ۳ و دومی رنگ جایگزین خواهد بود. رنگ (color) را همان‌طور که برای

آرگومان تابع کتابخانه‌ای pnm_parsecolor() شرح داده شده است، تعیین نمایید.

این آرگومان‌ها قبل از آرگومان نام فایل ورودی (در صورت وجود) قرار می‌گیرند. این یک نحو نامعمول برای برنامه‌های Netpbm است.

-selected

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

-forcecolor

این گزینه باعث می‌شود infotopam آیکون‌های ۱ صفحه‌بیتی را به جای تصاویر سیاه‌وسفید، به تصاویر PAM رنگی تبدیل کند. رنگ‌ها شامل رنگ نمایهٔ ۲ برای سیاه و رنگ نمایهٔ ۱ برای سفید خواهند بود.

-verbose

این گزینه باعث می‌شود infotopam پیام‌های اطلاع‌رسانی دربارهٔ فرایند تبدیل صادر کند.

این گزینه در Netpbm 11.06 (مارس ۲۰۲۴) اضافه شد.

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

همچنین ببینید (SEE ALSO)

pam(1) pamtopnm(1) pamscale(1)

نکات (NOTES)

با تشکر از افراد زیر در comp.sys.amiga.programmer بابت راهنمایی‌ها و نکاتشان در رابطه با رمزگشایی ساختار فایل info.:

Ben Hutchings
Thomas Richter
Kjetil Svalastog Matheussen
Anders Melchiorsen
Dirk Stoecker
Ronald V.D.

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

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

سربرگ DiskObject شامل مواردی از قبیل عدد جادویی (0xE310)، پهنا و بلندی شیء (درون سربرگ تعبیه‌شدهٔ Gadget) و نسخه است.

هر سربرگ آیکون شامل پهنا و بلندی آیکون (که می‌تواند از پهنا و بلندی شیء کوچک‌تر باشد) و تعداد صفحه‌بیت‌ها است.

داده‌های آیکون ساختار زیر را دارند:

تعداد BIT-PLANE صفحه، هر کدام با HEIGHT ردیف به طول ۲ * 16 / (WIDTH + 15) بایت.

بنابراین اگر آیکونی با ابعاد 9x3x2 داشته باشید، داده‌های آیکون به این شکل خواهند بود:

aaaa aaaa a000 0000
aaaa aaaa a000 0000
aaaa aaaa a000 0000
bbbb bbbb b000 0000
bbbb bbbb b000 0000
bbbb bbbb b000 0000

که در آن a یک بیت برای نخستین صفحه‌بیت، b یک بیت برای دومین صفحه‌بیت، و 0 پرکننده (padding) است. باز هم با تشکر از Ben Hutchings بابت ارسال بسیار مفیدش!

تاریخچه (HISTORY)

دستور infotopam در Netpbm 10.22 (آوریل ۲۰۰۴) اضافه شد.

محدودیت‌ها (LIMITATIONS)

دستور infotopam در حال حاضر تنها از آیکون‌های ۱ و ۲ صفحه‌بیتی پشتیبانی می‌کند.

هیچ دستور pamtoinfo وجود ندارد، زیرا فایل‌های info. حاوی اطلاعاتی بسیار فراتر از صرفاً داده‌های آیکون هستند و نگاشت رنگ‌ها نیز دشوار خواهد بود.

نویسنده (AUTHOR)

حق نشر (C) ۲۰۰۰، ۲۰۰۴ متعلق به Richard Griswold است.

منبع سند (DOCUMENT SOURCE)

این صفحه راهنما توسط ابزار Netpbm موسوم به 'makeman' بر اساس منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:

: http://netpbm.sourceforge.net/doc/infotopam.html