Now we are working in

https://github.com/Project3CITM/CulverinEngine-Project3

Culverin 3D Engine

This is a project consistent of creating a Game Engine that allows you to use tools to create video games.

It's created for educational purposes, and we are two students that are studying a Video Games Development and Design degree at CITM, Terrassa (UPC).

Check out our Web: https://github.com/elliotjb/3D-Engine

Download Last Version: https://github.com/elliotjb/3D-Engine/releases/tag/Assignment3

VERY IMPORTANT!

Make sure that you store the Release in a path without spaces, because the system won't detect successfully the path, and you won't be able to compile any script.

• Correct Path: "C:/User/Desktop/Culverin_v0.8/..."
• Incorrect Path: "C:/Program Files/Culverin_v0.8/..."

Example Street scene:

FEATURES

• Configuration options (Application, Memory Consumption, Window, Camera, Input, Audio, Scene, GUI, Renderer, Resources).
• Game Objects Structure (with components & following a hierarchy of parent-childrens).
• Basic GameObject Creation (Cube, Empty object).
• Component options (Select between all loaded meshes(MESH COMPONENT), materials (MATERIAL COMPONENT), reset transforms (TRANSFORM COMPONENT), etc.)
• GameObject/Components deletion.
• Main Camera (Frustum geometry with modificable parameters).
• Game Clock (Play, Pause & Play Frame Modes).
• In Game Mode, you will see the scene through the active camera you have selected from your gameobjects hierarchy.
• Models importation (Imports meshes and textures, and creates Game Objects with correct components, following the correct hierarchy).
• Models reimportation (You can modify an imported mesh/texture externally and changes will be applied automatically in the engine).
• You can select game objects that have a bounding box directly from Scene Screen (or you can select them through hierarchy window).
• Skybox as background of the scene.
• Editable quadtree that will contain static objects.
• Materials and Meshes components uses Resources to load data only once in memory.
• Scripting System: Unity-like functionality. You have access to the scene gameobjects and act on them (modifying name, transform (pos, rot, scale), Enabling/Disabling it, etc.).

HIGH LEVEL SYSTEM: SCRIPTING SYSTEM.

You can create your own scripts (.cs files), with restricted functionality, and attach them to the GameObjects of the scene.

• By the moment, you can only attach one script per GameObject.
• All the variables of the script are shown in the inspector (for debuging purposes).
• EDITOR OUTPUT VARIABLES: in the inspector, the variables that are recognizable are: INT, FLOAT, STRING, GAMEOBJECT. (other variables will be shown as UNKNOWN TYPE/VALUE).
• You can edit variables from the editor to modify the script.
• Make sure you don't have compilation errors in your scripts (you won't be able to run the "Game").
• You can modify scripts directly from the inspector, by clicking the "< Edit Script >" button. You will see a new window with the code. Once you have modified the script, click "File"->"Save".
• Each script has access to the GameObject that it's attached ("GameObject.gameObject").

HOW TO CREATE A NEW SCRIPT:

1. Create-> C# Script.
2. Write the class name to generate the script.

• WARNING: don't write the same name of an existing script (it won't be generated).

3. Then, your new script is saved into assets folder, and compiled by default.

IMPORT EXTERNAL SCRIPTS:

You can drag and drop a script into the engine window to import it. If it has no errors, it will be compiled successfully.

Otherwise you will have to edit it and save changes to recompile it.

EDIT SCRIPTS:

1. To edit it, you have to attach it to a GameObject first: Inspector->Add Component-> Script.
2. You will have to choose between all imported scripts ("Select script...")
3. : opens a new window with the code will apepear. You can edit it and Save changes (File->Save).

SCRIPTS IN THE INSPECTOR

• : open editor window to edit the script.
• As a component, script has a checkbox to activate/deactivate it when entering Play Mode.
• NAME: name of the script.
• VARIABLES: a list with all the variables of the script (TYPE, NAME , VALUE).

FUNCTIONS TO USE

In your scripts, you can call these specific functions to:

1. ACT ON GAMEOBJECTS:

• VOID GameObject.gameObject.SetActive(bool): set active/inactive a object.
• BOOL GameObject.gameObject.isActive(): check if it's active/inactive.
• VOID GameObject.gameObject.SetName(string): change name of the object.
• STRING GameObject.gameObject.GetName(): get name of the object.
• STRING GameObject.gameObject.GetComponent: get component specified of the gameobject (only Transform by now).
• VECTOR3 Transform.Position: position (x, y, z) of the object.
• VECTOR3 Transform.Rotation: rotation [euler] (x, y, z) of the object.
• VECTOR3 Transform.RotateAroundAxis(Vector3): rotate the transform around the specified axis.

2. CONSOLE:

• VOID Debug.Log(string): Logs the written message into the engine console.

