Merge branch 'main' into patch-1

Author: Raffaello

.github/workflows/simple_engine_ci.yml

@@ -12,3 +12,6 @@ content:
 ui:
   bundle:
     url: ui-bundle.zip
+runtime:
+  log:
+    failure_level: warn

antora-ci-playbook.yml

@@ -63,3 +63,89 @@
 ** xref:courses/18_Ray_tracing/07_Conclusion.adoc[Conclusion]
 * xref:90_FAQ.adoc[FAQ]
 * link:https://github.com/KhronosGroup/Vulkan-Tutorial[GitHub Repository, window=_blank]
+
+* Building a Simple Engine
+** xref:Building_a_Simple_Engine/introduction.adoc[Introduction]
+** Engine Architecture
+*** xref:Building_a_Simple_Engine/Engine_Architecture/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/02_architectural_patterns.adoc[Architectural patterns]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/03_component_systems.adoc[Component systems]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/04_resource_management.adoc[Resource management]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/05_rendering_pipeline.adoc[Rendering pipeline]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/06_event_systems.adoc[Event systems]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/conclusion.adoc[Conclusion]
+** Camera Transformations
+*** xref:Building_a_Simple_Engine/Camera_Transformations/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/02_math_foundations.adoc[Math foundations]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/03_transformation_matrices.adoc[Transformation matrices]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/04_camera_implementation.adoc[Camera implementation]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/05_vulkan_integration.adoc[Vulkan integration]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/06_conclusion.adoc[Conclusion]
+** Lighting & Materials
+*** xref:Building_a_Simple_Engine/Lighting_Materials/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/02_lighting_models.adoc[Lighting models]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/03_push_constants.adoc[Push constants]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/04_lighting_implementation.adoc[Lighting implementation]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/05_vulkan_integration.adoc[Vulkan integration]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/07_shadows.adoc[Shadows]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/06_conclusion.adoc[Conclusion]
+** GUI
+*** xref:Building_a_Simple_Engine/GUI/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/GUI/02_imgui_setup.adoc[ImGui setup]
+*** xref:Building_a_Simple_Engine/GUI/03_input_handling.adoc[Input handling]
+*** xref:Building_a_Simple_Engine/GUI/04_ui_elements.adoc[UI elements]
+*** xref:Building_a_Simple_Engine/GUI/05_vulkan_integration.adoc[Vulkan integration]
+*** xref:Building_a_Simple_Engine/GUI/06_conclusion.adoc[Conclusion]
+** Loading Models
+*** xref:Building_a_Simple_Engine/Loading_Models/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Loading_Models/02_project_setup.adoc[Project setup]
+*** xref:Building_a_Simple_Engine/Loading_Models/03_model_system.adoc[Model system]
+*** xref:Building_a_Simple_Engine/Loading_Models/04_loading_gltf.adoc[Loading glTF]
+*** xref:Building_a_Simple_Engine/Loading_Models/05_pbr_rendering.adoc[PBR rendering]
+*** xref:Building_a_Simple_Engine/Loading_Models/06_multiple_objects.adoc[Multiple objects]
+*** xref:Building_a_Simple_Engine/Loading_Models/07_scene_rendering.adoc[Scene rendering]
+*** xref:Building_a_Simple_Engine/Loading_Models/08_animations.adoc[Animations]
+*** xref:Building_a_Simple_Engine/Loading_Models/09_conclusion.adoc[Conclusion]
+** Subsystems
+*** xref:Building_a_Simple_Engine/Subsystems/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Subsystems/02_audio_basics.adoc[Audio basics]
+*** xref:Building_a_Simple_Engine/Subsystems/03_vulkan_audio.adoc[Vulkan audio]
+*** xref:Building_a_Simple_Engine/Subsystems/04_physics_basics.adoc[Physics basics]
+*** xref:Building_a_Simple_Engine/Subsystems/05_vulkan_physics.adoc[Vulkan physics]
+*** xref:Building_a_Simple_Engine/Subsystems/06_conclusion.adoc[Conclusion]
+** Tooling
+*** xref:Building_a_Simple_Engine/Tooling/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Tooling/02_cicd.adoc[CI/CD]
+*** xref:Building_a_Simple_Engine/Tooling/03_debugging_and_renderdoc.adoc[Debugging & RenderDoc]
+*** xref:Building_a_Simple_Engine/Tooling/04_crash_minidump.adoc[Crash minidumps]
+*** xref:Building_a_Simple_Engine/Tooling/05_extensions.adoc[Extensions]
+*** xref:Building_a_Simple_Engine/Tooling/06_packaging_and_distribution.adoc[Packaging & distribution]
+*** xref:Building_a_Simple_Engine/Tooling/07_conclusion.adoc[Conclusion]
+** Mobile Development
+*** xref:Building_a_Simple_Engine/Mobile_Development/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Mobile_Development/02_platform_considerations.adoc[Platform considerations]
+*** xref:Building_a_Simple_Engine/Mobile_Development/03_performance_optimizations.adoc[Performance optimizations]
+*** xref:Building_a_Simple_Engine/Mobile_Development/04_rendering_approaches.adoc[Rendering approaches]
+*** xref:Building_a_Simple_Engine/Mobile_Development/05_vulkan_extensions.adoc[Vulkan extensions]
+*** xref:Building_a_Simple_Engine/Mobile_Development/06_conclusion.adoc[Conclusion]
+** Advanced Topics
+*** xref:Building_a_Simple_Engine/Advanced_Topics/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering pipeline overview]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Forward_ForwardPlus_Deferred.adoc[Forward vs Forward+ vs Deferred]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/ForwardPlus_Rendering.adoc[Forward+ rendering]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Culling.adoc[Culling]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Mipmaps_and_LOD.adoc[Mipmaps & LOD]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Push_Constants_Per_Object.adoc[Push constants per object]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization & streaming]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_2_Frame_Pacing.adoc[Synchronization2 & frame pacing]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor indexing (UpdateAfterBind)]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Separate_Image_Sampler_Descriptors.adoc[Separate image/sampler descriptors]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Shader_Tile_Image.adoc[Shader tile image]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/GLTF_Animation.adoc[glTF animation]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Planar_Reflections.adoc[Planar reflections]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Rendering.adoc[Ray query rendering]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Reflections_and_Transparency.adoc[Ray query: reflections & transparency]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Dynamic_Rendering_Local_Read.adoc[Dynamic rendering local read]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Robustness2.adoc[Robustness2]
+** Appendix
+*** xref:Building_a_Simple_Engine/Appendix/appendix.adoc[Appendix]

