Commit | Line | Data |
---|---|---|
5ca28f79 L |
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 |