Difference between revisions of "Linefind"
(Inital linefind description) |
|||
| Line 1: | Line 1: | ||
= General and description = | = General and description = | ||
| − | '''Linefind''' is a detector for vertical features in images. It tries to find vertical lines using the same algorithm as [[Calibrate lens gui#Line detection|Calibrate_lens_gui]] and assign [[Vertical control points|vertical control points]] to them. | + | '''Linefind''' is a detector for vertical features in images. It tries to find vertical lines using the same algorithm as [[Calibrate lens gui#Line detection|Calibrate_lens_gui]] and assign [[Vertical control points|vertical control points]] to them. The detection runs on the source images, if the input images are [[Rectilinear Projection|rectilinear images]]. In the other cases (e. g. [[Fisheye Projection|fisheye images]]) the input images are reprojected to a [[Equirectangular Projection|equirectangluar projection]] and the detection works on the reprojected images. |
| − | It using the [[roll|roll value]], saved in the pto project file, to determine what is "top" and "bottom". So before running '''linefind''' check that your [[roll|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 detection this information automatically and sets the roll value accordingly when adding such images into Hugin. | + | It using the [[roll|roll value]], saved in the pto project file, to determine what is "top" and "bottom". So before running '''linefind''' check that your [[roll|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 detection this information automatically and sets the roll value accordingly when adding such images into Hugin. |
= Usage = | = Usage = | ||
Revision as of 14:13, 18 September 2011
General and description
Linefind is a detector for vertical features in images. It tries to find vertical lines using the same algorithm as Calibrate_lens_gui and assign 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 a equirectangluar projection and the detection works on the reprojected images. It using 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 detection this information automatically and sets the roll value accordingly when adding such images into Hugin.
Usage
The general usage is
linefind -o output.pto input.pto
If the --output/-o switch is missing then the suffix "_line" is added to the filename.
The maximal number of lines added per image can be given with the --lines switch (or short -l):
linefind --lines=10 -o output.pto input.pto
By default maximal 5 lines per image are added to the project file.
Attention: Keep in mind that more vertical control points will dominate the optimisation in favour of "normal" control points.
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 the --image/-i switch, e.g.
linefind --image=0 --image=4 -o output.pto input.pto
will only search for vertical lines in image 0 and 4.