Added option for Digital cinema profile compliant codestream. This can be chosen...
[openjpeg.git] / libopenjpeg / openjpeg.h
index 5bae6bebd19b1fea8e505296c89c2b28822756fc..d5543b926d2d9a9ee30db923ecfe74c718cf680a 100644 (file)
@@ -1,9 +1,10 @@
-/*
+ /*
+ * Copyright (c) 2002-2007, Communications and Remote Sensing Laboratory, Universite catholique de Louvain (UCL), Belgium
+ * Copyright (c) 2002-2007, Professor Benoit Macq
  * Copyright (c) 2001-2003, David Janssens
  * Copyright (c) 2002-2003, Yannick Verschueren
- * Copyright (c) 2003-2005, Francois Devaux and Antonin Descampe
- * Copyright (c) 2005, Herv� Drolon, FreeImage Team
- * Copyright (c) 2002-2005, Communications and remote sensing Laboratory, Universite catholique de Louvain, Belgium
+ * Copyright (c) 2003-2007, Francois-Olivier Devaux and Antonin Descampe
+ * Copyright (c) 2005, Herve Drolon, FreeImage Team
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  */
-
-
 #ifndef OPENJPEG_H
 #define OPENJPEG_H
 
+#define OPENJPEG_VERSION "1.1.1"
+
 /* 
 ==========================================================
    Compiler directives
 ==========================================================
 */
+
+#if defined(OPJ_STATIC) || !(defined(WIN32) || defined(__WIN32__))
+#define OPJ_API
+#define OPJ_CALLCONV
+#else
+#define OPJ_CALLCONV __stdcall
+/*
+The following ifdef block is the standard way of creating macros which make exporting 
+from a DLL simpler. All files within this DLL are compiled with the OPJ_EXPORTS
+symbol defined on the command line. this symbol should not be defined on any project
+that uses this DLL. This way any other project whose source files include this file see 
+OPJ_API functions as being imported from a DLL, wheras this DLL sees symbols
+defined with this macro as being exported.
+*/
+#ifdef OPJ_EXPORTS
+#define OPJ_API __declspec(dllexport)
+#else
+#define OPJ_API __declspec(dllimport)
+#endif /* OPJ_EXPORTS */
+#endif /* !OPJ_STATIC || !WIN32 */
+
 #ifndef __cplusplus
 #if defined(HAVE_STDBOOL_H)
 /*
@@ -51,13 +73,13 @@ The C language implementation does not provide the standard header file
 braindamage below.
 */
 #if !defined(bool)
-#define bool  int
+#define        bool    int
 #endif
 #if !defined(true)
-#define true  1
+#define true   1
 #endif
 #if !defined(false)
-#define false 0
+#define        false   0
 #endif
 #endif
 #endif /* __cplusplus */
@@ -68,12 +90,22 @@ braindamage below.
 ==========================================================
 */
 
-#ifndef MAX_PATH
-#define MAX_PATH 260  /**< Maximum allowed size for filenames */
-#endif /* MAX_PATH */
+#define OPJ_PATH_LEN 4096 /**< Maximum allowed size for filenames */
 
-#define J2K_MAXRLVLS 33         /**< Number of maximum resolution level authorized */
-#define J2K_MAXBANDS (3*J2K_MAXRLVLS-2) /**< Number of maximum sub-band linked to number of resolution level */
+#define J2K_MAXRLVLS 33                                        /**< Number of maximum resolution level authorized */
+#define J2K_MAXBANDS (3*J2K_MAXRLVLS-2)        /**< Number of maximum sub-band linked to number of resolution level */
+
+/* UniPG>> */
+#ifdef USE_JPWL
+#define JPWL_MAX_NO_TILESPECS  16 /**< Maximum number of tile parts expected by JPWL: increase at your will */
+#define JPWL_MAX_NO_PACKSPECS  16 /**< Maximum number of packet parts expected by JPWL: increase at your will */
+#define JPWL_MAX_NO_MARKERS    512 /**< Maximum number of JPWL markers: increase at your will */
+#define JPWL_PRIVATEINDEX_NAME "jpwl_index_privatefilename" /**< index file name used when JPWL is on */
+#define JPWL_EXPECTED_COMPONENTS 3 /**< Expect this number of components, so you'll find better the first EPB */
+#define JPWL_MAXIMUM_TILES 8192 /**< Expect this maximum number of tiles, to avoid some crashes */
+#define JPWL_MAXIMUM_HAMMING 2 /**< Expect this maximum number of bit errors in marker id's */
+#endif /* USE_JPWL */
+/* <<UniPG */
 
 /* 
 ==========================================================
@@ -81,36 +113,57 @@ braindamage below.
 ==========================================================
 */
 
