vgframework

Yes, yet another work-in-progress game and graphic engine project :)

build
description
changelog
getting started
extern libs
disclaimer

build

Configuration	Platform	API	Status
Debug	PC	DirectX12
Release	PC	DirectX12
Debug	PC	Vulkan
Release	PC	Vulkan

description

Its renderer only uses modern graphics APIs like DirectX12 and Vulkan (I would also like to support Metal the day I got and Apple device) so it can be 100% bindless from the very beginning and do strong choices in that direction:

• instanciating and writing into GPU tables is not even exposed: You have to do all the rendering stuff the modern, bindless way.
• All the interface is made to encourage using only push constants and bindless buffers/textures, not updating tables constantly as if we were still emulating DX9.
• You can't access the command lists without using the framegraph that is part of the graphic driver layer. Go framegraph or do not render anything.
• Apart from the number of root constants, all shaders are sharing the same root signatures.

changelog

0.28

Reverse Z-Buffer
Fix rounding issues
Custom Snap component
Fix physics debug scale
Editor fixes related to Prefabs
Planar projection

0.27

Can now create Prefabs to instanciate in Levels
Animation blend helper functions
Use ImGuiFileDialog instead of ImGuiFileBrowser
3D View Titlebar menu

0.26

Editor Camera V0
Improve window resize + fix rare crash when maximizing window
Forbid deleting or adding siblings to root node
Better leak tracking with FILE and LINE + Fix rare memory leak in animation loading
Update WinPixEventRuntime 1.0.231030001

0.25

Fix an issue with CountLeadingZeroes that could return a different result depending on CPU used
Jolt no more uses AVX2 to allow running on older hardware
VGFramework requires AVX1 available on any AMD/Intel CPU since 2011 (Bulldozer/Sandy Bridge)
Patch shader files in memory to support GPU DebugInfo/Warning/Error/Assert
Fix non-triangulated mesh import

0.24

New darker ImGui style
Read instance color and texture from GPUInstanceData and GPUMaterialData
Improve BLAS management
Transparent pass
Lock-free multithreaded debug display

0.23

Directional and spot lights with Raytraced (hard) shadows

0.22

Skinned BLAS updates for RT
Add icons for component types
Depth/Stencil Shader Resource Views
Fix Vulkan RenderDoc capture crash because of RayTracing used in bindless root signature

0.21

Add support for inline RayTracing with BLAS & TLAS for DirectX12/Vulkan
Duplicate/Instanciate GameObjects hierarchies UI
Log shader and PSO compilation timings
Optimize physics broadphase when game starts
Use float for dt instead of double
Optimized DirectX12 clear color
Fix multithread issue in Resource window when hot-reloading
Variable map/unmap size to speed up skinning
Update Vulkan Memory Allocator to 3.0.1
Update hlslpp to 3.4

0.20

Translate/Move/Rotate objects using ImGuizmo
Character Controller component
Start in Game mode, not editor

0.17

New add/remove component buttons and improved components popup windows Add support for themes

0.16

JoltPhysics integration V0

0.15

Removed dependency to the FBX SDK

0.14

Skeletal animations with Compute Shader Skinning
Modified properties are restored when exiting Game mode
Application now has icon :p

0.13

Loaded resources are displayed per type and their owners with paths

0.12

Mesh (FBX), Material & Texture hot-reload
GPU Picking

0.11

Add Info/Warning/Error console + clean & fixes

0.1

Separate DLLs for Engine, Renderer, Editor and Game.

getting started

• Sync the depot.
• Install the required SDKs and configure the environment variables.
• Open the "vgframework.sln" solution in Visual Studio 2022 Community IDE.
• Build & Run

You can double-click "Play (DX12).bat" or "Play (Vulkan).bat" to start the game sample without editor.
In game you can press ESC at any time to go back Editor mode.
First run might take a few seconds because files are cooking.

command-line args

(*) debugDevice is enabled by default on debug builds

keyboard shortcuts

(*) You can also keep shift pressed while moving objects to duplicate

ide

VS Studio 2022 Community
https://visualstudio.microsoft.com/fr/vs/community/

During the install select "Desktop development with C++" and "MSVC v143 - VS 2022 C++ x64/x86 build tools (latest)" (or add them later from Tool>Get Tools and Features...)

You can change the Solution Platform in Visual Studio's command line to toggle between the DirectX12 and the Vulkan renderers.

Also don't forget to set the working directory to $(SolutionDir).

SDKs

The SDKs are not included with the sources. You need to install them.

(*) Only required to build Vulkan version. $(VULKAN_SDK) should point the Vulkan SDK installation dir (i.e. "C:\SDK\Vulkan\1.3.261.1")

extern libs

The external libraries are included with the sources for convenience.

(*) You can download the binaries for optick 1.3.1 from https://github.com/bombomby/optick/releases/tag/1.3.1.0

data

models

misc

Used https://github.com/Nadrin/PBR as reference for PBR lighting equations (MIT licence)

disclaimer

Everything is heavily "Work-in-Progress" and 0% in an usable state, and I would not recommend anyone to use it yet.