Subversion Repositories AndroidProjects

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
244 chris 1
/*
2
 * Copyright (c) 1999-2000 Image Power, Inc. and the University of
3
 *   British Columbia.
4
 * Copyright (c) 2001-2003 Michael David Adams.
5
 * All rights reserved.
6
 */
7
 
8
/* __START_OF_JASPER_LICENSE__
9
 *
10
 * JasPer Software License
11
 *
12
 * IMAGE POWER JPEG-2000 PUBLIC LICENSE
13
 * ************************************
14
 *
15
 * GRANT:
16
 *
17
 * Permission is hereby granted, free of charge, to any person (the "User")
18
 * obtaining a copy of this software and associated documentation, to deal
19
 * in the JasPer Software without restriction, including without limitation
20
 * the right to use, copy, modify, merge, publish, distribute, sublicense,
21
 * and/or sell copies of the JasPer Software (in source and binary forms),
22
 * and to permit persons to whom the JasPer Software is furnished to do so,
23
 * provided further that the License Conditions below are met.
24
 *
25
 * License Conditions
26
 * ******************
27
 *
28
 * A.  Redistributions of source code must retain the above copyright notice,
29
 * and this list of conditions, and the following disclaimer.
30
 *
31
 * B.  Redistributions in binary form must reproduce the above copyright
32
 * notice, and this list of conditions, and the following disclaimer in
33
 * the documentation and/or other materials provided with the distribution.
34
 *
35
 * C.  Neither the name of Image Power, Inc. nor any other contributor
36
 * (including, but not limited to, the University of British Columbia and
37
 * Michael David Adams) may be used to endorse or promote products derived
38
 * from this software without specific prior written permission.
39
 *
40
 * D.  User agrees that it shall not commence any action against Image Power,
41
 * Inc., the University of British Columbia, Michael David Adams, or any
42
 * other contributors (collectively "Licensors") for infringement of any
43
 * intellectual property rights ("IPR") held by the User in respect of any
44
 * technology that User owns or has a right to license or sublicense and
45
 * which is an element required in order to claim compliance with ISO/IEC
46
 * 15444-1 (i.e., JPEG-2000 Part 1).  "IPR" means all intellectual property
47
 * rights worldwide arising under statutory or common law, and whether
48
 * or not perfected, including, without limitation, all (i) patents and
49
 * patent applications owned or licensable by User; (ii) rights associated
50
 * with works of authorship including copyrights, copyright applications,
51
 * copyright registrations, mask work rights, mask work applications,
52
 * mask work registrations; (iii) rights relating to the protection of
53
 * trade secrets and confidential information; (iv) any right analogous
54
 * to those set forth in subsections (i), (ii), or (iii) and any other
55
 * proprietary rights relating to intangible property (other than trademark,
56
 * trade dress, or service mark rights); and (v) divisions, continuations,
57
 * renewals, reissues and extensions of the foregoing (as and to the extent
58
 * applicable) now existing, hereafter filed, issued or acquired.
59
 *
60
 * E.  If User commences an infringement action against any Licensor(s) then
61
 * such Licensor(s) shall have the right to terminate User's license and
62
 * all sublicenses that have been granted hereunder by User to other parties.
63
 *
64
 * F.  This software is for use only in hardware or software products that
65
 * are compliant with ISO/IEC 15444-1 (i.e., JPEG-2000 Part 1).  No license
66
 * or right to this Software is granted for products that do not comply
67
 * with ISO/IEC 15444-1.  The JPEG-2000 Part 1 standard can be purchased
68
 * from the ISO.
69
 *
70
 * THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE.
71
 * NO USE OF THE JASPER SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER
72
 * THIS DISCLAIMER.  THE JASPER SOFTWARE IS PROVIDED BY THE LICENSORS AND
73
 * CONTRIBUTORS UNDER THIS LICENSE ON AN ``AS-IS'' BASIS, WITHOUT WARRANTY
74
 * OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION,
75
 * WARRANTIES THAT THE JASPER SOFTWARE IS FREE OF DEFECTS, IS MERCHANTABLE,
76
 * IS FIT FOR A PARTICULAR PURPOSE OR IS NON-INFRINGING.  THOSE INTENDING
77
 * TO USE THE JASPER SOFTWARE OR MODIFICATIONS THEREOF FOR USE IN HARDWARE
78
 * OR SOFTWARE PRODUCTS ARE ADVISED THAT THEIR USE MAY INFRINGE EXISTING
79
 * PATENTS, COPYRIGHTS, TRADEMARKS, OR OTHER INTELLECTUAL PROPERTY RIGHTS.
80
 * THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE JASPER SOFTWARE
81
 * IS WITH THE USER.  SHOULD ANY PART OF THE JASPER SOFTWARE PROVE DEFECTIVE
82
 * IN ANY RESPECT, THE USER (AND NOT THE INITIAL DEVELOPERS, THE UNIVERSITY
83
 * OF BRITISH COLUMBIA, IMAGE POWER, INC., MICHAEL DAVID ADAMS, OR ANY
84
 * OTHER CONTRIBUTOR) SHALL ASSUME THE COST OF ANY NECESSARY SERVICING,
85
 * REPAIR OR CORRECTION.  UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY,
86
 * WHETHER TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE
87
 * INITIAL DEVELOPER, THE UNIVERSITY OF BRITISH COLUMBIA, IMAGE POWER, INC.,
88
 * MICHAEL DAVID ADAMS, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE
89
 * JASPER SOFTWARE, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO
90
 * THE USER OR ANY OTHER PERSON FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR
91
 * CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION,
92
 * DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
93
 * MALFUNCTION, OR ANY AND ALL OTHER COMMERCIAL DAMAGES OR LOSSES, EVEN IF
94
 * SUCH PARTY HAD BEEN INFORMED, OR OUGHT TO HAVE KNOWN, OF THE POSSIBILITY
95
 * OF SUCH DAMAGES.  THE JASPER SOFTWARE AND UNDERLYING TECHNOLOGY ARE NOT
96
 * FAULT-TOLERANT AND ARE NOT DESIGNED, MANUFACTURED OR INTENDED FOR USE OR
97
 * RESALE AS ON-LINE CONTROL EQUIPMENT IN HAZARDOUS ENVIRONMENTS REQUIRING
98
 * FAIL-SAFE PERFORMANCE, SUCH AS IN THE OPERATION OF NUCLEAR FACILITIES,
99
 * AIRCRAFT NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL, DIRECT
100
 * LIFE SUPPORT MACHINES, OR WEAPONS SYSTEMS, IN WHICH THE FAILURE OF THE
101
 * JASPER SOFTWARE OR UNDERLYING TECHNOLOGY OR PRODUCT COULD LEAD DIRECTLY
102
 * TO DEATH, PERSONAL INJURY, OR SEVERE PHYSICAL OR ENVIRONMENTAL DAMAGE
103
 * ("HIGH RISK ACTIVITIES").  LICENSOR SPECIFICALLY DISCLAIMS ANY EXPRESS
104
 * OR IMPLIED WARRANTY OF FITNESS FOR HIGH RISK ACTIVITIES.  USER WILL NOT
105
 * KNOWINGLY USE, DISTRIBUTE OR RESELL THE JASPER SOFTWARE OR UNDERLYING
106
 * TECHNOLOGY OR PRODUCTS FOR HIGH RISK ACTIVITIES AND WILL ENSURE THAT ITS
107
 * CUSTOMERS AND END-USERS OF ITS PRODUCTS ARE PROVIDED WITH A COPY OF THE
108
 * NOTICE SPECIFIED IN THIS SECTION.
109
 *
110
 * __END_OF_JASPER_LICENSE__
111
 */
