GAM666/DPS901 Student Resources

GAM666/DPS901 | Weekly Schedule | Student List | Project Requirements | Teams and their Projects | Student Resources

Student Resources

The purpose of this page is to share useful information that can help groups with their game projects.

A Note on Visual Studio Includes

A problem that we ran into here at Team Mutalisk was that our vcxproj file was being committed into the repository along with the committing user's include information. The problem with this was that other members had different include paths to the DX SDK and so when they updated after that user had committed, their vcxproj file would be updated and the project would not compile for them.

We've come up with a solution to this problem:

1. Set the header include path (Solution->Right-Click Project->Properties->Configuration Properties->VC++ Directories->Include Directories) for the project to: $(IncludePath);%INCLUDE%;
2. Set the library include path (Solution->Right-Click Project->Properties->Configuration Properties->VC++ Directories->Library Directories) for the project to: $(LibraryPath);%LIB%;
3. Do this for all configurations (Solution->Right-Click Project->Properties->Configuration(top of box))
4. Create/Set the environmental variables INCLUDE and LIB on your system. Do this through the Environment Variables dialog box.
   • (Win7/Vista: Start Menu->Right-Click Computer->Properties->Advanced system settings->Advanced tab->Environment Variables)
   • (WinXP: Start Menu->Right-Click My Computer->Properties->Advanced tab->Environment Variables)
5. You can add the environment variables to either only your account, at which point the project will only compile when you are logged into your own account, or to the entire system, at which point the project will compile will compile on any account on your machine. Make a decision and then click New under the appropriate list (top is user, bottom is system).
   • Please note that in order to modify system environmental variables, your account must possess admin privileges or you must know the admin credentials (win 7) or must be logged into the admin account (Vista or older).
6. First create the variable INCLUDE. Enter INCLUDE in the Variable name box. Enter the path to your DX SDK/Include in the Variable value box; eg if my DX SDK is located at C:\Program Files\Microsoft DirectX SDK (August 2007) then the value of my INCLUDE variable would be: C:\Program Files\Microsoft DirectX SDK (August 2007)\Include;
7. Second create the variable LIB. Enter LIB in the Variable name box. Enter the path to your DX SDK/Lib/x86 in the Variable value box; eg if my DX SDK is located at C:\Program Files\Microsoft DirectX SDK (August 2007) then the value of my LIB variable would be: C:\Program Files\Microsoft DirectX SDK (August 2007)\Lib\x86;
   • Please note that if either of the two variables already exists on your system, simply edit its value and concatenate the relevant path to its current value. Ensure that all paths are separated by semicolons. Eg: C:\Program Files\Microsoft SDKs\Windows\v6.0A\Lib;C:\Program Files\Microsoft DirectX SDK (August 2007)\Lib\x86;
8. Logout then login to refresh the windows environmental variable cache.
9. Attempt to compile the project. Assuming that you have no syntax errors or other unrelated problems, the project should compile. If it does, then it's time commit the vcxproj file to your repository. Now that it's up there, others can modify it (add/remove files) without worrying about breaking other group members' dependencies.

This concludes the vcxproj tutorial, cheers!

-northWind

Useful diagrams

• Class diagram of the framework Chris provides

Useful links around the web

• Download 2007 SDK
• How to create a class diagram in Visual Studio

Useful code snippets

   foo("Hello World");

Collision Code Snippets

Two teams have asked me to upgrade the framework to handle collisions. You can complete the upgrade by adding the follow snippets:

// add this code to Design::initialize() - use proper values for min max points

    jumper->setAxisAligned(Vector(-10, -10, -10), Vector(10, 10, 10));
    pedestal->setAxisAligned(Vector(-10, -10, -10), Vector(10, 10, 10));
   
   
