diff options
| author | Mathieu Malaterre <mathieu.malaterre@gmail.com> | 2012-09-28 08:11:41 +0000 |
|---|---|---|
| committer | Mathieu Malaterre <mathieu.malaterre@gmail.com> | 2012-09-28 08:11:41 +0000 |
| commit | d518970039a19a2a9b6d2bdd592cc88a43897bbb (patch) | |
| tree | 57bac2cf7e63e9352228231062763baac627563c /src/lib/openjpip/index_manager.h | |
| parent | 8363a6ab1e031bb4b2e40a92e56efd40fdab1aa1 (diff) | |
[trunk] Start FolderReorgProposal task
Update issue 177
Diffstat (limited to 'src/lib/openjpip/index_manager.h')
| -rw-r--r-- | src/lib/openjpip/index_manager.h | 187 |
1 files changed, 187 insertions, 0 deletions
diff --git a/src/lib/openjpip/index_manager.h b/src/lib/openjpip/index_manager.h new file mode 100644 index 00000000..c1969fac --- /dev/null +++ b/src/lib/openjpip/index_manager.h @@ -0,0 +1,187 @@ +/* + * $Id: index_manager.h 53 2011-05-09 16:55:39Z kaori $ + * + * Copyright (c) 2002-2011, Communications and Remote Sensing Laboratory, Universite catholique de Louvain (UCL), Belgium + * Copyright (c) 2002-2011, Professor Benoit Macq + * Copyright (c) 2010-2011, Kaori Hagihara + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS' + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef INDEX_MANAGER_H_ +# define INDEX_MANAGER_H_ + +#include "byte_manager.h" +#include "faixbox_manager.h" +#include "metadata_manager.h" +#include "mhixbox_manager.h" +#include "bool.h" + +/** progression order */ +typedef enum porder { + PROG_UNKNOWN = -1, /**< place-holder */ + LRCP = 0, /**< layer-resolution-component-precinct order */ + RLCP = 1, /**< resolution-layer-component-precinct order */ + RPCL = 2, /**< resolution-precinct-component-layer order */ + PCRL = 3, /**< precinct-component-resolution-layer order */ + CPRL = 4 /**< component-precinct-resolution-layer order */ +} porder_t; + +/** A.5.1 Image and tile size (SIZ)*/ +typedef struct SIZmarker_param{ + Byte2_t Lsiz; /**< length of marker segment excluding the marker*/ + Byte2_t Rsiz; /**< capabilities that a decoder needs*/ + Byte4_t Xsiz; /**< width of the reference grid*/ + Byte4_t Ysiz; /**< height of the reference grid*/ + Byte4_t XOsiz; /**< horizontal offset from the origin of the reference grid to the left side of the image area*/ + Byte4_t YOsiz; /**< vertical offset from the origin of the reference grid to the top side of the image area*/ + Byte4_t XTsiz; /**< width of one reference tile with respect to the reference grid*/ + Byte4_t YTsiz; /**< height of one reference tile with respect to the reference grid*/ + Byte4_t XTOsiz; /**< horizontal offset from the origin of the reference grid to the left side of the first tile*/ + Byte4_t YTOsiz; /**< vertical offset from the origin of the reference grid to the top side of the first tile*/ + Byte4_t XTnum; /**< number of tiles in horizontal direction*/ + Byte4_t YTnum; /**< number of tiles in vertical direction*/ + Byte2_t Csiz; /**< number of the components in the image*/ + Byte_t Ssiz[3]; /**< precision (depth) in bits and sign of the component samples*/ + Byte_t XRsiz[3]; /**< horizontal separation of a sample of component with respect to the reference grid*/ + Byte_t YRsiz[3]; /**< vertical separation of a sample of component with respect to the reference grid*/ +} SIZmarker_param_t; + +/** A.6.1 Coding style default (COD)*/ +typedef struct CODmarker_param{ + Byte2_t Lcod; /**< length of marker segment excluding the marker*/ + Byte_t Scod; /**< Coding style for all components*/ + porder_t prog_order; /**< progression order*/ + Byte2_t numOflayers; /**< number of layers*/ + Byte_t numOfdecomp; /**< number of decompositions levels*/ + Byte4_t *XPsiz; /**< dynamic array of precinct width at successive resolution level in order*/ + Byte4_t *YPsiz; /**< dynamic array of precinct height at successive resolution level in order*/ +} CODmarker_param_t; + +/** index parameters*/ +typedef struct index_param{ + metadatalist_param_t *metadatalist; /**< metadata-bin list*/ + OPJ_OFF_T offset; /**< codestream offset*/ + Byte8_t length; /**< codestream length */ + Byte8_t mhead_length; /**< main header length */ + SIZmarker_param_t SIZ; /**< SIZ marker information*/ + CODmarker_param_t COD; /**< COD marker information*/ + faixbox_param_t *tilepart; /**< tile part information from tpix box*/ + mhixbox_param_t **tileheader; /**< dynamic array of tile header information from thix box*/ + faixbox_param_t **precpacket; /**< dynamic array of precint packet information from ppix box*/ +} index_param_t; + + +/** + * parse JP2 file + * AnnexI: Indexing JPEG2000 files for JPIP + * + * @param[in] fd file descriptor of the JP2 file + * @return pointer to the generated structure of index parameters + */ +index_param_t * parse_jp2file( int fd); + +/** + * print index parameters + * + * @param[in] index index parameters + */ +void print_index( index_param_t index); + +/** + * print Image and Tile SIZ parameters + * + * @param[in] SIZ SIZ marker information + */ +void print_SIZ( SIZmarker_param_t SIZ); + +/** + * print Coding style default COD parameters + * + * @param[in] COD COD marker information + */ +void print_COD( CODmarker_param_t COD); + +/** + * delete index + * + * @param[in,out] index addressof the index pointer + */ +void delete_index( index_param_t **index); + +/** + * delete dynamic arrays in COD marker + * + * @param[in] COD COD marker information + */ +void delete_COD( CODmarker_param_t COD); + + +/** 1-dimensional range parameters*/ +typedef struct range_param{ + Byte4_t minvalue; /**< minimal value*/ + Byte4_t maxvalue; /**< maximal value*/ +} range_param_t; + +/** + * get horizontal range of the tile in reference grid + * + * @param[in] SIZ SIZ marker information + * @param[in] tile_id tile id + * @param[in] level decomposition level + * @return structured range parameter + */ +range_param_t get_tile_Xrange( SIZmarker_param_t SIZ, Byte4_t tile_id, int level); + +/** + * get vertical range of the tile in reference grid + * + * @param[in] SIZ SIZ marker information + * @param[in] tile_id tile id + * @param[in] level decomposition level + * @return structured range parameter + */ +range_param_t get_tile_Yrange( SIZmarker_param_t SIZ, Byte4_t tile_id, int level); + + +/** + * get tile wdith at the decomposition level + * + * @param[in] SIZ SIZ marker information + * @param[in] tile_id tile id + * @param[in] level decomposition level + * @return tile width + */ +Byte4_t get_tile_XSiz( SIZmarker_param_t SIZ, Byte4_t tile_id, int level); +Byte4_t get_tile_YSiz( SIZmarker_param_t SIZ, Byte4_t tile_id, int level); + + +/** + * answers if the target is feasible to JPT-stream + * + * @param[in] index index parameters + * @return true if JPT-stream is feasible + */ +bool isJPTfeasible( index_param_t index); + +#endif /* !INDEX_MANAGER_H_ */ |
