نام (NAME)

xpmtoppm - تبدیل یک تصویر پیکس‌مپ X11 به یک تصویر PPM

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

xpmtoppm

[--alphaout={alpha-filename,-}] [-verbose]

[xpmfile]

توضیحات (DESCRIPTION)

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

برنامه xpmtoppm یک فایل نگاشت‌پیکسلی X11 (نسخه ۱ یا ۳ فرمت XPM) را به عنوان ورودی خوانده و یک تصویر PPM در خروجی تولید می‌کند.

گزینه‌ها (OPTIONS)

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

--alphaout=alpha-filename

این گزینه باعث می‌شود که xpmtoppm یک فایل PBM حاوی ماسک شفافیت (transparency mask) تصویر ایجاد کند. اگر تصویر ورودی فاقد اطلاعات شفافیت باشد، فایل alpha-filename تنها حاوی مقادیر کاملاً سفید (کدر و مات) خواهد بود.

اگر گزینه --alphaout را مشخص نکنید، xpmtoppm هیچ فایل شفافیتی تولید نکرده و هرگونه اطلاعات شفافیت موجود در تصویر ورودی را نادیده می‌گیرد.

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

برای یک نمونه از نحوه استفاده از فایل خروجی شفافیت، ببینید: pamcomp(1).

برنامه xpmtoppm قادر به پردازش خطوط طولانی‌تر از ۸ کیلوبایت (8K) در ورودی XPM نیست. اگر طول خطی در فایل ورودی از این مقدار فراتر رود، xpmtoppm با یک پیام خطای متناسب به کار خود پایان می‌دهد. پیش از نسخه Netpbm 10.30 (اکتبر ۲۰۰۵)، این محدودیت برابر با ۲ کیلوبایت (2K) بود.

--verbose

برنامه xpmtoppm اطلاعات مربوط به فرآیند پردازش را در خطای استاندارد (Standard Error) چاپ می‌کند.

محدودیت‌ها (LIMITATIONS)

برنامه xpmtoppm تنها مجموعه محدودی از ویژگی‌های نسخه ۳ فرمت XPM را شناسایی می‌کند؛ به این معنی که بسیاری از تصاویر معتبر XPM را به عنوان تصویر نامعتبر رد می‌کند.

تنها جایی که قرارگیری بلوک توضیحات (comment) معتبر است، شروع از ستون ۱ در سطر بلافاصله پس از "... static char" است.

علاوه بر این، ppmtoxpm هر توضیح تک‌خطی را که از ستون ۱ در بخش جدول رنگ‌های فایل شروع شود، به درستی شناسایی می‌کند.

باید برای هر پیکسل یک نام‌رنگ پیش‌فرض جهت نمایش نوع رنگ وجود داشته باشد.

پیش از نسخه Netpbm 10.58 (مارس ۲۰۱۲)، وجود مقدار صفر بایت به ازای هر پیکسل باعث می‌شد برنامه با پیامی مبنی بر پایان زودهنگام فایل ورودی (premature EOF) با خطا متوقف شود.

همچنین ببینید (SEE ALSO)

ppmtoxpm(1), pamcomp(1), ppm(1)

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

حق نشر (C) ۱۹۹۱ متعلق به Jef Poskanzer است.

ارتقا یافته برای کار با نگارش ۳ از XPM توسط Arnaud Le Hors<lehors@mirsa.inria.fr>, سه‌شنبه ۹ آوریل ۱۹۹۱.

منبع مستندات (DOCUMENT SOURCE)

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

http://netpbm.sourceforge.net/doc/xpmtoppm.html