112
 
113
/*
114
 * MQ Arithmetic Decoder
115
 *
116
 * $Id: jpc_mqdec.h,v 1.1 2003/05/15 01:30:32 ace Exp $
117
 */
118
 
119
#ifndef JPC_MQDEC_H
120
#define JPC_MQDEC_H
121
 
122
/******************************************************************************\
123
* Includes.
124
\******************************************************************************/
125
 
126
#include "jas_types.h"
127
#include "jas_stream.h"
128
 
129
#include "jpc_mqcod.h"
130
 
131
/******************************************************************************\
132
* Types.
133
\******************************************************************************/
134
 
135
/* MQ arithmetic decoder. */
136
 
137
typedef struct {
138
 
139
        /* The C register. */
140
        uint_fast32_t creg;
141
 
142
        /* The A register. */
143
        uint_fast32_t areg;
144
 
145
        /* The CT register. */
146
        uint_fast32_t ctreg;
147
 
148
        /* The current context. */
149
        jpc_mqstate_t **curctx;
150
 
151
        /* The per-context information. */
152
        jpc_mqstate_t **ctxs;
153
 
154
        /* The maximum number of contexts. */
155
        int maxctxs;
156
 
157
        /* The stream from which to read data. */
158
        jas_stream_t *in;
159
 
160
        /* The last character read. */
161
        uchar inbuffer;
162
 
163
        /* The EOF indicator. */
164
        int eof;
165
 
166
} jpc_mqdec_t;
167
 
