.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "GEOCPSET ""1"""
.TH GEOCPSET """1""" 2026-01-05 """Version: 2025.0.1""" HUGIN
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
geocpset \- افزودن نقاط کنترل بر اساس موقعیت هندسی
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBgeocpset\fR [\fI\-o output.pto\fR] \fIinput.pto\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
\&\fBgeocpset\fR ابزاری برای تصاویر سراسرنما (پانوراما) است که شامل تصاویر فاقد ویژگی‌های بارز (مانند تصویر آسمان) هستند. در این گونه تصاویر، آشکارساز نقاط کنترل معمولاً موفق به یافتن نقاط کنترل نمی‌شود. \&\fBgeocpset\fR موقعیت تصاویر را در فایل‌های پروژه تحلیل می‌کند. سپس به تصاویری که توسط هیچ نقطه کنترلی متصل نشده‌اند، نقاط کنترل اضافه می‌کند. این نقاط کنترل صرفاً بر اساس موقعیت‌های هندسی تصاویر تنظیم می‌شوند و نه بر پایه محتوای بصری آن‌ها؛ از این رو \&\fBgeocpset\fR باید تنها در پروژه‌هایی به کار رود که موقعیت‌های تقریبی تصاویر در آن‌ها مشخص شده است.
.SH "نحوه استفاده (USAGE)"
.IX Header "USAGE"
.IP " \fBgeocpset\fR \fI\-o output.pto\fR \fIinput.pto\fR" 4
.IX Item " geocpset -o output.pto input.pto"
.PP
در صورت مشخص نشدن سوییچ \fI\-\-output/\-o\fR، پسوند «_geo» به نام فایل اضافه خواهد شد.
.PP
جریان کاری توصیه‎شده عبارت است از:
.IP "۱# ابتدا فایل پروژه را بسازید:" 4
.IX Item "1# First create project file"
pto_gen \-o project.pto *.jpg
.IP "۲# سپس موقعیت‌های تقریبی را به تصاویر اختصاص دهید:" 4
.IX Item "2# Then assign rough positions to images"
pto_var \-\-set y=i*20\-40,p=0,r=0 \-o project.pto project.pto
.IP "۳# حال یک آشکارساز نقاط کنترل «معمولی» را اجرا کنید، برای مثال فقط روی تصاویر هم‌پوشان:" 4
.IX Item "3# Now run a normal control point detector, e.g. only on overlapping images"
cpfind \-\-prealigned \-o project.pto project.pto
.IP "۴# و در نهایت تمام تصاویر متصل‌نشده را به یکدیگر متصل کنید:" 4
.IX Item "4# And finally connect all unconnected images"
geocpset \-o project.pto project.pto
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-o|\-\-output\fR \fIoutput.pto\fR" 4
.IX Item "-o|--output output.pto"
ذخیره فایل خروجی pto با نام فایل مشخص‌شده. در صورت مشخص نشدن، پسوند «_geo» به انتهای نام فایل ورودی الصاق خواهد شد.
.IP \fB\-e|\-\-each\-overlap\fR 4
.IX Item "-e|--each-overlap"
به‌طور پیش‌فرض، \&\fBgeocpset\fR تنها به تصاویر متصل‌نشده نقاط کنترل اضافه می‌کند. با این سوییچ می‌توانید برنامه را وادار کنید به هر هم‌پوشانی که با نقاط کنترل متصل نشده یا به موقعیت‌های تصاویر پیوند نخورده است، یک نقطه کنترل هندسی اضافه کند.
.IP \fB\-\-min\-overlap=NUM\fR 4
.IX Item "--min-overlap=NUM"
به‌طور پیش‌فرض، \&\fBgeocpset\fR تنها جفت‌تصاویری را لحاظ می‌کند که بیش از ۱۰٪ هم‌پوشانی داشته باشند. اگر هم‌پوشانی بسیار باریکی دارید، می‌توانید این مقدار را کاهش دهید تا چنین هم‌پوشانی‌های کوچکی نیز لحاظ شوند؛ به عنوان مثال:
\&\fB\-\-min\-overlap=1\fR
.IP \fB\-h|\-\-help\fR 4
.IX Item "-h|--help"
نمایش پیام راهنما.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
\&\fBgeocpset\fR توسط Thomas Modes نوشته شده است. این صفحه راهنما با تبدیل صفحه ویکی در <http://wiki.panotools.org> به قالب pod توسط Andreas Metzler ایجاد شده است.