antkeeper
/
superbuild

<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: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.		</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).&nbsp;Proceed to&nbsp;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.&nbsp; Note: This must be done&nbsp;for&nbsp;each&nbsp;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 (pesterhazy@gmx.net), for the work on VC++ port.		</P>		<P>			This document was originally called "VisualC.txt", and was written by <A HREF="mailto:slouken@libsdl.org">				Sam Lantinga</A>.		</P>		<P>			Later, it was converted to HTML and expanded into the document that you see 			today by <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro</A>.		</P>		<P>Minor Fixes and Visual C++ 7 Information (In Green) was added by <A HREF="mailto:james@conceptofzero.net">James Turk</A>		</P>	</BODY></HTML>