author | Ryan C. Gordon <icculus@icculus.org> |
Wed, 24 Apr 2002 21:00:31 +0000 | |
changeset 208 | d176cef27a77 |
parent 205 | 6808b87ea234 |
child 214 | 19846c18071b |
permissions | -rw-r--r-- |
208
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
1 |
Building is (ahem) very easy. |
54 | 2 |
|
71 | 3 |
|
4 |
ALL PLATFORMS: |
|
91 | 5 |
|
71 | 6 |
Please understand your rights and mine: read the text file LICENSE in the root |
7 |
of the source tree. If you can't abide by it, delete this source tree now. |
|
8 |
||
9 |
The best documentation for the PhysicsFS API is physfs.h. It is VERY heavily |
|
10 |
commented, and makes an excellent, in-depth reference to all the functions. |
|
11 |
||
12 |
||
13 |
UNIX: |
|
91 | 14 |
|
54 | 15 |
Edit "Makefile", and follow the instructions. The defaults are probably okay |
71 | 16 |
for general purposes, but give it a once over to make sure. If you don't have |
17 |
zLib on your system, you'll need to disable ZIP support. |
|
54 | 18 |
|
19 |
run "make" |
|
20 |
||
21 |
That's it. The library will be sitting in a new directory called "bin". |
|
22 |
||
60
e5aade8e1b3f
Added appropriate make install target.
Ryan C. Gordon <icculus@icculus.org>
parents:
54
diff
changeset
|
23 |
Run "make install" to install the library for use on your system. |
54 | 24 |
|
71 | 25 |
|
26 |
WIN32: |
|
89
2f9f1d02aaca
Updated win32 build instructions.
Ryan C. Gordon <icculus@icculus.org>
parents:
71
diff
changeset
|
27 |
Download http://icculus.org/physfs/downloads/physfs-win32-support.zip, and |
205 | 28 |
unpack in the root of the source directory, preserving directory names. If |
29 |
you did it correctly, there should be a directory named "zlib114" in the |
|
30 |
same directory as "physfs.h". This archive has Visual C project files and |
|
89
2f9f1d02aaca
Updated win32 build instructions.
Ryan C. Gordon <icculus@icculus.org>
parents:
71
diff
changeset
|
31 |
the code needed for zipfile support in PhysicsFS, since most Windows boxes |
2f9f1d02aaca
Updated win32 build instructions.
Ryan C. Gordon <icculus@icculus.org>
parents:
71
diff
changeset
|
32 |
don't have zlib preinstalled. |
2f9f1d02aaca
Updated win32 build instructions.
Ryan C. Gordon <icculus@icculus.org>
parents:
71
diff
changeset
|
33 |
|
208
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
34 |
IMPORTANT: If you are using anything older than Visual Studio.NET, you |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
35 |
will _NEED_ to upgrade to the latest Platform SDK from Microsoft. It is a |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
36 |
free download: http://www.microsoft.com/msdownload/platformsdk/sdkupdate/ |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
37 |
Be sure to install _at least_ the Core SDK and the WMI SDK. I'm not sure if |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
38 |
this is needed (or usable for Cygwin). Even though you need these SDK updates, |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
39 |
the compiled PhysicsFS DLL should work on any win32 platform from Win95 and |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
40 |
WinNT 4.0 and later. |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
41 |
|
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
42 |
No one's tried building this for a WinCE (PocketPC) platform, but it may or |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
43 |
may not work. Patches are welcome. |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
44 |
|
205 | 45 |
After that, if building with CygWin, follow the Unix instructions, above. |
208
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
46 |
(Which used to work, see caveat about Platform SDK above). If you're using |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
47 |
Visual C, point the IDE at physfs.dsp, and build. If you're using any other |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
48 |
compiler, send me a patch when you get it working. :) |
71 | 49 |
|
91 | 50 |
If someone is willing to maintain prebuilt PhysicsFS DLLs, I'd like to hear |
51 |
from you; send an email to icculus@clutteredmind.org. |
|
52 |
||
187 | 53 |
|
54 |
MACOS 8/9: |
|
55 |
Download http://icculus.org/physfs/downloads/mac_classic_support.sit and |
|
56 |
unpack it in the root of the physfs folder. It should produce a folder |
|
57 |
called "Mac Classic Support" that has CodeWarrior 6 project files and a |
|
58 |
copy of zlib for zipfile support. |
|
59 |
||
60 |
If someone is willing to maintain prebuilt PhysicsFS Shared Libraries for |
|
61 |
the Mac, I'd like to hear from you; send an email to icculus@clutteredmind.org. |
|
62 |
||
63 |
||
64 |
OTHER PLATFORMS: |
|
65 |
Many platforms might "just work" with the Unix Makefile (such as BeOS and |
|
208
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
66 |
MacOS X), but have not been heavily tested, if tested at all. To implement a |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
67 |
new platform or archiver, please read the heavily-commented physfs_internal.h |
d176cef27a77
Updated win32 build info, other tweaks.
Ryan C. Gordon <icculus@icculus.org>
parents:
205
diff
changeset
|
68 |
and look in the platform/ and archiver/ directories for examples. |
187 | 69 |
|
54 | 70 |
--ryan. (icculus@clutteredmind.org) |
71 |