<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<!-- lifted from troff+man by doclifter -->
<refentry id='dpyan2k1'>
<!--  @(#)dpyan2k.1 2001/04/02 NIST -->
<!--  I Image Group -->
<!--  Stan Janet &amp; Michael D. Garris -->

<refmeta>
<refentrytitle>DPYAN2K</refentrytitle>
<manvolnum>1C</manvolnum>
<refmiscinfo class='date'>02 April 2001</refmiscinfo>
<refmiscinfo class='source'>NIST</refmiscinfo>
<refmiscinfo class='manual'>NFIS Reference Manual</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>dpyan2k</refname>
<refpurpose>display image and minutiae contents of an ANSI/NIST file.</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
  <command>dpyan2k</command>    
    <arg choice='opt'><replaceable>options</replaceable></arg>
    <arg choice='plain' rep='repeat'><replaceable>&lt;ANSI_NIST</replaceable></arg>
    <arg>&gt;</arg>
    <sbr/>
    <arg choice='plain'>-a <replaceable>n</replaceable></arg>
    <sbr/>
    <arg choice='plain'>-v </arg>
    <sbr/>
    <arg choice='plain'>-x </arg>
    <sbr/>
    <arg choice='plain'>-b <replaceable>n</replaceable></arg>
    <sbr/>
    <arg choice='plain'>-i </arg>
    <sbr/>
    <arg choice='plain'>-n </arg>
    <sbr/>
    <arg choice='plain'>-p <replaceable>n</replaceable></arg>
    <sbr/>
    <arg choice='plain'>-W <replaceable>n</replaceable></arg>
    <sbr/>
    <arg choice='plain'>-H <replaceable>n</replaceable></arg>
    <sbr/>
    <arg choice='plain'>-X <replaceable>n</replaceable></arg>
    <sbr/>
    <arg choice='plain'>-Y <replaceable>n</replaceable></arg>
    <sbr/>
    <arg choice='plain'>-T <replaceable>title</replaceable></arg>
    <sbr/>
    <arg choice='plain'>-d <replaceable>display</replaceable></arg>
    <sbr/>
</cmdsynopsis>
</refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para><emphasis remap='B'>Dpyan2k</emphasis>
displays in a sequence of X11 windows all the image records and
overlays any corresponding minutiae from Type-9 records contained
in an ANSI/NIST-ITL 1-2000 file.</para>

<para>If multiple input files are specified,
<command>dpyan2k</command> 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.</para>

<para>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.</para>

<para>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.</para>

</refsect1>

<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><option>-a </option><emphasis remap='I'>n</emphasis></term>
  <listitem>
<para>sets drag accelerator to <emphasis remap='I'>n</emphasis> &mdash; changes in pointer position
will result in <emphasis remap='I'>n</emphasis> shifts in the displayed image [1].</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-v</option></term>
  <listitem>
<para>turns on verbose output.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-x</option></term>
  <listitem>
<para>turns on debug mode, causing a core dump when an X11 error occurs.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-b </option><emphasis remap='I'>n</emphasis></term>
  <listitem>
<para>sets border width to <emphasis remap='I'>n</emphasis> pixels [4].</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-i</option></term>
  <listitem>
<para>directs the utility to use the FBI/IAFIS fields 13-23 in a
Type-9 record when overlaying minutiae on an image.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-n</option></term>
  <listitem>
<para>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.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-p</option></term>
  <listitem>
<para>sets the pixel width of overlayed minutia points [3].</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-W </option><emphasis remap='I'>n</emphasis></term>
  <listitem>
<para>displays image in a window of width <emphasis remap='I'>n</emphasis> pixels.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-H </option><emphasis remap='I'>n</emphasis></term>
  <listitem>
<para>displays image in a window of height <emphasis remap='I'>n</emphasis> pixels.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-X </option><emphasis remap='I'>n</emphasis></term>
  <listitem>
<para>positions image window with top-left corner <emphasis remap='I'>n</emphasis>
pixels to the right of the display's top-left corner [0].</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-Y </option><emphasis remap='I'>n</emphasis></term>
  <listitem>
<para>positions image window with top-left corner <emphasis remap='I'>n</emphasis>
pixels below the display's top-left corner [0].</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-T </option><emphasis remap='I'>title</emphasis></term>
  <listitem>
<para>sets all image window names to <emphasis remap='I'>title</emphasis>.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><option>-d </option><emphasis remap='I'>display</emphasis></term>
  <listitem>
<para>connects to an alternate X11 display.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;ANSI_NIST ...&gt;</emphasis></term>
  <listitem>
<para>one or more ANSI/NIST files with images and possbily
minutiae to be displayed.</para>

  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

<refsect1 id='examples'><title>EXAMPLES</title>
<para>From <emphasis remap='I'>test/an2k/execs/dpyan2k/dpyan2k.src</emphasis>:</para>

<para><emphasis remap='B'>% dpyan2k ../../data/nist.an2</emphasis>
<!-- .br -->
displays image records and overlays minutia using NIST
Type-9 fields.</para>

<para><emphasis remap='B'>% dpyan2k -i ../../data/iafis.an2</emphasis>
<!-- .br -->
displays image records and overlays minutia using FBI/IAFIS
Type-9 fields.</para>

</refsect1>

<refsect1 id='see_also'><title>SEE ALSO</title>
<para><emphasis remap='B'>an2ktool</emphasis>(1C),
<emphasis remap='B'>dpyimage</emphasis>(1D),
<emphasis remap='B'>mindtct</emphasis>(1B)</para>

</refsect1>

<refsect1 id='author'><title>AUTHOR</title>
<para>NIST/ITL/DIV894/Image Group</para>
</refsect1>
</refentry>

