Ppmtowinicon User Manual(0) Ppmtowinicon User Manual(0)

ppmtowinicon - تبدیل تصویر PPM به یک فایل .ico ویندوز

ppmtowinicon

[-andpgms]

[-output=output.ico]

[ppmfile [andfile] ...]

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

این برنامه اساساً منسوخ شده است؛ برنامه جدیدتر pamtowinicon عملکرد بهتری دارد.

دستور ppmtowinicon یک یا چند تصویر PPM را به عنوان ورودی خوانده و یک فایل .ico مایکروسافت ویندوز را به عنوان خروجی تولید می‌کند.

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

مایکروسافت توصیه می‌کند که دست‌کم قالب‌های زیر در هر آیکون گنجانده شوند:

  • 16 x 16 - 4 bpp
  • 32 x 32 - 4 bpp
  • 48 x 48 - 8 bpp

اگر هیچ فایل ورودی را مشخص نکنید، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود.

خروجی به خروجی استاندارد (Standard Output) ارسال می‌شود، مگر اینکه گزینه -output را مشخص کنید.

اگر گزینه -andmask را مشخص کنید، آیکون‌های (تا حدی) شفاف دریافت خواهید کرد. در این حالت، آرگومان‌های شما جفت‌هایی از نام فایل‌ها خواهند بود، که فایل نخست تصویر اصلی و فایل دوم یک ماسک شفافیت استاندارد PGM در Netpbm است (به pgm format specification(1) مراجعه کنید).

در یک فایل .ico، چیزی به نام شفافیت جزئی یا نیمه‌شفافی (translucency) وجود ندارد. هر جا که ماسک PGM کاملاً کدر (opaque) باشد، آیکون کدر خواهد بود. در هر جای دیگر، آیکون شفاف خواهد بود. توجه داشته باشید که مانند هر برنامه Netpbm، می‌توانید از یک تصویر PBM نیز برای ماسک شفافیت استفاده کنید و ppmtowinicon با آن مانند یک PGM رفتار خواهد کرد.

ماسک AND شبیه به یک ماسک شفافیت است، با این تفاوت که در نواحی «غیرکدر» معنای متفاوتی دارد. در حالت معمول، تصویر پیش‌زمینه در آن نواحی سیاه است و در نتیجه آن نواحی کاملاً شفاف می‌شوند -- یعنی پس‌زمینه از میان آیکون نمایان می‌شود. اما به طور کلی، یک پیکسل غیرکدر بیانگر این است که پس‌زمینه و پیش‌زمینه باید به این ترتیب با یکدیگر ادغام شوند: شدت مؤلفه‌های رنگ در پیش‌زمینه و پس‌زمینه به صورت اعداد دودویی نمایش داده می‌شوند، سپس بیت‌های متناظر شدت‌های پس‌زمینه و پیش‌زمینه با یکدیگر XOR (یا exclusive-or) می‌شوند. بنابراین نوعی جلوه تصویر معکوس (reverse video) ایجاد می‌شود.

اگر این جلوه خاص را نمی‌خواهید و در عوض خواهان شفافیت مستقیم و ساده هستید، از گزینه -truetransparent استفاده کنید. این گزینه باعث می‌شود ppmtowinicon تصویر پایه را در هر جایی که ماسک شفافیت مشخص کرده، صرف‌نظر از رنگ تصویر ورودی در آن نقطه، کاملاً سیاه کند.

اگر -andmask را مشخص نکنید، ppmtowinicon ماسک‌های AND کاملاً کدر را در فایل .ico قرار می‌دهد.

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

اطلاعات شفافیت را در آیکون‌ها می‌گنجاند. به بخش شفافیت مراجعه کنید.
نام فایل خروجی. به طور پیش‌فرض، ppmtowinicon آیکون را در خروجی استاندارد می‌نویسد.
شفافیت در آیکون را به جای جلوه ویژه تصویر معکوس، به صورت عادی درمی‌آورد. به بخش شفافیت مراجعه کنید.

pamtowinicon(1)، winicontoppm(1)، ppm(1)، pgm(1)

حق نشر (C) ۲۰۰۰ متعلق به Lee Benfield است.

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

http://netpbm.sourceforge.net/doc/ppmtowinicon.html
01 May 2004 netpbm documentation