StrawberryEngine: 3D Engine

Developing a 3D Engine for the subject 3D Engines taught in CITM-UPC by Marc Garrigó, developed by Tomás Carreras and Núria Lamonja

The Engine

Short description of the engine and links.

This is Strawberry Engine's base. It includes basic features such as:

• Model Import w/ Drag & Drop
• Texture Import w/ Drag & Drop
• GameObject hierarchy + Component Pattern
• Unity-like camera controls, improved
• Editor tools (main menu and windows)
• Own file format
• Mesh display
• Manage objects

It is developed under the MIT License.

• To go to the Engine's RELEASES click here.

• To go to the GITHUB REPOSITORY click here.

• To go to the WEB PAGE click here.

The Team

List of team members and GitHub and Linkedin accounts.

This project is developed by:

• Tomás Carreras
  • Linkedin
  • GitHub
• Núria Lamonja
  • Linkedin
  • GitHub

How STRAWBERRY ENGINE works

How to use the engine, detailing the controls and any specific action.

• Camera: Right-click + WASD to move the camera in the X and Y axis, right-click also allows for free camera look, mouse wheel to zoom in and out, Atl + left-click orbits the selected mesh, the "F" key centers the camera's focus to the selecte mesh and SHIFT doubles the camera speed.
• Hierarchy window: The hierarchy window displays all game objects in the scene with their respective meshes, which can be selected to display its information on the inspector window.
• Inspector window: The inspector window, although open at the start of the engine, doesn't display any information unless there's at least one mesh selected, in which case it displays some basic information about the mesh and the textures.
• Console window : The console window displays very basic information for now and it does not accept input.
• Menu bar: The menu bar has 4 menus:
  • File: only has an item to exit.
  • View: offers the option to hide/show all the main windows.
  • Help: list of links to our web page, to report bugs and to open the about window with information about the software and the hardware.
  • Basic Shapes: offers the option to import 4 basic shapes (cube, cylinder, sphere and cone).
• Configuration window: The configuration window gives information about the application and hardware and has several options for render, textures and window preferences.
• Assets window: shows all the assets

Included files

Files you will find in the .zip.

• StrawberryEngine (main folder)
  • Assets/Resources
  • .dll files
  • StrawberryEngine.exe
• README.md (StrawberryEngine's key information)
• LICENCE.md (MIT License, which the project is developed under)
• Licences (folder with all third party libraries’ licences)

Basic functionalities

Base funcionalities in the engine for it to work properly.

• It allows to drag and drop FBX files from anywhere in the Hard Drive.
• It allows to drag and drop DDS/PNG files from anywhere in the Hard Drive (And it applies the texture to the selected GameObject).
• Game Object structure: 4 different display-only components: Transform, Mesh, Texture and Camera, all of which can be modified in the inspector window.
• Unity-like camera controls:
  • While Right clicking, “WASD” fps-like movement and free look around is enabled.
  • Mouse wheel zooms in and out.
  • Alt+Left click orbit around the object.
  • Pressing “f” focuses the camera around the geometry.
  • Holding SHIFT doubles camera movement speed.
• Editor Windows:
  • Console: the window LOGs the geometry loading process from ASSIMP and the external libraries initialization process.
  • Configuration:
    • A graph for the frames per second.
    • Configuration for all variables on each module (renderer, window, input, textures).
    • Information output of memory consumption, hardware detection and software versions (SDL, OpenGL, DevIL).
  • Hierarchy: displays a list with all GameObjects in this window. The user is able to select a GameObject through this window.
  • Inspector: displays information about the components of the selected GameObject
    • Transform: only for display purposes. Show position, rotation and scale for the selected GameObject.
    • Mesh: information about the loaded mesh. There is an option to display its normals (per-triangle and per-face).
    • Texture: displays texture size and path. There is an option to view the selected GameObject with the checkers texture.
  • There is a general menu with an option to quit, visit the github page and get info about the engine (“About”). It is also able to turn on/off editor windows.
  • There is a menu to load your own basic shapes.
  • Assets: A window that shows all user assets through which the user can drop any to the scene.
• You can select a gameobject by picking them on the scene or by selecting them on the hierarchy.
• You can change the mesh and/or texture of a selected gameobject through the inspector or by dragging a mesh/texture from the assets window into the scene
• You can reparent up GOs, delete them, create empty ones and manually drag one into another to reparent them in the hierarchy
• You can have more than one camera component added into the scene and you can have a preview of that camera.
• You can also modify the values of the camera components in the inspector, visuallize its frustum and see the culling in action.
• All meshes use a bounding volume (AABB) and can be discarded using Frustum Culling.
• Meshes and textures are saved to our own format under “Library” folder.

Extra functionalities (innovation)

Additional funcionalities in the engine.

Take into account...

Additional comments to understand some parts of the engine.

Credits

• 3D Models: free3d.com