.\" 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 "Pnmstitch User Manual" 0 "July 2002" "netpbm documentation"

.SH "نام (NAME)"
pnmstitch \- اتصال و یکی‌کردن دو تصویر سراسرنما (کنار هم) به یکدیگر

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

\fBpnmstitch\fP
[
[\fIleft_filespec\fP] \fIright_filespec\fP |
\fIleft_filespec\fP \fIright_filespec\fP \fIoutput_filespec\fP
]
[\fB-width=\fP\fIwidth\fP]
[\fB-height=\fP\fIheight\fP]
[\fB-xrightpos=\fP\fIcolumn\fP]
[\fB-yrightpos=\fP\fIrow\fP]
[\fB-stitcher=\fP{\fBRotateSliver\fP,
\fBBiLinearSliver\fP,\fBLinearSliver\fP}]
[\fB-filter=\fP{\fBLineAtATime\fP,\fBHorizontalCrop\fP}]
[\fB-output=\fP\fIoutput_filespec\fP]
[\fB-verbose\fP]
.PP
همهٔ گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها خلاصه کرد.
می‌توانید به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید نام
یک گزینه و مقدار آن را به جای علامت مساوی با فاصله از هم جدا کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامهٔ \fBpnmstitch\fP دو عکس سراسرنما (پانوراما) را به یکدیگر پیوند می‌دهد.
این بدان معناست که اگر از سمت چپ و راست سوژه‌ای که برای یک کادر دوربین
بیش از حد بزرگ است عکس گرفته‌اید، \fBpnmstitch\fP می‌تواند آن‌ها را به یک
تصویر عریض تبدیل کند.
.PP
برنامهٔ \fBpnmstitch\fP تنها روی تصاویر کنار هم کار می‌کند، نه تصاویر بالا و پایین
(هرچند مسلماً می‌توانید از \fBpamflip\fP در ترکیب با \fBpnmstitch\fP برای رسیدن به این هدف
استفاده کنید). این برنامه دو تصویر را به هم متصل می‌کند، اما می‌توانید مکرراً
از آن برای پیوند زدن هر تعداد تصویر که نیاز دارید استفاده کنید.
.PP
برای اینکه \fBpnmstitch\fP به درستی کار کند، عکس‌های شما باید هم‌پوشانی داشته باشند
و این هم‌پوشانی باید چشمگیر و قابل‌توجه باشد. \fBpnmstitch\fP تصویر سمت راست را
جابه‌جا کرده و می‌کِشد تا با تصویر سمت چپ تطابق پیدا کند. احتمالاً پس از آن مایل خواهید
بود نتیجه را با \fBpamcut\fP برش دهید تا تصویری مستطیلی و مرتب حاصل شود.
.PP
اگر صرفاً قصد دارید دو تصویر را از لبه‌هایشان به هم متصل کنید (الحاق ساده)، از
\fBpamcat\fP استفاده کنید.
.PP
آرگومان‌های \fIleft_filespec\fP و \fIright_filespec\fP مشخصات (نام‌های)
فایل‌های PNM حاوی تصاویر سمت چپ و راست هستند. اگر فقط \fIright_filespec\fP
را مشخص کنید، تصویر سمت چپ از ورودی استاندارد (Standard Input) خوانده می‌شود.
اگر هیچ‌کدام را مشخص نکنید، هر دو تصویر از ورودی استاندارد به صورت یک فایل
چندتصویری حاوی ابتدا تصویر چپ و سپس تصویر راست دریافت می‌شوند.
.PP
مقدار \fIoutput_filespec\fP مشخصات (نام) فایل PNM خروجی است.
گزینهٔ \fB-output\fP نیز فایل خروجی را مشخص می‌کند. شما نمی‌توانید هم‌زمان
هم آرگومان و هم گزینه را تعیین کنید. اگر هیچ‌یک را مشخص نکنید، خروجی
به خروجی استاندارد (Standard Output) فرستاده می‌شود.


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


.TP
\fB-width=\fIwidth\fP\fP
.TP
\fB-height=\fIheight\fP\fP
.TP
\fB-xrightpos=\fIcolumn\fP\fP
.TP
\fB-yrightpos=\fIrow\fP\fP
این‌ها محدودیت‌هایی برای نقطه‌ای هستند که \fBpnmstitch\fP تصاویر را در آنجا به هم پیوند می‌دهد.
برای روش \fBLinearSliver\fP، مقادیر \fIcolumn\fP و \fIrow\fP تعیین می‌کنند کدام
موقعیت در تصویر سمت راست با گوشهٔ بالا سمت راستِ تصویر سمت چپ مطابقت دارد.
     
.TP
\fB-stitcher=\fP{\fBRotateSliver\fP,\fBBiLinearSliver\fP,
\fBLinearSliver\fP}
مقدار پیش‌فرض \fBRotateSliver\fP است.

.TP
\fB-filter=\fP{\fBLineAtATime\fP,\fBHorizontalCrop\fP}
هیچ جزئیاتی در دسترس نیست.
     
.TP
\fB-output=\fP\fIoutput_filespec\fP
نام فایل خروجی. اگر این گزینه را مشخص نکنید، تصویر خروجی به خروجی استاندارد
(Standard Output) ارسال می‌شود.

.TP
\fB-verbose\fP
این گزینه باعث می‌شود \fBpnmstitch\fP پیام‌هایی را درباره فرایند پیوند تصاویر به
خطای استاندارد (Standard Error) ارسال کند.
     


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamcut" (1)\c
\&,
.BR "pamcat" (1)\c
\&,
.BR "pamflip" (1)\c
\&,
.BR "pnm" (1)\c
\&,

.UN history
.SH "تاریخچه (HISTORY)"
.PP
این برنامه در نگارش ۱۰.۷ (اوت ۲۰۰۲) به Netpbm اضافه شد.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است.
مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pnmstitch.html
.PP