test

.github/workflows/build.yml

@@ -28,16 +28,19 @@ jobs:
           #}
           - {
             name: "linux: gcc",
-            cc: "gcc-10",
-            cxx: "g++-10"
+            cc: "gcc-13",
+            cxx: "g++-13"
           }
         # note: if a specific vulkan version (e.g. 1.1.x, or < 1.2.135) needs testing, you can add it here:
         # (not that ubuntu-latest (20.04) only supports >= v1.2.148 via apt)
-        vulkan-sdk: ["latest", "1.2.176"]
-        vma: ["OFF"]
+        vulkan-sdk: ["latest", "1.3.216", "1.2.198"]
+        vma: ["ON", "OFF"]
+        exclude: # exclude combinations that are known to fail
+          - vulkan-sdk: "1.2.198"
+            vma: "ON"
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
 
       - name: Create Build Environment
         shell: bash
@@ -52,13 +55,18 @@ jobs:
             sudo wget -qO /etc/apt/sources.list.d/lunarg-vulkan-${{ matrix.vulkan-sdk }}-focal.list https://packages.lunarg.com/vulkan/${{ matrix.vulkan-sdk }}/lunarg-vulkan-${{ matrix.vulkan-sdk }}-focal.list
           fi
 
+          # For GCC-13
+          sudo add-apt-repository -y ppa:ubuntu-toolchain-r/ppa
+
           # Update package lists
           sudo apt-get update -qq
 
           # Install dependencies
           sudo apt-get install -y \
-            vulkan-sdk
-
+            vulkan-sdk \
+            g++-13 \
+            gcc-13
+
           # clang does not yet (<= 12) support "Down with typename" (P0634R3), which is used in libstdc++ >= 11 in the ranges-header
           if [ "${{ matrix.config.cc }}" = "clang" ]; then
             sudo apt remove libgcc-11-dev gcc-11
@@ -86,7 +94,7 @@ jobs:
         run: cmake --build .
 
   windows:
-    name: ${{ matrix.config.name }}, VulkanSDK ${{ matrix.vulkan-sdk }}, VMA=${{ matrix.vma }}
+    name: ${{ matrix.config.name }}, windows-2019, VulkanSDK ${{ matrix.vulkan-sdk }}, VMA=${{ matrix.vma }}
     runs-on: windows-2019
     env:
       vulkan_sdk: "$GITHUB_WORKSPACE/vulkan_sdk/"
@@ -99,16 +107,19 @@ jobs:
             cc: "cl",
             cxx: "cl"
           }
-        # note: if a specific vulkan version (e.g. 1.1.x, or < 1.2.135) needs testing, you can add it here:
-        vulkan-sdk: ["latest", "1.2.176.1"]
-        vma: ["OFF"]
+        # note: if a specific vulkan version needs testing, you can add it here:
+        vulkan-sdk: ["latest", "1.3.216.0", "1.2.198.1"]
+        vma: ["ON", "OFF"]
+        exclude: # exclude combinations that are known to fail
+          - vulkan-sdk: "1.2.198"
+            vma: "ON"
 
     steps:
-      # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
-      - uses: actions/checkout@v2
+      # apparently checkout@v3 pulls to Auto-Vk/Auto-Vk on windows
+      - uses: actions/checkout@v3
 
       - name: Create Build Environment
-        # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
+        # apparently checkout@v3 pulls to Auto-Vk/Auto-Vk on windows
         working-directory: ${{ runner.workspace }}/${{ github.event.repository.name }}
         shell: pwsh
         # Some projects don't allow in-source building, so create a separate build directory
@@ -121,6 +132,8 @@ jobs:
             curl -LS -o vulkan-sdk.exe https://sdk.lunarg.com/sdk/download/${{ matrix.vulkan-sdk }}/windows/VulkanSDK-${{ matrix.vulkan-sdk }}-Installer.exe
           }
           7z x vulkan-sdk.exe -o"${{ env.vulkan_sdk }}"
+          mkdir "${{ env.vulkan_sdk }}Include/vma/"
+          curl -LS -o "${{ env.vulkan_sdk }}Include/vma/vk_mem_alloc.h" https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator/blob/master/include/vk_mem_alloc.h?raw=true
 
           # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
           cmake -E make_directory ${{ runner.workspace }}/${{ github.event.repository.name }}/build
