| 1 | <HTML> |
| 2 | <HEAD> |
| 3 | <TITLE>Using SDL with Microsoft Visual C++</TITLE> |
| 4 | </HEAD> |
| 5 | <BODY> |
| 6 | <H1> |
| 7 | Using SDL with Microsoft Visual C++ 5,6 and 7 |
| 8 | </H1> |
| 9 | <H3> |
| 10 | by <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro </A>and additions by <A HREF="mailto:james@conceptofzero.net"> |
| 11 | James Turk</A> |
| 12 | </H3> |
| 13 | <p> |
| 14 | You can either use the precompiled libraries from <A HREF="http://www.libsdl.org/download.php"> |
| 15 | the SDL Download web site </A>, or you can build SDL yourself. |
| 16 | </p> |
| 17 | <H3> |
| 18 | Building SDL |
| 19 | </H3> |
| 20 | <P> |
| 21 | Unzip the <CODE>VisualC.zip</CODE> file into the directory that contains this |
| 22 | file (<CODE>VisualC.html</CODE>). |
| 23 | </P> |
| 24 | <P> |
| 25 | Be certain that you unzip the zip file for your compiler into <strong>this</strong> |
| 26 | directory and not any other directory. If you are using WinZip, be careful to |
| 27 | make sure that it extracts to <strong>this</strong> folder, because it's |
| 28 | convenient feature of unzipping to a folder with the name of the file currently |
| 29 | being unzipped will get you in trouble if you use it right now. And that's all |
| 30 | I have to say about that. |
| 31 | </P> |
| 32 | <P> |
| 33 | Now that it's unzipped, go into the VisualC |
| 34 | directory that is created, and double-click on the VC++ file "<CODE>SDL.dsw</CODE>"<STRONG><FONT color="#009900"> |
| 35 | ("<CODE>SDL.sln</CODE>").</FONT></STRONG> This should open up the IDE. |
| 36 | </P> |
| 37 | <P> |
| 38 | You may be prompted at this point to upgrade the workspace, should you be using |
| 39 | a more recent version of Visual C++. If so, allow the workspace to be upgraded. |
| 40 | </P> |
| 41 | <P> |
| 42 | Build the <CODE>.dll</CODE> and <CODE>.lib</CODE> files. |
| 43 | </P> |
| 44 | <P> |
| 45 | This is done by right clicking on each project in turn (Projects are listed in |
| 46 | the Workspace panel in the FileView tab), and selecting "Build". |
| 47 | </P> |
| 48 | <P> |
| 49 | If you get an error about SDL_config.h being missing, you should |
| 50 | copy include/SDL_config.h.default to include/SDL_config.h and try again. |
| 51 | </P> |
| 52 | <P> |
| 53 | You may get a few warnings, but you should not get any errors. You do have to |
| 54 | have at least the DirectX 5 SDK installed, however. The latest |
| 55 | version of DirectX can be downloaded or purchased on a cheap CD (my |
| 56 | recommendation) from <A HREF="http://www.microsoft.com">Microsoft </A>. |
| 57 | </P> |
| 58 | <P> |
| 59 | Later, we will refer to the following .lib and .dll files that have just been |
| 60 | generated: |
| 61 | </P> |
| 62 | <ul> |
| 63 | <li> SDL.dll</li> |
| 64 | <li> SDL.lib</li> |
| 65 | <li> SDLmain.lib</li> |
| 66 | </ul> |
| 67 | <P> |
| 68 | Search for these using the Windows Find (Windows-F) utility, if you don't |
| 69 | already know where they should be. For those of you with a clue, look inside |
| 70 | the Debug or Release directories of the subdirectories of the Project folder. |
| 71 | (It might be easier to just use Windows Find if this sounds confusing. And |
| 72 | don't worry about needing a clue; we all need visits from the clue fairy |
| 73 | frequently.) |
| 74 | </P> |
| 75 | <H3> |
| 76 | Creating a Project with SDL |
| 77 | </H3> |
| 78 | <P> |
| 79 | Create a project as a Win32 Application. |
| 80 | </P> |
| 81 | <P> |
| 82 | Create a C++ file for your project. |
| 83 | </P> |
| 84 | <P> |
| 85 | Set the C runtime to "Multi-threaded DLL" in the menu: <CODE>Project|Settings|C/C++ |
| 86 | tab|Code Generation|Runtime Library </CODE>. |
| 87 | </P> |
| 88 | <P> |
| 89 | Add the SDL <CODE>include</CODE> directory to your list of includes in the |
| 90 | menu: <CODE>Project|Settings|C/C++ tab|Preprocessor|Additional include directories </CODE> |
| 91 | . |
| 92 | <br> |
| 93 | <STRONG><FONT color="#009900">VC7 Specific: Instead of doing this I find it easier to |
| 94 | add the include and library directories to the list that VC7 keeps. Do this by |
| 95 | selecting Tools|Options|Projects|VC++ Directories and under the "Show |
| 96 | Directories For:" dropbox select "Include Files", and click the "New Directory |
| 97 | Icon" and add the [SDLROOT]\include directory (ex. If you installed to |
| 98 | c:\SDL-1.2.5\ add c:\SDL-1.2.5\include). Proceed to change the |
| 99 | dropbox selection to "Library Files" and add [SDLROOT]\lib.</FONT></STRONG> |
| 100 | </P> |
| 101 | <P> |
| 102 | The "include directory" I am referring to is the <CODE>include</CODE> folder |
| 103 | within the main SDL directory (the one that this HTML file located within). |
| 104 | </P> |
| 105 | <P> |
| 106 | Now we're going to use the files that we had created earlier in the Build SDL |
| 107 | step. |
| 108 | </P> |
| 109 | <P> |
| 110 | Copy the following files into your Project directory: |
| 111 | </P> |
| 112 | <ul> |
| 113 | <li> SDL.dll</li> |
| 114 | </ul> |
| 115 | <P> |
| 116 | Add the following files to your project (It is not necessary to copy them to |
| 117 | your project directory): |
| 118 | </P> |
| 119 | <ul> |
| 120 | <li> SDL.lib </li> |
| 121 | <li> SDLmain.lib</li> |
| 122 | </ul> |
| 123 | <P> |
| 124 | (To add them to your project, right click on your project, and select "Add |
| 125 | files to project") |
| 126 | </P> |
| 127 | <P><STRONG><FONT color="#009900">Instead of adding the files to your project it is more |
| 128 | desireable to add them to the linker options: Project|Properties|Linker|Command |
| 129 | Line and type the names of the libraries to link with in the "Additional |
| 130 | Options:" box. Note: This must be done for each build |
| 131 | configuration (eg. Release,Debug).</FONT></STRONG></P> |
| 132 | <H3> |
| 133 | SDL 101, First Day of Class |
| 134 | </H3> |
| 135 | <P> |
| 136 | Now create the basic body of your project. The body of your program should take |
| 137 | the following form: <CODE> |
| 138 | <PRE> |
| 139 | #include "SDL.h" |
| 140 | |
| 141 | int main( int argc, char* argv[] ) |
| 142 | { |
| 143 | // Body of the program goes here. |
| 144 | return 0; |
| 145 | } |
| 146 | </PRE> |
| 147 | </CODE> |
| 148 | <P></P> |
| 149 | <H3> |
| 150 | That's it! |
| 151 | </H3> |
| 152 | <P> |
| 153 | I hope that this document has helped you get through the most difficult part of |
| 154 | using the SDL: installing it. Suggestions for improvements to this document |
| 155 | should be sent to the writers of this document. |
| 156 | </P> |
| 157 | <P> |
| 158 | Thanks to Paulus Esterhazy (pesterhazy@gmx.net), for the work on VC++ port. |
| 159 | </P> |
| 160 | <P> |
| 161 | This document was originally called "VisualC.txt", and was written by <A HREF="mailto:slouken@libsdl.org"> |
| 162 | Sam Lantinga</A>. |
| 163 | </P> |
| 164 | <P> |
| 165 | Later, it was converted to HTML and expanded into the document that you see |
| 166 | today by <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro</A>. |
| 167 | </P> |
| 168 | <P>Minor Fixes and Visual C++ 7 Information (In Green) was added by <A HREF="mailto:james@conceptofzero.net">James Turk</A> |
| 169 | </P> |
| 170 | </BODY> |
| 171 | </HTML> |