Go to most recent revision | Details | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line |
|---|---|---|---|
| 5496 | leency | 1 | /* |
| 2 | * Copyright (c) 2002-2007, Communications and Remote Sensing Laboratory, Universite catholique de Louvain (UCL), Belgium |
||
| 3 | * Copyright (c) 2002-2007, Professor Benoit Macq |
||
| 4 | * Copyright (c) 2001-2003, David Janssens |
||
| 5 | * Copyright (c) 2002-2003, Yannick Verschueren |
||
| 6 | * Copyright (c) 2003-2007, Francois-Olivier Devaux and Antonin Descampe |
||
| 7 | * Copyright (c) 2005, Herve Drolon, FreeImage Team |
||
| 8 | * All rights reserved. |
||
| 9 | * |
||
| 10 | * Redistribution and use in source and binary forms, with or without |
||
| 11 | * modification, are permitted provided that the following conditions |
||
| 12 | * are met: |
||
| 13 | * 1. Redistributions of source code must retain the above copyright |
||
| 14 | * notice, this list of conditions and the following disclaimer. |
||
| 15 | * 2. Redistributions in binary form must reproduce the above copyright |
||
| 16 | * notice, this list of conditions and the following disclaimer in the |
||
| 17 | * documentation and/or other materials provided with the distribution. |
||
| 18 | * |
||
| 19 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS' |
||
| 20 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
||
| 21 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
||
| 22 | * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE |
||
| 23 | * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
||
| 24 | * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
||
| 25 | * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
||
| 26 | * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
||
| 27 | * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
||
| 28 | * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
||
| 29 | * POSSIBILITY OF SUCH DAMAGE. |
||
| 30 | */ |
||
| 31 | #ifndef __TCD_H |
||
| 32 | #define __TCD_H |
||
| 33 | /** |
||
| 34 | @file tcd.h |
||
| 35 | @brief Implementation of a tile coder/decoder (TCD) |
||
| 36 | |||
| 37 | The functions in TCD.C have for goal to encode or decode each tile independently from |
||
| 38 | each other. The functions in TCD.C are used by some function in J2K.C. |
||
| 39 | */ |
||
| 40 | |||
| 41 | /** @defgroup TCD TCD - Implementation of a tile coder/decoder */ |
||
| 42 | /*@{*/ |
||
| 43 | |||
| 44 | /** |
||
| 45 | FIXME: documentation |
||
| 46 | */ |
||
| 47 | typedef struct opj_tcd_seg { |
||
| 48 | unsigned char** data; |
||
| 49 | int dataindex; |
||
| 50 | int numpasses; |
||
| 51 | int len; |
||
| 52 | int maxpasses; |
||
| 53 | int numnewpasses; |
||
| 54 | int newlen; |
||
| 55 | } opj_tcd_seg_t; |
||
| 56 | |||
| 57 | /** |
||
| 58 | FIXME: documentation |
||
| 59 | */ |
||
| 60 | typedef struct opj_tcd_pass { |
||
| 61 | int rate; |
||
| 62 | double distortiondec; |
||
| 63 | int term, len; |
||
| 64 | } opj_tcd_pass_t; |
||
| 65 | |||
| 66 | /** |
||
| 67 | FIXME: documentation |
||
| 68 | */ |
||
| 69 | typedef struct opj_tcd_layer { |
||
| 70 | int numpasses; /* Number of passes in the layer */ |
||
| 71 | int len; /* len of information */ |
||
| 72 | double disto; /* add for index (Cfr. Marcela) */ |
||
| 73 | unsigned char *data; /* data */ |
||
| 74 | } opj_tcd_layer_t; |
||
| 75 | |||
| 76 | /** |
||
| 77 | FIXME: documentation |
||
| 78 | */ |
||
| 79 | typedef struct opj_tcd_cblk_enc { |
||
| 80 | unsigned char* data; /* Data */ |
||
| 81 | opj_tcd_layer_t* layers; /* layer information */ |
||
| 82 | opj_tcd_pass_t* passes; /* information about the passes */ |
||
| 83 | int x0, y0, x1, y1; /* dimension of the code-blocks : left upper corner (x0, y0) right low corner (x1,y1) */ |
||
| 84 | int numbps; |
||
| 85 | int numlenbits; |
||
| 86 | int numpasses; /* number of pass already done for the code-blocks */ |
||
| 87 | int numpassesinlayers; /* number of passes in the layer */ |
||
| 88 | int totalpasses; /* total number of passes */ |
||
| 89 | } opj_tcd_cblk_enc_t; |
||
| 90 | |||
| 91 | typedef struct opj_tcd_cblk_dec { |
||
| 92 | unsigned char* data; /* Data */ |
||
| 93 | opj_tcd_seg_t* segs; /* segments informations */ |
||
| 94 | int x0, y0, x1, y1; /* dimension of the code-blocks : left upper corner (x0, y0) right low corner (x1,y1) */ |
||
| 95 | int numbps; |
||
| 96 | int numlenbits; |
||
| 97 | int len; /* length */ |
||
| 98 | int numnewpasses; /* number of pass added to the code-blocks */ |
||
| 99 | int numsegs; /* number of segments */ |
||
| 100 | } opj_tcd_cblk_dec_t; |
||
| 101 | |||
| 102 | /** |
||
| 103 | FIXME: documentation |
||
| 104 | */ |
||
| 105 | typedef struct opj_tcd_precinct { |
||
| 106 | int x0, y0, x1, y1; /* dimension of the precinct : left upper corner (x0, y0) right low corner (x1,y1) */ |
||
| 107 | int cw, ch; /* number of precinct in width and heigth */ |
||
| 108 | union{ /* code-blocks informations */ |
||
| 109 | opj_tcd_cblk_enc_t* enc; |
||
| 110 | opj_tcd_cblk_dec_t* dec; |
||
| 111 | } cblks; |
||
| 112 | opj_tgt_tree_t *incltree; /* inclusion tree */ |
||
| 113 | opj_tgt_tree_t *imsbtree; /* IMSB tree */ |
||
| 114 | } opj_tcd_precinct_t; |
||
| 115 | |||
| 116 | /** |
||
| 117 | FIXME: documentation |
||
| 118 | */ |
||
| 119 | typedef struct opj_tcd_band { |
||
| 120 | int x0, y0, x1, y1; /* dimension of the subband : left upper corner (x0, y0) right low corner (x1,y1) */ |
||
| 121 | int bandno; |
||
| 122 | opj_tcd_precinct_t *precincts; /* precinct information */ |
||
| 123 | int numbps; |
||
| 124 | float stepsize; |
||
| 125 | } opj_tcd_band_t; |
||
| 126 | |||
| 127 | /** |
||
| 128 | FIXME: documentation |
||
| 129 | */ |
||
| 130 | typedef struct opj_tcd_resolution { |
||
| 131 | int x0, y0, x1, y1; /* dimension of the resolution level : left upper corner (x0, y0) right low corner (x1,y1) */ |
||
| 132 | int pw, ph; |
||
| 133 | int numbands; /* number sub-band for the resolution level */ |
||
| 134 | opj_tcd_band_t bands[3]; /* subband information */ |
||
| 135 | } opj_tcd_resolution_t; |
||
| 136 | |||
| 137 | /** |
||
| 138 | FIXME: documentation |
||
| 139 | */ |
||
| 140 | typedef struct opj_tcd_tilecomp { |
||
| 141 | int x0, y0, x1, y1; /* dimension of component : left upper corner (x0, y0) right low corner (x1,y1) */ |
||
| 142 | int numresolutions; /* number of resolutions level */ |
||
| 143 | opj_tcd_resolution_t *resolutions; /* resolutions information */ |
||
| 144 | int *data; /* data of the component */ |
||
| 145 | int numpix; /* add fixed_quality */ |
||
| 146 | } opj_tcd_tilecomp_t; |
||
| 147 | |||
| 148 | /** |
||
| 149 | FIXME: documentation |
||
| 150 | */ |
||
| 151 | typedef struct opj_tcd_tile { |
||
| 152 | int x0, y0, x1, y1; /* dimension of the tile : left upper corner (x0, y0) right low corner (x1,y1) */ |
||
| 153 | int numcomps; /* number of components in tile */ |
||
| 154 | opj_tcd_tilecomp_t *comps; /* Components information */ |
||
| 155 | int numpix; /* add fixed_quality */ |
||
| 156 | double distotile; /* add fixed_quality */ |
||
| 157 | double distolayer[100]; /* add fixed_quality */ |
||
| 158 | /** packet number */ |
||
| 159 | int packno; |
||
| 160 | } opj_tcd_tile_t; |
||
| 161 | |||
| 162 | /** |
||
| 163 | FIXME: documentation |
||
| 164 | */ |
||
| 165 | typedef struct opj_tcd_image { |
||
| 166 | int tw, th; /* number of tiles in width and heigth */ |
||
| 167 | opj_tcd_tile_t *tiles; /* Tiles information */ |
||
| 168 | } opj_tcd_image_t; |
||
| 169 | |||
| 170 | /** |
||
| 171 | Tile coder/decoder |
||
| 172 | */ |
||
| 173 | typedef struct opj_tcd { |
||
| 174 | /** Position of the tilepart flag in Progression order*/ |
||
| 175 | int tp_pos; |
||
| 176 | /** Tile part number*/ |
||
| 177 | int tp_num; |
||
| 178 | /** Current tile part number*/ |
||
| 179 | int cur_tp_num; |
||
| 180 | /** Total number of tileparts of the current tile*/ |
||
| 181 | int cur_totnum_tp; |
||
| 182 | /** Current Packet iterator number */ |
||
| 183 | int cur_pino; |
||
| 184 | /** codec context */ |
||
| 185 | opj_common_ptr cinfo; |
||
| 186 | |||
| 187 | /** info on each image tile */ |
||
| 188 | opj_tcd_image_t *tcd_image; |
||
| 189 | /** image */ |
||
| 190 | opj_image_t *image; |
||
| 191 | /** coding parameters */ |
||
| 192 | opj_cp_t *cp; |
||
| 193 | /** pointer to the current encoded/decoded tile */ |
||
| 194 | opj_tcd_tile_t *tcd_tile; |
||
| 195 | /** coding/decoding parameters common to all tiles */ |
||
| 196 | opj_tcp_t *tcp; |
||
| 197 | /** current encoded/decoded tile */ |
||
| 198 | int tcd_tileno; |
||
| 199 | /** Time taken to encode a tile*/ |
||
| 200 | double encoding_time; |
||
| 201 | } opj_tcd_t; |
||
| 202 | |||
| 203 | /** @name Exported functions */ |
||
| 204 | /*@{*/ |
||
| 205 | /* ----------------------------------------------------------------------- */ |
||
| 206 | |||
| 207 | /** |
||
| 208 | Dump the content of a tcd structure |
||
| 209 | */ |
||
| 210 | void tcd_dump(FILE *fd, opj_tcd_t *tcd, opj_tcd_image_t *img); |
||
| 211 | /** |
||
| 212 | Create a new TCD handle |
||
| 213 | @param cinfo Codec context info |
||
| 214 | @return Returns a new TCD handle if successful returns NULL otherwise |
||
| 215 | */ |
||
| 216 | opj_tcd_t* tcd_create(opj_common_ptr cinfo); |
||
| 217 | /** |
||
| 218 | Destroy a previously created TCD handle |
||
| 219 | @param tcd TCD handle to destroy |
||
| 220 | */ |
||
| 221 | void tcd_destroy(opj_tcd_t *tcd); |
||
| 222 | /** |
||
| 223 | Initialize the tile coder (allocate the memory) |
||
| 224 | @param tcd TCD handle |
||
| 225 | @param image Raw image |
||
| 226 | @param cp Coding parameters |
||
| 227 | @param curtileno Number that identifies the tile that will be encoded |
||
| 228 | */ |
||
| 229 | void tcd_malloc_encode(opj_tcd_t *tcd, opj_image_t * image, opj_cp_t * cp, int curtileno); |
||
| 230 | /** |
||
| 231 | Free the memory allocated for encoding |
||
| 232 | @param tcd TCD handle |
||
| 233 | */ |
||
| 234 | void tcd_free_encode(opj_tcd_t *tcd); |
||
| 235 | /** |
||
| 236 | Initialize the tile coder (reuses the memory allocated by tcd_malloc_encode) |
||
| 237 | @param tcd TCD handle |
||
| 238 | @param image Raw image |
||
| 239 | @param cp Coding parameters |
||
| 240 | @param curtileno Number that identifies the tile that will be encoded |
||
| 241 | */ |
||
| 242 | void tcd_init_encode(opj_tcd_t *tcd, opj_image_t * image, opj_cp_t * cp, int curtileno); |
||
| 243 | /** |
||
| 244 | Initialize the tile decoder |
||
| 245 | @param tcd TCD handle |
||
| 246 | @param image Raw image |
||
| 247 | @param cp Coding parameters |
||
| 248 | */ |
||
| 249 | void tcd_malloc_decode(opj_tcd_t *tcd, opj_image_t * image, opj_cp_t * cp); |
||
| 250 | void tcd_malloc_decode_tile(opj_tcd_t *tcd, opj_image_t * image, opj_cp_t * cp, int tileno, opj_codestream_info_t *cstr_info); |
||
| 251 | void tcd_makelayer_fixed(opj_tcd_t *tcd, int layno, int final); |
||
| 252 | void tcd_rateallocate_fixed(opj_tcd_t *tcd); |
||
| 253 | void tcd_makelayer(opj_tcd_t *tcd, int layno, double thresh, int final); |
||
| 254 | bool tcd_rateallocate(opj_tcd_t *tcd, unsigned char *dest, int len, opj_codestream_info_t *cstr_info); |
||
| 255 | /** |
||
| 256 | Encode a tile from the raw image into a buffer |
||
| 257 | @param tcd TCD handle |
||
| 258 | @param tileno Number that identifies one of the tiles to be encoded |
||
| 259 | @param dest Destination buffer |
||
| 260 | @param len Length of destination buffer |
||
| 261 | @param cstr_info Codestream information structure |
||
| 262 | @return |
||
| 263 | */ |
||
| 264 | int tcd_encode_tile(opj_tcd_t *tcd, int tileno, unsigned char *dest, int len, opj_codestream_info_t *cstr_info); |
||
| 265 | /** |
||
| 266 | Decode a tile from a buffer into a raw image |
||
| 267 | @param tcd TCD handle |
||
| 268 | @param src Source buffer |
||
| 269 | @param len Length of source buffer |
||
| 270 | @param tileno Number that identifies one of the tiles to be decoded |
||
| 271 | @param cstr_info Codestream information structure |
||
| 272 | */ |
||
| 273 | bool tcd_decode_tile(opj_tcd_t *tcd, unsigned char *src, int len, int tileno, opj_codestream_info_t *cstr_info); |
||
| 274 | /** |
||
| 275 | Free the memory allocated for decoding |
||
| 276 | @param tcd TCD handle |
||
| 277 | */ |
||
| 278 | void tcd_free_decode(opj_tcd_t *tcd); |
||
| 279 | void tcd_free_decode_tile(opj_tcd_t *tcd, int tileno); |
||
| 280 | |||
| 281 | /* ----------------------------------------------------------------------- */ |
||
| 282 | /*@}*/ |
||
| 283 | |||
| 284 | /*@}*/ |
||
| 285 | |||
| 286 | #endif /* __TCD_H */ |