@@ -138,19 +151,22 @@ jobs:
           $env:CC="${{ matrix.config.cc }}"
           $env:CXX="${{ matrix.config.cxx }}"
           $env:Path += ";${{ env.vulkan_sdk }}\;${{ env.vulkan_sdk }}\Bin\"
+          $env:VULKAN_SDK="${{ env.vulkan_sdk }}"
+          $env:Vulkan_LIBRARY="${{ env.vulkan_sdk }}/Bin"
+          $env:Vulkan_INCLUDE_DIR="${{ env.vulkan_sdk }}/Include"
 
           # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
           cmake -DCMAKE_BUILD_TYPE=$BUILD_TYPE -Davk_LibraryType=STATIC ${{ runner.workspace }}/${{ github.event.repository.name }} -Davk_UseVMA=${{ matrix.vma }} -G "Visual Studio 16 2019" -A x64
 
       - name: Build
         shell: bash
-        # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
+        # apparently checkout@v3 pulls to Auto-Vk/Auto-Vk on windows
         working-directory: ${{ runner.workspace }}/${{ github.event.repository.name }}/build
         # Execute the build.  You can specify a specific target with "--target <NAME>"
-        run: cmake --build .
+        run: VULKAN_SDK=${{ env.vulkan_sdk }} cmake --build . --config $BUILD_TYPE
 
   windows-latest:
-    name: ${{ matrix.config.name }}, VulkanSDK ${{ matrix.vulkan-sdk }}, VMA=${{ matrix.vma }}
+    name: ${{ matrix.config.name }}, windows-latest, VulkanSDK ${{ matrix.vulkan-sdk }}, VMA=${{ matrix.vma }}
     runs-on: windows-latest
     env:
       vulkan_sdk: "$GITHUB_WORKSPACE/vulkan_sdk/"
@@ -163,16 +179,19 @@ jobs:
             cc: "cl",
             cxx: "cl"
           }
-        # note: if a specific vulkan version (e.g. 1.1.x, or < 1.2.135) needs testing, you can add it here:
-        vulkan-sdk: ["latest", "1.2.176.1"]
-        vma: ["OFF"]
+        # note: if a specific vulkan version needs testing, you can add it here:
+        vulkan-sdk: ["latest", "1.3.216.0", "1.2.198.1"]
+        vma: ["ON", "OFF"]
+        exclude: # exclude combinations that are known to fail
+          - vulkan-sdk: "1.2.198"
+            vma: "ON"
 
     steps:
-      # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
-      - uses: actions/checkout@v2
+      # apparently checkout@v3 pulls to Auto-Vk/Auto-Vk on windows
+      - uses: actions/checkout@v3
 
       - name: Create Build Environment
-        # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
+        # apparently checkout@v3 pulls to Auto-Vk/Auto-Vk on windows
         working-directory: ${{ runner.workspace }}/${{ github.event.repository.name }}
         shell: pwsh
         # Some projects don't allow in-source building, so create a separate build directory
@@ -185,8 +204,10 @@ jobs:
             curl -LS -o vulkan-sdk.exe https://sdk.lunarg.com/sdk/download/${{ matrix.vulkan-sdk }}/windows/VulkanSDK-${{ matrix.vulkan-sdk }}-Installer.exe
           }
           7z x vulkan-sdk.exe -o"${{ env.vulkan_sdk }}"
+          mkdir "${{ env.vulkan_sdk }}Include/vma/"
+          curl -LS -o "${{ env.vulkan_sdk }}Include/vma/vk_mem_alloc.h" https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator/blob/master/include/vk_mem_alloc.h?raw=true
 
-          # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
+          # apparently checkout@v3 pulls to Auto-Vk/Auto-Vk on windows
           cmake -E make_directory ${{ runner.workspace }}/${{ github.event.repository.name }}/build
 
       - name: Configure CMake
@@ -201,14 +222,15 @@ jobs:
         run: |
           $env:CC="${{ matrix.config.cc }}"
           $env:CXX="${{ matrix.config.cxx }}"
