adding image copy utils

.gitea/workflows/CI.yml

@@ -0,0 +1,45 @@
+name: Windows
+
+on:
+  repository_dispatch:
+    types: [create-pull-request]
+  pull_request:
+  push:
+    paths-ignore:
+      - '.gitignore'
+      - 'LICENSE'
+      - 'README.md'
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-x86_64, macos-x86_64, ubuntu-latest]
+
+    runs-on: ${{ matrix.os }}
+    if: "!contains(github.event.head_commit.message, 'ci skip')"
+
+    steps:
+    - name: Get current date as package key
+      id: cache_key
+      shell: bash
+      run: echo "key=$(date +'%W')" >> "$GITHUB_OUTPUT"
+
+    - name: Checkout repository
+      uses: actions/checkout@v6
+
+    - name: Set xmake env
+      run: echo "XMAKE_GLOBALDIR=${{ runner.workspace }}/xmake-global" >> $GITHUB_ENV
+
+    - name: Setup xmake
+      uses: xmake-io/github-action-setup-xmake@v1
+      with:
+        xmake-version: branch@master
+        actions-cache-folder: .xmake-cache-W${{ steps.cache_key.outputs.key }}
+
+    - name: Update xmake repository
+      run: cd sandbox && xmake repo --update
+
+    - name: Build test
+      run: cd sandbox && xmake --yes

.gitignore

@@ -2,3 +2,5 @@
 *.swp
 *.swx
 sandbox/test
+sandbox/build/
+sandbox/.xmake/

README.md

@@ -1,9 +1,9 @@
-# KVF
+# KVF <a href="https://git.kbz8.me/kbz_8/KVF/actions?workflows=CI.yml"><img src="https://git.kbz8.me/kbz_8/KVF/actions/workflows/CI.yml/badge.svg"></a>
 
 KVF (kbz_8 vulkan framework) is a lightweight single-header Vulkan framework written in C99 to simplify the creation of Vulkan applications.
 It is designed to be a drop in framework inside any existing Vulkan renderer as it does not use any custom types of structs (except for the graphics pipeline builder).
 
-Here's a simple C example of a hello world triangle using KVF and SDL2:
+Here's a simple C example of a hello world triangle using KVF and SDL2 :
 ```C
 #include <SDL2/SDL.h>
 #include <SDL2/SDL_timer.h>
@@ -45,7 +45,7 @@ int main(void)
 	// Swapchain creation
 	VkExtent2D extent;
 	SDL_Vulkan_GetDrawableSize(win, (int*)&extent.width, (int*)&extent.height);
-	VkSwapchainKHR swapchain = kvfCreateSwapchainKHR(device, ph_device, surface, extent, true);
+	VkSwapchainKHR swapchain = kvfCreateSwapchainKHR(device, ph_device, surface, extent, VK_NULL_HANDLE, true, true);
 
 	// Swapchain images acquisition
 	uint32_t swapchain_images_count = kvfGetSwapchainImagesCount(swapchain);
@@ -55,8 +55,8 @@ int main(void)
 	for(uint32_t i = 0; i < swapchain_images_count; i++)
 	{
 		VkCommandBuffer cmd = kvfCreateCommandBuffer(device);
-		kvfTransitionImageLayout(device, swapchain_images[i], cmd, kvfGetSwapchainImagesFormat(swapchain), VK_IMAGE_LAYOUT_UNDEFINED, VK_IMAGE_LAYOUT_PRESENT_SRC_KHR, true);
+		kvfTransitionImageLayout(device, swapchain_images[i], KVF_IMAGE_COLOR, cmd, kvfGetSwapchainImagesFormat(swapchain), VK_IMAGE_LAYOUT_UNDEFINED, VK_IMAGE_LAYOUT_PRESENT_SRC_KHR, true);
-		swapchain_images_views[i] = kvfCreateImageView(device, swapchain_images[i], kvfGetSwapchainImagesFormat(swapchain), VK_IMAGE_VIEW_TYPE_2D, VK_IMAGE_ASPECT_COLOR_BIT);
+		swapchain_images_views[i] = kvfCreateImageView(device, swapchain_images[i], kvfGetSwapchainImagesFormat(swapchain), VK_IMAGE_VIEW_TYPE_2D, VK_IMAGE_ASPECT_COLOR_BIT, 1);
 	}
 
 	// Sync objects creation
@@ -85,10 +85,11 @@ int main(void)
 	kvfGPipelineBuilderSetCullMode(builder, VK_CULL_MODE_NONE, VK_FRONT_FACE_CLOCKWISE);
 	kvfGPipelineBuilderAddShaderStage(builder, VK_SHADER_STAGE_VERTEX_BIT, vertex_shader_module, "main");
 	kvfGPipelineBuilderAddShaderStage(builder, VK_SHADER_STAGE_FRAGMENT_BIT, fragment_shader_module, "main");
+    	kvfGPipelineBuilderSetMultisampling(builder , VK_SAMPLE_COUNT_1_BIT);
 	kvfGPipelineBuilderDisableDepthTest(builder);
 	kvfGPipelineBuilderDisableBlending(builder);
 
-	VkPipeline pipeline = kvfCreateGraphicsPipeline(device, pipeline_layout, builder, renderpass);
+	VkPipeline pipeline = kvfCreateGraphicsPipeline(device, VK_NULL_HANDLE, pipeline_layout, builder, renderpass);
 
 	kvfDestroyGPipelineBuilder(builder);
 	kvfDestroyShaderModule(device, vertex_shader_module);
@@ -152,3 +153,7 @@ int main(void)
 }
 
 ```
