Installing the Dark GDK with Visual Studio 2008 

 
The Dark GDK installer assumes that you are using Microsoft Visual C++ 2008 Express Edition. If 
you plan to use the Dark GDK with Visual Studio, you will need to follow the instructions in this 
document. 
 
 
STEP 1: Install and Run Visual Studio
 

• Install Visual Studio. 
• Run Visual Studio. If asked to choose your default development environment settings, 
choose Visual C++ Development Settings. 
• Close Visual Studio. 

 
  STEP 2: Install the August 2007 version 
 
of the DirectX 9.0c SDK
 
 
Note that the Dark GDK requires this specific version of the DirectX SDK. If you have installed a 
later version, you should uninstall it before installing this version. 
 
• Begin the installation by clicking this link: 
http://download.microsoft.com/download/3/3/f/33f1af6e‐c61b‐4f14‐a0de‐
3e9096ed4b3a/dxsdk_aug2007.exe 
• When you click on the link shown above, a File Download dialog box will appear. Click 
Run to download and run this part of the installation. (The file that is downloaded in this 
step is large, and might take some time to install.) 
• Once the file has downloaded, the WinZip dialog box shown in Figure 1 will appear. 
Make sure the "Overwrite files without prompting" and "When done unzipping open: 
Setup.exe" boxes are checked, and then click the Unzip button.  
• The program will begin unzipping files to your system, and then you will see a dialog box 
indicating that the files were unzipped successfully. Click OK to dismiss the dialog box. 
 
   

    Page 1 
 
Figure 1: WinZip dialog box 

• You may experience a momentary pause at this point, while the setup program for the 
August 2007 DirectX 9.0 SDK loads. When the setup program begins, you will see the 
screen shown in Figure 2. Click the Next button to continue with the setup. Once you've 
accepted the license agreement on the next screen, simply click the Next button to 
accept the default options on each of the screens that you see. The installation will take 
a few minutes. When it is finished you will see a screen with the message "InstallShield 
Wizard Completed." 

Note: During setup you will see a message warning that the pre‐release version of 
XAudio2 has expired. You may ignore this warning. 

Figure 2: DirectX SDK setup 

    Page 2 
 
 
  STEP 3: Install the Dark GDK
 

• Begin the installation by clicking this link: http://go.microsoft.com/?linkid=7708310 
• When the Dark GDK setup program executes, you will see the screen shown in Figure 3. 
Click the Next button to continue with the setup. Once you've accepted the license 
agreement on the next screen, simply click the Next button to accept the default 
options on each of the screens that you see. The installation will take a few minutes. 
When it is finished you will see a screen with the message "Installation Complete." 

Figure 3: Dark GDK setup 

 
 
• Despite the message displayed on the previous screen, the installation isn't complete 
yet. You still need to run the executable file that was just installed. In your Documents 
folder (or My Documents if you are running XP) you should have a folder named MSDN, 
and in that folder you should have a folder named The Game Creators Dark GDK. (In 
fact, you may see the contents of this folder displayed on the screen at this time.) In this 
folder you will have an executable file named something like Dark GDK ‐ 161107.exe. 
Run that file. 

Note: You may see a message warning you that the Microsoft Visual C++ compiler was not 
detected. You may ignore that warning because it refers to the Express Edition compiler. 
When asked if you want to install the compiler before proceeding, click No. 
 

    Page 3 
 
 • Next you will be asked if you have run the Visual C++ compiler at least once. Click Yes, 
and then on the subsequent screens simply click Next to accept the default options. (On 
one screen you will be asked to click Yes to accept the licensing agreement.) When the 
installation is complete, you will finally see a message indicating that the Dark GDK has 
been installed on your computer. Click the Finish button. 

 
 
 
  STEP 4: Copy the Dark GDK Project 
  Templates 
 

• Go to the following folder:  
               C:\Program Files\Microsoft Visual Studio 9.0\VC\vcprojects 
