Tabula Rasa Engine

A 3d game engine developed with OpenGL in c ++. This project has been done by two students of CITM - UPC (Terrasa, Spain) for the subject Game Engines,

• Github repository
• Website

Installation instructions

Download the zip file and unzip it. Open the folder, execute the .exe and enjoy! You can find the models and textures in the assets folder.

IMPORTANT: do not modify, change or add any folder or file as you might not be able to execute the game engine.

Notes on performance

There are three main known cases where the overall perfomance might decrease significantly:

• Only the first time you execute the engine the app will "freeze" as it's importing all the assets and generating its corresponding resources. The time will vary depending in the number and sizes of files that are being imported.
• If the z-buffer visualization is activated.
• When an animated model is loaded on scene (especially if its playing its animation) the engine perfomance might drop a lot. That's because the skinning process of deforming the mesh to match the bones positions of the corresponding skeleton needs to do a lot of matrix related operations multiple times per frame. As we don't use shaders in this engine all these operations are sended to the CPU (instead of the GPU) which is not prepared to handle matrix operations as well as the GPU does.

Controls

• Select object: Left click

Gizmos

• W/E/R: Change gizmo to Translate, Rotation and Scale

Assets controls

• Load scene: Double left clic

Camera

• Free look around: Right Click Mouse Button
• Orbit around object: LALT + Left Click Mouse Button
• Zoom in/out Mouse wheel
• Pan: Middle mouse button
• Duplicate movement speeed: Hold Shift key
• Focus camera on object: F key

UI

• Open config window: 8
• Open console: 7
• Open Inspector: I key
• Show/Hide UI: LALT + G key
• Quit application: ESC / Alt+F4

Animations

• Play punch animation: 1
• Play walk in place animation: 2

Click again on Window->(any option) to close that window

How to handle animations

• Left click in the the Warlock gameobject in the hierarchy which represents the character mesh.
• In the inspector scroll down until you find the animation component.
• In this component the animation can be played, paused, move frames forward and backward and you can move the timeline too if needed. * * Down below these controls you can change the animation speed and if you want it in loop and to interpolate between frames.
• Below this you'll find the available animations for this mesh which if clicked will be loaded into the character mesh.
• Pressing 1 the character will perform a punch attack.
• Pressing 2 the character will blend to the walk in place animation (blend time is set to 1s). If 2 is released character will return to the idle animation.

Innovations / Redesign

• Draw the z-buffer in grayscale option determined by the distance (Option in Config window -> Renderer3D options -> Switch Z- Buffer Visualization).

Warning: If this option is activated the overall performance might decrease significantly.

Example for comparison:

Team members

García Subirana, Guillermo's responsability and Github account

• Code
• Github account

Masó Garcia, Victor's responsability and Github account

• Code
• Github account

Tools used

• IDE: Microsoft Visual Studio 2017
• Language: C++
• Containers: STL
• Input and audio: SDL 2.0.8
• Graphics: OpenGL
• Math: MathGeoLib 1.5
• Random Number Generator: PCG 0.9 (Minimal C Edition)
• GUI: Deat ImGui 1.65
• 3D Model importer: Assimp 1.4.0
• Image loader: Developer's Image Library (DevIL) 1.8.0
• Data persistance: JSON parser - Parson 2017
• Profiler: Brofiler 1.1.2
• Memory manager: mmgr
• File system: PHYSFS 3.0.1
• Code repository: GitHub
• Others: Adobe Photoshop CS6 / MS Paint / Aseprite

Credits attributions

• All the animated models along with its corresponding textures have been downloaded from Mixamo