NAME

       enc_jpeg2000.c - Encodes JPEG2000 code stream.

SYNOPSIS

       #include <stdio.h>
       #include <stdlib.h>
       #include 'grib2.h'
       #include 'jasper/jasper.h'

   Macros
       #define JAS_1_700_2
           Define for JAS.
       #define MAXOPTSSIZE   1024
           Maximum size of options.

   Functions
       int enc_jpeg2000 (unsigned char *cin, g2int width, g2int height, g2int nbits, g2int ltype,
           g2int ratio, g2int retry, char *outjpc, g2int jpclen)
           This Function encodes a grayscale image into a JPEG2000 code stream specified in the
           JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software version 1.500.4
           (or 1.700.2) written by the University of British Columbia, Image Power Inc, and
           others.

Detailed Description

       Encodes JPEG2000 code stream.

       Author
           Stephen Gilbert

       Date
           2002-12-02

       Definition in file enc_jpeg2000.c.

Macro Definition Documentation

   #define JAS_1_700_2
       Define for JAS.

       Definition at line 13 of file enc_jpeg2000.c.

   #define MAXOPTSSIZE   1024
       Maximum size of options.

       Definition at line 14 of file enc_jpeg2000.c.

Function Documentation

   int enc_jpeg2000 (unsigned char * cin, g2int width, g2int height, g2int nbits, g2int ltype,
       g2int ratio, g2int retry, char * outjpc, g2int jpclen)
       This Function encodes a grayscale image into a JPEG2000 code stream specified in the
       JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software version 1.500.4 (or
       1.700.2) written by the University of British Columbia, Image Power Inc, and others.
       JasPer is available at http://www.ece.uvic.ca/~mdadams/jasper/.

       PROGRAM HISTORY LOG:

       • 2002-12-02 Gilbert

       • 2004-12-16 Gilbert - Added retry argument/option to allow option of increasing the
         maximum number of guard bits to the JPEG2000 algorithm.

       Parameters
           cin Packed matrix of Grayscale image values to encode.
           width width of image.
           height height of image.
           nbits depth (in bits) of image. i.e number of bits used to hold each data value.
           ltype indicator of lossless or lossy compression.

           • 1, for lossy compression

           • != 1, for lossless compression

           ratio target compression ratio. (ratio:1) Used only when ltype == 1.
           retry Pointer to option type. If 1 try increasing number of guard bits otherwise, no
           additional options.
           outjpc Output encoded JPEG2000 code stream.
           jpclen Number of bytes allocated for new JPEG2000 code stream in outjpc.

       Returns

           • > 0 = Length in bytes of encoded JPEG2000 code stream

           • -3 = Error decode jpeg2000 code stream.

           • -5 = decoded image had multiple color components. Only grayscale is expected.

       Note
           Requires JasPer Software version 1.500.4 or 1.700.2.

       Author
           Stephen Gilbert

       Date
           2002-12-02

       Definition at line 56 of file enc_jpeg2000.c.

       References MAXOPTSSIZE.

       Referenced by jpcpack().

Author

       Generated automatically by Doxygen for NCEPLIBS-g2c from the source code.