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"
34 typedef struct opj_decompression
36 opj_bool (* opj_read_header) (
37 struct opj_stream_private * cio,
39 opj_image_header_t ** image_header,
40 opj_codestream_info_t ** cstr_info,
41 struct opj_event_mgr * p_manager);
42 opj_image_t* (* opj_decode) (void * p_codec, struct opj_stream_private *p_cio, struct opj_event_mgr * p_manager);
43 opj_bool (*opj_read_tile_header)(
45 OPJ_UINT32 * p_tile_index,
46 OPJ_UINT32* p_data_size,
47 OPJ_INT32 * p_tile_x0,
48 OPJ_INT32 * p_tile_y0,
49 OPJ_INT32 * p_tile_x1,
50 OPJ_INT32 * p_tile_y1,
51 OPJ_UINT32 * p_nb_comps,
52 opj_bool * p_should_go_on,
53 struct opj_stream_private *p_cio,
54 struct opj_event_mgr * p_manager);
55 opj_bool (*opj_decode_tile_data)(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);
56 opj_bool (* opj_end_decompress) (void *p_codec,struct opj_stream_private *cio,struct opj_event_mgr * p_manager);
57 void (* opj_destroy) (void * p_codec);
58 void (*opj_setup_decoder) (void * p_codec,opj_dparameters_t * p_param);
59 opj_bool (*opj_set_decode_area) (void * p_codec,OPJ_INT32 p_start_x,OPJ_INT32 p_end_x,OPJ_INT32 p_start_y,OPJ_INT32 p_end_y,struct opj_event_mgr * p_manager);
64 typedef struct opj_compression
66 opj_bool (* opj_start_compress) (void *p_codec,struct opj_stream_private *cio,struct opj_image * p_image, struct opj_event_mgr * p_manager);
67 opj_bool (* opj_encode) (void * p_codec, struct opj_stream_private *p_cio, struct opj_event_mgr * p_manager);
68 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);
69 opj_bool (* opj_end_compress) (void * p_codec, struct opj_stream_private *p_cio, struct opj_event_mgr * p_manager);
70 void (* opj_destroy) (void * p_codec);
71 void (*opj_setup_encoder) (void * p_codec,opj_cparameters_t * p_param,struct opj_image * p_image, struct opj_event_mgr * p_manager);
75 typedef struct opj_codec_private
78 { /* code-blocks informations */
79 opj_decompression_t m_decompression;
80 opj_compression_t m_compression;
83 opj_event_mgr_t* m_event_mgr;
84 unsigned is_decompressor : 1;
89 * Default callback function.
92 void opj_default_callback (const char *msg, void *client_data)
94 //FIXME V2 -> V1 cf below
97 void set_default_event_handler(opj_event_mgr_t * p_manager)
100 //p_manager->m_error_data = 00;
101 //p_manager->m_warning_data = 00;
102 //p_manager->m_info_data = 00;
103 p_manager->error_handler = opj_default_callback;
104 p_manager->info_handler = opj_default_callback;
105 p_manager->warning_handler = opj_default_callback;
108 OPJ_UINT32 opj_read_from_file (void * p_buffer, OPJ_UINT32 p_nb_bytes, FILE * p_file)
110 OPJ_UINT32 l_nb_read = fread(p_buffer,1,p_nb_bytes,p_file);
111 return l_nb_read ? l_nb_read : -1;
114 OPJ_UINT32 opj_write_from_file (void * p_buffer, OPJ_UINT32 p_nb_bytes, FILE * p_file)
116 return fwrite(p_buffer,1,p_nb_bytes,p_file);
119 OPJ_SIZE_T opj_skip_from_file (OPJ_SIZE_T p_nb_bytes, FILE * p_user_data)
122 (fseek(p_user_data,p_nb_bytes,SEEK_CUR))
129 opj_bool opj_seek_from_file (OPJ_SIZE_T p_nb_bytes, FILE * p_user_data)
132 (fseek(p_user_data,p_nb_bytes,SEEK_SET))
139 /* ---------------------------------------------------------------------- */
143 DllMain(HANDLE hModule, DWORD ul_reason_for_call, LPVOID lpReserved) {
145 OPJ_ARG_NOT_USED(lpReserved);
146 OPJ_ARG_NOT_USED(hModule);
148 switch (ul_reason_for_call) {
149 case DLL_PROCESS_ATTACH :
151 case DLL_PROCESS_DETACH :
153 case DLL_THREAD_ATTACH :
154 case DLL_THREAD_DETACH :
160 #endif /* OPJ_STATIC */
163 /* ---------------------------------------------------------------------- */
166 const char* OPJ_CALLCONV opj_version(void) {
167 return PACKAGE_VERSION;
170 opj_dinfo_t* OPJ_CALLCONV opj_create_decompress(OPJ_CODEC_FORMAT format) {
171 opj_dinfo_t *dinfo = (opj_dinfo_t*)opj_calloc(1, sizeof(opj_dinfo_t));
172 if(!dinfo) return NULL;
173 dinfo->is_decompressor = OPJ_TRUE;
177 /* get a J2K decoder handle */
178 dinfo->j2k_handle = (void*)j2k_create_decompress((opj_common_ptr)dinfo);
179 if(!dinfo->j2k_handle) {
185 /* get a JP2 decoder handle */
186 dinfo->jp2_handle = (void*)jp2_create_decompress((opj_common_ptr)dinfo);
187 if(!dinfo->jp2_handle) {
198 dinfo->codec_format = format;
203 opj_codec_t* OPJ_CALLCONV opj_create_decompress_v2(OPJ_CODEC_FORMAT p_format)
205 opj_codec_private_t *l_info = 00;
207 l_info = (opj_codec_private_t*) opj_calloc(1, sizeof(opj_codec_private_t));
211 memset(l_info, 0, sizeof(opj_codec_private_t));
213 l_info->is_decompressor = 1;
219 l_info->m_codec_data.m_decompression.opj_decode = (opj_image_t* (*) (void *, struct opj_stream_private *, struct opj_event_mgr * ))j2k_decode;
220 l_info->m_codec_data.m_decompression.opj_end_decompress = (opj_bool (*) (void *,struct opj_stream_private *,struct opj_event_mgr *))j2k_end_decompress;
221 l_info->m_codec_data.m_decompression.opj_read_header = (opj_bool (*) (
222 struct opj_stream_private *,
224 opj_image_header_t **,
225 opj_codestream_info_t**,
226 struct opj_event_mgr * )) j2k_read_header;
227 l_info->m_codec_data.m_decompression.opj_destroy = (void (*) (void *))j2k_destroy;
228 l_info->m_codec_data.m_decompression.opj_setup_decoder = (void (*) (void * ,opj_dparameters_t * )) j2k_setup_decoder;
229 l_info->m_codec_data.m_decompression.opj_read_tile_header = (opj_bool (*) (
239 struct opj_stream_private *,
240 struct opj_event_mgr * )) j2k_read_tile_header;
241 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 * )) j2k_decode_tile;
242 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 * )) j2k_set_decode_area;
243 l_info->m_codec = j2k_create_decompress_v2();
253 /* get a JP2 decoder handle */
255 l_info->m_codec_data.m_decompression.opj_decode = (opj_image_t* (*) (void *, struct opj_stream_private *, struct opj_event_mgr * ))opj_jp2_decode;
256 l_info->m_codec_data.m_decompression.opj_end_decompress = (opj_bool (*) (void *,struct opj_stream_private *,struct opj_event_mgr *)) jp2_end_decompress;
257 l_info->m_codec_data.m_decompression.opj_read_header = (opj_bool (*) (
267 struct opj_stream_private *,
268 struct opj_event_mgr * )) jp2_read_header;
270 l_info->m_codec_data.m_decompression.opj_read_tile_header = (
281 struct opj_stream_private *,
282 struct opj_event_mgr * )) jp2_read_tile_header;
284 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 * )) opj_jp2_decode_tile;
286 l_info->m_codec_data.m_decompression.opj_destroy = (void (*) (void *))jp2_destroy;
287 l_info->m_codec_data.m_decompression.opj_setup_decoder = (void (*) (void * ,opj_dparameters_t * )) jp2_setup_decoder;
288 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;
291 l_info->m_codec = jp2_create(OPJ_TRUE);
307 // FIXME set_default_event_handler(&(l_info->m_event_mgr));
308 return (opj_codec_t*) l_info;
312 void OPJ_CALLCONV opj_destroy_decompress(opj_dinfo_t *dinfo) {
314 /* destroy the codec */
315 switch(dinfo->codec_format) {
318 j2k_destroy_decompress((opj_j2k_t*)dinfo->j2k_handle);
321 jp2_destroy_decompress((opj_jp2_t*)dinfo->jp2_handle);
327 /* destroy the decompressor */
332 void OPJ_CALLCONV opj_set_default_decoder_parameters(opj_dparameters_t *parameters) {
334 memset(parameters, 0, sizeof(opj_dparameters_t));
335 /* default decoding parameters */
336 parameters->cp_layer = 0;
337 parameters->cp_reduce = 0;
338 parameters->cp_limit_decoding = NO_LIMITATION;
340 parameters->decod_format = -1;
341 parameters->cod_format = -1;
344 parameters->jpwl_correct = OPJ_FALSE;
345 parameters->jpwl_exp_comps = JPWL_EXPECTED_COMPONENTS;
346 parameters->jpwl_max_tiles = JPWL_MAXIMUM_TILES;
347 #endif /* USE_JPWL */
352 void OPJ_CALLCONV opj_setup_decoder(opj_dinfo_t *dinfo, opj_dparameters_t *parameters) {
353 if(dinfo && parameters) {
354 switch(dinfo->codec_format) {
357 j2k_setup_decoder((opj_j2k_t*)dinfo->j2k_handle, parameters);
360 jp2_setup_decoder((opj_jp2_t*)dinfo->jp2_handle, parameters);
369 opj_bool OPJ_CALLCONV opj_setup_decoder_v2(opj_codec_t *p_info, opj_dparameters_t *parameters, opj_event_mgr_t* event_mgr)
371 if (p_info && parameters) {
372 opj_codec_private_t * l_info = (opj_codec_private_t *) p_info;
374 if (! l_info->is_decompressor) {
378 l_info->m_codec_data.m_decompression.opj_setup_decoder(l_info->m_codec,parameters);
380 if (event_mgr == NULL)
382 l_info->m_event_mgr->error_handler = opj_default_callback ;
383 l_info->m_event_mgr->warning_handler = opj_default_callback ;
384 l_info->m_event_mgr->info_handler = opj_default_callback ;
385 l_info->m_event_mgr->client_data = stderr;
388 l_info->m_event_mgr = event_mgr;
394 opj_image_t* OPJ_CALLCONV opj_decode(opj_dinfo_t *dinfo, opj_cio_t *cio) {
395 return opj_decode_with_info(dinfo, cio, NULL);
398 opj_image_t* OPJ_CALLCONV opj_decode_with_info(opj_dinfo_t *dinfo, opj_cio_t *cio, opj_codestream_info_t *cstr_info) {
400 switch(dinfo->codec_format) {
402 return j2k_decode((opj_j2k_t*)dinfo->j2k_handle, cio, cstr_info);
404 return j2k_decode_jpt_stream((opj_j2k_t*)dinfo->j2k_handle, cio, cstr_info);
406 return opj_jp2_decode((opj_jp2_t*)dinfo->jp2_handle, cio, cstr_info);
415 opj_cinfo_t* OPJ_CALLCONV opj_create_compress(OPJ_CODEC_FORMAT format) {
416 opj_cinfo_t *cinfo = (opj_cinfo_t*)opj_calloc(1, sizeof(opj_cinfo_t));
417 if(!cinfo) return NULL;
418 cinfo->is_decompressor = OPJ_FALSE;
421 /* get a J2K coder handle */
422 cinfo->j2k_handle = (void*)j2k_create_compress((opj_common_ptr)cinfo);
423 if(!cinfo->j2k_handle) {
429 /* get a JP2 coder handle */
430 cinfo->jp2_handle = (void*)jp2_create_compress((opj_common_ptr)cinfo);
431 if(!cinfo->jp2_handle) {
443 cinfo->codec_format = format;
448 void OPJ_CALLCONV opj_destroy_compress(opj_cinfo_t *cinfo) {
450 /* destroy the codec */
451 switch(cinfo->codec_format) {
453 j2k_destroy_compress((opj_j2k_t*)cinfo->j2k_handle);
456 jp2_destroy_compress((opj_jp2_t*)cinfo->jp2_handle);
463 /* destroy the decompressor */
468 void OPJ_CALLCONV opj_set_default_encoder_parameters(opj_cparameters_t *parameters) {
470 memset(parameters, 0, sizeof(opj_cparameters_t));
471 /* default coding parameters */
472 parameters->cp_cinema = OFF;
473 parameters->max_comp_size = 0;
474 parameters->numresolution = 6;
475 parameters->cp_rsiz = STD_RSIZ;
476 parameters->cblockw_init = 64;
477 parameters->cblockh_init = 64;
478 parameters->prog_order = LRCP;
479 parameters->roi_compno = -1; /* no ROI */
480 parameters->subsampling_dx = 1;
481 parameters->subsampling_dy = 1;
482 parameters->tp_on = 0;
483 parameters->decod_format = -1;
484 parameters->cod_format = -1;
485 parameters->tcp_rates[0] = 0;
486 parameters->tcp_numlayers = 0;
487 parameters->cp_disto_alloc = 0;
488 parameters->cp_fixed_alloc = 0;
489 parameters->cp_fixed_quality = 0;
490 parameters->jpip_on = OPJ_FALSE;
493 parameters->jpwl_epc_on = OPJ_FALSE;
494 parameters->jpwl_hprot_MH = -1; /* -1 means unassigned */
497 for (i = 0; i < JPWL_MAX_NO_TILESPECS; i++) {
498 parameters->jpwl_hprot_TPH_tileno[i] = -1; /* unassigned */
499 parameters->jpwl_hprot_TPH[i] = 0; /* absent */
504 for (i = 0; i < JPWL_MAX_NO_PACKSPECS; i++) {
505 parameters->jpwl_pprot_tileno[i] = -1; /* unassigned */
506 parameters->jpwl_pprot_packno[i] = -1; /* unassigned */
507 parameters->jpwl_pprot[i] = 0; /* absent */
510 parameters->jpwl_sens_size = 0; /* 0 means no ESD */
511 parameters->jpwl_sens_addr = 0; /* 0 means auto */
512 parameters->jpwl_sens_range = 0; /* 0 means packet */
513 parameters->jpwl_sens_MH = -1; /* -1 means unassigned */
516 for (i = 0; i < JPWL_MAX_NO_TILESPECS; i++) {
517 parameters->jpwl_sens_TPH_tileno[i] = -1; /* unassigned */
518 parameters->jpwl_sens_TPH[i] = -1; /* absent */
521 #endif /* USE_JPWL */
528 * Sets the stream to be a file stream. The FILE must have been open previously.
529 * @param p_stream the stream to modify
530 * @param p_file handler to an already open file.
532 opj_stream_t* OPJ_CALLCONV opj_stream_create_default_file_stream (FILE * p_file, opj_bool p_is_read_stream)
534 return opj_stream_create_file_stream(p_file,J2K_STREAM_CHUNK_SIZE,p_is_read_stream);
537 opj_stream_t* OPJ_CALLCONV opj_stream_create_file_stream (FILE * p_file, OPJ_UINT32 p_size, opj_bool p_is_read_stream)
539 opj_stream_t* l_stream = 00;
545 l_stream = opj_stream_create(p_size,p_is_read_stream);
550 opj_stream_set_user_data(l_stream, p_file);
551 opj_stream_set_read_function(l_stream, (opj_stream_read_fn) opj_read_from_file);
552 opj_stream_set_write_function(l_stream, (opj_stream_write_fn) opj_write_from_file);
553 opj_stream_set_skip_function(l_stream, (opj_stream_skip_fn) opj_skip_from_file);
554 opj_stream_set_seek_function(l_stream, (opj_stream_seek_fn) opj_seek_from_file);
559 void OPJ_CALLCONV opj_setup_encoder(opj_cinfo_t *cinfo, opj_cparameters_t *parameters, opj_image_t *image) {
560 if(cinfo && parameters && image) {
561 switch(cinfo->codec_format) {
563 j2k_setup_encoder((opj_j2k_t*)cinfo->j2k_handle, parameters, image);
566 jp2_setup_encoder((opj_jp2_t*)cinfo->jp2_handle, parameters, image);
576 opj_bool OPJ_CALLCONV opj_encode(opj_cinfo_t *cinfo, opj_cio_t *cio, opj_image_t *image, char *index) {
578 opj_event_msg((opj_common_ptr)cinfo, EVT_WARNING, "Set index to NULL when calling the opj_encode function.\n"
579 "To extract the index, use the opj_encode_with_info() function.\n"
580 "No index will be generated during this encoding\n");
581 return opj_encode_with_info(cinfo, cio, image, NULL);
584 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) {
585 if(cinfo && cio && image) {
586 switch(cinfo->codec_format) {
588 return j2k_encode((opj_j2k_t*)cinfo->j2k_handle, cio, image, cstr_info);
590 return opj_jp2_encode((opj_jp2_t*)cinfo->jp2_handle, cio, image, cstr_info);
600 void OPJ_CALLCONV opj_destroy_cstr_info(opj_codestream_info_t *cstr_info) {
603 for (tileno = 0; tileno < cstr_info->tw * cstr_info->th; tileno++) {
604 opj_tile_info_t *tile_info = &cstr_info->tile[tileno];
605 opj_free(tile_info->thresh);
606 opj_free(tile_info->packet);
607 opj_free(tile_info->tp);
608 opj_free(tile_info->marker);
610 opj_free(cstr_info->tile);
611 opj_free(cstr_info->marker);
612 opj_free(cstr_info->numdecompos);
617 opj_bool OPJ_CALLCONV opj_read_header (
618 opj_codec_t *p_codec,
619 opj_image_t ** p_image,
620 OPJ_INT32 * p_tile_x0,
621 OPJ_INT32 * p_tile_y0,
622 OPJ_UINT32 * p_tile_width,
623 OPJ_UINT32 * p_tile_height,
624 OPJ_UINT32 * p_nb_tiles_x,
625 OPJ_UINT32 * p_nb_tiles_y,
628 if (p_codec && p_cio) {
629 opj_codec_private_t * l_info = (opj_codec_private_t *) p_codec;
630 opj_stream_private_t * l_cio = (opj_stream_private_t *) p_cio;
632 if(! l_info->is_decompressor) {
636 return l_info->m_codec_data.m_decompression.opj_read_header(
646 l_info->m_event_mgr); //&(l_info->m_event_mgr));
652 opj_bool OPJ_CALLCONV opj_read_header ( opj_stream_t *p_cio,
653 opj_codec_t *p_codec,
654 opj_image_header_t **p_image_header,
655 opj_codestream_info_t **p_cstr_info )
658 if (p_codec && p_cio) {
659 opj_codec_private_t* l_info = (opj_codec_private_t*) p_codec;
660 opj_stream_private_t* l_cio = (opj_stream_private_t*) p_cio;
662 if(! l_info->is_decompressor) {
666 return l_info->m_codec_data.m_decompression.opj_read_header(
671 l_info->m_event_mgr);
677 void OPJ_CALLCONV opj_destroy_codec(opj_codec_t *p_info)
682 opj_codec_private_t * l_info = (opj_codec_private_t *) p_info;
684 (l_info->is_decompressor)
686 l_info->m_codec_data.m_decompression.opj_destroy(l_info->m_codec);
690 l_info->m_codec_data.m_compression.opj_destroy(l_info->m_codec);
692 l_info->m_codec = 00;