Ppmtoxpm User Manual(0) Ppmtoxpm User Manual(0)

ppmtoxpm - تبدیل یک تصویر PPM به یک پیکس‌مپ (pixmap) در X11

ppmtoxpm [-name=xpmname] [-hexonly] [-rgb=rgb-textfile] [-alphamask=pgmfile] [ppmfile]

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

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

برنامه ppmtoxpm یک تصویر PPM را به عنوان ورودی خوانده و یک پیکس‌مپ X11 (نسخه ۳) به عنوان خروجی تولید می‌کند. این قالب توسط کتابخانه XPM قابل بارگذاری است.

در خروجی XPM، رنگ‌ها ممکن است با نام‌هایی مانند «Red» یا در قالب شانزده‌شانزدهی (هگزادسیمال)، به عنوان مثال «#FF0000» مشخص شوند. در قالب هگزادسیمال، برای هر یک از مؤلفه‌های RGB می‌تواند بین ۱ تا ۴ رقم هگزادسیمال وجود داشته باشد.

به‌طور پیش‌فرض، برنامه ppmtoxpm تلاش می‌کند تا نام هر رنگ موجود در تصویر را در فرهنگ رنگ سیستم پیدا کند و در صورت یافتن، از آن استفاده نماید. در غیر این صورت، از مقدار هگزادسیمال استفاده می‌کند. با استفاده از گزینه -hexonly می‌توانید ppmtoxpm را ملزم کنید که فقط از مقادیر هگزادسیمال استفاده کند. همچنین با استفاده از گزینه -rgb می‌توانید فرهنگ رنگ متفاوتی را مشخص کنید.

هنگامی که ppmtoxpm از قالب هگزادسیمال برای شناسایی یک رنگ استفاده می‌کند، از کمترین تعداد ارقام هگزادسیمال مورد نیاز برای نمایش مقدار maxval در تصویر PPM ورودی استفاده می‌نماید. برای نمونه، اگر maxval در PPM ورودی ۱۰۰ باشد، ppmtoxpm برای هر مؤلفه از ۲ رقم استفاده می‌کند، مانند «#FF0000».

برخی از برنامه‌ها شناسه‌های رنگ هگزادسیمال با یک رقم برای هر مؤلفه را به درستی پردازش نمی‌کنند و رنگ‌ها را نادرست نشان می‌دهند. برای تولید یک فایل XPM که چنین برنامه‌هایی بتوانند آن را پردازش کنند، مطمئن شوید که maxval تصویر PPM ورودی بزرگ‌تر از ۱۵ است؛ برای نمونه از طریق عبور دادن آن از دستور pamdepth 255.

در قالب XPM، یک پالت («نگاشت رنگ» یا color map) وجود دارد که هر رنگ تصویر را به توالی یکتایی از نویسه‌های قابل چاپ تحت عنوان کد رنگ اختصاص می‌دهد، و یک رستر (raster) که رنگ هر پیکسل تصویر را با یکی از آن کدهای رنگ مشخص می‌کند. طول کد رنگ بر اندازه جریان تصویر تأثیر می‌گذارد.

تمام کدهای رنگ در یک تصویر هم‌طول هستند و ppmtoxpm تلاش می‌کند آن را تا حد امکان کوتاه نگه دارد. این طول مشخصاً بر اساس تعداد رنگ‌های موجود در تصویر تعیین می‌شود. برنامه ppmtoxpm رنگ‌های تصویر را به جز رنگ‌هایی که به دلیل ماسک شفافیت در خروجی شفاف خواهند بود شمارش می‌کند و طول کد رنگ را بر این اساس انتخاب می‌نماید. ۹۲ نویسه قابل چاپ وجود دارد که می‌توان در یک کد رنگ استفاده کرد. بنابراین اگر ۹۲ رنگ یا کمتر داشته باشید، کدهای رنگ شما یک‌نویسه‌ای خواهند بود. اگر بیش از ۹۲ ولی حداکثر ۹۲ * ۹۲ رنگ داشته باشید، کدهای رنگ دو‌نویسه‌ای خواهند بود و به همین ترتیب.

یک استثنا برای موارد بالا وجود دارد: اگر یک ماسک شفافیت (گزینه -alpha) مشخص کنید، یک کد رنگ منحصر‌به‌فرد نمایانگر «شفاف» خواهد بود. این امر حتی در صورتی که ماسک شفافیت در عمل هیچ پیکسل شفافی تولید نکند نیز صادق است. بنابراین در صورت استفاده از -alpha، یک واحد از تعداد رنگ‌های ممکن کم کنید.

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

