نام (NAME)

pnmhistmap - رسم بافت‌نگار برای یک فایل PGM یا PPM

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

pnmhistmap

[-red] [-green] [-blue]

[-black] [-white]

[-max N]

[-lval] [-rval]

[-height] [-width]

[-dots]

[-verbose]

[pnmfile]

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

توضیحات (DESCRIPTION)

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

دستور pnmhistmap یک تصویر PNM را به عنوان ورودی می‌خواند و تصویری تولید می‌کند که بافت‌نگاری از مقادیر رنگی (یا خاکستری) موجود در ورودی را نشان می‌دهد. یک ورودی PGM منجر به یک خروجی PBM می‌شود. یک ورودی PPM منجر به یک خروجی PPM با سه بافت‌نگار روی‌هم‌افتاده خواهد شد: یکی قرمز برای ورودی قرمز، یکی سبز برای ورودی سبز، و یکی آبی برای ورودی آبی.

برای مثال، تصویر زیر بافت‌نگار بعدی را تولید می‌کند:

تصویر بافت‌نگار حاصل از تصویر

اگر ورودی PBM باشد، pnmhistmap یک پیام خطا چاپ کرده و هیچ تصویر خروجی‌ای تولید نمی‌کند.

گزینه‌ها (OPTIONS)

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

-red

-green

-blue

مؤلفه رنگی مشخص‌شده را در خروجی می‌گنجاند. اگر هیچ‌یک از این‌ها را مشخص نکنید، pnmhistmap هر سه مؤلفه را در بر خواهد داشت.

این گزینه‌ها در صورتی که ورودی PGM باشد، بی‌معنی هستند.

این گزینه‌ها در Netpbm 10.26 (ژانویه ۲۰۰۵) اضافه شدند. پیش از آن، pnmhistmap همیشه هر سه مؤلفه رنگی را شامل می‌شد.

-dots

بافت‌نگار را به صورت نقطه رسم می‌کند. به صورت پیش‌فرض، pnmhistmap نمودار میله‌ای رسم می‌کند.

مثالی از حالت نقطه‌ای: مثال -dots

این گزینه در Netpbm 10.26 (ژانویه ۲۰۰۵) اضافه شد. پیش از آن، pnmhistmap همیشه نمودار میله‌ای رسم می‌کرد.

-lval minpixval

-rval maxpixval

این گزینه‌ها محدوده مقادیر روشنایی (شدت نور) را برای گنجاندن در نمودار مشخص می‌کنند. pnmhistmap مقادیر روشنایی کمتر از minpixval و بیشتر از maxpixval را نادیده می‌گیرد. بنابراین سمت چپ بافت‌نگار متناظر با minpixval و سمت راست آن متناظر با maxpixval خواهد بود.

به صورت پیش‌فرض، pnmhistmap تمام محدوده ممکن را رسم می‌کند: از صفر تا maxval.

این گزینه‌ها در Netpbm 10.26 (ژانویه ۲۰۰۵) اضافه شدند. پیش از آن، pnmhistmap همیشه نمودار را از صفر تا maxval رسم می‌کرد.

-height

-width

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

ارتفاع پیش‌فرض ۲۰۰ پیکسل است.

عرض پیش‌فرض یک پیکسل به ازای هر مقدار روشنایی رسم‌شده است (بنابراین توسط maxval تصویر و گزینه‌های -lval و -rval کنترل می‌شود). «باکت‌های شمارش» در بافت‌نگار همیشه دارای عرض یک پیکسل هستند. اگر عرضی کمتر از تعداد مقادیر روشنایی رسم‌شده تعیین کنید، یک باکت نمایانگر بیش از یک مقدار روشنایی خواهد بود. اگر عرضی بیشتر از تعداد مقادیر روشنایی رسم‌شده تعیین کنید، برخی باکت‌ها نمایانگر هیچ رنگی نخواهند بود (شمارش آن‌ها صفر است).

این گزینه در Netpbm 10.26 (ژانویه ۲۰۰۵) اضافه شد. پیش از آن، ابعاد همیشه برابر با مقادیر پیش‌فرض امروزی بود.

-black

هنگام مقیاس‌بندی بافت‌نگار، شمارش پیکسل‌های سیاه را نادیده می‌گیرد.

-white

هنگام مقیاس‌بندی بافت‌نگار، شمارش پیکسل‌های سفید را نادیده می‌گیرد.

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

-max N

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

-verbose

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

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

دستور pnmhistmap فرض می‌کند مقدار maxval همیشه ۲۵۵ است. تصاویری با maxval کوچکتر فقط از بخش مقادیر پایین‌تر بافت‌نگار استفاده خواهند کرد. می‌توانید این مشکل را با لوله‌کشی (pipe) ورودی به pamdepth یا با برش و مقیاس‌بندی بخش مقادیر پایین‌تر بافت‌نگار برطرف کنید. هیچ‌یک از این روش‌ها راه‌حلی چندان ظریف برای این مسئله محسوب نمی‌شوند.

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

pgmhist(1), ppmhist(1), pgm(1), ppm(1)

نویسنده (AUTHOR)

Wilson H. Bent. Jr. (whb@usc.edu).

منبع سند (DOCUMENT SOURCE)

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

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