sdl-ios-xcode: Borland.html annotate

annotate Borland.html @ 5127:b6c7a6b07ebf

Updated main.c for API changes Kees Bakker to sdl The main.c for the template is still targeting SDL1.2. Here is the patch to make it work for SDL1.3 (I'm hoping the mailing lists accepts attachments.) In this patch I have also changed the shell script that assembles the Template. Since there is now only one lib target (same name for "device" and "simulator" version) I copy the simulator library to the destination with the name libSDLSimulator.a. This is not a satisfactory solution, because both libraries are included in the project while only one is needed (depending on the selected environment). However, I'm not fluent with Xcode to say what a better solution would be. Kind regards, Kees Bakker

author	Sam Lantinga <slouken@libsdl.org>
date	Fri, 28 Jan 2011 10:37:36 -0800
parents	de622b7108bf
children

rev	line source
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	2 <html>
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	3 <head>
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	4 <title>Building SDL with Borland's C++ compilers</title>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	5
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	6 <meta name="author"
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	7 content="David Snopek and updated by Dominique Louis.">
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	8 </head>
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	9 <body>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	10 <xevol @newtonave.net=""> </xevol>
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	11 <h1>Building SDL with Borland's C++ compilers. </h1>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	12 <b> by <a href="mailto:xevol@users.sourceforge.net"> David Snopek</a></b>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	13 and updated by <b><a href="mailto:Dominique@SavageSoftware.com.au">Dominique
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	14 Louis</a></b> ( Last updated : 30th June 2003 ).<br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	15 <br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	16 These instructions cover how to compile SDL and its included test
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	17 programs using either Borland <a href="#bcbwin">C++ Builder 5, 6 for Windows</a>,
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	18 <a href="#k3">C++ Builder for Linux ( AKA Kylix 3 )</a> or the free <a
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	19 href="#bccc">Borland C++ command-line compiler</a>. <br>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	20
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	21 <h3> <b> Extract the files </b> </h3>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	22
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	23 <p> Unzip the Borland.zip archive into <b>this</b> directory. Do not unzip
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	24 it into any other directory because the makefiles ( *.mak ) and project
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	25 files ( *.bpr ) use relative paths to refer to the SDL sources. This should
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	26 create a directory named "Borland" inside of the top level SDL source directory.
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	27 </p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	28
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	29 <h3> <b><a name="bcbwin"></a> Using Borland C++ Builder 5, 6 for Windows </b>
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	30 </h3>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	31
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	32 <p> Inside of the "Borland" directory there is a "bcb6" directory that contains
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	33 a number of Builder project files. Double-click on the "libSDL.bpg" file
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	34 icon. Once Builder has started click on the "<u>P</u>rojects" menu on
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	35 the menu-bar and go down to "B<u>u</u>ild All Projects" option. <br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	36 This will proceed to build SDL ( with Borland's calling convention ),
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	37 SDLmain, and all the <a href="#tests">test programs</a>. Currently, all
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	38 the <a href="#tests">test programs</a> are dynamically linked to Sam Lantinga's
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	39 SDL.dll.</p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	40
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	41 <p><b>NOTE :</b> Borland's "lib" format and Microsoft's "lib" format are incompatible.
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	42  <br>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	43 If you wish to dynamically link to the SDL library supplied by Sam Lantinga
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	44 in each release, I have created the correct *.libs for SDL 1.2.4 and they
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	45 exist in the "/lib" directory.<br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	46 If you would like to create the *.lib files yourself, you will need to
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	47 make use of Borland's "implib.exe" utility.<br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	48 </p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	49
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	50 <p><tt>IMPLIB</tt> works like this: </p>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	51
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	52 <pre> IMPLIB (destination lib name) (source dll)<br></pre>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	53
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	54 <p> For example,</p>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	55
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	56 <pre> IMPLIB SDL.lib SDL.dll<br></pre>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	57
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	58 <p>This assumes that SDL.dll was compiled with Visual C++ or similar.<br>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	59 </p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	60
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	61 <p>To learn more about the difference between Borland's and Microsoft's *.lib
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	62 format please read the article <a
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	63 href="http://www.bcbdev.com/articles/vcdll.htm">here</a>.<br>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	64 </p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	65
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	66 <p> <b><br>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	67 NOTE :</b> The C++ Builder for Windows project format, is not compatible
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	68 with the Kylix 3 project format, hence the reason why they are in separate
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	69 directories.</p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	70
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	71 <h3> <b><a name="bccc"></a> Using the free Borland C++ command-line compiler
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	72 </b> </h3>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	73
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	74 <p> The free Borland compiler can be downloaded at no charge from <a
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	75 href="http://www.borland.com/bcppbuilder/freecompiler/"> the Borland website
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	76 </a>. Make sure that it is installed and properly configured. </p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	77
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	78 <p> Open an MS-DOS Prompt. Change to the "Borland\freebcc" directory under
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	79 the SDL source directory. Type "make -f SDL.mak" to build SDL and "make
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	80 -f SDLmain.mak". There are also makefiles for all of the <a
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	81 href="#tests">test programs</a>, if you wish to build them. All .exes and
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	82 DLLs are created in the "test" SDL directory. Ify ou would like to create
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	83 the DLL and all the test applications, I have thrown together a basic batchfile
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	84 called "makeall.bat" which should create everything in the right order. </p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	85
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	86 <h3> <b> Output files </b> </h3>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	87 No matter which compiler you used, three important files should have
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	88 been produced:
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	89 <ul>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	90 <li> SDL.dll ( Borland format ) </li>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	91 <li> SDL.lib ( Borland format ) </li>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	92 <li> SDLmain.lib ( Borland format ) </li>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	93
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	94 </ul>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	95 Both of the *.lib files will need to be added to all the projects
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	96 that use SDL and SDL.dll must be placed some where the Windows dynamic
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	97 linker can find it (either in your project directory or on the system
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	98 path, C:\WINDOWS\SYSTEM).
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	99 <h3> <b><a name="k3"></a> Using Borland C++ Builder for Linux ( AKA Kylix
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	100 3 ) </b> </h3>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	101
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	102 <p> Inside of the "Borland" directory there is a "k3" directory that contains
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	103 a number of Builder project files. Double-click on the "libSDL.bpg" file
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	104 icon. Once Builder has started click on the "<u>P</u>rojects" menu on
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	105 the menu-bar and go down to "B<u>u</u>ild All Projects" option. This will
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	106 proceed to build all the <a href="#tests">test programs</a>. <br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	107 Linux users do not need *.lib files as the Shared Object is linked right
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	108 into the project ( very neat actually, Windows should do this sort of thing
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	109 as it is a lot easier for the developer ). <br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	110 <b>NOTE :</b> The C++ Builder for Windows project format, is not
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	111 compatible with the Kylix 3 project format, hence the reason why they are
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	112 in separate directories.</p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	113
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	114 <p> On Mandrake 8.1 the shared objects for SDL are located in the /usr/lib
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	115 directory as libSDL_*.so and the Mesa OpenGL shared objects are located
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	116 in /usr/X11R6/lib as libGL*.so<br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	117 <br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	118 So if your setup is different you may need to change the project file
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	119 so that they re-link to the ones on your system.<br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	120 <br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	121 On Mandrake 8.1 the headers files are located at /usr/include/SDL/.
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	122 So if you you have not installed the development RPMs ( usually named libSDL-devel*
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	123 ) for SDL ( not included ) you may have to change the include directory
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	124 within some of the projects.<br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	125 </p>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	126
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	127 <h3> Known Problems</h3>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	128 The only known problem is that I ( Dominique Louis ), was unable to
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	129 create the projects that rebuilt the SDL shared objects under Linux, due
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	130 to time constraints and my lack of intimate knowledge of Linux.
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	131 <h3><a name="tests"><b> Test programs </b> </a></h3>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	132 Some of the test programs require included media files ( .wav; .bmp
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	133 etc ). All the test programs are now created in the "test" directory, where
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	134 the media files are ( usually ) so they should be ready to go. <br>
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	135 <br>
642 de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	136 <br>
de622b7108bf * empty log message * Sam Lantinga <slouken@libsdl.org> parents: 465 diff changeset	137 <br>
465 25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	138 </body>
25f475cd4981 Updated the Borland C++ projects (thanks Dominique!) Sam Lantinga <slouken@libsdl.org> parents: diff changeset	139 </html>

Mercurial > sdl-ios-xcode

annotate Borland.html @ 5127:b6c7a6b07ebf