.\" -*- nroff -*- .\" icotool.1 - Manual page for icotool. .\" .\" Copyright (C) 1998 Oskar Liljeblad .\" .\" This program is free software: you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation, either version 3 of the License, or .\" (at your option) any later version. .\" .\" This program is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . .\" .TH ICOTOOL "1" "April 18, 2005" "icotool (icoutils)" .SH "نام (NAME)" icotool \- تبدیل و ساخت فایل‌های آیکون و نشانگر Win32 .SH "خلاصه دستور (SYNOPSIS)" .B icotool .RI [ OPTION ]... " " [ FILE ]... .SH "توضیحات (DESCRIPTION)" این صفحهٔ راهنما دستور \fBicotool\fP را شرح می‌دهد. برنامهٔ \fBicotool\fP فایل‌های آیکون (.ico) و نشانگر (.cur) را تبدیل کرده و می‌سازد. در حال حاضر آیکون‌ها تنها می‌توانند از فایل‌های PNG ساخته شده و به آن‌ها استخراج شوند. این کار با استفاده از libpng انجام می‌شود. فایل‌های آیکون و نشانگر عمدتاً در بستر Microsoft Windows(R) استفاده می‌شوند. هر فایل آیکون یا نشانگر ممکن است شامل چندین تصویر با وضوح‌های گوناگون و تعداد رنگ‌های مختلف باشد. تفاوت فایل‌های نشانگر با فایل‌های آیکون در این است که حاوی اطلاعات نقطهٔ حساس (hotspot) هر تصویر نیز هستند. نسخه‌های جدید Internet Explorer متعلق به Microsoft از آیکون‌ها برای نشان‌واره‌های کوچک وبگاه‌ها استفاده می‌کنند. مرورگر فایلی به نام favicon.ico را از یک وبگاه دریافت کرده و از تصاویر درون آن برای نمایش وبگاه در منوها و فهرست‌های وبگاه‌ها استفاده می‌کند. (این فایل همانند هر فایل دیگری در دایرکتوری ریشهٔ وبگاه قرار می‌گیرد.) مرورگرهایی نظیر Galeon از این رفتار الگوبرداری کرده و اکنون آن‌ها نیز فایل‌های .ico را دریافت کرده و از آن‌ها برای نشان‌واره‌های وبگاه‌ها استفاده می‌کنند. از آنجا که هر فایل آیکون یا نشانگر ممکن است حاوی چندین تصویر با ابعاد و عمق‌های مختلف باشد، یک تبدیل ممکن است به ایجاد چندین فایل PNG منجر شود. به همین ترتیب، هنگام ساخت یک فایل آیکون/نشانگر می‌توان چندین فایل PNG را مشخص کرد. .SH "گزینه‌ها (OPTIONS)" این برنامه‌ها از ساختار نحوی معمول خط فرمان گنو پیروی می‌کنند، به طوری که گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند. .TP .B \-x, \-\-extract این گزینه به icotool اعلام می‌کند که تصاویر از تمام فایل‌های آیکون/نشانگر مشخص‌شده در خط فرمان استخراج شوند. از گزینه‌های پالایه (پایین‌تر را ببینید) می‌توان برای کنترل این‌که چه تصاویری استخراج شوند استفاده کرد. .TP .B \-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 .TP .B \-c, \-\-create این گزینه به icotool اعلام می‌کند که با استفاده از تمام فایل‌های PNG مشخص‌شده در خط فرمان، و به ترتیبی که تعیین شده‌اند، یک فایل آیکون/نشانگر بسازد. تعداد بیت بر پیکسل استفاده‌شده در فایل آیکون/نشانگر به تعداد رنگ‌های استفاده‌شده در فایل PNG بستگی خواهد داشت. (اگر تصویر PNG دارای یک پالت نمایه‌دار باشد، الزاماً به این معنا نیست که از همان پالت در فایل آیکون/نشانگر ساخته‌شده استفاده خواهد شد.) .TP .B \-i, \-\-index=\fIN\fR هنگام فهرست کردن یا استخراج فایل‌ها، این گزینه به icotool اعلام می‌کند که تنها Nامین تصویر در هر فایل را فهرست یا استخراج کند. نخستین تصویر دارای اندیس ۱ است. این گزینه در حالت ساخت هیچ تأثیری ندارد. .TP .B \-w, \-\-width=\fIPIXELS\fR مشابه با \-\-index است، اما به جای آن امکان تطبیق بر اساس پهنای تصویر را فراهم می‌کند. این گزینه در حالت ساخت هیچ تأثیری ندارد. .TP .B \-h, \-\-height=\fIPIXELS\fR مشابه با \-\-index است، اما به جای آن امکان تطبیق بر اساس بلندی تصویر را فراهم می‌کند. این گزینه در حالت ساخت هیچ تأثیری ندارد. .TP .B \-b, \-\-bit-depth=\fICOUNT\fR مشابه با \-\-index است، اما به جای آن امکان تطبیق بر اساس تعداد بیت بر پیکسل تصویر را فراهم می‌کند. مقادیر معتبر عبارتند از ۱، ۲، ۴، ۸، ۱۶، ۲۴ و ۳۲. در حالت ساخت، این گزینه به شما امکان می‌دهد حداقل عمق بیت را برای تصاویر موجود در فایل آیکون مشخص کنید. اگر گزینه را یک‌بار ارائه دهید، برای تمام فایل‌های ورودی اعمال خواهد شد. اگر آن را چندین بار تعیین کنید، برای تمام فایل‌های ورودی پس از آن گزینهٔ خاص اعمال می‌شود؛ در این حالت باید برای تمام تصاویر یک عمق بیت مشخص کنید. .\".B \-m, \-\-min-bit-depth=\fICOUNT\fR .\"This option allows the number of bits per pixel in the image to be matched instead .\"(minimally). .\"See --bit-depth for details. .\" .\"In create mode, this option will allow you to specify a minimum bit depth .\"for images in the icon file. .\".TP .TP .B \-p, \-\-palette-size=\fIPIXELS\fR مشابه با \-\-index است، اما به جای آن امکان تطبیق بر اساس تعداد رنگ‌های پالت تصویر را فراهم می‌کند. تصاویر ۲۴ یا ۳۲ بیتی در فایل‌های آیکون/نشانگر پالت ندارند و بنابراین اندازهٔ پالت آن‌ها برابر با ۰ خواهد بود. این گزینه در حالت ساخت هیچ تأثیری ندارد. .TP .B \-X, \-\-hotspot-x=\fICOORD\fR مشابه با \-\-index است، اما به جای آن امکان تطبیق مختصات x نقطهٔ حساس را فراهم می‌کند. این گزینه تنها روی فایل‌های نشانگر اثر دارد. در حالت ساخت، می‌توان از این گزینه برای مشخص کردن مختصات x نقطهٔ حساس استفاده کرد. اگر گزینه را یک‌بار ارائه دهید، برای تمام فایل‌های ورودی اعمال خواهد شد. اگر آن را چندین بار مشخص کنید، برای تمام فایل‌های ورودی پس از آن گزینهٔ خاص اعمال می‌شود؛ در این حالت باید برای تمام تصاویر مختصات نقطهٔ حساس را تعیین کنید. .TP .B \-Y, \-\-hotspot-y=\fICOORD\fR مشابه با \-\-index است، اما به جای آن امکان تطبیق مختصات y نقطهٔ حساس را فراهم می‌کند. این گزینه تنها روی فایل‌های نشانگر اثر دارد. در حالت ساخت، می‌توان از این گزینه برای مشخص کردن مختصات y نقطهٔ حساس استفاده کرد. اگر گزینه را یک‌بار ارائه دهید، برای تمام فایل‌های ورودی اعمال خواهد شد. اگر آن را چندین بار مشخص کنید، برای تمام فایل‌های ورودی پس از آن گزینهٔ خاص اعمال می‌شود؛ در این حالت باید برای تمام تصاویر مختصات نقطهٔ حساس را تعیین کنید. .TP .B \-\-icon این گزینه مشخص می‌کند که فقط فایل‌های آیکون فهرست یا استخراج شوند. در حالت ساخت، می‌توان از این گزینه استفاده کرد تا مشخص شود یک آیکون (به‌جای نشانگر) باید ساخته شود. (این مقدار در حالت ساخت پیش‌فرض است.) .TP .B \-\-cursor این گزینه مشخص می‌کند که فقط فایل‌های نشانگر فهرست یا استخراج شوند. در حالت ساخت، می‌توان از این گزینه استفاده کرد تا مشخص شود یک نشانگر (به‌جای آیکون) باید ساخته شود. .TP .B \-t, \-\-alpha\-threshold=\fILEVEL\fR حداکثر سطح آلفا (شفافیت) را در تصویر PNG برای بخش‌هایی که باید در آیکونِ ساخته‌شده شفاف شوند، مشخص می‌کند. مقدار پیش‌فرض ۱۲۷ است. این گزینه تنها هنگام ساخت فایل‌های آیکون به کار می‌رود. .TP .B \-o, \-\-output=\fIPATH\fR در حالت استخراج، این گزینه دایرکتوری‌ای را مشخص می‌کند که فایل‌های استخراج‌شده باید در آن ساخته شوند. اگر PATH وجود نداشته باشد، چنین فرض می‌شود که به یک فایل ناموجود اشاره دارد. نخستین تصویر منطبق، در فایلی با همان نام استخراج خواهد شد. در حالت ساخت، این گزینه نام فایل خروجی را مشخص می‌کند. حالت پیش‌فرض، نوشتن داده‌های دودویی در خروجی استاندارد است (که اگر خروجی استاندارد پایانه باشد، icotool از انجام آن خودداری می‌کند). اگر PATH مقدار `-' باشد، تمام خروجی در خروجی استاندارد چاپ خواهد شد. این گزینه در حالت فهرست کردن هیچ تأثیری ندارد. .TP .B \-r, \-\-raw=FILENAME ذخیرهٔ فایل ورودی به صورت PNG خام (آیکون‌های Vista). .TP .B \-\-help نمایش خلاصه‌ای از گزینه‌ها. .TP .B \-\-version نمایش اطلاعات نسخه و خروج. .SH "مثال‌ها (EXAMPLES)" فهرست کردن تمام تصاویر در فایل `demo.ico': .br $ \fBicotool \-l demo.ico\fP \-\-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 .PP فهرست کردن تنها تصاویر ۱۶‌رنگ در `demo.ico': .br $ \fBicotool \-l \-\-palette-size=16 demo.ico\fP \-\-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 .PP استخراج تمام تصاویر به دایرکتوری جاری و نام‌گذاری فایل‌های مقصد به صورت `demo.ico_I_WxHxD.xpm': .br $ \fBicotool \-x \-o . demo.ico\fP $ \fBls *.png\fP demo_1_16x16x4.png demo_3_48x48x4.png demo_5_32x32x8.png demo_2_32x32x4.png demo_4_16x16x8.png demo_6_48x48x8.png .PP استخراج تمام تصاویر آیکون ۲۵۶ رنگ در تمام فایل‌های .ico در دایرکتوری جاری و قرار دادن تصاویر استخراج‌شده در `img/': .br $ \fBicotool \-x \-o img/ \-p 256 *.ico\fP .PP ساخت یک آیکون با نام `favicon.ico' با دو تصویر: .br $ \fBicotool \-c \-o favicon.ico mysite_32x32.png mysite_64x64.png\fP .SH "نویسندگان (AUTHORS)" مجموعهٔ \fBicoutils\fP توسط Oskar Liljeblad <\fIoskar@osk.mine.nu\fP> نوشته شده است. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" حق نشر \(co 1998 متعلق به Oskar Liljeblad این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر به کد منبع مراجعه کنید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص. .SH "علامت‌های تجاری (TRADEMARKS)" ویندوز (Windows) یک علامت تجاری ثبت‌شده متعلق به Microsoft Corporation در ایالات متحده و سایر کشورها است.