BorlandC.html
author Sam Lantinga <slouken@libsdl.org>
Sun, 19 May 2002 18:52:25 +0000
changeset 368 180837a1db89
parent 274 051b991765ba
permissions -rw-r--r--
*** empty log message ***
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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