http://ioquake.org/forums/viewtopic.php?f=12&t=60


Credit goes to DevHC, ensiform, GreyGhost, benmachine, kevlarman, and the rest of the #ioquake3 IRC denizens.  Keepin' it real one ASCII gang sign at a time!


This should work for XP and Vista. Tested on WinXP but it will probably work on Vista.


Installing Visual Studio 2008:

1) go to http://www.microsoft.com/express/download/ and scroll to the bottom of the page, find the Offline Install, choose the language of your choice, and click Download.  Download the file into c:\temp\vs2008exp\
2) follow the instructions at http://www.microsoft.com/express/download/offline.aspx to install the program--I mounted the ISO in a virtual CD and installed from there, but you can burn it to a DVD-R or extract the files, whatever floats your boat.
3) run the installer, all you need is "Visual C++ 2008 Express Edition" and nothing else.  I unchecked "Allow Visual Studio to receive and display online RSS content" and I did NOT install the optional installs of Microsoft Silverlight Runtime and Microsoft SQL Server 2008 Express Edition (x86).  Install to default directories, etc.  
4) VS2008 will litter your hard drive with a stupid temporary directory, feel free to delete it.  For reference, mine was C:\1514b1b9a0b983757ae90709a18b\
5) download http://libsdl.org/release/SDL-devel-1.2.13-VC8.zip to c:\temp\sdl\
6) extract SDL-devel-1.2.13-VC8.zip into c:\temp\sdl\
7) copy *.lib from C:\temp\SDL-1.2.13\lib to C:\Program Files\Microsoft Visual Studio 9.0\VC\lib (should be SDL.lib and SDLmain.lib)
8) download http://tortoisesvn.net/downloads into c:\temp\svn\
9) run the installer with all the defaults, reboot when it tells you to
10) make the folder c:\ioq3-vs2008
11) right-click that folder and choose "SVN Checkout", use the URL of repository to be svn://svn.icculus.org/quake3/trunk
12) leave everything else as default and click the OK button; you should start getting source unless svn is down/broken
13) VS2008 installs the parts of the Windows SDK that it needs, so we don't need to install that or configure it.


Setting up your compilin' environment:

1) Load VS2008, go to File and choose Open and then Project/Solution... and select C:\ioq3-vs2008\misc\msvc\ioq3.sln
2) It will run you through an import wizard.  Basically you'll get an option to create backups before converting or not.  I lived dangerously and didn't bother.
3) Once your "solution" has loaded, go to Build and choose Configuration Manager... and make sure the drop-down menu says "Release"; mine was defaulted to "Debug TA".
4) Right-click on the "quake3" entry in the Solution Explorer in the upper-left and select Properties.
5) Instead of dynamically linking the microsoft libraries, we are going to statically link them.
6) Under the Configuration Manager tree, click on General
7) In the Project Defaults section, Use of MFC should be "Use MFC in a Static Library"
8) When compiling, you will get warnings about LIBCMT and OleAcc.dll, but the binary will build fine and should work on systems without requiring the microsoft DLLs to be included as well.
9) You can research /NODEFAULTLIB: and other things if those LINK warnings bother you, but the resulting binary seems to work fine.
10) Under the Configuration Manager tree, expand the C/C++ tree and click on General
11) Additional Include Directories should include: ..\..\code\SDL12\include; ..\..\code\libcurl; ..\..\code\AL; ..\..\code\libspeex\include
12) Under the Configuration Manager tree, expand the C/C++ tree and click on Preprocessor
13) Preprocessor Definitions should be: WIN32; NDEBUG; _WINDOWS; _CRT_SECURE_NO_DEPRECATE; BOTLIB; USE_ICON; USE_CURL; USE_CURL_DLOPEN; USE_LOCAL_HEADERS; USE_VOIP; HAVE_CONFIG_H
14) Under the Configuration Manager tree, expand the Linker tree and click on Input
15) Additional Dependencies should be: user32.lib advapi32.lib winmm.lib wsock32.lib ws2_32.lib SDLmain.lib SDL.lib OpenGL32.lib msvcrt.lib
16) Hit the "Apply" button and close VS2008 to make sure everything is saved before you start messing things up.
17) Go back into VS2008, open the ioquake3 solution, right-click the "quake3" project, and Add a New Filter.  Call it "speex".
18) Open a windows explorer and go to C:\ioq3-vs2008\code\libspeex\ and then sort by file type.  The .c files should be first followed by the .h files.  Drag all the .c files into the speex folder in VS2008, it should import them all.  Remove test*.c from the speex folder, though, as ioquake3 doesn't use them.  Additionally, drag the config.h file into the speex folder as well.  So you will have a bunch of .c files and config.h in the VS2008 "speex" folder/filter.  
19) Close VS2008 to make sure everything is saved before you start messing things up.


Compiling the sucker:

