Revert "OpenJPEG: update to 2.1 from 1.5"
[blender.git] / extern / libopenjpeg / openjpeg.h
index 988db720092c63f71de29213d5e1462708620a8f..59147c8b3d1237fb0a3a96c9a7044619355c88df 100644 (file)
@@ -1,21 +1,12 @@
  /*
- * The copyright in this software is being made available under the 2-clauses 
- * BSD License, included below. This software may be subject to other third 
- * party and contributor rights, including patent rights, and no such rights
- * are granted under this license.
- *
- * Copyright (c) 2002-2014, Universite catholique de Louvain (UCL), Belgium
- * Copyright (c) 2002-2014, Professor Benoit Macq
+ * 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-2007, Francois-Olivier Devaux 
- * Copyright (c) 2003-2014, Antonin Descampe
+ * Copyright (c) 2003-2007, Francois-Olivier Devaux and Antonin Descampe
  * Copyright (c) 2005, Herve Drolon, FreeImage Team
  * Copyright (c) 2006-2007, Parvatha Elangovan
- * Copyright (c) 2008, Jerome Fimes, Communications & Systemes <jerome.fimes@c-s.fr>
  * Copyright (c) 2010-2011, Kaori Hagihara
- * Copyright (c) 2011-2012, Centre National d'Etudes Spatiales (CNES), France 
- * Copyright (c) 2012, CS Systemes d'Information, France
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
 ==========================================================
 */
 
-/*
-The inline keyword is supported by C99 but not by C90. 
-Most compilers implement their own version of this keyword ... 
-*/
-#ifndef INLINE
-       #if defined(_MSC_VER)
-               #define INLINE __forceinline
-       #elif defined(__GNUC__)
-               #define INLINE __inline__
-       #elif defined(__MWERKS__)
-               #define INLINE inline
-       #else 
-               /* add other compilers here ... */
-               #define INLINE 
-       #endif /* defined(<Compiler>) */
-#endif /* INLINE */
-
-/* deprecated attribute */
-#ifdef __GNUC__
-       #define OPJ_DEPRECATED(func) func __attribute__ ((deprecated))
-#elif defined(_MSC_VER)
-       #define OPJ_DEPRECATED(func) __declspec(deprecated) func
-#else
-       #pragma message("WARNING: You need to implement DEPRECATED for this compiler")
-       #define OPJ_DEPRECATED(func) func
-#endif
-
 #if defined(OPJ_STATIC) || !defined(_WIN32)
-/* http://gcc.gnu.org/wiki/Visibility */
-#if __GNUC__ >= 4
-#define OPJ_API    __attribute__ ((visibility ("default")))
-#define OPJ_LOCAL  __attribute__ ((visibility ("hidden")))
-#else
 #define OPJ_API
-#define OPJ_LOCAL
-#endif
 #define OPJ_CALLCONV
 #else
 #define OPJ_CALLCONV __stdcall
@@ -103,34 +60,12 @@ defined with this macro as being exported.
 #endif /* OPJ_EXPORTS */
 #endif /* !OPJ_STATIC || !_WIN32 */
 
-typedef int OPJ_BOOL;
+typedef int opj_bool;
 #define OPJ_TRUE 1
 #define OPJ_FALSE 0
 
-typedef char          OPJ_CHAR;
-typedef float         OPJ_FLOAT32;
-typedef double        OPJ_FLOAT64;
-typedef unsigned char OPJ_BYTE;
-
-#include "opj_stdint.h"
-
-typedef int8_t   OPJ_INT8;
-typedef uint8_t  OPJ_UINT8;
-typedef int16_t  OPJ_INT16;
-typedef uint16_t OPJ_UINT16;
-typedef int32_t  OPJ_INT32;
-typedef uint32_t OPJ_UINT32;
-typedef int64_t  OPJ_INT64;
-typedef uint64_t OPJ_UINT64;
-
-typedef int64_t  OPJ_OFF_T; /* 64-bit file offset type */
-
-#include <stdio.h>
-typedef size_t   OPJ_SIZE_T;
-
 /* Avoid compile-time warning because parameter is not used */
 #define OPJ_ARG_NOT_USED(x) (void)(x)
-
 /* 
 ==========================================================
    Useful constant definitions
@@ -139,16 +74,10 @@ typedef size_t   OPJ_SIZE_T;
 
 #define OPJ_PATH_LEN 4096 /**< Maximum allowed size for filenames */
 
-#define OPJ_J2K_MAXRLVLS 33                                    /**< Number of maximum resolution level authorized */
-#define OPJ_J2K_MAXBANDS (3*OPJ_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 */
 
-#define OPJ_J2K_DEFAULT_NB_SEGS                                10
-#define OPJ_J2K_STREAM_CHUNK_SIZE                      0x100000 /** 1 mega by default */
-#define OPJ_J2K_DEFAULT_HEADER_SIZE                    1000
-#define OPJ_J2K_MCC_DEFAULT_NB_RECORDS         10
-#define OPJ_J2K_MCT_DEFAULT_NB_RECORDS         10
-
-/* UniPG>> */ /* NOT YET USED IN THE V2 VERSION OF OPENJPEG */
+/* UniPG>> */
 #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 */
@@ -159,141 +88,75 @@ typedef size_t   OPJ_SIZE_T;
 #define JPWL_MAXIMUM_EPB_ROOM 65450 /**< Expect this maximum number of bytes for composition of EPBs */
 /* <<UniPG */
 
