.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Ppmtobmp User Manual" 0 "20 December 2018" "netpbm documentation"

.SH "نام (NAME)"
ppmtobmp \- تبدیل یک تصویر PPM به یک فایل BMP

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBppmtobmp\fP

[\fB-windows\fP]

[\fB-os2\fP]

[\fB-bpp=\fP\fIbits_per_pixel\fP]

[\fB-mapfile=\fP\fIfilename\fP]

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


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامهٔ \fBppmtobmp\fP یک تصویر PPM را به عنوان ورودی خوانده و یک فایل BMP برای Microsoft Windows یا OS/2 به عنوان خروجی تولید می‌کند.

.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm (به‌ویژه \fB-quiet\fP؛
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
\& را ببینید)، \fBppmtobmp\fP گزینه‌های خط فرمان زیر را می‌شناسد:


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

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

.TP
\fB-bpp\fP
مشخص می‌کند که فایل BMP باید دارای چند بیت بر پیکسل (bits per pixel) باشد. تنها مقادیر ۱، ۴، ۸ و ۲۴ امکان‌پذیر هستند. به‌طور پیش‌فرض، \fBppmtobmp\fP کوچک‌ترین مقداری را انتخاب می‌کند که با آن بتوان تمام رنگ‌های تصویر ورودی را بازنمایی کرد. اگر عددی را تعیین کنید که برای نمایش همه رنگ‌های تصویر ورودی بسیار کوچک باشد، \fBppmtobmp\fP پیام داده و متوقف می‌شود. می‌توانید از \fBpnmquant\fP یا \fBppmdither\fP برای کاهش تعداد رنگ‌های تصویر استفاده کنید.
.sp
پیش از نسخهٔ Netpbm 10.85 (دسامبر ۲۰۱۸)، چنانچه ورودی PBM بود، \fBppmtobmp\fP این گزینه را نادیده می‌گرفت و یک BMP با ۱ بیت بر پیکسل تولید می‌کرد. در آن نسخه‌ها، اگر مقداری بیش از این می‌خواهید، ابتدا از \fBpbmtopgm\fP برای تبدیل PBM به PGM استفاده کنید.

.TP
\fB-mapfile=\fP\fIfilename\fP
فایلی را مشخص می‌کند که باید به عنوان پالت BMP (یا همان «colormap») استفاده شود. در یکی از زیرقالب‌های BMP، جریان دادهٔ BMP شامل پالتی با حداکثر ۲۵۶ رنگ است و شطرنجی (رستر) تصویر را به صورت نمایه‌هایی به آن پالت بازنمایی می‌کند. در حالت معمول، \fBppmtobmp\fP وظیفهٔ محاسبهٔ یک پالت مناسب را بر عهده دارد، اما اگر قصد دارید خروجی BMP را به نحوی کالبدشکافی و واکاوی کنید، ممکن است مقادیر مشخصی را برای نمایه‌های پالت در نظر داشته باشید. به عنوان مثال، ممکن است بخواهید رنگ قرمز نمایهٔ ۱۳ باشد، در حالی که \fBppmtobmp\fP ممکن است (به صورت دلخواه) مقدار ۳۹ را انتخاب کند. در این صورت، می‌توانید خودتان پالت را ساخته و با استفاده از این گزینه به \fBppmtobmp\fP دستور دهید که از پالت شما استفاده نماید.
.sp
این گزینه تعیین \fIنمی‌کند\fP چه رنگ‌هایی در خروجی باشند. رنگ‌های خروجی دقیقاً همان رنگ‌های ورودی هستند و پالتی که ارائه می‌دهید باید دست‌کم شامل تمامی رنگ‌های موجود در ورودی باشد. می‌توانید از \fBpnmremap\fP برای تنظیم تصویر ورودی خود استفاده کنید تا تنها حاوی رنگ‌هایی از پالت شما باشد.
.sp
فایل پالت، یک فایل با قالب Netpbm است که در آن هر پیکسل معرف یک مدخل در پالت است. هر پیکسل باید رنگی متمایز داشته باشد (تکرار مجاز نیست). ترتیب پالت BMP که \fBppmtobmp\fP تولید می‌کند، مطابق با ترتیب پیکسل‌های فایل پالت از بالا به پایین و از چپ به راست خواهد بود.
.sp
یک پالت BMP حداکثر می‌تواند ۲۵۶ رنگ داشته باشد، بنابراین فایل پالت حداکثر باید ۲۵۶ پیکسل داشته باشد.
.sp
ممکن است ابزار \fBpnmcolormap\fP برای تولید فایل پالت مفید باشد؛ همچنین ابزار \fBpamseq\fP.
.sp
در مورد تصاویر در مقیاس خاکستری (grayscale)، چنانچه در حال پردازش تصویر BMP هستید، ممکن است ترجیح دهید به جای نمایه‌های دلخواه در یک پالت، مقادیر واقعی خاکستری را در بخش شطرنجی تصویر داشته باشید. هیچ قالب BMP خاصی به صورت اختصاصی برای این منظور وجود ندارد، اما می‌توانید با استفاده از پالتی که در آن هر نمایه برابر با مقدار خاکستری اندیس‌شده است، و سپس نادیده گرفتن پالت هنگام پردازش تصویر BMP، به این هدف دست یابید.
.sp
نمونه‌ای از انجام این کار در ادامه آورده شده است:

.nf
    \f(CW
    $ pamseq 1 255 > mapfile.pgm

    $ ppmtobmp -mapfile=mapfile.pgm input.pgm > output.bmp
    \fP
.fi
.sp
این گزینه در Netpbm 10.45 (دسامبر ۲۰۰۸) اضافه شده است.




.UN notes
.SH "نکات (NOTES)"
.PP
برای دستیابی به بازتولیدی دقیق و وفادار از تصویر ورودی، مقدار maxval تصویر ورودی باید ۲۵۵ باشد. اگر مقداری غیر از این باشد، رنگ‌های موجود در فایل BMP ممکن است اندکی با رنگ‌های ورودی تفاوت داشته باشند.
.PP
آیکون‌های Windows فایل‌های BMP نیستند. برای ساخت آن‌ها از \fBppmtowinicon\fP استفاده کنید.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "bmptoppm" (1)\c
\&,
.BR "ppmtowinicon" (1)\c
\&,
.BR "pnmquant" (1)\c
\&,
.BR "ppmdither" (1)\c
\&,
.BR "pnmremap" (1)\c
\&,
.BR "ppm" (1)\c
\&

.UN author
.SH "نویسندگان (AUTHORS)"

حق نشر (C) ۱۹۹۲ متعلق به David W. Sanderson است.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmtobmp.html
.PP