+
+<p align="center">
+    <img src="https://github.com/Kbz-8/KVF/blob/46aa29be4facef398aeab0b7e82bff84aab683ce/sandbox/screenshot.png" alt="drawing" width="500"/>
+</p>

sandbox/Makefile

@@ -1,10 +0,0 @@
-NAME = ./test
-
-CC = clang
-
-all : $(NAME)
-
-$(NAME):
-	$(CC) -o $(NAME) main.c -lvulkan -lSDL2 -g
-
-.PHONY: all

sandbox/main.c

@@ -80,7 +80,7 @@ int main(void)
 	// Swapchain creation
 	VkExtent2D extent;
 	SDL_Vulkan_GetDrawableSize(win, (int*)&extent.width, (int*)&extent.height);
-	VkSwapchainKHR swapchain = kvfCreateSwapchainKHR(device, ph_device, surface, extent, true);
+	VkSwapchainKHR swapchain = kvfCreateSwapchainKHR(device, ph_device, surface, extent, VK_NULL_HANDLE, true, true);
 
 	// Swapchain images acquisition
 	uint32_t swapchain_images_count = kvfGetSwapchainImagesCount(swapchain);
@@ -90,8 +90,8 @@ int main(void)
 	for(uint32_t i = 0; i < swapchain_images_count; i++)
 	{
 		VkCommandBuffer cmd = kvfCreateCommandBuffer(device);
-		kvfTransitionImageLayout(device, swapchain_images[i], cmd, kvfGetSwapchainImagesFormat(swapchain), VK_IMAGE_LAYOUT_UNDEFINED, VK_IMAGE_LAYOUT_PRESENT_SRC_KHR, true);
+		kvfTransitionImageLayout(device, swapchain_images[i], KVF_IMAGE_COLOR, cmd, kvfGetSwapchainImagesFormat(swapchain), VK_IMAGE_LAYOUT_UNDEFINED, VK_IMAGE_LAYOUT_PRESENT_SRC_KHR, true);
-		swapchain_images_views[i] = kvfCreateImageView(device, swapchain_images[i], kvfGetSwapchainImagesFormat(swapchain), VK_IMAGE_VIEW_TYPE_2D, VK_IMAGE_ASPECT_COLOR_BIT);
+		swapchain_images_views[i] = kvfCreateImageView(device, swapchain_images[i], kvfGetSwapchainImagesFormat(swapchain), VK_IMAGE_VIEW_TYPE_2D, VK_IMAGE_ASPECT_COLOR_BIT, 1);
 	}
 
 	// Sync objects creation
@@ -118,12 +118,13 @@ int main(void)
 	kvfGPipelineBuilderSetInputTopology(builder, VK_PRIMITIVE_TOPOLOGY_TRIANGLE_LIST);
 	kvfGPipelineBuilderSetPolygonMode(builder, VK_POLYGON_MODE_FILL, 1.0f);
 	kvfGPipelineBuilderSetCullMode(builder, VK_CULL_MODE_NONE, VK_FRONT_FACE_CLOCKWISE);
+	kvfGPipelineBuilderSetMultisampling(builder, VK_SAMPLE_COUNT_1_BIT);
 	kvfGPipelineBuilderAddShaderStage(builder, VK_SHADER_STAGE_VERTEX_BIT, vertex_shader_module, "main");
 	kvfGPipelineBuilderAddShaderStage(builder, VK_SHADER_STAGE_FRAGMENT_BIT, fragment_shader_module, "main");
 	kvfGPipelineBuilderDisableDepthTest(builder);
 	kvfGPipelineBuilderDisableBlending(builder);
 
-	VkPipeline pipeline = kvfCreateGraphicsPipeline(device, pipeline_layout, builder, renderpass);
+	VkPipeline pipeline = kvfCreateGraphicsPipeline(device, VK_NULL_HANDLE, pipeline_layout, builder, renderpass);
 
 	kvfDestroyGPipelineBuilder(builder);
 	kvfDestroyShaderModule(device, vertex_shader_module);

sandbox/xmake.lua

@@ -0,0 +1,11 @@
+add_requires("libsdl2", { configs = { sdlmain = false } })
+add_requires("vulkan-headers")
+
+target("test")
+	set_kind("binary")
+	add_linkdirs("./")
+	add_files("main.c", { languages = "c99" })
+	add_defines("SDL_MAIN_HANDLED")
+	add_packages("libsdl2", "vulkan-headers")
+	add_syslinks("vulkan")
+target_end()