Create buildable version of the TGE source code in VS2005 Express
by Scott Peal · 07/01/2006 (12:21 pm) · 3 comments
GOAL: Create a version of the TGE code which will serve as my base and is buildable in Visual Studio 2005 Express Edition.
Here is an excert from my change management logs which will outline the steps I took to get a buildable version of TGE working and slimmed down to only the code I needed.
- This change management log was created.
- Downloaded and extracted Torque Game Engine (TGE) version 1.4 SDK onto my IBM R51 laptop running Microsoft Windows XP. Downloaded SDK into C:\Torque directory
- Ran demo with no errors
- Created a custom location for the new source code by copying C:\Torque\SDK to C:\Torque\IV3
- Located a wiki called Guide to Compiling TGE 1.4 with Visual Studio 2005 Express at Garage Games web site: http://tdn.garagegames.com/wiki/Torque/vs2k5 I will refer to this as the "guide" for the rest of this process.
- NOTE: Visual Studio 2005 Professional was already installed on this laptop, however, wanted to install the Express version in order to follow the installation guide's instructions.
- Downloaded and installed Microsoft Visual C++ 2005 Express Edition version 8.0.50727.42 (RTM.050727-4200) as per the instructions found in the guide following the "New Instructions" method. NOTE: that there are instructions from Microsoft to install the Platform SDK as step four of their installation instructions. I have not done this at this time because the instructions found at Garage Games (GG) do not explicitly state to do so. (the Platform SDK was not needed).
- Registered Microsoft Visual C++ 2005 Express Edition
- Went to Windows Update to look for updates for Microsoft Visual C++ 2005 Express Edition. No updates were found.
- As per the guide, I download the patch for TGE for VS2005 Express Edition located here: http://tdn.garagegames.com/wiki/images/e/e8/TGE_VS2005.zip . The patch was applied to the C:\Torque\IV3 directory.
- As per the guide, I made the changes to the working folders for debug and release builds. Next I did a build of the project. The build process takes about 7 minutes and 8 seconds to build on my laptop. The results of my build did matched what was shown in the guide:
- I opened the build log file and found the following errors at the start of the log. I am not sure why these errors occurred at this time. Most of the errors look like Macintosh related code. I will look into this later:
- Next I want to remove any code not needed for my project. I closed the VS2005 Express project and deleted the vc6 and vc7 directories from the C:\Torque\IV3 directory (remembering that I have another copy of it in my C:\Torque\SDK directory). Next I opened my project in VS2005 Express and re-built the project (menu Build -> Rebuild Torque Demo) - RESULTS: The rebuild was successful and when I ran the demo (F5 key) I received a notice that a file was out of date and asked if I wanted to rebuild it. I clicked yes and the demo ran successfully.
- CC060701-001: I closed VS2005. As I am working on a first person shooter (FPS) type, I changed the demo to launch the starter.fps example instead of the demo example. To do this, I edited this file: C:\Torque\IV3\example\main.cs and changed this line:
to this line:
The number found in the comments is the code change ("CC") number. The numbering system will be like this: CCYYMMDD-NNN where NNN is an incremental number which restarts at 000 each day.
- I tested the last change by running the demo again - successfully (C:\Torque\IV3\example\torqueDemo)
- Next I want to see what happens if I delete all the other demo examples. I deleted the following folders for the test:
I started the the demo to verify it would start correctly and it did. I next started the project in VS2005 and did a rebuild to see if there were any errors or it re-created the folders. After the rebuild, the following is the results:
Notice the 4 failed errors.
I did a menu Build -> clean and then did a menu Build again to see if I go the same errors. This time all was successful:
- At this point, I consider this version of the code to be my base code and will give it the version number of 0.0.1, next I created a zipped of the C:\Torque\IV3 and labeled it "IV3 version 0.0.1" as a backup.
Here is an excert from my change management logs which will outline the steps I took to get a buildable version of TGE working and slimmed down to only the code I needed.
- This change management log was created.
- Downloaded and extracted Torque Game Engine (TGE) version 1.4 SDK onto my IBM R51 laptop running Microsoft Windows XP. Downloaded SDK into C:\Torque directory
- Ran demo with no errors
- Created a custom location for the new source code by copying C:\Torque\SDK to C:\Torque\IV3
- Located a wiki called Guide to Compiling TGE 1.4 with Visual Studio 2005 Express at Garage Games web site: http://tdn.garagegames.com/wiki/Torque/vs2k5 I will refer to this as the "guide" for the rest of this process.
- NOTE: Visual Studio 2005 Professional was already installed on this laptop, however, wanted to install the Express version in order to follow the installation guide's instructions.
- Downloaded and installed Microsoft Visual C++ 2005 Express Edition version 8.0.50727.42 (RTM.050727-4200) as per the instructions found in the guide following the "New Instructions" method. NOTE: that there are instructions from Microsoft to install the Platform SDK as step four of their installation instructions. I have not done this at this time because the instructions found at Garage Games (GG) do not explicitly state to do so. (the Platform SDK was not needed).
- Registered Microsoft Visual C++ 2005 Express Edition
- Went to Windows Update to look for updates for Microsoft Visual C++ 2005 Express Edition. No updates were found.
- As per the guide, I download the patch for TGE for VS2005 Express Edition located here: http://tdn.garagegames.com/wiki/images/e/e8/TGE_VS2005.zip . The patch was applied to the C:\Torque\IV3 directory.
- As per the guide, I made the changes to the working folders for debug and release builds. Next I did a build of the project. The build process takes about 7 minutes and 8 seconds to build on my laptop. The results of my build did matched what was shown in the guide:
Microsoft Browse Information Maintenance Utility Version 8.00.50727 Copyright (C) Microsoft Corporation. All rights reserved. Build log was saved at "file://c:\Torque\IV3\engine\out.VC8.DEBUG\BuildLog.htm" Torque Demo - 0 error(s), 8 warning(s) ========== Build: 7 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========
- I opened the build log file and found the following errors at the start of the log. I am not sure why these errors occurred at this time. Most of the errors look like Macintosh related code. I will look into this later:
Torque Demo : warning PRJ0041 : Cannot find missing dependency 'winwlm.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'macwin32.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'macwin32.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'macwin32.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'macwin32.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missng dependency 'macwin32.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'macwin32.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'rpcerr.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'rpcmac.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'macname1.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'macpub.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'macapi.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found. Torque Demo : warning PRJ0041 : Cannot find missing dependency 'macname2.h' for file 'TorqueDemo.rc'. Your project may still build, but may continue to appear out of date until this file is found.
- Next I want to remove any code not needed for my project. I closed the VS2005 Express project and deleted the vc6 and vc7 directories from the C:\Torque\IV3 directory (remembering that I have another copy of it in my C:\Torque\SDK directory). Next I opened my project in VS2005 Express and re-built the project (menu Build -> Rebuild Torque Demo) - RESULTS: The rebuild was successful and when I ran the demo (F5 key) I received a notice that a file was out of date and asked if I wanted to rebuild it. I clicked yes and the demo ran successfully.
- CC060701-001: I closed VS2005. As I am working on a first person shooter (FPS) type, I changed the demo to launch the starter.fps example instead of the demo example. To do this, I edited this file: C:\Torque\IV3\example\main.cs and changed this line:
$defaultGame = "tutorial.base";
to this line:
$defaultGame = "starter.fps"; //CC060701-001 // $defaultGame = "tutorial.base";
The number found in the comments is the code change ("CC") number. The numbering system will be like this: CCYYMMDD-NNN where NNN is an incremental number which restarts at 000 each day.
- I tested the last change by running the demo again - successfully (C:\Torque\IV3\example\torqueDemo)
- Next I want to see what happens if I delete all the other demo examples. I deleted the following folders for the test:
C:\Torque\IVexample\demo C:\Torque\IVexample\starter.demo C:\Torque\IVexample\tutorial.base
I started the the demo to verify it would start correctly and it did. I next started the project in VS2005 and did a rebuild to see if there were any errors or it re-created the folders. After the rebuild, the following is the results:
Microsoft Browse Information Maintenance Utility Version 8.00.50727 Copyright (C) Microsoft Corporation. All rights reserved. Build log was saved at "file://c:\Torque\IV3\engine\out.VC8.DEBUG\BuildLog.htm" Torque Demo - 0 error(s), 8 warning(s) ========== Rebuild All: 9 succeeded, 4 failed, 3 skipped ==========
Notice the 4 failed errors.
I did a menu Build -> clean and then did a menu Build again to see if I go the same errors. This time all was successful:
Microsoft Browse Information Maintenance Utility Version 8.00.50727 Copyright (C) Microsoft Corporation. All rights reserved. Build log was saved at "file://c:\Torque\IV3\engine\out.VC8.DEBUG\BuildLog.htm" Torque Demo - 0 error(s), 8 warning(s) ========== Build: 7 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========
- At this point, I consider this version of the code to be my base code and will give it the version number of 0.0.1, next I created a zipped of the C:\Torque\IV3 and labeled it "IV3 version 0.0.1" as a backup.
About the author
Step 1) be the indie, step 2) make enough to buy a commercial license :)
#2
07/05/2006 (3:33 am)
Top marks for presentation and explanation, lets have some more. :)
#3
09/27/2006 (4:03 pm)
"About" 7 minutes and 8 seconds? Damn it man, give us some precise figures! Was it *really* 7 minutes and 8 seconds, or did it actually tip over into 7 minutes and 8.51 seconds, but you didn't want to say? I find all this very suspicious... :) 
Torque Owner Jeff Tunnell
-Jeff Tunnell, GG