+typedef enum RSIZ_CAPABILITIES {
+       STD_RSIZ = 0,
+       CINEMA2K = 3,           /** Profile name for a 2K image*/
+       CINEMA4K = 4            /** Profile name for a 4K image*/
+} OPJ_RSIZ_CAPABILITIES;
+
+typedef enum CINEMA_MODE {
+       OFF = 0,
+       CINEMA2K_24 = 1,
+       CINEMA2K_48 = 2,
+       CINEMA4K_24 = 3
+}OPJ_CINEMA_MODE;
+
 /** Progression order */
 typedef enum PROG_ORDER {
-  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 */
+       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 */
 } OPJ_PROG_ORDER;
 
 /**
 Supported image color spaces
 */
 typedef enum COLOR_SPACE {
-  CLRSPC_UNKNOWN = -1,  /**< place-holder */
-  CLRSPC_SRGB = 1,    /**< sRGB */
-  CLRSPC_GRAY = 2,    /**< grayscale */
-  CLRSPC_SYCC = 3     /**< YUV */
+       CLRSPC_UNKNOWN = -1,    /**< place-holder */
+       CLRSPC_SRGB = 1,                /**< sRGB */
+       CLRSPC_GRAY = 2,                /**< grayscale */
+       CLRSPC_SYCC = 3                 /**< YUV */
 } OPJ_COLOR_SPACE;
 
 /**
 Supported codec
 */
 typedef enum CODEC_FORMAT {
-  CODEC_UNKNOWN = -1, /**< place-holder */
-  CODEC_J2K = 0,    /**< JPEG-2000 codestream : read/write */
-  CODEC_JPT = 1,    /**< JPT-stream (JPEG 2000, JPIP) : read only */
-  CODEC_JP2 = 2   /**< JPEG-2000 file format : read/write */
+       CODEC_UNKNOWN = -1,     /**< place-holder */
+       CODEC_J2K = 0,          /**< JPEG-2000 codestream : read/write */
+       CODEC_JPT = 1,          /**< JPT-stream (JPEG 2000, JPIP) : read only */
+       CODEC_JP2 = 2           /**< JPEG-2000 file format : read/write */
 } OPJ_CODEC_FORMAT;
 
+/** 
+Limit decoding to certain portions of the codestream. 
+*/
+typedef enum LIMIT_DECODING {
+       NO_LIMITATION = 0,                              /**< No limitation for the decoding. The entire codestream will de decoded */
+       LIMIT_TO_MAIN_HEADER = 1        /**< The decoding is limited to the Main Header */
+} OPJ_LIMIT_DECODING;
+
 /* 
 ==========================================================
    event manager typedef definitions
@@ -134,12 +187,12 @@ used for
 </ul>
 */
 typedef struct opj_event_mgr {
-  /** Error message callback if available, NULL otherwise */
-  opj_msg_callback error_handler;
-  /** Warning message callback if available, NULL otherwise */
-  opj_msg_callback warning_handler;
-  /** Debug message callback if available, NULL otherwise */
-  opj_msg_callback info_handler;
+       /** Error message callback if available, NULL otherwise */
+       opj_msg_callback error_handler;
+       /** Warning message callback if available, NULL otherwise */
+       opj_msg_callback warning_handler;
+       /** Debug message callback if available, NULL otherwise */
+       opj_msg_callback info_handler;
 } opj_event_mgr_t;
 
 