+          $env:VULKAN_SDK="${{ env.vulkan_sdk }}"
+          $env:Vulkan_LIBRARY="${{ env.vulkan_sdk }}/Bin"
+          $env:Vulkan_INCLUDE_DIR="${{ env.vulkan_sdk }}/Include"
           $env:Path += ";${{ env.vulkan_sdk }}\;${{ env.vulkan_sdk }}\Bin\"
-
-          # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
           cmake -DCMAKE_BUILD_TYPE=$BUILD_TYPE -Davk_LibraryType=STATIC ${{ runner.workspace }}/${{ github.event.repository.name }} -Davk_UseVMA=${{ matrix.vma }} -G "Visual Studio 17 2022" -A x64
 
       - name: Build
         shell: bash
-        # apparently checkout@v2 pulls to Auto-Vk/Auto-Vk on windows
+        # apparently checkout@v3 pulls to Auto-Vk/Auto-Vk on windows
         working-directory: ${{ runner.workspace }}/${{ github.event.repository.name }}/build
         # Execute the build.  You can specify a specific target with "--target <NAME>"
-        run: cmake --build .
+        run: cmake --build . --config $BUILD_TYPE

CMakeLists.txt

@@ -1,10 +1,9 @@
-cmake_minimum_required(VERSION 3.13)
+cmake_minimum_required(VERSION 3.16)
 project(avk)
 
 if (MSVC)
     # <ranges> support requires /std:c++latest on MSVC
-    set(CMAKE_CXX_STANDARD 23)
-    add_compile_options(/bigobj)
+    set(CMAKE_CXX_STANDARD 20)
 else (MSVC)
     set(CMAKE_CXX_STANDARD 20)
 endif (MSVC)

README.md

@@ -13,7 +13,7 @@ I.e., the big, important concepts, which make Vulkan as performant as it can be-
 # Setup
 
 _Auto-Vk_ requires
