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