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@7229
|
7 |
Using SDL with Microsoft Visual C++
|
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@7229
|
14 |
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.
|
slouken@521
|
15 |
</p>
|
slouken@521
|
16 |
<H3>
|
slouken@521
|
17 |
Building SDL
|
slouken@521
|
18 |
</H3>
|
slouken@521
|
19 |
<P>
|
slouken@7229
|
20 |
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.
|
slouken@521
|
21 |
</P>
|
slouken@521
|
22 |
<P>
|
aschiffler@7314
|
23 |
There are different solution files for the various
|
aschiffler@7314
|
24 |
versions of the IDE. Please use the appropiate version
|
slouken@8849
|
25 |
2008, 2010, 2012 or 2013.
|
aschiffler@7314
|
26 |
</P>
|
aschiffler@7314
|
27 |
<P>
|
slouken@521
|
28 |
Build the <CODE>.dll</CODE> and <CODE>.lib</CODE> files.
|
slouken@521
|
29 |
</P>
|
slouken@521
|
30 |
<P>
|
slouken@521
|
31 |
This is done by right clicking on each project in turn (Projects are listed in
|
slouken@521
|
32 |
the Workspace panel in the FileView tab), and selecting "Build".
|
slouken@521
|
33 |
</P>
|
slouken@521
|
34 |
<P>
|
slouken@521
|
35 |
You may get a few warnings, but you should not get any errors. You do have to
|
slouken@7229
|
36 |
have at least the DirectX 9 SDK installed, however. The latest
|
slouken@7229
|
37 |
version of DirectX can be downloaded from <A HREF="http://www.microsoft.com">Microsoft</A>.
|
slouken@521
|
38 |
</P>
|
slouken@521
|
39 |
<P>
|
slouken@521
|
40 |
Later, we will refer to the following .lib and .dll files that have just been
|
slouken@521
|
41 |
generated:
|
slouken@521
|
42 |
</P>
|
slouken@521
|
43 |
<ul>
|
slouken@7229
|
44 |
<li> SDL2.dll</li>
|
slouken@7229
|
45 |
<li> SDL2.lib</li>
|
slouken@7229
|
46 |
<li> SDL2main.lib</li>
|
slouken@521
|
47 |
</ul>
|
slouken@521
|
48 |
<P>
|
slouken@7229
|
49 |
Search for these using the Windows Find (Windows-F) utility inside the VisualC directory.
|
slouken@521
|
50 |
</P>
|
slouken@521
|
51 |
<H3>
|
slouken@521
|
52 |
Creating a Project with SDL
|
slouken@521
|
53 |
</H3>
|
slouken@521
|
54 |
<P>
|
slouken@521
|
55 |
Create a project as a Win32 Application.
|
slouken@521
|
56 |
</P>
|
slouken@521
|
57 |
<P>
|
slouken@521
|
58 |
Create a C++ file for your project.
|
slouken@521
|
59 |
</P>
|
slouken@521
|
60 |
<P>
|
slouken@521
|
61 |
Set the C runtime to "Multi-threaded DLL" in the menu: <CODE>Project|Settings|C/C++
|
slouken@521
|
62 |
tab|Code Generation|Runtime Library </CODE>.
|
slouken@521
|
63 |
</P>
|
slouken@521
|
64 |
<P>
|
slouken@521
|
65 |
Add the SDL <CODE>include</CODE> directory to your list of includes in the
|
slouken@521
|
66 |
menu: <CODE>Project|Settings|C/C++ tab|Preprocessor|Additional include directories </CODE>
|
slouken@521
|
67 |
.
|
slouken@521
|
68 |
<br>
|
slouken@521
|
69 |
<STRONG><FONT color="#009900">VC7 Specific: Instead of doing this I find it easier to
|
slouken@521
|
70 |
add the include and library directories to the list that VC7 keeps. Do this by
|
slouken@521
|
71 |
selecting Tools|Options|Projects|VC++ Directories and under the "Show
|
slouken@521
|
72 |
Directories For:" dropbox select "Include Files", and click the "New Directory
|
philipp@7338
|
73 |
Icon" and add the [SDLROOT]\include directory (e.g. If you installed to
|
philipp@7338
|
74 |
c:\SDL\ add c:\SDL\include). Proceed to change the
|
slouken@521
|
75 |
dropbox selection to "Library Files" and add [SDLROOT]\lib.</FONT></STRONG>
|
slouken@521
|
76 |
</P>
|
slouken@521
|
77 |
<P>
|
slouken@521
|
78 |
The "include directory" I am referring to is the <CODE>include</CODE> folder
|
slouken@521
|
79 |
within the main SDL directory (the one that this HTML file located within).
|
slouken@521
|
80 |
</P>
|
slouken@521
|
81 |
<P>
|
slouken@521
|
82 |
Now we're going to use the files that we had created earlier in the Build SDL
|
slouken@521
|
83 |
step.
|
slouken@521
|
84 |
</P>
|
slouken@521
|
85 |
<P>
|
slouken@521
|
86 |
Copy the following files into your Project directory:
|
slouken@521
|
87 |
</P>
|
slouken@521
|
88 |
<ul>
|
slouken@7229
|
89 |
<li> SDL2.dll</li>
|
slouken@521
|
90 |
</ul>
|
slouken@521
|
91 |
<P>
|
slouken@521
|
92 |
Add the following files to your project (It is not necessary to copy them to
|
slouken@521
|
93 |
your project directory):
|
slouken@521
|
94 |
</P>
|
slouken@521
|
95 |
<ul>
|
slouken@7229
|
96 |
<li> SDL2.lib </li>
|
slouken@7229
|
97 |
<li> SDL2main.lib</li>
|
slouken@521
|
98 |
</ul>
|
slouken@521
|
99 |
<P>
|
slouken@521
|
100 |
(To add them to your project, right click on your project, and select "Add
|
slouken@521
|
101 |
files to project")
|
slouken@521
|
102 |
</P>
|
slouken@521
|
103 |
<P><STRONG><FONT color="#009900">Instead of adding the files to your project it is more
|
slouken@521
|
104 |
desireable to add them to the linker options: Project|Properties|Linker|Command
|
slouken@521
|
105 |
Line and type the names of the libraries to link with in the "Additional
|
slouken@521
|
106 |
Options:" box. Note: This must be done for each build
|
philipp@7338
|
107 |
configuration (e.g. Release,Debug).</FONT></STRONG></P>
|
slouken@521
|
108 |
<H3>
|
slouken@521
|
109 |
SDL 101, First Day of Class
|
slouken@521
|
110 |
</H3>
|
slouken@521
|
111 |
<P>
|
slouken@521
|
112 |
Now create the basic body of your project. The body of your program should take
|
philipp@8855
|
113 |
the following form:
|
philipp@8855
|
114 |
<PRE><CODE>
|
philipp@7338
|
115 |
#include "SDL.h"
|
slouken@0
|
116 |
|
slouken@0
|
117 |
int main( int argc, char* argv[] )
|
slouken@0
|
118 |
{
|
slouken@0
|
119 |
// Body of the program goes here.
|
slouken@0
|
120 |
return 0;
|
slouken@0
|
121 |
}
|
philipp@8855
|
122 |
</CODE></PRE>
|
slouken@521
|
123 |
<P></P>
|
slouken@521
|
124 |
<H3>
|
slouken@521
|
125 |
That's it!
|
slouken@521
|
126 |
</H3>
|
slouken@521
|
127 |
<P>
|
slouken@521
|
128 |
I hope that this document has helped you get through the most difficult part of
|
slouken@521
|
129 |
using the SDL: installing it. Suggestions for improvements to this document
|
slouken@521
|
130 |
should be sent to the writers of this document.
|
slouken@521
|
131 |
</P>
|
slouken@521
|
132 |
<P>
|
slouken@521
|
133 |
Thanks to Paulus Esterhazy (pesterhazy@gmx.net), for the work on VC++ port.
|
slouken@521
|
134 |
</P>
|
slouken@521
|
135 |
<P>
|
slouken@521
|
136 |
This document was originally called "VisualC.txt", and was written by <A HREF="mailto:slouken@libsdl.org">
|
slouken@521
|
137 |
Sam Lantinga</A>.
|
slouken@521
|
138 |
</P>
|
slouken@521
|
139 |
<P>
|
slouken@521
|
140 |
Later, it was converted to HTML and expanded into the document that you see
|
slouken@521
|
141 |
today by <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro</A>.
|
slouken@521
|
142 |
</P>
|
slouken@521
|
143 |
<P>Minor Fixes and Visual C++ 7 Information (In Green) was added by <A HREF="mailto:james@conceptofzero.net">James Turk</A>
|
slouken@521
|
144 |
</P>
|
slouken@521
|
145 |
</BODY>
|
slouken@0
|
146 |
</HTML>
|