-* A Vulkan 1.2 SDK or a Vulkan 1.3 SDK
+* A Vulkan 1.3 SDK
 * [Vulkan-Hpp](https://github.com/KhronosGroup/Vulkan-Hpp)
 * A C++20 compiler
 
@@ -79,7 +79,7 @@ avk::framebuffer framebuffer = myRoot.create_framebuffer(...);
 avk::semaphore imageAvailableSemaphore = ...;
 
 mRoot.record({
-      avk::command::render_pass(graphicsPipeline->renderpass_reference(), framebuffer.as_reference(), {
+      avk::command::render_pass(graphicsPipeline->renderpass_reference().value(), framebuffer.as_reference(), {
           avk::command::bind_pipeline(graphicsPipeline.as_reference()),
           avk::command::draw(3u, 1u, 0u, 0u)
       })

include/avk/attachment.hpp

@@ -60,6 +60,35 @@ namespace avk
 		 */
 		static attachment declare_for(const image_view_t& aImageView, attachment_load_config aLoadOp, subpass_usages aUsageInSubpasses, attachment_store_config aStoreOp);
 
+		/**	Declare multisampled format of an attachment for a dynamic rendering pipeline. This attachment can only be used with pipeline that has dynamic rendering enabled.
+	 	 *  It has fewer parameters than regular attachment since some of its values (load/store ops etc...) are set when starting the dynamic render pass
+		 *  as opposed to being declared beforehand..
+		 *	@param	aFormatAndSamples	Multisampled format definition: A tuple with the format of the attachment in its first element, and with the number of samples in its second element.
+		 *	@param	aUsage				How is this attachment being used in the renderpass? In contrast to non-dynamic attachments, this usage can only contain a single subpass as such 
+		 *                              Possible values in namespace avk::usage::
+		 *                              Usages for different subpasses can be defined by concatenating them using operator>>.
+		 *                              Example 1: avk::usage::color(0) 					   // Indicates that this attachment is used as color attachment at location=0 in the renderpass
+		 *                              Example 2: avk::usage::color(2) + usage::resolve_to(3) // Indicates that this attachment is used as color attachment at location=2 in the renderpass
+		 *                                                                                     // Additionally, at the end of renderpass, its contents are resolved into the attachment at index 3.
+		 *                              Example 3: usage::unused // Indicates that this attachment is unused in the renderpass (it will only be used as a resolve target for example)
+		 */
+		static attachment declare_dynamic(std::tuple<vk::Format, vk::SampleCountFlagBits> aFormatAndSamples, subpass_usages aUsage);
+
+		/**	Declare multisampled format of an attachment for a dynamic rendering pipeline. This attachment can only be used with pipeline that has dynamic rendering enabled.
+	 	 *  It has fewer parameters than regular attachment since some of its values (load/store ops etc...) are set when starting the dynamic render pass
+		 *  as opposed to being declared beforehand..
+		 *	@param	aFormat	 The format of the attachment
+		 */
+		static attachment declare_dynamic(vk::Format aFormat, subpass_usages aUsage);
+
+		/**	Declare multisampled format of an attachment for a dynamic rendering pipeline. This attachment can only be used with pipeline that has dynamic rendering enabled.
+	 	 *  It has fewer parameters than regular attachment since some of its values (load/store ops etc...) are set when starting the dynamic render pass
+		 *  as opposed to being declared beforehand..
+		 *	@param	aImageView			The format of the attachment is copied from the given image view.
+		 */
+		static attachment declare_dynamic_for(const image_view_t& aImageView, subpass_usages aUsage);
+
+
 		attachment& set_clear_color(std::array<float, 4> aColor) { mColorClearValue = aColor; return *this; }
 		attachment& set_depth_clear_value(float aDepthClear) { mDepthClearValue = aDepthClear; return *this; }
 		attachment& set_stencil_clear_value(uint32_t aStencilClear) { mStencilClearValue = aStencilClear; return *this; }
@@ -88,6 +117,8 @@ namespace avk
 		auto sample_count() const { return mSampleCount; }
 		/** True if a multisample resolve pass shall be set up. */
 		auto is_to_be_resolved() const { return mSubpassUsages.contains_resolve(); }
+		/** True if this attachment is declared for dynamic rendering pipelines ie. using one of the dynamic declare functions*/
+		bool is_for_dynamic_rendering() const { return mDynamicRenderingAttachment; }
 
 		/** Returns the stencil load operation */
 		auto get_stencil_load_op() const { return mStencilLoadOperation.value_or(mLoadOperation); }
@@ -108,5 +139,6 @@ namespace avk
 		std::array<float, 4> mColorClearValue;
 		float mDepthClearValue;
 		uint32_t mStencilClearValue;
+		bool mDynamicRenderingAttachment;
 	};
 }

include/avk/avk.hpp

@@ -711,11 +711,12 @@ namespace avk
 		 *	@param	aAlterConfigBeforeCreation	Optional custom callback function which can be used to alter the new pipeline's config right before it is being created on the device.
 		 *	@return A new graphics pipeline instance.
 		 */
-		graphics_pipeline create_graphics_pipeline_from_template(const graphics_pipeline_t& aTemplate, renderpass aNewRenderpass, std::optional<cfg::subpass_index> aSubpassIndex = {}, std::function<void(graphics_pipeline_t&)> aAlterConfigBeforeCreation = {});
+		graphics_pipeline create_graphics_pipeline_from_template(const graphics_pipeline_t& aTemplate, std::optional<renderpass> aNewRenderpass, std::optional<cfg::subpass_index> aSubpassIndex = {}, std::function<void(graphics_pipeline_t&)> aAlterConfigBeforeCreation = {});
 
-		/**	Creates a graphics pipeline based on another graphics pipeline, which serves as a template,
-		 *	which either uses the same renderpass (if it has shared ownership enabled) or creates a new
-		 *	renderpass internally using create_renderpass_from_template with the template's renderpass.
+		/**	Creates a graphics pipeline based on another graphics pipeline, which serves as a template, which either:
+		 *  	- uses the same renderpass (if it has shared ownership enabled)
+		 *      - creates a new renderpass internally using create_renderpass_from_template with the template's renderpass
+		 *      - uses dynamic rendering and thus does not need to create new renderpass
 		 *	@param	aTemplate					Another, already existing graphics pipeline, which serves as a template for the newly created graphics pipeline.
 		 *	@param	aAlterConfigBeforeCreation	Optional custom callback function which can be used to alter the new pipeline's config right before it is being created on the device.
 		 *	@return A new graphics pipeline instance.
@@ -728,6 +729,7 @@ namespace avk
 		 *   - cfg::pipeline_settings (flags)
 		 *   - renderpass
 		 *   - avk::attachment (use either attachments or renderpass!)
+		 *   - avk::dynamic_rendering_attachment (only use if dynamic_rendering::enabled)
 		 *   - input_binding_location_data (vertex input)
 		 *   - cfg::primitive_topology
 		 *   - shader_info
@@ -736,6 +738,7 @@ namespace avk
 		 *   - cfg::depth_write
 		 *   - cfg::viewport_depth_scissors_config
 		 *   - cfg::culling_mode
+		 *   - cfg::dynamic_rendering
 		 *   - cfg::front_face
 		 *   - cfg::polygon_drawing
 		 *   - cfg::rasterizer_geometry_mode
@@ -759,17 +762,39 @@ namespace avk
 			std::function<void(graphics_pipeline_t&)> alterConfigFunction;
 			graphics_pipeline_config config;
 			add_config(config, renderPassAttachments, alterConfigFunction, std::move(args)...);
-
-			// Check if render pass attachments are in renderPassAttachments XOR config => only in that case, it is clear how to proceed, fail in other cases
-			if (renderPassAttachments.size() > 0 == (config.mRenderPassSubpass.has_value() && static_cast<bool>(std::get<renderpass>(*config.mRenderPassSubpass)->handle()))) {
-				if (renderPassAttachments.size() == 0) {
-					throw avk::runtime_error("No renderpass config provided! Please provide a renderpass or attachments!");
+			bool hasRenderPassAttachments = false;
+			bool hasDynamicRenderingAttachments = false;
+			for(const auto & attachment : renderPassAttachments)
+			{
+				if(attachment.is_for_dynamic_rendering())
+				{
+					hasDynamicRenderingAttachments = true;
+				} else {
+					hasRenderPassAttachments = true;
 				}
-				throw avk::runtime_error("Ambiguous renderpass config! Either set a renderpass XOR provide attachments!");
 			}
+
+			const bool hasValidRenderPass = config.mRenderPassSubpass.has_value() && static_cast<bool>(std::get<renderpass>(*config.mRenderPassSubpass)->handle());
+			const bool isDynamicRenderingSet = config.mDynamicRendering == avk::cfg::dynamic_rendering::enabled;
+			// Check all invalid configurations when dynamic rendering is set
+			if (isDynamicRenderingSet )
+			{
+				if(hasValidRenderPass) 		 		{ throw avk::runtime_error("Dynamic rendering does not accept renderpasses! They are set dynamically during rendering!"); }
+				if(hasRenderPassAttachments) 		{ throw avk::runtime_error("Only avk::attachments created by declare_dynamic(_for) functions are allowed when dynamic rendering is enabled!"); }
+				if(!hasDynamicRenderingAttachments) { throw avk::runtime_error("Dynamic rendering enabled but no avk::attachmenst created by declare_dynamic(_for) functions provided! Please provide at least one attachment!"); }
+			} 
+			// Check all invalid configurations when normal rendering (with renderpasses) is used
+			else 
+			{
+				if(hasValidRenderPass && hasRenderPassAttachments) 	{ throw avk::runtime_error("Ambiguous renderpass config! Either set a renderpass OR provide attachments but not both at the same time!"); }
+				if(!(hasValidRenderPass || hasRenderPassAttachments)) { throw avk::runtime_error("No renderpass config provided! Please provide a renderpass or attachments!"); }
+			}
+
 			// ^ that was the sanity check. See if we have to build the renderpass from the attachments:
-			if (renderPassAttachments.size() > 0) {
+			if (hasRenderPassAttachments) {
 				add_config(config, renderPassAttachments, alterConfigFunction, create_renderpass(std::move(renderPassAttachments)));
+			} else {
+				config.mDynamicRenderingAttachments = std::move(renderPassAttachments);
 			}
 
 			// 2. CREATE PIPELINE according to the config