JLS_UNION

JLS_UNION: OP_JLSP, OP_JLSE

The JLS_UNION structure supplies parameters to the OP_JLSE and OP_JLSP opcodes used for expanding JPEG-LS images to DIBs and for compressing DIBs to JPEG-LS images, respectively.

	Copy Code
typedef struct { DWORD Reserved0; BYTE PICHUGE* Reserved1; BYTE PICHUGE* Reserved2; BYTE PICHUGE* Reserved3; BYTE PICHUGE* Reserved4; BYTE PICHUGE* Reserved5; BYTE PICHUGE* Reserved6; BYTE PICHUGE* Reserved7; BYTE PICHUGE* Reserved8; PICFLAGS PicFlags; PICFLAGS PicFlags2; REGION Region; LONG ImageWidth; LONG ImageHeight; LONG StripSize; LSSCAN DftScan; } JLS_UNION;

Copy Code

typedef struct {
   DWORD                           Reserved0;
   BYTE PICHUGE*                   Reserved1;
   BYTE PICHUGE*                   Reserved2;
   BYTE PICHUGE*                   Reserved3;
   BYTE PICHUGE*                   Reserved4;
   BYTE PICHUGE*                   Reserved5;
   BYTE PICHUGE*                   Reserved6;
   BYTE PICHUGE*                   Reserved7;
   BYTE PICHUGE*                   Reserved8;
   PICFLAGS                        PicFlags;
   PICFLAGS                        PicFlags2;
   REGION                          Region;
   LONG                            ImageWidth;
   LONG                            ImageHeight;
   LONG                            StripSize;
   LSSCAN                          DftScan;
} JLS_UNION;

Fields:

Name

Description

Reserved0

Reserved1

Reserved2

Reserved3

Reserved4

Reserved5

Reserved6

Reserved7

Reserved8

These fields are not currently used and must be set to 0.

PicFlags

Set the PF_YieldPut flag if the RES_PUT_DATA_YIELD response is desired in OP_JLSE. Set the PF_YieldGet flag if the RES_GET_DATA_YIELD response is desired in OP_JLSP.

Flags that control or report on the opcode operation.

Value	Meaning
PF_YieldGet	If set by the application, OP_JLSP will periodically return RES_GET_DATA_YIELD as it packs the image.
PF_YieldPut	If set by the application, OP_JLSE will periodically return RES_PUT_DATA_YIELD as it expands the image.
PF_BadJAIThresholds	If set by the application, then if the compressed image is the type of 13 to 16 bits per sample image that JAI incorrectly encodes, OP_JLSE will decode the image using the incorrect way of JAI instead of the correct standard way. All other images, whether encoded by JAI or otherwise, will decode correctly. If PF_AutoBadJAIThresholds is set requesting automatic detection and decoding, then OP_JLSE sets or clears this flag to indicate whether it used non-compliant or compliant decoding, respectively. This flag is not needed for images compressed with OP_JLSP.
PF_AutoBadJAIThresholds	If set by the application, then OP_JLSE attempts to automatically detect and correctly decode any 13 to 16 bits per sample image that may have been encoded the incorrect JAI way. All other images, whether encoded by JAI or otherwise, will decode correctly. This flag is not needed for images compressed with OP_JLSP.

PicFlags2

This field is not currently used and must be set to 0.

Region

This field is used to define image characteristics. OP_JLSE returns the image characteristics in this structure in addition to returning them in the PIC_PARM.Head structure. OP_JLSP requires that these be set before the call to REQ_INIT.

ImageWidth

ImageHeight

OP_JLSE returns the full image width and height, as retrieved from the compressed image, in these fields. If cropping to a smaller subrectangle is requested (by setting the appropriate fields in the PIC_PARM structure), these values will differ from the width and height returned in the Region field and the PIC_PARM.Head structure. These fields are not used by OP_JLSP.

StripSize

Following REQ_INIT, this is set to the size of one input strip. The Put queue buffer must be large enough to hold at least one strip.

DftScan

Compression settings for all scans. See LSSCAN.