.\" -*- 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 "NONA ""1"""
.TH NONA """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
nona \- Stitch a panorama image
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBnona\fR [options] \fB\-o\fR \fIoutput\fR \fIproject_file\fR (image files)
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBnona\fR uses the transform function from PanoTools, the stitching
itself is quite simple, no seam feathering is done.
.PP
Only the non-antialiasing interpolators of PanoTools are supported.
.PP
The following output formats (\fBn\fR option of PanoTools \fBp\fR script
line) are supported:
.IP "JPEG, TIFF, PNG  : Single image formats without feathered blending" 4
.IX Item "JPEG, TIFF, PNG : Single image formats without feathered blending"
.PD 0
.IP "JPEG_m, TIFF_m, PNG_m   : multiple tiff files" 4
.IX Item "JPEG_m, TIFF_m, PNG_m : multiple tiff files"
.IP "TIFF_multilayer : Multilayer tiff files, readable by The Gimp 2.0" 4
.IX Item "TIFF_multilayer : Multilayer tiff files, readable by The Gimp 2.0"
.PD
.SH OPTIONS
.IX Header "OPTIONS"
General options:
.IP \fB\-c\fR 4
.IX Item "-c"
Create coordinate images (only TIFF_m output)
.IP \fB\-v\fR 4
.IX Item "-v"
Quiet, do not output progress indicators
.IP \fB\-d\fR 4
.IX Item "-d"
print detailed output for GPU processing
.IP \fB\-g\fR 4
.IX Item "-g"
perform image remapping on the GPU
.PP
The following options can be used to override settings in the project file:
.IP "\fB\-i\fR \fInum\fR" 4
.IX Item "-i num"
Remap only image with number num (can be specified multiple times)
.IP "\fB\-m\fR \fIstr\fR" 4
.IX Item "-m str"
Set output file format (TIFF, TIFF_m, TIFF_multilayer, EXR, EXR_m, JPEG, JPEG_m, PNG, PNG_m)
.IP "\fB\-r\fR \fIldr\fR/\fIhdr\fR" 4
.IX Item "-r ldr/hdr"
Set output mode:
.RS 4
.IP "ldr \- keep original bit depth and response" 4
.IX Item "ldr - keep original bit depth and response"
.PD 0
.IP "hdr \- merge to hdr" 4
.IX Item "hdr - merge to hdr"
.RE
.RS 4
.RE
.IP "\fB\-e\fR \fIexposure\fR" 4
.IX Item "-e exposure"
.PD
Set exposure for ldr mode
.IP "\fB\-p\fR \fITYPE\fR" 4
.IX Item "-p TYPE"
Pixel type of the output. Can be one of:
.RS 4
.IP "UINT8   8 bit unsigned integer" 4
.IX Item "UINT8 8 bit unsigned integer"
.PD 0
.IP "UINT16  16 bit unsigned integer" 4
.IX Item "UINT16 16 bit unsigned integer"
.IP "INT16   16 bit signed integer" 4
.IX Item "INT16 16 bit signed integer"
.IP "UINT32  32 bit unsigned integer" 4
.IX Item "UINT32 32 bit unsigned integer"
.IP "INT32   32 bit signed integer" 4
.IX Item "INT32 32 bit signed integer"
.IP "FLOAT   32 bit floating point" 4
.IX Item "FLOAT 32 bit floating point"
.RE
.RS 4
.RE
.IP \fB\-z|\-\-compression\fR 4
.IX Item "-z|--compression"
.PD
Set compression type. Possible options for tiff output:
.RS 4
.IP "NONE      no compression" 4
.IX Item "NONE no compression"
.PD 0
.IP "PACKBITS  packbits compression" 4
.IX Item "PACKBITS packbits compression"
.IP "LZW       LZW compression" 4
.IX Item "LZW LZW compression"
.IP "DEFLATE   deflate compression" 4
.IX Item "DEFLATE deflate compression"
.PD
For JPEG output set quality number
.RE
.RS 4
.RE
.IP \fB\-\-ignore\-exposure\fR 4
.IX Item "--ignore-exposure"
Don't correct exposure. (This doesn't work with the \-e switch)
.IP \fB\-\-save\-intermediate\-images\fR 4
.IX Item "--save-intermediate-images"
Saves also the intermediate images (only when output is is TIFF, PNG or JPEG)
.IP \fB\-\-intermediate\-suffix=SUFFIX\fR 4
.IX Item "--intermediate-suffix=SUFFIX"
Suffix for intermediate images
.IP \fB\-\-create\-exposure\-layers\fR 4
.IX Item "--create-exposure-layers"
Create all exposure layers (this will always use TIFF)
.IP "\fB\-\-clip\-exposure[=lower cutoff:upper cutoff]\fR" 4
.IX Item "--clip-exposure[=lower cutoff:upper cutoff]"
Mask automatically all dark and bright pixels. Optionally you can specify the limits for the lower and upper cutoff (specify in range 0...1, relative the full range)
.SH AUTHORS
.IX Header "AUTHORS"
Written by Pablo d'Angelo. Also contains contributions from Douglas Wilkins, Ippei Ukai, Ed Halley, Bruno Postle, Gerry Patterson and Brent Townshend.
.PP
This man page was written by Cyril Brulebois
<cyril.brulebois@enst\-bretagne.fr> and updated by Terry Duell and is licensed under the same
terms as the hugin package itself.