Pamtowinicon User Manual(1) General Commands Manual نام (NAME) pamtowinicon - تبدیل تصاویر Netpbm PAM به یک فایل آیکون مایکروسافت ویندوز (.ico) خلاصه دستور (SYNOPSIS) pamtowinicon [-pngthreshold=حد_آستانه] [-truetransparent] [-verbose] [فایل_pam] تمام گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه استفاده کنید. همچنین می‌توانید بین نام یک گزینه و مقدار آن از فاصله یا علامت مساوی استفاده نمایید. توضیحات (DESCRIPTION) این برنامه بخشی از Netpbm(1) است. دستور pamtowinicon یک فایل Netpbm PAM از نوع RGB_ALPHA را می‌خواند و آن را به یک فایل آیکون مایکروسافت ویندوز تبدیل می‌کند. خروجی به خروجی استاندارد (Standard Output) ارسال می‌شود. ورودی یک فایل PAM چندتصویری است؛ هر تصویر به یک آیکون در فایل خروجی تبدیل می‌شود. اگر تصاویر ورودی شما در چند فایل جداگانه قرار دارند، می‌توانید به‌سادگی آن‌ها را با دستور cat ترکیب کرده و نتیجه را به pamtowinicon ارسال کنید. گزینه‌ها (OPTIONS) علاوه بر گزینه‌های مشترک بین تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه -quiet، به گزینه‌های مشترک مراجعه کنید)، دستور pamtowinicon گزینه‌های خط فرمان زیر را می‌شناسد: -pngthreshold=حد_آستانه دستور pamtowinicon تصاویری را که وضوح (رزولوشن) آن‌ها بزرگتر یا مساوی حد_آستانه در حد_آستانه باشد، از طریق اجرای pnmtopng(1) به صورت PNG کدگذاری می‌کند. سایر تصاویر را با استفاده از فرمت سنتی‌تر BMP کدگذاری می‌نماید. هنگامی که برنامه از کدگذاری PNG برای یک فایل PAM پنج‌کاناله با ماسک AND مجزا استفاده می‌کند (به زیر مراجعه کنید)، ماسک AND را نادیده می‌گیرد. از آنجا که PNG همواره قابلیت تعیین شفافیت را داشته است، قالب آیکون ویندوز در حالتی که آیکون با فرمت PNG کدگذاری شده باشد، ماسک AND جداگانه‌ای ارائه نمی‌دهد. مقدار پیش‌فرض برای حد_آستانه برابر با ۱۲۸ است. -truetransparent تمام پیکسل‌های خارج از ناحیه مات را سیاه می‌کند تا از معکوس‌سازی رنگ و سایر جلوه‌ها روی پس‌زمینه تصویر جلوگیری شود (به Windows Icons(1) مراجعه کنید). -verbose چاپ پیام‌های بیشتر با جزئیات کامل‌تر. تصاویر (IMAGES) دستور pamtowinicon یک فایل Netpbm PAM (چندتصویری) را به عنوان ورودی می‌خواند و یک فایل آیکون ویندوز منفرد حاوی آن تصاویر را خروجی می‌دهد. تصاویر در فایل آیکون به همان ترتیبی قرار می‌گیرند که در ورودی PAM آمده‌اند. ورودی PAM (PAM Input) دستور pamtowinicon تصاویر PAM را بر اساس تعداد کانال‌ها به صورت زیر تفسیر می‌کند: ──────────────────────────────────────────────────────────── کانال‌ها تصویر 1 تصویر کاملاً مات در مقیاس خاکستری (grayscale) 2 تصویر در مقیاس خاکستری به همراه کانال شفافیت 3 تصویر رنگی کاملاً مات 4 تصویر رنگی به همراه کانال شفافیت 5 تصویر رنگی به همراه کانال شفافیت و ماسک AND اضافی نوع تاپل (tuple type) فایل‌های PAM اهمیتی ندارد. ماسک AND (AND Mask) اصطلاح موسوم به «ماسک AND» یک ویژگی خاص در آیکون‌های مایکروسافت ویندوز است. این ماسک برای تمام تصاویر کدگذاری‌شده با فرمت BMP الزامی است. در نگاه نخست، ماسک AND یک کانال شفافیت ۱ بیتی است، اما برای مواردی مانند سایه‌زدن آیکون هنگام کشیدن (drag) نیز استفاده می‌شود. برای جزئیات به Windows Icons(1) مراجعه کنید. اگر ماسک AND صریحی وجود نداشته باشد اما داده‌های شفافیت در تصویر ورودی موجود باشد، pamtowinicon ماسک AND را در نقاطی که نمونه موجود در کانال شفافیت کمتر از maxval باشد به صورت مات، و در سایر نقاط به صورت شفاف تنظیم می‌کند. اگر هیچ داده شفافیتی در تصویر ورودی وجود نداشته باشد، pamtowinicon کل تصویر را کاملاً مات در نظر می‌گیرد. خروجی BMP (BMP Output) هنگام کدگذاری یک تصویر به فرمت BMP، دستور pamtowinicon تلاش می‌کند تا از فشرده‌ترین فرمت BI_RGB مجاز برای تصاویر آیکون با عمق رنگ هشت بیت در هر کانال استفاده کند. دستور pamtowinicon تصاویر کدگذاری‌شده BMP با فرمت ۱۶ بیتی BI_RGB یا BI_BITFIELDS تولید نمی‌کند، حتی اگر مقدار maxval در فایل PAM ورودی ۲۵۵ نباشد. همچنین ببینید (SEE ALSO) • winicontopam(1) • ppmtowinicon(1) • pam(1) • Windows Icons(1) برای اطلاعات درباره فرمت PNG، به http://schaik.com/png مراجعه کنید. تاریخچه (HISTORY) دستور pamtowinicon در نگارش 10.63 نرم‌افزار Netpbm (ژوئن ۲۰۱۳) معرفی شد. این برنامه با ارائه قابلیت‌های بیشتر و سازگاری بهتر با قراردادهای Netpbm، جایگزین ppmtowinicon گردید. نویسنده (AUTHOR) حق نشر (C) ۲۰۱۳ متعلق به Ludolf Holzheid است. ترجمه به سبک کدنویسی Netpbm توسط Bryan Henderson انجام شده است. منبع سند (DOCUMENT SOURCE) این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارند: http://netpbm.sourceforge.net/doc/pamtowinicon.html netpbm documentation 12 April 2013 Pamtowinicon User Manual(1)