این گزینه رشته پیشوند مشخص‌شده در خروجی XPM را تعیین می‌کند. اگر از گزینه -name استفاده نکنید، ppmtoxpm به‌طور پیش‌فرض از نام فایل (بدون پسوند) پارامتر ppmfile استفاده می‌کند. اگر -name یا ppmfile را مشخص نکنید (یعنی ورودی از ورودی استاندارد باشد)، رشته پیشوند به صورت پیش‌فرض noname خواهد بود.
این گزینه مشخص می‌کند که هرگز نام رنگ‌ها در فایل XPM قرار نگیرد، بلکه رنگ‌ها با رشته‌های هگزادسیمال که صریحاً شدت مؤلفه‌های RGB را تعیین می‌کنند، مشخص شوند. این بدان معناست که خواننده فایل برای تفسیر آن نیازی به دسترسی به فرهنگ رنگ مناسب ندارد.

این گزینه در Netpbm 10.15 (آوریل ۲۰۰۳) معرفی شد. پیش از آن، این رفتار پیش‌فرض بود و با تعیین -rgb لغو می‌شد.

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

هنگامی که -hexonly را تعیین کنید، این گزینه بی‌معنی است.

پیش از Netpbm 10.15 (آوریل ۲۰۰۳)، ppmtoxpm به طور پیش‌فرض از فرهنگ رنگ سیستم استفاده نمی‌کرد. اگر -rgb را مشخص نمی‌کردید، ppmtoxpm فقط از مشخص‌کننده‌های رنگ هگزادسیمال استفاده می‌کرد.

این گزینه یک فایل PGM را نام می‌برد تا به عنوان ماسک شفافیت (آلفا) استفاده شود. فایل باید حاوی تصویری با ابعاد یکسان با تصویر ورودی باشد. برنامه ppmtoxpm هر پیکسلی را که موقعیت آن در تصویر ماسک شفافیت حداکثر نیمه‌سفید باشد به عنوان شفاف علامت‌گذاری می‌کند.

اگر -alphamask را تعیین نکنید، ppmtoxpm تمام پیکسل‌ها را در خروجی کدر (مات) می‌سازد.

دستور ppmcolormask یکی از روش‌های ایجاد فایل ماسک شفافیت است. همچنین می‌توانید آن را با استخراج اطلاعات شفافیت از یک فایل XPM با گزینه -alphaout در دستور xpmtoppm ایجاد کنید.

گزینه‌های مشابهی در دیگر مبدل‌های Netpbm که قالب‌های دارای اطلاعات شفافیت را تبدیل می‌کنند نیز وجود دارد.

ppmcolormask(1), xpmtoppm(1), pamdepth(1), ppm(1) راهنمای XPM توسط Arnaud Le Hors lehors@mirsa.inria.fr

حق نشر (C) ۱۹۹۰ توسط Mark W. Snitily.

مجوز استفاده، کپی، تغییر و توزیع این نرم‌افزار و مستندات آن برای هر هدفی و بدون هزینه بدین وسیله اعطا می‌شود، مشروط بر اینکه اطلاعیه حق نشر بالا در تمامی نسخه‌ها ظاهر شود و هر دو اطلاعیه حق نشر و این مجوزنامه در مستندات پشتیبان آورده شوند. این نرم‌افزار «همان‌گونه که هست» و بدون هیچ‌گونه ضمانت صریح یا ضمنی ارائه شده است.

این ابزار برای شرکت Schlumberger Technologies، بخش ATE توسعه یافته بود و با اجازه آن‌ها همراه با اطلاعیه حق نشر و مجوز بالا در دسترس عموم قرار گرفته است.

ارتقا به XPM2 توسط Paul Breslaw از Mecasoft SA، زوریخ، سوئیس (paul@mecazh.uu.ch)، در ۸ نوامبر ۱۹۹۰.

ارتقا به XPM نسخه ۳ توسط Arnaud Le Hors (lehors@mirsa.inria.fr)، در ۹ آوریل ۱۹۹۱.

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

http://netpbm.sourceforge.net/doc/ppmtoxpm.html
22 February 2003 netpbm documentation