| 1 | |
| 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 | |