0.9.6:Getting Started

From DXFWiki

Jump to: navigation, search

Note that the following documentation is for an old version of DXFramework and may be incomplete or incorrect

Here are the steps required to begin using DXFramework.

The only fully supported version of Visual Studio supported at this time is Visual Studio .NET 2003 so whenever Visual Studio is seen below, it is a reference to Visual Studio .NET 2003.

Contents

Visual Studio and DirectX SDK

  • Install Visual Studio
  • Install the latest DirectX SDK. New SDK updates are released every two months. Obtain the latest SDK here: http://msdn.microsoft.com/directx/sdk
  • Make sure the SDK directories are set correctly:
    • Tools --> Options --> Projects folder --> VC++ Directories
    • Select Show Directories For --> Include files
    • Make sure "<path-to-your-sdk>\Include" is on the top of the list.
    • If it isn't there, move it there!
    • Select Show Directories For --> Library files
    • Make sure "<path-to-your-sdk>\Lib\x86" is on the top of the list.
    • If it isn't there, move it there!

The DXFramework Package

  • Download the latest DXFramework package: http://dxframework.org/?page_id=3
  • Extract the DXFramework package.
    • Your desktop or documents folder will work fine. In fact, any folder should work fine. Report problems.

Install DXFramework Project Template

  • As administrator or with administrator privileges, navigate to your Visual Studio .NET 2003 installation directory. This is often: 
C:\Program Files\Microsoft Visual Studio .NET 2003
  • Drag contents of dxf-fall-2005/template into Vc7/
    • Copy over what is there if anything. This is a non-destructive, additive operation.
  • Close all instances of Visual Studio before continuing to allow the project template list to refresh.

Building and Running the Demo Projects

  • Double click the DXFramework solution (dxframework.sln) to load up the package.
  • Use the hotkey control-shift-b to build everything.
  • Right click the DXFramework-Demo project and select Set as start up project
  • Press F5 to run the project.
    • Alternately, use the menus: Debug -> Start
  • When done, right click the other projects (WorldMap, DXPong) to set them as start up project, and then F5 to run them.
    • The DXFramework-Engine project cannot be debugged by itself because it is a library, so there is no point in setting it as a start up project.

Creating a Blank Project

  • Load the DXFramework solution
  • Right click the solution icon in the Solution Explorer, select Add -> New Project
    • Alternatively, use the menus: File -> Add Project -> New Project
  • Select Visual C++ Projects -> DXFramework
    • Don't see DXFramework? Did you install the templates? If so, there is a template problem. Report it.
  • Type a project name where it says <Enter name>
    • A good name to use is the name of your game or a nickname (code name) for the game
  • Click OK (the default paths should be correct).
  • Right click the References folder under your new project (in the Solution Explorer) and select Add Reference.
  • Click the DXFramework-Engine project and click the Select button, then click OK.
  • Build the entire solution (control-shift-b).
  • Right click your new project and select Set as Start Up Project.
  • Go in to the project properties and in the debugging pane, select "All configurations" from the drop down in the upper-left, and then put ".." (quotes unnecessary) for the working directory.
  • Hit F5 to debug, verify you get an empty application, then hit the escape key to exit.
Retrieved from "http://dxframework.org/wiki/index.php/0.9.6:Getting_Started"
Personal tools