This tutorial is intended to aid in building Scorched 3D with Visual Studio (more importantly, Visual Studio 2005). If you are new to compiling, I suggest you start at Step 1. If you've compiled Windows Applications before, skip to step 6.
1- Download and install MS Visual C++ 2005 from microsoft (free until november 2006, so hurry up)
Choose either 1 of those links, the one that suits more your needs
Download web installer (recommended from Microsoft but should only be considered by dial-up users) 2.9 MB + additional download
When asked what to install, you only need to install the Graphical IDE to to merely get Scorched to compile which should be about 70MB.
Download full installer CD-Rom ISO image (recommended by me but not from microsoft) 445MB
Download full installer CD-Rom IMG image (recommended by me but not from microsoft) 445MB
2- Download & install the microsoft platform SDK
Web installer download page scroll until you reach the bottom and search for your processor architecture. (again this should only be considered by dial-up users) 1.2MB + additional download
When asked what to install, make sure to choose a custom install and select all options EXCEPT for ones having to do with Documentation, Sample Code, or any 64 bit options.
Download full installer CD-Rom IMG image (again i recommend this) 409.9 MB
3- go the VC menu tools, then go to options, the select Projects & solutions, then select VC++ directories
Add the paths to the appropriate subsection:
Executable files: C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Bin
Include files: C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Include
Library files: C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Lib
Note: Alternatively, you can update the Visual C++ Directories by modifying the VCProjectEngine.dll.express.config file located in the \vc\vcpackages subdirectory of the Visual C++ Express install location. Please make sure that you also delete the file "vccomponents.dat" located in the "%USERPROFILE%\Local Settings\Application Data\Microsoft\VCExpress\8.0" if it exists before restarting Visual C++ Express Edition.
4- Update the corewin_express.vsprops file.
One more step is needed to make the Win32 template work in Visual C++ Express. You need to edit the corewin_express.vsprops file (found in C:\Program Files\Microsoft Visual Studio 8\VC\VCProjectDefaults) and
Change the string that reads:
AdditionalDependencies="kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib"
Additionally, to subdue the deprecation warnings, you can change the VCCLCompilerTool line so that it reads:
<Tool Name="VCCLCompilerTool" PreprocessorDefinitions="_CRT_SECURE_NO_DEPRECATE;_CRT_NONSTDC_NO_DEPRECATE"/>
5- Enable Win32 Application Type
In Visual C++ Express, the Win32 Windows Application type is disabled in the Win32 Application Wizard. To enable that type, you need to edit the file AppSettings.htm file located in the folder “%ProgramFiles%\Microsoft Visual Studio 8\VC\VCWizards\AppWiz\Generic\Application\html\1033\".
In a text editor comment out lines 441 - 444 by putting a // in front of them as shown here:
// WIN_APP.disabled = true; // WIN_APP_LABEL.disabled = true; // DLL_APP.disabled = true; // DLL_APP_LABEL.disabled = true;
Save and close the file and open Visual C++ Express.
6- open the scorched project file (you must download all CVS files first) and convert it to VS
7- Choose either debug (there may be problems experienced when compiling using debug in VS 2005) or release (should be considered the default option) from the drop down at the top of the page.
8- Right click on the scorched icon in the file viewer in the left hand side and choose properties from the pop-up menu.
Choose debuging and change the working directory to : ..\..
Choose Linker/input and edit the aditional dependancies.
dxguid.lib (This is very important. If not removed, Scorched will crash when you try to run it.)
Add (if not listed):-
User32.lib Gdi32.lib ole32.lib Shell32.lib Advapi32.lib Comdlg32.lib
9 - Build it (F7)
10 - Run it (F5)
This tutorial was originally written by Brain Damage with changes and additions by Gavin and Deathstryker