VisualC.html - third_party/sdl - Git at Google

 <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>
	<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). 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 (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>