summaryrefslogtreecommitdiff
path: root/Build/source/libs/zziplib/zziplib-src/docs/zzip-index.htm
blob: 8b7a9bb6637d9ed72929adf04492c467fbc106e2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
<section> <date> created 1.Jun.2000, last updated 09.Feb.2003 </date>
<h2> The Library </h2> Overview

<!--border-->

<!-- 1. section of zzip-zip.html -->

<P>
 The <a href="zziplib.html">zziplib library</a> is intentionally
 lightweight, it offers the ability to easily extract data from 
 files archived in a single zip file. Applications can bundle
 files into a single zip archive and access them.
 The implementation is based only on the (free) subset of 
 compression with the <a href="http://www.gzip.org/zlib">
 zlib algorithm</a> which is actually used by the <tt>zip/unzip</tt> tools.
</P>

<center>
 The library allows reading zip archives in a number of ways,
</center><dl>
<dt>archive mode:</dt>
<dd>  reading the zip directory and extracting files from it.
      This is the traditional mode as seen with unzip-utilities.
      Some extra unzip-utiles for transparent/magic mode are 
      shipped as&nbsp;well.
</dd>
<dt>replacement mode:</dt>
<dd>  Use ZZIP_FILE / ZZIP_DIR pointers provided by zziplib and
      put them to work with routines originally developped to
      work with real directories and file handles. The API calls
      do follow traditional synopsis from posix/stdio.
</dd>
<dt>transparent mode:</dt>
<dd>  Use replacement handles and allow the open()-calls to 
      automatically detect when a file is contained in a zip 
      archive or when it is a real file in the file system.
      A filepath can be partly in a real filesystem and partly
      within the zip archive when one is seen.
</dd>
<dt> ext magic </dt>
<dd>  Use the same filepath to access either a zipped or real
      file - it looks for a real file and there is none then
      every subdirectory of the path is checked, a ".zip"
      extension appended, and the zipped file transparently
      opened. This can speed up dat-file development 
      dramatically.
</dd>
<dt> io/xor magic </dt>
<dd>  The access to the filesystem can be hooked up - examples
      are given for xor obfuscation which is great for game
      artwork and AI data. A small intro for SDLrwops usage is
      given as well.
</dd>
</dl>
</section>