Mercurial > sdl-ios-xcode
diff VisualC.html @ 0:74212992fb08
Initial revision
| author | Sam Lantinga <slouken@lokigames.com> |
|---|---|
| date | Thu, 26 Apr 2001 16:45:43 +0000 |
| parents | |
| children | 180837a1db89 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/VisualC.html Thu Apr 26 16:45:43 2001 +0000 @@ -0,0 +1,235 @@ +<HTML> + + + +<HEAD> + + + +<TITLE> Using SDL with Microsoft Visual C++ 5 and 6 </TITLE> + + + +</HEAD> + + + +<BODY> + + + +<H1> Using SDL with Microsoft Visual C++ 5 and 6 </H1> + +<H3> + by <A HREF="mailto:snowlion@sprynet.com"> Lion Kimbro </A> +</H3> + + + +<p> + You can either use the precompiled libraries from + <A HREF="http://www.libsdl.org/download.html"> + the SDL Download web site </A>, + or you can build SDL yourself. +</p> + + +<H3> Building SDL </H3> + +<P> + Unzip the <CODE>VisualC.zip</CODE> file into the directory + that contains this file (<CODE>VisualC.html</CODE>). +</P> + +<P> + Be certain that you unzip <CODE> VisualC.zip </CODE> + into <strong>this</strong> directory and not any other + directory. If you are using WinZip, be careful to + make sure that it extracts to <strong>this</strong> + folder, because it's convenient feature of + unzipping to a folder with the name of the + file currently being unzipped will get you in + trouble if you use it right now. And that's all + I have to say about that. +</P> + +<P> + Now that it's unzipped, go into the VisualC directory + that is created, and double-click on the VC++ + workspace file "<CODE>SDL.dsw</CODE>". + This should open up VisualC. +</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. +</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 + 5 SDK installed, however. (I believe...) 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>. +</P> + +<P> + Later, we will refer to the following .lib and .dll + files that have just been generated: +</P> + + <list> + <li> SDL.dll + <li> SDL.lib + <li> SDLmain.lib + </list> + +<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 + VisualC 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.) +</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>. +</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> + + <list> + <li> SDL.dll </li> + </list> + +<P> + Copy the following files into your Project directory, + and <em>add them to your Project</em> as well: +</P> + + <list> + <li> SDL.lib </li> + <li> SDLmain.lib </li> + </list> + +<P> + (To add them to your project, right click on your + project, and select "Add files to project") +</P> + +<P> + (I believe that it's not necessary to actually + copy the .lib files into your directory; you only + have to be certain that you add them to your Project. + If someone is so inclined, correct this document, or + <A HREF="mailto:snowlion@sprynet.com"> + e-mail me </A>, + and I'll fix this document.) +</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> +#include "SDL.h" + +int main( int argc, char* argv[] ) +{ + // Body of the program goes here. + return 0; +} +</PRE> +</CODE> +</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> + + + +</BODY> + + + +</HTML> + +