annotate src/zlib-1.2.8/contrib/delphi/readme.txt @ 56:af97cad61ff0

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