<?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='sd_rfmt1'>
<!--  @(#)sd_rfmt.1 2001/04/02 NIST -->
<!--  I Image Group -->
<!--  Craig Watson and Michael D. Garris -->

<refmeta>
<refentrytitle>SD_RFMT</refentrytitle>
<manvolnum>1D</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>sd_rfmt</refname>
<refpurpose>takes images from NIST Special Databases 4, 9, 10, 14, and 18 and reformats the compressed data to work with the decompressors djpegl and dwsq.</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<para><command>sd_rfmt</command>
<emphasis remap='I'>&lt;SD #&gt;</emphasis>
<command>&lt;outext&gt;</command>
<emphasis remap='I'>&lt;image file&gt;</emphasis>
SD list = {4,9,10,14,18}</para>
</refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para><emphasis remap='B'>Sd_rfmt</emphasis>
reformats images compressed with the old JPEGLSD and WSQ14
compression, on NIST Special Databases 4, 9, 10, 18 (JPEGLSD) and
14 (WSQ14), so the images can be decompressed with the new
commands <emphasis remap='B'>djpegl</emphasis> and <emphasis remap='B'>dwsq</emphasis>.</para>

<para>When JPEGLSD was used to compress images on NIST Special
Databases (4, 9, 10, 18) the NIST IHEAD header was used to store
the data for the JPEGLSD compression.  In the new versions
<emphasis remap='B'>cjpegl</emphasis> and <emphasis remap='B'>djpegl</emphasis> the full JPEG format is used
not the IHEAD header.</para>

<para>The WSQ14 compression used on SD14 has problems with ordering
of the data in the compressed file.  <emphasis remap='B'>Sd_rfmt</emphasis> simply reorders
the data to comply with the format specified 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.  <emphasis remap='B'>NOTE: The method for selecting the quantization
amount was refined after the release of SD14 so the data loss in
the reconstructed image may be more than seen when using the new versions
cwsq and dwsq.</emphasis></para>

</refsect1>

<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><emphasis remap='I'>&lt;SD #&gt;</emphasis></term>
  <listitem>
<para>Specify that the input image is from NIST Special Database #.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><command>&lt;outext&gt;</command></term>
  <listitem>
<para>the extension of the reformatted output file.
ªTo construct the output filename, <command>sd_rfmt</command> takes the
input filename and replaces its extension with the one
specified here.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;image file&gt;</emphasis></term>
  <listitem>
<para>the compressed input file to be reformatted.</para>

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

<refsect1 id='examples'><title>EXAMPLES</title>
<para>From <emphasis remap='I'>test/imgtools/execs/sd_rfmt/sd_rfmt.src</emphasis>:</para>
<!-- .RS -->

<!-- .br -->
<para><emphasis remap='B'>% sd_rfmt 7 jpl sd09.old</emphasis>
<!-- .br -->
<emphasis remap='B'>% sd_rfmt 10 jpl sd10.old</emphasis>
<!-- .br -->
<emphasis remap='B'>% sd_rfmt 14 wsq sd14.old</emphasis>
<!-- .br -->
<emphasis remap='B'>% sd_rfmt 18 jpl sd18.old</emphasis>
<!-- .br -->
Convert the special database images to the correct
formatted compressed files (JPEGL and WSQ).  User
could use <emphasis remap='B'>rdjpgcom</emphasis> and <emphasis remap='B'>rdwsqcom</emphasis> to read the
NISTCOM comment that is written in the reformatted output file.
After reformatting the new file can be decompressed with
<emphasis remap='B'>djpegl</emphasis> or <emphasis remap='B'>dwsq</emphasis>.</para>

</refsect1>

<refsect1 id='see_also'><title>SEE ALSO</title>
<para><emphasis remap='B'>djpegl</emphasis>(1D),
<emphasis remap='B'>dwsq</emphasis>(1D),
<emphasis remap='B'>dpyimage</emphasis>(1D),
<emphasis remap='B'>rdjpgcom</emphasis>(1D),
<emphasis remap='B'>rdwsqcom</emphasis>(1D)</para>

</refsect1>

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

