نام (NAME)

icotool - تبدیل و ساخت فایل‌های آیکون و نشانگر Win32

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

icotool [OPTION]... [FILE]...

توضیحات (DESCRIPTION)

این صفحهٔ راهنما دستور icotool را شرح می‌دهد.

برنامهٔ icotool فایل‌های آیکون (.ico) و نشانگر (.cur) را تبدیل کرده و می‌سازد. در حال حاضر آیکون‌ها تنها می‌توانند از فایل‌های PNG ساخته شده و به آن‌ها استخراج شوند. این کار با استفاده از libpng انجام می‌شود.

فایل‌های آیکون و نشانگر عمدتاً در بستر Microsoft Windows(R) استفاده می‌شوند. هر فایل آیکون یا نشانگر ممکن است شامل چندین تصویر با وضوح‌های گوناگون و تعداد رنگ‌های مختلف باشد. تفاوت فایل‌های نشانگر با فایل‌های آیکون در این است که حاوی اطلاعات نقطهٔ حساس (hotspot) هر تصویر نیز هستند.

نسخه‌های جدید Internet Explorer متعلق به Microsoft از آیکون‌ها برای نشان‌واره‌های کوچک وبگاه‌ها استفاده می‌کنند. مرورگر فایلی به نام favicon.ico را از یک وبگاه دریافت کرده و از تصاویر درون آن برای نمایش وبگاه در منوها و فهرست‌های وبگاه‌ها استفاده می‌کند. (این فایل همانند هر فایل دیگری در دایرکتوری ریشهٔ وبگاه قرار می‌گیرد.) مرورگرهایی نظیر Galeon از این رفتار الگوبرداری کرده و اکنون آن‌ها نیز فایل‌های .ico را دریافت کرده و از آن‌ها برای نشان‌واره‌های وبگاه‌ها استفاده می‌کنند.

از آنجا که هر فایل آیکون یا نشانگر ممکن است حاوی چندین تصویر با ابعاد و عمق‌های مختلف باشد، یک تبدیل ممکن است به ایجاد چندین فایل PNG منجر شود. به همین ترتیب، هنگام ساخت یک فایل آیکون/نشانگر می‌توان چندین فایل PNG را مشخص کرد.

گزینه‌ها (OPTIONS)

این برنامه‌ها از ساختار نحوی معمول خط فرمان گنو پیروی می‌کنند، به طوری که گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند.

-x, --extract

این گزینه به icotool اعلام می‌کند که تصاویر از تمام فایل‌های آیکون/نشانگر مشخص‌شده در خط فرمان استخراج شوند. از گزینه‌های پالایه (پایین‌تر را ببینید) می‌توان برای کنترل این‌که چه تصاویری استخراج شوند استفاده کرد.

-l, --list

این گزینه به icotool اعلام می‌کند که تصاویر موجود در تمام فایل‌های آیکون/نشانگر مشخص‌شده فهرست شوند. خروجی چیزی شبیه به این خواهد بود:

--icon --index=1 --width=16 --height=16 --bit-depth=4 --palette-size=16
--icon --index=2 --width=32 --height=32 --bit-depth=8 --palette-size=256

-c, --create

این گزینه به icotool اعلام می‌کند که با استفاده از تمام فایل‌های PNG مشخص‌شده در خط فرمان، و به ترتیبی که تعیین شده‌اند، یک فایل آیکون/نشانگر بسازد. تعداد بیت بر پیکسل استفاده‌شده در فایل آیکون/نشانگر به تعداد رنگ‌های استفاده‌شده در فایل PNG بستگی خواهد داشت. (اگر تصویر PNG دارای یک پالت نمایه‌دار باشد، الزاماً به این معنا نیست که از همان پالت در فایل آیکون/نشانگر ساخته‌شده استفاده خواهد شد.)

-i, --index=N

هنگام فهرست کردن یا استخراج فایل‌ها، این گزینه به icotool اعلام می‌کند که تنها Nامین تصویر در هر فایل را فهرست یا استخراج کند. نخستین تصویر دارای اندیس ۱ است.

این گزینه در حالت ساخت هیچ تأثیری ندارد.

-w, --width=PIXELS

مشابه با --index است، اما به جای آن امکان تطبیق بر اساس پهنای تصویر را فراهم می‌کند. این گزینه در حالت ساخت هیچ تأثیری ندارد.

-h, --height=PIXELS

مشابه با --index است، اما به جای آن امکان تطبیق بر اساس بلندی تصویر را فراهم می‌کند. این گزینه در حالت ساخت هیچ تأثیری ندارد.

-b, --bit-depth=COUNT

مشابه با --index است، اما به جای آن امکان تطبیق بر اساس تعداد بیت بر پیکسل تصویر را فراهم می‌کند. مقادیر معتبر عبارتند از ۱، ۲، ۴، ۸، ۱۶، ۲۴ و ۳۲.

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

-p, --palette-size=PIXELS