@@ -164,135 +217,198 @@ typedef struct opj_poc {
 Compression parameters
 */
 typedef struct opj_cparameters {
-  /** size of tile: tile_size_on = false (not in argument) or = true (in argument) */
-  bool tile_size_on;
-  /** XTOsiz */
-  int cp_tx0;
-  /** YTOsiz */
-  int cp_ty0;
-  /** XTsiz */
-  int cp_tdx;
-  /** YTsiz */
-  int cp_tdy;
-  /** allocation by rate/distortion */
-  int cp_disto_alloc;
-  /** allocation by fixed layer */
-  int cp_fixed_alloc;
-  /** add fixed_quality */
-  int cp_fixed_quality;
-  /** fixed layer */
-  int *cp_matrice;
-  /** comment for coding */
-  char *cp_comment;
-  /** csty : coding style */
-  int csty;
-  /** progression order (default LRCP) */
-  OPJ_PROG_ORDER prog_order;
-  /** progression order changes */
-  opj_poc_t POC[32];
-  /** number of progression order changes (POC), default to 0 */
-  int numpocs;
-  /** number of layers */
-  int tcp_numlayers;
-  /** rates of layers */
-  int tcp_rates[100];
-  /** different psnr for successive layers */
-  float tcp_distoratio[100];
-  /** number of resolutions */
-  int numresolution;
-  /** initial code block width, default to 64 */
-  int cblockw_init;
-  /** initial code block height, default to 64 */
-  int cblockh_init;
-  /** mode switch (cblk_style) */
-  int mode;
-  /** 1 : use the irreversible DWT 9-7, 0 : use lossless compression (default) */
-  int irreversible;
-  /** region of interest: affected component in [0..3], -1 means no ROI */
-  int roi_compno;
-  /** region of interest: upshift value */
-  int roi_shift;
-  /* number of precinct size specifications */
-  int res_spec;
-  /** initial precinct width */
-  int prcw_init[J2K_MAXRLVLS];
-  /** initial precinct height */
-  int prch_init[J2K_MAXRLVLS];
-
-  /**@name command line encoder parameters (not used inside the library) */
-  /*@{*/
-  /** input file name */
-  char infile[MAX_PATH];
-  /** output file name */
-  char outfile[MAX_PATH];
-  /** creation of an index file, default to 0 (false) */
-  int index_on;
-  /** index file name */
-  char index[MAX_PATH];
-  /** subimage encoding: origin image offset in x direction */
-  int image_offset_x0;
-  /** subimage encoding: origin image offset in y direction */
-  int image_offset_y0;
-  /** subsampling value for dx */
-  int subsampling_dx;
-  /** subsampling value for dy */
-  int subsampling_dy;
-  /** input file format 0: PGX, 1: PxM, 2: BMP */
-  int decod_format;
-  /** output file format 0: J2K, 1: JP2, 2: JPT */
-  int cod_format;
-  /*@}*/
+       /** Digital Cinema compliance 0-not compliant, 1-compliant*/
+       OPJ_CINEMA_MODE cp_cinema;
+       /** Progression order*/
+       char cp_prog[4];
+       /** Profile name*/
+       OPJ_RSIZ_CAPABILITIES cp_rsiz;
+       /** size of tile: tile_size_on = false (not in argument) or = true (in argument) */
+       bool tile_size_on;
+       /** XTOsiz */
+       int cp_tx0;
+       /** YTOsiz */
+       int cp_ty0;
+       /** XTsiz */
+       int cp_tdx;
+       /** YTsiz */
+       int cp_tdy;
+       /** allocation by rate/distortion */
+       int cp_disto_alloc;
+       /** allocation by fixed layer */
+       int cp_fixed_alloc;
+       /** add fixed_quality */
+       int cp_fixed_quality;
+       /** fixed layer */
+       int *cp_matrice;
+       /** comment for coding */
+       char *cp_comment;
+       /** csty : coding style */
+       int csty;
+       /** progression order (default LRCP) */
+       OPJ_PROG_ORDER prog_order;
+       /** progression order changes */
+       opj_poc_t POC[32];
+       /** number of progression order changes (POC), default to 0 */
+       int numpocs;
+       /** number of layers */
+       int tcp_numlayers;
+       /** rates of layers */
+       float tcp_rates[100];
+       /** different psnr for successive layers */
+       float tcp_distoratio[100];
+       /** number of resolutions */
+       int numresolution;
+       /** initial code block width, default to 64 */
+       int cblockw_init;
+       /** initial code block height, default to 64 */
+       int cblockh_init;
+       /** mode switch (cblk_style) */
+       int mode;
+       /** 1 : use the irreversible DWT 9-7, 0 : use lossless compression (default) */
+       int irreversible;
+       /** region of interest: affected component in [0..3], -1 means no ROI */
+       int roi_compno;
+       /** region of interest: upshift value */
+       int roi_shift;
+       /* number of precinct size specifications */
+       int res_spec;
+       /** initial precinct width */
+       int prcw_init[J2K_MAXRLVLS];
+       /** initial precinct height */
+       int prch_init[J2K_MAXRLVLS];
+
+       /**@name command line encoder parameters (not used inside the library) */
+       /*@{*/
+       /** input file name */
+       char infile[OPJ_PATH_LEN];
+       /** output file name */
+       char outfile[OPJ_PATH_LEN];
+       /** creation of an index file, default to 0 (false) */
+       int index_on;
+       /** index file name */
+       char index[OPJ_PATH_LEN];
+       /** subimage encoding: origin image offset in x direction */
+       int image_offset_x0;
+       /** subimage encoding: origin image offset in y direction */
+       int image_offset_y0;
+       /** subsampling value for dx */
+       int subsampling_dx;
+       /** subsampling value for dy */
+       int subsampling_dy;
+       /** input file format 0: PGX, 1: PxM, 2: BMP 3:TIF*/
+       int decod_format;
+       /** output file format 0: J2K, 1: JP2, 2: JPT */
+       int cod_format;
+       /*@}*/
+
+/* UniPG>> */
+#ifdef USE_JPWL
+       /**@name JPWL encoding parameters */
+       /*@{*/
+       /** enables writing of EPC in MH, thus activating JPWL */
+       bool jpwl_epc_on;
+       /** error protection method for MH (0,1,16,32,37-128) */
+       int jpwl_hprot_MH;
+       /** tile number of header protection specification (>=0) */
+       int jpwl_hprot_TPH_tileno[JPWL_MAX_NO_TILESPECS];
+       /** error protection methods for TPHs (0,1,16,32,37-128) */
+       int jpwl_hprot_TPH[JPWL_MAX_NO_TILESPECS];
+       /** tile number of packet protection specification (>=0) */
+       int jpwl_pprot_tileno[JPWL_MAX_NO_PACKSPECS];
+       /** packet number of packet protection specification (>=0) */
+       int jpwl_pprot_packno[JPWL_MAX_NO_PACKSPECS];
+       /** error protection methods for packets (0,1,16,32,37-128) */
+       int jpwl_pprot[JPWL_MAX_NO_PACKSPECS];
+       /** enables writing of ESD, (0=no/1/2 bytes) */
+       int jpwl_sens_size;
+       /** sensitivity addressing size (0=auto/2/4 bytes) */
+       int jpwl_sens_addr;
+       /** sensitivity range (0-3) */
+       int jpwl_sens_range;
+       /** sensitivity method for MH (-1=no,0-7) */
+       int jpwl_sens_MH;
+       /** tile number of sensitivity specification (>=0) */
+       int jpwl_sens_TPH_tileno[JPWL_MAX_NO_TILESPECS];
+       /** sensitivity methods for TPHs (-1=no,0-7) */
+       int jpwl_sens_TPH[JPWL_MAX_NO_TILESPECS];
+       /*@}*/
+#endif /* USE_JPWL */
+/* <<UniPG */
+
 } opj_cparameters_t;
 
 /**
 Decompression parameters
 */
 typedef struct opj_dparameters {
-  /** 
-  Set the number of highest resolution levels to be discarded. 
-  The image resolution is effectively divided by 2 to the power of the number of discarded levels. 
-  The reduce factor is limited by the smallest total number of decomposition levels among tiles.
-  if != 0, then original dimension divided by 2^(reduce); 
-  if == 0 or not used, image is decoded to the full resolution 
-  */
-  int cp_reduce;
-  /** 
-  Set the maximum number of quality layers to decode. 
-  If there are less quality layers than the specified number, all the quality layers are decoded.
-  if != 0, then only the first "layer" layers are decoded; 
-  if == 0 or not used, all the quality layers are decoded 
-  */
-  int cp_layer;
-
-  /**@name command line encoder parameters (not used inside the library) */
-  /*@{*/
-  /** input file name */
-  char infile[MAX_PATH];
-  /** output file name */
-  char outfile[MAX_PATH];
-  /** input file format 0: J2K, 1: JP2, 2: JPT */
-  int decod_format;
-  /** output file format 0: PGX, 1: PxM, 2: BMP */
-  int cod_format;
-  /*@}*/
+       /** 
+       Set the number of highest resolution levels to be discarded. 
+       The image resolution is effectively divided by 2 to the power of the number of discarded levels. 
+       The reduce factor is limited by the smallest total number of decomposition levels among tiles.
+       if != 0, then original dimension divided by 2^(reduce); 
+       if == 0 or not used, image is decoded to the full resolution 
+       */
+       int cp_reduce;
+       /** 
+       Set the maximum number of quality layers to decode. 
+       If there are less quality layers than the specified number, all the quality layers are decoded.
+       if != 0, then only the first "layer" layers are decoded; 
+       if == 0 or not used, all the quality layers are decoded 
+       */
+       int cp_layer;
+
+       /** 
+       Specify whether the decoding should be done on the entire codestream, or be limited to the main header
+       Limiting the decoding to the main header makes it possible to extract the characteristics of the codestream
+       if == NO_LIMITATION, the entire codestream is decoded; 
+       if == LIMIT_TO_MAIN_HEADER, only the main header is decoded; 
+       */
+       OPJ_LIMIT_DECODING cp_limit_decoding;
+
+       /**@name command line encoder parameters (not used inside the library) */
+       /*@{*/
+       /** input file name */
+       char infile[OPJ_PATH_LEN];
+       /** output file name */
+       char outfile[OPJ_PATH_LEN];
+       /** input file format 0: J2K, 1: JP2, 2: JPT */
+       int decod_format;
+       /** output file format 0: PGX, 1: PxM, 2: BMP */
+       int cod_format;
+       /*@}*/
+
+/* UniPG>> */
+#ifdef USE_JPWL
+       /**@name JPWL decoding parameters */
+       /*@{*/
+       /** activates the JPWL correction capabilities */
+       bool jpwl_correct;
+       /** expected number of components */
+       int jpwl_exp_comps;
+       /** maximum number of tiles */
+       int jpwl_max_tiles;
+       /*@}*/
+#endif /* USE_JPWL */
+/* <<UniPG */
 } opj_dparameters_t;
 
 /** Common fields between JPEG-2000 compression and decompression master structs. */
 
 #define opj_common_fields \
-  opj_event_mgr_t *event_mgr; /**< pointer to the event manager */\
-  void * client_data;     /**< Available for use by application */\
-  bool is_decompressor;   /**< So common code can tell which is which */\
-  OPJ_CODEC_FORMAT codec_format;  /**< selected codec */\
-  void *j2k_handle;     /**< pointer to the J2K codec */\
-  void *jp2_handle      /**< pointer to the JP2 codec */
-  
+       opj_event_mgr_t *event_mgr;     /**< pointer to the event manager */\
+       void * client_data;                     /**< Available for use by application */\
+       bool is_decompressor;           /**< So common code can tell which is which */\
+       OPJ_CODEC_FORMAT codec_format;  /**< selected codec */\
+       void *j2k_handle;                       /**< pointer to the J2K codec */\
+       void *jp2_handle                        /**< pointer to the JP2 codec */
+       
 /* Routines that are to be used by both halves of the library are declared
  * to receive a pointer to this structure.  There are no actual instances of
  * opj_common_struct_t, only of opj_cinfo_t and opj_dinfo_t.
  */
 typedef struct opj_common_struct {
-  opj_common_fields;    /* Fields common to both master struct types */
+  opj_common_fields;           /* Fields common to both master struct types */
   /* Additional fields follow in an actual opj_cinfo_t or
    * opj_dinfo_t.  All three structs must agree on these
    * initial fields!  (This would be a lot cleaner in C++.)
@@ -305,18 +421,18 @@ typedef opj_common_struct_t * opj_common_ptr;
 Compression context info
 */
 typedef struct opj_cinfo {
-  /** Fields shared with opj_dinfo_t */
-  opj_common_fields;  
-  /* other specific fields go here */
+       /** Fields shared with opj_dinfo_t */
+       opj_common_fields;      
+       /* other specific fields go here */
 } opj_cinfo_t;
 
 /**
 Decompression context info
 */
 typedef struct opj_dinfo {
-  /** Fields shared with opj_cinfo_t */
-  opj_common_fields;  
-  /* other specific fields go here */
+       /** Fields shared with opj_cinfo_t */
+       opj_common_fields;      
+       /* other specific fields go here */
 } opj_dinfo_t;
 
 /* 
@@ -329,7 +445,7 @@ typedef struct opj_dinfo {
  * Stream open flags.
  */
 /** The stream was opened for reading. */
-#define OPJ_STREAM_READ 0x0001
+#define OPJ_STREAM_READ        0x0001
 /** The stream was opened for writing. */
 #define OPJ_STREAM_WRITE 0x0002
 
@@ -337,22 +453,22 @@ typedef struct opj_dinfo {
 Byte input-output stream (CIO)
 */
 typedef struct opj_cio {
-  /** codec context */
-  opj_common_ptr cinfo;
-
-  /** open mode (read/write) either OPJ_STREAM_READ or OPJ_STREAM_WRITE */
-  int openmode;
-  /** pointer to the start of the buffer */
-  unsigned char *buffer;
-  /** buffer size in bytes */
-  int length;
-
-  /** pointer to the start of the stream */
-  unsigned char *start;
-  /** pointer to the end of the stream */
-  unsigned char *end;
-  /** pointer to the current position */
-  unsigned char *bp;
+       /** codec context */
+       opj_common_ptr cinfo;
+
+       /** open mode (read/write) either OPJ_STREAM_READ or OPJ_STREAM_WRITE */
+       int openmode;
+       /** pointer to the start of the buffer */
+       unsigned char *buffer;
+       /** buffer size in bytes */
+       int length;
+
+       /** pointer to the start of the stream */
+       unsigned char *start;
+       /** pointer to the end of the stream */
+       unsigned char *end;
+       /** pointer to the current position */
+       unsigned char *bp;
 } opj_cio_t;
 
 /* 
@@ -365,80 +481,89 @@ typedef struct opj_cio {
 Defines a single image component
 */
 typedef struct opj_image_comp {
-  /** XRsiz: horizontal separation of a sample of ith component with respect to the reference grid */
-  int dx;
-  /** YRsiz: vertical separation of a sample of ith component with respect to the reference grid */
-  int dy;
-  /** data width */
-  int w;
-  /** data height */
-  int h;
-  /** x component offset compared to the whole image */
-  int x0;
-  /** y component offset compared to the whole image */
-  int y0;
-  /** precision */
-  int prec;
-  /** image depth in bits */
-  int bpp;
-  /** signed (1) / unsigned (0) */
-  int sgnd;
-  /** number of decoded resolution */
-  int resno_decoded;
-  /** number of division by 2 of the out image compared to the original size of image */
-  int factor;
-  /** image component data */
-  int *data;
+       /** XRsiz: horizontal separation of a sample of ith component with respect to the reference grid */
+       int dx;
+       /** YRsiz: vertical separation of a sample of ith component with respect to the reference grid */
+       int dy;
+       /** data width */
+       int w;
+       /** data height */
+       int h;
+       /** x component offset compared to the whole image */
+       int x0;
+       /** y component offset compared to the whole image */
+       int y0;
+       /** precision */
+       int prec;
+       /** image depth in bits */
+       int bpp;
+       /** signed (1) / unsigned (0) */
+       int sgnd;
+       /** number of decoded resolution */
+       int resno_decoded;
+       /** number of division by 2 of the out image compared to the original size of image */
+       int factor;
+       /** image component data */
+       int *data;
 } opj_image_comp_t;
 
 /** 
 Defines image data and characteristics
 */
 typedef struct opj_image {
-  /** XOsiz: horizontal offset from the origin of the reference grid to the left side of the image area */
-  int x0;
-  /** YOsiz: vertical offset from the origin of the reference grid to the top side of the image area */
-  int y0;
-  /** Xsiz: width of the reference grid */
-  int x1;
-  /** Ysiz: height of the reference grid */
-  int y1;
-  /** number of components in the image */
-  int numcomps;
-  /** color space: sRGB, Greyscale or YUV */
-  OPJ_COLOR_SPACE color_space;
-  /** image components */
-  opj_image_comp_t *comps;
+       /** XOsiz: horizontal offset from the origin of the reference grid to the left side of the image area */
+       int x0;
+       /** YOsiz: vertical offset from the origin of the reference grid to the top side of the image area */
+       int y0;
+       /** Xsiz: width of the reference grid */
+       int x1;
+       /** Ysiz: height of the reference grid */
+       int y1;
+       /** number of components in the image */
+       int numcomps;
+       /** color space: sRGB, Greyscale or YUV */
+       OPJ_COLOR_SPACE color_space;
+       /** image components */
+       opj_image_comp_t *comps;
 } opj_image_t;
 
 /**
 Component parameters structure used by the opj_image_create function
 */
 typedef struct opj_image_comptparm {
-  /** XRsiz: horizontal separation of a sample of ith component with respect to the reference grid */
-  int dx;
-  /** YRsiz: vertical separation of a sample of ith component with respect to the reference grid */
-  int dy;
-  /** data width */
-  int w;
-  /** data height */
-  int h;
-  /** x component offset compared to the whole image */
-  int x0;
-  /** y component offset compared to the whole image */
-  int y0;
-  /** precision */
-  int prec;
-  /** image depth in bits */
-  int bpp;
-  /** signed (1) / unsigned (0) */
-  int sgnd;
+       /** XRsiz: horizontal separation of a sample of ith component with respect to the reference grid */
+       int dx;
+       /** YRsiz: vertical separation of a sample of ith component with respect to the reference grid */
+       int dy;
+       /** data width */
+       int w;
+       /** data height */
+       int h;
+       /** x component offset compared to the whole image */
+       int x0;
+       /** y component offset compared to the whole image */
+       int y0;
+       /** precision */
+       int prec;
+       /** image depth in bits */
+       int bpp;
+       /** signed (1) / unsigned (0) */
+       int sgnd;
 } opj_image_cmptparm_t;
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
+
+/* 
+==========================================================
+   openjpeg version
+==========================================================
+*/
+
+OPJ_API const char * OPJ_CALLCONV opj_version();
+
 /* 
 ==========================================================
    image functions definitions
@@ -452,13 +577,13 @@ Create an image
 @param clrspc image color space
 @return returns a new image structure if successful, returns NULL otherwise
 */
-opj_image_t *opj_image_create(int numcmpts, opj_image_cmptparm_t *cmptparms, OPJ_COLOR_SPACE clrspc);
+OPJ_API opj_image_t* OPJ_CALLCONV opj_image_create(int numcmpts, opj_image_cmptparm_t *cmptparms, OPJ_COLOR_SPACE clrspc);
 
 /**
 Deallocate any resources associated with an image
 @param image image to be destroyed
 */
-void opj_image_destroy(opj_image_t *image);
+OPJ_API void OPJ_CALLCONV opj_image_destroy(opj_image_t *image);
 
 /* 
 ==========================================================
@@ -477,26 +602,26 @@ to contain encoded data.
 @param length Reading: buffer length. Writing: 0
 @return Returns a CIO handle if successful, returns NULL otherwise
 */
-opj_cio_t* opj_cio_open(opj_common_ptr cinfo, unsigned char *buffer, int length);
+OPJ_API opj_cio_t* OPJ_CALLCONV opj_cio_open(opj_common_ptr cinfo, unsigned char *buffer, int length);
 
 /**
 Close and free a CIO handle
 @param cio CIO handle to free
 */
-void opj_cio_close(opj_cio_t *cio);
+OPJ_API void OPJ_CALLCONV opj_cio_close(opj_cio_t *cio);
 
 /**
 Get position in byte stream
 @param cio CIO handle
 @return Returns the position in bytes
 */
-int cio_tell(opj_cio_t *cio);
+OPJ_API int OPJ_CALLCONV cio_tell(opj_cio_t *cio);
 /**
 Set position in byte stream
 @param cio CIO handle
 @param pos Position, in number of bytes, from the beginning of the stream
 */
-void cio_seek(opj_cio_t *cio, int pos);
+OPJ_API void OPJ_CALLCONV cio_seek(opj_cio_t *cio, int pos);
 
 /* 
 ==========================================================
@@ -504,7 +629,7 @@ void cio_seek(opj_cio_t *cio, int pos);
 ==========================================================
 */
 
-opj_event_mgr_t* opj_set_event_mgr(opj_common_ptr cinfo, opj_event_mgr_t *event_mgr, void *context);
+OPJ_API opj_event_mgr_t* OPJ_CALLCONV opj_set_event_mgr(opj_common_ptr cinfo, opj_event_mgr_t *event_mgr, void *context);
 
 /* 
 ==========================================================
@@ -516,42 +641,42 @@ Creates a J2K/JPT/JP2 decompression structure
 @param format Decoder to select
 @return Returns a handle to a decompressor if successful, returns NULL otherwise
 */
-opj_dinfo_t* opj_create_decompress(OPJ_CODEC_FORMAT format);
+OPJ_API opj_dinfo_t* OPJ_CALLCONV opj_create_decompress(OPJ_CODEC_FORMAT format);
 /**
 Destroy a decompressor handle
 @param dinfo decompressor handle to destroy
 */
-void opj_destroy_decompress(opj_dinfo_t *dinfo);
+OPJ_API void OPJ_CALLCONV opj_destroy_decompress(opj_dinfo_t *dinfo);
 /**
 Set decoding parameters to default values
 @param parameters Decompression parameters
 */
-void opj_set_default_decoder_parameters(opj_dparameters_t *parameters);
+OPJ_API void OPJ_CALLCONV opj_set_default_decoder_parameters(opj_dparameters_t *parameters);
 /**
 Setup the decoder decoding parameters using user parameters.
 Decoding parameters are returned in j2k->cp. 
 @param dinfo decompressor handle
 @param parameters decompression parameters
 */
-void opj_setup_decoder(opj_dinfo_t *dinfo, opj_dparameters_t *parameters);
+OPJ_API void OPJ_CALLCONV opj_setup_decoder(opj_dinfo_t *dinfo, opj_dparameters_t *parameters);
 /**
 Decode an image from a JPEG-2000 codestream
 @param dinfo decompressor handle
 @param cio Input buffer stream
 @return Returns a decoded image if successful, returns NULL otherwise
 */
-opj_image_t* opj_decode(opj_dinfo_t *dinfo, opj_cio_t *cio);
+OPJ_API opj_image_t* OPJ_CALLCONV opj_decode(opj_dinfo_t *dinfo, opj_cio_t *cio);
 /**
 Creates a J2K/JP2 compression structure
 @param format Coder to select
 @return Returns a handle to a compressor if successful, returns NULL otherwise
 */
-opj_cinfo_t* opj_create_compress(OPJ_CODEC_FORMAT format);
+OPJ_API opj_cinfo_t* OPJ_CALLCONV opj_create_compress(OPJ_CODEC_FORMAT format);
 /**
 Destroy a compressor handle
 @param cinfo compressor handle to destroy
 */
-void opj_destroy_compress(opj_cinfo_t *cinfo);
+OPJ_API void OPJ_CALLCONV opj_destroy_compress(opj_cinfo_t *cinfo);
 /**
 Set encoding parameters to default values, that means : 
 <ul>
@@ -573,14 +698,14 @@ Set encoding parameters to default values, that means :
 </ul>
 @param parameters Compression parameters
 */
-void opj_set_default_encoder_parameters(opj_cparameters_t *parameters);
+OPJ_API void OPJ_CALLCONV opj_set_default_encoder_parameters(opj_cparameters_t *parameters);
 /**
 Setup the encoder parameters using the current image and using user parameters. 
 @param cinfo compressor handle
 @param parameters compression parameters
 @param image input filled image
 */
-void opj_setup_encoder(opj_cinfo_t *cinfo, opj_cparameters_t *parameters, opj_image_t *image);
+OPJ_API void OPJ_CALLCONV opj_setup_encoder(opj_cinfo_t *cinfo, opj_cparameters_t *parameters, opj_image_t *image);
 /**
 Encode an image into a JPEG-2000 codestream
 @param cinfo compressor handle
@@ -589,7 +714,7 @@ Encode an image into a JPEG-2000 codestream
 @param index Name of the index file if required, NULL otherwise
 @return Returns true if successful, returns false otherwise
 */
-bool opj_encode(opj_cinfo_t *cinfo, opj_cio_t *cio, opj_image_t *image, char *index);
+OPJ_API bool OPJ_CALLCONV opj_encode(opj_cinfo_t *cinfo, opj_cio_t *cio, opj_image_t *image, char *index);
 
 #ifdef __cplusplus
 }