.\" 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 "Pnmindex User Manual" 0 "23 November 2023" "netpbm documentation"

.SH "نام (NAME)"
pnmindex \- ساخت یک نمایه تصویری از مجموعه‌ای از تصاویر PNM

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

\fBpnmindex\fP

[\fB-size=\fP\fIN\fP]

[\fB-across=\fP\fIN\fP]

[\fB-black\fP]

[\fB-title=\fP\fItitle\fP]

[\fB-quant\fP|\fB-noquant\fP]

[\fB-colors=\fP\fIN\fP]

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


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpnmindex\fP یک تصویر نمایه‌ای شامل نسخه‌های بندانگشتی (کوچک) از مجموعه‌ای از فایل‌های PNM ارائه‌شده ایجاد می‌کند (مشابه با یک «صفحه تماس» در عکاسی).
.PP
دستور \fBpnmindex\fP روی هر تصویر بندانگشتی برچسب می‌زند و می‌تواند به طور اختیاری حاوی یک عنوان باشد.
.PP
اگر تنها می‌خواهید چند تصویر را به صورت یک شبکه به هم متصل کنید، برای این کار از \fBpamundice\fP استفاده کنید.
.PP
اگر می‌خواهید تصویری را که با \fBpnmindex\fP ایجاد کرده‌اید تفکیک و جدا کنید، از \fBpamdice\fP یا \fBpamcut\fP استفاده کنید.
.PP
این برنامه ممکن است فایل‌های موقت بزرگی ایجاد کند. به طور پیش‌فرض، این فایل‌ها در دایرکتوری \fB/tmp\fP ذخیره می‌شوند، اما می‌توانید از متغیر محیطی \fBTMPDIR\fP برای ذخیره آن‌ها در مکانی دیگر استفاده کنید.


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


.TP
\fB-size=\fP\fIN\fP
اندازه هر تصویر بندانگشتی. تصویر تا حد امکان درون یک کادر \fIN\fP در \fIN\fP پیکسل بدون تغییر نسبت ابعاد کوچک می‌شود.
.sp
اگر تصویر ورودی در حال حاضر از این مقدار کوچک‌تر باشد، اندازه آن در خروجی دست‌نخورده باقی می‌ماند.
.sp
مقدار باید حداقل ۱ باشد.
.sp
پیش‌فرض ۱۰۰ است.

.TP
\fB-across=\fP\fIN\fP
تعداد تصاویر بندانگشتی در هر سطر.
.sp
مقدار باید حداقل ۱ باشد.
.sp
پیش‌فرض ۶ است.
  
.TP
\fB-black\fP
رنگ فاصله و حاشیه بین تصاویر را کنترل می‌کند؛ به صورت پیش‌فرض این رنگ سفید است و برچسب‌ها با حروف سیاه روی پس‌زمینه سفید قرار دارند، اما گزینه \fB-black\fP این حالت را معکوس می‌کند.

.TP
\fB-title=\fP\fItitle\fP
عنوانی را تعیین می‌کند که در بالای تصویر قرار می‌گیرد.
.sp
مقدار \fItitle\fP باید در قالب ASCII باشد. نویسه‌هایی که جزو نویسه‌های معتبر ASCII نیستند نمایش داده نمی‌شوند.
.sp
پیش‌فرض بدون عنوان است.

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

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

.TP
\fB-colors=\fP\fIN\fP
حداکثر تعداد رنگ‌های مجاز در کل تصویر. در صورتی که تعداد رنگ‌ها بیش از این مقدار باشد، \fBpnmindex\fP نتیجه را کوانتایز می‌کند. برای کاهش تأثیر رنگ‌های یک تصویر بندانگشتی بر رنگ‌های استفاده‌شده در دیگری، برنامه ابتدا رنگ‌ها را در هر بندانگشتی به طور مستقل به این تعداد کاهش می‌دهد، سپس رنگ‌ها را در هر سطر از بندانگشتی‌ها به این تعداد کوانتایز می‌کند، و در پایان رنگ‌های کل تصویر خروجی را به این عدد کاهش می‌دهد.
.sp
در صورت مشخص کردن گزینه \fB-noquant\fP یا در صورتی که هیچ تصویر ورودی PPM نباشد، این مقدار بی‌اثر خواهد بود.
.sp
پیش‌فرض ۲۵۶ است.




.UN history
.SH "تاریخچه (HISTORY)"
.PP
پیش از Netpbm نسخه 11.05 (دسامبر ۲۰۲۳)، گزینه مشترک \fB-plain\fP در Netpbm پیاده‌سازی نشده بود.


  .UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamscale" (1)\c
\&,
.BR "pamcat" (1)\c
\&,
.BR "pbmtext" (1)\c
\&,
.BR "pnmquant" (1)\c
\&,
.BR "pamcut" (1)\c
\&,
.BR "pamdice" (1)\c
\&,
.BR "pamundice" (1)\c
\&,
.BR "pnmtile" (1)\c
\&,
.BR "pnm" (1)\c
\&


.UN author
.SH "نویسندگان (AUTHORS)"
.PP
حق نشر \(co ۱۹۹۱ متعلق به Jef Poskanzer.
.PP
گزینه‌های \fB-title\fP و \fB-noquant\fP در سال ۲۰۰۰ توسط John Heidemann اضافه شدند.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از روی منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pnmindex.html
.PP