-/**
- * EXPERIMENTAL FOR THE MOMENT
- * Supported options about file information used only in j2k_dump
-*/
-#define OPJ_IMG_INFO           1       /**< Basic image information provided to the user */
-#define OPJ_J2K_MH_INFO                2       /**< Codestream information based only on the main header */
-#define OPJ_J2K_TH_INFO                4       /**< Tile information based on the current tile header */
-#define OPJ_J2K_TCH_INFO       8       /**< Tile/Component information of all tiles */
-#define OPJ_J2K_MH_IND         16      /**< Codestream index based only on the main header */
-#define OPJ_J2K_TH_IND         32      /**< Tile index based on the current tile */
-/*FIXME #define OPJ_J2K_CSTR_IND       48*/    /**<  */
-#define OPJ_JP2_INFO           128     /**< JP2 file information */
-#define OPJ_JP2_IND                    256     /**< JP2 file index */
-
-/**
- * JPEG 2000 Profiles, see Table A.10 from 15444-1 (updated in various AMD)
- * These values help chosing the RSIZ value for the J2K codestream.
- * The RSIZ value triggers various encoding options, as detailed in Table A.10.
- * If OPJ_PROFILE_PART2 is chosen, it has to be combined with one or more extensions
- * described hereunder.
- *   Example: rsiz = OPJ_PROFILE_PART2 | OPJ_EXTENSION_MCT;
- * For broadcast profiles, the OPJ_PROFILE value has to be combined with the targeted
- * mainlevel (3-0 LSB, value between 0 and 11):
- *   Example: rsiz = OPJ_PROFILE_BC_MULTI | 0x0005; (here mainlevel 5)
- * For IMF profiles, the OPJ_PROFILE value has to be combined with the targeted mainlevel
- * (3-0 LSB, value between 0 and 11) and sublevel (7-4 LSB, value between 0 and 9):
- *   Example: rsiz = OPJ_PROFILE_IMF_2K | 0x0040 | 0x0005; (here main 5 and sublevel 4)
- * */
-#define OPJ_PROFILE_NONE        0x0000 /** no profile, conform to 15444-1 */
-#define OPJ_PROFILE_0           0x0001 /** Profile 0 as described in 15444-1,Table A.45 */
-#define OPJ_PROFILE_1           0x0002 /** Profile 1 as described in 15444-1,Table A.45 */
-#define OPJ_PROFILE_PART2       0x8000 /** At least 1 extension defined in 15444-2 (Part-2) */
-#define OPJ_PROFILE_CINEMA_2K   0x0003 /** 2K cinema profile defined in 15444-1 AMD1 */
-#define OPJ_PROFILE_CINEMA_4K   0x0004 /** 4K cinema profile defined in 15444-1 AMD1 */
-#define OPJ_PROFILE_CINEMA_S2K  0x0005 /** Scalable 2K cinema profile defined in 15444-1 AMD2 */
-#define OPJ_PROFILE_CINEMA_S4K  0x0006 /** Scalable 4K cinema profile defined in 15444-1 AMD2 */
-#define OPJ_PROFILE_CINEMA_LTS  0x0007 /** Long term storage cinema profile defined in 15444-1 AMD2 */
-#define OPJ_PROFILE_BC_SINGLE   0x0100 /** Single Tile Broadcast profile defined in 15444-1 AMD3 */
-#define OPJ_PROFILE_BC_MULTI    0x0200 /** Multi Tile Broadcast profile defined in 15444-1 AMD3 */
-#define OPJ_PROFILE_BC_MULTI_R  0x0300 /** Multi Tile Reversible Broadcast profile defined in 15444-1 AMD3 */
-#define OPJ_PROFILE_IMF_2K      0x0400 /** 2K Single Tile Lossy IMF profile defined in 15444-1 AMD 8 */
-#define OPJ_PROFILE_IMF_4K      0x0401 /** 4K Single Tile Lossy IMF profile defined in 15444-1 AMD 8 */
-#define OPJ_PROFILE_IMF_8K      0x0402 /** 8K Single Tile Lossy IMF profile defined in 15444-1 AMD 8 */
-#define OPJ_PROFILE_IMF_2K_R    0x0403 /** 2K Single/Multi Tile Reversible IMF profile defined in 15444-1 AMD 8 */
-#define OPJ_PROFILE_IMF_4K_R    0x0800 /** 4K Single/Multi Tile Reversible IMF profile defined in 15444-1 AMD 8 */
-#define OPJ_PROFILE_IMF_8K_R    0x0801  /** 8K Single/Multi Tile Reversible IMF profile defined in 15444-1 AMD 8 */
-
-/**
- * JPEG 2000 Part-2 extensions
- * */
-#define OPJ_EXTENSION_NONE      0x0000 /** No Part-2 extension */
-#define OPJ_EXTENSION_MCT       0x0100  /** Custom MCT support */
-
-/**
- * JPEG 2000 profile macros
- * */
-#define OPJ_IS_CINEMA(v)     (((v) >= OPJ_PROFILE_CINEMA_2K)&&((v) <= OPJ_PROFILE_CINEMA_S4K))
-#define OPJ_IS_STORAGE(v)    ((v) == OPJ_PROFILE_CINEMA_LTS)
-#define OPJ_IS_BROADCAST(v)  (((v) >= OPJ_PROFILE_BC_SINGLE)&&((v) <= ((OPJ_PROFILE_BC_MULTI_R) | (0x000b))))
-#define OPJ_IS_IMF(v)        (((v) >= OPJ_PROFILE_IMF_2K)&&((v) <= ((OPJ_PROFILE_IMF_8K_R) | (0x009b))))
-#define OPJ_IS_PART2(v)      ((v) & OPJ_PROFILE_PART2)
-
-/**
- * JPEG 2000 codestream and component size limits in cinema profiles
- * */
-#define OPJ_CINEMA_24_CS     1302083           /** Maximum codestream length for 24fps */
-#define OPJ_CINEMA_48_CS     651041     /** Maximum codestream length for 48fps */
-#define OPJ_CINEMA_24_COMP   1041666    /** Maximum size per color component for 2K & 4K @ 24fps */
-#define OPJ_CINEMA_48_COMP   520833            /** Maximum size per color component for 2K @ 48fps */
-
 /* 
 ==========================================================
    enum definitions
 ==========================================================
 */
-
-/**
- * DEPRECATED: use RSIZ, OPJ_PROFILE_* and OPJ_EXTENSION_* instead
- * Rsiz Capabilities
- * */
+/** 
+Rsiz Capabilities
+*/
 typedef enum RSIZ_CAPABILITIES {
-    OPJ_STD_RSIZ = 0,          /** Standard JPEG2000 profile*/
-    OPJ_CINEMA2K = 3,          /** Profile name for a 2K image*/
-    OPJ_CINEMA4K = 4,          /** Profile name for a 4K image*/
-    OPJ_MCT = 0x8100
+       STD_RSIZ = 0,           /** Standard JPEG2000 profile*/
+       CINEMA2K = 3,           /** Profile name for a 2K image*/
+       CINEMA4K = 4            /** Profile name for a 4K image*/
 } OPJ_RSIZ_CAPABILITIES;
 
