نام (NAME)

ppmtobmp - تبدیل یک تصویر PPM به یک فایل BMP

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

ppmtobmp

[-windows]

[-os2]

[-bpp=bits_per_pixel]

[-mapfile=filename]

[ppmfile]

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

توضیحات (DESCRIPTION)

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

برنامهٔ ppmtobmp یک تصویر PPM را به عنوان ورودی خوانده و یک فایل BMP برای Microsoft Windows یا OS/2 به عنوان خروجی تولید می‌کند.

گزینه‌ها (OPTIONS)

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

-windows

به برنامه اعلام می‌کند که یک فایل BMP مخصوص Microsoft Windows تولید کند (این حالت پیش‌فرض است).

-os2

به برنامه اعلام می‌کند که یک فایل BMP مخصوص OS/2 تولید کند (پیش از اوت ۲۰۰۰، این حالت پیش‌فرض بود).

-bpp

مشخص می‌کند که فایل BMP باید دارای چند بیت بر پیکسل (bits per pixel) باشد. تنها مقادیر ۱، ۴، ۸ و ۲۴ امکان‌پذیر هستند. به‌طور پیش‌فرض، ppmtobmp کوچک‌ترین مقداری را انتخاب می‌کند که با آن بتوان تمام رنگ‌های تصویر ورودی را بازنمایی کرد. اگر عددی را تعیین کنید که برای نمایش همه رنگ‌های تصویر ورودی بسیار کوچک باشد، ppmtobmp پیام داده و متوقف می‌شود. می‌توانید از pnmquant یا ppmdither برای کاهش تعداد رنگ‌های تصویر استفاده کنید.

پیش از نسخهٔ Netpbm 10.85 (دسامبر ۲۰۱۸)، چنانچه ورودی PBM بود، ppmtobmp این گزینه را نادیده می‌گرفت و یک BMP با ۱ بیت بر پیکسل تولید می‌کرد. در آن نسخه‌ها، اگر مقداری بیش از این می‌خواهید، ابتدا از pbmtopgm برای تبدیل PBM به PGM استفاده کنید.

-mapfile=filename

فایلی را مشخص می‌کند که باید به عنوان پالت BMP (یا همان «colormap») استفاده شود. در یکی از زیرقالب‌های BMP، جریان دادهٔ BMP شامل پالتی با حداکثر ۲۵۶ رنگ است و شطرنجی (رستر) تصویر را به صورت نمایه‌هایی به آن پالت بازنمایی می‌کند. در حالت معمول، ppmtobmp وظیفهٔ محاسبهٔ یک پالت مناسب را بر عهده دارد، اما اگر قصد دارید خروجی BMP را به نحوی کالبدشکافی و واکاوی کنید، ممکن است مقادیر مشخصی را برای نمایه‌های پالت در نظر داشته باشید. به عنوان مثال، ممکن است بخواهید رنگ قرمز نمایهٔ ۱۳ باشد، در حالی که ppmtobmp ممکن است (به صورت دلخواه) مقدار ۳۹ را انتخاب کند. در این صورت، می‌توانید خودتان پالت را ساخته و با استفاده از این گزینه به ppmtobmp دستور دهید که از پالت شما استفاده نماید.

این گزینه تعیین نمی‌کند چه رنگ‌هایی در خروجی باشند. رنگ‌های خروجی دقیقاً همان رنگ‌های ورودی هستند و پالتی که ارائه می‌دهید باید دست‌کم شامل تمامی رنگ‌های موجود در ورودی باشد. می‌توانید از pnmremap برای تنظیم تصویر ورودی خود استفاده کنید تا تنها حاوی رنگ‌هایی از پالت شما باشد.

فایل پالت، یک فایل با قالب Netpbm است که در آن هر پیکسل معرف یک مدخل در پالت است. هر پیکسل باید رنگی متمایز داشته باشد (تکرار مجاز نیست). ترتیب پالت BMP که ppmtobmp تولید می‌کند، مطابق با ترتیب پیکسل‌های فایل پالت از بالا به پایین و از چپ به راست خواهد بود.

یک پالت BMP حداکثر می‌تواند ۲۵۶ رنگ داشته باشد، بنابراین فایل پالت حداکثر باید ۲۵۶ پیکسل داشته باشد.

ممکن است ابزار pnmcolormap برای تولید فایل پالت مفید باشد؛ همچنین ابزار pamseq.

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

نمونه‌ای از انجام این کار در ادامه آورده شده است:

    
    $ pamseq 1 255 > mapfile.pgm
    $ ppmtobmp -mapfile=mapfile.pgm input.pgm > output.bmp
    

این گزینه در Netpbm 10.45 (دسامبر ۲۰۰۸) اضافه شده است.

نکات (NOTES)

برای دستیابی به بازتولیدی دقیق و وفادار از تصویر ورودی، مقدار maxval تصویر ورودی باید ۲۵۵ باشد. اگر مقداری غیر از این باشد، رنگ‌های موجود در فایل BMP ممکن است اندکی با رنگ‌های ورودی تفاوت داشته باشند.

آیکون‌های Windows فایل‌های BMP نیستند. برای ساخت آن‌ها از ppmtowinicon استفاده کنید.

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

bmptoppm(1), ppmtowinicon(1), pnmquant(1), ppmdither(1), pnmremap(1), ppm(1)

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

حق نشر (C) ۱۹۹۲ متعلق به David W. Sanderson است.

منبع سند (DOCUMENT SOURCE)

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

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