168
/******************************************************************************\
169
* Functions/macros for construction and destruction.
170
\******************************************************************************/
171
 
172
/* Create a MQ decoder. */
173
jpc_mqdec_t *jpc_mqdec_create(int maxctxs, jas_stream_t *in);
174
 
175
/* Destroy a MQ decoder. */
176
void jpc_mqdec_destroy(jpc_mqdec_t *dec);
177
 
178
/******************************************************************************\
179
* Functions/macros for initialization.
180
\******************************************************************************/
181
 
182
/* Set the input stream associated with a MQ decoder. */
183
void jpc_mqdec_setinput(jpc_mqdec_t *dec, jas_stream_t *in);
184
 
185
/* Initialize a MQ decoder. */
186
void jpc_mqdec_init(jpc_mqdec_t *dec);
187
 
188
/******************************************************************************\
189
* Functions/macros for manipulating contexts.
190
\******************************************************************************/
191
 
192
/* Set the current context for a MQ decoder. */
193
#define jpc_mqdec_setcurctx(dec, ctxno) \
194
        ((mqdec)->curctx = &(mqdec)->ctxs[ctxno]);
195
 
196
/* Set the state information for a particular context of a MQ decoder. */
197
void jpc_mqdec_setctx(jpc_mqdec_t *dec, int ctxno, jpc_mqctx_t *ctx);
198
 
199
/* Set the state information for all contexts of a MQ decoder. */
200
void jpc_mqdec_setctxs(jpc_mqdec_t *dec, int numctxs, jpc_mqctx_t *ctxs);
201
 
202
/******************************************************************************\
203
* Functions/macros for decoding bits.
204
\******************************************************************************/
205
 
206
/* Decode a symbol. */
207
#if !defined(DEBUG)
208
#define jpc_mqdec_getbit(dec) \
209
        jpc_mqdec_getbit_macro(dec)
210
#else
211
#define jpc_mqdec_getbit(dec) \
212
        jpc_mqdec_getbit_func(dec)
213
#endif
214
 
215
/* Decode a symbol (assuming an unskewed probability distribution). */
216
#if !defined(DEBUG)
217
#define jpc_mqdec_getbitnoskew(dec) \
218
        jpc_mqdec_getbit_macro(dec)
219
#else
220
#define jpc_mqdec_getbitnoskew(dec) \
221
        jpc_mqdec_getbit_func(dec)
222
#endif
223
 
224
/******************************************************************************\
225
* Functions/macros for debugging.
226
\******************************************************************************/
227
 
