dagon2 ~main

Dagon Engine 2

Feature-rich, easy to use, extensible desktop game development framework for D language aiming photorealistic 3D graphics. Works on Windows and Linux.

This is work-in-progress SDL3/Vulkan port of Dagon Engine 1.0.

Note: this project is not connected to Dagon engine by Senscape.

Screenshots

Features

Note: Dagon 2 is still in active development. Not all features of Dagon 1.0 are ported yet.

• Scene graph
• Virtual file system
• Imports almost any 3D model via Assimp library
• Textures in PNG, JPEG, WebP, AVIF, DDS, KTX/KTX2, HDR, SVG and many other formats
• S3TC (DXTn), RGTC, BPTC, Basis Universal texture compression support. Built-in DXT1/DXT5/BC4/BC7 compressors and DDS exporter. Texture cache to accelerate asset loading
• Shaders in GLSL 4.60; SPIR-V cache
• Runs in windowed, fullscreen and borderless fullscreen modes
• Hybrid deferred+forward rendering pipeline
• Physically based rendering (PBR) with GGX microfacet BRDF, industry-standard Metallic-Roughness material workflow and image-based lighting based on split-sum approximation
• HDR rendering with AgX tonemapping. Wide-gamut scRGB output support for HDR displays
• HDRI environment maps. Equirectangular HDRI to cubemap conversion. GPU-based cubemap prefiltering with importance sampling. Loading prebaked cubemaps from DDS
• Directional lights with cascaded shadow mapping
• Normal mapping, parallax mapping
• Stochastic screen-space reflections (SSSR) with importance sampling and temporal denoising
• Temporal SSAO
• Deferred decals with normal mapping and PBR material properties
• Input from keyboard, mouse and up to 4 gamepads
• Unicode text input
• Ownership memory model
• Built-in camera logics for easy navigation: freeview and first person views
• Rigid body physics using Jolt physics engine. Built-in character controller
• Native file open/save dialogs (for Windows, GTK, and Qt).

New features:

• Built-in GScript3 virtual machine and scripting API
• The renderer now leverages SDL GPU, targeting Vulkan instead of OpenGL
• Improvements and optimizations in almost every stage of the renderer. Many new features such as irradiance mapping, multiple scattering, specular occlusion, and adjustable f0
• Screen-space reflections
• Experimental HDR (scRGB) output support
• 2x supersampling support
• Temporal SSAO support
• BC7 texture compressor based on D port of Rich Geldreich's bc7enc
• BC4 texture compressor (original implementation)
• Built-in texture caching. Abstract resource cache (dagon.resource.cache) that can be used for any file types
• Many new DDS/DXGI formats support
• Fog effect is now applied in a separate pass. Ground fog support
• Radial optical distortion support
• Shadeless materials in deferred pipeline
• Window minimize/restore events.

Major changes from Dagon 0.x/1.x:

• Reimplemented dagon.render. Deferred renderer, post-processing renderer and presentation renderer are now combined into one
• Shader workflow is now based on GLSL 4.60 and includes built-in GLSL to SPIR-V compiler. SPIR-V modules are cached to disk for reuse
• Texture loader is fully based on SDL3_Image and doesn't use dlib.image.io. KTX support is now a core feature
• Assimp integration is now a core feature
• Tonemapping is entirely based on AgX. Legacy tonemappers were removed
• Semantic of Scene and World classes is changed. Scene is now just a container for Entities and other graphical data; for user input and game logics World should be used
• All Entities are static by default, and their model matrices are not recalculated each frame to reduce CPU overhead. For dynamic updates enable Entity.dynamic or use custom EntityController (partly analogous to old EntityComponent)
• The renderer now uses separate irradiance cubemap
• BRDF LUT is now generated at runtime instead of loading from data/__internal
• Jolt Physics is now built-in as dagon.jolt package.

System Requirements

Realistic minimum system requirements (for Full HD rendering at 60 fps):

• CPU: Intel Core i3-10100 / AMD Ryzen 3 3100
• RAM: application-dependent, usually 8 Gb minimum
• GPU: Vulkan-capable, tested on GeForce RTX 3050
• VRAM: 6-8 Gb
• OS: 64-bit Windows 10 or higher / Linux.

Usage

TODO

Runtime Dependencies

• SDL 3.4
• SDL_Image 3.2
• FreeType 2.8.1
• GLSLang
• SPIRV-Cross
• Assimp
• Jolt Physics via joltc wrapper

Dependencies are automatically deployed on 64-bit Windows and Linux. Under Linux, if you want to use local libraries in Windows way (from application's working directory rather than from the system), add the following to your dub.json:

"lflags-linux": ["-rpath=$$ORIGIN"]

Known Limitations

• The engine doesn't support macOS yet. Although SDL GPU is a multi-backend API, Dagon 2 currently targets only Vulkan backend.

Documentation

HTML documentation can be generated from source code using ddox (dub build -b ddox). Be aware that documentation is currently incomplete.

License

Distributed under the Boost Software License, Version 1.0 (see accompanying file COPYING or at http://www.boost.org/LICENSE10.txt).