|
<html><head><title>dlib C++ Library - inftrees.h</title></head><body bgcolor='white'><pre> |
|
<font color='#009900'>/* inftrees.h -- header to use inftrees.c |
|
* Copyright (C) 1995-2005, 2010 Mark Adler |
|
* For conditions of distribution and use, see copyright notice in zlib.h |
|
*/</font> |
|
|
|
<font color='#009900'>/* WARNING: this file should *not* be used by applications. It is |
|
part of the implementation of the compression library and is |
|
subject to change. Applications should only use zlib.h. |
|
*/</font> |
|
|
|
<font color='#009900'>/* Structure for decoding tables. Each entry provides either the |
|
information needed to do the operation requested by the code that |
|
indexed that table entry, or it provides a pointer to another |
|
table that indexes more bits of the code. op indicates whether |
|
the entry is a pointer to another table, a literal, a length or |
|
distance, an end-of-block, or an invalid code. For a table |
|
pointer, the low four bits of op is the number of index bits of |
|
that table. For a length or distance, the low four bits of op |
|
is the number of extra bits to get after the code. bits is |
|
the number of bits in this code or part of the code to drop off |
|
of the bit buffer. val is the actual byte to output in the case |
|
of a literal, the base length or distance, or the offset from |
|
the current table to the next table. Each entry is four bytes. */</font> |
|
<font color='#0000FF'>typedef</font> <font color='#0000FF'>struct</font> <b>{</b> |
|
<font color='#0000FF'><u>unsigned</u></font> <font color='#0000FF'><u>char</u></font> op; <font color='#009900'>/* operation, extra bits, table bits */</font> |
|
<font color='#0000FF'><u>unsigned</u></font> <font color='#0000FF'><u>char</u></font> bits; <font color='#009900'>/* bits in this part of the code */</font> |
|
<font color='#0000FF'><u>unsigned</u></font> <font color='#0000FF'><u>short</u></font> val; <font color='#009900'>/* offset in table or code value */</font> |
|
<b>}</b> code; |
|
|
|
<font color='#009900'>/* op values as set by inflate_table(): |
|
00000000 - literal |
|
0000tttt - table link, tttt != 0 is the number of table index bits |
|
0001eeee - length or distance, eeee is the number of extra bits |
|
01100000 - end of block |
|
01000000 - invalid code |
|
*/</font> |
|
|
|
<font color='#009900'>/* Maximum size of the dynamic table. The maximum number of code structures is |
|
1444, which is the sum of 852 for literal/length codes and 592 for distance |
|
codes. These values were found by exhaustive searches using the program |
|
examples/enough.c found in the zlib distribtution. The arguments to that |
|
program are the number of symbols, the initial root table size, and the |
|
maximum bit length of a code. "enough 286 9 15" for literal/length codes |
|
returns returns 852, and "enough 30 6 15" for distance codes returns 592. |
|
The initial root table size (9 or 6) is found in the fifth argument of the |
|
inflate_table() calls in inflate.c and infback.c. If the root table size is |
|
changed, then these maximum sizes would be need to be recalculated and |
|
updated. */</font> |
|
<font color='#0000FF'>#define</font> ENOUGH_LENS <font color='#979000'>852</font> |
|
<font color='#0000FF'>#define</font> ENOUGH_DISTS <font color='#979000'>592</font> |
|
<font color='#0000FF'>#define</font> ENOUGH <font face='Lucida Console'>(</font>ENOUGH_LENS<font color='#5555FF'>+</font>ENOUGH_DISTS<font face='Lucida Console'>)</font> |
|
|
|
<font color='#009900'>/* Type of code to build for inflate_table() */</font> |
|
<font color='#0000FF'>typedef</font> <font color='#0000FF'>enum</font> <b>{</b> |
|
CODES, |
|
LENS, |
|
DISTS |
|
<b>}</b> codetype; |
|
|
|
<font color='#0000FF'><u>int</u></font> ZLIB_INTERNAL inflate_table <b><a name='OF'></a>OF</b><font face='Lucida Console'>(</font><font face='Lucida Console'>(</font>codetype type, <font color='#0000FF'><u>unsigned</u></font> <font color='#0000FF'><u>short</u></font> FAR <font color='#5555FF'>*</font>lens, |
|
<font color='#0000FF'><u>unsigned</u></font> codes, code FAR <font color='#5555FF'>*</font> FAR <font color='#5555FF'>*</font>table, |
|
<font color='#0000FF'><u>unsigned</u></font> FAR <font color='#5555FF'>*</font>bits, <font color='#0000FF'><u>unsigned</u></font> <font color='#0000FF'><u>short</u></font> FAR <font color='#5555FF'>*</font>work<font face='Lucida Console'>)</font><font face='Lucida Console'>)</font>; |
|
|
|
</pre></body></html> |
