</HEAD>
<BODY>
<H1>
- Using SDL with Microsoft Visual C++ 5,6 and 7
+ Using SDL with Microsoft Visual C++
</H1>
<H3>
by <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro </A>and additions by <A HREF="mailto:james@conceptofzero.net">
James Turk</A>
</H3>
<p>
- You can either use the precompiled libraries from <A HREF="http://www.libsdl.org/download.php">
- the SDL Download web site </A>, or you can build SDL yourself.
+ You can either use the precompiled libraries from <A HREF="http://www.libsdl.org/download.php"> the SDL Download web site </A>, or you can build SDL yourself.
</p>
<H3>
Building SDL
</H3>
<P>
- Go into the VisualC
- directory that is created, and double-click on the VC++ file "<CODE>SDL.dsw</CODE>"<STRONG><FONT color="#009900">
- ("<CODE>SDL.sln</CODE>").</FONT></STRONG> This should open up the IDE.
+ Go into the VisualC directory and double-click on the Visual Studio solution for your version of Visual Studio, e.g. <CODE>SDL_VS2008.sln</CODE> This should open up the IDE.
</P>
<P>
- You may be prompted at this point to upgrade the workspace, should you be using
- a more recent version of Visual C++. If so, allow the workspace to be upgraded.
+ There are different solution files for the various
+ versions of the IDE. Please use the appropiate version
+ 2008, 2010, 2012 or 2013.
</P>
<P>
Build the <CODE>.dll</CODE> and <CODE>.lib</CODE> files.
the Workspace panel in the FileView tab), and selecting "Build".
</P>
<P>
- If you get an error about SDL_config.h being missing, you should
- copy include/SDL_config.h.default to include/SDL_config.h and try again.
- </P>
- <P>
You may get a few warnings, but you should not get any errors. You do have to
- have at least the DirectX 5 SDK installed, however. The latest
- version of DirectX can be downloaded or purchased on a cheap CD (my
- recommendation) from <A HREF="http://www.microsoft.com">Microsoft </A>.
+ have at least the DirectX 9 SDK installed, however. The latest
+ version of DirectX can be downloaded from <A HREF="http://www.microsoft.com">Microsoft</A>.
</P>
<P>
Later, we will refer to the following .lib and .dll files that have just been
generated:
</P>
<ul>
- <li> SDL.dll</li>
- <li> SDL.lib</li>
- <li> SDLmain.lib</li>
+ <li> SDL2.dll</li>
+ <li> SDL2.lib</li>
+ <li> SDL2main.lib</li>
</ul>
<P>
- Search for these using the Windows Find (Windows-F) utility, if you don't
- already know where they should be. For those of you with a clue, look inside
- the Debug or Release directories of the subdirectories of the Project folder.
- (It might be easier to just use Windows Find if this sounds confusing. And
- don't worry about needing a clue; we all need visits from the clue fairy
- frequently.)
+ Search for these using the Windows Find (Windows-F) utility inside the VisualC directory.
</P>
<H3>
Creating a Project with SDL
add the include and library directories to the list that VC7 keeps. Do this by
selecting Tools|Options|Projects|VC++ Directories and under the "Show
Directories For:" dropbox select "Include Files", and click the "New Directory
- Icon" and add the [SDLROOT]\include directory (ex. If you installed to
- c:\SDL-1.2.5\ add c:\SDL-1.2.5\include). Proceed to change the
+ Icon" and add the [SDLROOT]\include directory (e.g. If you installed to
+ c:\SDL\ add c:\SDL\include). Proceed to change the
dropbox selection to "Library Files" and add [SDLROOT]\lib.</FONT></STRONG>
</P>
<P>
Copy the following files into your Project directory:
</P>
<ul>
- <li> SDL.dll</li>
+ <li> SDL2.dll</li>
</ul>
<P>
Add the following files to your project (It is not necessary to copy them to
your project directory):
</P>
<ul>
- <li> SDL.lib </li>
- <li> SDLmain.lib</li>
+ <li> SDL2.lib </li>
+ <li> SDL2main.lib</li>
</ul>
<P>
(To add them to your project, right click on your project, and select "Add
desireable to add them to the linker options: Project|Properties|Linker|Command
Line and type the names of the libraries to link with in the "Additional
Options:" box. Note: This must be done for each build
- configuration (eg. Release,Debug).</FONT></STRONG></P>
+ configuration (e.g. Release,Debug).</FONT></STRONG></P>
<H3>
SDL 101, First Day of Class
</H3>
<P>
Now create the basic body of your project. The body of your program should take
- the following form: <CODE>
- <PRE>
+ the following form:
+ <PRE><CODE>
#include "SDL.h"
int main( int argc, char* argv[] )
// Body of the program goes here.
return 0;
}
-</PRE>
- </CODE>
+ </CODE></PRE>
<P></P>
<H3>
That's it!