annotate VisualC.html @ 942:41a59de7f2ed

Here are patches for SDL12 and SDL_mixer for 4 or 6 channel surround sound on Linux using the Alsa driver. To use them, naturally you need a sound card that will do 4 or 6 channels and probably also a recent version of the Alsa drivers and library. Since the only SDL output driver that knows about surround sound is the Alsa driver, you���ll want to choose it, using: export SDL_AUDIODRIVER=alsa There are no syntactic changes to the programming API. No new library calls, no differences in arguments. There are two semantic changes: (1) For library calls with number of channels as an argument, formerly you could use only 1 or 2 for the number of channels. Now you can also use 4 or 6. (2) The two "left" and "right" arguments to Mix_SetPanning, for the case of 4 or 6 channels, no longer simply control the volumes of the left and right channels. Now the "left" argument is converted to an angle and Mix_SetPosition is called, and the "right" argu- ment is ignored. With two exceptions, so far as I know, the modified SDL12 and SDL_mixer work the same way as the original versions, when opened for 1 or 2 channel output. The two exceptions are bugs which I fixed. Well, the first, anyway, is a bug for sure. When rate conversions up or down by a factor of two are applied (in src/audio/SDL_audiocvt.c), streams with different numbers of channels (that is, mono and stereo) are treated the same way: either each sample is copied or every other sample is omitted. This is ok for mono, but for stereo, it is frames that should be copied or omitted, where by "frame" I mean a portion of the stream containing one sample for each channel. (In the SDL source, confusingly, sometimes frames are called "samples".) So for these rate conversions, stereo streams have to be treated differently, and they are, in my modified version. The other problem that might be characterized as a bug arises when SDL_mixer is passed a multichannel chunk which does not have an integral number of frames. Due to the way the effect_position code loops over frames, when the chunk ends with a partial frame, memory outside the chunk buffer will be accessed. In the case of stereo, it���s possible that because malloc may give more memory than requested, this potential problem never actually causes a segment fault. I don���t know. For 6 channel chunks, I do know, and it does cause segment faults. If SDL_mixer is passed defective chunks and this causes a segment fault, arguably, that���s not a bug in SDL_mixer. Still, whether or not it counts as a bug, it���s easy to protect against, so why not? I added code in mixer.c to discard any partial frame at the end of a chunk. Then what about when SDL or SDL_mixer is opened for 4 or 6 chan- nel output? What happens with the parts of the current library designed for stereo? I don���t know whether I���ve covered all the bases, but I���ve tried: (1) For playing 2 channel waves, or other cases where SDL knows it has to match up a 2 channel source with a 4 or 6 channel output, I���ve added code in SDL_audiocvt.c to make the necessary conversions. (2) For playing midis using timidity, I���ve converted timidity to do 4 or 6 channel output, upon request. (3) For playing mods using mikmod, I put ad hoc code in music.c to convert the stereo output that mikmod produces to 4 or 6 chan- nels. Obviously it would be better to change the mikmod code to mix down into 4 or 6 channels, but I have a hard time following the code in mikmod, so I didn���t do that. (4) For playing mp3s, I put ad hoc code in smpeg to copy channels in the case when 4 or 6 channel output is needed. (5) There seems to be no problem with .ogg files - stereo .oggs can be up converted as .wavs are. (6) The effect_position code in SDL_mixer is now generalized to in- clude the cases of 4 and 6 channel streams. I���ve done a very limited amount of compatibility testing for some of the games using SDL I happen to have. For details, see the file TESTS. I���ve put into a separate archive, Surround-SDL-testfiles.tgz, a couple of 6 channel wave files for testing and a 6 channel ogg file. If you have the right hardware and version of Alsa, you should be able to play the wave files with the Alsa utility aplay (and hear all channels, except maybe lfe, for chan-id.wav, since it���s rather faint). Don���t expect aplay to give good sound, though. There���s something wrong with the current version of aplay. The canyon.ogg file is to test loading of 6 channel oggs. After patching and compiling, you can play it with playmus. (My version of ogg123 will not play it, and I had to patch mplayer to get it to play 6 channel oggs.) Greg Lee <greg@ling.lll.hawaii.edu> Thus, July 1, 2004
author Sam Lantinga <slouken@libsdl.org>
date Sat, 21 Aug 2004 12:27:02 +0000
parents 136d97397288
children e044e7c70a50
rev   line source
0
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
1 <HTML>
521
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
2 <HEAD>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
3 <TITLE>Using SDL with Microsoft Visual C++</TITLE>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
4 </HEAD>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
5 <BODY>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
6 <H1>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
7 Using SDL with Microsoft Visual C++ 5,6&nbsp;and 7
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
8 </H1>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
9 <H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
10 by <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro </A>and additions by <A HREF="mailto:james@conceptofzero.net">
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
11 James Turk</A>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
12 </H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
13 <p>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
14 You can either use the precompiled libraries from <A HREF="http://www.libsdl.org/download.php">
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
15 the SDL Download web site </A>, or you can build SDL yourself.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
16 </p>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
17 <H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
18 Building SDL
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
19 </H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
20 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
21 Unzip the <CODE>VisualC.zip</CODE> file into the directory that contains this
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
22 file (<CODE>VisualC.html</CODE>). <STRONG><FONT color="#009900">If you are using Visual
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
23 C++ 7 (.NET) you will need to use the file <code>VisualC7.zip.</code></FONT></STRONG>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
24 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
25 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
26 Be certain that you unzip the zip file for your compiler into <strong>this</strong>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
27 directory and not any other directory. If you are using WinZip, be careful to
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
28 make sure that it extracts to <strong>this</strong> folder, because it's
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
29 convenient feature of unzipping to a folder with the name of the file currently
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
30 being unzipped will get you in trouble if you use it right now. And that's all
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
31 I have to say about that.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
32 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
33 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
34 Now that it's unzipped, go into the VisualC <STRONG><FONT color="#009900">(VisualC7)</FONT></STRONG>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
35 directory that is created, and double-click on the VC++ file "<CODE>SDL.dsw</CODE>"<STRONG><FONT color="#009900">
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
36 ("<CODE>SDL.sln</CODE>").</FONT></STRONG> This should open up the IDE.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
37 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
38 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
39 You may be prompted at this point to upgrade the workspace, should you be using
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
40 a more recent version of Visual C++. If so, allow the workspace to be upgraded.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
41 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
42 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
43 Build the <CODE>.dll</CODE> and <CODE>.lib</CODE> files.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
44 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
45 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
46 This is done by right clicking on each project in turn (Projects are listed in
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
47 the Workspace panel in the FileView tab), and selecting "Build".
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
48 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
49 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
50 You may get a few warnings, but you should not get any errors. You do have to
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
51 have at least the DirectX 5 SDK installed, however. The latest
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
52 version of DirectX can be downloaded or purchased on a cheap CD (my
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
53 recommendation) from <A HREF="http://www.microsoft.com">Microsoft </A>.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
54 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
55 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
56 Later, we will refer to the following .lib and .dll files that have just been
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
57 generated:
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
58 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
59 <ul>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
60 <li> SDL.dll</li>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
61 <li> SDL.lib</li>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
62 <li> SDLmain.lib</li>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
63 </ul>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
64 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
65 Search for these using the Windows Find (Windows-F) utility, if you don't
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
66 already know where they should be. For those of you with a clue, look inside
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
67 the Debug or Release directories of the subdirectories of the Project folder.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
68 (It might be easier to just use Windows Find if this sounds confusing. And
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
69 don't worry about needing a clue; we all need visits from the clue fairy
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
70 frequently.)
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
71 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
72 <H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
73 Creating a Project with SDL
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
74 </H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
75 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
76 Create a project as a Win32 Application.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
77 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
78 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
79 Create a C++ file for your project.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
80 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
81 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
82 Set the C runtime to "Multi-threaded DLL" in the menu: <CODE>Project|Settings|C/C++
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
83 tab|Code Generation|Runtime Library </CODE>.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
84 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
85 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
86 Add the SDL <CODE>include</CODE> directory to your list of includes in the
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
87 menu: <CODE>Project|Settings|C/C++ tab|Preprocessor|Additional include directories </CODE>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
88 .
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
89 <br>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
90 <STRONG><FONT color="#009900">VC7 Specific: Instead of doing this I find it easier to
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
91 add the include and library directories to the list that VC7 keeps. Do this by
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
92 selecting Tools|Options|Projects|VC++ Directories and under the "Show
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
93 Directories For:" dropbox select "Include Files", and click the "New Directory
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
94 Icon" and add the [SDLROOT]\include directory (ex. If you installed to
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
95 c:\SDL-1.2.5\ add c:\SDL-1.2.5\include).&nbsp;Proceed to&nbsp;change the
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
96 dropbox selection to "Library Files" and add [SDLROOT]\lib.</FONT></STRONG>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
97 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
98 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
99 The "include directory" I am referring to is the <CODE>include</CODE> folder
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
100 within the main SDL directory (the one that this HTML file located within).
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
101 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
102 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
103 Now we're going to use the files that we had created earlier in the Build SDL
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
104 step.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
105 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
106 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
107 Copy the following files into your Project directory:
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
108 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
109 <ul>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
110 <li> SDL.dll</li>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
111 </ul>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
112 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
113 Add the following files to your project (It is not necessary to copy them to
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
114 your project directory):
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
115 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
116 <ul>
0
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
117 <li> SDL.lib </li>
521
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
118 <li> SDLmain.lib</li>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
119 </ul>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
120 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
121 (To add them to your project, right click on your project, and select "Add
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
122 files to project")
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
123 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
124 <P><STRONG><FONT color="#009900">Instead of adding the files to your project it is more
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
125 desireable to add them to the linker options: Project|Properties|Linker|Command
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
126 Line and type the names of the libraries to link with in the "Additional
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
127 Options:" box.&nbsp; Note: This must be done&nbsp;for&nbsp;each&nbsp;build
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
128 configuration (eg. Release,Debug).</FONT></STRONG></P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
129 <H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
130 SDL 101, First Day of Class
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
131 </H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
132 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
133 Now create the basic body of your project. The body of your program should take
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
134 the following form: <CODE>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
135 <PRE>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
136 #include "SDL.h"
0
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
137
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
138 int main( int argc, char* argv[] )
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
139 {
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
140 // Body of the program goes here.
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
141 return 0;
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
142 }
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
143 </PRE>
521
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
144 </CODE>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
145 <P></P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
146 <H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
147 That's it!
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
148 </H3>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
149 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
150 I hope that this document has helped you get through the most difficult part of
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
151 using the SDL: installing it. Suggestions for improvements to this document
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
152 should be sent to the writers of this document.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
153 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
154 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
155 Thanks to Paulus Esterhazy (pesterhazy@gmx.net), for the work on VC++ port.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
156 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
157 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
158 This document was originally called "VisualC.txt", and was written by <A HREF="mailto:slouken@libsdl.org">
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
159 Sam Lantinga</A>.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
160 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
161 <P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
162 Later, it was converted to HTML and expanded into the document that you see
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
163 today by <A HREF="mailto:snowlion@sprynet.com">Lion Kimbro</A>.
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
164 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
165 <P>Minor Fixes and Visual C++ 7 Information (In Green) was added by <A HREF="mailto:james@conceptofzero.net">James Turk</A>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
166 </P>
136d97397288 Added Visual C++ 7 (.NET) projects (thanks James!)
Sam Lantinga <slouken@libsdl.org>
parents: 368
diff changeset
167 </BODY>
0
74212992fb08 Initial revision
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
168 </HTML>