170 lines
6.9 KiB
C
170 lines
6.9 KiB
C
/*
|
|
* $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"
|
|
|
|
//! 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
|
|
Byte8_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);
|
|
|
|
//! 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);
|
|
|
|
#endif /* !INDEX_MANAGER_H_ */
|