0
+ − 1 <HTML>
+ − 2
+ − 3
+ − 4
+ − 5 <HEAD>
+ − 6
+ − 7
+ − 8
+ − 9 <TITLE> Using SDL with Microsoft Visual C++ 5 and 6 </TITLE>
+ − 10
+ − 11
+ − 12
+ − 13 </HEAD>
+ − 14
+ − 15
+ − 16
+ − 17 <BODY>
+ − 18
+ − 19
+ − 20
+ − 21 <H1> Using SDL with Microsoft Visual C++ 5 and 6 </H1>
+ − 22
+ − 23 <H3>
+ − 24 by <A HREF="mailto:snowlion@sprynet.com"> Lion Kimbro </A>
+ − 25 </H3>
+ − 26
+ − 27
+ − 28
+ − 29 <p>
+ − 30 You can either use the precompiled libraries from
+ − 31 <A HREF="http://www.libsdl.org/download.html">
+ − 32 the SDL Download web site </A>,
+ − 33 or you can build SDL yourself.
+ − 34 </p>
+ − 35
+ − 36
+ − 37 <H3> Building SDL </H3>
+ − 38
+ − 39 <P>
+ − 40 Unzip the <CODE>VisualC.zip</CODE> file into the directory
+ − 41 that contains this file (<CODE>VisualC.html</CODE>).
+ − 42 </P>
+ − 43
+ − 44 <P>
+ − 45 Be certain that you unzip <CODE> VisualC.zip </CODE>
+ − 46 into <strong>this</strong> directory and not any other
+ − 47 directory. If you are using WinZip, be careful to
+ − 48 make sure that it extracts to <strong>this</strong>
+ − 49 folder, because it's convenient feature of
+ − 50 unzipping to a folder with the name of the
+ − 51 file currently being unzipped will get you in
+ − 52 trouble if you use it right now. And that's all
+ − 53 I have to say about that.
+ − 54 </P>
+ − 55
+ − 56 <P>
+ − 57 Now that it's unzipped, go into the VisualC directory
+ − 58 that is created, and double-click on the VC++
+ − 59 workspace file "<CODE>SDL.dsw</CODE>".
+ − 60 This should open up VisualC.
+ − 61 </P>
+ − 62
+ − 63 <P>
+ − 64 You may be prompted at this point to upgrade the
+ − 65 workspace, should you be using a more recent version
+ − 66 of Visual C++. If so, allow the workspace to be
+ − 67 upgraded.
+ − 68 </P>
+ − 69
+ − 70
+ − 71 <P>
+ − 72 Build the <CODE>.dll</CODE> and <CODE>.lib</CODE> files.
+ − 73 </P>
+ − 74
+ − 75 <P>
+ − 76 This is done by right clicking on each project in turn
+ − 77 (Projects are listed in the Workspace panel in the
+ − 78 FileView tab), and selecting "Build".
+ − 79 </P>
+ − 80
+ − 81 <P>
+ − 82 You may get a few warnings, but you should not get
+ − 83 any errors. You do have to have at least the DirectX
+ − 84 5 SDK installed, however. (I believe...) The latest
+ − 85 version of DirectX can be downloaded or purchased
+ − 86 on a cheap CD (my recommendation) from
+ − 87 <A HREF="http://www.microsoft.com"> Microsoft </A>.
+ − 88 </P>
+ − 89
+ − 90 <P>
+ − 91 Later, we will refer to the following .lib and .dll
+ − 92 files that have just been generated:
+ − 93 </P>
+ − 94
+ − 95 <list>
+ − 96 <li> SDL.dll
+ − 97 <li> SDL.lib
+ − 98 <li> SDLmain.lib
+ − 99 </list>
+ − 100
+ − 101 <P>
+ − 102 Search for these using the Windows Find (Windows-F)
+ − 103 utility, if you don't already know where they should be.
+ − 104 For those of you with a clue, look inside the Debug
+ − 105 or Release directories of the subdirectories of the
+ − 106 VisualC folder. (It might be easier to just use
+ − 107 Windows Find if this sounds confusing. And don't worry
+ − 108 about needing a clue; we all need visits from the
+ − 109 clue fairy frequently.)
+ − 110 </P>
+ − 111
+ − 112
+ − 113
+ − 114 <H3> Creating a Project with SDL </H3>
+ − 115
+ − 116 <P>
+ − 117 Create a project as a Win32 Application.
+ − 118 </P>
+ − 119
+ − 120 <P>
+ − 121 Create a C++ file for your project.
+ − 122 </P>
+ − 123
+ − 124 <P>
+ − 125 Set the C runtime to "Multi-threaded DLL" in the menu:
+ − 126 <CODE> Project|Settings|C/C++ tab|Code Generation|Runtime Library </CODE>.
+ − 127 </P>
+ − 128
+ − 129 <P>
+ − 130 Add the SDL <CODE>include</CODE> directory to your list
+ − 131 of includes in the menu:
+ − 132 <CODE> Project|Settings|C/C++ tab|Preprocessor|Additional include directories </CODE>.
+ − 133 </P>
+ − 134
+ − 135 <P>
+ − 136 The "include directory" I am referring to is the
+ − 137 <CODE>include</CODE> folder within the main SDL
+ − 138 directory (the one that this HTML file located
+ − 139 within.
+ − 140 </P>
+ − 141
+ − 142 <P>
+ − 143 Now we're going to use the files that we had created
+ − 144 earlier in the Build SDL step.
+ − 145 </P>
+ − 146
+ − 147 <P>
+ − 148 Copy the following files into your Project directory:
+ − 149 </P>
+ − 150
+ − 151 <list>
+ − 152 <li> SDL.dll </li>
+ − 153 </list>
+ − 154
+ − 155 <P>
+ − 156 Copy the following files into your Project directory,
+ − 157 and <em>add them to your Project</em> as well:
+ − 158 </P>
+ − 159
+ − 160 <list>
+ − 161 <li> SDL.lib </li>
+ − 162 <li> SDLmain.lib </li>
+ − 163 </list>
+ − 164
+ − 165 <P>
+ − 166 (To add them to your project, right click on your
+ − 167 project, and select "Add files to project")
+ − 168 </P>
+ − 169
+ − 170 <P>
+ − 171 (I believe that it's not necessary to actually
+ − 172 copy the .lib files into your directory; you only
+ − 173 have to be certain that you add them to your Project.
+ − 174 If someone is so inclined, correct this document, or
+ − 175 <A HREF="mailto:snowlion@sprynet.com">
+ − 176 e-mail me </A>,
+ − 177 and I'll fix this document.)
+ − 178 </P>
+ − 179
+ − 180
+ − 181
+ − 182 <H3> SDL 101, First Day of Class </H3>
+ − 183
+ − 184 <P>
+ − 185 Now create the basic body of your project.
+ − 186 The body of your program should take the following form:
+ − 187
+ − 188 <CODE>
+ − 189 <PRE>
+ − 190 #include "SDL.h"
+ − 191
+ − 192 int main( int argc, char* argv[] )
+ − 193 {
+ − 194 // Body of the program goes here.
+ − 195 return 0;
+ − 196 }
+ − 197 </PRE>
+ − 198 </CODE>
+ − 199 </P>
+ − 200
+ − 201 <H3> That's it! </H3>
+ − 202
+ − 203 <P>
+ − 204 I hope that this document has helped you get
+ − 205 through the most difficult part of using the
+ − 206 SDL: installing it. Suggestions for improvements
+ − 207 to this document should be sent to the writers
+ − 208 of this document.
+ − 209 </P>
+ − 210
+ − 211 <P>
+ − 212 Thanks to Paulus Esterhazy (pesterhazy@gmx.net), for the work on VC++ port.
+ − 213 </P>
+ − 214
+ − 215 <P>
+ − 216 This document was originally called "VisualC.txt",
+ − 217 and was written by
+ − 218 <A HREF="mailto:slouken@libsdl.org">Sam Lantinga</A>.
+ − 219 </P>
+ − 220
+ − 221 <P>
+ − 222 Later, it was converted to HTML and expanded into
+ − 223 the document that you see today by
+ − 224 <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro</A>.
+ − 225 </P>
+ − 226
+ − 227
+ − 228
+ − 229 </BODY>
+ − 230
+ − 231
+ − 232
+ − 233 </HTML>
+ − 234
+ − 235
