]> Creatis software - gdcm.git/blob - src/gdcmopenjpeg/libopenjpeg/j2k.h
ENH: A user does not know (and should not) what we internally use for representing...
[gdcm.git] / src / gdcmopenjpeg / libopenjpeg / j2k.h
1 /*
2  * Copyright (c) 2001-2002, David Janssens
3  * Copyright (c) 2002-2003, Yannick Verschueren
4  * Copyright (c) 2002-2003,  Communications and remote sensing Laboratory, Universite catholique de Louvain, Belgium
5  * All rights reserved. 
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
17  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
20  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26  * POSSIBILITY OF SUCH DAMAGE.
27  */
28
29 #define VERSION "0.0.9"
30
31 #if defined(_WIN32) && defined (OPENJPEGDLL)
32 #ifdef gdcmopenjpeg_EXPORTS /*LIBJ2K_EXPORTS*/
33 #define LIBJ2K_API __declspec(dllexport)
34 #else
35 #define LIBJ2K_API __declspec(dllimport)
36 #endif
37 #else
38 #ifdef OPENJPEGSTATIC
39 #define LIBJ2K_API extern
40 #else
41 #define LIBJ2K_API
42 #endif
43 #endif
44
45
46 #ifndef __J2K_H
47 #define __J2K_H
48
49 #define J2K_MAXRLVLS 33      /* Number of maximum resolution level authorized                   */
50 #define J2K_MAXBANDS (3*J2K_MAXRLVLS-2)   /* Number of maximum sub-band linked to number of resolution level */
51 #define J2K_CFMT 0
52 #define JP2_CFMT 1
53 #define JPT_CFMT 2
54 #define MJ2_CFMT 3
55 #define PXM_DFMT 0
56 #define PGX_DFMT 1
57 #define BMP_DFMT 2
58 #define YUV_DFMT 3
59
60 #define J2K_CP_CSTY_PRT 0x01
61 #define J2K_CP_CSTY_SOP 0x02
62 #define J2K_CP_CSTY_EPH 0x04
63 #define J2K_CCP_CSTY_PRT 0x01
64 #define J2K_CCP_CBLKSTY_LAZY 0x01
65 #define J2K_CCP_CBLKSTY_RESET 0x02
66 #define J2K_CCP_CBLKSTY_TERMALL 0x04
67 #define J2K_CCP_CBLKSTY_VSC 0x08
68 #define J2K_CCP_CBLKSTY_PTERM 0x10
69 #define J2K_CCP_CBLKSTY_SEGSYM 0x20
70 #define J2K_CCP_QNTSTY_NOQNT 0
71 #define J2K_CCP_QNTSTY_SIQNT 1
72 #define J2K_CCP_QNTSTY_SEQNT 2
73
74 typedef struct {
75   int dx, dy;         /* XRsiz, YRsiz              */
76   int w, h;         /* width and height of data  */
77   int x0, y0;         /* offset of the component compare to the whole image  */
78   int prec;         /* precision                 */
79   int bpp;         /* deapth of image in bits   */
80   int sgnd;         /* signed                    */
81   int resno_decoded;      /* number of decoded resolution */
82   int factor;         /* number of division by 2 of the out image  compare to the original size of image */
83   int *data;         /* image-component data      */
84 } j2k_comp_t;
85
86 typedef struct {
87   int x0, y0;         /* XOsiz, YOsiz              */
88   int x1, y1;         /* Xsiz, Ysiz                */
89   int numcomps;         /* number of components      */
90   int color_space;      /* sRGB, Greyscale or YUV */
91   j2k_comp_t *comps;      /* image-components          */
92 } j2k_image_t;
93
94 typedef struct {
95   int expn;         /* exponent                  */
96   int mant;         /* mantissa                  */
97 } j2k_stepsize_t;
98
99 typedef struct {
100   int csty;         /* coding style                          */
101   int numresolutions;      /* number of resolutions                 */
102   int cblkw;         /* width of code-blocks                  */
103   int cblkh;         /* height of code-blocks                 */
104   int cblksty;         /* code-block coding style               */
105   int qmfbid;         /* discrete wavelet transform identifier */
106   int qntsty;         /* quantisation style                    */
107   j2k_stepsize_t stepsizes[J2K_MAXBANDS];   /* stepsizes used for quantization       */
108   int numgbits;         /* number of guard bits                  */
109   int roishift;         /* Region Of Interest shift              */
110   int prcw[J2K_MAXRLVLS];   /* Precinct width                        */
111   int prch[J2K_MAXRLVLS];   /* Precinct height                       */
112 } j2k_tccp_t;
113
114 typedef struct {
115   int resno0, compno0;
116   int layno1, resno1, compno1;
117   int prg;
118   int tile;
119   char progorder[4];
120 } j2k_poc_t;
121
122 typedef struct {
123   int first;         /* 1 : first part-tile of a tile                                     */
124   int csty;         /* coding style                                                      */
125   int prg;         /* progression order                                                 */
126   int numlayers;      /* number of layers                                                  */
127   int mct;         /* multi-component transform identifier                              */
128   int rates[100];      /* rates of layers                                                   */
129   int numpocs;         /* number of progression order changes                               */
130   int POC;         /* Precise if a POC marker has been used O:NO, 1:YES                 */
131   j2k_poc_t pocs[32];      /* progression order changes                                         */
132   unsigned char *ppt_data;   /* packet header store there for futur use in t2_decode_packet       */
133   unsigned char *ppt_data_first;   /* pointer remaining on the first byte of the first header if ppt is used */
134   int ppt;         /* If ppt == 1 --> there was a PPT marker for the present tile       */
135   int ppt_store;      /* Use in case of multiple marker PPT (number of info already store) */
136   int ppt_len;         /* ppmbug1 */
137   float distoratio[100];   /* add fixed_quality */
138   j2k_tccp_t *tccps;      /* tile-component coding parameters                                  */
139 } j2k_tcp_t;
140
141 typedef struct {
142   int intermed_file;      /* 1: Store each encoded tile one by one in the output file (for mega-Images)*/
143   int decod_format;      /* 0: PGX, 1: PxM, 2: BMP */
144   int cod_format;      /* 0: J2K, 1: JP2, 2: JPT */
145   int disto_alloc;      /* Allocation by rate/distortion     */
146   int fixed_alloc;      /* Allocation by fixed layer         */
147   int fixed_quality;      /* add fixed_quality */
148   int reduce;         /* if != 0, then original dimension divided by 2^(reduce); if == 0 or not used, image is decoded to the full resolution */
149   int layer;         /* if != 0, then only the first "layer" layers are decoded; if == 0 or not used, all the quality layers are decoded */
150   int index_on;         /* 0 = no index || 1 = index */
151   int tx0, ty0;         /* XTOsiz, YTOsiz                    */
152   int tdx, tdy;         /* XTsiz, YTsiz                      */
153   char *comment;      /* comment for coding                */
154   int tw, th;         /* number of tiles in width and heigth */
155   int *tileno;         /* ID number of the tiles present in the codestream */
156   int tileno_size;      /* size of the vector tileno */
157   unsigned char *ppm_data;   /* packet header store there for futur use in t2_decode_packet             */
158   unsigned char *ppm_data_first;   /* pointer remaining on the first byte of the first header if ppm is used */
159   int ppm;         /* If ppm == 1 --> there was a PPM marker for the present tile             */
160   int ppm_store;      /* Use in case of multiple marker PPM (number of info already store)       */
161   int ppm_previous;      /* Use in case of multiple marker PPM (case on non-finished previous info) */
162   int ppm_len;         /* ppmbug1 */
163   j2k_tcp_t *tcps;      /* tile coding parameters                                                  */
164   int *matrice;         /* Fixed layer                                                             */
165 } j2k_cp_t;
166
167 typedef struct {
168   int start_pos, end_pos;   /* start and end position            */
169   double disto;         /* ADD for Marcela                   */
170 } info_packet;         /* Index struct                      */
171
172 typedef struct {
173   double *thresh;      /* value of thresh for each layer by tile cfr. Marcela   */
174   int num_tile;         /* Number of Tile                                        */
175   int start_pos;      /* Start position                                        */
176   int end_header;      /* End position of the header                            */
177   int end_pos;         /* End position                                          */
178   int pw[33], ph[33];      /* precinct number for each resolution level             */
179
180   int pdx[33], pdy[33];      /* precinct size (in power of 2), in X and Y for each resolution level */
181   info_packet *packet;      /* information concerning packets inside tile            */
182   int nbpix;         /* add fixed_quality                                     */
183   double distotile;      /* add fixed_quality                                     */
184 } info_tile;         /* index struct                                          */
185
186 typedef struct {
187   int index_on;
188   double D_max;         /* ADD for Marcela                                       */
189   int num;         /* numero of packet                                      */
190   int index_write;      /* writing the packet inthe index with t2_encode_packets */
191   int Im_w, Im_h;      /* Image width and Height                                */
192   int Prog;         /* progression order                                     */
193   int Tile_x, Tile_y;      /* Tile size in x and y                                  */
194   int Tile_Ox, Tile_Oy;
195   int tw, th;         /* Number of Tile in X and Y                             */
196   int Comp;         /* Component numbers                                     */
197   int Layer;         /* number of layer                                       */
198   int Decomposition;      /* number of decomposition                               */
199   int Main_head_end;      /* Main header position                                  */
200   int codestream_size;      /* codestream's size                                     */
201   info_tile *tile;      /* information concerning tiles inside image             */
202 } info_image;         /* index struct                                          */
203
204 /* 
205  * Encode an image into a JPEG-2000 codestream
206  * i: image to encode
207  * cp: coding parameters
208  * output: destination buffer or name of the output file when cp->intermed_file==1
209  * len: length of destination buffer
210  * index : index file name
211  */
212 LIBJ2K_API int j2k_encode(j2k_image_t * i, j2k_cp_t * cp, char *output,
213            int len, char *index);
214
215 /* LIBJ2K_API int j2k_encode(j2k_image_t *i, j2k_cp_t *cp,unsigned char *dest, int len); */
216 /*
217  * Decode an image from a JPEG-2000 codestream
218  * src: source buffer
219  * len: length of source buffer
220  * i: decode image
221  * cp: coding parameters that were used to encode the image
222  */
223
224 LIBJ2K_API int j2k_decode(unsigned char *src, int len, j2k_image_t * img,
225            j2k_cp_t * cp);
226
227
228 /*
229  * Decode an image form a JPT-stream (JPEG 2000, JPIP)
230  * src: source buffer
231  * len: length of source buffer
232  * i: decode image
233  * cp: coding parameters that were used to encode the image
234  *
235  */
236 int j2k_decode_jpt_stream(unsigned char *src, int len, j2k_image_t * img,
237            j2k_cp_t * cp);
238
239 LIBJ2K_API void j2k_dec_release();/*antonin*/
240
241 #endif