.\" -*- 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 "LINEFIND ""1"""
.TH LINEFIND """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)"
linefind \- شناسایی ویژگی‌های عمودی در تصاویر
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBlinefind\fR [options] \-o \fIoutput.pto\fR \fIinput.pto\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
\&\fBlinefind\fR یک ابزار شناسایی ویژگی‌های عمودی در تصاویر است. این ابزار تلاش می‌کند خطوط عمودی را با استفاده از الگوریتمی مشابه با Calibrate_lens_gui پیدا کند و نقاط کنترل عمودی را به آن‌ها اختصاص دهد. اگر تصاویر ورودی از نوع مستقیم‌خط (rectilinear) باشند، عملیات شناسایی روی تصاویر مبدأ اجرا می‌شود. در موارد دیگر (مانند تصاویر چشم‌ماهی یا fisheye)، تصاویر ورودی به یک تصویرسازی هم‌مستطیلی (equirectangular) بازافکنی (reproject) می‌شوند و شناسایی روی تصاویر بازافکنی‌شده انجام می‌گیرد. این برنامه از مقدار roll ذخیره‌شده در فایل پروژه pto برای تعیین اینکه چه جهتی «بالا» و چه جهتی «پایین» است استفاده می‌کند. بنابراین پیش از اجرای linefind بررسی کنید که مقادیر roll شما درست باشند (برای نمونه هنگام استفاده از تصاویر مستقیماً گرفته‌شده با دوربین، مقدار roll را برای تصاویر افقی برابر 0 و برای تصاویر عمودی برابر 90 یا 270 قرار دهید. اگر دوربین شما حسگر جهت‌یابی داشته باشد، Hugin می‌تواند این اطلاعات را به‌طور خودکار تشخیص دهد و هنگام افزودن این تصاویر به Hugin، مقدار roll را متناسب با آن تنظیم کند).
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-o|\-\-output\fR output.pto" 4
.IX Item "-o|--output output.pto"
فایل PTO خروجی Hugin. پیش‌فرض: \*(Aq<filename>_line.pto\*(Aq.
.IP "\fB\-l|\-\-lines\fR num" 4
.IX Item "-l|--lines num"
حداکثر تعداد خطوط اضافه‌شده به ازای هر تصویر (پیش‌فرض: 5). توجه: به یاد داشته باشید که نقاط کنترل عمودی بیشتر، بر بهینه‌سازی چیره شده و آن را به نفع خود و به ضرر نقاط کنترل «معمولی» تحت تأثیر قرار می‌دهند.
.IP "\fB\-i|\-\-image\fR num" 4
.IX Item "-i|--image num"
شماره تصویر(ها) برای پردازش. در حالت عادی، linefind تلاش می‌کند خطوط عمودی را در تمام تصاویر فایل پروژه پیدا کند. اگر می‌خواهید شناسایی را به چند تصویر مشخص محدود کنید، می‌توانید از این پارامتر استفاده نمایید. این گزینه می‌تواند چندین بار استفاده شود.
.IP \fB\-h|\-\-help\fR 4
.IX Item "-h|--help"
نمایش راهنما
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Thomas Modes، کد شناسایی خط بر پایه calibrate_lens از Tim Nugent