3. INPUT:

• BOOL Input.KeyDown(string)/KeyUp(string)/KeyRepeat(string): check the state of the desired keyboard key.

[FIND THE NAME OF THE KEY HERE: https://wiki.libsdl.org/SDL_Scancode]

• BOOL Input.MouseButtonDown(int)/MouseButtonUp(int)/MouseButtonRepeat(int): check state of mouse buttons.

[1: Left button, 2: Middle button, 3:Right button]

4. TIME:

• FLOAT Time.DeltaTime(): return delta time of the game (real dt modified by time scale).

SCENE SETUP

1. From "Models" folder, drag and drop "tank.obj" into the Engine Window. It will be imported. You can drag folder.

2. Double click it to load into scene. Delete the "g_default" child objects (they are unnecessary).

3. Now, drag and drop from "Scripts" folder the 3 .cs files. They will be compiled successfully.

4. Select "tank.obj" (parent object) and attach it the "Tank" script. You can change the values of rotation speed and movement speed.(Add Component->script, Select script...-> Tank).

5. Select "gTower" child game object and attach it the "myTurret" script. You can change its rotation speed.

6. Select "MainCamera" object and attach it the "CameraController" script.

7. In "target" variable, yot have to set "tank.obj" to follow the tank.

8. Now, you are ready to enjoy! (Hit PLAY button).

9. Video Tutorial Setup: https://youtu.be/tNWcKUdz2rw

• CONTROLS:

  • W/A/S/D: move the tank.
  • Left MouseButton/Right MouseButton: rotate the turret.
  • Spacebar: SHOOT!. (Console message "SHOOT!").

INNOVATIONS

• We have created our own DLL "CulverinEditor" to load all the assemblies to enable our own c# functions.
• Basic GameObject Creation: Cube.
• Entering Play Mode enables the Active Game Camera to see the scene from it.
• Copy/Paste of GameObjects: by right clicking them (or Ctrl+C and Ctrl+V).
• Skybox as background: you can choose between 2 predefined skyboxes in Windows->Configuration->Scene.
• Resource Management:
  1. You can import an entire folder in the engine to copy all the files inside it, and see them through "Project" Window.
  2. Reimporting elements: you can import a model/texture, edit them externally, and changes will be applied automatically.
  3. Meta files: importing a model/texture will create a .meta file with information about the imported elemend and resources it uses.
  4. Folders Management: you can create, rename (only for empty folders), and remove folders (it will delete resources if they are inside, so, components that use these resources will be "empty").
  5. Resource Manager: window to see all resources loaded in the scene: rename them, see reference counting... and more [Access it via: Windows->Resources].
• Project window like Unity: with resizable icons and same navigation as Unity: folders on the left, files of the folder on the right.
• Gizmos: enable transform modifications of gameobjects in the scene.
• Mouse without restrictions: when you are moving the editor camera with right-click, if you reach a screen border, the mouse will reappear on the extreme side of the screen.

IMPORTING/REIMPORTING FILES

To import a model (.fbx/.obj), texture (.png/.jpg/.tga) or a folder to the Engine, just drag it inside the window. It will create all necessary resources to apply to GameObjects/Components. To load a model into the scene, double-click the icon that has appeared when the file was dragged. It will create a prefab.

Helper videos about resource managing:

• Importing/Reimporting Models: https://youtu.be/r2dZ5sxbU-U
• Importing/Reimporting Textures: https://youtu.be/rUXQ10-Nwls
• Editing Mesh & Material components: https://youtu.be/rsceOFcBO0c

CAMERA CONTROLS (Unity-like)

• Right Mouse Button: look around with static position
• Left Mouse Button + L-Alt: orbit around a selected object.
• Mouse Wheel: Zoom in / Zoom out.
• Middle Mouse Button: drag and move the camera vertically and horitzontally.
• F: center the Camera on the selected object.

GIZMOS

Only enabled when Editor Mode is Active. When you select a game object, its gizmo will be activated, to edit its transform. Controls:

• 1: Translate.
• 2: Rotate.
• 3: Scale.

If you have problems to select a game object by clicking on the scene screen, tree to move the camera to get a better vision angle.

QUADTREE

In Windows->Configuration->Scene you will see QUADTREE options:

• You can enable/disable its Debug Draw.
• You can change the size of the root node with the slider.
• To implement static objects inside it, first create game objects and set them to 'static'. Then, make sure all of them are inside the quadtree boundaries and click "UPDATE QUADTREE" button (only when Editor Mode is active).
• The quadtree will correctly be divided and will contain static objects.

CAMERA CULLING

• Only enabled in Play Mode.
• To cull static objects you have to set them 'static' first, then update the quadtree. If they are inside the quadtree, culling for static objects in Play Mode is enabled.

GAME OBJECTS / COMPONENT OPTIONS

You can right-click a game object or a component to see which options are enabled that will modify the selected element. Warning: for this release, cubes created in the engine hasn't got texture coords, so you won't be able to see the applied texture.

STATIC OBJECTS

When setting an object 'static', you won't be able to modify its transform when Play Mode is activated.

#VERY IMPORTANT!

Make sure that you store the Release in a path without spaces, because the system won't detect successfully the path, and you won't be able to compile any script.

UPDATES

• 0.8:

  • Embedded Mono in our application.
  • Created the main structure to link c++ functions with c# functions.
  • Resource Script included.
  • Tank scripts created and .obj model added.
  • Code cleaning.
  • Created own assembly "CulverinEditor.dll" to manage c# scripting.
  • Resource Manager Window added.

• 0.7:

  • Added Gizmos that work well with children objects.
  • Implemented Skybox (2 different skyboxes for now).
  • You can update quadtree to collect static games inside it to speed up frustum culling.
  • Added popups to warn users about Object Deletion, Setting Static an object with childs and another PopUp to warn that it's impossible to set more than one game camera active.
  • GameObjects/Components Options when right clicking them.
  • Resource manager with Import/Reimport functionality.
  • Camera moving without restrictions (only with right-click).
  • Correct Save/Load of the scene when entering/exiting Play Mode.

• 0.6:

  • Added Game Clock (with PLAY/PAUSE/PLAY FREAME buttons).
  • Structured camera with a frustum.
  • Added Game camera to visualize the scene in Game Mode.
  • Added Resources Manager (in progress).
  • Implemented Quadtree.
  • Mouse Picking feature added.
  • Camera culling fixed.
  • Added Guizmos to operate with local transforms of Game Objects.
  • Importing models transformations fixed.
  • Implemented Resources.
  • Add class JSONSerialization, Save & Load: Scenes and Prefabs.
  • Fixed Bugs with Import and Load.

• 0.5.5:

  • Fixed Bugs with transmors.
  • Fixed Bugs with Window Project.

• 0.5.4:

  • Add Window Project:

    In left window, you can see a hierarchy folders. In right, All files from a folder Test.

  • Add Modules -> Importer and Loader

    Import and Load Meshes. Import Textures.

  • Add ModuleFs.
  • GameObject & Components Structure:

    Components: transform, mesh, material and camera. *Hierarchy and Inspector Windows work on Game Objects structure.

• 0.5:

  • Implemented diference movement Camera (Now is Like Unity).
  • Add more modules in Configuration Window
  • We can set different textures on each different mesh of the model (if imported correctly).
  • Color of the model can be edited.
  • Debug info
  • Bounding box, Enable/Disable the model.

• 0.4.1:

  • Add buttom to Revert Style Docking. (v0.4.1.1)
  • Added Basic GameObject - Component Structure (Like Unity Engine)
  • Reestructured Model Importer (Now loads the texture it contains in his data automatically).
  • Implemented Save and Load Doking windows.
  • Render Scene in a window "ImGui".

• 0.4:

  • Add ImGui::Dock
  • Add window Hierarchy and Inspector
  • Add icons (play, pause stop).
  • Drag & Drop funcionality (to import FBX models).
  • Texture 2D implemented.

• 0.3:

  • Add icon .exe (v0.3.2.1)
  • Implemented Assimp (v0.3.2)
  • Fixed structure Objects (v0.3.2)
  • Add window exit (Save, Don't Save and Cancel) - "(v0.3.1)"
  • Implemented "Render" options inside "Configuration" window

    Depth test, lightning, color material, wireframe, axis, smooth polygons and fog mode.

  • "Hardware" Window implementation:

    OpenGL info.

  • Creation of spheres and boxes (in "Creation" Window).

• 0.2:

  • Implemented "Configuration" Window:

    Frame rate options. Window options (resizable, fullscreen, etc). Volume adjoustment.

  • Added "About us..." Window:

    Name, description, libraries used.

  • "Hardware" Window:

    CPU's, GPU descriptions & info.

• 0.1.1:

  • Implemented Delete Objects in Scene

Libraries Used:

(Not created by us!)

• MathGeoLib -> http://clb.demon.fi/MathGeoLib/nightly/
• ImGui -> https://github.com/ocornut/imgui
• Bullet -> http://bulletphysics.org
• Sdl -> http://www.libsdl.org/
• parson (json parser) -> https://github.com/kgabis/parson
• ASSIMP -> http://assimp.sourceforge.net/
• DevIL -> http://openil.sourceforge.net/
• Mono -> http://www.mono-project.com/

Authors:

• Elliot Jimenez: https://github.com/elliotjb
• Jordi Oña: https://github.com/Jordior97

Repository Link: https://github.com/elliotjb/3D-Engine