نام (NAME)

pnmindex - ساخت یک نمایه تصویری از مجموعه‌ای از تصاویر PNM

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

pnmindex

[-size=N]

[-across=N]

[-black]

[-title=title]

[-quant|-noquant]

[-colors=N]

pnmfile ...

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

توضیحات (DESCRIPTION)

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

دستور pnmindex یک تصویر نمایه‌ای شامل نسخه‌های بندانگشتی (کوچک) از مجموعه‌ای از فایل‌های PNM ارائه‌شده ایجاد می‌کند (مشابه با یک «صفحه تماس» در عکاسی).

دستور pnmindex روی هر تصویر بندانگشتی برچسب می‌زند و می‌تواند به طور اختیاری حاوی یک عنوان باشد.

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

اگر می‌خواهید تصویری را که با pnmindex ایجاد کرده‌اید تفکیک و جدا کنید، از pamdice یا pamcut استفاده کنید.

این برنامه ممکن است فایل‌های موقت بزرگی ایجاد کند. به طور پیش‌فرض، این فایل‌ها در دایرکتوری /tmp ذخیره می‌شوند، اما می‌توانید از متغیر محیطی TMPDIR برای ذخیره آن‌ها در مکانی دیگر استفاده کنید.

گزینه‌ها (OPTIONS)

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

-size=N

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

اگر تصویر ورودی در حال حاضر از این مقدار کوچک‌تر باشد، اندازه آن در خروجی دست‌نخورده باقی می‌ماند.

مقدار باید حداقل ۱ باشد.

پیش‌فرض ۱۰۰ است.

-across=N

تعداد تصاویر بندانگشتی در هر سطر.

مقدار باید حداقل ۱ باشد.

پیش‌فرض ۶ است.

-black

رنگ فاصله و حاشیه بین تصاویر را کنترل می‌کند؛ به صورت پیش‌فرض این رنگ سفید است و برچسب‌ها با حروف سیاه روی پس‌زمینه سفید قرار دارند، اما گزینه -black این حالت را معکوس می‌کند.

-title=title

عنوانی را تعیین می‌کند که در بالای تصویر قرار می‌گیرد.

مقدار title باید در قالب ASCII باشد. نویسه‌هایی که جزو نویسه‌های معتبر ASCII نیستند نمایش داده نمی‌شوند.

پیش‌فرض بدون عنوان است.

-noquant

کوانتایز کردن (کاهش تعداد) رنگ‌ها را غیرفعال می‌کند. به طور پیش‌فرض، اگر هر یک از تصاویر ورودی از نوع PPM باشد، برنامه تعداد رنگ‌ها را به مقدار مشخص‌شده با -colors کاهش می‌دهد.

-quant

این گزینه هیچ تأثیری ندارد؛ و به صراحت رفتار پیش‌فرض مبنی بر کوانتایز کردن رنگ‌ها را انتخاب می‌کند. به -noquant مراجعه کنید.

-colors=N

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

در صورت مشخص کردن گزینه -noquant یا در صورتی که هیچ تصویر ورودی PPM نباشد، این مقدار بی‌اثر خواهد بود.

پیش‌فرض ۲۵۶ است.

تاریخچه (HISTORY)

پیش از Netpbm نسخه 11.05 (دسامبر ۲۰۲۳)، گزینه مشترک -plain در Netpbm پیاده‌سازی نشده بود.

.UN seealso

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

pamscale(1), pamcat(1), pbmtext(1), pnmquant(1), pamcut(1), pamdice(1), pamundice(1), pnmtile(1), pnm(1)

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

حق نشر © ۱۹۹۱ متعلق به Jef Poskanzer.

گزینه‌های -title و -noquant در سال ۲۰۰۰ توسط John Heidemann اضافه شدند.

منبع سند (DOCUMENT SOURCE)

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

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