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.
7 * Copyright (c) 2002-2014, Universite catholique de Louvain (UCL), Belgium
8 * Copyright (c) 2002-2014, Professor Benoit Macq
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
21 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
24 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 * POSSIBILITY OF SUCH DAMAGE.
40 * Main codec handler used for compression or decompression.
42 typedef struct opj_codec_private {
46 * Decompression handler.
48 struct opj_decompression {
49 /** Main header reading function handler */
50 OPJ_BOOL(*opj_read_header)(struct opj_stream_private * cio,
52 opj_image_t **p_image,
53 struct opj_event_mgr * p_manager);
55 /** Decoding function */
56 OPJ_BOOL(*opj_decode)(void * p_codec,
57 struct opj_stream_private * p_cio,
58 opj_image_t * p_image,
59 struct opj_event_mgr * p_manager);
62 OPJ_BOOL(*opj_read_tile_header)(void * p_codec,
63 OPJ_UINT32 * p_tile_index,
64 OPJ_UINT32 * p_data_size,
65 OPJ_INT32 * p_tile_x0,
66 OPJ_INT32 * p_tile_y0,
67 OPJ_INT32 * p_tile_x1,
68 OPJ_INT32 * p_tile_y1,
69 OPJ_UINT32 * p_nb_comps,
70 OPJ_BOOL * p_should_go_on,
71 struct opj_stream_private * p_cio,
72 struct opj_event_mgr * p_manager);
75 OPJ_BOOL(*opj_decode_tile_data)(void * p_codec,
76 OPJ_UINT32 p_tile_index,
78 OPJ_UINT32 p_data_size,
79 struct opj_stream_private * p_cio,
80 struct opj_event_mgr * p_manager);
82 /** Reading function used after codestream if necessary */
83 OPJ_BOOL(* opj_end_decompress)(void *p_codec,
84 struct opj_stream_private * cio,
85 struct opj_event_mgr * p_manager);
87 /** Codec destroy function handler */
88 void (*opj_destroy)(void * p_codec);
90 /** Setup decoder function handler */
91 void (*opj_setup_decoder)(void * p_codec, opj_dparameters_t * p_param);
93 /** Set decode area function handler */
94 OPJ_BOOL(*opj_set_decode_area)(void * p_codec,
95 opj_image_t * p_image,
100 struct opj_event_mgr * p_manager);
102 /** Get tile function */
103 OPJ_BOOL(*opj_get_decoded_tile)(void *p_codec,
104 opj_stream_private_t * p_cio,
105 opj_image_t *p_image,
106 struct opj_event_mgr * p_manager,
107 OPJ_UINT32 tile_index);
109 /** Set the decoded resolution factor */
110 OPJ_BOOL(*opj_set_decoded_resolution_factor)(void * p_codec,
111 OPJ_UINT32 res_factor,
112 opj_event_mgr_t * p_manager);
117 * Compression handler. FIXME DOC
119 struct opj_compression {
120 OPJ_BOOL(* opj_start_compress)(void *p_codec,
121 struct opj_stream_private * cio,
122 struct opj_image * p_image,
123 struct opj_event_mgr * p_manager);
125 OPJ_BOOL(* opj_encode)(void * p_codec,
126 struct opj_stream_private *p_cio,
127 struct opj_event_mgr * p_manager);
129 OPJ_BOOL(* opj_write_tile)(void * p_codec,
130 OPJ_UINT32 p_tile_index,
132 OPJ_UINT32 p_data_size,
133 struct opj_stream_private * p_cio,
134 struct opj_event_mgr * p_manager);
136 OPJ_BOOL(* opj_end_compress)(void * p_codec,
137 struct opj_stream_private * p_cio,
138 struct opj_event_mgr * p_manager);
140 void (* opj_destroy)(void * p_codec);
142 OPJ_BOOL(* opj_setup_encoder)(void * p_codec,
143 opj_cparameters_t * p_param,
144 struct opj_image * p_image,
145 struct opj_event_mgr * p_manager);
151 opj_event_mgr_t m_event_mgr;
152 /** Flag to indicate if the codec is used to decode or encode*/
153 OPJ_BOOL is_decompressor;
154 void (*opj_dump_codec)(void * p_codec, OPJ_INT32 info_flag,
155 FILE* output_stream);
156 opj_codestream_info_v2_t* (*opj_get_codec_info)(void* p_codec);
157 opj_codestream_index_t* (*opj_get_codec_index)(void* p_codec);
159 /** Set number of threads */
160 OPJ_BOOL(*opj_set_threads)(void * p_codec, OPJ_UINT32 num_threads);
165 #endif /* OPJ_CODEC_H */