2 * Copyright (c) 2005, Herve Drolon, FreeImage Team
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
15 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
18 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
19 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
20 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
21 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
22 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
23 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
24 * POSSIBILITY OF SUCH DAMAGE.
31 #include "opj_config.h"
32 #include "opj_includes.h"
36 * Decompression handler.
38 typedef struct opj_decompression
40 /** Main header reading function handler*/
41 opj_bool (* opj_read_header) ( struct opj_stream_private * cio,
43 opj_image_t **p_image,
44 struct opj_event_mgr * p_manager);
46 opj_bool (* opj_decode) ( void * p_codec,
47 struct opj_stream_private *p_cio,
49 struct opj_event_mgr * p_manager);
51 opj_bool (*opj_read_tile_header)( void * p_codec,
52 OPJ_UINT32 * p_tile_index,
53 OPJ_UINT32* p_data_size,
54 OPJ_INT32 * p_tile_x0, OPJ_INT32 * p_tile_y0,
55 OPJ_INT32 * p_tile_x1, OPJ_INT32 * p_tile_y1,
56 OPJ_UINT32 * p_nb_comps,
57 opj_bool * p_should_go_on,
58 struct opj_stream_private *p_cio,
59 struct opj_event_mgr * p_manager);
61 opj_bool (*opj_decode_tile_data)( void * p_codec,
62 OPJ_UINT32 p_tile_index,
64 OPJ_UINT32 p_data_size,
65 struct opj_stream_private *p_cio,
66 struct opj_event_mgr * p_manager);
68 opj_bool (* opj_end_decompress) ( void *p_codec,
69 struct opj_stream_private *cio,
70 struct opj_event_mgr * p_manager);
71 /** Codec destroy function handler*/
72 void (* opj_destroy) (void * p_codec);
73 /** Setup decoder function handler */
74 void (*opj_setup_decoder) (void * p_codec, opj_dparameters_t * p_param);
75 /** Set decode area function handler */
76 opj_bool (*opj_set_decode_area) ( void * p_codec,
77 OPJ_INT32 p_start_x, OPJ_INT32 p_end_x,
78 OPJ_INT32 p_start_y, OPJ_INT32 p_end_y,
79 struct opj_event_mgr * p_manager);
83 * Compression handler. FIXME DOC
85 typedef struct opj_compression
87 opj_bool (* opj_start_compress) (void *p_codec,struct opj_stream_private *cio,struct opj_image * p_image, struct opj_event_mgr * p_manager);
88 opj_bool (* opj_encode) (void * p_codec, struct opj_stream_private *p_cio, struct opj_event_mgr * p_manager);
89 opj_bool (* opj_write_tile) (void * p_codec,OPJ_UINT32 p_tile_index,OPJ_BYTE * p_data,OPJ_UINT32 p_data_size,struct opj_stream_private * p_cio,struct opj_event_mgr * p_manager);
90 opj_bool (* opj_end_compress) (void * p_codec, struct opj_stream_private *p_cio, struct opj_event_mgr * p_manager);
91 void (* opj_destroy) (void * p_codec);
92 void (*opj_setup_encoder) (void * p_codec,opj_cparameters_t * p_param,struct opj_image * p_image, struct opj_event_mgr * p_manager);
97 * Main codec handler used for compression or decompression.
99 typedef struct opj_codec_private
103 opj_decompression_t m_decompression;
104 opj_compression_t m_compression;
109 opj_event_mgr_t* m_event_mgr;
110 /** Flag to indicate if the codec is used to decode or encode*/
111 opj_bool is_decompressor;
112 void (*opj_dump_codec) (void * p_codec, OPJ_INT32 info_flag, FILE* output_stream);
113 opj_codestream_info_v2_t* (*opj_get_codec_info)(void* p_codec);
114 opj_codestream_index_t* (*opj_get_codec_index)(void* p_codec);
120 /* ---------------------------------------------------------------------- */
123 OPJ_UINT32 opj_read_from_file (void * p_buffer, OPJ_UINT32 p_nb_bytes, FILE * p_file)
125 OPJ_UINT32 l_nb_read = fread(p_buffer,1,p_nb_bytes,p_file);
126 return l_nb_read ? l_nb_read : -1;
129 OPJ_UINT32 opj_get_data_length_from_file (FILE * p_file)
131 OPJ_UINT32 file_length = 0;
133 fseek(p_file, 0, SEEK_END);
134 file_length = ftell(p_file);
135 fseek(p_file, 0, SEEK_SET);
140 OPJ_UINT32 opj_write_from_file (void * p_buffer, OPJ_UINT32 p_nb_bytes, FILE * p_file)
142 return fwrite(p_buffer,1,p_nb_bytes,p_file);
145 OPJ_SIZE_T opj_skip_from_file (OPJ_SIZE_T p_nb_bytes, FILE * p_user_data)
147 if (fseek(p_user_data,p_nb_bytes,SEEK_CUR)) {
154 opj_bool opj_seek_from_file (OPJ_SIZE_T p_nb_bytes, FILE * p_user_data)
156 if (fseek(p_user_data,p_nb_bytes,SEEK_SET)) {
163 /* ---------------------------------------------------------------------- */
167 DllMain(HANDLE hModule, DWORD ul_reason_for_call, LPVOID lpReserved) {
169 OPJ_ARG_NOT_USED(lpReserved);
170 OPJ_ARG_NOT_USED(hModule);
172 switch (ul_reason_for_call) {
173 case DLL_PROCESS_ATTACH :
175 case DLL_PROCESS_DETACH :
177 case DLL_THREAD_ATTACH :
178 case DLL_THREAD_DETACH :
184 #endif /* OPJ_STATIC */
187 /* ---------------------------------------------------------------------- */
190 const char* OPJ_CALLCONV opj_version(void) {
191 return PACKAGE_VERSION;
196 opj_dinfo_t* OPJ_CALLCONV opj_create_decompress(OPJ_CODEC_FORMAT format) {
197 opj_dinfo_t *dinfo = (opj_dinfo_t*)opj_calloc(1, sizeof(opj_dinfo_t));
198 if(!dinfo) return NULL;
199 dinfo->is_decompressor = OPJ_TRUE;
203 /* get a J2K decoder handle */
204 dinfo->j2k_handle = (void*)j2k_create_decompress((opj_common_ptr)dinfo);
205 if(!dinfo->j2k_handle) {
211 /* get a JP2 decoder handle */
212 dinfo->jp2_handle = (void*)jp2_create_decompress((opj_common_ptr)dinfo);
213 if(!dinfo->jp2_handle) {
224 dinfo->codec_format = format;
229 opj_codec_t* OPJ_CALLCONV opj_create_decompress_v2(OPJ_CODEC_FORMAT p_format)
231 opj_codec_private_t *l_info = 00;
233 l_info = (opj_codec_private_t*) opj_calloc(1, sizeof(opj_codec_private_t));
237 memset(l_info, 0, sizeof(opj_codec_private_t));
239 l_info->is_decompressor = 1;
243 l_info->opj_dump_codec = (void (*) (void*, OPJ_INT32, FILE*)) j2k_dump;
245 l_info->opj_get_codec_info = (opj_codestream_info_v2_t* (*) (void*) ) j2k_get_cstr_info;
247 l_info->opj_get_codec_index = (opj_codestream_index_t* (*) (void*) ) j2k_get_cstr_index;
249 l_info->m_codec_data.m_decompression.opj_decode =
250 (opj_bool (*) ( void *,
251 struct opj_stream_private *,
252 opj_image_t*, struct opj_event_mgr * )) j2k_decode_v2;
254 l_info->m_codec_data.m_decompression.opj_end_decompress =
255 (opj_bool (*) ( void *,
256 struct opj_stream_private *,
257 struct opj_event_mgr *)) j2k_end_decompress;
259 l_info->m_codec_data.m_decompression.opj_read_header =
260 (opj_bool (*) ( struct opj_stream_private *,
263 struct opj_event_mgr * )) j2k_read_header;
265 l_info->m_codec_data.m_decompression.opj_destroy =
266 (void (*) (void *))j2k_destroy;
268 l_info->m_codec_data.m_decompression.opj_setup_decoder =
269 (void (*) (void * , opj_dparameters_t * )) j2k_setup_decoder_v2;
271 l_info->m_codec_data.m_decompression.opj_read_tile_header =
272 (opj_bool (*) ( void *,
275 OPJ_INT32*, OPJ_INT32*,
276 OPJ_INT32*, OPJ_INT32*,
279 struct opj_stream_private *,
280 struct opj_event_mgr * )) j2k_read_tile_header;
282 l_info->m_codec_data.m_decompression.opj_decode_tile_data =
283 (opj_bool (*) (void *, OPJ_UINT32, OPJ_BYTE*, OPJ_UINT32, struct opj_stream_private *, struct opj_event_mgr *)) j2k_decode_tile;
285 l_info->m_codec_data.m_decompression.opj_set_decode_area =
286 (opj_bool (*) (void *, OPJ_INT32, OPJ_INT32, OPJ_INT32, OPJ_INT32, struct opj_event_mgr *)) j2k_set_decode_area;
288 l_info->m_codec = j2k_create_decompress_v2();
290 if (! l_info->m_codec) {
298 /* get a JP2 decoder handle */
299 l_info->opj_dump_codec = (void (*) (void*, OPJ_INT32, FILE*)) jp2_dump;
301 l_info->opj_get_codec_info = (opj_codestream_info_v2_t* (*) (void*) ) jp2_get_cstr_info;
303 l_info->opj_get_codec_index = (opj_codestream_index_t* (*) (void*) ) jp2_get_cstr_index;
305 l_info->m_codec_data.m_decompression.opj_decode =
306 (opj_bool (*) ( void *,
307 struct opj_stream_private *,
309 struct opj_event_mgr * )) jp2_decode_v2;
311 l_info->m_codec_data.m_decompression.opj_end_decompress = (opj_bool (*) (void *,struct opj_stream_private *,struct opj_event_mgr *)) jp2_end_decompress;
313 l_info->m_codec_data.m_decompression.opj_read_header = (opj_bool (*) (
314 struct opj_stream_private *,
317 struct opj_event_mgr * )) jp2_read_header;
319 l_info->m_codec_data.m_decompression.opj_read_tile_header = ( opj_bool (*) (
329 struct opj_stream_private *,
330 struct opj_event_mgr * )) jp2_read_tile_header;
332 l_info->m_codec_data.m_decompression.opj_decode_tile_data = (opj_bool (*) (void *,OPJ_UINT32,OPJ_BYTE*,OPJ_UINT32,struct opj_stream_private *, struct opj_event_mgr * )) jp2_decode_tile;
334 l_info->m_codec_data.m_decompression.opj_destroy = (void (*) (void *))jp2_destroy;
336 l_info->m_codec_data.m_decompression.opj_setup_decoder = (void (*) (void * ,opj_dparameters_t * )) jp2_setup_decoder_v2;
338 l_info->m_codec_data.m_decompression.opj_set_decode_area = (opj_bool (*) (void *,OPJ_INT32,OPJ_INT32,OPJ_INT32,OPJ_INT32, struct opj_event_mgr * )) jp2_set_decode_area;
340 l_info->m_codec = jp2_create(OPJ_TRUE);
342 if (! l_info->m_codec) {
355 // FIXME set_default_event_handler(&(l_info->m_event_mgr));
356 return (opj_codec_t*) l_info;
360 void OPJ_CALLCONV opj_destroy_decompress(opj_dinfo_t *dinfo) {
362 /* destroy the codec */
363 switch(dinfo->codec_format) {
366 j2k_destroy_decompress((opj_j2k_t*)dinfo->j2k_handle);
369 jp2_destroy_decompress((opj_jp2_t*)dinfo->jp2_handle);
375 /* destroy the decompressor */
380 void OPJ_CALLCONV opj_set_default_decoder_parameters(opj_dparameters_t *parameters) {
382 memset(parameters, 0, sizeof(opj_dparameters_t));
383 /* default decoding parameters */
384 parameters->cp_layer = 0;
385 parameters->cp_reduce = 0;
386 parameters->cp_limit_decoding = NO_LIMITATION;
388 parameters->decod_format = -1;
389 parameters->cod_format = -1;
392 parameters->jpwl_correct = OPJ_FALSE;
393 parameters->jpwl_exp_comps = JPWL_EXPECTED_COMPONENTS;
394 parameters->jpwl_max_tiles = JPWL_MAXIMUM_TILES;
395 #endif /* USE_JPWL */
400 void OPJ_CALLCONV opj_setup_decoder(opj_dinfo_t *dinfo, opj_dparameters_t *parameters) {
401 if(dinfo && parameters) {
402 switch(dinfo->codec_format) {
405 j2k_setup_decoder((opj_j2k_t*)dinfo->j2k_handle, parameters);
408 jp2_setup_decoder((opj_jp2_t*)dinfo->jp2_handle, parameters);
417 opj_bool OPJ_CALLCONV opj_setup_decoder_v2(opj_codec_t *p_info, opj_dparameters_t *parameters, opj_event_mgr_t* event_mgr)
419 opj_codec_private_t * l_info = (opj_codec_private_t *) p_info;
421 if ( !p_info || !parameters || !event_mgr ){
422 fprintf(stderr, "[ERROR] Input parameters of the setup_decoder function are incorrect.\n");
426 if ( !event_mgr->error_handler || !event_mgr->warning_handler || !event_mgr->error_handler){
427 fprintf(stderr, "[ERROR] Event handler provided to the setup_decoder function is not valid.\n");
431 if (! l_info->is_decompressor) {
432 opj_event_msg_v2(event_mgr, EVT_ERROR, "Codec provided to the setup_decoder function is not a decompressor handler.\n");
436 l_info->m_codec_data.m_decompression.opj_setup_decoder(l_info->m_codec, parameters);
438 l_info->m_event_mgr = event_mgr;
443 opj_image_t* OPJ_CALLCONV opj_decode(opj_dinfo_t *dinfo, opj_cio_t *cio) {
444 return opj_decode_with_info(dinfo, cio, NULL);
447 opj_image_t* OPJ_CALLCONV opj_decode_with_info(opj_dinfo_t *dinfo, opj_cio_t *cio, opj_codestream_info_t *cstr_info) {
449 switch(dinfo->codec_format) {
451 return j2k_decode((opj_j2k_t*)dinfo->j2k_handle, cio, cstr_info);
453 return j2k_decode_jpt_stream((opj_j2k_t*)dinfo->j2k_handle, cio, cstr_info);
455 return opj_jp2_decode((opj_jp2_t*)dinfo->jp2_handle, cio, cstr_info);
464 opj_cinfo_t* OPJ_CALLCONV opj_create_compress(OPJ_CODEC_FORMAT format) {
465 opj_cinfo_t *cinfo = (opj_cinfo_t*)opj_calloc(1, sizeof(opj_cinfo_t));
466 if(!cinfo) return NULL;
467 cinfo->is_decompressor = OPJ_FALSE;
470 /* get a J2K coder handle */
471 cinfo->j2k_handle = (void*)j2k_create_compress((opj_common_ptr)cinfo);
472 if(!cinfo->j2k_handle) {
478 /* get a JP2 coder handle */
479 cinfo->jp2_handle = (void*)jp2_create_compress((opj_common_ptr)cinfo);
480 if(!cinfo->jp2_handle) {
492 cinfo->codec_format = format;
497 void OPJ_CALLCONV opj_destroy_compress(opj_cinfo_t *cinfo) {
499 /* destroy the codec */
500 switch(cinfo->codec_format) {
502 j2k_destroy_compress((opj_j2k_t*)cinfo->j2k_handle);
505 jp2_destroy_compress((opj_jp2_t*)cinfo->jp2_handle);
512 /* destroy the decompressor */
517 void OPJ_CALLCONV opj_set_default_encoder_parameters(opj_cparameters_t *parameters) {
519 memset(parameters, 0, sizeof(opj_cparameters_t));
520 /* default coding parameters */
521 parameters->cp_cinema = OFF;
522 parameters->max_comp_size = 0;
523 parameters->numresolution = 6;
524 parameters->cp_rsiz = STD_RSIZ;
525 parameters->cblockw_init = 64;
526 parameters->cblockh_init = 64;
527 parameters->prog_order = LRCP;
528 parameters->roi_compno = -1; /* no ROI */
529 parameters->subsampling_dx = 1;
530 parameters->subsampling_dy = 1;
531 parameters->tp_on = 0;
532 parameters->decod_format = -1;
533 parameters->cod_format = -1;
534 parameters->tcp_rates[0] = 0;
535 parameters->tcp_numlayers = 0;
536 parameters->cp_disto_alloc = 0;
537 parameters->cp_fixed_alloc = 0;
538 parameters->cp_fixed_quality = 0;
539 parameters->jpip_on = OPJ_FALSE;
542 parameters->jpwl_epc_on = OPJ_FALSE;
543 parameters->jpwl_hprot_MH = -1; /* -1 means unassigned */
546 for (i = 0; i < JPWL_MAX_NO_TILESPECS; i++) {
547 parameters->jpwl_hprot_TPH_tileno[i] = -1; /* unassigned */
548 parameters->jpwl_hprot_TPH[i] = 0; /* absent */
553 for (i = 0; i < JPWL_MAX_NO_PACKSPECS; i++) {
554 parameters->jpwl_pprot_tileno[i] = -1; /* unassigned */
555 parameters->jpwl_pprot_packno[i] = -1; /* unassigned */
556 parameters->jpwl_pprot[i] = 0; /* absent */
559 parameters->jpwl_sens_size = 0; /* 0 means no ESD */
560 parameters->jpwl_sens_addr = 0; /* 0 means auto */
561 parameters->jpwl_sens_range = 0; /* 0 means packet */
562 parameters->jpwl_sens_MH = -1; /* -1 means unassigned */
565 for (i = 0; i < JPWL_MAX_NO_TILESPECS; i++) {
566 parameters->jpwl_sens_TPH_tileno[i] = -1; /* unassigned */
567 parameters->jpwl_sens_TPH[i] = -1; /* absent */
570 #endif /* USE_JPWL */
577 * Sets the stream to be a file stream. The FILE must have been open previously.
578 * @param p_stream the stream to modify
579 * @param p_file handler to an already open file.
581 opj_stream_t* OPJ_CALLCONV opj_stream_create_default_file_stream (FILE * p_file, opj_bool p_is_read_stream)
583 return opj_stream_create_file_stream(p_file,J2K_STREAM_CHUNK_SIZE,p_is_read_stream);
586 opj_stream_t* OPJ_CALLCONV opj_stream_create_file_stream (FILE * p_file, OPJ_UINT32 p_size, opj_bool p_is_read_stream)
588 opj_stream_t* l_stream = 00;
594 l_stream = opj_stream_create(p_size,p_is_read_stream);
599 opj_stream_set_user_data(l_stream, p_file);
600 opj_stream_set_user_data_length(l_stream, opj_get_data_length_from_file(p_file));
601 opj_stream_set_read_function(l_stream, (opj_stream_read_fn) opj_read_from_file);
602 opj_stream_set_write_function(l_stream, (opj_stream_write_fn) opj_write_from_file);
603 opj_stream_set_skip_function(l_stream, (opj_stream_skip_fn) opj_skip_from_file);
604 opj_stream_set_seek_function(l_stream, (opj_stream_seek_fn) opj_seek_from_file);
609 void OPJ_CALLCONV opj_setup_encoder(opj_cinfo_t *cinfo, opj_cparameters_t *parameters, opj_image_t *image) {
610 if(cinfo && parameters && image) {
611 switch(cinfo->codec_format) {
613 j2k_setup_encoder((opj_j2k_t*)cinfo->j2k_handle, parameters, image);
616 jp2_setup_encoder((opj_jp2_t*)cinfo->jp2_handle, parameters, image);
626 opj_bool OPJ_CALLCONV opj_encode(opj_cinfo_t *cinfo, opj_cio_t *cio, opj_image_t *image, char *index) {
628 opj_event_msg((opj_common_ptr)cinfo, EVT_WARNING, "Set index to NULL when calling the opj_encode function.\n"
629 "To extract the index, use the opj_encode_with_info() function.\n"
630 "No index will be generated during this encoding\n");
631 return opj_encode_with_info(cinfo, cio, image, NULL);
634 opj_bool OPJ_CALLCONV opj_encode_with_info(opj_cinfo_t *cinfo, opj_cio_t *cio, opj_image_t *image, opj_codestream_info_t *cstr_info) {
635 if(cinfo && cio && image) {
636 switch(cinfo->codec_format) {
638 return j2k_encode((opj_j2k_t*)cinfo->j2k_handle, cio, image, cstr_info);
640 return opj_jp2_encode((opj_jp2_t*)cinfo->jp2_handle, cio, image, cstr_info);
650 void OPJ_CALLCONV opj_destroy_cstr_info(opj_codestream_info_t *cstr_info) {
653 for (tileno = 0; tileno < cstr_info->tw * cstr_info->th; tileno++) {
654 opj_tile_info_t *tile_info = &cstr_info->tile[tileno];
655 opj_free(tile_info->thresh);
656 opj_free(tile_info->packet);
657 opj_free(tile_info->tp);
658 opj_free(tile_info->marker);
660 opj_free(cstr_info->tile);
661 opj_free(cstr_info->marker);
662 opj_free(cstr_info->numdecompos);
669 opj_bool OPJ_CALLCONV opj_read_header (
670 opj_codec_t *p_codec,
671 opj_image_t ** p_image,
672 OPJ_INT32 * p_tile_x0,
673 OPJ_INT32 * p_tile_y0,
674 OPJ_UINT32 * p_tile_width,
675 OPJ_UINT32 * p_tile_height,
676 OPJ_UINT32 * p_nb_tiles_x,
677 OPJ_UINT32 * p_nb_tiles_y,
680 if (p_codec && p_cio) {
681 opj_codec_private_t * l_info = (opj_codec_private_t *) p_codec;
682 opj_stream_private_t * l_cio = (opj_stream_private_t *) p_cio;
684 if(! l_info->is_decompressor) {
688 return l_info->m_codec_data.m_decompression.opj_read_header(
698 l_info->m_event_mgr); //&(l_info->m_event_mgr));
704 opj_bool OPJ_CALLCONV opj_read_header ( opj_stream_t *p_cio,
705 opj_codec_t *p_codec,
706 opj_image_t **p_image )
708 if (p_codec && p_cio) {
709 opj_codec_private_t* l_info = (opj_codec_private_t*) p_codec;
710 opj_stream_private_t* l_cio = (opj_stream_private_t*) p_cio;
712 if(! l_info->is_decompressor) {
713 opj_event_msg_v2(l_info->m_event_mgr, EVT_ERROR, "Codec provided to the read_header function is not a decompressor handler.\n");
717 return l_info->m_codec_data.m_decompression.opj_read_header(
721 l_info->m_event_mgr);
724 fprintf(stderr, "[ERROR] Input parameters of the read_header function are incorrect.\n");
729 void OPJ_CALLCONV opj_destroy_codec(opj_codec_t *p_info)
732 opj_codec_private_t * l_info = (opj_codec_private_t *) p_info;
734 if (l_info->is_decompressor) {
735 l_info->m_codec_data.m_decompression.opj_destroy(l_info->m_codec);
738 l_info->m_codec_data.m_compression.opj_destroy(l_info->m_codec);
741 l_info->m_codec = 00;
747 * Sets the given area to be decoded. This function should be called right after opj_read_header and before any tile header reading.
749 * @param p_codec the jpeg2000 codec.
750 * @param p_start_x the left position of the rectangle to decode (in image coordinates).
751 * @param p_end_x the right position of the rectangle to decode (in image coordinates).
752 * @param p_start_y the up position of the rectangle to decode (in image coordinates).
753 * @param p_end_y the bottom position of the rectangle to decode (in image coordinates).
755 * @return true if the area could be set.
757 opj_bool OPJ_CALLCONV opj_set_decode_area( opj_codec_t *p_codec,
758 OPJ_INT32 p_start_x, OPJ_INT32 p_start_y,
759 OPJ_INT32 p_end_x, OPJ_INT32 p_end_y
763 opj_codec_private_t * l_info = (opj_codec_private_t *) p_codec;
764 if (! l_info->is_decompressor) {
768 return l_info->m_codec_data.m_decompression.opj_set_decode_area(
774 l_info->m_event_mgr);
781 * Reads a tile header. This function is compulsory and allows one to know the size of the tile thta will be decoded.
782 * The user may need to refer to the image got by opj_read_header to understand the size being taken by the tile.
784 * @param p_codec the jpeg2000 codec.
785 * @param p_tile_index pointer to a value that will hold the index of the tile being decoded, in case of success.
786 * @param p_data_size pointer to a value that will hold the maximum size of the decoded data, in case of success. In case
787 * of truncated codestreams, the actual number of bytes decoded may be lower. The computation of the size is the same
788 * as depicted in opj_write_tile.
789 * @param p_tile_x0 pointer to a value that will hold the x0 pos of the tile (in the image).
790 * @param p_tile_y0 pointer to a value that will hold the y0 pos of the tile (in the image).
791 * @param p_tile_x1 pointer to a value that will hold the x1 pos of the tile (in the image).
792 * @param p_tile_y1 pointer to a value that will hold the y1 pos of the tile (in the image).
793 * @param p_nb_comps pointer to a value that will hold the number of components in the tile.
794 * @param p_should_go_on pointer to a boolean that will hold the fact that the decoding should go on. In case the
795 * codestream is over at the time of the call, the value will be set to false. The user should then stop
797 * @param p_stream the stream to decode.
798 * @return true if the tile header could be decoded. In case the decoding should end, the returned value is still true.
799 * returning false may be the result of a shortage of memory or an internal error.
801 opj_bool OPJ_CALLCONV opj_read_tile_header(
802 opj_codec_t *p_codec,
803 opj_stream_t * p_stream,
804 OPJ_UINT32 * p_tile_index,
805 OPJ_UINT32 * p_data_size,
806 OPJ_INT32 * p_tile_x0, OPJ_INT32 * p_tile_y0,
807 OPJ_INT32 * p_tile_x1, OPJ_INT32 * p_tile_y1,
808 OPJ_UINT32 * p_nb_comps,
809 opj_bool * p_should_go_on)
811 if (p_codec && p_stream && p_data_size && p_tile_index) {
812 opj_codec_private_t * l_info = (opj_codec_private_t *) p_codec;
813 opj_stream_private_t * l_cio = (opj_stream_private_t *) p_stream;
815 if (! l_info->is_decompressor) {
819 return l_info->m_codec_data.m_decompression.opj_read_tile_header(
823 p_tile_x0, p_tile_y0,
824 p_tile_x1, p_tile_y1,
828 l_info->m_event_mgr);
834 * Reads a tile data. This function is compulsory and allows one to decode tile data. opj_read_tile_header should be called before.
835 * The user may need to refer to the image got by opj_read_header to understand the size being taken by the tile.
837 * @param p_codec the jpeg2000 codec.
838 * @param p_tile_index the index of the tile being decoded, this should be the value set by opj_read_tile_header.
839 * @param p_data pointer to a memory block that will hold the decoded data.
840 * @param p_data_size size of p_data. p_data_size should be bigger or equal to the value set by opj_read_tile_header.
841 * @param p_stream the stream to decode.
843 * @return true if the data could be decoded.
845 opj_bool OPJ_CALLCONV opj_decode_tile_data(
846 opj_codec_t *p_codec,
847 OPJ_UINT32 p_tile_index,
849 OPJ_UINT32 p_data_size,
850 opj_stream_t *p_stream
853 if (p_codec && p_data && p_stream) {
854 opj_codec_private_t * l_info = (opj_codec_private_t *) p_codec;
855 opj_stream_private_t * l_cio = (opj_stream_private_t *) p_stream;
857 if (! l_info->is_decompressor) {
861 return l_info->m_codec_data.m_decompression.opj_decode_tile_data( l_info->m_codec,
866 l_info->m_event_mgr);
875 void OPJ_CALLCONV opj_dump_codec( opj_codec_t *p_codec,
880 opj_codec_private_t* l_codec = (opj_codec_private_t*) p_codec;
882 l_codec->opj_dump_codec(l_codec->m_codec, info_flag, output_stream);
886 fprintf(stderr, "[ERROR] Input parameter of the dump_codec function are incorrect.\n");
894 opj_codestream_info_v2_t* OPJ_CALLCONV opj_get_cstr_info(opj_codec_t *p_codec)
897 opj_codec_private_t* l_codec = (opj_codec_private_t*) p_codec;
899 return l_codec->opj_get_codec_info(l_codec->m_codec);
909 void OPJ_CALLCONV opj_destroy_cstr_info_v2(opj_codestream_info_v2_t **cstr_info) {
912 if ((*cstr_info)->m_default_tile_info.tccp_info){
913 opj_free((*cstr_info)->m_default_tile_info.tccp_info);
916 if ((*cstr_info)->tile_info){
917 /* FIXME not used for the moment*/
920 opj_free((*cstr_info));
929 opj_codestream_index_t * OPJ_CALLCONV opj_get_cstr_index(opj_codec_t *p_codec)
932 opj_codec_private_t* l_codec = (opj_codec_private_t*) p_codec;
934 return l_codec->opj_get_codec_index(l_codec->m_codec);
944 void OPJ_CALLCONV opj_destroy_cstr_index(opj_codestream_index_t **p_cstr_index)
948 if((*p_cstr_index)->marker){
949 opj_free((*p_cstr_index)->marker);
950 (*p_cstr_index)->marker = NULL;
953 if((*p_cstr_index)->tile_index) {
954 /* FIXME not used for the moment*/
957 opj_free((*p_cstr_index));
958 (*p_cstr_index) = NULL;
964 opj_bool OPJ_CALLCONV opj_decode_v2(opj_codec_t *p_info,
966 opj_image_t* p_image)
969 opj_codec_private_t * l_info = (opj_codec_private_t *) p_info;
970 opj_stream_private_t * l_cio = (opj_stream_private_t *) cio;
972 if (! l_info->is_decompressor) {
976 return l_info->m_codec_data.m_decompression.opj_decode( l_info->m_codec,
979 l_info->m_event_mgr);
985 opj_bool OPJ_CALLCONV opj_end_decompress (opj_codec_t *p_codec,opj_stream_t *p_cio)
987 if (p_codec && p_cio) {
988 opj_codec_private_t * l_info = (opj_codec_private_t *) p_codec;
989 opj_stream_private_t * l_cio = (opj_stream_private_t *) p_cio;
991 if (! l_info->is_decompressor) {
994 return l_info->m_codec_data.m_decompression.opj_end_decompress( l_info->m_codec,
996 l_info->m_event_mgr);