antora/modules/ROOT/nav.adoc

@@ -48,10 +48,7 @@ class HelloTriangleApplication
 	vk::raii::PhysicalDevice physicalDevice = nullptr;
 
 	std::vector<const char *> requiredDeviceExtension = {
-	    vk::KHRSwapchainExtensionName,
-	    vk::KHRSpirv14ExtensionName,
-	    vk::KHRSynchronization2ExtensionName,
-	    vk::KHRCreateRenderpass2ExtensionName};
+	    vk::KHRSwapchainExtensionName};
 
 	void initWindow()
 	{

attachments/03_physical_device_selection.cpp

@@ -52,10 +52,7 @@ class HelloTriangleApplication
 	vk::raii::Queue graphicsQueue = nullptr;
 
 	std::vector<const char *> requiredDeviceExtension = {
-	    vk::KHRSwapchainExtensionName,
-	    vk::KHRSpirv14ExtensionName,
-	    vk::KHRSynchronization2ExtensionName,
-	    vk::KHRCreateRenderpass2ExtensionName};
+	    vk::KHRSwapchainExtensionName};
 
 	void initWindow()
 	{

attachments/04_logical_device.cpp

@@ -49,10 +49,7 @@ class HelloTriangleApplication
 	vk::raii::Queue                  queue          = nullptr;
 
 	std::vector<const char *> requiredDeviceExtension = {
-	    vk::KHRSwapchainExtensionName,
-	    vk::KHRSpirv14ExtensionName,
-	    vk::KHRSynchronization2ExtensionName,
-	    vk::KHRCreateRenderpass2ExtensionName};
+	    vk::KHRSwapchainExtensionName};
 
 	void initWindow()
 	{

attachments/05_window_surface.cpp

@@ -56,10 +56,7 @@ class HelloTriangleApplication
 	std::vector<vk::raii::ImageView> swapChainImageViews;
 
 	std::vector<const char *> requiredDeviceExtension = {
-	    vk::KHRSwapchainExtensionName,
-	    vk::KHRSpirv14ExtensionName,
-	    vk::KHRSynchronization2ExtensionName,
-	    vk::KHRCreateRenderpass2ExtensionName};
+	    vk::KHRSwapchainExtensionName};
 
 	void initWindow()
 	{

attachments/06_swap_chain_creation.cpp

@@ -56,10 +56,7 @@ class HelloTriangleApplication
 	std::vector<vk::raii::ImageView> swapChainImageViews;
 
 	std::vector<const char *> requiredDeviceExtension = {
-	    vk::KHRSwapchainExtensionName,
-	    vk::KHRSpirv14ExtensionName,
-	    vk::KHRSynchronization2ExtensionName,
-	    vk::KHRCreateRenderpass2ExtensionName};
+	    vk::KHRSwapchainExtensionName};
 
 	void initWindow()
 	{

attachments/07_image_views.cpp

@@ -56,10 +56,7 @@ class HelloTriangleApplication
 	std::vector<vk::raii::ImageView> swapChainImageViews;
 
 	std::vector<const char *> requiredDeviceExtension = {
-	    vk::KHRSwapchainExtensionName,
-	    vk::KHRSpirv14ExtensionName,
-	    vk::KHRSynchronization2ExtensionName,
-	    vk::KHRCreateRenderpass2ExtensionName};
+	    vk::KHRSwapchainExtensionName};
 
 	void initWindow()
 	{

attachments/08_graphics_pipeline.cpp

@@ -57,10 +57,7 @@ class HelloTriangleApplication
 	std::vector<vk::raii::ImageView> swapChainImageViews;
 
 	std::vector<const char *> requiredDeviceExtension = {
-	    vk::KHRSwapchainExtensionName,
-	    vk::KHRSpirv14ExtensionName,
-	    vk::KHRSynchronization2ExtensionName,
-	    vk::KHRCreateRenderpass2ExtensionName};
+	    vk::KHRSwapchainExtensionName};
 
 	void initWindow()
 	{