.\" 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 "Pnmhistmap User Manual" 0 "13 July 2009" "netpbm documentation"

.SH "نام (NAME)"
pnmhistmap \- رسم بافت‌نگار برای یک فایل PGM یا PPM

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

\fBpnmhistmap\fP

[\fB-red\fP] [\fB-green\fP] [\fB-blue\fP]

[\fB-black\fP] [\fB-white\fP]

[\fB-max\fP \fIN\fP]

[\fB-lval\fP] [\fB-rval\fP]

[\fB-height\fP] [\fB-width\fP]

[\fB-dots\fP]

[\fB-verbose\fP]

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

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpnmhistmap\fP یک تصویر PNM را به عنوان ورودی می‌خواند و تصویری تولید می‌کند که بافت‌نگاری از مقادیر رنگی (یا خاکستری) موجود در ورودی را نشان می‌دهد. یک ورودی PGM منجر به یک خروجی PBM می‌شود. یک ورودی PPM منجر به یک خروجی PPM با سه بافت‌نگار روی‌هم‌افتاده خواهد شد: یکی قرمز برای ورودی قرمز، یکی سبز برای ورودی سبز، و یکی آبی برای ورودی آبی.
.PP
برای مثال، تصویر زیر بافت‌نگار بعدی را تولید می‌کند:
.PP
.B تصویر
.IMG -C testimg.png
.B بافت‌نگار حاصل از تصویر
.IMG -C testimg_histbar.png
.PP
اگر ورودی PBM باشد، \fBpnmhistmap\fP یک پیام خطا چاپ کرده و هیچ تصویر خروجی‌ای تولید نمی‌کند.

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



.TP
\fB-red\fP
.TP
\fB-green\fP
.TP
\fB-blue\fP
مؤلفه رنگی مشخص‌شده را در خروجی می‌گنجاند. اگر هیچ‌یک از این‌ها را مشخص نکنید، \fBpnmhistmap\fP هر سه مؤلفه را در بر خواهد داشت.
.sp
این گزینه‌ها در صورتی که ورودی PGM باشد، بی‌معنی هستند.
.sp
این گزینه‌ها در Netpbm 10.26 (ژانویه ۲۰۰۵) اضافه شدند. پیش از آن، \fBpnmhistmap\fP همیشه هر سه مؤلفه رنگی را شامل می‌شد.

.TP
\fB-dots\fP
بافت‌نگار را به صورت نقطه رسم می‌کند. به صورت پیش‌فرض، \fBpnmhistmap\fP نمودار میله‌ای رسم می‌کند.
.sp
مثالی از حالت نقطه‌ای:
.B مثال \-dots
.IMG -C testimg_histdot.png
.sp
این گزینه در Netpbm 10.26 (ژانویه ۲۰۰۵) اضافه شد. پیش از آن، \fBpnmhistmap\fP همیشه نمودار میله‌ای رسم می‌کرد.

.TP
\fB-lval\fP \fIminpixval\fP
.TP
\fB-rval\fP \fImaxpixval\fP
این گزینه‌ها محدوده مقادیر روشنایی (شدت نور) را برای گنجاندن در نمودار مشخص می‌کنند.
\fBpnmhistmap\fP مقادیر روشنایی کمتر از \fIminpixval\fP و
بیشتر از \fImaxpixval\fP را نادیده می‌گیرد. بنابراین سمت چپ بافت‌نگار
متناظر با \fIminpixval\fP و سمت راست آن متناظر با
\fImaxpixval\fP خواهد بود.
.sp
به صورت پیش‌فرض، \fBpnmhistmap\fP تمام محدوده ممکن را رسم می‌کند: از صفر
تا maxval.
.sp
این گزینه‌ها در Netpbm 10.26 (ژانویه ۲۰۰۵) اضافه شدند. پیش از آن،
\fBpnmhistmap\fP همیشه نمودار را از صفر تا maxval رسم می‌کرد.

