Home

Introduction

Hi and welcome to the Brenta Engine documentation! Brenta Engine is a simple 3D engine written in modern C++/OpenGL using the Entity Component System architecture. The engine was created by Giovanni Santini in the summer of 2024, the name is inspired by the Brenta Dolimites in the Italian Alps.

The Submodules

The Engine is composed of many different submodules, each one with its own purpose. The submodules are mostly independent from each other so you can use any of the submodules you are interested into. I said mostly because all the submodules that work in a graphical environment need the opengl context from the Screen.

The main submodules are:

• oak: engine's logger
• valfuzz: the engine's testing framework
• viotecs: the engine's Entity Component System
• brenta::screen: manages the window and the OpenGL context.
• brenta::audio: everything audio.
• brenta::input: manages the screen input using callbacks.
• brenta::text: text rendering.
• brenta::engine: manages the setup of the engine.

In addition, the engine has multiple classes to provide more functionalities. Those are mostly wrappers around opengl primitives or handy classes providing utilities. Classes with many variables also provide a Builder to nicely iniitalize them.

The classes are:

• brenta::gl: provides some useful OpenGL functions.
• brenta::mesh: a 3D openGL mesh.
• brenta::model: a 3D openGL model.
• brenta::particle_emitter: create and customize particles.
• brenta::shader: manages the shaders.
• brenta::texture: manages the textures.
• brenta::types::translation: manages the translations.
• brenta::types::vao: wrapper around the Vertex Array Objects.
• brenta::types::buffer: wrapper around the Buffers.
• brenta::types::framebuffer: framebuffer wrapper.
• brenta::time: manages the time.
• brenta::camera: manages the camera.
• brenta::gui: provides helper functions to ImGUI.

Graphics

The engine uses OpenGL for the graphics and provides classes to interact with opengl.

The engine natively provides the following features:

• Color Blending
• Cull Face
• Multisample
• Depth Test
• MSAA
• Vsync
• obj model loading
• Text rendering
• Lighting: Ambient, Diffuse and Specular lighting.
• Texture atlas: texture atlas support.
• GPU Particles: particle system in the GPU.

Although the engine currently implements only basic graphics features, it provides all the building blocks to create more complex graphics. Effort will be put into implementing various graphics techniques, if you want to contribute check out the Contributing page. This issue tracks future features to implement.

In the next section we are going to see how to build the engine.

License

The engine is released under the MIT license. You can find the license in the repository.