OP_WSQE: Expand WSQ to DIB

See the WSQ:OP_WSQE section for additional information.  Note that OP_WSQE requires that ParmVerMinor be 2.

These codes implement parts of ANSI/NBS-CLS 1-1993, "American National Standard Data Format For The Interchange Of Fingerprint Information.''  Reference "WSQ Gray-scale Fingerprint Image Compression  Specification''  IAFIS-IC-0110v2, 16 Feb 1993 refers to a technical report ( probably written by T. E. Hopper, C. M. Brislawn, and J. N. Bradley) which is available over the internet  as ftp://ftp.c3.lanl.gov/pub/WSQ/documents/wsqSpec2.ps.Z

The Accusoft Corporation implementation of this specification is approved by the FBI and is assigned the FBI implementation number: 54100.

OP_WSQE is used for expanding images compressed by OP_WSQP.

For WSQ images, the bit depth of the output DIB is the same as that of the input compressed image - which is the same as the bit depth of the original source DIB which was compressed.  For WSQ images, the bit depth of the output DIB is 8 bits per pixel gray scale.

StripSize will have been set by OP_WSQE after REQ_INIT is complete.  The Put queue must be at least StripSize bytes in length, and must be a multiple of StripSize.

If PF_Yield is set in u.WSQ.PicFlags then OP_WSQE will return a RES_YIELD response periodically during compression (during REQ_EXEC only).  This would allow an application to update decompression progress reporting, for example.

The decompressed image data is described in either the p.Head member of PIC_PARM or, when the F_RAW switch is set in p.FLAGS, the p.u.WSQ.Region structure is used to describe the data.

OP_WSQE optionally returns comments, application data, watermark or scripts using PIC2List packets. Therefore OP_WSQE requires that ParmVerMinor equals 2.  See the PIC2List section of Accessing Comments and Other Auxiliary Data in the  PICTools and AIMTools Programmer's Guide for more information about how opcodes return PIC2List packets.