|
|
@@ -1,146 +0,0 @@
|
|
|
-<HTML>
|
|
|
- <HEAD>
|
|
|
- <TITLE>Using SDL with Microsoft Visual C++</TITLE>
|
|
|
- </HEAD>
|
|
|
- <BODY>
|
|
|
- <H1>
|
|
|
- Using SDL with Microsoft Visual C++
|
|
|
- </H1>
|
|
|
- <H3>
|
|
|
- by <A HREF="mailto:[email protected]">Lion Kimbro </A>and additions by <A HREF="mailto:[email protected]">
|
|
|
- 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.
|
|
|
- </p>
|
|
|
- <H3>
|
|
|
- Building SDL
|
|
|
- </H3>
|
|
|
- <P>
|
|
|
- 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>
|
|
|
- There are different solution files for the various
|
|
|
- versions of the IDE. Please use the appropriate version
|
|
|
- 2008, 2010, 2012 or 2013.
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- Build the <CODE>.dll</CODE> and <CODE>.lib</CODE> files.
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- This is done by right clicking on each project in turn (Projects are listed in
|
|
|
- the Workspace panel in the FileView tab), and selecting "Build".
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- You may get a few warnings, but you should not get any errors. You do have to
|
|
|
- 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> SDL2.dll</li>
|
|
|
- <li> SDL2.lib</li>
|
|
|
- <li> SDL2main.lib</li>
|
|
|
- </ul>
|
|
|
- <P>
|
|
|
- Search for these using the Windows Find (Windows-F) utility inside the VisualC directory.
|
|
|
- </P>
|
|
|
- <H3>
|
|
|
- Creating a Project with SDL
|
|
|
- </H3>
|
|
|
- <P>
|
|
|
- Create a project as a Win32 Application.
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- Create a C++ file for your project.
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- Set the C runtime to "Multi-threaded DLL" in the menu: <CODE>Project|Settings|C/C++
|
|
|
- tab|Code Generation|Runtime Library </CODE>.
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- Add the SDL <CODE>include</CODE> directory to your list of includes in the
|
|
|
- menu: <CODE>Project|Settings|C/C++ tab|Preprocessor|Additional include directories </CODE>
|
|
|
- .
|
|
|
- <br>
|
|
|
- <STRONG><FONT color="#009900">VC7 Specific: Instead of doing this I find it easier to
|
|
|
- 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 (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>
|
|
|
- The "include directory" I am referring to is the <CODE>include</CODE> folder
|
|
|
- within the main SDL directory (the one that this HTML file located within).
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- Now we're going to use the files that we had created earlier in the Build SDL
|
|
|
- step.
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- Copy the following files into your Project directory:
|
|
|
- </P>
|
|
|
- <ul>
|
|
|
- <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> SDL2.lib </li>
|
|
|
- <li> SDL2main.lib</li>
|
|
|
- </ul>
|
|
|
- <P>
|
|
|
- (To add them to your project, right click on your project, and select "Add
|
|
|
- files to project")
|
|
|
- </P>
|
|
|
- <P><STRONG><FONT color="#009900">Instead of adding the files to your project it is more
|
|
|
- desirable 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 (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:
|
|
|
- <PRE><CODE>
|
|
|
-#include "SDL.h"
|
|
|
-
|
|
|
-int main( int argc, char* argv[] )
|
|
|
-{
|
|
|
- // Body of the program goes here.
|
|
|
- return 0;
|
|
|
-}
|
|
|
- </CODE></PRE>
|
|
|
- <P></P>
|
|
|
- <H3>
|
|
|
- That's it!
|
|
|
- </H3>
|
|
|
- <P>
|
|
|
- I hope that this document has helped you get through the most difficult part of
|
|
|
- using the SDL: installing it. Suggestions for improvements to this document
|
|
|
- should be sent to the writers of this document.
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- Thanks to Paulus Esterhazy ([email protected]), for the work on VC++ port.
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- This document was originally called "VisualC.txt", and was written by <A HREF="mailto:[email protected]">
|
|
|
- Sam Lantinga</A>.
|
|
|
- </P>
|
|
|
- <P>
|
|
|
- Later, it was converted to HTML and expanded into the document that you see
|
|
|
- today by <A HREF="mailto:[email protected]">Lion Kimbro</A>.
|
|
|
- </P>
|
|
|
- <P>Minor Fixes and Visual C++ 7 Information (In Green) was added by <A HREF="mailto:[email protected]">James Turk</A>
|
|
|
- </P>
|
|
|
- </BODY>
|
|
|
-</HTML>
|
erik yuzwa