Skip to content

Latest commit

 

History

History
137 lines (100 loc) · 3.38 KB

README.md

File metadata and controls

137 lines (100 loc) · 3.38 KB
Raw

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.