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