Man page - int_dec_jpeg2000(3)

Packages contains this manual

Manual

decenc_jpeg2000.c

NAME
SYNOPSIS
Macros
Functions
Detailed Description
Macro Definition Documentation
#define MAXOPTSSIZE 1024
Function Documentation
int dec_jpeg2000 (char * injpc, g2int bufsize, g2int * outfld)
int enc_jpeg2000 (unsigned char * cin, g2int width, g2int height, g2intnbits, g2int ltype, g2int ratio, g2int retry, char * outjpc, g2intjpclen)
int g2c_dec_jpeg2000 (char * injpc, size_t bufsize, int * outfld)
int g2c_enc_jpeg2000 (unsigned char * cin, int width, int height, intnbits, int ltype, int ratio, int retry, char * outjpc, size_t jpclen)
static int int_dec_jpeg2000 (char * injpc, g2int bufsize, void * outfld,int out_is_g2int) [static]
Author

NAME

decenc_jpeg2000.c - Decode/encode a JPEG2000 code stream.

SYNOPSIS

#include ’grib2_int.h’
#include ’jasper/jasper.h’
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

Macros

#define MAXOPTSSIZE 1024
Maximum size of options.

Functions

int dec_jpeg2000 (char *injpc, g2int bufsize, g2int *outfld)
Decode a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .
int enc_jpeg2000 (unsigned char *cin, g2int width, g2int height, g2int nbits, g2int ltype, g2int ratio, g2int retry, char *outjpc, g2int jpclen)
Encode a grayscale image into a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .
int g2c_dec_jpeg2000 (char *injpc, size_t bufsize, int *outfld)
Decode a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .
int g2c_enc_jpeg2000 (unsigned char *cin, int width, int height, int nbits, int ltype, int ratio, int retry, char *outjpc, size_t jpclen)
Encode a grayscale image into a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .
static int int_dec_jpeg2000 (char *injpc, g2int bufsize, void *outfld, int out_is_g2int)
Decode a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .

Detailed Description

Decode/encode a JPEG2000 code stream.

Author

Alyson Stahl

Date

2024-14-08

Definition in file decenc_jpeg2000.c .

Macro Definition Documentation

#define MAXOPTSSIZE 1024

Maximum size of options.

Definition at line 12 of file decenc_jpeg2000.c .

Function Documentation

int dec_jpeg2000 (char * injpc, g2int bufsize, g2int * outfld)

Decode a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .

Parameters

injpc Pointer to buffer that holds the input JPEG2000 code stream.
bufsize
Length (in bytes) of the buffer that holds the input JPEG2000 code stream.
outfld
Pointer to g2int array, already allocated, that gets the unpacked data.

Returns

0 Successful decode

G2_JASPER_DECODE Error decode jpeg2000 code stream.

G2_JASPER_DECODE_COLOR decoded image had multiple color components. Only grayscale is expected.

G2_JASPER_INIT Error inializing Jasper library.

Author

Stephen Gilbert, Ed Hartnett

Definition at line 377 of file decenc_jpeg2000.c .

References int_dec_jpeg2000() .

Referenced by jpcunpack_int() .

int enc_jpeg2000 (unsigned char * cin, g2int width, g2int height, g2intnbits, g2int ltype, g2int ratio, g2int retry, char * outjpc, g2intjpclen)

Encode a grayscale image into a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .

### Program History Log Date Programmer Comments 2002-12-02 Gilbert Initial 2004-12-16 Gilbert Added retry argument allowing increased guard bits. 2022-04-15 Hartnett Converted to use jas_ instead of jpc_ functions.

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
If 1 try increasing number of guard bits.
outjpc
Output encoded JPEG2000 code stream.
jpclen
Number of bytes allocated for the output JPEG2000 code stream in outjpc.

Returns

> 0 = Length in bytes of encoded JPEG2000 code stream

G2_JASPER_INIT Error initializing jasper library.

G2_JASPER_ENCODE Error encode jpeg2000 code stream.

Note

Requires JasPer Software version 1.500.4 or 1.700.2 or later.

Author

Stephen Gilbert

Date

2002-12-02

Author

Ed Hartnett

Definition at line 94 of file decenc_jpeg2000.c .

References G2_JASPER_ENCODE , G2_JASPER_INIT , G2C_JASPER_JPEG_FORMAT_NAME , LOG , and MAXOPTSSIZE .

Referenced by g2c_enc_jpeg2000() , and jpcpack_int() .

int g2c_dec_jpeg2000 (char * injpc, size_t bufsize, int * outfld)

Decode a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .

Parameters

injpc Pointer to buffer that holds the input JPEG2000 code stream.
bufsize
Length (in bytes) of the buffer that holds the input JPEG2000 code stream.
outfld
Pointer to int array, already allocated, that gets the unpacked data.

Returns

G2C_NOERROR No error.

G2_JASPER_DECODE Error decode jpeg2000 code stream.

G2_JASPER_DECODE_COLOR decoded image had multiple color components. Only grayscale is expected.

G2_JASPER_INIT Error inializing Jasper library.

Author

Ed Hartnett

Date

9/7/22

Definition at line 350 of file decenc_jpeg2000.c .

References int_dec_jpeg2000() .

int g2c_enc_jpeg2000 (unsigned char * cin, int width, int height, intnbits, int ltype, int ratio, int retry, char * outjpc, size_t jpclen)

Encode a grayscale image into a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .

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
If 1 try increasing number of guard bits.
outjpc
Output encoded JPEG2000 code stream.
jpclen
Number of bytes allocated for the output JPEG2000 code stream in outjpc.

Returns

> 0 = Length in bytes of encoded JPEG2000 code stream

G2_JASPER_INIT Error initializing jasper library.

G2_JASPER_ENCODE Error encode jpeg2000 code stream.

Note

Requires JasPer Software version 1.500.4 or 1.700.2 or later.

Author

Stephen Gilbert

Date

2002-12-02

Author

Ed Hartnett

Definition at line 45 of file decenc_jpeg2000.c .

References enc_jpeg2000() .

static int int_dec_jpeg2000 (char * injpc, g2int bufsize, void * outfld,int out_is_g2int) [static]

Decode a JPEG2000 code stream specified in the JPEG2000 Part-1 standard (i.e., ISO/IEC 15444-1) using JasPer Software .

Parameters

injpc Pointer to buffer that holds the input JPEG2000 code stream.
bufsize
Length (in bytes) of the buffer that holds the input JPEG2000 code stream.
outfld
Pointer to either int or g2int array, already allocated, that gets the unpacked data.
out_is_g2int
Non-zero if the output array is of type g2int (i.e. 64-bit ints), zero if output is an int array (32-bits).

Returns

0 Successful decode

G2_JASPER_DECODE Error decode jpeg2000 code stream.

G2_JASPER_DECODE_COLOR decoded image had multiple color components. Only grayscale is expected.

G2_JASPER_INIT Error inializing Jasper library.

Author

Stephen Gilbert

Date

2002-12-02

Author

Ed Hartnett

Eric Engle

Definition at line 221 of file decenc_jpeg2000.c .

References G2_JASPER_DECODE , G2_JASPER_DECODE_COLOR , G2_JASPER_INIT , G2C_JASPER_JPEG_FORMAT_NAME , G2C_JASPER_MAX_MEM , and LOG .

Referenced by dec_jpeg2000() , and g2c_dec_jpeg2000() .

Author

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