nbis-wrapper-js 0.0.1

package/libnbis/nbis_x86-64_linux/man/man1/dpyan2k.1

@@ -0,0 +1,179 @@
+.\" @(#)dpyan2k.1 2008/10/02 NIST
+.\" I Image Group
+.\" Stan Janet & Michael D. Garris
+.\" record selection options added by Joseph C. Konczal
+.\"
+.TH DPYAN2K 1F "02 October 2008" "NIST" "NBIS Reference Manual"
+.SH NAME
+dpyan2k \- display image and minutiae contents of an
+ANSI/NIST file.
+.SH SYNOPSIS
+.B dpyan2k
+.RB [ \-vxIN ]
+.RB [ \-f 
+.IR FGP[:IMP] ]
+.RB [ \-i 
+.IR IMP ]
+.RB [ \-n 
+.IR IDC ]
+.RB [ \-t 
+.IR LRT ]
+.RB [ \-q 
+.IR NQM ]
+.RB [ \-r 
+.IR rec-sel-in-file ]
+.RB [ \-w 
+.IR rec-sel-out-file ]
+.RB [ \-a 
+.IR accel-factor ]
+.RB [ \-b 
+.IR border-width ]
+.RB [ \-p 
+.IR minutia-size ]
+.RB [ \-W 
+.IR width ]
+.RB [ \-H 
+.IR height ]
+.RB [ \-X 
+.IR x-pos ]
+.RB [ \-Y 
+.IR y-pos ]
+.RB [ \-T 
+.IR title ]
+.RB [ \-d 
+.IR display ]
+.RB [ \-version ]
+.I ANSI/NIST-file ...
+
+
+.SH DESCRIPTION
+\fBDpyan2k\fR displays the image records in a sequence of X11
+windows.  Overlays any corresponding minutiae from Type-9 records
+contained in an ANSI/NIST-ITL 1-2007 file.  Shows any segmentation
+data in Type-14 SEG or ASEG fields using unfilled colored polygons,
+typically rectangles.  Some of the options, including \fB-f\fR, can be
+used to select certain records to display, otherwise all images are
+displayed.
+
+If multiple input files are specified,
+\fIdpyan2k\fP reads each ANSI/NIST file into memory and
+displays its contents, one file at a time.  Multiple image
+records within an ANSI/NIST file are displayed simultaneously
+by forking background window processes, one for each
+image record.
+
+If an image is too large to be displayed on the screen,
+the upper left hand corner will be displayed and the rest of the
+image can be moved into view by holding down a mouse button,
+moving in the direction desired, and then releasing the button.
+Button presses when another button(s) is already down
+and button releases when another button(s) is still down
+are ignored.
+
+Users may remove a displayed image window by striking any key
+within that window.  Once all windows associated with a
+particular ANSI/NIST file have been removed, the utility proceeds
+to display the contents of the next ANSI/NIST file listed on
+the command line.
+
+.SH OPTIONS
+.\" The following combination of several items separated by .br,
+.\" followed by .RS/.RE seems to adequately approximate a tagged
+.\" paragraph (.TP) with multiple tags.
+.P
+\fB-f \fIfinger position (FGP)\fR
+.br
+\fB-i \fIimpression type (IMP)\fR
+.br
+\fB-n \fIimage descriptor character (IDC) (actually a small number)\fR
+.br
+\fB-t \fIlogical record type (LRT)\fR
+.br
+\fB-q \fINIST fingerprint image quality metric (NQM)\fR
+.br
+\fB-r \fIread record selector from a file\fR
+.br
+\fB-w \fIwrite record selector to a file\fR
+.RS
+See
+.BR record_selector (1F)
+for details on these record selector options.
+.RE
+.TP
+\fB-a \fIn
+sets drag accelerator to \fIn\fR \(em changes in pointer position
+will result in \fIn\fR shifts in the displayed image [1].
+.TP
+\fB-v
+turns on verbose output.
+.TP
+\fB-x
+turns on debug mode, causing a core dump when an X11 error occurs.
+.TP
+\fB-b \fIn
+sets border width to \fIn\fP pixels [4].
+.TP
+\fB-I
+directs the utility to use the FBI/IAFIS fields 13-23 in a Type-9
+record when overlaying minutiae on an image. (This was changed from
+little i in version 1 to capital I in version 2.)
+.TP
+\fB-N
+directs the utility to use the NIST fields 5-12 in a
+Type-9 record when overlaying minutiae on an image.  This
+is the default setting. (This was changed from
+little n in version 1 to capital N in version 2.)
+.TP
+\fB-p
+sets the pixel width of overlayed minutia points [3].
+.TP
+\fB-W \fIn
+displays image in a window of width \fIn\fR pixels.
+.TP
+\fB-H \fIn
+displays image in a window of height \fIn\fR pixels.
+.TP
+\fB-X \fIn
+positions image window with top-left corner \fIn\fR
+pixels to the right of the display's top-left corner [0].
+.TP
+\fB-Y \fIn
+positions image window with top-left corner \fIn\fR
+pixels below the display's top-left corner [0].
+.TP
+\fB-T \fItitle
+sets all image window names to \fItitle\fR.
+.TP
+\fB-d \fIdisplay
+connects to an alternate X11 display.
+.TP
+\fB-version
+\fRPrint ANSI/NIST stardand and NBIS software version.
+\fI<ANSI_NIST ...>
+one or more ANSI/NIST files with images and possbily
+minutiae to be displayed.
+
+.SH EXAMPLES
+.B % dpyan2k ../../data/nist.an2
+.br
+displays image records and overlays minutia using NIST
+Type-9 fields.
+
+.B % dpyan2k -I ../../data/iafis.an2
+.br
+displays image records and overlays minutia using FBI/IAFIS
+Type-9 fields.
+
+.B % dpyan2k -ft:r ../../data/a001-seg.an2
+.br
+displays image records containing rolled thumbs and overlays
+segmentation results recorded in the data file.
+
+.SH "SEE ALSO"
+.BR an2ktool (1F),
+.BR dpyimage (1G),
+.BR mindtct (1C),
+.BR record_selector (1F)
+
+.SH AUTHOR
+NIST/ITL/DIV894/Image Group

package/libnbis/nbis_x86-64_linux/man/man1/dpyimage.1

@@ -0,0 +1,233 @@
+.\" @(#)dpyimage.1 2008/10/02 NIST
+.\" I Image Group
+.\" Stan Janet
+.\"
+.TH DPYIMAGE 1G "02 October 2008" "NIST" "NBIS Reference Manual"
+.SH NAME
+dpyimage \- displays the image contents of Baseline JPEG,
+Lossless JPEG, WSQ, IHead, and raw pixmap files.
+
+.SH SYNOPSIS
+.B dpyimage
+[\fIoptions\fR]
+.I image-file ...
+.RS 10
+.br
+\fB-r \fIw\fR,\fIh\fR,\fId\fR,\fIwp
+.br
+\fB-A
+.br
+\fB-s \fIn
+.br
+\fB-a \fIn
+.br
+\fB-v
+.br
+\fB-x
+.br
+\fB-b \fIn
+.br
+\fB-N \fIn
+.br
+\fB-O
+.br
+\fB-k
+.br
+\fB-W \fIn
+.br
+\fB-H \fIn
+.br
+\fB-X \fIn
+.br
+\fB-Y \fIn
+.br
+\fB-n
+.br
+\fB-T \fItitle
+.br
+\fB-t
+.br
+\fB-D \fIdir
+.br
+\fB-d \fIdisplay
+.TP
+\fB-version
+\fRPrint ANSI/NIST stardand and NBIS software version.
+
+.SH DESCRIPTION
+.B Dpyimage
+reads various image file formats, decompresses and reconstructs pixmaps
+as needed, and displays image contents in an X11 window.  Supported
+file formats include Baseline JPEG (lossy), Lossless JPEG,
+WSQ (lossy), NIST IHead, and raw pixmap files.  Raw pixmaps containing
+either grayscale or interleaved RGB color pixels are supported.
+This utility automatically differentiates between these different formats.
+
+If only one file (or the \fI-n\fP option)
+is specified on the command line, the image or images are
+simply read from disk and then displayed.
+If multiple files are specified,
+\fBdpyimage\fR attempts to minimize the display waiting time
+by forking a background process to pre-read images from disk.
+By default, the child
+transfers images to the parent via a pipe.
+This always allows at least one image to be read in from disk
+while the user is viewing the current image.
+Since a process writing on a pipe
+is blocked (until a read on the other end of the pipe)
+after transferring four kilobytes, the child
+will only be one image ahead of the parent except when handling
+smaller images.
+
+If the \fI-t\fP option appears on the command line,
+the processes use temporary files as the means of exchanging
+image data. Therefore, the child is not constrained on
+the number of images it may pre-read for the parent.
+However, the filesystem on which the directory for temporary files resides
+must have enough space for copies of all images in uncompressed
+state or an error may occur.
+This is the suggested mode
+for viewing compressed images for which
+decompression takes considerably longer than disk I/O.
+
+If the image is too large to be displayed on the screen,
+the upper lefthand corner will be displayed and the rest of the
+image can be moved into view by holding down a mouse button,
+moving in the direction desired, and then releasing the button.
+Button presses when another button(s) is already down
+and button releases when another button(s) is still down
+are ignored.
+
+Users may exit from the program by striking keys 'x' or 'X'.
+Advancing to the next image is accomplished by any other
+keystroke.
+
+.SH OPTIONS
+.TP
+\fB-r, -raw  \fIw\fR,\fIh\fR,\fId\fR,\fIwp
+raw pixmap attributes:
+.RS
+\fIw\fR  - pixel width,
+.br
+\fIh\fR  - pixel height,
+.br
+\fId\fR  - pixel depth,
+.br
+\fIwp\fR - white pixel value
+.RS
+bi-level  wp=0|1
+.br
+grayscale wp=0|255
+.br
+RGB       wp=0 (value ignored)
+.RE
+.RE
+.TP
+\fB-A
+automatically advances through images.
+.TP
+\fB-s \fIn
+in automatic mode, sleeps \fIn\fP seconds before advancing to
+the next image [2].
+.TP
+\fB-a \fIn
+sets drag accelerator to \fIn\fR \(em changes in pointer position
+will result in \fIn\fR shifts in the displayed image [1].
+.TP
+\fB-v
+turns on verbose output.
+.TP
+\fB-x
+turns on debug mode, causing a core dump when an X11 error occurs.
+.TP
+\fB-b \fIn
+sets border width to \fIn\fP pixels [4].
+.TP
+\fB-N \fIn
+the child I/O process is niced to level \fIn\fP.
+.TP
+\fB-O
+overrides the redirect on windows (no window manager).
+.TP
+\fB-k
+informs utility that there is no keyboard input.
+.TP
+\fB-W \fIn
+displays image in a window of width \fIn\fR pixels.
+.TP
+\fB-H \fIn
+displays image in a window of height \fIn\fR pixels.
+.TP
+\fB-X \fIn
+positions image window with top-left corner \fIn\fR
+pixels to the right of the display's top-left corner [0].
+.TP
+\fB-Y \fIn
+positions image window with top-left corner \fIn\fR
+pixels below the display's top-left corner [0].
+.TP
+\fB-n
+does not fork to display multiple images.
+.TP
+\fB-T \fItitle
+sets window name to \fItitle\fR [\fIfile\fR].
+\fB-t
+uses temporary files to transfer multiple images to parent [via pipe].
+.TP
+\fB-D \fIdirectory
+creates temporary files in \fIdirectory\fP [/tmp].
+.TP
+\fB-d \fIdisplay
+connects to alternate display.
+.TP
+.I image-file ...
+one or more image files whose pixmaps are to be displayed.
+
+.SH ENVIRONMENT
+If the environment variable \fBTMPDIR\fR is set
+and the \fB-D\fR option is not set on the command line,
+\fBdpyimage\fR uses this directory as the location for temporary files.
+
+.SH EXAMPLES
+From \fItest/imgtools/execs/dpyimage/dpyimage.src\fR:
+.PP
+.B % dpyimage -r 500,500,8,255 ../../data/finger/gray/raw/finger.raw
+.br
+displays a fingerprint image from a raw pixmap file.
+
+.B % dpyimage ../../data/finger/gray/jpegl/finger.jpl
+.br
+displays a reconstructed fingerprint image from a Lossless JPEG file.
+
+.B % dpyimage ../../data/finger/gray/wsq/finger.wsq
+.br
+displays a reconstructed fingerprint image from a WSQ file.
+
+.B % dpyimage ../../data/face/gray/jpegb/face.jpb
+.br
+displays a reconstructed grayscale face image from a Baseline JPEG file.
+
+.B % dpyimage -r 768,1024,24,0 ../../data/face/rgb/raw/intrlv/face.raw
+.br
+displays a color face image from a raw pixmap file.
+
+.B % dpyimage ../../data/face/rgb/jpegb/face.jpb
+.br
+displays a reconstructed color face image from a Baseline JPEG file.
+
+.B % dpyimage ../../data/face/rgb/jpegl/face.jpl
+.br
+displays a reconstructed color face image from a Lossless JPEG file.
+
+.SH "SEE ALSO"
+.BR an2ktool (1F),
+.BR cjpegb (1G),
+.BR cjpegl (1G),
+.BR cwsq (1G),
+.BR djpegb (1G),
+.BR djpegl (1G),
+.BR dpyan2k (1F),
+.BR dwsq (1G)
+
+.SH AUTHOR
+NIST/ITL/DIV894/Image Group

package/libnbis/nbis_x86-64_linux/man/man1/dwsq.1

@@ -0,0 +1,112 @@
+.\" @(#)dwsq.1 2008/10/02 NIST
+.\" I Image Group
+.\" Craig Watson and Michael D. Garris
+.\"
+.TH DWSQ 1G "02 October 2008" "NIST" "NBIS Reference Manual"
+.SH NAME
+dwsq \- decompresses a WSQ-encoded grayscale fingerprint image.
+.SH SYNOPSIS
+.B dwsq
+.I <outext>
+.I <image file>
+[\fB-raw_out\fR]
+
+.SH DESCRIPTION
+.B Dwsq
+takes as input a file containing a WSQ-compressed grayscale fingerprint
+image.  Once read into memory, the lossy-compressed pixmap is decoded
+and reconstructed using Wavelet Scalar Quantization as described in the
+FBI's Criminal Justice Information Services (CJIS) document,
+"WSQ Gray-scale Fingerprint Compressions Specification," Dec. 1997.
+This is the only fingerprint compression format accepted by the FBI IAFIS
+system.
+
+Upon completion, two different output image file formats are possible,
+a NIST IHead file (the default) or a raw pixmap file (specified by the
+\fB-raw_out\fR flag).  In addition, a specially formatted text
+file, called a NISTCOM, is created with extension ".ncm".  The NISTCOM
+file contains relevant image attributes associated with the decoded
+and reconstructed output image.
+(See NISTCOM OUTPUT below.)
+
+.SH OPTIONS
+All switch names may be abbreviated; for example,
+\fB-raw_out\fR may be written \fB-r\fR.
+.TP
+.I <outext>
+the extension of the decompressed output file.
+To construct the output filename, \fBdwsq\fR takes the
+input filename and replaces its extension with the one
+specified here.
+.TP
+.I <image file>
+the input WSQ file to be decompressed.
+.TP
+.B -raw_out
+specifies that the decoded and reconstructed image should be
+stored to a raw pixmap file.
+.TP
+\fB-version
+\fRPrint ANSI/NIST stardand and NBIS software version.
+
+.SH NISTCOM OUTPUT
+Upon successful completion, \fBdwsq\fR, creates a specially
+formatted text file called a NISTCOM file.
+A NISTCOM is a text-based attribute list comprised
+of (name, value) pairs, one pair per text line.
+The first line of a NISTCOM always has name = "NIST_COM" 
+and its value is always the total number of attributes included in
+the list.  These attributes are collected and merged from two
+different sources to represent the history and condition of
+the resulting reconstructed image.  The first source is from an
+optional NISTCOM comment block inside the WSQ-encoded input file.
+This comment block can be used to hold user-supplied attributes.
+The WSQ encoder, \fBcwsq\fR, by convention inserts one of these
+comment blocks in each compressed output file it creates.
+(The utility \fBrdwsqcom\fR can be used to scan a WSQ file for
+any and all comment blocks.)
+The second source of attributes comes from the decompression
+process itself.  In general, attribute values from this second
+source are given precedence over those from the first.
+
+The NISTCOM output filename is constructed by combining the
+basename of the input WSQ file with the extension ".ncm".
+By creating the NISTCOM file, relevant attributes associated
+with the decoded and reconstructed image are retained and
+easily accessed.  This is especially useful when dealing with
+raw pixmap files and creating image archives.  The following
+is an example NISTCOM generated by \fBdwsq\fR:
+
+.RS
+NIST_COM 7
+.br
+PIX_WIDTH 500
+.br
+PIX_HEIGHT 500
+.br
+PIX_DEPTH 8
+.br
+PPI 500
+.br
+LOSSY 1
+.br
+COLORSPACE GRAY
+
+.SH EXAMPLES
+From \fItest/imgtools/execs/dwsq/dwsq.src\fR:
+.PP
+.RS
+.B % dwsq raw finger.wsq -r
+.br
+decompresses a WSQ-encoded fingerprint image and stores
+the reconstructed image to a raw pixmap file.  Note the
+NISTCOM file, \fBfinger.ncm\fR, is also created.
+
+.SH SEE ALSO
+.BR cwsq (1G),
+.BR dpyimage (1G),
+.BR rdwsqcom (1G),
+.BR wrwsqcom (1G)
+
+.SH AUTHOR
+NIST/ITL/DIV894/Image Group

package/libnbis/nbis_x86-64_linux/man/man1/dwsq14.1

@@ -0,0 +1,120 @@
+.\" @(#)dwsq14.1 2008/10/02 NIST
+.\" I Image Group
+.\" Craig Watson and Michael D. Garris
+.\"
+.TH DWSQ14 1G "02 October 2008" "NIST" "NBIS Reference Manual"
+.SH NAME
+dwsq14 \- decompresses a WSQ14-encoded grayscale fingerprint image from
+NIST Special Database 14.
+.SH SYNOPSIS
+.B dwsq14
+.I <outext>
+.I <image file>
+[\fB-raw_out\fR]
+
+.SH DESCRIPTION
+.B Dwsq14
+takes as input a file containing a WSQ14-compressed grayscale fingerprint
+image from NIST Special Database 14.  The version of WSQ14 used to compress
+the images on this database is not certified and produces loss that may
+be more than permitted by a certified WSQ compression algorithm.  Once
+read into memory, the lossy-compressed pixmap is decoded and reconstructed
+using Wavelet Scalar Quantization as described in the FBI's Criminal
+Justice Information Services (CJIS) document, "WSQ Gray-scale Fingerprint
+Compressions Specification," Dec. 1997.  This is the only fingerprint
+compression format accepted by the FBI IAFIS system.
+
+Upon completion, two different output image file formats are possible,
+a NIST IHead file (the default) or a raw pixmap file (specified by the
+\fB-raw_out\fR flag).  In addition, a specially formatted text
+file, called a NISTCOM, is created with extension ".ncm".  The NISTCOM
+file contains relevant image attributes associated with the decoded
+and reconstructed output image.
+(See NISTCOM OUTPUT below.)
+
+.SH OPTIONS
+All switch names may be abbreviated; for example,
+\fB-raw_out\fR may be written \fB-r\fR.
+.TP
+.I <outext>
+the extension of the decompressed output file.
+To construct the output filename, \fBdwsq14\fR takes the
+input filename and replaces its extension with the one
+specified here.
+.TP
+.I <image file>
+the input WSQ14 file to be decompressed.
+.TP
+.B -raw_out
+specifies that the decoded and reconstructed image should be
+stored to a raw pixmap file.
+.TP
+\fB-version
+\fRPrint ANSI/NIST stardand and NBIS software version.
+
+.SH NISTCOM OUTPUT
+Upon successful completion, \fBdwsq14\fR, creates a specially
+formatted text file called a NISTCOM file.
+A NISTCOM is a text-based attribute list comprised
+of (name, value) pairs, one pair per text line.
+The first line of a NISTCOM always has name = "NIST_COM" 
+and its value is always the total number of attributes included in
+the list.  These attributes are collected from two sources
+and merged to represent the history and condition of the resulting
+reconstructed image.  The two sources for the attributes are the
+IHEAD header of the compressed image (specific information
+about the fingerprint itself is contained here) and the
+decompression process.  In general, attribute values from the second
+source are given precedence over those from the first.
+
+The NISTCOM output filename is constructed by combining the
+basename of the input WSQ14 file with the extension ".ncm".
+By creating the NISTCOM file, relevant attributes associated
+with the decoded and reconstructed image are retained and
+easily accessed.  This is especially useful when dealing with
+raw pixmap files and creating image archives.  The following
+is an example NISTCOM generated by \fBdwsq14\fR (highlighted
+items specific to SD14):
+
+.RS
+NIST_COM 12
+.br
+PPI 500
+.br
+.B SD_ID 14
+.br
+.B HISTORY f0000001.wsq 20 tape3.t1116010.01 4096x1536
+.br
+.B FING_CLASS R
+.br
+.B SEX m
+.br
+.B SCAN_TYPE i
+.br
+PIX_WIDTH 832
+.br
+PIX_HEIGHT 768
+.br
+PIX_DEPTH 8
+.br
+LOSSY 1
+.br
+COLORSPACE GRAY
+
+.SH EXAMPLES
+From \fItest/imgtools/execs/dwsq14/dwsq14.src\fR:
+.PP
+.RS
+.B % dwsq14 raw sd14.old -r
+.br
+decompresses a WSQ14-encoded fingerprint image and stores
+the reconstructed image to a raw pixmap file.  Note the
+NISTCOM file, \fBsd14.ncm\fR, is also created.
+
+.SH SEE ALSO
+.BR cwsq (1G),
+.BR dwsq (1G),
+.BR dpyimage (1G),
+
+.SH AUTHOR
+NIST/ITL/DIV894/Image Group