From 85807e9f3f7d95d4701aafb33f4ea31d6e948f2d Mon Sep 17 00:00:00 2001 From: MistEO Date: Sun, 2 Jan 2022 03:45:21 +0800 Subject: [PATCH] =?UTF-8?q?perf.=E4=BC=98=E5=8C=96=E8=93=9D=E5=8F=A0?= =?UTF-8?q?=E5=9B=BD=E9=99=85=E7=89=88=E7=9A=84=E6=88=AA=E5=9B=BE=E9=80=9F?= =?UTF-8?q?=E5=BA=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 3rdparty/include/zlib/config.hpp | 5 + 3rdparty/include/zlib/decompress.hpp | 99 ++ 3rdparty/include/zlib/zconf.h | 536 +++++++ 3rdparty/include/zlib/zlib.h | 1912 +++++++++++++++++++++++++ 3rdparty/lib/zlibstatic.lib | Bin 0 -> 177362 bytes README.md | 2 + resource/config.json | 5 +- src/MeoAssistant/AsstDef.h | 4 +- src/MeoAssistant/Controller.cpp | 70 +- src/MeoAssistant/GeneralConfiger.cpp | 1 + src/MeoAssistant/MeoAssistant.vcxproj | 4 +- src/MeoAssistant/README.md | 2 + 12 files changed, 2605 insertions(+), 35 deletions(-) create mode 100644 3rdparty/include/zlib/config.hpp create mode 100644 3rdparty/include/zlib/decompress.hpp create mode 100644 3rdparty/include/zlib/zconf.h create mode 100644 3rdparty/include/zlib/zlib.h create mode 100644 3rdparty/lib/zlibstatic.lib diff --git a/3rdparty/include/zlib/config.hpp b/3rdparty/include/zlib/config.hpp new file mode 100644 index 0000000000..21f34a0b62 --- /dev/null +++ b/3rdparty/include/zlib/config.hpp @@ -0,0 +1,5 @@ +#pragma once + +#ifndef ZLIB_CONST +#define ZLIB_CONST +#endif \ No newline at end of file diff --git a/3rdparty/include/zlib/decompress.hpp b/3rdparty/include/zlib/decompress.hpp new file mode 100644 index 0000000000..03cb216b6e --- /dev/null +++ b/3rdparty/include/zlib/decompress.hpp @@ -0,0 +1,99 @@ +#include "config.hpp" + +// std +#include +#include +#include + +namespace gzip +{ + // zlib +#include "zlib.h" + + class Decompressor + { + std::size_t max_; + + public: + Decompressor(std::size_t max_bytes = 1000000000) // by default refuse operation if compressed data is > 1GB + : max_(max_bytes) + {} + + template + void decompress(OutputType& output, + const uchar* data, + std::size_t size) const + { + z_stream inflate_s; + + inflate_s.zalloc = Z_NULL; + inflate_s.zfree = Z_NULL; + inflate_s.opaque = Z_NULL; + inflate_s.avail_in = 0; + inflate_s.next_in = Z_NULL; + + // The windowBits parameter is the base two logarithm of the window size (the size of the history buffer). + // It should be in the range 8..15 for this version of the library. + // Larger values of this parameter result in better compression at the expense of memory usage. + // This range of values also changes the decoding type: + // -8 to -15 for raw deflate + // 8 to 15 for zlib + // (8 to 15) + 16 for gzip + // (8 to 15) + 32 to automatically detect gzip/zlib header + constexpr int window_bits = 15 + 32; // auto with windowbits of 15 + +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wold-style-cast" + if (inflateInit2(&inflate_s, window_bits) != Z_OK) { + throw std::runtime_error("inflate init failed"); + } +#pragma GCC diagnostic pop + inflate_s.next_in = reinterpret_cast(data); + +#ifdef DEBUG + // Verify if size (long type) input will fit into unsigned int, type used for zlib's avail_in + std::uint64_t size_64 = size * 2; + if (size_64 > std::numeric_limits::max()) { + inflateEnd(&inflate_s); + throw std::runtime_error("size arg is too large to fit into unsigned int type x2"); + } +#endif + if (size > max_ || (size * 2) > max_) { + inflateEnd(&inflate_s); + throw std::runtime_error("size may use more memory than intended when decompressing"); + } + inflate_s.avail_in = static_cast(size); + std::size_t size_uncompressed = 0; + do { + std::size_t resize_to = size_uncompressed + 2 * size; + if (resize_to > max_) { + inflateEnd(&inflate_s); + throw std::runtime_error("size of output string will use more memory then intended when decompressing"); + } + output.resize(resize_to); + inflate_s.avail_out = static_cast(2 * size); + inflate_s.next_out = reinterpret_cast(&output[0] + size_uncompressed); + int ret = inflate(&inflate_s, Z_FINISH); + if (ret != Z_STREAM_END && ret != Z_OK && ret != Z_BUF_ERROR) { + std::string error_msg = inflate_s.msg; + inflateEnd(&inflate_s); + //throw std::runtime_error(error_msg); + output.clear(); + return; + } + + size_uncompressed += (2 * size - inflate_s.avail_out); + } while (inflate_s.avail_out == 0); + inflateEnd(&inflate_s); + output.resize(size_uncompressed); + } + }; + + inline std::vector decompress(const uchar* data, std::size_t size) + { + Decompressor decomp; + std::vector output; + decomp.decompress(output, data, size); + return output; + } +} // namespace gzip diff --git a/3rdparty/include/zlib/zconf.h b/3rdparty/include/zlib/zconf.h new file mode 100644 index 0000000000..352f552b8f --- /dev/null +++ b/3rdparty/include/zlib/zconf.h @@ -0,0 +1,536 @@ +/* zconf.h -- configuration of the zlib compression library + * Copyright (C) 1995-2016 Jean-loup Gailly, Mark Adler + * For conditions of distribution and use, see copyright notice in zlib.h + */ + +/* @(#) $Id$ */ + +#ifndef ZCONF_H +#define ZCONF_H +/* #undef Z_PREFIX */ +/* #undef Z_HAVE_UNISTD_H */ + +/* + * If you *really* need a unique prefix for all types and library functions, + * compile with -DZ_PREFIX. The "standard" zlib should be compiled without it. + * Even better than compiling with -DZ_PREFIX would be to use configure to set + * this permanently in zconf.h using "./configure --zprefix". + */ +#ifdef Z_PREFIX /* may be set to #if 1 by ./configure */ +# define Z_PREFIX_SET + +/* all linked symbols and init macros */ +# define _dist_code z__dist_code +# define _length_code z__length_code +# define _tr_align z__tr_align +# define _tr_flush_bits z__tr_flush_bits +# define _tr_flush_block z__tr_flush_block +# define _tr_init z__tr_init +# define _tr_stored_block z__tr_stored_block +# define _tr_tally z__tr_tally +# define adler32 z_adler32 +# define adler32_combine z_adler32_combine +# define adler32_combine64 z_adler32_combine64 +# define adler32_z z_adler32_z +# ifndef Z_SOLO +# define compress z_compress +# define compress2 z_compress2 +# define compressBound z_compressBound +# endif +# define crc32 z_crc32 +# define crc32_combine z_crc32_combine +# define crc32_combine64 z_crc32_combine64 +# define crc32_z z_crc32_z +# define deflate z_deflate +# define deflateBound z_deflateBound +# define deflateCopy z_deflateCopy +# define deflateEnd z_deflateEnd +# define deflateGetDictionary z_deflateGetDictionary +# define deflateInit z_deflateInit +# define deflateInit2 z_deflateInit2 +# define deflateInit2_ z_deflateInit2_ +# define deflateInit_ z_deflateInit_ +# define deflateParams z_deflateParams +# define deflatePending z_deflatePending +# define deflatePrime z_deflatePrime +# define deflateReset z_deflateReset +# define deflateResetKeep z_deflateResetKeep +# define deflateSetDictionary z_deflateSetDictionary +# define deflateSetHeader z_deflateSetHeader +# define deflateTune z_deflateTune +# define deflate_copyright z_deflate_copyright +# define get_crc_table z_get_crc_table +# ifndef Z_SOLO +# define gz_error z_gz_error +# define gz_intmax z_gz_intmax +# define gz_strwinerror z_gz_strwinerror +# define gzbuffer z_gzbuffer +# define gzclearerr z_gzclearerr +# define gzclose z_gzclose +# define gzclose_r z_gzclose_r +# define gzclose_w z_gzclose_w +# define gzdirect z_gzdirect +# define gzdopen z_gzdopen +# define gzeof z_gzeof +# define gzerror z_gzerror +# define gzflush z_gzflush +# define gzfread z_gzfread +# define gzfwrite z_gzfwrite +# define gzgetc z_gzgetc +# define gzgetc_ z_gzgetc_ +# define gzgets z_gzgets +# define gzoffset z_gzoffset +# define gzoffset64 z_gzoffset64 +# define gzopen z_gzopen +# define gzopen64 z_gzopen64 +# ifdef _WIN32 +# define gzopen_w z_gzopen_w +# endif +# define gzprintf z_gzprintf +# define gzputc z_gzputc +# define gzputs z_gzputs +# define gzread z_gzread +# define gzrewind z_gzrewind +# define gzseek z_gzseek +# define gzseek64 z_gzseek64 +# define gzsetparams z_gzsetparams +# define gztell z_gztell +# define gztell64 z_gztell64 +# define gzungetc z_gzungetc +# define gzvprintf z_gzvprintf +# define gzwrite z_gzwrite +# endif +# define inflate z_inflate +# define inflateBack z_inflateBack +# define inflateBackEnd z_inflateBackEnd +# define inflateBackInit z_inflateBackInit +# define inflateBackInit_ z_inflateBackInit_ +# define inflateCodesUsed z_inflateCodesUsed +# define inflateCopy z_inflateCopy +# define inflateEnd z_inflateEnd +# define inflateGetDictionary z_inflateGetDictionary +# define inflateGetHeader z_inflateGetHeader +# define inflateInit z_inflateInit +# define inflateInit2 z_inflateInit2 +# define inflateInit2_ z_inflateInit2_ +# define inflateInit_ z_inflateInit_ +# define inflateMark z_inflateMark +# define inflatePrime z_inflatePrime +# define inflateReset z_inflateReset +# define inflateReset2 z_inflateReset2 +# define inflateResetKeep z_inflateResetKeep +# define inflateSetDictionary z_inflateSetDictionary +# define inflateSync z_inflateSync +# define inflateSyncPoint z_inflateSyncPoint +# define inflateUndermine z_inflateUndermine +# define inflateValidate z_inflateValidate +# define inflate_copyright z_inflate_copyright +# define inflate_fast z_inflate_fast +# define inflate_table z_inflate_table +# ifndef Z_SOLO +# define uncompress z_uncompress +# define uncompress2 z_uncompress2 +# endif +# define zError z_zError +# ifndef Z_SOLO +# define zcalloc z_zcalloc +# define zcfree z_zcfree +# endif +# define zlibCompileFlags z_zlibCompileFlags +# define zlibVersion z_zlibVersion + +/* all zlib typedefs in zlib.h and zconf.h */ +# define Byte z_Byte +# define Bytef z_Bytef +# define alloc_func z_alloc_func +# define charf z_charf +# define free_func z_free_func +# ifndef Z_SOLO +# define gzFile z_gzFile +# endif +# define gz_header z_gz_header +# define gz_headerp z_gz_headerp +# define in_func z_in_func +# define intf z_intf +# define out_func z_out_func +# define uInt z_uInt +# define uIntf z_uIntf +# define uLong z_uLong +# define uLongf z_uLongf +# define voidp z_voidp +# define voidpc z_voidpc +# define voidpf z_voidpf + +/* all zlib structs in zlib.h and zconf.h */ +# define gz_header_s z_gz_header_s +# define internal_state z_internal_state + +#endif + +#if defined(__MSDOS__) && !defined(MSDOS) +# define MSDOS +#endif +#if (defined(OS_2) || defined(__OS2__)) && !defined(OS2) +# define OS2 +#endif +#if defined(_WINDOWS) && !defined(WINDOWS) +# define WINDOWS +#endif +#if defined(_WIN32) || defined(_WIN32_WCE) || defined(__WIN32__) +# ifndef WIN32 +# define WIN32 +# endif +#endif +#if (defined(MSDOS) || defined(OS2) || defined(WINDOWS)) && !defined(WIN32) +# if !defined(__GNUC__) && !defined(__FLAT__) && !defined(__386__) +# ifndef SYS16BIT +# define SYS16BIT +# endif +# endif +#endif + +/* + * Compile with -DMAXSEG_64K if the alloc function cannot allocate more + * than 64k bytes at a time (needed on systems with 16-bit int). + */ +#ifdef SYS16BIT +# define MAXSEG_64K +#endif +#ifdef MSDOS +# define UNALIGNED_OK +#endif + +#ifdef __STDC_VERSION__ +# ifndef STDC +# define STDC +# endif +# if __STDC_VERSION__ >= 199901L +# ifndef STDC99 +# define STDC99 +# endif +# endif +#endif +#if !defined(STDC) && (defined(__STDC__) || defined(__cplusplus)) +# define STDC +#endif +#if !defined(STDC) && (defined(__GNUC__) || defined(__BORLANDC__)) +# define STDC +#endif +#if !defined(STDC) && (defined(MSDOS) || defined(WINDOWS) || defined(WIN32)) +# define STDC +#endif +#if !defined(STDC) && (defined(OS2) || defined(__HOS_AIX__)) +# define STDC +#endif + +#if defined(__OS400__) && !defined(STDC) /* iSeries (formerly AS/400). */ +# define STDC +#endif + +#ifndef STDC +# ifndef const /* cannot use !defined(STDC) && !defined(const) on Mac */ +# define const /* note: need a more gentle solution here */ +# endif +#endif + +#if defined(ZLIB_CONST) && !defined(z_const) +# define z_const const +#else +# define z_const +#endif + +#ifdef Z_SOLO + typedef unsigned long z_size_t; +#else +# define z_longlong long long +# if defined(NO_SIZE_T) + typedef unsigned NO_SIZE_T z_size_t; +# elif defined(STDC) +# include + typedef size_t z_size_t; +# else + typedef unsigned long z_size_t; +# endif +# undef z_longlong +#endif + +/* Maximum value for memLevel in deflateInit2 */ +#ifndef MAX_MEM_LEVEL +# ifdef MAXSEG_64K +# define MAX_MEM_LEVEL 8 +# else +# define MAX_MEM_LEVEL 9 +# endif +#endif + +/* Maximum value for windowBits in deflateInit2 and inflateInit2. + * WARNING: reducing MAX_WBITS makes minigzip unable to extract .gz files + * created by gzip. (Files created by minigzip can still be extracted by + * gzip.) + */ +#ifndef MAX_WBITS +# define MAX_WBITS 15 /* 32K LZ77 window */ +#endif + +/* The memory requirements for deflate are (in bytes): + (1 << (windowBits+2)) + (1 << (memLevel+9)) + that is: 128K for windowBits=15 + 128K for memLevel = 8 (default values) + plus a few kilobytes for small objects. For example, if you want to reduce + the default memory requirements from 256K to 128K, compile with + make CFLAGS="-O -DMAX_WBITS=14 -DMAX_MEM_LEVEL=7" + Of course this will generally degrade compression (there's no free lunch). + + The memory requirements for inflate are (in bytes) 1 << windowBits + that is, 32K for windowBits=15 (default value) plus about 7 kilobytes + for small objects. +*/ + + /* Type declarations */ + +#ifndef OF /* function prototypes */ +# ifdef STDC +# define OF(args) args +# else +# define OF(args) () +# endif +#endif + +#ifndef Z_ARG /* function prototypes for stdarg */ +# if defined(STDC) || defined(Z_HAVE_STDARG_H) +# define Z_ARG(args) args +# else +# define Z_ARG(args) () +# endif +#endif + +/* The following definitions for FAR are needed only for MSDOS mixed + * model programming (small or medium model with some far allocations). + * This was tested only with MSC; for other MSDOS compilers you may have + * to define NO_MEMCPY in zutil.h. If you don't need the mixed model, + * just define FAR to be empty. + */ +#ifdef SYS16BIT +# if defined(M_I86SM) || defined(M_I86MM) + /* MSC small or medium model */ +# define SMALL_MEDIUM +# ifdef _MSC_VER +# define FAR _far +# else +# define FAR far +# endif +# endif +# if (defined(__SMALL__) || defined(__MEDIUM__)) + /* Turbo C small or medium model */ +# define SMALL_MEDIUM +# ifdef __BORLANDC__ +# define FAR _far +# else +# define FAR far +# endif +# endif +#endif + +#if defined(WINDOWS) || defined(WIN32) + /* If building or using zlib as a DLL, define ZLIB_DLL. + * This is not mandatory, but it offers a little performance increase. + */ +# ifdef ZLIB_DLL +# if defined(WIN32) && (!defined(__BORLANDC__) || (__BORLANDC__ >= 0x500)) +# ifdef ZLIB_INTERNAL +# define ZEXTERN extern __declspec(dllexport) +# else +# define ZEXTERN extern __declspec(dllimport) +# endif +# endif +# endif /* ZLIB_DLL */ + /* If building or using zlib with the WINAPI/WINAPIV calling convention, + * define ZLIB_WINAPI. + * Caution: the standard ZLIB1.DLL is NOT compiled using ZLIB_WINAPI. + */ +# ifdef ZLIB_WINAPI +# ifdef FAR +# undef FAR +# endif +# include + /* No need for _export, use ZLIB.DEF instead. */ + /* For complete Windows compatibility, use WINAPI, not __stdcall. */ +# define ZEXPORT WINAPI +# ifdef WIN32 +# define ZEXPORTVA WINAPIV +# else +# define ZEXPORTVA FAR CDECL +# endif +# endif +#endif + +#if defined (__BEOS__) +# ifdef ZLIB_DLL +# ifdef ZLIB_INTERNAL +# define ZEXPORT __declspec(dllexport) +# define ZEXPORTVA __declspec(dllexport) +# else +# define ZEXPORT __declspec(dllimport) +# define ZEXPORTVA __declspec(dllimport) +# endif +# endif +#endif + +#ifndef ZEXTERN +# define ZEXTERN extern +#endif +#ifndef ZEXPORT +# define ZEXPORT +#endif +#ifndef ZEXPORTVA +# define ZEXPORTVA +#endif + +#ifndef FAR +# define FAR +#endif + +#if !defined(__MACTYPES__) +typedef unsigned char Byte; /* 8 bits */ +#endif +typedef unsigned int uInt; /* 16 bits or more */ +typedef unsigned long uLong; /* 32 bits or more */ + +#ifdef SMALL_MEDIUM + /* Borland C/C++ and some old MSC versions ignore FAR inside typedef */ +# define Bytef Byte FAR +#else + typedef Byte FAR Bytef; +#endif +typedef char FAR charf; +typedef int FAR intf; +typedef uInt FAR uIntf; +typedef uLong FAR uLongf; + +#ifdef STDC + typedef void const *voidpc; + typedef void FAR *voidpf; + typedef void *voidp; +#else + typedef Byte const *voidpc; + typedef Byte FAR *voidpf; + typedef Byte *voidp; +#endif + +#if !defined(Z_U4) && !defined(Z_SOLO) && defined(STDC) +# include +# if (UINT_MAX == 0xffffffffUL) +# define Z_U4 unsigned +# elif (ULONG_MAX == 0xffffffffUL) +# define Z_U4 unsigned long +# elif (USHRT_MAX == 0xffffffffUL) +# define Z_U4 unsigned short +# endif +#endif + +#ifdef Z_U4 + typedef Z_U4 z_crc_t; +#else + typedef unsigned long z_crc_t; +#endif + +#ifdef HAVE_UNISTD_H /* may be set to #if 1 by ./configure */ +# define Z_HAVE_UNISTD_H +#endif + +#ifdef HAVE_STDARG_H /* may be set to #if 1 by ./configure */ +# define Z_HAVE_STDARG_H +#endif + +#ifdef STDC +# ifndef Z_SOLO +# include /* for off_t */ +# endif +#endif + +#if defined(STDC) || defined(Z_HAVE_STDARG_H) +# ifndef Z_SOLO +# include /* for va_list */ +# endif +#endif + +#ifdef _WIN32 +# ifndef Z_SOLO +# include /* for wchar_t */ +# endif +#endif + +/* a little trick to accommodate both "#define _LARGEFILE64_SOURCE" and + * "#define _LARGEFILE64_SOURCE 1" as requesting 64-bit operations, (even + * though the former does not conform to the LFS document), but considering + * both "#undef _LARGEFILE64_SOURCE" and "#define _LARGEFILE64_SOURCE 0" as + * equivalently requesting no 64-bit operations + */ +#if defined(_LARGEFILE64_SOURCE) && -_LARGEFILE64_SOURCE - -1 == 1 +# undef _LARGEFILE64_SOURCE +#endif + +#if defined(__WATCOMC__) && !defined(Z_HAVE_UNISTD_H) +# define Z_HAVE_UNISTD_H +#endif +#ifndef Z_SOLO +# if defined(Z_HAVE_UNISTD_H) || defined(_LARGEFILE64_SOURCE) +# include /* for SEEK_*, off_t, and _LFS64_LARGEFILE */ +# ifdef VMS +# include /* for off_t */ +# endif +# ifndef z_off_t +# define z_off_t off_t +# endif +# endif +#endif + +#if defined(_LFS64_LARGEFILE) && _LFS64_LARGEFILE-0 +# define Z_LFS64 +#endif + +#if defined(_LARGEFILE64_SOURCE) && defined(Z_LFS64) +# define Z_LARGE64 +#endif + +#if defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS-0 == 64 && defined(Z_LFS64) +# define Z_WANT64 +#endif + +#if !defined(SEEK_SET) && !defined(Z_SOLO) +# define SEEK_SET 0 /* Seek from beginning of file. */ +# define SEEK_CUR 1 /* Seek from current position. */ +# define SEEK_END 2 /* Set file pointer to EOF plus "offset" */ +#endif + +#ifndef z_off_t +# define z_off_t long +#endif + +#if !defined(_WIN32) && defined(Z_LARGE64) +# define z_off64_t off64_t +#else +# if defined(_WIN32) && !defined(__GNUC__) && !defined(Z_SOLO) +# define z_off64_t __int64 +# else +# define z_off64_t z_off_t +# endif +#endif + +/* MVS linker does not support external names larger than 8 bytes */ +#if defined(__MVS__) + #pragma map(deflateInit_,"DEIN") + #pragma map(deflateInit2_,"DEIN2") + #pragma map(deflateEnd,"DEEND") + #pragma map(deflateBound,"DEBND") + #pragma map(inflateInit_,"ININ") + #pragma map(inflateInit2_,"ININ2") + #pragma map(inflateEnd,"INEND") + #pragma map(inflateSync,"INSY") + #pragma map(inflateSetDictionary,"INSEDI") + #pragma map(compressBound,"CMBND") + #pragma map(inflate_table,"INTABL") + #pragma map(inflate_fast,"INFA") + #pragma map(inflate_copyright,"INCOPY") +#endif + +#endif /* ZCONF_H */ diff --git a/3rdparty/include/zlib/zlib.h b/3rdparty/include/zlib/zlib.h new file mode 100644 index 0000000000..f09cdaf1e0 --- /dev/null +++ b/3rdparty/include/zlib/zlib.h @@ -0,0 +1,1912 @@ +/* zlib.h -- interface of the 'zlib' general purpose compression library + version 1.2.11, January 15th, 2017 + + Copyright (C) 1995-2017 Jean-loup Gailly and Mark Adler + + This software is provided 'as-is', without any express or implied + warranty. In no event will the authors be held liable for any damages + arising from the use of this software. + + Permission is granted to anyone to use this software for any purpose, + including commercial applications, and to alter it and redistribute it + freely, subject to the following restrictions: + + 1. The origin of this software must not be misrepresented; you must not + claim that you wrote the original software. If you use this software + in a product, an acknowledgment in the product documentation would be + appreciated but is not required. + 2. Altered source versions must be plainly marked as such, and must not be + misrepresented as being the original software. + 3. This notice may not be removed or altered from any source distribution. + + Jean-loup Gailly Mark Adler + jloup@gzip.org madler@alumni.caltech.edu + + + The data format used by the zlib library is described by RFCs (Request for + Comments) 1950 to 1952 in the files http://tools.ietf.org/html/rfc1950 + (zlib format), rfc1951 (deflate format) and rfc1952 (gzip format). +*/ + +#ifndef ZLIB_H +#define ZLIB_H + +#include "zconf.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define ZLIB_VERSION "1.2.11" +#define ZLIB_VERNUM 0x12b0 +#define ZLIB_VER_MAJOR 1 +#define ZLIB_VER_MINOR 2 +#define ZLIB_VER_REVISION 11 +#define ZLIB_VER_SUBREVISION 0 + +/* + The 'zlib' compression library provides in-memory compression and + decompression functions, including integrity checks of the uncompressed data. + This version of the library supports only one compression method (deflation) + but other algorithms will be added later and will have the same stream + interface. + + Compression can be done in a single step if the buffers are large enough, + or can be done by repeated calls of the compression function. In the latter + case, the application must provide more input and/or consume the output + (providing more output space) before each call. + + The compressed data format used by default by the in-memory functions is + the zlib format, which is a zlib wrapper documented in RFC 1950, wrapped + around a deflate stream, which is itself documented in RFC 1951. + + The library also supports reading and writing files in gzip (.gz) format + with an interface similar to that of stdio using the functions that start + with "gz". The gzip format is different from the zlib format. gzip is a + gzip wrapper, documented in RFC 1952, wrapped around a deflate stream. + + This library can optionally read and write gzip and raw deflate streams in + memory as well. + + The zlib format was designed to be compact and fast for use in memory + and on communications channels. The gzip format was designed for single- + file compression on file systems, has a larger header than zlib to maintain + directory information, and uses a different, slower check method than zlib. + + The library does not install any signal handler. The decoder checks + the consistency of the compressed data, so the library should never crash + even in the case of corrupted input. +*/ + +typedef voidpf (*alloc_func) OF((voidpf opaque, uInt items, uInt size)); +typedef void (*free_func) OF((voidpf opaque, voidpf address)); + +struct internal_state; + +typedef struct z_stream_s { + z_const Bytef *next_in; /* next input byte */ + uInt avail_in; /* number of bytes available at next_in */ + uLong total_in; /* total number of input bytes read so far */ + + Bytef *next_out; /* next output byte will go here */ + uInt avail_out; /* remaining free space at next_out */ + uLong total_out; /* total number of bytes output so far */ + + z_const char *msg; /* last error message, NULL if no error */ + struct internal_state FAR *state; /* not visible by applications */ + + alloc_func zalloc; /* used to allocate the internal state */ + free_func zfree; /* used to free the internal state */ + voidpf opaque; /* private data object passed to zalloc and zfree */ + + int data_type; /* best guess about the data type: binary or text + for deflate, or the decoding state for inflate */ + uLong adler; /* Adler-32 or CRC-32 value of the uncompressed data */ + uLong reserved; /* reserved for future use */ +} z_stream; + +typedef z_stream FAR *z_streamp; + +/* + gzip header information passed to and from zlib routines. See RFC 1952 + for more details on the meanings of these fields. +*/ +typedef struct gz_header_s { + int text; /* true if compressed data believed to be text */ + uLong time; /* modification time */ + int xflags; /* extra flags (not used when writing a gzip file) */ + int os; /* operating system */ + Bytef *extra; /* pointer to extra field or Z_NULL if none */ + uInt extra_len; /* extra field length (valid if extra != Z_NULL) */ + uInt extra_max; /* space at extra (only when reading header) */ + Bytef *name; /* pointer to zero-terminated file name or Z_NULL */ + uInt name_max; /* space at name (only when reading header) */ + Bytef *comment; /* pointer to zero-terminated comment or Z_NULL */ + uInt comm_max; /* space at comment (only when reading header) */ + int hcrc; /* true if there was or will be a header crc */ + int done; /* true when done reading gzip header (not used + when writing a gzip file) */ +} gz_header; + +typedef gz_header FAR *gz_headerp; + +/* + The application must update next_in and avail_in when avail_in has dropped + to zero. It must update next_out and avail_out when avail_out has dropped + to zero. The application must initialize zalloc, zfree and opaque before + calling the init function. All other fields are set by the compression + library and must not be updated by the application. + + The opaque value provided by the application will be passed as the first + parameter for calls of zalloc and zfree. This can be useful for custom + memory management. The compression library attaches no meaning to the + opaque value. + + zalloc must return Z_NULL if there is not enough memory for the object. + If zlib is used in a multi-threaded application, zalloc and zfree must be + thread safe. In that case, zlib is thread-safe. When zalloc and zfree are + Z_NULL on entry to the initialization function, they are set to internal + routines that use the standard library functions malloc() and free(). + + On 16-bit systems, the functions zalloc and zfree must be able to allocate + exactly 65536 bytes, but will not be required to allocate more than this if + the symbol MAXSEG_64K is defined (see zconf.h). WARNING: On MSDOS, pointers + returned by zalloc for objects of exactly 65536 bytes *must* have their + offset normalized to zero. The default allocation function provided by this + library ensures this (see zutil.c). To reduce memory requirements and avoid + any allocation of 64K objects, at the expense of compression ratio, compile + the library with -DMAX_WBITS=14 (see zconf.h). + + The fields total_in and total_out can be used for statistics or progress + reports. After compression, total_in holds the total size of the + uncompressed data and may be saved for use by the decompressor (particularly + if the decompressor wants to decompress everything in a single step). +*/ + + /* constants */ + +#define Z_NO_FLUSH 0 +#define Z_PARTIAL_FLUSH 1 +#define Z_SYNC_FLUSH 2 +#define Z_FULL_FLUSH 3 +#define Z_FINISH 4 +#define Z_BLOCK 5 +#define Z_TREES 6 +/* Allowed flush values; see deflate() and inflate() below for details */ + +#define Z_OK 0 +#define Z_STREAM_END 1 +#define Z_NEED_DICT 2 +#define Z_ERRNO (-1) +#define Z_STREAM_ERROR (-2) +#define Z_DATA_ERROR (-3) +#define Z_MEM_ERROR (-4) +#define Z_BUF_ERROR (-5) +#define Z_VERSION_ERROR (-6) +/* Return codes for the compression/decompression functions. Negative values + * are errors, positive values are used for special but normal events. + */ + +#define Z_NO_COMPRESSION 0 +#define Z_BEST_SPEED 1 +#define Z_BEST_COMPRESSION 9 +#define Z_DEFAULT_COMPRESSION (-1) +/* compression levels */ + +#define Z_FILTERED 1 +#define Z_HUFFMAN_ONLY 2 +#define Z_RLE 3 +#define Z_FIXED 4 +#define Z_DEFAULT_STRATEGY 0 +/* compression strategy; see deflateInit2() below for details */ + +#define Z_BINARY 0 +#define Z_TEXT 1 +#define Z_ASCII Z_TEXT /* for compatibility with 1.2.2 and earlier */ +#define Z_UNKNOWN 2 +/* Possible values of the data_type field for deflate() */ + +#define Z_DEFLATED 8 +/* The deflate compression method (the only one supported in this version) */ + +#define Z_NULL 0 /* for initializing zalloc, zfree, opaque */ + +#define zlib_version zlibVersion() +/* for compatibility with versions < 1.0.2 */ + + + /* basic functions */ + +ZEXTERN const char * ZEXPORT zlibVersion OF((void)); +/* The application can compare zlibVersion and ZLIB_VERSION for consistency. + If the first character differs, the library code actually used is not + compatible with the zlib.h header file used by the application. This check + is automatically made by deflateInit and inflateInit. + */ + +/* +ZEXTERN int ZEXPORT deflateInit OF((z_streamp strm, int level)); + + Initializes the internal stream state for compression. The fields + zalloc, zfree and opaque must be initialized before by the caller. If + zalloc and zfree are set to Z_NULL, deflateInit updates them to use default + allocation functions. + + The compression level must be Z_DEFAULT_COMPRESSION, or between 0 and 9: + 1 gives best speed, 9 gives best compression, 0 gives no compression at all + (the input data is simply copied a block at a time). Z_DEFAULT_COMPRESSION + requests a default compromise between speed and compression (currently + equivalent to level 6). + + deflateInit returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_STREAM_ERROR if level is not a valid compression level, or + Z_VERSION_ERROR if the zlib library version (zlib_version) is incompatible + with the version assumed by the caller (ZLIB_VERSION). msg is set to null + if there is no error message. deflateInit does not perform any compression: + this will be done by deflate(). +*/ + + +ZEXTERN int ZEXPORT deflate OF((z_streamp strm, int flush)); +/* + deflate compresses as much data as possible, and stops when the input + buffer becomes empty or the output buffer becomes full. It may introduce + some output latency (reading input without producing any output) except when + forced to flush. + + The detailed semantics are as follows. deflate performs one or both of the + following actions: + + - Compress more input starting at next_in and update next_in and avail_in + accordingly. If not all input can be processed (because there is not + enough room in the output buffer), next_in and avail_in are updated and + processing will resume at this point for the next call of deflate(). + + - Generate more output starting at next_out and update next_out and avail_out + accordingly. This action is forced if the parameter flush is non zero. + Forcing flush frequently degrades the compression ratio, so this parameter + should be set only when necessary. Some output may be provided even if + flush is zero. + + Before the call of deflate(), the application should ensure that at least + one of the actions is possible, by providing more input and/or consuming more + output, and updating avail_in or avail_out accordingly; avail_out should + never be zero before the call. The application can consume the compressed + output when it wants, for example when the output buffer is full (avail_out + == 0), or after each call of deflate(). If deflate returns Z_OK and with + zero avail_out, it must be called again after making room in the output + buffer because there might be more output pending. See deflatePending(), + which can be used if desired to determine whether or not there is more ouput + in that case. + + Normally the parameter flush is set to Z_NO_FLUSH, which allows deflate to + decide how much data to accumulate before producing output, in order to + maximize compression. + + If the parameter flush is set to Z_SYNC_FLUSH, all pending output is + flushed to the output buffer and the output is aligned on a byte boundary, so + that the decompressor can get all input data available so far. (In + particular avail_in is zero after the call if enough output space has been + provided before the call.) Flushing may degrade compression for some + compression algorithms and so it should be used only when necessary. This + completes the current deflate block and follows it with an empty stored block + that is three bits plus filler bits to the next byte, followed by four bytes + (00 00 ff ff). + + If flush is set to Z_PARTIAL_FLUSH, all pending output is flushed to the + output buffer, but the output is not aligned to a byte boundary. All of the + input data so far will be available to the decompressor, as for Z_SYNC_FLUSH. + This completes the current deflate block and follows it with an empty fixed + codes block that is 10 bits long. This assures that enough bytes are output + in order for the decompressor to finish the block before the empty fixed + codes block. + + If flush is set to Z_BLOCK, a deflate block is completed and emitted, as + for Z_SYNC_FLUSH, but the output is not aligned on a byte boundary, and up to + seven bits of the current block are held to be written as the next byte after + the next deflate block is completed. In this case, the decompressor may not + be provided enough bits at this point in order to complete decompression of + the data provided so far to the compressor. It may need to wait for the next + block to be emitted. This is for advanced applications that need to control + the emission of deflate blocks. + + If flush is set to Z_FULL_FLUSH, all output is flushed as with + Z_SYNC_FLUSH, and the compression state is reset so that decompression can + restart from this point if previous compressed data has been damaged or if + random access is desired. Using Z_FULL_FLUSH too often can seriously degrade + compression. + + If deflate returns with avail_out == 0, this function must be called again + with the same value of the flush parameter and more output space (updated + avail_out), until the flush is complete (deflate returns with non-zero + avail_out). In the case of a Z_FULL_FLUSH or Z_SYNC_FLUSH, make sure that + avail_out is greater than six to avoid repeated flush markers due to + avail_out == 0 on return. + + If the parameter flush is set to Z_FINISH, pending input is processed, + pending output is flushed and deflate returns with Z_STREAM_END if there was + enough output space. If deflate returns with Z_OK or Z_BUF_ERROR, this + function must be called again with Z_FINISH and more output space (updated + avail_out) but no more input data, until it returns with Z_STREAM_END or an + error. After deflate has returned Z_STREAM_END, the only possible operations + on the stream are deflateReset or deflateEnd. + + Z_FINISH can be used in the first deflate call after deflateInit if all the + compression is to be done in a single step. In order to complete in one + call, avail_out must be at least the value returned by deflateBound (see + below). Then deflate is guaranteed to return Z_STREAM_END. If not enough + output space is provided, deflate will not return Z_STREAM_END, and it must + be called again as described above. + + deflate() sets strm->adler to the Adler-32 checksum of all input read + so far (that is, total_in bytes). If a gzip stream is being generated, then + strm->adler will be the CRC-32 checksum of the input read so far. (See + deflateInit2 below.) + + deflate() may update strm->data_type if it can make a good guess about + the input data type (Z_BINARY or Z_TEXT). If in doubt, the data is + considered binary. This field is only for information purposes and does not + affect the compression algorithm in any manner. + + deflate() returns Z_OK if some progress has been made (more input + processed or more output produced), Z_STREAM_END if all input has been + consumed and all output has been produced (only when flush is set to + Z_FINISH), Z_STREAM_ERROR if the stream state was inconsistent (for example + if next_in or next_out was Z_NULL or the state was inadvertently written over + by the application), or Z_BUF_ERROR if no progress is possible (for example + avail_in or avail_out was zero). Note that Z_BUF_ERROR is not fatal, and + deflate() can be called again with more input and more output space to + continue compressing. +*/ + + +ZEXTERN int ZEXPORT deflateEnd OF((z_streamp strm)); +/* + All dynamically allocated data structures for this stream are freed. + This function discards any unprocessed input and does not flush any pending + output. + + deflateEnd returns Z_OK if success, Z_STREAM_ERROR if the + stream state was inconsistent, Z_DATA_ERROR if the stream was freed + prematurely (some input or output was discarded). In the error case, msg + may be set but then points to a static string (which must not be + deallocated). +*/ + + +/* +ZEXTERN int ZEXPORT inflateInit OF((z_streamp strm)); + + Initializes the internal stream state for decompression. The fields + next_in, avail_in, zalloc, zfree and opaque must be initialized before by + the caller. In the current version of inflate, the provided input is not + read or consumed. The allocation of a sliding window will be deferred to + the first call of inflate (if the decompression does not complete on the + first call). If zalloc and zfree are set to Z_NULL, inflateInit updates + them to use default allocation functions. + + inflateInit returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_VERSION_ERROR if the zlib library version is incompatible with the + version assumed by the caller, or Z_STREAM_ERROR if the parameters are + invalid, such as a null pointer to the structure. msg is set to null if + there is no error message. inflateInit does not perform any decompression. + Actual decompression will be done by inflate(). So next_in, and avail_in, + next_out, and avail_out are unused and unchanged. The current + implementation of inflateInit() does not process any header information -- + that is deferred until inflate() is called. +*/ + + +ZEXTERN int ZEXPORT inflate OF((z_streamp strm, int flush)); +/* + inflate decompresses as much data as possible, and stops when the input + buffer becomes empty or the output buffer becomes full. It may introduce + some output latency (reading input without producing any output) except when + forced to flush. + + The detailed semantics are as follows. inflate performs one or both of the + following actions: + + - Decompress more input starting at next_in and update next_in and avail_in + accordingly. If not all input can be processed (because there is not + enough room in the output buffer), then next_in and avail_in are updated + accordingly, and processing will resume at this point for the next call of + inflate(). + + - Generate more output starting at next_out and update next_out and avail_out + accordingly. inflate() provides as much output as possible, until there is + no more input data or no more space in the output buffer (see below about + the flush parameter). + + Before the call of inflate(), the application should ensure that at least + one of the actions is possible, by providing more input and/or consuming more + output, and updating the next_* and avail_* values accordingly. If the + caller of inflate() does not provide both available input and available + output space, it is possible that there will be no progress made. The + application can consume the uncompressed output when it wants, for example + when the output buffer is full (avail_out == 0), or after each call of + inflate(). If inflate returns Z_OK and with zero avail_out, it must be + called again after making room in the output buffer because there might be + more output pending. + + The flush parameter of inflate() can be Z_NO_FLUSH, Z_SYNC_FLUSH, Z_FINISH, + Z_BLOCK, or Z_TREES. Z_SYNC_FLUSH requests that inflate() flush as much + output as possible to the output buffer. Z_BLOCK requests that inflate() + stop if and when it gets to the next deflate block boundary. When decoding + the zlib or gzip format, this will cause inflate() to return immediately + after the header and before the first block. When doing a raw inflate, + inflate() will go ahead and process the first block, and will return when it + gets to the end of that block, or when it runs out of data. + + The Z_BLOCK option assists in appending to or combining deflate streams. + To assist in this, on return inflate() always sets strm->data_type to the + number of unused bits in the last byte taken from strm->next_in, plus 64 if + inflate() is currently decoding the last block in the deflate stream, plus + 128 if inflate() returned immediately after decoding an end-of-block code or + decoding the complete header up to just before the first byte of the deflate + stream. The end-of-block will not be indicated until all of the uncompressed + data from that block has been written to strm->next_out. The number of + unused bits may in general be greater than seven, except when bit 7 of + data_type is set, in which case the number of unused bits will be less than + eight. data_type is set as noted here every time inflate() returns for all + flush options, and so can be used to determine the amount of currently + consumed input in bits. + + The Z_TREES option behaves as Z_BLOCK does, but it also returns when the + end of each deflate block header is reached, before any actual data in that + block is decoded. This allows the caller to determine the length of the + deflate block header for later use in random access within a deflate block. + 256 is added to the value of strm->data_type when inflate() returns + immediately after reaching the end of the deflate block header. + + inflate() should normally be called until it returns Z_STREAM_END or an + error. However if all decompression is to be performed in a single step (a + single call of inflate), the parameter flush should be set to Z_FINISH. In + this case all pending input is processed and all pending output is flushed; + avail_out must be large enough to hold all of the uncompressed data for the + operation to complete. (The size of the uncompressed data may have been + saved by the compressor for this purpose.) The use of Z_FINISH is not + required to perform an inflation in one step. However it may be used to + inform inflate that a faster approach can be used for the single inflate() + call. Z_FINISH also informs inflate to not maintain a sliding window if the + stream completes, which reduces inflate's memory footprint. If the stream + does not complete, either because not all of the stream is provided or not + enough output space is provided, then a sliding window will be allocated and + inflate() can be called again to continue the operation as if Z_NO_FLUSH had + been used. + + In this implementation, inflate() always flushes as much output as + possible to the output buffer, and always uses the faster approach on the + first call. So the effects of the flush parameter in this implementation are + on the return value of inflate() as noted below, when inflate() returns early + when Z_BLOCK or Z_TREES is used, and when inflate() avoids the allocation of + memory for a sliding window when Z_FINISH is used. + + If a preset dictionary is needed after this call (see inflateSetDictionary + below), inflate sets strm->adler to the Adler-32 checksum of the dictionary + chosen by the compressor and returns Z_NEED_DICT; otherwise it sets + strm->adler to the Adler-32 checksum of all output produced so far (that is, + total_out bytes) and returns Z_OK, Z_STREAM_END or an error code as described + below. At the end of the stream, inflate() checks that its computed Adler-32 + checksum is equal to that saved by the compressor and returns Z_STREAM_END + only if the checksum is correct. + + inflate() can decompress and check either zlib-wrapped or gzip-wrapped + deflate data. The header type is detected automatically, if requested when + initializing with inflateInit2(). Any information contained in the gzip + header is not retained unless inflateGetHeader() is used. When processing + gzip-wrapped deflate data, strm->adler32 is set to the CRC-32 of the output + produced so far. The CRC-32 is checked against the gzip trailer, as is the + uncompressed length, modulo 2^32. + + inflate() returns Z_OK if some progress has been made (more input processed + or more output produced), Z_STREAM_END if the end of the compressed data has + been reached and all uncompressed output has been produced, Z_NEED_DICT if a + preset dictionary is needed at this point, Z_DATA_ERROR if the input data was + corrupted (input stream not conforming to the zlib format or incorrect check + value, in which case strm->msg points to a string with a more specific + error), Z_STREAM_ERROR if the stream structure was inconsistent (for example + next_in or next_out was Z_NULL, or the state was inadvertently written over + by the application), Z_MEM_ERROR if there was not enough memory, Z_BUF_ERROR + if no progress was possible or if there was not enough room in the output + buffer when Z_FINISH is used. Note that Z_BUF_ERROR is not fatal, and + inflate() can be called again with more input and more output space to + continue decompressing. If Z_DATA_ERROR is returned, the application may + then call inflateSync() to look for a good compression block if a partial + recovery of the data is to be attempted. +*/ + + +ZEXTERN int ZEXPORT inflateEnd OF((z_streamp strm)); +/* + All dynamically allocated data structures for this stream are freed. + This function discards any unprocessed input and does not flush any pending + output. + + inflateEnd returns Z_OK if success, or Z_STREAM_ERROR if the stream state + was inconsistent. +*/ + + + /* Advanced functions */ + +/* + The following functions are needed only in some special applications. +*/ + +/* +ZEXTERN int ZEXPORT deflateInit2 OF((z_streamp strm, + int level, + int method, + int windowBits, + int memLevel, + int strategy)); + + This is another version of deflateInit with more compression options. The + fields next_in, zalloc, zfree and opaque must be initialized before by the + caller. + + The method parameter is the compression method. It must be Z_DEFLATED in + this version of the library. + + The windowBits parameter is the base two logarithm of the window size + (the size of the history buffer). It should be in the range 8..15 for this + version of the library. Larger values of this parameter result in better + compression at the expense of memory usage. The default value is 15 if + deflateInit is used instead. + + For the current implementation of deflate(), a windowBits value of 8 (a + window size of 256 bytes) is not supported. As a result, a request for 8 + will result in 9 (a 512-byte window). In that case, providing 8 to + inflateInit2() will result in an error when the zlib header with 9 is + checked against the initialization of inflate(). The remedy is to not use 8 + with deflateInit2() with this initialization, or at least in that case use 9 + with inflateInit2(). + + windowBits can also be -8..-15 for raw deflate. In this case, -windowBits + determines the window size. deflate() will then generate raw deflate data + with no zlib header or trailer, and will not compute a check value. + + windowBits can also be greater than 15 for optional gzip encoding. Add + 16 to windowBits to write a simple gzip header and trailer around the + compressed data instead of a zlib wrapper. The gzip header will have no + file name, no extra data, no comment, no modification time (set to zero), no + header crc, and the operating system will be set to the appropriate value, + if the operating system was determined at compile time. If a gzip stream is + being written, strm->adler is a CRC-32 instead of an Adler-32. + + For raw deflate or gzip encoding, a request for a 256-byte window is + rejected as invalid, since only the zlib header provides a means of + transmitting the window size to the decompressor. + + The memLevel parameter specifies how much memory should be allocated + for the internal compression state. memLevel=1 uses minimum memory but is + slow and reduces compression ratio; memLevel=9 uses maximum memory for + optimal speed. The default value is 8. See zconf.h for total memory usage + as a function of windowBits and memLevel. + + The strategy parameter is used to tune the compression algorithm. Use the + value Z_DEFAULT_STRATEGY for normal data, Z_FILTERED for data produced by a + filter (or predictor), Z_HUFFMAN_ONLY to force Huffman encoding only (no + string match), or Z_RLE to limit match distances to one (run-length + encoding). Filtered data consists mostly of small values with a somewhat + random distribution. In this case, the compression algorithm is tuned to + compress them better. The effect of Z_FILTERED is to force more Huffman + coding and less string matching; it is somewhat intermediate between + Z_DEFAULT_STRATEGY and Z_HUFFMAN_ONLY. Z_RLE is designed to be almost as + fast as Z_HUFFMAN_ONLY, but give better compression for PNG image data. The + strategy parameter only affects the compression ratio but not the + correctness of the compressed output even if it is not set appropriately. + Z_FIXED prevents the use of dynamic Huffman codes, allowing for a simpler + decoder for special applications. + + deflateInit2 returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_STREAM_ERROR if any parameter is invalid (such as an invalid + method), or Z_VERSION_ERROR if the zlib library version (zlib_version) is + incompatible with the version assumed by the caller (ZLIB_VERSION). msg is + set to null if there is no error message. deflateInit2 does not perform any + compression: this will be done by deflate(). +*/ + +ZEXTERN int ZEXPORT deflateSetDictionary OF((z_streamp strm, + const Bytef *dictionary, + uInt dictLength)); +/* + Initializes the compression dictionary from the given byte sequence + without producing any compressed output. When using the zlib format, this + function must be called immediately after deflateInit, deflateInit2 or + deflateReset, and before any call of deflate. When doing raw deflate, this + function must be called either before any call of deflate, or immediately + after the completion of a deflate block, i.e. after all input has been + consumed and all output has been delivered when using any of the flush + options Z_BLOCK, Z_PARTIAL_FLUSH, Z_SYNC_FLUSH, or Z_FULL_FLUSH. The + compressor and decompressor must use exactly the same dictionary (see + inflateSetDictionary). + + The dictionary should consist of strings (byte sequences) that are likely + to be encountered later in the data to be compressed, with the most commonly + used strings preferably put towards the end of the dictionary. Using a + dictionary is most useful when the data to be compressed is short and can be + predicted with good accuracy; the data can then be compressed better than + with the default empty dictionary. + + Depending on the size of the compression data structures selected by + deflateInit or deflateInit2, a part of the dictionary may in effect be + discarded, for example if the dictionary is larger than the window size + provided in deflateInit or deflateInit2. Thus the strings most likely to be + useful should be put at the end of the dictionary, not at the front. In + addition, the current implementation of deflate will use at most the window + size minus 262 bytes of the provided dictionary. + + Upon return of this function, strm->adler is set to the Adler-32 value + of the dictionary; the decompressor may later use this value to determine + which dictionary has been used by the compressor. (The Adler-32 value + applies to the whole dictionary even if only a subset of the dictionary is + actually used by the compressor.) If a raw deflate was requested, then the + Adler-32 value is not computed and strm->adler is not set. + + deflateSetDictionary returns Z_OK if success, or Z_STREAM_ERROR if a + parameter is invalid (e.g. dictionary being Z_NULL) or the stream state is + inconsistent (for example if deflate has already been called for this stream + or if not at a block boundary for raw deflate). deflateSetDictionary does + not perform any compression: this will be done by deflate(). +*/ + +ZEXTERN int ZEXPORT deflateGetDictionary OF((z_streamp strm, + Bytef *dictionary, + uInt *dictLength)); +/* + Returns the sliding dictionary being maintained by deflate. dictLength is + set to the number of bytes in the dictionary, and that many bytes are copied + to dictionary. dictionary must have enough space, where 32768 bytes is + always enough. If deflateGetDictionary() is called with dictionary equal to + Z_NULL, then only the dictionary length is returned, and nothing is copied. + Similary, if dictLength is Z_NULL, then it is not set. + + deflateGetDictionary() may return a length less than the window size, even + when more than the window size in input has been provided. It may return up + to 258 bytes less in that case, due to how zlib's implementation of deflate + manages the sliding window and lookahead for matches, where matches can be + up to 258 bytes long. If the application needs the last window-size bytes of + input, then that would need to be saved by the application outside of zlib. + + deflateGetDictionary returns Z_OK on success, or Z_STREAM_ERROR if the + stream state is inconsistent. +*/ + +ZEXTERN int ZEXPORT deflateCopy OF((z_streamp dest, + z_streamp source)); +/* + Sets the destination stream as a complete copy of the source stream. + + This function can be useful when several compression strategies will be + tried, for example when there are several ways of pre-processing the input + data with a filter. The streams that will be discarded should then be freed + by calling deflateEnd. Note that deflateCopy duplicates the internal + compression state which can be quite large, so this strategy is slow and can + consume lots of memory. + + deflateCopy returns Z_OK if success, Z_MEM_ERROR if there was not + enough memory, Z_STREAM_ERROR if the source stream state was inconsistent + (such as zalloc being Z_NULL). msg is left unchanged in both source and + destination. +*/ + +ZEXTERN int ZEXPORT deflateReset OF((z_streamp strm)); +/* + This function is equivalent to deflateEnd followed by deflateInit, but + does not free and reallocate the internal compression state. The stream + will leave the compression level and any other attributes that may have been + set unchanged. + + deflateReset returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent (such as zalloc or state being Z_NULL). +*/ + +ZEXTERN int ZEXPORT deflateParams OF((z_streamp strm, + int level, + int strategy)); +/* + Dynamically update the compression level and compression strategy. The + interpretation of level and strategy is as in deflateInit2(). This can be + used to switch between compression and straight copy of the input data, or + to switch to a different kind of input data requiring a different strategy. + If the compression approach (which is a function of the level) or the + strategy is changed, and if any input has been consumed in a previous + deflate() call, then the input available so far is compressed with the old + level and strategy using deflate(strm, Z_BLOCK). There are three approaches + for the compression levels 0, 1..3, and 4..9 respectively. The new level + and strategy will take effect at the next call of deflate(). + + If a deflate(strm, Z_BLOCK) is performed by deflateParams(), and it does + not have enough output space to complete, then the parameter change will not + take effect. In this case, deflateParams() can be called again with the + same parameters and more output space to try again. + + In order to assure a change in the parameters on the first try, the + deflate stream should be flushed using deflate() with Z_BLOCK or other flush + request until strm.avail_out is not zero, before calling deflateParams(). + Then no more input data should be provided before the deflateParams() call. + If this is done, the old level and strategy will be applied to the data + compressed before deflateParams(), and the new level and strategy will be + applied to the the data compressed after deflateParams(). + + deflateParams returns Z_OK on success, Z_STREAM_ERROR if the source stream + state was inconsistent or if a parameter was invalid, or Z_BUF_ERROR if + there was not enough output space to complete the compression of the + available input data before a change in the strategy or approach. Note that + in the case of a Z_BUF_ERROR, the parameters are not changed. A return + value of Z_BUF_ERROR is not fatal, in which case deflateParams() can be + retried with more output space. +*/ + +ZEXTERN int ZEXPORT deflateTune OF((z_streamp strm, + int good_length, + int max_lazy, + int nice_length, + int max_chain)); +/* + Fine tune deflate's internal compression parameters. This should only be + used by someone who understands the algorithm used by zlib's deflate for + searching for the best matching string, and even then only by the most + fanatic optimizer trying to squeeze out the last compressed bit for their + specific input data. Read the deflate.c source code for the meaning of the + max_lazy, good_length, nice_length, and max_chain parameters. + + deflateTune() can be called after deflateInit() or deflateInit2(), and + returns Z_OK on success, or Z_STREAM_ERROR for an invalid deflate stream. + */ + +ZEXTERN uLong ZEXPORT deflateBound OF((z_streamp strm, + uLong sourceLen)); +/* + deflateBound() returns an upper bound on the compressed size after + deflation of sourceLen bytes. It must be called after deflateInit() or + deflateInit2(), and after deflateSetHeader(), if used. This would be used + to allocate an output buffer for deflation in a single pass, and so would be + called before deflate(). If that first deflate() call is provided the + sourceLen input bytes, an output buffer allocated to the size returned by + deflateBound(), and the flush value Z_FINISH, then deflate() is guaranteed + to return Z_STREAM_END. Note that it is possible for the compressed size to + be larger than the value returned by deflateBound() if flush options other + than Z_FINISH or Z_NO_FLUSH are used. +*/ + +ZEXTERN int ZEXPORT deflatePending OF((z_streamp strm, + unsigned *pending, + int *bits)); +/* + deflatePending() returns the number of bytes and bits of output that have + been generated, but not yet provided in the available output. The bytes not + provided would be due to the available output space having being consumed. + The number of bits of output not provided are between 0 and 7, where they + await more bits to join them in order to fill out a full byte. If pending + or bits are Z_NULL, then those values are not set. + + deflatePending returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent. + */ + +ZEXTERN int ZEXPORT deflatePrime OF((z_streamp strm, + int bits, + int value)); +/* + deflatePrime() inserts bits in the deflate output stream. The intent + is that this function is used to start off the deflate output with the bits + leftover from a previous deflate stream when appending to it. As such, this + function can only be used for raw deflate, and must be used before the first + deflate() call after a deflateInit2() or deflateReset(). bits must be less + than or equal to 16, and that many of the least significant bits of value + will be inserted in the output. + + deflatePrime returns Z_OK if success, Z_BUF_ERROR if there was not enough + room in the internal buffer to insert the bits, or Z_STREAM_ERROR if the + source stream state was inconsistent. +*/ + +ZEXTERN int ZEXPORT deflateSetHeader OF((z_streamp strm, + gz_headerp head)); +/* + deflateSetHeader() provides gzip header information for when a gzip + stream is requested by deflateInit2(). deflateSetHeader() may be called + after deflateInit2() or deflateReset() and before the first call of + deflate(). The text, time, os, extra field, name, and comment information + in the provided gz_header structure are written to the gzip header (xflag is + ignored -- the extra flags are set according to the compression level). The + caller must assure that, if not Z_NULL, name and comment are terminated with + a zero byte, and that if extra is not Z_NULL, that extra_len bytes are + available there. If hcrc is true, a gzip header crc is included. Note that + the current versions of the command-line version of gzip (up through version + 1.3.x) do not support header crc's, and will report that it is a "multi-part + gzip file" and give up. + + If deflateSetHeader is not used, the default gzip header has text false, + the time set to zero, and os set to 255, with no extra, name, or comment + fields. The gzip header is returned to the default state by deflateReset(). + + deflateSetHeader returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent. +*/ + +/* +ZEXTERN int ZEXPORT inflateInit2 OF((z_streamp strm, + int windowBits)); + + This is another version of inflateInit with an extra parameter. The + fields next_in, avail_in, zalloc, zfree and opaque must be initialized + before by the caller. + + The windowBits parameter is the base two logarithm of the maximum window + size (the size of the history buffer). It should be in the range 8..15 for + this version of the library. The default value is 15 if inflateInit is used + instead. windowBits must be greater than or equal to the windowBits value + provided to deflateInit2() while compressing, or it must be equal to 15 if + deflateInit2() was not used. If a compressed stream with a larger window + size is given as input, inflate() will return with the error code + Z_DATA_ERROR instead of trying to allocate a larger window. + + windowBits can also be zero to request that inflate use the window size in + the zlib header of the compressed stream. + + windowBits can also be -8..-15 for raw inflate. In this case, -windowBits + determines the window size. inflate() will then process raw deflate data, + not looking for a zlib or gzip header, not generating a check value, and not + looking for any check values for comparison at the end of the stream. This + is for use with other formats that use the deflate compressed data format + such as zip. Those formats provide their own check values. If a custom + format is developed using the raw deflate format for compressed data, it is + recommended that a check value such as an Adler-32 or a CRC-32 be applied to + the uncompressed data as is done in the zlib, gzip, and zip formats. For + most applications, the zlib format should be used as is. Note that comments + above on the use in deflateInit2() applies to the magnitude of windowBits. + + windowBits can also be greater than 15 for optional gzip decoding. Add + 32 to windowBits to enable zlib and gzip decoding with automatic header + detection, or add 16 to decode only the gzip format (the zlib format will + return a Z_DATA_ERROR). If a gzip stream is being decoded, strm->adler is a + CRC-32 instead of an Adler-32. Unlike the gunzip utility and gzread() (see + below), inflate() will not automatically decode concatenated gzip streams. + inflate() will return Z_STREAM_END at the end of the gzip stream. The state + would need to be reset to continue decoding a subsequent gzip stream. + + inflateInit2 returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_VERSION_ERROR if the zlib library version is incompatible with the + version assumed by the caller, or Z_STREAM_ERROR if the parameters are + invalid, such as a null pointer to the structure. msg is set to null if + there is no error message. inflateInit2 does not perform any decompression + apart from possibly reading the zlib header if present: actual decompression + will be done by inflate(). (So next_in and avail_in may be modified, but + next_out and avail_out are unused and unchanged.) The current implementation + of inflateInit2() does not process any header information -- that is + deferred until inflate() is called. +*/ + +ZEXTERN int ZEXPORT inflateSetDictionary OF((z_streamp strm, + const Bytef *dictionary, + uInt dictLength)); +/* + Initializes the decompression dictionary from the given uncompressed byte + sequence. This function must be called immediately after a call of inflate, + if that call returned Z_NEED_DICT. The dictionary chosen by the compressor + can be determined from the Adler-32 value returned by that call of inflate. + The compressor and decompressor must use exactly the same dictionary (see + deflateSetDictionary). For raw inflate, this function can be called at any + time to set the dictionary. If the provided dictionary is smaller than the + window and there is already data in the window, then the provided dictionary + will amend what's there. The application must insure that the dictionary + that was used for compression is provided. + + inflateSetDictionary returns Z_OK if success, Z_STREAM_ERROR if a + parameter is invalid (e.g. dictionary being Z_NULL) or the stream state is + inconsistent, Z_DATA_ERROR if the given dictionary doesn't match the + expected one (incorrect Adler-32 value). inflateSetDictionary does not + perform any decompression: this will be done by subsequent calls of + inflate(). +*/ + +ZEXTERN int ZEXPORT inflateGetDictionary OF((z_streamp strm, + Bytef *dictionary, + uInt *dictLength)); +/* + Returns the sliding dictionary being maintained by inflate. dictLength is + set to the number of bytes in the dictionary, and that many bytes are copied + to dictionary. dictionary must have enough space, where 32768 bytes is + always enough. If inflateGetDictionary() is called with dictionary equal to + Z_NULL, then only the dictionary length is returned, and nothing is copied. + Similary, if dictLength is Z_NULL, then it is not set. + + inflateGetDictionary returns Z_OK on success, or Z_STREAM_ERROR if the + stream state is inconsistent. +*/ + +ZEXTERN int ZEXPORT inflateSync OF((z_streamp strm)); +/* + Skips invalid compressed data until a possible full flush point (see above + for the description of deflate with Z_FULL_FLUSH) can be found, or until all + available input is skipped. No output is provided. + + inflateSync searches for a 00 00 FF FF pattern in the compressed data. + All full flush points have this pattern, but not all occurrences of this + pattern are full flush points. + + inflateSync returns Z_OK if a possible full flush point has been found, + Z_BUF_ERROR if no more input was provided, Z_DATA_ERROR if no flush point + has been found, or Z_STREAM_ERROR if the stream structure was inconsistent. + In the success case, the application may save the current current value of + total_in which indicates where valid compressed data was found. In the + error case, the application may repeatedly call inflateSync, providing more + input each time, until success or end of the input data. +*/ + +ZEXTERN int ZEXPORT inflateCopy OF((z_streamp dest, + z_streamp source)); +/* + Sets the destination stream as a complete copy of the source stream. + + This function can be useful when randomly accessing a large stream. The + first pass through the stream can periodically record the inflate state, + allowing restarting inflate at those points when randomly accessing the + stream. + + inflateCopy returns Z_OK if success, Z_MEM_ERROR if there was not + enough memory, Z_STREAM_ERROR if the source stream state was inconsistent + (such as zalloc being Z_NULL). msg is left unchanged in both source and + destination. +*/ + +ZEXTERN int ZEXPORT inflateReset OF((z_streamp strm)); +/* + This function is equivalent to inflateEnd followed by inflateInit, + but does not free and reallocate the internal decompression state. The + stream will keep attributes that may have been set by inflateInit2. + + inflateReset returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent (such as zalloc or state being Z_NULL). +*/ + +ZEXTERN int ZEXPORT inflateReset2 OF((z_streamp strm, + int windowBits)); +/* + This function is the same as inflateReset, but it also permits changing + the wrap and window size requests. The windowBits parameter is interpreted + the same as it is for inflateInit2. If the window size is changed, then the + memory allocated for the window is freed, and the window will be reallocated + by inflate() if needed. + + inflateReset2 returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent (such as zalloc or state being Z_NULL), or if + the windowBits parameter is invalid. +*/ + +ZEXTERN int ZEXPORT inflatePrime OF((z_streamp strm, + int bits, + int value)); +/* + This function inserts bits in the inflate input stream. The intent is + that this function is used to start inflating at a bit position in the + middle of a byte. The provided bits will be used before any bytes are used + from next_in. This function should only be used with raw inflate, and + should be used before the first inflate() call after inflateInit2() or + inflateReset(). bits must be less than or equal to 16, and that many of the + least significant bits of value will be inserted in the input. + + If bits is negative, then the input stream bit buffer is emptied. Then + inflatePrime() can be called again to put bits in the buffer. This is used + to clear out bits leftover after feeding inflate a block description prior + to feeding inflate codes. + + inflatePrime returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent. +*/ + +ZEXTERN long ZEXPORT inflateMark OF((z_streamp strm)); +/* + This function returns two values, one in the lower 16 bits of the return + value, and the other in the remaining upper bits, obtained by shifting the + return value down 16 bits. If the upper value is -1 and the lower value is + zero, then inflate() is currently decoding information outside of a block. + If the upper value is -1 and the lower value is non-zero, then inflate is in + the middle of a stored block, with the lower value equaling the number of + bytes from the input remaining to copy. If the upper value is not -1, then + it is the number of bits back from the current bit position in the input of + the code (literal or length/distance pair) currently being processed. In + that case the lower value is the number of bytes already emitted for that + code. + + A code is being processed if inflate is waiting for more input to complete + decoding of the code, or if it has completed decoding but is waiting for + more output space to write the literal or match data. + + inflateMark() is used to mark locations in the input data for random + access, which may be at bit positions, and to note those cases where the + output of a code may span boundaries of random access blocks. The current + location in the input stream can be determined from avail_in and data_type + as noted in the description for the Z_BLOCK flush parameter for inflate. + + inflateMark returns the value noted above, or -65536 if the provided + source stream state was inconsistent. +*/ + +ZEXTERN int ZEXPORT inflateGetHeader OF((z_streamp strm, + gz_headerp head)); +/* + inflateGetHeader() requests that gzip header information be stored in the + provided gz_header structure. inflateGetHeader() may be called after + inflateInit2() or inflateReset(), and before the first call of inflate(). + As inflate() processes the gzip stream, head->done is zero until the header + is completed, at which time head->done is set to one. If a zlib stream is + being decoded, then head->done is set to -1 to indicate that there will be + no gzip header information forthcoming. Note that Z_BLOCK or Z_TREES can be + used to force inflate() to return immediately after header processing is + complete and before any actual data is decompressed. + + The text, time, xflags, and os fields are filled in with the gzip header + contents. hcrc is set to true if there is a header CRC. (The header CRC + was valid if done is set to one.) If extra is not Z_NULL, then extra_max + contains the maximum number of bytes to write to extra. Once done is true, + extra_len contains the actual extra field length, and extra contains the + extra field, or that field truncated if extra_max is less than extra_len. + If name is not Z_NULL, then up to name_max characters are written there, + terminated with a zero unless the length is greater than name_max. If + comment is not Z_NULL, then up to comm_max characters are written there, + terminated with a zero unless the length is greater than comm_max. When any + of extra, name, or comment are not Z_NULL and the respective field is not + present in the header, then that field is set to Z_NULL to signal its + absence. This allows the use of deflateSetHeader() with the returned + structure to duplicate the header. However if those fields are set to + allocated memory, then the application will need to save those pointers + elsewhere so that they can be eventually freed. + + If inflateGetHeader is not used, then the header information is simply + discarded. The header is always checked for validity, including the header + CRC if present. inflateReset() will reset the process to discard the header + information. The application would need to call inflateGetHeader() again to + retrieve the header from the next gzip stream. + + inflateGetHeader returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent. +*/ + +/* +ZEXTERN int ZEXPORT inflateBackInit OF((z_streamp strm, int windowBits, + unsigned char FAR *window)); + + Initialize the internal stream state for decompression using inflateBack() + calls. The fields zalloc, zfree and opaque in strm must be initialized + before the call. If zalloc and zfree are Z_NULL, then the default library- + derived memory allocation routines are used. windowBits is the base two + logarithm of the window size, in the range 8..15. window is a caller + supplied buffer of that size. Except for special applications where it is + assured that deflate was used with small window sizes, windowBits must be 15 + and a 32K byte window must be supplied to be able to decompress general + deflate streams. + + See inflateBack() for the usage of these routines. + + inflateBackInit will return Z_OK on success, Z_STREAM_ERROR if any of + the parameters are invalid, Z_MEM_ERROR if the internal state could not be + allocated, or Z_VERSION_ERROR if the version of the library does not match + the version of the header file. +*/ + +typedef unsigned (*in_func) OF((void FAR *, + z_const unsigned char FAR * FAR *)); +typedef int (*out_func) OF((void FAR *, unsigned char FAR *, unsigned)); + +ZEXTERN int ZEXPORT inflateBack OF((z_streamp strm, + in_func in, void FAR *in_desc, + out_func out, void FAR *out_desc)); +/* + inflateBack() does a raw inflate with a single call using a call-back + interface for input and output. This is potentially more efficient than + inflate() for file i/o applications, in that it avoids copying between the + output and the sliding window by simply making the window itself the output + buffer. inflate() can be faster on modern CPUs when used with large + buffers. inflateBack() trusts the application to not change the output + buffer passed by the output function, at least until inflateBack() returns. + + inflateBackInit() must be called first to allocate the internal state + and to initialize the state with the user-provided window buffer. + inflateBack() may then be used multiple times to inflate a complete, raw + deflate stream with each call. inflateBackEnd() is then called to free the + allocated state. + + A raw deflate stream is one with no zlib or gzip header or trailer. + This routine would normally be used in a utility that reads zip or gzip + files and writes out uncompressed files. The utility would decode the + header and process the trailer on its own, hence this routine expects only + the raw deflate stream to decompress. This is different from the default + behavior of inflate(), which expects a zlib header and trailer around the + deflate stream. + + inflateBack() uses two subroutines supplied by the caller that are then + called by inflateBack() for input and output. inflateBack() calls those + routines until it reads a complete deflate stream and writes out all of the + uncompressed data, or until it encounters an error. The function's + parameters and return types are defined above in the in_func and out_func + typedefs. inflateBack() will call in(in_desc, &buf) which should return the + number of bytes of provided input, and a pointer to that input in buf. If + there is no input available, in() must return zero -- buf is ignored in that + case -- and inflateBack() will return a buffer error. inflateBack() will + call out(out_desc, buf, len) to write the uncompressed data buf[0..len-1]. + out() should return zero on success, or non-zero on failure. If out() + returns non-zero, inflateBack() will return with an error. Neither in() nor + out() are permitted to change the contents of the window provided to + inflateBackInit(), which is also the buffer that out() uses to write from. + The length written by out() will be at most the window size. Any non-zero + amount of input may be provided by in(). + + For convenience, inflateBack() can be provided input on the first call by + setting strm->next_in and strm->avail_in. If that input is exhausted, then + in() will be called. Therefore strm->next_in must be initialized before + calling inflateBack(). If strm->next_in is Z_NULL, then in() will be called + immediately for input. If strm->next_in is not Z_NULL, then strm->avail_in + must also be initialized, and then if strm->avail_in is not zero, input will + initially be taken from strm->next_in[0 .. strm->avail_in - 1]. + + The in_desc and out_desc parameters of inflateBack() is passed as the + first parameter of in() and out() respectively when they are called. These + descriptors can be optionally used to pass any information that the caller- + supplied in() and out() functions need to do their job. + + On return, inflateBack() will set strm->next_in and strm->avail_in to + pass back any unused input that was provided by the last in() call. The + return values of inflateBack() can be Z_STREAM_END on success, Z_BUF_ERROR + if in() or out() returned an error, Z_DATA_ERROR if there was a format error + in the deflate stream (in which case strm->msg is set to indicate the nature + of the error), or Z_STREAM_ERROR if the stream was not properly initialized. + In the case of Z_BUF_ERROR, an input or output error can be distinguished + using strm->next_in which will be Z_NULL only if in() returned an error. If + strm->next_in is not Z_NULL, then the Z_BUF_ERROR was due to out() returning + non-zero. (in() will always be called before out(), so strm->next_in is + assured to be defined if out() returns non-zero.) Note that inflateBack() + cannot return Z_OK. +*/ + +ZEXTERN int ZEXPORT inflateBackEnd OF((z_streamp strm)); +/* + All memory allocated by inflateBackInit() is freed. + + inflateBackEnd() returns Z_OK on success, or Z_STREAM_ERROR if the stream + state was inconsistent. +*/ + +ZEXTERN uLong ZEXPORT zlibCompileFlags OF((void)); +/* Return flags indicating compile-time options. + + Type sizes, two bits each, 00 = 16 bits, 01 = 32, 10 = 64, 11 = other: + 1.0: size of uInt + 3.2: size of uLong + 5.4: size of voidpf (pointer) + 7.6: size of z_off_t + + Compiler, assembler, and debug options: + 8: ZLIB_DEBUG + 9: ASMV or ASMINF -- use ASM code + 10: ZLIB_WINAPI -- exported functions use the WINAPI calling convention + 11: 0 (reserved) + + One-time table building (smaller code, but not thread-safe if true): + 12: BUILDFIXED -- build static block decoding tables when needed + 13: DYNAMIC_CRC_TABLE -- build CRC calculation tables when needed + 14,15: 0 (reserved) + + Library content (indicates missing functionality): + 16: NO_GZCOMPRESS -- gz* functions cannot compress (to avoid linking + deflate code when not needed) + 17: NO_GZIP -- deflate can't write gzip streams, and inflate can't detect + and decode gzip streams (to avoid linking crc code) + 18-19: 0 (reserved) + + Operation variations (changes in library functionality): + 20: PKZIP_BUG_WORKAROUND -- slightly more permissive inflate + 21: FASTEST -- deflate algorithm with only one, lowest compression level + 22,23: 0 (reserved) + + The sprintf variant used by gzprintf (zero is best): + 24: 0 = vs*, 1 = s* -- 1 means limited to 20 arguments after the format + 25: 0 = *nprintf, 1 = *printf -- 1 means gzprintf() not secure! + 26: 0 = returns value, 1 = void -- 1 means inferred string length returned + + Remainder: + 27-31: 0 (reserved) + */ + +#ifndef Z_SOLO + + /* utility functions */ + +/* + The following utility functions are implemented on top of the basic + stream-oriented functions. To simplify the interface, some default options + are assumed (compression level and memory usage, standard memory allocation + functions). The source code of these utility functions can be modified if + you need special options. +*/ + +ZEXTERN int ZEXPORT compress OF((Bytef *dest, uLongf *destLen, + const Bytef *source, uLong sourceLen)); +/* + Compresses the source buffer into the destination buffer. sourceLen is + the byte length of the source buffer. Upon entry, destLen is the total size + of the destination buffer, which must be at least the value returned by + compressBound(sourceLen). Upon exit, destLen is the actual size of the + compressed data. compress() is equivalent to compress2() with a level + parameter of Z_DEFAULT_COMPRESSION. + + compress returns Z_OK if success, Z_MEM_ERROR if there was not + enough memory, Z_BUF_ERROR if there was not enough room in the output + buffer. +*/ + +ZEXTERN int ZEXPORT compress2 OF((Bytef *dest, uLongf *destLen, + const Bytef *source, uLong sourceLen, + int level)); +/* + Compresses the source buffer into the destination buffer. The level + parameter has the same meaning as in deflateInit. sourceLen is the byte + length of the source buffer. Upon entry, destLen is the total size of the + destination buffer, which must be at least the value returned by + compressBound(sourceLen). Upon exit, destLen is the actual size of the + compressed data. + + compress2 returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_BUF_ERROR if there was not enough room in the output buffer, + Z_STREAM_ERROR if the level parameter is invalid. +*/ + +ZEXTERN uLong ZEXPORT compressBound OF((uLong sourceLen)); +/* + compressBound() returns an upper bound on the compressed size after + compress() or compress2() on sourceLen bytes. It would be used before a + compress() or compress2() call to allocate the destination buffer. +*/ + +ZEXTERN int ZEXPORT uncompress OF((Bytef *dest, uLongf *destLen, + const Bytef *source, uLong sourceLen)); +/* + Decompresses the source buffer into the destination buffer. sourceLen is + the byte length of the source buffer. Upon entry, destLen is the total size + of the destination buffer, which must be large enough to hold the entire + uncompressed data. (The size of the uncompressed data must have been saved + previously by the compressor and transmitted to the decompressor by some + mechanism outside the scope of this compression library.) Upon exit, destLen + is the actual size of the uncompressed data. + + uncompress returns Z_OK if success, Z_MEM_ERROR if there was not + enough memory, Z_BUF_ERROR if there was not enough room in the output + buffer, or Z_DATA_ERROR if the input data was corrupted or incomplete. In + the case where there is not enough room, uncompress() will fill the output + buffer with the uncompressed data up to that point. +*/ + +ZEXTERN int ZEXPORT uncompress2 OF((Bytef *dest, uLongf *destLen, + const Bytef *source, uLong *sourceLen)); +/* + Same as uncompress, except that sourceLen is a pointer, where the + length of the source is *sourceLen. On return, *sourceLen is the number of + source bytes consumed. +*/ + + /* gzip file access functions */ + +/* + This library supports reading and writing files in gzip (.gz) format with + an interface similar to that of stdio, using the functions that start with + "gz". The gzip format is different from the zlib format. gzip is a gzip + wrapper, documented in RFC 1952, wrapped around a deflate stream. +*/ + +typedef struct gzFile_s *gzFile; /* semi-opaque gzip file descriptor */ + +/* +ZEXTERN gzFile ZEXPORT gzopen OF((const char *path, const char *mode)); + + Opens a gzip (.gz) file for reading or writing. The mode parameter is as + in fopen ("rb" or "wb") but can also include a compression level ("wb9") or + a strategy: 'f' for filtered data as in "wb6f", 'h' for Huffman-only + compression as in "wb1h", 'R' for run-length encoding as in "wb1R", or 'F' + for fixed code compression as in "wb9F". (See the description of + deflateInit2 for more information about the strategy parameter.) 'T' will + request transparent writing or appending with no compression and not using + the gzip format. + + "a" can be used instead of "w" to request that the gzip stream that will + be written be appended to the file. "+" will result in an error, since + reading and writing to the same gzip file is not supported. The addition of + "x" when writing will create the file exclusively, which fails if the file + already exists. On systems that support it, the addition of "e" when + reading or writing will set the flag to close the file on an execve() call. + + These functions, as well as gzip, will read and decode a sequence of gzip + streams in a file. The append function of gzopen() can be used to create + such a file. (Also see gzflush() for another way to do this.) When + appending, gzopen does not test whether the file begins with a gzip stream, + nor does it look for the end of the gzip streams to begin appending. gzopen + will simply append a gzip stream to the existing file. + + gzopen can be used to read a file which is not in gzip format; in this + case gzread will directly read from the file without decompression. When + reading, this will be detected automatically by looking for the magic two- + byte gzip header. + + gzopen returns NULL if the file could not be opened, if there was + insufficient memory to allocate the gzFile state, or if an invalid mode was + specified (an 'r', 'w', or 'a' was not provided, or '+' was provided). + errno can be checked to determine if the reason gzopen failed was that the + file could not be opened. +*/ + +ZEXTERN gzFile ZEXPORT gzdopen OF((int fd, const char *mode)); +/* + gzdopen associates a gzFile with the file descriptor fd. File descriptors + are obtained from calls like open, dup, creat, pipe or fileno (if the file + has been previously opened with fopen). The mode parameter is as in gzopen. + + The next call of gzclose on the returned gzFile will also close the file + descriptor fd, just like fclose(fdopen(fd, mode)) closes the file descriptor + fd. If you want to keep fd open, use fd = dup(fd_keep); gz = gzdopen(fd, + mode);. The duplicated descriptor should be saved to avoid a leak, since + gzdopen does not close fd if it fails. If you are using fileno() to get the + file descriptor from a FILE *, then you will have to use dup() to avoid + double-close()ing the file descriptor. Both gzclose() and fclose() will + close the associated file descriptor, so they need to have different file + descriptors. + + gzdopen returns NULL if there was insufficient memory to allocate the + gzFile state, if an invalid mode was specified (an 'r', 'w', or 'a' was not + provided, or '+' was provided), or if fd is -1. The file descriptor is not + used until the next gz* read, write, seek, or close operation, so gzdopen + will not detect if fd is invalid (unless fd is -1). +*/ + +ZEXTERN int ZEXPORT gzbuffer OF((gzFile file, unsigned size)); +/* + Set the internal buffer size used by this library's functions. The + default buffer size is 8192 bytes. This function must be called after + gzopen() or gzdopen(), and before any other calls that read or write the + file. The buffer memory allocation is always deferred to the first read or + write. Three times that size in buffer space is allocated. A larger buffer + size of, for example, 64K or 128K bytes will noticeably increase the speed + of decompression (reading). + + The new buffer size also affects the maximum length for gzprintf(). + + gzbuffer() returns 0 on success, or -1 on failure, such as being called + too late. +*/ + +ZEXTERN int ZEXPORT gzsetparams OF((gzFile file, int level, int strategy)); +/* + Dynamically update the compression level or strategy. See the description + of deflateInit2 for the meaning of these parameters. Previously provided + data is flushed before the parameter change. + + gzsetparams returns Z_OK if success, Z_STREAM_ERROR if the file was not + opened for writing, Z_ERRNO if there is an error writing the flushed data, + or Z_MEM_ERROR if there is a memory allocation error. +*/ + +ZEXTERN int ZEXPORT gzread OF((gzFile file, voidp buf, unsigned len)); +/* + Reads the given number of uncompressed bytes from the compressed file. If + the input file is not in gzip format, gzread copies the given number of + bytes into the buffer directly from the file. + + After reaching the end of a gzip stream in the input, gzread will continue + to read, looking for another gzip stream. Any number of gzip streams may be + concatenated in the input file, and will all be decompressed by gzread(). + If something other than a gzip stream is encountered after a gzip stream, + that remaining trailing garbage is ignored (and no error is returned). + + gzread can be used to read a gzip file that is being concurrently written. + Upon reaching the end of the input, gzread will return with the available + data. If the error code returned by gzerror is Z_OK or Z_BUF_ERROR, then + gzclearerr can be used to clear the end of file indicator in order to permit + gzread to be tried again. Z_OK indicates that a gzip stream was completed + on the last gzread. Z_BUF_ERROR indicates that the input file ended in the + middle of a gzip stream. Note that gzread does not return -1 in the event + of an incomplete gzip stream. This error is deferred until gzclose(), which + will return Z_BUF_ERROR if the last gzread ended in the middle of a gzip + stream. Alternatively, gzerror can be used before gzclose to detect this + case. + + gzread returns the number of uncompressed bytes actually read, less than + len for end of file, or -1 for error. If len is too large to fit in an int, + then nothing is read, -1 is returned, and the error state is set to + Z_STREAM_ERROR. +*/ + +ZEXTERN z_size_t ZEXPORT gzfread OF((voidp buf, z_size_t size, z_size_t nitems, + gzFile file)); +/* + Read up to nitems items of size size from file to buf, otherwise operating + as gzread() does. This duplicates the interface of stdio's fread(), with + size_t request and return types. If the library defines size_t, then + z_size_t is identical to size_t. If not, then z_size_t is an unsigned + integer type that can contain a pointer. + + gzfread() returns the number of full items read of size size, or zero if + the end of the file was reached and a full item could not be read, or if + there was an error. gzerror() must be consulted if zero is returned in + order to determine if there was an error. If the multiplication of size and + nitems overflows, i.e. the product does not fit in a z_size_t, then nothing + is read, zero is returned, and the error state is set to Z_STREAM_ERROR. + + In the event that the end of file is reached and only a partial item is + available at the end, i.e. the remaining uncompressed data length is not a + multiple of size, then the final partial item is nevetheless read into buf + and the end-of-file flag is set. The length of the partial item read is not + provided, but could be inferred from the result of gztell(). This behavior + is the same as the behavior of fread() implementations in common libraries, + but it prevents the direct use of gzfread() to read a concurrently written + file, reseting and retrying on end-of-file, when size is not 1. +*/ + +ZEXTERN int ZEXPORT gzwrite OF((gzFile file, + voidpc buf, unsigned len)); +/* + Writes the given number of uncompressed bytes into the compressed file. + gzwrite returns the number of uncompressed bytes written or 0 in case of + error. +*/ + +ZEXTERN z_size_t ZEXPORT gzfwrite OF((voidpc buf, z_size_t size, + z_size_t nitems, gzFile file)); +/* + gzfwrite() writes nitems items of size size from buf to file, duplicating + the interface of stdio's fwrite(), with size_t request and return types. If + the library defines size_t, then z_size_t is identical to size_t. If not, + then z_size_t is an unsigned integer type that can contain a pointer. + + gzfwrite() returns the number of full items written of size size, or zero + if there was an error. If the multiplication of size and nitems overflows, + i.e. the product does not fit in a z_size_t, then nothing is written, zero + is returned, and the error state is set to Z_STREAM_ERROR. +*/ + +ZEXTERN int ZEXPORTVA gzprintf Z_ARG((gzFile file, const char *format, ...)); +/* + Converts, formats, and writes the arguments to the compressed file under + control of the format string, as in fprintf. gzprintf returns the number of + uncompressed bytes actually written, or a negative zlib error code in case + of error. The number of uncompressed bytes written is limited to 8191, or + one less than the buffer size given to gzbuffer(). The caller should assure + that this limit is not exceeded. If it is exceeded, then gzprintf() will + return an error (0) with nothing written. In this case, there may also be a + buffer overflow with unpredictable consequences, which is possible only if + zlib was compiled with the insecure functions sprintf() or vsprintf() + because the secure snprintf() or vsnprintf() functions were not available. + This can be determined using zlibCompileFlags(). +*/ + +ZEXTERN int ZEXPORT gzputs OF((gzFile file, const char *s)); +/* + Writes the given null-terminated string to the compressed file, excluding + the terminating null character. + + gzputs returns the number of characters written, or -1 in case of error. +*/ + +ZEXTERN char * ZEXPORT gzgets OF((gzFile file, char *buf, int len)); +/* + Reads bytes from the compressed file until len-1 characters are read, or a + newline character is read and transferred to buf, or an end-of-file + condition is encountered. If any characters are read or if len == 1, the + string is terminated with a null character. If no characters are read due + to an end-of-file or len < 1, then the buffer is left untouched. + + gzgets returns buf which is a null-terminated string, or it returns NULL + for end-of-file or in case of error. If there was an error, the contents at + buf are indeterminate. +*/ + +ZEXTERN int ZEXPORT gzputc OF((gzFile file, int c)); +/* + Writes c, converted to an unsigned char, into the compressed file. gzputc + returns the value that was written, or -1 in case of error. +*/ + +ZEXTERN int ZEXPORT gzgetc OF((gzFile file)); +/* + Reads one byte from the compressed file. gzgetc returns this byte or -1 + in case of end of file or error. This is implemented as a macro for speed. + As such, it does not do all of the checking the other functions do. I.e. + it does not check to see if file is NULL, nor whether the structure file + points to has been clobbered or not. +*/ + +ZEXTERN int ZEXPORT gzungetc OF((int c, gzFile file)); +/* + Push one character back onto the stream to be read as the first character + on the next read. At least one character of push-back is allowed. + gzungetc() returns the character pushed, or -1 on failure. gzungetc() will + fail if c is -1, and may fail if a character has been pushed but not read + yet. If gzungetc is used immediately after gzopen or gzdopen, at least the + output buffer size of pushed characters is allowed. (See gzbuffer above.) + The pushed character will be discarded if the stream is repositioned with + gzseek() or gzrewind(). +*/ + +ZEXTERN int ZEXPORT gzflush OF((gzFile file, int flush)); +/* + Flushes all pending output into the compressed file. The parameter flush + is as in the deflate() function. The return value is the zlib error number + (see function gzerror below). gzflush is only permitted when writing. + + If the flush parameter is Z_FINISH, the remaining data is written and the + gzip stream is completed in the output. If gzwrite() is called again, a new + gzip stream will be started in the output. gzread() is able to read such + concatenated gzip streams. + + gzflush should be called only when strictly necessary because it will + degrade compression if called too often. +*/ + +/* +ZEXTERN z_off_t ZEXPORT gzseek OF((gzFile file, + z_off_t offset, int whence)); + + Sets the starting position for the next gzread or gzwrite on the given + compressed file. The offset represents a number of bytes in the + uncompressed data stream. The whence parameter is defined as in lseek(2); + the value SEEK_END is not supported. + + If the file is opened for reading, this function is emulated but can be + extremely slow. If the file is opened for writing, only forward seeks are + supported; gzseek then compresses a sequence of zeroes up to the new + starting position. + + gzseek returns the resulting offset location as measured in bytes from + the beginning of the uncompressed stream, or -1 in case of error, in + particular if the file is opened for writing and the new starting position + would be before the current position. +*/ + +ZEXTERN int ZEXPORT gzrewind OF((gzFile file)); +/* + Rewinds the given file. This function is supported only for reading. + + gzrewind(file) is equivalent to (int)gzseek(file, 0L, SEEK_SET) +*/ + +/* +ZEXTERN z_off_t ZEXPORT gztell OF((gzFile file)); + + Returns the starting position for the next gzread or gzwrite on the given + compressed file. This position represents a number of bytes in the + uncompressed data stream, and is zero when starting, even if appending or + reading a gzip stream from the middle of a file using gzdopen(). + + gztell(file) is equivalent to gzseek(file, 0L, SEEK_CUR) +*/ + +/* +ZEXTERN z_off_t ZEXPORT gzoffset OF((gzFile file)); + + Returns the current offset in the file being read or written. This offset + includes the count of bytes that precede the gzip stream, for example when + appending or when using gzdopen() for reading. When reading, the offset + does not include as yet unused buffered input. This information can be used + for a progress indicator. On error, gzoffset() returns -1. +*/ + +ZEXTERN int ZEXPORT gzeof OF((gzFile file)); +/* + Returns true (1) if the end-of-file indicator has been set while reading, + false (0) otherwise. Note that the end-of-file indicator is set only if the + read tried to go past the end of the input, but came up short. Therefore, + just like feof(), gzeof() may return false even if there is no more data to + read, in the event that the last read request was for the exact number of + bytes remaining in the input file. This will happen if the input file size + is an exact multiple of the buffer size. + + If gzeof() returns true, then the read functions will return no more data, + unless the end-of-file indicator is reset by gzclearerr() and the input file + has grown since the previous end of file was detected. +*/ + +ZEXTERN int ZEXPORT gzdirect OF((gzFile file)); +/* + Returns true (1) if file is being copied directly while reading, or false + (0) if file is a gzip stream being decompressed. + + If the input file is empty, gzdirect() will return true, since the input + does not contain a gzip stream. + + If gzdirect() is used immediately after gzopen() or gzdopen() it will + cause buffers to be allocated to allow reading the file to determine if it + is a gzip file. Therefore if gzbuffer() is used, it should be called before + gzdirect(). + + When writing, gzdirect() returns true (1) if transparent writing was + requested ("wT" for the gzopen() mode), or false (0) otherwise. (Note: + gzdirect() is not needed when writing. Transparent writing must be + explicitly requested, so the application already knows the answer. When + linking statically, using gzdirect() will include all of the zlib code for + gzip file reading and decompression, which may not be desired.) +*/ + +ZEXTERN int ZEXPORT gzclose OF((gzFile file)); +/* + Flushes all pending output if necessary, closes the compressed file and + deallocates the (de)compression state. Note that once file is closed, you + cannot call gzerror with file, since its structures have been deallocated. + gzclose must not be called more than once on the same file, just as free + must not be called more than once on the same allocation. + + gzclose will return Z_STREAM_ERROR if file is not valid, Z_ERRNO on a + file operation error, Z_MEM_ERROR if out of memory, Z_BUF_ERROR if the + last read ended in the middle of a gzip stream, or Z_OK on success. +*/ + +ZEXTERN int ZEXPORT gzclose_r OF((gzFile file)); +ZEXTERN int ZEXPORT gzclose_w OF((gzFile file)); +/* + Same as gzclose(), but gzclose_r() is only for use when reading, and + gzclose_w() is only for use when writing or appending. The advantage to + using these instead of gzclose() is that they avoid linking in zlib + compression or decompression code that is not used when only reading or only + writing respectively. If gzclose() is used, then both compression and + decompression code will be included the application when linking to a static + zlib library. +*/ + +ZEXTERN const char * ZEXPORT gzerror OF((gzFile file, int *errnum)); +/* + Returns the error message for the last error which occurred on the given + compressed file. errnum is set to zlib error number. If an error occurred + in the file system and not in the compression library, errnum is set to + Z_ERRNO and the application may consult errno to get the exact error code. + + The application must not modify the returned string. Future calls to + this function may invalidate the previously returned string. If file is + closed, then the string previously returned by gzerror will no longer be + available. + + gzerror() should be used to distinguish errors from end-of-file for those + functions above that do not distinguish those cases in their return values. +*/ + +ZEXTERN void ZEXPORT gzclearerr OF((gzFile file)); +/* + Clears the error and end-of-file flags for file. This is analogous to the + clearerr() function in stdio. This is useful for continuing to read a gzip + file that is being written concurrently. +*/ + +#endif /* !Z_SOLO */ + + /* checksum functions */ + +/* + These functions are not related to compression but are exported + anyway because they might be useful in applications using the compression + library. +*/ + +ZEXTERN uLong ZEXPORT adler32 OF((uLong adler, const Bytef *buf, uInt len)); +/* + Update a running Adler-32 checksum with the bytes buf[0..len-1] and + return the updated checksum. If buf is Z_NULL, this function returns the + required initial value for the checksum. + + An Adler-32 checksum is almost as reliable as a CRC-32 but can be computed + much faster. + + Usage example: + + uLong adler = adler32(0L, Z_NULL, 0); + + while (read_buffer(buffer, length) != EOF) { + adler = adler32(adler, buffer, length); + } + if (adler != original_adler) error(); +*/ + +ZEXTERN uLong ZEXPORT adler32_z OF((uLong adler, const Bytef *buf, + z_size_t len)); +/* + Same as adler32(), but with a size_t length. +*/ + +/* +ZEXTERN uLong ZEXPORT adler32_combine OF((uLong adler1, uLong adler2, + z_off_t len2)); + + Combine two Adler-32 checksums into one. For two sequences of bytes, seq1 + and seq2 with lengths len1 and len2, Adler-32 checksums were calculated for + each, adler1 and adler2. adler32_combine() returns the Adler-32 checksum of + seq1 and seq2 concatenated, requiring only adler1, adler2, and len2. Note + that the z_off_t type (like off_t) is a signed integer. If len2 is + negative, the result has no meaning or utility. +*/ + +ZEXTERN uLong ZEXPORT crc32 OF((uLong crc, const Bytef *buf, uInt len)); +/* + Update a running CRC-32 with the bytes buf[0..len-1] and return the + updated CRC-32. If buf is Z_NULL, this function returns the required + initial value for the crc. Pre- and post-conditioning (one's complement) is + performed within this function so it shouldn't be done by the application. + + Usage example: + + uLong crc = crc32(0L, Z_NULL, 0); + + while (read_buffer(buffer, length) != EOF) { + crc = crc32(crc, buffer, length); + } + if (crc != original_crc) error(); +*/ + +ZEXTERN uLong ZEXPORT crc32_z OF((uLong adler, const Bytef *buf, + z_size_t len)); +/* + Same as crc32(), but with a size_t length. +*/ + +/* +ZEXTERN uLong ZEXPORT crc32_combine OF((uLong crc1, uLong crc2, z_off_t len2)); + + Combine two CRC-32 check values into one. For two sequences of bytes, + seq1 and seq2 with lengths len1 and len2, CRC-32 check values were + calculated for each, crc1 and crc2. crc32_combine() returns the CRC-32 + check value of seq1 and seq2 concatenated, requiring only crc1, crc2, and + len2. +*/ + + + /* various hacks, don't look :) */ + +/* deflateInit and inflateInit are macros to allow checking the zlib version + * and the compiler's view of z_stream: + */ +ZEXTERN int ZEXPORT deflateInit_ OF((z_streamp strm, int level, + const char *version, int stream_size)); +ZEXTERN int ZEXPORT inflateInit_ OF((z_streamp strm, + const char *version, int stream_size)); +ZEXTERN int ZEXPORT deflateInit2_ OF((z_streamp strm, int level, int method, + int windowBits, int memLevel, + int strategy, const char *version, + int stream_size)); +ZEXTERN int ZEXPORT inflateInit2_ OF((z_streamp strm, int windowBits, + const char *version, int stream_size)); +ZEXTERN int ZEXPORT inflateBackInit_ OF((z_streamp strm, int windowBits, + unsigned char FAR *window, + const char *version, + int stream_size)); +#ifdef Z_PREFIX_SET +# define z_deflateInit(strm, level) \ + deflateInit_((strm), (level), ZLIB_VERSION, (int)sizeof(z_stream)) +# define z_inflateInit(strm) \ + inflateInit_((strm), ZLIB_VERSION, (int)sizeof(z_stream)) +# define z_deflateInit2(strm, level, method, windowBits, memLevel, strategy) \ + deflateInit2_((strm),(level),(method),(windowBits),(memLevel),\ + (strategy), ZLIB_VERSION, (int)sizeof(z_stream)) +# define z_inflateInit2(strm, windowBits) \ + inflateInit2_((strm), (windowBits), ZLIB_VERSION, \ + (int)sizeof(z_stream)) +# define z_inflateBackInit(strm, windowBits, window) \ + inflateBackInit_((strm), (windowBits), (window), \ + ZLIB_VERSION, (int)sizeof(z_stream)) +#else +# define deflateInit(strm, level) \ + deflateInit_((strm), (level), ZLIB_VERSION, (int)sizeof(z_stream)) +# define inflateInit(strm) \ + inflateInit_((strm), ZLIB_VERSION, (int)sizeof(z_stream)) +# define deflateInit2(strm, level, method, windowBits, memLevel, strategy) \ + deflateInit2_((strm),(level),(method),(windowBits),(memLevel),\ + (strategy), ZLIB_VERSION, (int)sizeof(z_stream)) +# define inflateInit2(strm, windowBits) \ + inflateInit2_((strm), (windowBits), ZLIB_VERSION, \ + (int)sizeof(z_stream)) +# define inflateBackInit(strm, windowBits, window) \ + inflateBackInit_((strm), (windowBits), (window), \ + ZLIB_VERSION, (int)sizeof(z_stream)) +#endif + +#ifndef Z_SOLO + +/* gzgetc() macro and its supporting function and exposed data structure. Note + * that the real internal state is much larger than the exposed structure. + * This abbreviated structure exposes just enough for the gzgetc() macro. The + * user should not mess with these exposed elements, since their names or + * behavior could change in the future, perhaps even capriciously. They can + * only be used by the gzgetc() macro. You have been warned. + */ +struct gzFile_s { + unsigned have; + unsigned char *next; + z_off64_t pos; +}; +ZEXTERN int ZEXPORT gzgetc_ OF((gzFile file)); /* backward compatibility */ +#ifdef Z_PREFIX_SET +# undef z_gzgetc +# define z_gzgetc(g) \ + ((g)->have ? ((g)->have--, (g)->pos++, *((g)->next)++) : (gzgetc)(g)) +#else +# define gzgetc(g) \ + ((g)->have ? ((g)->have--, (g)->pos++, *((g)->next)++) : (gzgetc)(g)) +#endif + +/* provide 64-bit offset functions if _LARGEFILE64_SOURCE defined, and/or + * change the regular functions to 64 bits if _FILE_OFFSET_BITS is 64 (if + * both are true, the application gets the *64 functions, and the regular + * functions are changed to 64 bits) -- in case these are set on systems + * without large file support, _LFS64_LARGEFILE must also be true + */ +#ifdef Z_LARGE64 + ZEXTERN gzFile ZEXPORT gzopen64 OF((const char *, const char *)); + ZEXTERN z_off64_t ZEXPORT gzseek64 OF((gzFile, z_off64_t, int)); + ZEXTERN z_off64_t ZEXPORT gztell64 OF((gzFile)); + ZEXTERN z_off64_t ZEXPORT gzoffset64 OF((gzFile)); + ZEXTERN uLong ZEXPORT adler32_combine64 OF((uLong, uLong, z_off64_t)); + ZEXTERN uLong ZEXPORT crc32_combine64 OF((uLong, uLong, z_off64_t)); +#endif + +#if !defined(ZLIB_INTERNAL) && defined(Z_WANT64) +# ifdef Z_PREFIX_SET +# define z_gzopen z_gzopen64 +# define z_gzseek z_gzseek64 +# define z_gztell z_gztell64 +# define z_gzoffset z_gzoffset64 +# define z_adler32_combine z_adler32_combine64 +# define z_crc32_combine z_crc32_combine64 +# else +# define gzopen gzopen64 +# define gzseek gzseek64 +# define gztell gztell64 +# define gzoffset gzoffset64 +# define adler32_combine adler32_combine64 +# define crc32_combine crc32_combine64 +# endif +# ifndef Z_LARGE64 + ZEXTERN gzFile ZEXPORT gzopen64 OF((const char *, const char *)); + ZEXTERN z_off_t ZEXPORT gzseek64 OF((gzFile, z_off_t, int)); + ZEXTERN z_off_t ZEXPORT gztell64 OF((gzFile)); + ZEXTERN z_off_t ZEXPORT gzoffset64 OF((gzFile)); + ZEXTERN uLong ZEXPORT adler32_combine64 OF((uLong, uLong, z_off_t)); + ZEXTERN uLong ZEXPORT crc32_combine64 OF((uLong, uLong, z_off_t)); +# endif +#else + ZEXTERN gzFile ZEXPORT gzopen OF((const char *, const char *)); + ZEXTERN z_off_t ZEXPORT gzseek OF((gzFile, z_off_t, int)); + ZEXTERN z_off_t ZEXPORT gztell OF((gzFile)); + ZEXTERN z_off_t ZEXPORT gzoffset OF((gzFile)); + ZEXTERN uLong ZEXPORT adler32_combine OF((uLong, uLong, z_off_t)); + ZEXTERN uLong ZEXPORT crc32_combine OF((uLong, uLong, z_off_t)); +#endif + +#else /* Z_SOLO */ + + ZEXTERN uLong ZEXPORT adler32_combine OF((uLong, uLong, z_off_t)); + ZEXTERN uLong ZEXPORT crc32_combine OF((uLong, uLong, z_off_t)); + +#endif /* !Z_SOLO */ + +/* undocumented functions */ +ZEXTERN const char * ZEXPORT zError OF((int)); +ZEXTERN int ZEXPORT inflateSyncPoint OF((z_streamp)); +ZEXTERN const z_crc_t FAR * ZEXPORT get_crc_table OF((void)); +ZEXTERN int ZEXPORT inflateUndermine OF((z_streamp, int)); +ZEXTERN int ZEXPORT inflateValidate OF((z_streamp, int)); +ZEXTERN unsigned long ZEXPORT inflateCodesUsed OF ((z_streamp)); +ZEXTERN int ZEXPORT inflateResetKeep OF((z_streamp)); +ZEXTERN int ZEXPORT deflateResetKeep OF((z_streamp)); +#if (defined(_WIN32) || defined(__CYGWIN__)) && !defined(Z_SOLO) +ZEXTERN gzFile ZEXPORT gzopen_w OF((const wchar_t *path, + const char *mode)); +#endif +#if defined(STDC) || defined(Z_HAVE_STDARG_H) +# ifndef Z_SOLO +ZEXTERN int ZEXPORTVA gzvprintf Z_ARG((gzFile file, + const char *format, + va_list va)); +# endif +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* ZLIB_H */ diff --git a/3rdparty/lib/zlibstatic.lib b/3rdparty/lib/zlibstatic.lib new file mode 100644 index 0000000000000000000000000000000000000000..1249b6491fba189ad6c05d785209739add5e7f3f GIT binary patch literal 177362 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%0D2{2U+j5)a($hSuR?HL`(-D%X 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 literal 0 HcmV?d00001 diff --git a/README.md b/README.md index bf0f5aeaf6..f6031eda3b 100644 --- a/README.md +++ b/README.md @@ -185,6 +185,8 @@ A Game Assistant for Arknights - C++ JSON库：[meojson](https://github.com/MistEO/meojson.git) - C++ 运算符解析器：[calculator](https://github.com/kimwalisch/calculator) - C++ base64编解码：[cpp-base64](https://github.com/ReneNyffenegger/cpp-base64) +- C++ 解压压缩库：[zlib](https://github.com/madler/zlib) +- C++ Gzip封装：[gzip-hpp](https://github.com/mapbox/gzip-hpp) - WPF MVVW框架：[Stylet](https://github.com/canton7/Stylet) - WPF控件库：[HandyControl](https://github.com/HandyOrg/HandyControl) - C# JSON库: [Newtonsoft.Json](https://github.com/JamesNK/Newtonsoft.Json) diff --git a/resource/config.json b/resource/config.json index 64517a752d..b2b7a48f5b 100644 --- a/resource/config.json +++ b/resource/config.json @@ -61,7 +61,8 @@ "swipe": "[Adb] -s [Address] shell input swipe [x1] [y1] [x2] [y2] [duration]", "display": "[Adb] -s [Address] shell dumpsys window displays | grep init= | awk ' { print $3 } '", "displayFormat": "cur=%dx%d", - "screencap": "[Adb] -s [Address] exec-out screencap -p", + "screencap": "[Adb] -s [Address] shell screencap | gzip -1", + "screencapGzip": true, "release": "[Adb] kill-server" } }, @@ -173,4 +174,4 @@ } } } -} \ No newline at end of file +} diff --git a/src/MeoAssistant/AsstDef.h b/src/MeoAssistant/AsstDef.h index bc24a8ad58..6114574ea3 100644 --- a/src/MeoAssistant/AsstDef.h +++ b/src/MeoAssistant/AsstDef.h @@ -41,8 +41,7 @@ namespace asst Rect(Rect&&) noexcept = default; Rect(int x, int y, int width, int height) : x(x), y(y), width(width), height(height) - { - } + {} Rect operator*(double rhs) const { return { x, y, static_cast(width * rhs), static_cast(height * rhs) }; @@ -243,6 +242,7 @@ namespace asst std::string display; std::string display_format; std::string screencap; + bool screencap_gzip = false; std::string release; //std::string pullscreen; int display_width = 0; diff --git a/src/MeoAssistant/Controller.cpp b/src/MeoAssistant/Controller.cpp index 020eddba92..cddc0952c3 100644 --- a/src/MeoAssistant/Controller.cpp +++ b/src/MeoAssistant/Controller.cpp @@ -16,6 +16,7 @@ #include #include +#include #include "AsstDef.h" #include "Logger.hpp" @@ -562,39 +563,50 @@ bool asst::Controller::screencap() { LogTraceFunction; -#if 1 - auto&& [ret, data] = call_command(m_emulator_info.adb.screencap); - if (ret && !data.empty()) { - if (m_image_convert_lf) { - convert_lf(data); - } - m_cache_image = cv::imdecode(data, cv::IMREAD_COLOR); - if (m_cache_image.empty()) { - Log.info("Data is not empty, but image is empty, try to convert lf"); - convert_lf(data); - m_cache_image = cv::imdecode(data, cv::IMREAD_COLOR); - if (m_cache_image.empty()) { - m_image_convert_lf = false; - Log.error("convert lf and retry decode falied!"); - return false; - } - m_image_convert_lf = true; - return true; - } - return true; - } - else { + auto& adb = m_emulator_info.adb; + auto&& [ret, data] = call_command(adb.screencap); + + if (!ret || data.empty()) { Log.error("Data is empty!"); return false; } -#else - m_cache_image = cv::imread("/home/mreo/test.png"); - return true; -#endif - //cv::Mat temp_image = cv::imdecode(data, cv::IMREAD_COLOR); - ////std::unique_lock image_lock(m_image_mutex); - //m_cache_image = std::move(temp_image); + if (m_image_convert_lf) { + convert_lf(data); + } + + std::function&)> decode_func = nullptr; + if (adb.screencap_gzip) { + decode_func = [&](const std::vector& data) -> bool { + auto dst = gzip::decompress(data.data(), data.size()); + if (dst.empty()) { + return false; + } + constexpr static int BmpHeaderSize = 12; + m_cache_image = cv::Mat(adb.display_height, adb.display_width, CV_8UC4, dst.data() + BmpHeaderSize); + cv::cvtColor(m_cache_image, m_cache_image, cv::COLOR_RGB2BGR); + return !m_cache_image.empty(); + }; + } + else { + decode_func = [&](const std::vector& data) -> bool { + m_cache_image = cv::imdecode(data, cv::IMREAD_COLOR); + return !m_cache_image.empty(); + }; + } + + if (!decode_func(data)) { + Log.info("Data is not empty, but image is empty, try to convert lf"); + convert_lf(data); + if (!decode_func(data)) { + m_image_convert_lf = false; + Log.error("convert lf and retry decode falied!"); + return false; + } + m_image_convert_lf = true; + return true; + } + return true; } int asst::Controller::click(const Point & p, bool block) diff --git a/src/MeoAssistant/GeneralConfiger.cpp b/src/MeoAssistant/GeneralConfiger.cpp index a1b30ff47f..d142aca5dd 100644 --- a/src/MeoAssistant/GeneralConfiger.cpp +++ b/src/MeoAssistant/GeneralConfiger.cpp @@ -52,6 +52,7 @@ bool asst::GeneralConfiger::parse(const json::value& json) emulator_info.adb.display = adb_json.at("display").as_string(); emulator_info.adb.display_format = adb_json.at("displayFormat").as_string(); emulator_info.adb.screencap = adb_json.at("screencap").as_string(); + emulator_info.adb.screencap_gzip = adb_json.get("screencapGzip", false); emulator_info.adb.release = adb_json.at("release").as_string(); //emulator_info.adb.pullscreen = adb_json.at("pullscreen").as_string(); diff --git a/src/MeoAssistant/MeoAssistant.vcxproj b/src/MeoAssistant/MeoAssistant.vcxproj index e61709ba0f..eabc213e5a 100644 --- a/src/MeoAssistant/MeoAssistant.vcxproj +++ b/src/MeoAssistant/MeoAssistant.vcxproj @@ -179,7 +179,7 @@ true true true - meojson.lib;ppocr.lib;opencv_world453.lib;penguin-stats-recognize.lib;%(AdditionalDependencies) + meojson.lib;ppocr.lib;opencv_world453.lib;penguin-stats-recognize.lib;zlibstatic.lib;%(AdditionalDependencies) RequireAdministrator @@ -225,7 +225,7 @@ xcopy /e /y /i /c $(SolutionDir)3rdparty\resource $(TargetDir)resource true true true - meojson.lib;ppocr.lib;opencv_world453.lib;penguin-stats-recognize.lib;%(AdditionalDependencies) + meojson.lib;ppocr.lib;opencv_world453.lib;penguin-stats-recognize.lib;zlibstatic.lib;%(AdditionalDependencies) RequireAdministrator diff --git a/src/MeoAssistant/README.md b/src/MeoAssistant/README.md index 49f8ac971f..c762ed495b 100644 --- a/src/MeoAssistant/README.md +++ b/src/MeoAssistant/README.md @@ -16,6 +16,8 @@ - C++ JSON库：[meojson](https://github.com/MistEO/meojson.git) - C++ 运算符解析器：[calculator](https://github.com/kimwalisch/calculator) - C++ base64编解码：[cpp-base64](https://github.com/ReneNyffenegger/cpp-base64) +- C++ 解压压缩库：[zlib](https://github.com/madler/zlib) +- C++ Gzip封装：[gzip-hpp](https://github.com/mapbox/gzip-hpp) ## 数据