-/**
- * DEPRECATED: use RSIZ, OPJ_PROFILE_* and OPJ_EXTENSION_* instead
- * Digital cinema operation mode
- * */
+/** 
+Digital cinema operation mode 
+*/
 typedef enum CINEMA_MODE {
-    OPJ_OFF = 0,                       /** Not Digital Cinema*/
-    OPJ_CINEMA2K_24 = 1,       /** 2K Digital Cinema at 24 fps*/
-    OPJ_CINEMA2K_48 = 2,       /** 2K Digital Cinema at 48 fps*/
-    OPJ_CINEMA4K_24 = 3                /** 4K Digital Cinema at 24 fps*/
+       OFF = 0,                                        /** Not Digital Cinema*/
+       CINEMA2K_24 = 1,        /** 2K Digital Cinema at 24 fps*/
+       CINEMA2K_48 = 2,        /** 2K Digital Cinema at 48 fps*/
+       CINEMA4K_24 = 3         /** 4K Digital Cinema at 24 fps*/
 }OPJ_CINEMA_MODE;
 
 /** 
- * Progression order
- * */
+Progression order 
+*/
 typedef enum PROG_ORDER {
-       OPJ_PROG_UNKNOWN = -1,  /**< place-holder */
-       OPJ_LRCP = 0,                   /**< layer-resolution-component-precinct order */
-       OPJ_RLCP = 1,                   /**< resolution-layer-component-precinct order */
-       OPJ_RPCL = 2,                   /**< resolution-precinct-component-layer order */
-       OPJ_PCRL = 3,                   /**< precinct-component-resolution-layer order */
-       OPJ_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
+Supported image color spaces
 */
 typedef enum COLOR_SPACE {
-    OPJ_CLRSPC_UNKNOWN = -1,   /**< not supported by the library */
-    OPJ_CLRSPC_UNSPECIFIED = 0,        /**< not specified in the codestream */
-    OPJ_CLRSPC_SRGB = 1,               /**< sRGB */
-    OPJ_CLRSPC_GRAY = 2,               /**< grayscale */
-    OPJ_CLRSPC_SYCC = 3,               /**< YUV */
-    OPJ_CLRSPC_EYCC = 4,        /**< e-YCC */
-    OPJ_CLRSPC_CMYK = 5         /**< CMYK */
+       CLRSPC_UNKNOWN = -1,    /**< not supported by the library */
+       CLRSPC_UNSPECIFIED = 0, /**< not specified in the codestream */ 
+       CLRSPC_SRGB = 1,                /**< sRGB */
+       CLRSPC_GRAY = 2,                /**< grayscale */
+       CLRSPC_SYCC = 3                 /**< YUV */
 } OPJ_COLOR_SPACE;
 
+#define ENUMCS_SRGB 16
+#define ENUMCS_GRAY 17
+#define ENUMCS_SYCC 18
+
 /**
- * Supported codec
+Supported codec
 */
 typedef enum CODEC_FORMAT {
-       OPJ_CODEC_UNKNOWN = -1, /**< place-holder */
-       OPJ_CODEC_J2K  = 0,             /**< JPEG-2000 codestream : read/write */
-       OPJ_CODEC_JPT  = 1,             /**< JPT-stream (JPEG 2000, JPIP) : read only */
-    OPJ_CODEC_JP2  = 2,                /**< JP2 file format : read/write */
-    OPJ_CODEC_JPP  = 3,                /**< JPP-stream (JPEG 2000, JPIP) : to be coded */
-    OPJ_CODEC_JPX  = 4         /**< JPX file format (JPEG 2000 Part-2) : to be coded */
+       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 */
+       DECODE_ALL_BUT_PACKETS = 2      /**< Decode everything except the JPEG 2000 packets */
+} OPJ_LIMIT_DECODING;
 
 /* 
 ==========================================================
@@ -302,12 +165,31 @@ typedef enum CODEC_FORMAT {
 */
 
 /**
- * Callback function prototype for events
- * @param msg               Event message
- * @param client_data       Client object where will be return the event message 
- * */
+Callback function prototype for events
+@param msg Event message
+@param client_data 
+*/
 typedef void (*opj_msg_callback) (const char *msg, void *client_data);
 
+/**
+Message handler object
+used for 
+<ul>
+<li>Error messages
+<li>Warning messages
+<li>Debugging messages
+</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;
+} opj_event_mgr_t;
+
+
 /* 
 ==========================================================
    codec typedef definitions
@@ -315,40 +197,39 @@ typedef void (*opj_msg_callback) (const char *msg, void *client_data);
 */
 
 /**
- * Progression order changes
- * 
- */
+Progression order changes
+*/
 typedef struct opj_poc {
        /** Resolution num start, Component num start, given by POC */
-       OPJ_UINT32 resno0, compno0;
+       int resno0, compno0;
        /** Layer num end,Resolution num end, Component num end, given by POC */
-       OPJ_UINT32 layno1, resno1, compno1;
+       int layno1, resno1, compno1;
        /** Layer num start,Precinct num start, Precinct num end */
-       OPJ_UINT32 layno0, precno0, precno1;
+       int layno0, precno0, precno1;
        /** Progression order enum*/
        OPJ_PROG_ORDER prg1,prg;
        /** Progression order string*/
-       OPJ_CHAR progorder[5];
+       char progorder[5];
        /** Tile number */
-       OPJ_UINT32 tile;
+       int tile;
        /** Start and end values for Tile width and height*/
-       OPJ_INT32 tx0,tx1,ty0,ty1;
+       int tx0,tx1,ty0,ty1;
        /** Start value, initialised in pi_initialise_encode*/
-       OPJ_UINT32 layS, resS, compS, prcS;
+       int layS, resS, compS, prcS;
        /** End value, initialised in pi_initialise_encode */
-       OPJ_UINT32 layE, resE, compE, prcE;
+       int layE, resE, compE, prcE;
        /** Start and end values of Tile width and height, initialised in pi_initialise_encode*/
-       OPJ_UINT32 txS,txE,tyS,tyE,dx,dy;
+       int txS,txE,tyS,tyE,dx,dy;
        /** Temporary values for Tile parts, initialised in pi_create_encode */
-       OPJ_UINT32 lay_t, res_t, comp_t, prc_t,tx0_t,ty0_t;
+       int lay_t, res_t, comp_t, prc_t,tx0_t,ty0_t;
 } opj_poc_t;
 
 /**
- * Compression parameters
- * */
+Compression parameters
+*/
 typedef struct opj_cparameters {
        /** size of tile: tile_size_on = false (not in argument) or = true (in argument) */
-       OPJ_BOOL tile_size_on;
+       opj_bool tile_size_on;
        /** XTOsiz */
        int cp_tx0;
        /** YTOsiz */
@@ -369,15 +250,15 @@ typedef struct opj_cparameters {
        char *cp_comment;
        /** csty : coding style */
        int csty;
-       /** progression order (default OPJ_LRCP) */
+       /** 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 */
-       OPJ_UINT32 numpocs;
+       int numpocs;
        /** number of layers */
        int tcp_numlayers;
-    /** rates of layers - might be subsequently limited by the max_cs_size field */
+       /** rates of layers */
        float tcp_rates[100];
        /** different psnr for successive layers */
        float tcp_distoratio[100];
@@ -398,9 +279,9 @@ typedef struct opj_cparameters {
        /* number of precinct size specifications */
        int res_spec;
        /** initial precinct width */
-       int prcw_init[OPJ_J2K_MAXRLVLS];
+       int prcw_init[J2K_MAXRLVLS];
        /** initial precinct height */
-       int prch_init[OPJ_J2K_MAXRLVLS];
+       int prch_init[J2K_MAXRLVLS];
 
        /**@name command line encoder parameters (not used inside the library) */
        /*@{*/
@@ -426,11 +307,11 @@ typedef struct opj_cparameters {
        int cod_format;
        /*@}*/
 
-/* UniPG>> */ /* NOT YET USED IN THE V2 VERSION OF OPENJPEG */
+/* UniPG>> */
        /**@name JPWL encoding parameters */
        /*@{*/
        /** enables writing of EPC in MH, thus activating JPWL */
-       OPJ_BOOL jpwl_epc_on;
+       opj_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) */
@@ -458,21 +339,12 @@ typedef struct opj_cparameters {
        /*@}*/
 /* <<UniPG */
 
-    /**
-     * DEPRECATED: use RSIZ, OPJ_PROFILE_* and MAX_COMP_SIZE instead
-     * Digital Cinema compliance 0-not compliant, 1-compliant
-     * */
-    OPJ_CINEMA_MODE cp_cinema;
-    /**
-     * Maximum size (in bytes) for each component.
-     * If == 0, component size limitation is not considered
-     * */
+       /** Digital Cinema compliance 0-not compliant, 1-compliant*/
+       OPJ_CINEMA_MODE cp_cinema;
+       /** Maximum rate for each component. If == 0, component size limitation is not considered */
        int max_comp_size;
-    /**
-     * DEPRECATED: use RSIZ, OPJ_PROFILE_* and OPJ_EXTENSION_* instead
-     * Profile name
-     * */
-    OPJ_RSIZ_CAPABILITIES cp_rsiz;
+       /** Profile name*/
+       OPJ_RSIZ_CAPABILITIES cp_rsiz;
        /** Tile part generation*/
        char tp_on;
        /** Flag for Tile part generation*/
@@ -480,27 +352,14 @@ typedef struct opj_cparameters {
        /** MCT (multiple component transform) */
        char tcp_mct;
        /** Enable JPIP indexing*/
-       OPJ_BOOL jpip_on;
-       /** Naive implementation of MCT restricted to a single reversible array based 
-        encoding without offset concerning all the components. */
-       void * mct_data;
-    /**
-     * Maximum size (in bytes) for the whole codestream.
-     * If == 0, codestream size limitation is not considered
-     * If it does not comply with tcp_rates, max_cs_size prevails
-     * and a warning is issued.
-     * */
-    int max_cs_size;
-    /** RSIZ value
-        To be used to combine OPJ_PROFILE_*, OPJ_EXTENSION_* and (sub)levels values. */
-    OPJ_UINT16 rsiz;
-} opj_cparameters_t;  
+       opj_bool jpip_on;
+} opj_cparameters_t;
 
 #define OPJ_DPARAMETERS_IGNORE_PCLR_CMAP_CDEF_FLAG     0x0001
 
 /**
- * Decompression parameters
- * */
+Decompression parameters
+*/
 typedef struct opj_dparameters {
        /** 
        Set the number of highest resolution levels to be discarded. 
@@ -509,16 +368,16 @@ typedef struct opj_dparameters {
        if != 0, then original dimension divided by 2^(reduce); 
        if == 0 or not used, image is decoded to the full resolution 
        */
-       OPJ_UINT32 cp_reduce;
+       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 
        */
-       OPJ_UINT32 cp_layer;
+       int cp_layer;
 
-       /**@name command line decoder parameters (not used inside the library) */
+       /**@name command line encoder parameters (not used inside the library) */
        /*@{*/
        /** input file name */
        char infile[OPJ_PATH_LEN];
@@ -528,30 +387,13 @@ typedef struct opj_dparameters {
        int decod_format;
        /** output file format 0: PGX, 1: PxM, 2: BMP */
        int cod_format;
-
-       /** Decoding area left boundary */
-       OPJ_UINT32 DA_x0;
-       /** Decoding area right boundary */
-       OPJ_UINT32 DA_x1;
-       /** Decoding area up boundary */
-       OPJ_UINT32 DA_y0;
-       /** Decoding area bottom boundary */
-       OPJ_UINT32 DA_y1;
-       /** Verbose mode */
-       OPJ_BOOL m_verbose;
-
-       /** tile number ot the decoded tile*/
-       OPJ_UINT32 tile_index;
-       /** Nb of tile to decode */
-       OPJ_UINT32 nb_tile_to_decode;
-
        /*@}*/
 
-/* UniPG>> */ /* NOT YET USED IN THE V2 VERSION OF OPENJPEG */
+/* UniPG>> */
        /**@name JPWL decoding parameters */
        /*@{*/
        /** activates the JPWL correction capabilities */
-       OPJ_BOOL jpwl_correct;
+       opj_bool jpwl_correct;
        /** expected number of components */
        int jpwl_exp_comps;
        /** maximum number of tiles */
@@ -559,15 +401,59 @@ typedef struct opj_dparameters {
        /*@}*/
 /* <<UniPG */
 
-       unsigned int flags;
+       /** 
+       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;
 
+       unsigned int flags;
 } 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 */\
+       opj_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 */\
+       void *mj2_handle                        /**< pointer to the MJ2 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 */
+  /* 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++.)
+   */
+} opj_common_struct_t;
+
+typedef opj_common_struct_t * opj_common_ptr;
 
 /**
- * JPEG2000 codec V2.
- * */
-typedef void * opj_codec_t;
+Compression context info
+*/
+typedef struct opj_cinfo {
+       /** 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 */
+} opj_dinfo_t;
 
 /* 
 ==========================================================
@@ -575,43 +461,35 @@ typedef void * opj_codec_t;
 ==========================================================
 */
 
-/**
+/*
  * Stream open flags.
- * */
+ */
 /** The stream was opened for reading. */
-#define OPJ_STREAM_READ        OPJ_TRUE
+#define OPJ_STREAM_READ        0x0001
 /** The stream was opened for writing. */
-#define OPJ_STREAM_WRITE OPJ_FALSE
-
-/*
- * Callback function prototype for read function
- */
-typedef OPJ_SIZE_T (* opj_stream_read_fn) (void * p_buffer, OPJ_SIZE_T p_nb_bytes, void * p_user_data) ;
-
-/*
- * Callback function prototype for write function
- */
-typedef OPJ_SIZE_T (* opj_stream_write_fn) (void * p_buffer, OPJ_SIZE_T p_nb_bytes, void * p_user_data) ;
+#define OPJ_STREAM_WRITE 0x0002
 
-/*
- * Callback function prototype for skip function
- */
-typedef OPJ_OFF_T (* opj_stream_skip_fn) (OPJ_OFF_T p_nb_bytes, void * p_user_data) ;
-
-/*
- * Callback function prototype for seek function
- */
-typedef OPJ_BOOL (* opj_stream_seek_fn) (OPJ_OFF_T p_nb_bytes, void * p_user_data) ;
+/**
+Byte input-output stream (CIO)
+*/
+typedef struct opj_cio {
+       /** codec context */
+       opj_common_ptr cinfo;
 
-/*
- * Callback function prototype for free user data function
- */
-typedef void (* opj_stream_free_user_data_fn) (void * p_user_data) ;
+       /** 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;
 
-/*
- * JPEG2000 Stream.
- */
-typedef void * opj_stream_t;
+       /** 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;
 
 /* 
 ==========================================================
@@ -620,104 +498,99 @@ typedef void * opj_stream_t;
 */
 
 /**
- * Defines a single image component
- * */
+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 */
-       OPJ_UINT32 dx;
+       int dx;
        /** YRsiz: vertical separation of a sample of ith component with respect to the reference grid */
-       OPJ_UINT32 dy;
+       int dy;
        /** data width */
-       OPJ_UINT32 w;
+       int w;
        /** data height */
-       OPJ_UINT32 h;
+       int h;
        /** x component offset compared to the whole image */
-       OPJ_UINT32 x0;
+       int x0;
        /** y component offset compared to the whole image */
-       OPJ_UINT32 y0;
+       int y0;
        /** precision */
-       OPJ_UINT32 prec;
+       int prec;
        /** image depth in bits */
-       OPJ_UINT32 bpp;
+       int bpp;
        /** signed (1) / unsigned (0) */
-       OPJ_UINT32 sgnd;
+       int sgnd;
        /** number of decoded resolution */
-       OPJ_UINT32 resno_decoded;
+       int resno_decoded;
        /** number of division by 2 of the out image compared to the original size of image */
-       OPJ_UINT32 factor;
+       int factor;
        /** image component data */
-       OPJ_INT32 *data;
-  /** alpha channel */
-  OPJ_UINT16 alpha;
+       int *data;
 } opj_image_comp_t;
 
 /** 
- * Defines image data and characteristics
- * */
+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 */
-       OPJ_UINT32 x0;
+       int x0;
        /** YOsiz: vertical offset from the origin of the reference grid to the top side of the image area */
-       OPJ_UINT32 y0;
+       int y0;
        /** Xsiz: width of the reference grid */
-       OPJ_UINT32 x1;
+       int x1;
        /** Ysiz: height of the reference grid */
-       OPJ_UINT32 y1;
+       int y1;
        /** number of components in the image */
-       OPJ_UINT32 numcomps;
+       int numcomps;
        /** color space: sRGB, Greyscale or YUV */
        OPJ_COLOR_SPACE color_space;
        /** image components */
        opj_image_comp_t *comps;
        /** 'restricted' ICC profile */
-       OPJ_BYTE *icc_profile_buf;
+       unsigned char *icc_profile_buf;
        /** size of ICC profile */
-       OPJ_UINT32 icc_profile_len;
+       int icc_profile_len;
 } opj_image_t;
 
-
 /**
- * Component parameters structure used by the opj_image_create function
- * */
+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 */
-       OPJ_UINT32 dx;
+       int dx;
        /** YRsiz: vertical separation of a sample of ith component with respect to the reference grid */
-       OPJ_UINT32 dy;
+       int dy;
        /** data width */
-       OPJ_UINT32 w;
+       int w;
        /** data height */
-       OPJ_UINT32 h;
+       int h;
        /** x component offset compared to the whole image */
-       OPJ_UINT32 x0;
+       int x0;
        /** y component offset compared to the whole image */
-       OPJ_UINT32 y0;
+       int y0;
        /** precision */
-       OPJ_UINT32 prec;
+       int prec;
        /** image depth in bits */
-       OPJ_UINT32 bpp;
+       int bpp;
        /** signed (1) / unsigned (0) */
-       OPJ_UINT32 sgnd;
+       int sgnd;
 } opj_image_cmptparm_t;
 
-
 /* 
 ==========================================================
    Information on the JPEG 2000 codestream
 ==========================================================
 */
-/* QUITE EXPERIMENTAL FOR THE MOMENT */
 
 /**
- * Index structure : Information concerning a packet inside tile
- * */
+Index structure : Information concerning a packet inside tile
+*/
 typedef struct opj_packet_info {
        /** packet start position (including SOP marker if it exists) */
-       OPJ_OFF_T start_pos;
+       int start_pos;
        /** end of packet header position (including EPH marker if it exists)*/
-       OPJ_OFF_T end_ph_pos;
+       int end_ph_pos;
        /** packet end position */
-       OPJ_OFF_T end_pos;
+       int end_pos;
        /** packet distorsion */
        double disto;
 } opj_packet_info_t;
@@ -725,20 +598,20 @@ typedef struct opj_packet_info {
 
 /* UniPG>> */
 /**
- * Marker structure
- * */
-typedef struct opj_marker_info {
+Marker structure
+*/
+typedef struct opj_marker_info_t {
        /** marker type */
        unsigned short int type;
        /** position in codestream */
-       OPJ_OFF_T pos;
+       int pos;
        /** length, marker val included */
        int len;
 } opj_marker_info_t;
 /* <<UniPG */
 
 /**
- * Index structure : Information concerning tile-parts
+Index structure : Information concerning tile-parts
 */
 typedef struct opj_tp_info {
        /** start position of tile part */
@@ -754,7 +627,7 @@ typedef struct opj_tp_info {
 } opj_tp_info_t;
 
 /**
- * Index structure : information regarding tiles
+Index structure : information regarding tiles 
 */
 typedef struct opj_tile_info {
        /** value of thresh for each layer by tile cfr. Marcela   */
@@ -794,7 +667,7 @@ typedef struct opj_tile_info {
 } opj_tile_info_t;
 
 /**
- * Index structure of the codestream
+Index structure of the codestream
 */
 typedef struct opj_codestream_info {
        /** maximum distortion reduction on the whole image (add for Marcela) */
@@ -845,197 +718,6 @@ typedef struct opj_codestream_info {
        opj_tile_info_t *tile;
 } opj_codestream_info_t;
 
-/* <----------------------------------------------------------- */
-/* new output managment of the codestream information and index */
-
-/**
- * Tile-component coding parameters information
- */
-typedef struct opj_tccp_info
-{
-       /** component index */
-       OPJ_UINT32 compno;
-       /** coding style */
-       OPJ_UINT32 csty;
-       /** number of resolutions */
-       OPJ_UINT32 numresolutions;
-       /** code-blocks width */
-       OPJ_UINT32 cblkw;
-       /** code-blocks height */
-       OPJ_UINT32 cblkh;
-       /** code-block coding style */
-       OPJ_UINT32 cblksty;
-       /** discrete wavelet transform identifier */
-       OPJ_UINT32 qmfbid;
-       /** quantisation style */
-       OPJ_UINT32 qntsty;
-       /** stepsizes used for quantization */
-       OPJ_UINT32 stepsizes_mant[OPJ_J2K_MAXBANDS];
-       /** stepsizes used for quantization */
-       OPJ_UINT32 stepsizes_expn[OPJ_J2K_MAXBANDS];
-       /** number of guard bits */
-       OPJ_UINT32 numgbits;
-       /** Region Of Interest shift */
-       OPJ_INT32 roishift;
-       /** precinct width */
-       OPJ_UINT32 prcw[OPJ_J2K_MAXRLVLS];
-       /** precinct height */
-       OPJ_UINT32 prch[OPJ_J2K_MAXRLVLS];
-}
-opj_tccp_info_t;
-
-/**
- * Tile coding parameters information
- */
-typedef struct opj_tile_v2_info {
-
-       /** number (index) of tile */
-       int tileno;
-       /** coding style */
-       OPJ_UINT32 csty;
-       /** progression order */
-       OPJ_PROG_ORDER prg;
-       /** number of layers */
-       OPJ_UINT32 numlayers;
-       /** multi-component transform identifier */
-       OPJ_UINT32 mct;
-
-       /** information concerning tile component parameters*/
-       opj_tccp_info_t *tccp_info;
-
-} opj_tile_info_v2_t;
-
-/**
- * Information structure about the codestream (FIXME should be expand and enhance)
- */
-typedef struct opj_codestream_info_v2 {
-       /* Tile info */
-       /** tile origin in x = XTOsiz */
-       OPJ_UINT32 tx0;
-       /** tile origin in y = YTOsiz */
-       OPJ_UINT32 ty0;
-       /** tile size in x = XTsiz */
-       OPJ_UINT32 tdx;
-       /** tile size in y = YTsiz */
-       OPJ_UINT32 tdy;
-       /** number of tiles in X */
-       OPJ_UINT32 tw;
-       /** number of tiles in Y */
-       OPJ_UINT32 th;
-
-       /** number of components*/
-       OPJ_UINT32 nbcomps;
-
-       /** Default information regarding tiles inside image */
-       opj_tile_info_v2_t m_default_tile_info;
-
-       /** information regarding tiles inside image */
-       opj_tile_info_v2_t *tile_info; /* FIXME not used for the moment */
-
-} opj_codestream_info_v2_t;
-
-
-/**
- * Index structure about a tile part
- */
-typedef struct opj_tp_index {
-       /** start position */
-       OPJ_OFF_T start_pos;
-       /** end position of the header */
-       OPJ_OFF_T end_header;
-       /** end position */
-       OPJ_OFF_T end_pos;
-
-} opj_tp_index_t;
-
-/**
- * Index structure about a tile
- */
-typedef struct opj_tile_index {
-       /** tile index */
-       OPJ_UINT32 tileno;
-
-       /** number of tile parts */
-       OPJ_UINT32 nb_tps;
-       /** current nb of tile part (allocated)*/
-       OPJ_UINT32 current_nb_tps;
-       /** current tile-part index */
-       OPJ_UINT32 current_tpsno;
-       /** information concerning tile parts */
-       opj_tp_index_t *tp_index;
-
-       /* UniPG>> */ /* NOT USED FOR THE MOMENT IN THE V2 VERSION */
-               /** number of markers */
-               OPJ_UINT32 marknum;
-               /** list of markers */
-               opj_marker_info_t *marker;
-               /** actual size of markers array */
-               OPJ_UINT32 maxmarknum;
-       /* <<UniPG */
-
-       /** packet number */
-       OPJ_UINT32 nb_packet;
-       /** information concerning packets inside tile */
-       opj_packet_info_t *packet_index;
-
-} opj_tile_index_t;
-
-/**
- * Index structure of the codestream (FIXME should be expand and enhance)
- */
-typedef struct opj_codestream_index {
-       /** main header start position (SOC position) */
-       OPJ_OFF_T main_head_start;
-       /** main header end position (first SOT position) */
-       OPJ_OFF_T main_head_end;
-
-       /** codestream's size */
-       OPJ_UINT64 codestream_size;
-
-/* UniPG>> */ /* NOT USED FOR THE MOMENT IN THE V2 VERSION */
-       /** number of markers */
-       OPJ_UINT32 marknum;
-       /** list of markers */
-       opj_marker_info_t *marker;
-       /** actual size of markers array */
-       OPJ_UINT32 maxmarknum;
-/* <<UniPG */
-
-       /** */
-       OPJ_UINT32 nb_of_tiles;
-       /** */
-       opj_tile_index_t *tile_index; /* FIXME not used for the moment */
-
-}opj_codestream_index_t;
-/* -----------------------------------------------------------> */
-
-/*
-==========================================================
-   Metadata from the JP2file
-==========================================================
-*/
-
-/**
- * Info structure of the JP2 file
- * EXPERIMENTAL FOR THE MOMENT
- */
-typedef struct opj_jp2_metadata {
-       /** */
-       OPJ_INT32       not_used;
-
-} opj_jp2_metadata_t;
-
-/**
- * Index structure of the JP2 file
- * EXPERIMENTAL FOR THE MOMENT
- */
-typedef struct opj_jp2_index {
-       /** */
-       OPJ_INT32       not_used;
-
-} opj_jp2_index_t;
-
-
 #ifdef __cplusplus
 extern "C" {
 #endif
@@ -1047,7 +729,6 @@ extern "C" {
 ==========================================================
 */
 
-/* Get the version of the openjpeg library*/
 OPJ_API const char * OPJ_CALLCONV opj_version(void);
 
 /* 
@@ -1057,32 +738,19 @@ OPJ_API const char * OPJ_CALLCONV opj_version(void);
 */
 
 /**
- * Create an image
- *
- * @param numcmpts      number of components
- * @param cmptparms     components parameters
- * @param clrspc        image color space
- * @return returns      a new image structure if successful, returns NULL otherwise
- * */
-OPJ_API opj_image_t* OPJ_CALLCONV opj_image_create(OPJ_UINT32 numcmpts, opj_image_cmptparm_t *cmptparms, OPJ_COLOR_SPACE clrspc);
-
-/**
- * Deallocate any resources associated with an image
- *
- * @param image         image to be destroyed
- */
-OPJ_API void OPJ_CALLCONV opj_image_destroy(opj_image_t *image);
+Create an image
+@param numcmpts number of components
+@param cmptparms components parameters
+@param clrspc image color space
+@return returns a new image structure if successful, returns NULL otherwise
+*/
+OPJ_API opj_image_t* OPJ_CALLCONV opj_image_create(int numcmpts, opj_image_cmptparm_t *cmptparms, OPJ_COLOR_SPACE clrspc);
 
 /**
- * Creates an image without allocating memory for the image (used in the new version of the library).
- *
- * @param      numcmpts    the number of components
- * @param      cmptparms   the components parameters
- * @param      clrspc      the image color space
- *
- * @return     a new image structure if successful, NULL otherwise.
+Deallocate any resources associated with an image
+@param image image to be destroyed
 */
-OPJ_API opj_image_t* OPJ_CALLCONV opj_image_tile_create(OPJ_UINT32 numcmpts, opj_image_cmptparm_t *cmptparms, OPJ_COLOR_SPACE clrspc);
+OPJ_API void OPJ_CALLCONV opj_image_destroy(opj_image_t *image);
 
 /* 
 ==========================================================
@@ -1091,314 +759,100 @@ OPJ_API opj_image_t* OPJ_CALLCONV opj_image_tile_create(OPJ_UINT32 numcmpts, opj
 */
 
 /**
- * Creates an abstract stream. This function does nothing except allocating memory and initializing the abstract stream.
- *
- * @param      p_is_input              if set to true then the stream will be an input stream, an output stream else.
- *
- * @return     a stream object.
-*/
-OPJ_API opj_stream_t* OPJ_CALLCONV opj_stream_default_create(OPJ_BOOL p_is_input);
-
-/**
- * Creates an abstract stream. This function does nothing except allocating memory and initializing the abstract stream.
- *
- * @param      p_buffer_size  FIXME DOC
- * @param      p_is_input              if set to true then the stream will be an input stream, an output stream else.
- *
- * @return     a stream object.
-*/
-OPJ_API opj_stream_t* OPJ_CALLCONV opj_stream_create(OPJ_SIZE_T p_buffer_size, OPJ_BOOL p_is_input);
-
-/**
- * Destroys a stream created by opj_create_stream. This function does NOT close the abstract stream. If needed the user must
- * close its own implementation of the stream.
- *
- * @param      p_stream        the stream to destroy.
- */
-OPJ_API void OPJ_CALLCONV opj_stream_destroy(opj_stream_t* p_stream);
-/**
- * Sets the given function to be used as a read function.
- * @param              p_stream        the stream to modify
- * @param              p_function      the function to use a read function.
+Open and allocate a memory stream for read / write. 
+On reading, the user must provide a buffer containing encoded data. The buffer will be 
+wrapped by the returned CIO handle. 
+On writing, buffer parameters must be set to 0: a buffer will be allocated by the library 
+to contain encoded data. 
+@param cinfo Codec context info
+@param buffer Reading: buffer address. Writing: NULL
+@param length Reading: buffer length. Writing: 0
+@return Returns a CIO handle if successful, returns NULL otherwise
 */
-OPJ_API void OPJ_CALLCONV opj_stream_set_read_function(opj_stream_t* p_stream, opj_stream_read_fn p_function);
+OPJ_API opj_cio_t* OPJ_CALLCONV opj_cio_open(opj_common_ptr cinfo, unsigned char *buffer, int length);
 
 /**
- * Sets the given function to be used as a write function.
- * @param              p_stream        the stream to modify
- * @param              p_function      the function to use a write function.
+Close and free a CIO handle
+@param cio CIO handle to free
 */
-OPJ_API void OPJ_CALLCONV opj_stream_set_write_function(opj_stream_t* p_stream, opj_stream_write_fn p_function);
+OPJ_API void OPJ_CALLCONV opj_cio_close(opj_cio_t *cio);
 
 /**
- * Sets the given function to be used as a skip function.
- * @param              p_stream        the stream to modify
- * @param              p_function      the function to use a skip function.
+Get position in byte stream
+@param cio CIO handle
+@return Returns the position in bytes
 */
-OPJ_API void OPJ_CALLCONV opj_stream_set_skip_function(opj_stream_t* p_stream, opj_stream_skip_fn p_function);
-
+OPJ_API int OPJ_CALLCONV cio_tell(opj_cio_t *cio);
 /**
- * Sets the given function to be used as a seek function, the stream is then seekable.
- * @param              p_stream        the stream to modify
- * @param              p_function      the function to use a skip function.
+Set position in byte stream
+@param cio CIO handle
+@param pos Position, in number of bytes, from the beginning of the stream
 */
-OPJ_API void OPJ_CALLCONV opj_stream_set_seek_function(opj_stream_t* p_stream, opj_stream_seek_fn p_function);
+OPJ_API void OPJ_CALLCONV cio_seek(opj_cio_t *cio, int pos);
 
-/**
- * Sets the given data to be used as a user data for the stream.
- * @param              p_stream        the stream to modify
- * @param              p_data          the data to set.
- * @param              p_function      the function to free p_data when opj_stream_destroy() is called.
-*/
-OPJ_API void OPJ_CALLCONV opj_stream_set_user_data (opj_stream_t* p_stream, void * p_data, opj_stream_free_user_data_fn p_function);
-
-/**
- * Sets the length of the user data for the stream.
- *
- * @param p_stream    the stream to modify
- * @param data_length length of the user_data.
-*/
-OPJ_API void OPJ_CALLCONV opj_stream_set_user_data_length(opj_stream_t* p_stream, OPJ_UINT64 data_length);
-
-/**
- * Create a stream from a file identified with its filename with default parameters (helper function)
- * @param fname             the filename of the file to stream
- * @param p_is_read_stream  whether the stream is a read stream (true) or not (false)
-*/
-OPJ_API opj_stream_t* OPJ_CALLCONV opj_stream_create_default_file_stream (const char *fname, OPJ_BOOL p_is_read_stream);
-/** Create a stream from a file identified with its filename with a specific buffer size
- * @param fname             the filename of the file to stream
- * @param p_buffer_size     size of the chunk used to stream
- * @param p_is_read_stream  whether the stream is a read stream (true) or not (false)
-*/
-OPJ_API opj_stream_t* OPJ_CALLCONV opj_stream_create_file_stream (const char *fname,
-                                                                     OPJ_SIZE_T p_buffer_size,
-                                                                     OPJ_BOOL p_is_read_stream);
 /* 
 ==========================================================
    event manager functions definitions
 ==========================================================
 */
-/**
- * Set the info handler use by openjpeg.
- * @param p_codec       the codec previously initialise
- * @param p_callback    the callback function which will be used
- * @param p_user_data   client object where will be returned the message
-*/
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_set_info_handler(opj_codec_t * p_codec, 
-                                                   opj_msg_callback p_callback,
-                                                   void * p_user_data);
-/**
- * Set the warning handler use by openjpeg.
- * @param p_codec       the codec previously initialise
- * @param p_callback    the callback function which will be used
- * @param p_user_data   client object where will be returned the message
-*/
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_set_warning_handler(opj_codec_t * p_codec,
-                                                      opj_msg_callback p_callback,
-                                                      void * p_user_data);
-/**
- * Set the error handler use by openjpeg.
- * @param p_codec       the codec previously initialise
- * @param p_callback    the callback function which will be used
- * @param p_user_data   client object where will be returned the message
-*/
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_set_error_handler(opj_codec_t * p_codec, 
-                                                    opj_msg_callback p_callback,
-                                                    void * p_user_data);
+
+OPJ_API opj_event_mgr_t* OPJ_CALLCONV opj_set_event_mgr(opj_common_ptr cinfo, opj_event_mgr_t *event_mgr, void *context);
 
 /* 
 ==========================================================
    codec functions definitions
 ==========================================================
 */
-
 /**
- * Creates a J2K/JP2 decompression structure
- * @param format               Decoder to select
- *
- * @return Returns a handle to a decompressor if successful, returns NULL otherwise
- * */
-OPJ_API opj_codec_t* OPJ_CALLCONV opj_create_decompress(OPJ_CODEC_FORMAT format);
-
-/**
- * Destroy a decompressor handle
- *
- * @param      p_codec                 decompressor handle to destroy
- */
-OPJ_API void OPJ_CALLCONV opj_destroy_codec(opj_codec_t * p_codec);
-
+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_API opj_dinfo_t* OPJ_CALLCONV opj_create_decompress(OPJ_CODEC_FORMAT format);
 /**
- * Read after the codestream if necessary
- * @param      p_codec                 the JPEG2000 codec to read.
- * @param      p_stream                the JPEG2000 stream.
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_end_decompress (     opj_codec_t *p_codec,
-                                                                                                       opj_stream_t *p_stream);
-
-
+Destroy a decompressor handle
+@param dinfo decompressor handle to destroy
+*/
+OPJ_API void OPJ_CALLCONV opj_destroy_decompress(opj_dinfo_t *dinfo);
 /**
- * Set decoding parameters to default values
- * @param parameters Decompression parameters
- */
+Set decoding parameters to default values
+@param parameters Decompression parameters
+*/
 OPJ_API void OPJ_CALLCONV opj_set_default_decoder_parameters(opj_dparameters_t *parameters);
-
-/**
- * Setup the decoder with decompression parameters provided by the user and with the message handler
- * provided by the user.
- *
- * @param p_codec              decompressor handler
- * @param parameters   decompression parameters
- *
- * @return true                        if the decoder is correctly set
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_setup_decoder(opj_codec_t *p_codec,
-                                                                                               opj_dparameters_t *parameters );
-
-/**
- * Decodes an image header.
- *
- * @param      p_stream                the jpeg2000 stream.
- * @param      p_codec                 the jpeg2000 codec to read.
- * @param      p_image                 the image structure initialized with the characteristics of encoded image.
- *
- * @return true                                if the main header of the codestream and the JP2 header is correctly read.
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_read_header (        opj_stream_t *p_stream,
-                                                                                               opj_codec_t *p_codec,
-                                                                                               opj_image_t **p_image);
-
-/**
- * Sets the given area to be decoded. This function should be called right after opj_read_header and before any tile header reading.
- *
- * @param      p_codec                 the jpeg2000 codec.
- * @param      p_image         the decoded image previously setted by opj_read_header
- * @param      p_start_x               the left position of the rectangle to decode (in image coordinates).
- * @param      p_end_x                 the right position of the rectangle to decode (in image coordinates).
- * @param      p_start_y               the up position of the rectangle to decode (in image coordinates).
- * @param      p_end_y                 the bottom position of the rectangle to decode (in image coordinates).
- *
- * @return     true                    if the area could be set.
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_set_decode_area(     opj_codec_t *p_codec,
-                                                                                                       opj_image_t* p_image,
-                                                                                                       OPJ_INT32 p_start_x, OPJ_INT32 p_start_y,
-                                                                                                       OPJ_INT32 p_end_x, OPJ_INT32 p_end_y );
-
-/**
- * Decode an image from a JPEG-2000 codestream
- *
- * @param p_decompressor       decompressor handle
- * @param p_stream                     Input buffer stream
- * @param p_image                      the decoded image
- * @return                                     true if success, otherwise false
- * */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_decode(   opj_codec_t *p_decompressor,
-                                            opj_stream_t *p_stream,
-                                            opj_image_t *p_image);
-
-/**
- * Get the decoded tile from the codec
- *
- * @param      p_codec                 the jpeg2000 codec.
- * @param      p_stream                input streamm
- * @param      p_image                 output image
- * @param      tile_index              index of the tile which will be decode
- *
- * @return                                     true if success, otherwise false
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_get_decoded_tile(    opj_codec_t *p_codec,
-                                                                                                       opj_stream_t *p_stream,
-                                                                                                       opj_image_t *p_image,
-                                                                                                       OPJ_UINT32 tile_index);
-
 /**
- * Set the resolution factor of the decoded image
- * @param      p_codec                 the jpeg2000 codec.
- * @param      res_factor              resolution factor to set
- *
- * @return                                     true if success, otherwise false
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_set_decoded_resolution_factor(opj_codec_t *p_codec, OPJ_UINT32 res_factor);
-
+Setup the decoder decoding parameters using user parameters.
+Decoding parameters are returned in j2k->cp. 
+@param dinfo decompressor handle
+@param parameters decompression parameters
+*/
+OPJ_API void OPJ_CALLCONV opj_setup_decoder(opj_dinfo_t *dinfo, opj_dparameters_t *parameters);
 /**
- * Writes a tile with the given data.
- *
- * @param      p_codec                 the jpeg2000 codec.
- * @param      p_tile_index            the index of the tile to write. At the moment, the tiles must be written from 0 to n-1 in sequence.
- * @param      p_data                          pointer to the data to write. Data is arranged in sequence, data_comp0, then data_comp1, then ... NO INTERLEAVING should be set.
- * @param      p_data_size                     this value os used to make sure the data being written is correct. The size must be equal to the sum for each component of 
- *                              tile_width * tile_height * component_size. component_size can be 1,2 or 4 bytes, depending on the precision of the given component.
- * @param      p_stream                        the stream to write data to.
- *
- * @return     true if the data could be written.
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_write_tile ( opj_codec_t *p_codec,
-                                                                                               OPJ_UINT32 p_tile_index,
-                                                                                               OPJ_BYTE * p_data,
-                                                                                               OPJ_UINT32 p_data_size,
-                                                                                               opj_stream_t *p_stream );
+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_API opj_image_t* OPJ_CALLCONV opj_decode(opj_dinfo_t *dinfo, opj_cio_t *cio);
 
 /**
- * Reads a tile header. This function is compulsory and allows one to know the size of the tile thta will be decoded.
- * The user may need to refer to the image got by opj_read_header to understand the size being taken by the tile.
- *
- * @param      p_codec                 the jpeg2000 codec.
- * @param      p_tile_index    pointer to a value that will hold the index of the tile being decoded, in case of success.
- * @param      p_data_size             pointer to a value that will hold the maximum size of the decoded data, in case of success. In case
- *                                                     of truncated codestreams, the actual number of bytes decoded may be lower. The computation of the size is the same
- *                                                     as depicted in opj_write_tile.
- * @param      p_tile_x0               pointer to a value that will hold the x0 pos of the tile (in the image).
- * @param      p_tile_y0               pointer to a value that will hold the y0 pos of the tile (in the image).
- * @param      p_tile_x1               pointer to a value that will hold the x1 pos of the tile (in the image).
- * @param      p_tile_y1               pointer to a value that will hold the y1 pos of the tile (in the image).
- * @param      p_nb_comps              pointer to a value that will hold the number of components in the tile.
- * @param      p_should_go_on  pointer to a boolean that will hold the fact that the decoding should go on. In case the
- *                                                     codestream is over at the time of the call, the value will be set to false. The user should then stop
- *                                                     the decoding.
- * @param      p_stream                the stream to decode.
- * @return     true                    if the tile header could be decoded. In case the decoding should end, the returned value is still true.
- *                                                     returning false may be the result of a shortage of memory or an internal error.
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_read_tile_header(    opj_codec_t *p_codec,
-                                                                                               opj_stream_t * p_stream,
-                                                                                               OPJ_UINT32 * p_tile_index,
-                                                                                               OPJ_UINT32 * p_data_size,
-                                                                                               OPJ_INT32 * p_tile_x0, OPJ_INT32 * p_tile_y0,
-                                                                                               OPJ_INT32 * p_tile_x1, OPJ_INT32 * p_tile_y1,
-                                                                                               OPJ_UINT32 * p_nb_comps,
-                                                                                               OPJ_BOOL * p_should_go_on );
-
+Decode an image from a JPEG-2000 codestream and extract the codestream information
+@param dinfo decompressor handle
+@param cio Input buffer stream
+@param cstr_info Codestream information structure if needed afterwards, NULL otherwise
+@return Returns a decoded image if successful, returns NULL otherwise
+*/
+OPJ_API opj_image_t* OPJ_CALLCONV opj_decode_with_info(opj_dinfo_t *dinfo, opj_cio_t *cio, opj_codestream_info_t *cstr_info);
 /**
- * Reads a tile data. This function is compulsory and allows one to decode tile data. opj_read_tile_header should be called before.
- * The user may need to refer to the image got by opj_read_header to understand the size being taken by the tile.
- *
- * @param      p_codec                 the jpeg2000 codec.
- * @param      p_tile_index    the index of the tile being decoded, this should be the value set by opj_read_tile_header.
- * @param      p_data                  pointer to a memory block that will hold the decoded data.
- * @param      p_data_size             size of p_data. p_data_size should be bigger or equal to the value set by opj_read_tile_header.
- * @param      p_stream                the stream to decode.
- *
- * @return     true                    if the data could be decoded.
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_decode_tile_data(    opj_codec_t *p_codec,
-                                                                                                       OPJ_UINT32 p_tile_index,
-                                                                                                       OPJ_BYTE * p_data,
-                                                                                                       OPJ_UINT32 p_data_size,
-                                                                                                       opj_stream_t *p_stream );
-
-/* COMPRESSION FUNCTIONS*/
-
+Creates a J2K/JP2 compression structure
+@param format Coder to select
+@return Returns a handle to a compressor if successful, returns NULL otherwise
+*/
+OPJ_API opj_cinfo_t* OPJ_CALLCONV opj_create_compress(OPJ_CODEC_FORMAT format);
 /**
- * Creates a J2K/JP2 compression structure
- * @param      format          Coder to select
- * @return                             Returns a handle to a compressor if successful, returns NULL otherwise
- */
-OPJ_API opj_codec_t* OPJ_CALLCONV opj_create_compress(OPJ_CODEC_FORMAT format);
-
+Destroy a compressor handle
+@param cinfo compressor handle to destroy
+*/
+OPJ_API void OPJ_CALLCONV opj_destroy_compress(opj_cinfo_t *cinfo);
 /**
 Set encoding parameters to default values, that means : 
 <ul>
@@ -1421,135 +875,36 @@ Set encoding parameters to default values, that means :
 @param parameters Compression 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 p_codec              Compressor handle
- * @param parameters   Compression parameters
- * @param image                Input filled image
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_setup_encoder(opj_codec_t *p_codec, 
-                                                                                               opj_cparameters_t *parameters, 
-                                                                                               opj_image_t *image);
-
-/**
- * Start to compress the current image.
- * @param p_codec              Compressor handle
- * @param image            Input filled image
- * @param p_stream             Input stgream
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_start_compress (     opj_codec_t *p_codec,
-                                                                                                       opj_image_t * p_image,
-                                                                                                       opj_stream_t *p_stream);
-
+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
+*/
+OPJ_API void OPJ_CALLCONV opj_setup_encoder(opj_cinfo_t *cinfo, opj_cparameters_t *parameters, opj_image_t *image);
 /**
- * End to compress the current image.
- * @param p_codec              Compressor handle
- * @param p_stream             Input stgream
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_end_compress (opj_codec_t *p_codec,
-                                                                                               opj_stream_t *p_stream);
-
+Encode an image into a JPEG-2000 codestream
+3@param cinfo compressor handle
+@param cio Output buffer stream
+@param image Image to encode
+@param index Depreacted -> Set to NULL. To extract index, used opj_encode_wci()
+@return Returns true if successful, returns false otherwise
+*/
+OPJ_API opj_bool OPJ_CALLCONV opj_encode(opj_cinfo_t *cinfo, opj_cio_t *cio, opj_image_t *image, char *index);
 /**
- * Encode an image into a JPEG-2000 codestream
- * @param p_codec              compressor handle
- * @param p_stream             Output buffer stream
- *
- * @return                             Returns true if successful, returns false otherwise
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_encode(opj_codec_t *p_codec,
-                                         opj_stream_t *p_stream);
-/*
-==========================================================
-   codec output functions definitions
-==========================================================
+Encode an image into a JPEG-2000 codestream and extract the codestream information
+@param cinfo compressor handle
+@param cio Output buffer stream
+@param image Image to encode
+@param cstr_info Codestream information structure if needed afterwards, NULL otherwise
+@return Returns true if successful, returns false otherwise
 */
-/* EXPERIMENTAL FUNCTIONS FOR NOW, USED ONLY IN J2K_DUMP*/
-
+OPJ_API opj_bool OPJ_CALLCONV opj_encode_with_info(opj_cinfo_t *cinfo, opj_cio_t *cio, opj_image_t *image, opj_codestream_info_t *cstr_info);
 /**
 Destroy Codestream information after compression or decompression
 @param cstr_info Codestream information structure
 */
-OPJ_API void OPJ_CALLCONV opj_destroy_cstr_info(opj_codestream_info_v2_t **cstr_info);
-
-
-/**
- * Dump the codec information into the output stream
- *
- * @param      p_codec                 the jpeg2000 codec.
- * @param      info_flag               type of information dump.
- * @param      output_stream   output stream where dump the informations get from the codec.
- *
- */
-OPJ_API void OPJ_CALLCONV opj_dump_codec(      opj_codec_t *p_codec,
-                                                                                       OPJ_INT32 info_flag,
-                                                                                       FILE* output_stream);
-
-/**
- * Get the codestream information from the codec
- *
- * @param      p_codec                 the jpeg2000 codec.
- *
- * @return                                     a pointer to a codestream information structure.
- *
- */
-OPJ_API opj_codestream_info_v2_t* OPJ_CALLCONV opj_get_cstr_info(opj_codec_t *p_codec);
-
-/**
- * Get the codestream index from the codec
- *
- * @param      p_codec                 the jpeg2000 codec.
- *
- * @return                                     a pointer to a codestream index structure.
- *
- */
-OPJ_API opj_codestream_index_t * OPJ_CALLCONV opj_get_cstr_index(opj_codec_t *p_codec);
-
-OPJ_API void OPJ_CALLCONV opj_destroy_cstr_index(opj_codestream_index_t **p_cstr_index);
-
-
-/**
- * Get the JP2 file information from the codec FIXME
- *
- * @param      p_codec                 the jpeg2000 codec.
- *
- * @return                                     a pointer to a JP2 metadata structure.
- *
- */
-OPJ_API opj_jp2_metadata_t* OPJ_CALLCONV opj_get_jp2_metadata(opj_codec_t *p_codec);
-
-/**
- * Get the JP2 file index from the codec FIXME
- *
- * @param      p_codec                 the jpeg2000 codec.
- *
- * @return                                     a pointer to a JP2 index structure.
- *
- */
-OPJ_API opj_jp2_index_t* OPJ_CALLCONV opj_get_jp2_index(opj_codec_t *p_codec);
-
-
-/*
-==========================================================
-   MCT functions
-==========================================================
-*/
-
-/**
- * Sets the MCT matrix to use.
- *
- * @param      parameters              the parameters to change.
- * @param      pEncodingMatrix the encoding matrix.
- * @param      p_dc_shift              the dc shift coefficients to use.
- * @param      pNbComp                 the number of components of the image.
- *
- * @return     true if the parameters could be set.
- */
-OPJ_API OPJ_BOOL OPJ_CALLCONV opj_set_MCT( opj_cparameters_t *parameters,
-                                                  OPJ_FLOAT32 * pEncodingMatrix,
-                                                  OPJ_INT32 * p_dc_shift,
-                                                  OPJ_UINT32 pNbComp);
-
+OPJ_API void OPJ_CALLCONV opj_destroy_cstr_info(opj_codestream_info_t *cstr_info);
 
 
 #ifdef __cplusplus