9e052883 |
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 | |