\
.\" 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 "Pnmmontage User Manual" 0 "22 November 2012" "netpbm documentation"

.SH "نام (NAME)"
pnmmontage \- ایجاد یک تصویر مونتاژ از تصاویر PNM

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

\fBpnmmontage\fP

[\fB-header=\fP\fIheaderfile\fP]

[\fB-quality=\fP\fIn\fP]

[\fB-prefix=\fP\fIprefix\fP]

[\fB-0\fP|\fB-1\fP|\fB-2\fP|\fB...\fP|\fB-9\fP]

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

\fIpnmfile\fP...

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور
\fBpnmmontage\fP
تصاویری با ابعاد گوناگون را در یک تصویر ترکیبی با کمترین مساحت بسته‌بندی (pack) می‌کند.
.PP
بخش‌هایی از خروجی که تصویری نمی‌تواند در آن‌ها قرار گیرد به رنگ سیاه درمی‌آیند.


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



.TP
\fB-data=\fP\fIfilename\fP
این گزینه باعث می‌شود
\fBpnmmontage\fP
فایلی بنویسد که موقعیت تصاویر اصلی در تصویر بسته‌بندی‌شده را در قالبی ماشین‌خوان شرح می‌دهد. در اینجا یک نمونه آمده است:

.nf
<span style="font-family: monospace">
            :0:0:227:298
            ../image1.ppm:0:0:227:149
            ../image2.ppm:0:149:227:149
</span>
.fi
.sp
برای هر تصویر سازنده یک خط و برای تصویر مرکب نیز یک خط وجود دارد.
.sp
۵ فیلد در هر خط به شرح زیر هستند:


.IP \(bu
نام تصویر منبع (یا رشته تهی که نشان‌دهنده خط مربوط به تصویر مرکب نهایی است)
.IP \(bu
شماره ستون گوشه بالا سمت چپ تصویر
.IP \(bu
شماره سطر گوشه بالا سمت چپ تصویر
.IP \(bu
عرض تصویر (بر حسب ستون)
.IP \(bu
ارتفاع تصویر (بر حسب سطر)

.sp
این گزینه در Netpbm 10.6 (ژوئیه ۲۰۰۲) اضافه شد.

.TP
\fB-header=\fP\fIfilename\fP
به
\fBpnmmontage\fP
می‌گوید که یک فایل هدر زبان C شامل موقعیت‌های تصاویر اصلی در تصویر بسته‌بندی‌شده بنویسد. هر تصویر اصلی چهار تعریف #define در فایل بسته‌بندی‌شده ایجاد می‌کند: xxxX، xxxY، xxxSZX و xxxSZY، که در آن xxx نام فایل است که تماماً به حروف بزرگ تبدیل شده است. خروجی همچنین شامل تعاریف #define با نام‌های OVERALLX و OVERALLY است که اندازه کلی تصویر مونتاژ را مشخص می‌کنند.
.sp
یک نمونه در اینجا آمده است:

.nf
\f(CW
            #define OVERALLX 227
            #define OVERALLY 298
            
            #define X 0
            #define Y 0
            #define SZX 227
            #define SZY 149
            
            #define X 0
            #define Y 149
            #define SZX 227
            #define SZY 149
\fP
.fi

.TP
\fB-prefix\fP
به
\fBpnmmontage\fP
دستور می‌دهد تا از پیشوند مشخص‌شده روی تمام تعاریف #define که تولید می‌کند استفاده کند.

.TP
\fB-quality\fP
پیش از تلاش برای چیدن تصاویر فرعی،
\fBpnmmontage\fP
حداقل مساحت ممکن برای مونتاژ را محاسبه می‌کند؛ این مقدار یا مجموع مساحت تمام تصاویر فرعی است، یا حاصل‌ضرب عرض عریض‌ترین تصویر فرعی در ارتفاع بلندترین تصویر فرعی، هر کدام که بزرگ‌تر باشد. سپس
\fBpnmmontage\fP
یک جستجوی فضای مسئله را برای یافتن بهترین چینش آغاز می‌کند؛ اگر راه‌حلی بیابد که (حداقل) به خوبیِ مساحت حداقلی ضربدر مقدار کیفیت (به صورت درصد) باشد، از جستجو خارج می‌شود. بنابراین،
\fB-quality=100\fP
بهترین راه‌حل ممکن را پیدا خواهد کرد؛ با این حال، ممکن است زمان بسیار زیادی طول بکشد. مقدار پیش‌فرض
\fB-quality=200\fP
است.

.TP
\fB-0\fP, \fB-1\fP, ... \fB-9\fP
این گزینه‌ها کیفیت را در سطحی بالاتر از
\fB-quality\fP
کنترل می‌کنند؛
\fB-0\fP
بدترین کیفیت است (اولین راه‌حل یافت‌شده را انتخاب می‌کند)، در حالی که
\fB-9\fP
بهترین کیفیت است (یک جستجوی جامع در فضای مسئله برای بهترین چینش مطلق انجام می‌دهد). هرچه عدد بزرگ‌تر باشد، محاسبات کندتر خواهد بود. مقدار پیش‌فرض
\fB-5\fP
است.




.UN notes
.SH "نکات (NOTES)"
.PP
استفاده از گزینه
\fB-9\fP
روی تمام مجموعه‌های تصاویر به جز کوچک‌ترین آنها بسیار کند است.
.PP
چیدمان با حداقل مساحت اغلب شکل مناسبی ندارد. برای نمونه، ممکن است یک ستون بلند و باریک از تصاویر باشد، در حالی که شما ترجیح می‌دهید شکلی مربعی‌تر داشته باشید. برای تحمیل حداقل عرض یا ارتفاع، می‌توانید یک تصویر پایه (strut image) اضافه کنید - تصویری سیاه به آن عرض و با ارتفاع یک پیکسل. به همین ترتیب، می‌توانید از یک strut عمودی برای اعمال حداقل ارتفاع استفاده کنید.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamcat" (1)\c
\&,
.BR "pnmindex" (1)\c
\&,
.BR "pnm" (1)\c
\&,
.BR "pam" (1)\c
\&,
.BR "pbm" (1)\c
\&,
.BR "pgm" (1)\c
\&,
.BR "ppm" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور
\fBpnmmontage\fP
در Netpbm 9.10 (ژانویه ۲۰۰۱) اضافه شد.


.UN author
.SH "نویسنده (AUTHOR)"

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