نام (NAME)

ppmtopcx - تبدیل یک تصویر PPM به یک فایل PCX

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

ppmtopcx

[-24bit]

[-8bit]

[-packed]

[-stdpalette]

[-palette=palettefile]

[-planes=planes]

[-xpos=cols]

[-ypos=rows]

[ppmfile]

توضیحات (DESCRIPTION)

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

دستور ppmtopcx یک تصویر PPM را به عنوان ورودی خوانده و یک فایل PCX به عنوان خروجی تولید می‌کند. نوع فایل PCX به تعداد رنگ‌های موجود در تصویر ورودی بستگی دارد:

۱۶ رنگ یا کمتر:

فایل PCX هشت بیتی (۱ بیت/صفحه، ۱ تا ۴ صفحه یا ۱ تا ۴ بیت/صفحه، ۱ صفحه)

بیش از ۱۶ رنگ، اما نه بیشتر از ۲۵۶ رنگ:

فایل PCX با ۲۵۶ رنگ (۸ بیت/صفحه، ۱ صفحه)

بیش از ۲۵۶ رنگ:

فایل PCX رنگ واقعی یا truecolor (۲۴ بیتی) (۸ بیت/صفحه، ۳ صفحه)

می‌توانید با استفاده از گزینه‌های زیر برخی از این موارد را لغو کرده و قالب را به صورت صریح انتخاب کنید.

گزینه‌ها (OPTIONS)

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

-24bit

تولید یک فایل PCX رنگ واقعی (truecolor) ۲۴ بیتی، حتی اگر تصویر دارای ۲۵۶ رنگ یا کمتر باشد.

-8bit

تولید یک فایل PCX هشت بیتی (۲۵۶ رنگ)، حتی اگر تصویر دارای ۱۶ رنگ یا کمتر باشد.

این گزینه در Netpbm 10.18 (اوت ۲۰۰۳) اضافه شد.

-packed

استفاده از قالب «پیکسل فشرده» (packed pixel) برای فایل‌هایی با ۱۶ رنگ یا کمتر: ۱، ۲، یا ۴ بیت/پیکسل، ۱ صفحه.

-stdpalette

به جای محاسبه یک پالت از رنگ‌های درون تصویر، از یک پالت ۱۶ رنگ استاندارد و توکار استفاده می‌کند. اگر تصویر حاوی رنگی باشد که در پالت استاندارد وجود ندارد، ppmtopcx با شکست مواجه می‌شود.

پالت استاندارد نه‌تنها مجموعه‌ای از رنگ‌ها، بلکه یک نگاشت مشخص از نمایه‌های پالت به رنگ‌ها است؛ برای مثال، قرمز برابر با ۴ است.

می‌توانید از pnmremap به همراه یک تصویر PPM مناسب از پالت استاندارد استفاده کنید تا تصویر خود را طوری تطبیق دهید که دقیقاً از همان رنگ‌های موجود در پالت استفاده کند، تا ppmtopcx -stdpalette بتواند روی آن کار کند.

فایل pcxstd.ppm، که بخشی از Netpbm است، شامل پالت استاندارد می‌باشد.

اگرچه سرآیند PCX دقیقاً مشخص می‌کند چه پالتی در فایل استفاده شده است، برخی از مفسرهای قدیمی‌تر PCX از این اطلاعات استفاده نمی‌کنند. آن‌ها در عوض پالت استاندارد را فرض می‌کنند. اگر از گزینه -stdpalette استفاده نکنید، ممکن است ppmtopcx تصویری ایجاد کند که از پالت متفاوتی استفاده می‌کند (یک بازآرایی از همان رنگ‌ها) و سپس یکی از این مفسرهای قدیمی‌تر، رنگ‌های تصویر را به اشتباه تفسیر خواهد کرد.

نمی‌توانید این گزینه را هم‌زمان با -palette مشخص کنید.

این گزینه در Netpbm 10.22 (آوریل ۲۰۰۴) جدید بود.

