author | Sam Lantinga <slouken@libsdl.org> |
Thu, 18 Apr 2002 04:51:20 +0000 | |
changeset 362 | 3791ff65cddd |
parent 274 | 051b991765ba |
permissions | -rw-r--r-- |
274
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
1 |
Date: Sun, 13 Jan 2002 13:59:56 -0600 |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
2 |
From: David Snopek <xevol@newtonave.net> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
3 |
To: slouken@devolution.com |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
4 |
Subject: Compiling SDL with Borland C++ |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
5 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
6 |
<html> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
7 |
<title>Building SDL with Borland C++ </title> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
8 |
<body> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
9 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
10 |
<h1>Building SDL with Borland C++ </h1> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
11 |
<b> by <a href=mailto:xevol@users.sourceforge.net> David Snopek </a> </b> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
12 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
13 |
<br> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
14 |
<br> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
15 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
16 |
These instructions cover how to compile SDL and its included test programs using either |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
17 |
Borland C++ Builder 5 or the free Borland compiler. <br> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
18 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
19 |
<h3> <b> Extract the files </b> </h3> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
20 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
21 |
<p> Unzip the Borland.zip archive into <b>this</b> directory. Do not unzip it into any |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
22 |
other directory because the makefiles use relative paths to refer to the SDL sources. This |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
23 |
should create a directory named "Borland" inside of the top level SDL source directory. |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
24 |
</p> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
25 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
26 |
<h3> <b> Using Borland C++ Builder 5 </b> </h3> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
27 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
28 |
<p> Inside of the "Borland" directory there is a "bcb5" directory that contains a number |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
29 |
of Builder project files. Double-click on the "libSDL.bpg" file icon. Once Builder has |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
30 |
started click on the "<u>P</u>rojects" menu on the menu-bar and go down to |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
31 |
"B<u>u</u>ild All Projects" option. This will proceed to build SDL, SDLmain, and all |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
32 |
the <a href="#tests">test programs</a>. </p> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
33 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
34 |
<h3> <b> Using the free Borland compiler </b> </h3> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
35 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
36 |
<p> The free Borland compiler can be downloaded at no charge from <a href="http://www.borland.com/bcppbuilder/freecompiler/"> the |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
37 |
Borland website </a>. Make sure that it is installed and properly configured. </p> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
38 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
39 |
<p> Open an MS-DOS Prompt. Change to the "Borland\freebcc" directory under the |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
40 |
SDL source directory. Type "make -f SDL.mak" to build SDL and "make -f |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
41 |
SDLmain.mak". There are also makefiles for all of the <a href="#tests">test |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
42 |
programs</a>, if you wish to build them. </p> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
43 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
44 |
<h3> <b> Output files </b> </h3> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
45 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
46 |
No matter which compiler you used, three important files should have been produced: |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
47 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
48 |
<UL> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
49 |
<LI> SDL.dll </LI> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
50 |
<LI> SDL.lib </LI> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
51 |
<LI> SDLmain.lib </LI> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
52 |
</UL> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
53 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
54 |
Both of the *.lib files will need to be added to all the projects that use SDL and SDL.dll |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
55 |
must be placed some where the Windows dynamic linker can find it (either in your |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
56 |
project directory or on the system path, C:\WINDOWS\SYSTEM). |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
57 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
58 |
<a name="tests"> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
59 |
<h3> <b> Test programs </b> </h3> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
60 |
</a> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
61 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
62 |
Some of the test programs require included media files. Before trying to run any of the |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
63 |
test programs, copy these media files from the "tests/" directory into the build directory. |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
64 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
65 |
</body> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
66 |
</html> |
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
67 |
|
051b991765ba
David Snopek added Borland compiler support
Sam Lantinga <slouken@libsdl.org>
parents:
diff
changeset
|
68 |