مشابه با --index است، اما به جای آن امکان تطبیق بر اساس تعداد رنگ‌های پالت تصویر را فراهم می‌کند. تصاویر ۲۴ یا ۳۲ بیتی در فایل‌های آیکون/نشانگر پالت ندارند و بنابراین اندازهٔ پالت آن‌ها برابر با ۰ خواهد بود.

این گزینه در حالت ساخت هیچ تأثیری ندارد.

-X, --hotspot-x=COORD

مشابه با --index است، اما به جای آن امکان تطبیق مختصات x نقطهٔ حساس را فراهم می‌کند. این گزینه تنها روی فایل‌های نشانگر اثر دارد.

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

-Y, --hotspot-y=COORD

مشابه با --index است، اما به جای آن امکان تطبیق مختصات y نقطهٔ حساس را فراهم می‌کند. این گزینه تنها روی فایل‌های نشانگر اثر دارد.

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

--icon

این گزینه مشخص می‌کند که فقط فایل‌های آیکون فهرست یا استخراج شوند. در حالت ساخت، می‌توان از این گزینه استفاده کرد تا مشخص شود یک آیکون (به‌جای نشانگر) باید ساخته شود. (این مقدار در حالت ساخت پیش‌فرض است.)

--cursor

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

-t, --alpha-threshold=LEVEL

حداکثر سطح آلفا (شفافیت) را در تصویر PNG برای بخش‌هایی که باید در آیکونِ ساخته‌شده شفاف شوند، مشخص می‌کند. مقدار پیش‌فرض ۱۲۷ است. این گزینه تنها هنگام ساخت فایل‌های آیکون به کار می‌رود.

-o, --output=PATH

در حالت استخراج، این گزینه دایرکتوری‌ای را مشخص می‌کند که فایل‌های استخراج‌شده باید در آن ساخته شوند. اگر PATH وجود نداشته باشد، چنین فرض می‌شود که به یک فایل ناموجود اشاره دارد. نخستین تصویر منطبق، در فایلی با همان نام استخراج خواهد شد.

در حالت ساخت، این گزینه نام فایل خروجی را مشخص می‌کند. حالت پیش‌فرض، نوشتن داده‌های دودویی در خروجی استاندارد است (که اگر خروجی استاندارد پایانه باشد، icotool از انجام آن خودداری می‌کند).

اگر PATH مقدار `-' باشد، تمام خروجی در خروجی استاندارد چاپ خواهد شد.

این گزینه در حالت فهرست کردن هیچ تأثیری ندارد.

-r, --raw=FILENAME

ذخیرهٔ فایل ورودی به صورت PNG خام (آیکون‌های Vista).

--help

نمایش خلاصه‌ای از گزینه‌ها.

--version

نمایش اطلاعات نسخه و خروج.

مثال‌ها (EXAMPLES)

فهرست کردن تمام تصاویر در فایل `demo.ico':
$ icotool -l demo.ico
--icon --index=1 --width=16 --height=16 --bit-depth=4 --palette-size=16
--icon --index=2 --width=32 --height=32 --bit-depth=4 --palette-size=16
--icon --index=3 --width=48 --height=48 --bit-depth=4 --palette-size=16
--icon --index=4 --width=16 --height=16 --bit-depth=8 --palette-size=256
--icon --index=5 --width=32 --height=32 --bit-depth=8 --palette-size=256
--icon --index=6 --width=48 --height=48 --bit-depth=8 --palette-size=256

فهرست کردن تنها تصاویر ۱۶‌رنگ در `demo.ico':
$ icotool -l --palette-size=16 demo.ico
--icon --index=1 --width=16 --height=16 --bit-depth=4 --palette-size=16
--icon --index=2 --width=32 --height=32 --bit-depth=4 --palette-size=16
--icon --index=3 --width=48 --height=48 --bit-depth=4 --palette-size=16

استخراج تمام تصاویر به دایرکتوری جاری و نام‌گذاری فایل‌های مقصد به صورت `demo.ico_I_WxHxD.xpm':
$ icotool -x -o . demo.ico
$ ls *.png
demo_1_16x16x4.png demo_3_48x48x4.png demo_5_32x32x8.png
demo_2_32x32x4.png demo_4_16x16x8.png demo_6_48x48x8.png

استخراج تمام تصاویر آیکون ۲۵۶ رنگ در تمام فایل‌های .ico در دایرکتوری جاری و قرار دادن تصاویر استخراج‌شده در `img/':
$ icotool -x -o img/ -p 256 *.ico

ساخت یک آیکون با نام `favicon.ico' با دو تصویر:
$ icotool -c -o favicon.ico mysite_32x32.png mysite_64x64.png

نویسندگان (AUTHORS)

مجموعهٔ icoutils توسط Oskar Liljeblad <oskar@osk.mine.nu> نوشته شده است.

کپی‌رایت و تکثیر (COPYRIGHT)

حق نشر © 1998 متعلق به Oskar Liljeblad

این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر به کد منبع مراجعه کنید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

علامت‌های تجاری (TRADEMARKS)

ویندوز (Windows) یک علامت تجاری ثبت‌شده متعلق به Microsoft Corporation در ایالات متحده و سایر کشورها است.