228
/* Dump the MQ decoder state for debugging. */
229
void jpc_mqdec_dump(jpc_mqdec_t *dec, FILE *out);
230
 
231
/******************************************************************************\
232
* EVERYTHING BELOW THIS POINT IS IMPLEMENTATION SPECIFIC AND NOT PART OF THE
233
* APPLICATION INTERFACE.  DO NOT RELY ON ANY OF THE INTERNAL FUNCTIONS/MACROS
234
* GIVEN BELOW.
235
\******************************************************************************/
236
 
237
#define jpc_mqdec_getbit_macro(dec) \
238
        ((((dec)->areg -= (*(dec)->curctx)->qeval), \
239
          (dec)->creg >> 16 >= (*(dec)->curctx)->qeval) ? \
240
          ((((dec)->creg -= (*(dec)->curctx)->qeval << 16), \
241
          (dec)->areg & 0x8000) ?  (*(dec)->curctx)->mps : \
242
          jpc_mqdec_mpsexchrenormd(dec)) : \
243
          jpc_mqdec_lpsexchrenormd(dec))
244
 
245
#define jpc_mqdec_mpsexchange(areg, delta, curctx, bit) \
246
{ \
247
        if ((areg) < (delta)) { \
248
                register jpc_mqstate_t *state = *(curctx); \
249
                /* LPS decoded. */ \
250
                (bit) = state->mps ^ 1; \
251
                *(curctx) = state->nlps; \
252
        } else { \
253
                register jpc_mqstate_t *state = *(curctx); \
254
                /* MPS decoded. */ \
255
                (bit) = state->mps; \
256
                *(curctx) = state->nmps; \
257
        } \
258
}
259
 
260
#define jpc_mqdec_lpsexchange(areg, delta, curctx, bit) \
261
{ \
262
        if ((areg) >= (delta)) { \
263
                register jpc_mqstate_t *state = *(curctx); \
264
                (areg) = (delta); \
265
                (bit) = state->mps ^ 1; \
266
                *(curctx) = state->nlps; \
267
        } else { \
268
                register jpc_mqstate_t *state = *(curctx); \
269
                (areg) = (delta); \
270
                (bit) = state->mps; \
271
                *(curctx) = state->nmps; \
272
        } \
273
}
274
 
275
#define jpc_mqdec_renormd(areg, creg, ctreg, in, eof, inbuf) \
276
{ \
277
        do { \
278
                if (!(ctreg)) { \
279
                        jpc_mqdec_bytein2(creg, ctreg, in, eof, inbuf); \
280
                } \
281
                (areg) <<= 1; \
282
                (creg) <<= 1; \
283
                --(ctreg); \
284
        } while (!((areg) & 0x8000)); \
285
}
286
 
287
#define jpc_mqdec_bytein2(creg, ctreg, in, eof, inbuf) \
288
{ \
289
        int c; \
290
        unsigned char prevbuf; \
291
        if (!(eof)) { \
292
                if ((c = jas_stream_getc(in)) == EOF) { \
293
                        (eof) = 1; \
294
                        c = 0xff; \
295
                } \
296
                prevbuf = (inbuf); \
297
                (inbuf) = c; \
298
                if (prevbuf == 0xff) { \
299
                        if (c > 0x8f) { \
300
                                (creg) += 0xff00; \
301
                                (ctreg) = 8; \
302
                        } else { \
303
                                (creg) += c << 9; \
304
                                (ctreg) = 7; \
305
                        } \
306
                } else { \
307
                        (creg) += c << 8; \
308
                        (ctreg) = 8; \
309
                } \
310
        } else { \
311
                (creg) += 0xff00; \
312
                (ctreg) = 8; \
313
        } \
314
}
315
 
316
int jpc_mqdec_getbit_func(jpc_mqdec_t *dec);
317
int jpc_mqdec_mpsexchrenormd(jpc_mqdec_t *dec);
318
int jpc_mqdec_lpsexchrenormd(jpc_mqdec_t *dec);
319
 
320
#endif