Inside that folder, create a folder named Dark GDK 
 
• Copy all of the files from this folder:  
                C:\Program Files\The Game Creators\Dark GDK\Wizards\Files 
to the folder you just created. 

 
 
STEP 5: Edit the .vsz Files
 
 
Go to the Dark GDK folder that you created in Step 4, at this location: 
           C:\Program Files\Microsoft Visual Studio 9.0\VC\vcprojects\Dark GDK 
 
Inside that folder you should see some .vsz files. Use Notepad (or any other plain text editor) to 
edit the files as follows: 

• In the 2D Game.vsz file, find the line that begins Param = "ABSOLUTE_PATH…" 
Change that line to read: 
Param="ABSOLUTE_PATH = C:\Program Files\The Game Creators\Dark 
GDK\Wizards\Projects\Dark GDK ‐ 2D Game\Dark GDK ‐ 2D Game" 
 
 
 
 

    Page 4 
 
 • In the 3D Game.vsz file, find the line that begins Param = "ABSOLUTE_PATH…" 
Change that line to read: 
Param="ABSOLUTE_PATH = C:\Program Files\The Game Creators\Dark 
GDK\Wizards\Projects\Dark GDK ‐ 3D Game\Dark GDK ‐ 3D Game" 
 
• In the Game.vsz file, find the line that begins Param = "ABSOLUTE_PATH…" 
Change that line to read: 
Param="ABSOLUTE_PATH = C:\Program Files\The Game Creators\Dark 
GDK\Wizards\Projects\Dark GDK ‐ Game\Dark GDK ‐ Game" 

 
 
  STEP 6: Set the Compiler Options
 

• Run Visual Studio. On the menu bar select Tools, and then select Options. The Options 
Dialog box shown in Figure 4 will appear. As shown in the figure, in the left‐hand pane 
under Projects and Solutions select VC++ Directories. 

 
Figure 4: Options Dialog Box 

• In the top right‐hand area of the dialog box, under Show directories for, select Include 
Files from the drop‐down list. This is shown in Figure 5. 

    Page 5 
 
Figure 5: Select Include Files 

• Double‐click the area at the bottom of the list of include directories, and then click the 
 button as shown in Figure 6. 

Figure 6: Editing the List of Include Directories 

    Page 6 
 
 • You should now see a Select Directory dialog box. Navigate to and select the following 
directory, then click the OK button: 
C:\Program Files\The Game Creators\Dark GDK\Include 
 
• The screen should now appear as shown in Figure 7, with the directory that you just 
selected shown in the list. 

Figure 7: Dark GDK Include Directory Added to the List 

• Now you will add the Include directory for the DirectX 9.0c August 2007 SDK to the list. 
Repeat the steps that you just completed to select the following directory: 
C:\Program Files\Microsoft DirectX SDK (August 2007)\Include 
 
• The screen should now appear as shown in Figure 8, with the directory that you just 
selected shown in the list. 

    Page 7 
 
Figure 8: DirectX SDK (August 2007) Include Directory Added to the List 

• In the top right‐hand area of the dialog box, under Show directories for, select Library 
Files from the drop‐down list. This is shown in Figure 9. 

Figure 9: Select Library Files 

    Page 8 
 
 • Double‐click the area at the bottom of the list of library directories, and then click the 
 button. The Select Directory dialog box will appear. Use this dialog box to select 
the following directory and add it to the list: 
C:\Program Files\The Game Creators\Dark GDK\Lib\vs9 
 
• Repeat the same procedure to add the following directory to the list: 
C:\Program Files\Microsoft DirectX SDK (August 2007)\Lib\x86 
 
• The screen should now appear as shown in Figure 10, with the two directories that you 
just selected shown in the list. Click the OK button and you're done! 

Figure 10: Dark GDK and DirectX SDK Library Directories Added to the List 

    Page 9