.TP
-height
.TP
-width
این گزینه‌ها ابعاد تصویر بافت‌نگار را بر حسب پیکسل مشخص می‌کنند.
.sp
ارتفاع پیش‌فرض ۲۰۰ پیکسل است.
.sp
عرض پیش‌فرض یک پیکسل به ازای هر مقدار روشنایی رسم‌شده است (بنابراین توسط maxval تصویر و گزینه‌های \fB-lval\fP و \fB-rval\fP کنترل می‌شود). «باکت‌های شمارش» در بافت‌نگار همیشه دارای عرض یک پیکسل هستند. اگر عرضی کمتر از تعداد مقادیر روشنایی رسم‌شده تعیین کنید، یک باکت نمایانگر بیش از یک مقدار روشنایی خواهد بود. اگر عرضی بیشتر از تعداد مقادیر روشنایی رسم‌شده تعیین کنید، برخی باکت‌ها نمایانگر هیچ رنگی نخواهند بود (شمارش آن‌ها صفر است).
.sp
این گزینه در Netpbm 10.26 (ژانویه ۲۰۰۵) اضافه شد. پیش از آن، ابعاد همیشه برابر با مقادیر پیش‌فرض امروزی بود.

.TP
\fB-black \fP
هنگام مقیاس‌بندی بافت‌نگار، شمارش پیکسل‌های سیاه را نادیده می‌گیرد.

.TP
\fB-white\fP
هنگام مقیاس‌بندی بافت‌نگار، شمارش پیکسل‌های سفید را نادیده می‌گیرد.
.sp
گزینه‌های -black و -white که می‌توانند به صورت جداگانه یا با هم استفاده شوند، برای تصاویری مفید هستند که درصد بالایی از پیکسل‌های آن‌ها دارای مقدار صفر یا ۲۵۵ است، موضوعی که می‌تواند باعث شود داده‌های باقیمانده بافت‌نگار به قدری کوچک شوند که خوانا نباشند. توجه داشته باشید که برای ورودی‌های رنگی، این گزینه‌ها روی تمام رنگ‌ها اعمال می‌شوند؛ برای مثال، اگر ورودی دارای تعداد زیادی ناحیه قرمز روشن باشد، احتمالاً مایل به استفاده از گزینه -white خواهید بود.

.TP
\fB-max N\fP
مقیاس‌بندی بافت‌نگار را وادار می‌کند تا از N به عنوان مقدار بیشترین شمارش استفاده کند. این گزینه برای ورودی‌هایی با درصد بالایی از پیکسل‌های تک‌رنگ که سیاه یا سفید نیستند، کاربرد دارد.

.TP
\fB-verbose\fP
گزارش روند ساخت بافت‌نگار، از جمله بیشترین مقدار شمارش استفاده‌شده برای مقیاس‌بندی خروجی را چاپ می‌کند.




.UN limitations
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
دستور \fBpnmhistmap\fP فرض می‌کند مقدار maxval همیشه ۲۵۵ است. تصاویری با maxval کوچکتر فقط از بخش مقادیر پایین‌تر بافت‌نگار استفاده خواهند کرد. می‌توانید این مشکل را با لوله‌کشی (pipe) ورودی به \fBpamdepth\fP یا با برش و مقیاس‌بندی بخش مقادیر پایین‌تر بافت‌نگار برطرف کنید. هیچ‌یک از این روش‌ها راه‌حلی چندان ظریف برای این مسئله محسوب نمی‌شوند.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pgmhist" (1)\c
\&,
.BR "ppmhist" (1)\c
\&,
.BR "pgm" (1)\c
\&,
.BR "ppm" (1)\c
\&

.UN author
.SH "نویسنده (AUTHOR)"
.PP
Wilson H. Bent. Jr. (\fIwhb@usc.edu\fP).
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار «makeman» از Netpbm و از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pnmhistmap.html
.PP