.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
.\" ========================================================================
.\"
.IX Title "LINEFIND ""1"""
.TH LINEFIND """1""" 2024-03-20 """Version: 2023.0.0""" 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 \- Detect vertical features in images
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBlinefind\fR [options] \-o \fIoutput.pto\fR \fIinput.pto\fR
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBlinefind\fR is a detector for vertical features in images. It tries to find
vertical lines using the same algorithm as Calibrate_lens_gui and assigns
vertical control points to them. The detection runs on the source images, if
the input images are rectilinear images. In the other cases (e. g. fisheye
images) the input images are reprojected to an equirectangular projection and
the detection works on the reprojected images. It uses the roll value, saved
in the pto project file, to determine what is "top" and "bottom". So before
running linefind check that your roll values are correct (E. g. when using
images straight from the camera, use a roll value of 0 for landscape and a
value of 90 or 270 for portrait images. If your camera has an orientation
sensor, Hugin can detect this information automatically and sets the roll
value accordingly when adding such images into Hugin.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-o|\-\-output\fR output.pto" 4
.IX Item "-o|--output output.pto"
Output Hugin PTO file. Default: '<filename>_line.pto'.
.IP "\fB\-l|\-\-lines\fR num" 4
.IX Item "-l|--lines num"
The maximum number of lines added per image (default: 5) Attention: Keep in
mind that more vertical control points will dominate the optimisation in favour
of "normal" control points.
.IP "\fB\-i|\-\-image\fR num" 4
.IX Item "-i|--image num"
Image number(s) to process.  Normally linefind tries to find vertical lines in
all images of the project file. If you want to limit the detection to some
selected images, you can use this parameter. Can be used multiple times.
.IP \fB\-h|\-\-help\fR 4
.IX Item "-h|--help"
shows help
.SH AUTHORS
.IX Header "AUTHORS"
Thomas Modes, line detection code based on calibrate_lens by Tim Nugent