1) Load VS2008, go to File and choose Open and then Project/Solution... and select C:\ioq3-vs2008\misc\msvc\ioq3.sln
2) Once your "solution" has loaded, right-click on "Solution 'ioq3'" in the upper-left Solution Explorer window and select "Build". If you want to rebuild things fresh, select "Rebuild".
3) You should get warnings in your Output window, but the only really important part is the last line which should look something like ========== Rebuild All: 4 succeeded, 1 failed, 0 skipped ==========
4) the ui module will fail, but it wasn't going to get compiled anyway (unless you added code to make it be used) so you can safely ignore this error.  If you are trying to get ui working (rather than q3_ui), well, that's a different issue... this only deals with compiling straight out of SVN.
5) compiling depends on how much RAM you have and how fast your computer is. So it could go quickly or take forever. 
6) when you're done compiling, you should have the compiled files in:
C:\ioq3-vs2008\build\quake3_release\ioquake3.exe
C:\ioq3-vs2008\build\cgame_release\cgamex86.dll
C:\ioq3-vs2008\build\game_release\qagamex86.dll
C:\ioq3-vs2008\build\q3_ui_release\uix86.dll


Common problems:

1) Speex files generate a ton of warnings.  The main speex project disables these specifically, though you may or may not want to.  If you want to disable these warnings specifically, open up the properties of the "quake3" project, go to Configuration Properties, then to C/C++, then to Advanced, and in the Disable Specific Warnings field, type: 4244;4305;4311;4100;4127  When done, apply this to save it and you should get less chatter.  I went from 550 warnings down to 73 warnings.  Since the speex people themselves don't care about these warnings (else I assume they'd have fixed them), they probably aren't too important.  You can also add ones that are related to the JPEG code as well, such as 4245, 4389, 4706 or even 4201 for some warnings from the Platform SDK.  Again, the more warnings you exclude, the more errors or bugs might make their way into your code because you're suppressing the compiler telling you about them, but it might make finding major errors/bugs easier.
2) If you get an error about files in \code\jpeg-6 being missing, it's because they were moved to \code\jpeg-6b just to mess with you. To fix it, go to your Solution Explorer window in the upper-left, expand the quake3 tree, expand the jpeg tree, and expand the Header Files and Source Files trees. Delete the .h and .c files. We'll have to re-add them manually.
3) Open a windows explorer and go to C:\ioq3-vs2008\code\jpeg-6b\ and then sort by file type. The .c files should be first followed by the .h files. Drag all the .h files into the Header Files folder in VS2008, it should import them all. Drag all the .c files into the Source Files folder in VS2008, it should import them all.
4) You will need to remove some of the .c files before you're done with this fix. You do this by clicking once to highlight one of the .c files and then pressing the delete key once. To see which files you need to keep, look in C:\ioq3-vs2008\ and load the file "Makefile" in something like WordPad to preserve the Unix formatting. If you use NotePad, it comes out looking garbled. Anyway, search the file for "jcapimin". This should bring you to a section with a bunch of j-ish files starting with jcapimin.o and ending with jutils.o. Pretend these are .c files and these should be the ONLY files in your VS2008 project. That means, delete the files you just added that aren't in the list in the Makefile.
5) For example, the files I ended up deleting:
jctrans.c
jdatadst.c
jdmerge.c
jdphuff.c
jfdctfst.c
jfdctint.c
jidctfst.c
jidctint.c
jidctred.c
jload.c
jmemansi.c
jmemdos.c
jmemname.c
jpegtran.c
jquant1.c
jquant2.c


Using your compiled files:

1) I installed Quake 3 into, say, c:\program files\quake3, then installed the latest patches. I then installed ioquake3 into that same folder. I copied the whole install from c:\program files\quake3 to something like c:\program files\devquake3 so I could mess around and not ruin my regular game install.
2) since the needed SDL and OpenAL .dll files were already installed with ioquake3, all you need to copy over are the .exe and new .dll files when you want to test them in your \devquake3 install.
3) in case you're wondering, for the devquake3 example:
c:\Program Files\devquake3\ <--- put the .exe here
c:\Program Files\devquake3\baseq3 <--- put the .dll files here
c:\Program Files\devquake3\missionpack <--- put the .dll files here
4) if you are trying to install your VS2008-compiled files on a machine that doesn't have VS2008 on it, you may need to have that machine or user install "Microsoft Visual C++ 2008 SP1 Redistributable Package (x86)" if they are getting errors when trying to run the program you compiled. If you have some users who get the errors and some who don't, the ones who don't probably had another program already install this silently and just never informed the user. You can find this at: http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en
5) ...
6) profit!


A pre-made quake3.vcproj for lazy people:

1) https://bugzilla.icculus.org/show_bug.cgi?id=3771
2) right-click and save as for the attachment, it will want to save it as XML but you can rename it to quake3.vcproj 
3) so you set up your stuff and then shove this in there and it does all the stuff you'd normally do in the VS2008 tinkering.