OpenJPEG  2.2.0
jp2.h
Go to the documentation of this file.
1 /*
2  * The copyright in this software is being made available under the 2-clauses
3  * BSD License, included below. This software may be subject to other third
4  * party and contributor rights, including patent rights, and no such rights
5  * are granted under this license.
6  *
7  * Copyright (c) 2002-2014, Universite catholique de Louvain (UCL), Belgium
8  * Copyright (c) 2002-2014, Professor Benoit Macq
9  * Copyright (c) 2002-2003, Yannick Verschueren
10  * Copyright (c) 2005, Herve Drolon, FreeImage Team
11  * Copyright (c) 2008, 2011-2012, Centre National d'Etudes Spatiales (CNES), FR
12  * Copyright (c) 2012, CS Systemes d'Information, France
13  * All rights reserved.
14  *
15  * Redistribution and use in source and binary forms, with or without
16  * modification, are permitted provided that the following conditions
17  * are met:
18  * 1. Redistributions of source code must retain the above copyright
19  * notice, this list of conditions and the following disclaimer.
20  * 2. Redistributions in binary form must reproduce the above copyright
21  * notice, this list of conditions and the following disclaimer in the
22  * documentation and/or other materials provided with the distribution.
23  *
24  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
25  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
28  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34  * POSSIBILITY OF SUCH DAMAGE.
35  */
36 #ifndef OPJ_JP2_H
37 #define OPJ_JP2_H
38 
46 
47 /*#define JPIP_JPIP 0x6a706970*/
48 
49 #define JP2_JP 0x6a502020
50 #define JP2_FTYP 0x66747970
51 #define JP2_JP2H 0x6a703268
52 #define JP2_IHDR 0x69686472
53 #define JP2_COLR 0x636f6c72
54 #define JP2_JP2C 0x6a703263
55 #define JP2_URL 0x75726c20
56 #define JP2_PCLR 0x70636c72
57 #define JP2_CMAP 0x636d6170
58 #define JP2_CDEF 0x63646566
59 #define JP2_DTBL 0x6474626c
60 #define JP2_BPCC 0x62706363
61 #define JP2_JP2 0x6a703220
63 /* For the future */
64 /* #define JP2_RES 0x72657320 */
65 /* #define JP2_JP2I 0x6a703269 */
66 /* #define JP2_XML 0x786d6c20 */
67 /* #define JP2_UUID 0x75756994 */
68 /* #define JP2_UINF 0x75696e66 */
69 /* #define JP2_ULST 0x756c7374 */
71 /* ----------------------------------------------------------------------- */
72 
73 typedef enum {
80  JP2_STATE_UNKNOWN = 0x7fffffff /* ISO C restricts enumerator values to range of 'int' */
81 }
82 JP2_STATE;
83 
84 typedef enum {
86  JP2_IMG_STATE_UNKNOWN = 0x7fffffff
87 }
89 
93 typedef struct opj_jp2_cdef_info {
96 
100 typedef struct opj_jp2_cdef {
104 
108 typedef struct opj_jp2_cmap_comp {
112 
116 typedef struct opj_jp2_pclr {
124 
128 typedef struct opj_jp2_color {
131 
136 
140 typedef struct opj_jp2_comps {
145 
149 typedef struct opj_jp2 {
156 
157  /* width of image */
159  /* height of image */
161  /* number of components in the image */
176  /* FIXME: The following two variables are used to save offset
177  as we write out a JP2 file to disk. This mechanism is not flexible
178  as codec writers will need to extand those fields as new part
179  of the standard are implemented.
180  */
186 
188 
192 }
193 opj_jp2_t;
194 
198 typedef struct opj_jp2_box {
202 } opj_jp2_box_t;
203 
204 typedef struct opj_jp2_header_handler {
205  /* marker value */
207  /* action linked to the marker */
209  OPJ_BYTE *p_header_data,
210  OPJ_UINT32 p_header_size,
211  opj_event_mgr_t * p_manager);
212 }
214 
215 
217  /* action to perform */
218  OPJ_BYTE* (*handler)(opj_jp2_t *jp2, OPJ_UINT32 * p_data_size);
219  /* result of the action : data */
221  /* size of data */
223 }
225 
228 /* ----------------------------------------------------------------------- */
229 
236 void opj_jp2_setup_decoder(opj_jp2_t *jp2, opj_dparameters_t *parameters);
237 
239 
250  opj_stream_private_t *p_stream,
251  opj_image_t* p_image,
252  opj_event_mgr_t * p_manager);
253 
265  opj_cparameters_t *parameters,
266  opj_image_t *image,
267  opj_event_mgr_t * p_manager);
268 
277  opj_stream_private_t *stream,
278  opj_event_mgr_t * p_manager);
279 
280 
292  opj_stream_private_t *stream,
293  opj_image_t * p_image,
294  opj_event_mgr_t * p_manager);
295 
296 
303  opj_event_mgr_t * p_manager);
304 
305 /* ----------------------------------------------------------------------- */
306 
313  opj_event_mgr_t * p_manager);
314 
326  opj_jp2_t *jp2,
327  opj_image_t ** p_image,
328  opj_event_mgr_t * p_manager);
329 
345  OPJ_UINT32 * p_tile_index,
346  OPJ_UINT32 * p_data_size,
347  OPJ_INT32 * p_tile_x0,
348  OPJ_INT32 * p_tile_y0,
349  OPJ_INT32 * p_tile_x1,
350  OPJ_INT32 * p_tile_y1,
351  OPJ_UINT32 * p_nb_comps,
352  OPJ_BOOL * p_go_on,
353  opj_stream_private_t *p_stream,
354  opj_event_mgr_t * p_manager);
355 
367  OPJ_UINT32 p_tile_index,
368  OPJ_BYTE * p_data,
369  OPJ_UINT32 p_data_size,
370  opj_stream_private_t *p_stream,
371  opj_event_mgr_t * p_manager);
372 
385  OPJ_UINT32 p_tile_index,
386  OPJ_BYTE * p_data,
387  OPJ_UINT32 p_data_size,
388  opj_stream_private_t *p_stream,
389  opj_event_mgr_t * p_manager);
390 
396 opj_jp2_t* opj_jp2_create(OPJ_BOOL p_is_decoder);
397 
402 void opj_jp2_destroy(opj_jp2_t *jp2);
403 
404 
419  opj_image_t* p_image,
420  OPJ_INT32 p_start_x, OPJ_INT32 p_start_y,
421  OPJ_INT32 p_end_x, OPJ_INT32 p_end_y,
422  opj_event_mgr_t * p_manager);
423 
428  opj_stream_private_t *p_stream,
429  opj_image_t* p_image,
430  opj_event_mgr_t * p_manager,
431  OPJ_UINT32 tile_index);
432 
433 
438  OPJ_UINT32 res_factor,
439  opj_event_mgr_t * p_manager);
440 
441 
442 /* TODO MSD: clean these 3 functions */
451 void jp2_dump(opj_jp2_t* p_jp2, OPJ_INT32 flag, FILE* out_stream);
452 
461 
470 
471 
475 
476 #endif /* OPJ_JP2_H */
477 
OPJ_UINT32 numcomps
Definition: jp2.h:162
JPEG-2000 file format reader/writer.
Definition: jp2.h:149
struct opj_procedure_list * m_validation_list
list of validation procedures
Definition: jp2.h:153
struct opj_jp2_cmap_comp opj_jp2_cmap_comp_t
Component mappings: channel index, mapping type, palette index.
int64_t OPJ_OFF_T
Definition: openjpeg.h:130
OPJ_UINT32 bpcc
Definition: jp2.h:143
Definition: jp2.h:204
OPJ_BOOL jpip_on
Definition: jp2.h:183
OPJ_OFF_T jpip_iptr_offset
Definition: jp2.h:182
opj_jp2_comps_t * comps
Definition: jp2.h:175
struct opj_procedure_list * m_procedure_list
list of execution procedures
Definition: jp2.h:155
Message handler object used for.
Definition: event.h:50
struct opj_jp2_color opj_jp2_color_t
Collector for ICC profile, palette, component mapping, channel description.
OPJ_UINT32 icc_profile_len
Definition: jp2.h:130
OPJ_UINT16 asoc
Definition: jp2.h:94
OPJ_BYTE has_jp2h
Definition: jp2.h:190
int OPJ_BOOL
Definition: openjpeg.h:110
OPJ_BOOL opj_jp2_encode(opj_jp2_t *jp2, opj_stream_private_t *stream, opj_event_mgr_t *p_manager)
Encode an image into a JPEG-2000 file stream.
Definition: jp2.c:2085
JPEG-2000 codestream reader/writer.
Definition: j2k.h:539
OPJ_BOOL opj_jp2_write_tile(opj_jp2_t *p_jp2, OPJ_UINT32 p_tile_index, OPJ_BYTE *p_data, OPJ_UINT32 p_data_size, opj_stream_private_t *p_stream, opj_event_mgr_t *p_manager)
Writes a tile.
Definition: jp2.c:2972
OPJ_UINT32 length
Definition: jp2.h:199
OPJ_UINT32 id
Definition: jp2.h:206
Byte input-output stream.
Definition: cio.h:81
OPJ_BYTE * channel_size
Definition: jp2.h:119
unsigned char OPJ_BYTE
Definition: openjpeg.h:117
OPJ_BOOL opj_jp2_read_tile_header(opj_jp2_t *p_jp2, OPJ_UINT32 *p_tile_index, OPJ_UINT32 *p_data_size, OPJ_INT32 *p_tile_x0, OPJ_INT32 *p_tile_y0, OPJ_INT32 *p_tile_x1, OPJ_INT32 *p_tile_y1, OPJ_UINT32 *p_nb_comps, OPJ_BOOL *p_go_on, opj_stream_private_t *p_stream, opj_event_mgr_t *p_manager)
Reads a tile header.
Definition: jp2.c:2948
OPJ_BYTE * channel_sign
Definition: jp2.h:118
OPJ_UINT32 numcl
Definition: jp2.h:173
opj_jp2_t * opj_jp2_create(OPJ_BOOL p_is_decoder)
Creates a jpeg2000 file decompressor.
Definition: jp2.c:3144
JP2 Box.
Definition: jp2.h:198
opj_jp2_cdef_info_t * info
Definition: jp2.h:101
OPJ_UINT32 w
Definition: jp2.h:158
Definition: jp2.h:86
OPJ_UINT16 cn
Definition: jp2.h:94
OPJ_UINT32 IPR
Definition: jp2.h:166
OPJ_UINT32 depth
Definition: jp2.h:141
uint16_t OPJ_UINT16
Definition: openjpeg.h:124
struct opj_jp2_img_header_writer_handler opj_jp2_img_header_writer_handler_t
OPJ_BOOL opj_jp2_decode_tile(opj_jp2_t *p_jp2, OPJ_UINT32 p_tile_index, OPJ_BYTE *p_data, OPJ_UINT32 p_data_size, opj_stream_private_t *p_stream, opj_event_mgr_t *p_manager)
Decode tile data.
Definition: jp2.c:2985
struct opj_jp2_cdef opj_jp2_cdef_t
Channel descriptions and number of descriptions.
OPJ_BOOL(* handler)(opj_jp2_t *jp2, OPJ_BYTE *p_header_data, OPJ_UINT32 p_header_size, opj_event_mgr_t *p_manager)
Definition: jp2.h:208
int32_t OPJ_INT32
Definition: openjpeg.h:125
Information structure about the codestream (FIXME should be expand and enhance)
Definition: openjpeg.h:919
OPJ_BYTE mtyp
Definition: jp2.h:110
OPJ_BOOL opj_jp2_set_decoded_resolution_factor(opj_jp2_t *p_jp2, OPJ_UINT32 res_factor, opj_event_mgr_t *p_manager)
Definition: jp2.c:3206
struct opj_jp2_comps opj_jp2_comps_t
JP2 component.
OPJ_BOOL opj_jp2_setup_encoder(opj_jp2_t *jp2, opj_cparameters_t *parameters, opj_image_t *image, opj_event_mgr_t *p_manager)
Setup the encoder parameters using the current image and using user parameters.
Definition: jp2.c:1898
OPJ_UINT32 type
Definition: jp2.h:200
OPJ_BOOL opj_jp2_end_decompress(opj_jp2_t *jp2, opj_stream_private_t *cio, opj_event_mgr_t *p_manager)
Ends the decompression procedures and possibiliy add data to be read after the codestream.
Definition: jp2.c:2092
opj_jp2_cdef_t * jp2_cdef
Definition: jp2.h:132
opj_j2k_t * j2k
handle to the J2K codec
Definition: jp2.h:151
OPJ_UINT32 * entries
Definition: jp2.h:117
OPJ_BOOL opj_jp2_set_threads(opj_jp2_t *jp2, OPJ_UINT32 num_threads)
Definition: jp2.c:1889
OPJ_BYTE has_ihdr
Definition: jp2.h:191
OPJ_UINT32 minversion
Definition: jp2.h:172
OPJ_OFF_T j2k_codestream_offset
Definition: jp2.h:181
OPJ_BYTE nr_channels
Definition: jp2.h:122
OPJ_BOOL opj_jp2_set_decode_area(opj_jp2_t *p_jp2, opj_image_t *p_image, OPJ_INT32 p_start_x, OPJ_INT32 p_start_y, OPJ_INT32 p_end_x, OPJ_INT32 p_end_y, opj_event_mgr_t *p_manager)
Sets the given area to be decoded.
Definition: jp2.c:3065
Defines image data and characteristics.
Definition: openjpeg.h:666
OPJ_UINT16 typ
Definition: jp2.h:94
OPJ_UINT32 jp2_state
Definition: jp2.h:184
Definition: jp2.h:74
OPJ_BOOL ignore_pclr_cmap_cdef
Definition: jp2.h:189
Decompression parameters.
Definition: openjpeg.h:509
Collector for ICC profile, palette, component mapping, channel description.
Definition: jp2.h:128
OPJ_BOOL opj_jp2_read_header(opj_stream_private_t *p_stream, opj_jp2_t *jp2, opj_image_t **p_image, opj_event_mgr_t *p_manager)
Reads a jpeg2000 file header structure.
Definition: jp2.c:2820
OPJ_UINT32 precedence
Definition: jp2.h:170
A list of procedures.
Definition: function_list.h:57
OPJ_UINT32 jp2_img_state
Definition: jp2.h:185
OPJ_BOOL opj_jp2_start_compress(opj_jp2_t *jp2, opj_stream_private_t *stream, opj_image_t *p_image, opj_event_mgr_t *p_manager)
Starts a compression scheme, i.e.
Definition: jp2.c:2443
OPJ_BYTE * icc_profile_buf
Definition: jp2.h:129
OPJ_UINT32 m_size
Definition: jp2.h:222
OPJ_BYTE pcol
Definition: jp2.h:110
void opj_jp2_setup_decoder(opj_jp2_t *jp2, opj_dparameters_t *parameters)
Setup the decoder decoding parameters using user parameters.
Definition: jp2.c:1878
OPJ_BOOL opj_jp2_decode(opj_jp2_t *jp2, opj_stream_private_t *p_stream, opj_image_t *p_image, opj_event_mgr_t *p_manager)
Decode an image from a JPEG-2000 file stream.
Definition: jp2.c:1587
OPJ_UINT32 approx
Definition: jp2.h:168
OPJ_UINT16 nr_entries
Definition: jp2.h:121
struct opj_jp2 opj_jp2_t
JPEG-2000 file format reader/writer.
OPJ_INT32 init_pos
Definition: jp2.h:201
Definition: jp2.h:79
OPJ_UINT32 C
Definition: jp2.h:164
struct opj_jp2_pclr opj_jp2_pclr_t
Palette data: table entries, palette columns.
struct opj_jp2_box opj_jp2_box_t
JP2 Box.
Component mappings: channel index, mapping type, palette index.
Definition: jp2.h:108
OPJ_BYTE * m_data
Definition: jp2.h:220
opj_codestream_index_t * jp2_get_cstr_index(opj_jp2_t *p_jp2)
Get the codestream index from a JPEG2000 codec.
Definition: jp2.c:3196
opj_jp2_pclr_t * jp2_pclr
Definition: jp2.h:133
OPJ_UINT16 n
Definition: jp2.h:102
Index structure of the codestream (FIXME should be expand and enhance)
Definition: openjpeg.h:994
OPJ_UINT32 enumcs
Definition: jp2.h:169
Definition: jp2.h:80
Definition: jp2.h:78
opj_codestream_info_v2_t * jp2_get_cstr_info(opj_jp2_t *p_jp2)
Get the codestream info from a JPEG2000 codec.
Definition: jp2.c:3201
OPJ_UINT32 UnkC
Definition: jp2.h:165
void opj_jp2_destroy(opj_jp2_t *jp2)
Destroy a JP2 decompressor handle.
Definition: jp2.c:2997
opj_jp2_color_t color
Definition: jp2.h:187
uint32_t OPJ_UINT32
Definition: openjpeg.h:126
OPJ_UINT32 bpc
Definition: jp2.h:163
Palette data: table entries, palette columns.
Definition: jp2.h:116
struct opj_jp2_header_handler opj_jp2_header_handler_t
OPJ_UINT32 h
Definition: jp2.h:160
opj_jp2_cmap_comp_t * cmap
Definition: jp2.h:120
Compression parameters.
Definition: openjpeg.h:353
OPJ_UINT32 brand
Definition: jp2.h:171
OPJ_BOOL opj_jp2_get_tile(opj_jp2_t *p_jp2, opj_stream_private_t *p_stream, opj_image_t *p_image, opj_event_mgr_t *p_manager, OPJ_UINT32 tile_index)
Definition: jp2.c:3076
JP2_IMG_STATE
Definition: jp2.h:84
OPJ_BYTE jp2_has_colr
Definition: jp2.h:134
OPJ_BOOL opj_jp2_end_compress(opj_jp2_t *jp2, opj_stream_private_t *cio, opj_event_mgr_t *p_manager)
Ends the compression procedures and possibiliy add data to be read after the codestream.
Definition: jp2.c:2115
OPJ_UINT32 sgnd
Definition: jp2.h:142
OPJ_UINT16 cmp
Definition: jp2.h:109
struct opj_jp2_cdef_info opj_jp2_cdef_info_t
Channel description: channel index, type, association.
OPJ_UINT32 * cl
Definition: jp2.h:174
Definition: jp2.h:75
Definition: jp2.h:85
Definition: jp2.h:76
OPJ_UINT32 meth
Definition: jp2.h:167
JP2 component.
Definition: jp2.h:140
JP2_STATE
< Resolution box (super-box)
Definition: jp2.h:73
Channel description: channel index, type, association.
Definition: jp2.h:93
Channel descriptions and number of descriptions.
Definition: jp2.h:100
Definition: jp2.h:77
void jp2_dump(opj_jp2_t *p_jp2, OPJ_INT32 flag, FILE *out_stream)
Dump some elements from the JP2 decompression structure .
Definition: jp2.c:3186