2 * 11/19/04 1.0 moved to LGPL.
\r
4 * 12/12/99 0.0.7 Implementation stores single bits
\r
5 * as ints for better performance. mdm@techie.com.
\r
7 * 02/28/99 0.0 Java Conversion by E.B, javalayer@javazoom.net
\r
9 * Adapted from the public c code by Jeff Tsay.
\r
11 *-----------------------------------------------------------------------
\r
12 * This program is free software; you can redistribute it and/or modify
\r
13 * it under the terms of the GNU Library General Public License as published
\r
14 * by the Free Software Foundation; either version 2 of the License, or
\r
15 * (at your option) any later version.
\r
17 * This program is distributed in the hope that it will be useful,
\r
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
\r
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\r
20 * GNU Library General Public License for more details.
\r
22 * You should have received a copy of the GNU Library General Public
\r
23 * License along with this program; if not, write to the Free Software
\r
24 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
\r
25 *----------------------------------------------------------------------
\r
29 * Implementation of Bit Reservoir for Layer III.
\r
31 * The implementation stores single bits as a word in the buffer. If
\r
32 * a bit is set, the corresponding word in the buffer will be non-zero.
\r
33 * If a bit is clear, the corresponding word is zero. Although this
\r
34 * may seem waseful, this can be a factor of two quicker than
\r
35 * packing 8 bits to a byte and extracting.
\r
39 // REVIEW: there is no range checking, so buffer underflow or overflow
\r
40 // can silently occur.
\r
41 @LATTICE("SH<V,V<T,TOT<OFF,OFF<T,SH*,TOT*,OFF*")
\r
42 @METHODDEFAULT("OUT<V,V<C,C<IN,C*,THISLOC=V,GLOBALLOC=V")
\r
43 final class BitReserve
\r
46 * Size of the internal buffer to store the reserved bits.
\r
47 * Must be a power of 2. And x8, as each bit is stored as a single
\r
50 @LOC("T") private static final int BUFSIZE = 4096*8;
\r
53 * Mask that can be used to quickly implement the
\r
54 * modulus operation on BUFSIZE.
\r
56 @LOC("V") private static final int BUFSIZE_MASK = BUFSIZE-1;
\r
58 @LOC("OFF") private int offset;
\r
59 @LOC("TOT") private int totbit;
\r
60 @LOC("SH") private int buf_byte_idx;
\r
61 @LOC("V") private final int[] buf;
\r
62 @LOC("T") private int buf_bit_idx;
\r
69 buf = new int[BUFSIZE];
\r
74 * Return totbit Field.
\r
78 public int hsstell()
\r
84 * Read a number bits from the bit stream.
\r
85 * @param N the number of
\r
87 @LATTICE("OUT<SH,SH<THIS,THIS<C,C<GLOBAL,C*,SH*,THISLOC=THIS,GLOBALLOC=GLOBAL")
\r
89 public int hgetbits(@LOC("C") int N)
\r
93 @LOC("SH") int val = 0;
\r
95 @LOC("THIS,BitReserve.SH") int pos = buf_byte_idx;
\r
96 if (pos+N < BUFSIZE)
\r
101 val |= ((buf[pos++]!=0) ? 1 : 0);
\r
109 val |= ((buf[pos]!=0) ? 1 : 0);
\r
110 pos = (pos+1) & BUFSIZE_MASK;
\r
113 buf_byte_idx = pos;
\r
120 * Read 1 bit from the bit stream.
\r
123 public int hget1bit_old()
\r
127 if (buf_bit_idx == 0)
\r
132 // BUFSIZE = 4096 = 2^12, so
\r
133 // buf_byte_idx%BUFSIZE == buf_byte_idx & 0xfff
\r
134 val = buf[buf_byte_idx & BUFSIZE_MASK] & putmask[buf_bit_idx];
\r
136 val = val >>> buf_bit_idx;
\r
141 * Returns next bit from reserve.
\r
142 * @returns 0 if next bit is reset, or 1 if next bit is set.
\r
145 public int hget1bit()
\r
148 @LOC("OUT") int val = buf[buf_byte_idx];
\r
149 buf_byte_idx = (buf_byte_idx+1) & BUFSIZE_MASK;
\r
154 * Retrieves bits from the reserve.
\r
157 public int readBits(int[] out, int len)
\r
159 if (buf_bit_idx == 0)
\r
163 current = buf[buf_byte_idx & BUFSIZE_MASK];
\r
168 // save total number of bits returned
\r
177 out[count--] = (b & 0x1);
\r
187 * Write 8 bits into the bit stream.
\r
189 @LATTICE("OUT<THIS,THIS<IN,THISLOC=THIS,GLOBALLOC=IN")
\r
190 public void hputbuf(@LOC("IN") int val)
\r
192 @LOC("THIS,BitReserve.OFF") int ofs = offset;
\r
193 buf[ofs++] = val & 0x80;
\r
194 buf[ofs++] = val & 0x40;
\r
195 buf[ofs++] = val & 0x20;
\r
196 buf[ofs++] = val & 0x10;
\r
197 buf[ofs++] = val & 0x08;
\r
198 buf[ofs++] = val & 0x04;
\r
199 buf[ofs++] = val & 0x02;
\r
200 buf[ofs++] = val & 0x01;
\r
210 * Rewind N bits in Stream.
\r
212 public void rewindNbits(int N)
\r
216 if (buf_byte_idx<0)
\r
217 buf_byte_idx += BUFSIZE;
\r
221 * Rewind N bytes in Stream.
\r
223 @LATTICE("THIS<BIT,BIT<N,THISLOC=THIS,GLOBALLOC=N")
\r
224 public void rewindNbytes(@LOC("N") int N)
\r
226 @LOC("BIT") int bits = (N << 3);
\r
228 buf_byte_idx -= bits;
\r
229 if (buf_byte_idx<0)
\r
230 buf_byte_idx += BUFSIZE;
\r