-palette=palettefile

به جای محاسبه پالت از رنگ‌های موجود در تصویر، از پالت فایل palettefile استفاده می‌کند. اگر تصویر حاوی رنگی باشد که در آن پالت وجود ندارد، ppmtopcx با شکست مواجه می‌شود.

فایل پالت باید یک تصویر PPM باشد که به ازای هر رنگ در پالت، یک پیکسل داشته باشد. نسبت ابعاد تصویر پالت اهمیتی ندارد. ترتیب رنگ‌ها در پالت PCX، ترتیب پیکسل‌ها در تصویر PPM بر اساس ترتیب خواندن استاندارد غربی (از چپ به راست، از بالا به پایین) است. در صورت وجود رنگ تکراری در پالت، ppmtopcx در ساخت شطرنجی (raster) PCX، به دلخواه یکی از آن‌ها را انتخاب می‌کند.

شما تنها زمانی به این گزینه نیاز خواهید داشت که یک خواننده PCX داشته باشید که نتواند پالت موجود در فایل PCX را بخواند و در عوض پالت خاصی را فرض کند. همچنین گزینه -stdpalette را ببینید.

اگر تصویر ورودی شما ممکن است حاوی رنگ‌هایی به جز رنگ‌های موجود در پالت شما باشد، می‌توانید با pnmremap تصویر ورودی را به تصویری تبدیل کنید که فقط شامل رنگ‌های پالت شما باشد.

نمی‌توانید این گزینه را همراه با -stdpalette مشخص کنید.

این گزینه در Netpbm 10.25 (اکتبر ۲۰۰۴) جدید بود.

-planes=planes

تولید یک فایل PCX با planes صفحه، حتی اگر تعداد رنگ‌های تصویر با تعداد کمتری قابل نمایش باشد. این کار فایل را بزرگ‌تر می‌کند، اما برخی از مفسرهای PCX تنها قادر به پردازش تعداد مشخصی از صفحات هستند.

این گزینه تنها زمانی معنا دارد که ppmtopcx تصویری در قالب پالت ۱۶ رنگ بدون پیکسل‌های فشرده (packed pixels) تولید کند. در نتیجه، نمی‌توانید این گزینه را همراه با -24bit، -8bit یا -packed مشخص کنید.

مقادیر معتبر برای planes عبارتند از ۱، ۲، ۳ و ۴. به‌طور پیش‌فرض، ppmtopcx کمترین تعداد صفحاتی را که می‌تواند رنگ‌های تصویر را نمایش دهد انتخاب می‌کند؛ مثلاً اگر ۵ رنگ وجود داشته باشد، ppmtopcx تعداد ۳ صفحه را انتخاب می‌کند.

این گزینه در Netpbm 10.21 (مارس ۲۰۰۴) جدید بود.

-xpos=cols

-ypos=rows

این گزینه‌ها موقعیت تصویر را در یک محدوده (مثلاً روی صفحه نمایش) بر حسب ستون‌ها به سمت راست از لبه چپ و سطرها به سمت پایین از لبه بالا تعیین می‌کنند. قالب PCX حاوی اطلاعات موقعیت تصویر است. این مورد را با موقعیت یک ناحیه مورد نظر در درون تصویر اشتباه نگیرید. برای نمونه، استفاده از pnmpad برای افزودن یک حاشیه ۱۰ پیکسلی در سمت چپ به تصویر و سپس تبدیل آن تصویر به PCX با xpos = 0، همانند تبدیل تصویر اصلی به PCX و تنظیم xpos = 10 نیست.

مقادیر می‌توانند از -32767 تا 32768 باشند.

پیش‌فرض برای هر کدام صفر است.

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

pcxtoppm(1)، ppm(1)

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

حق نشر (C) ۱۹۹۴ متعلق به Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de)

بر اساس کارهای پیشین Michael Davidson.

منبع سند (DOCUMENT SOURCE)

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

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