// add this code to Design::update() where dx, dy, dz are time increments in x, y, z directions
   
    // check for collision
    unsigned flags = 0u;
    Vector d((float)dx, (float)dy, (float)dz);
    d *= FORWARD_SPEED;
    if (collision(pedestal, jumper, d, flags)) {
        // respond to collision with left object
        rollRight->translate(-d.x, -d.y, -d.z);
        if (flags & 1u)
            d.x = -d.x;
        if (flags & 2u)
            d.y = -d.y;
        if (flags & 4u)
            d.z = -d.z;
        rollRight->translate(d.x, d.y, d.z);
    }
       
   
// add this code to Frame.cpp and change signature of collision() in Frame.h
   
bool collision(const Shape* f1, const Shape* f2, Vector& d, unsigned& flags) {
    // ...
    else if (f1->axisAligned && f2->axisAligned) {
        Vector a = f1->position();
        Vector b = f2->position();
        Vector ax = f1->maximum * f1->world();
        Vector an = f1->minimum * f1->world();
        Vector bx = f2->maximum * f2->world();
        Vector bn = f2->minimum * f2->world();
        collide =
            ax.x >= bn.x && an.x <= bx.x &&
            ax.y >= bn.y && an.y <= bx.y &&
            ax.z >= bn.z && an.z <= bx.z;
        if (collide) {
            float lambdaxp, lambdayp, lambdazp, lambdaxn, lambdayn, lambdazn, lambda = 1.0f;
            Vector n = d / d.length();
            if (fabs(n.x) > 1.0e-5f) {
                lambdaxp = (ax.x - bn.x) / n.x;
                lambdaxn = (an.x - bx.x) / n.x;
                if (lambdaxp <= 1.0f && lambdaxn >= 0.0f && lambdaxp < lambdaxn)
                    lambda = lambdaxp;
                else if (lambdaxp <= 1.0f && lambdaxn >= 0.0f && lambdaxn < lambdaxp)
                    lambda = lambdaxn;
                else if (lambdaxp <= 1.0f && lambdaxp >= 0.0f)
                    lambda = lambdaxp;
                else if (lambdaxn >= 0.0f && lambdaxn <= 1.0f)
                    lambda = lambdaxn;
                flags = 1u;
            }
            if (fabs(n.y) > 1.0e-5f) {
                lambdayp = (ax.y - bn.y) / n.y;
                lambdayn = (an.y - bx.y) / n.y;
                float lambda0 = lambda;
                if (lambdayp <= 1.0f && lambdayn >= 0.0f && lambdayp < lambdayn && lambda > lambdayp)
                    lambda = lambdayp;
                else if (lambdayp <= 1.0f && lambdayn >= 0.0f && lambdayn < lambdayp && lambda > lambdayn)
                    lambda = lambdayn;
                else if (lambdayp <= 1.0f && lambdayp >= 0.0f && lambda > lambdayp)
                    lambda = lambdayp;
                else if (lambda >= 0.0f && lambdayn <= 1.0f && lambda > lambdayn)
                    lambda = lambdayn;
                if (lambda != lambda0)
                    flags = 2u;
            }
            if (fabs(n.z) > 1.0e-5f) {
                lambdazp = (ax.z - bn.z) / n.z;
                lambdazn = (an.z - bx.z) / n.z;
                float lambda0 = lambda;
                if (lambdazp <= 1.0f && lambdazn >= 0.0f && lambdazp < lambdazn && lambda > lambdazp)
                    lambda = lambdazp;
                else if (lambdazp <= 1.0f && lambdazn >= 0.0f && lambdazn < lambdazp && lambda > lambdazn)
                    lambda = lambdazn;
                else if (lambdazp <= 1.0f && lambdazp >= 0.0f && lambda > lambdazp)
                    lambda = lambdazp;
                else if (lambdazn >= 0.0f && lambdazn <= 1.0f && lambda > lambdazn)
                    lambda = lambdazn;
                if (lambda != lambda0)
                    flags = 4u;
            }
            d -= lambda * n;
        }
    }