annotate src/zlib-1.2.8/contrib/delphi/readme.txt @ 155:54abead6ecce

Opus for Windows (MSVC)
author Chris Cannam <cannam@all-day-breakfast.com>
date Fri, 25 Jan 2019 12:15:58 +0000
parents 5b4145a0d408
children
rev   line source
cannam@128 1
cannam@128 2 Overview
cannam@128 3 ========
cannam@128 4
cannam@128 5 This directory contains an update to the ZLib interface unit,
cannam@128 6 distributed by Borland as a Delphi supplemental component.
cannam@128 7
cannam@128 8 The original ZLib unit is Copyright (c) 1997,99 Borland Corp.,
cannam@128 9 and is based on zlib version 1.0.4. There are a series of bugs
cannam@128 10 and security problems associated with that old zlib version, and
cannam@128 11 we recommend the users to update their ZLib unit.
cannam@128 12
cannam@128 13
cannam@128 14 Summary of modifications
cannam@128 15 ========================
cannam@128 16
cannam@128 17 - Improved makefile, adapted to zlib version 1.2.1.
cannam@128 18
cannam@128 19 - Some field types from TZStreamRec are changed from Integer to
cannam@128 20 Longint, for consistency with the zlib.h header, and for 64-bit
cannam@128 21 readiness.
cannam@128 22
cannam@128 23 - The zlib_version constant is updated.
cannam@128 24
cannam@128 25 - The new Z_RLE strategy has its corresponding symbolic constant.
cannam@128 26
cannam@128 27 - The allocation and deallocation functions and function types
cannam@128 28 (TAlloc, TFree, zlibAllocMem and zlibFreeMem) are now cdecl,
cannam@128 29 and _malloc and _free are added as C RTL stubs. As a result,
cannam@128 30 the original C sources of zlib can be compiled out of the box,
cannam@128 31 and linked to the ZLib unit.
cannam@128 32
cannam@128 33
cannam@128 34 Suggestions for improvements
cannam@128 35 ============================
cannam@128 36
cannam@128 37 Currently, the ZLib unit provides only a limited wrapper around
cannam@128 38 the zlib library, and much of the original zlib functionality is
cannam@128 39 missing. Handling compressed file formats like ZIP/GZIP or PNG
cannam@128 40 cannot be implemented without having this functionality.
cannam@128 41 Applications that handle these formats are either using their own,
cannam@128 42 duplicated code, or not using the ZLib unit at all.
cannam@128 43
cannam@128 44 Here are a few suggestions:
cannam@128 45
cannam@128 46 - Checksum class wrappers around adler32() and crc32(), similar
cannam@128 47 to the Java classes that implement the java.util.zip.Checksum
cannam@128 48 interface.
cannam@128 49
cannam@128 50 - The ability to read and write raw deflate streams, without the
cannam@128 51 zlib stream header and trailer. Raw deflate streams are used
cannam@128 52 in the ZIP file format.
cannam@128 53
cannam@128 54 - The ability to read and write gzip streams, used in the GZIP
cannam@128 55 file format, and normally produced by the gzip program.
cannam@128 56
cannam@128 57 - The ability to select a different compression strategy, useful
cannam@128 58 to PNG and MNG image compression, and to multimedia compression
cannam@128 59 in general. Besides the compression level
cannam@128 60
cannam@128 61 TCompressionLevel = (clNone, clFastest, clDefault, clMax);
cannam@128 62
cannam@128 63 which, in fact, could have used the 'z' prefix and avoided
cannam@128 64 TColor-like symbols
cannam@128 65
cannam@128 66 TCompressionLevel = (zcNone, zcFastest, zcDefault, zcMax);
cannam@128 67
cannam@128 68 there could be a compression strategy
cannam@128 69
cannam@128 70 TCompressionStrategy = (zsDefault, zsFiltered, zsHuffmanOnly, zsRle);
cannam@128 71
cannam@128 72 - ZIP and GZIP stream handling via TStreams.
cannam@128 73
cannam@128 74
cannam@128 75 --
cannam@128 76 Cosmin Truta <cosmint@cs.ubbcluj.ro>