| 1 |
745 |
jeremybenn |
|
| 2 |
|
|
This directory contains a Pascal (Delphi, Kylix) interface to the
|
| 3 |
|
|
zlib data compression library.
|
| 4 |
|
|
|
| 5 |
|
|
|
| 6 |
|
|
Directory listing
|
| 7 |
|
|
=================
|
| 8 |
|
|
|
| 9 |
|
|
zlibd32.mak makefile for Borland C++
|
| 10 |
|
|
example.pas usage example of zlib
|
| 11 |
|
|
zlibpas.pas the Pascal interface to zlib
|
| 12 |
|
|
readme.txt this file
|
| 13 |
|
|
|
| 14 |
|
|
|
| 15 |
|
|
Compatibility notes
|
| 16 |
|
|
===================
|
| 17 |
|
|
|
| 18 |
|
|
- Although the name "zlib" would have been more normal for the
|
| 19 |
|
|
zlibpas unit, this name is already taken by Borland's ZLib unit.
|
| 20 |
|
|
This is somehow unfortunate, because that unit is not a genuine
|
| 21 |
|
|
interface to the full-fledged zlib functionality, but a suite of
|
| 22 |
|
|
class wrappers around zlib streams. Other essential features,
|
| 23 |
|
|
such as checksums, are missing.
|
| 24 |
|
|
It would have been more appropriate for that unit to have a name
|
| 25 |
|
|
like "ZStreams", or something similar.
|
| 26 |
|
|
|
| 27 |
|
|
- The C and zlib-supplied types int, uInt, long, uLong, etc. are
|
| 28 |
|
|
translated directly into Pascal types of similar sizes (Integer,
|
| 29 |
|
|
LongInt, etc.), to avoid namespace pollution. In particular,
|
| 30 |
|
|
there is no conversion of unsigned int into a Pascal unsigned
|
| 31 |
|
|
integer. The Word type is non-portable and has the same size
|
| 32 |
|
|
(16 bits) both in a 16-bit and in a 32-bit environment, unlike
|
| 33 |
|
|
Integer. Even if there is a 32-bit Cardinal type, there is no
|
| 34 |
|
|
real need for unsigned int in zlib under a 32-bit environment.
|
| 35 |
|
|
|
| 36 |
|
|
- Except for the callbacks, the zlib function interfaces are
|
| 37 |
|
|
assuming the calling convention normally used in Pascal
|
| 38 |
|
|
(__pascal for DOS and Windows16, __fastcall for Windows32).
|
| 39 |
|
|
Since the cdecl keyword is used, the old Turbo Pascal does
|
| 40 |
|
|
not work with this interface.
|
| 41 |
|
|
|
| 42 |
|
|
- The gz* function interfaces are not translated, to avoid
|
| 43 |
|
|
interfacing problems with the C runtime library. Besides,
|
| 44 |
|
|
gzprintf(gzFile file, const char *format, ...)
|
| 45 |
|
|
cannot be translated into Pascal.
|
| 46 |
|
|
|
| 47 |
|
|
|
| 48 |
|
|
Legal issues
|
| 49 |
|
|
============
|
| 50 |
|
|
|
| 51 |
|
|
The zlibpas interface is:
|
| 52 |
|
|
Copyright (C) 1995-2003 Jean-loup Gailly and Mark Adler.
|
| 53 |
|
|
Copyright (C) 1998 by Bob Dellaca.
|
| 54 |
|
|
Copyright (C) 2003 by Cosmin Truta.
|
| 55 |
|
|
|
| 56 |
|
|
The example program is:
|
| 57 |
|
|
Copyright (C) 1995-2003 by Jean-loup Gailly.
|
| 58 |
|
|
Copyright (C) 1998,1999,2000 by Jacques Nomssi Nzali.
|
| 59 |
|
|
Copyright (C) 2003 by Cosmin Truta.
|
| 60 |
|
|
|
| 61 |
|
|
This software is provided 'as-is', without any express or implied
|
| 62 |
|
|
warranty. In no event will the author be held liable for any damages
|
| 63 |
|
|
arising from the use of this software.
|
| 64 |
|
|
|
| 65 |
|
|
Permission is granted to anyone to use this software for any purpose,
|
| 66 |
|
|
including commercial applications, and to alter it and redistribute it
|
| 67 |
|
|
freely, subject to the following restrictions:
|
| 68 |
|
|
|
| 69 |
|
|
1. The origin of this software must not be misrepresented; you must not
|
| 70 |
|
|
claim that you wrote the original software. If you use this software
|
| 71 |
|
|
in a product, an acknowledgment in the product documentation would be
|
| 72 |
|
|
appreciated but is not required.
|
| 73 |
|
|
2. Altered source versions must be plainly marked as such, and must not be
|
| 74 |
|
|
misrepresented as being the original software.
|
| 75 |
|
|
3. This notice may not be removed or altered from any source distribution.
|
| 76 |
|
|
|
