Dangine

Prerequisites

1. Windows
2. Visual Studio 2010 or above
3. DirectX 9 SDK
4. PhysX System Software (Optional)

Setup

1. Clone the repo
2. Download the Dependencies and copy the folder into the root
3. Copy the DLLs from Dependencies/bin/Release and Dependencies/bin/Debug into bin/Release and bin/Debug respectively
4. Open scripts/VC2010/Dangine.sln
5. If you have a different version of Visual Studio, you may need to convert the project
6. Navigate to Project -> Properties -> Debugging -> Working Directory
7. Set it to $(ProjectDir)/../../../bin/$(Configuration)
8. Debug -> Start Debugging

Usage

Creation

First we initialise the engine:

mRenderSystem = DG_NEW(RenderSystem, mLinearArena)();
mRenderSystem->initialise(pWindowHandle);

// Specify the number of entities to pre-allocate
mWorld = DG_NEW(World, mLinearArena)(mLinearArena, 200);

// Create systems
SystemManager& systemManager = mWorld->getSystemManager();
mCameraSystem = systemManager.addSystem<CameraSystem>();
mCameraSystem->setRenderSystem(mRenderSystem);
mMeshSystem = systemManager.addSystem<MeshSystem>();
mMeshSystem->setRenderSystem(mRenderSystem);
mLightSystem = systemManager.addSystem<LightSystem>();
mLightSystem->setRenderSystem(mRenderSystem);

// Create input
mInput = DG_NEW(Input, mLinearArena)((unsigned long)pWindowHandle);

Then we can create a scene. The following code demonstrates how to add a transform and mesh component to an entity.

Transform* trans = DG_NEW(Transform, mLinearArena);
trans->position = vmVector3(0, 0, 0);
Mesh* mesh = DG_NEW(Mesh, mLinearArena);
mesh->file = "MyMesh.x";
mWorld->getEntity(0).addComponent(trans);
mWorld->getEntity(0).addComponent(mesh);

Components are allocated with the linear allocator, initial data is filled, and the components are added to a pre-allocated entity.

We then initialise all the systems:

mWorld.getSystemManager().initialiseAll();

For manipulating a component with a system, here's an example of how to move the camera forward:

mCameraSystem->moveForward(mWorld->getEntity(0), moveSpeed);

Updating

The update loop makes it easy to separate operations:

void Game::update()
{
	// 1) Update logic
	_internalLogicLoop(getGameTime());

	// 2) Update graphics
	mCameraSystem->process();
	mMeshSystem->process();
	mLightSystem->process();

	// 3) Update input
	mInput->update();
}

Memory System

Here is an example of arena and area creation:

HeapArea heapArea(1024 * 16);
LinearArena arena(heapArea);

Object creation/deletion:

MyClass* myClass = DG_NEW(MyClass, arena)(params)

// Manipulation

DG_DELETE(myClass, arena);

Array creation/deletion:

MyArray* myArray = DG_NEW_ARRAY(MyArray, size, arena)

// Manipulation

DG_DELETE_ARRAY(myArray, arena)

Todo

• A data-oriented scene graph.
• Frustum and octree culling.
• Complete implementation and usage of different memory allocators.
• Implement parallel library such as Intel TBB.
• Expand upon the entity system to include features such as messaging.
• A fully-featured game demo.