xsl/Vulkan-Samples
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

init

Browse Source
This commit is contained in:
xsl
2025-09-04 10:54:47 +08:00
commit 6bc8f61b18
1808 changed files with 208268 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
samples/extensions/full_screen_exclusive/CMakeLists.txt
+41
View File
@@ -0,0 +1,41 @@
# Copyright (c) 2023, Holochip Corporation
#
# SPDX-License-Identifier: Apache-2.0
#
# Licensed under the Apache License, Version 2.0 the "License";
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
get_filename_component(FOLDER_NAME ${CMAKE_CURRENT_LIST_DIR} NAME)
get_filename_component(PARENT_DIR ${CMAKE_CURRENT_LIST_DIR} PATH)
get_filename_component(CATEGORY_NAME ${PARENT_DIR} NAME)
#Full Screen exclusive is a windows only supported extension. We'll disable finding the sample on other platforms.
if (WIN32)
# Windows 11 fixed the reason for using full screen exclusive.
# We'll test for that here and not list the sample unless it's a candidate version of windows.
if (CMAKE_SYSTEM_VERSION)
set(ver ${CMAKE_SYSTEM_VERSION})
string(REGEX MATCH "^([0-9]+)" verMajor ${ver})
if ("${verMajor}" LESS_EQUAL "10")
add_sample(
ID ${FOLDER_NAME}
CATEGORY ${CATEGORY_NAME}
AUTHOR "Holochip Corporation"
NAME "Full Screen Exclusive"
DESCRIPTION "Demonstrates and showcases full_screen_exclusive related functionalities."
SHADER_FILES_GLSL
"triangle.vert"
"triangle.frag")
endif ()
endif ()
endif ()
samples/extensions/full_screen_exclusive/README.adoc
+46
View File
@@ -0,0 +1,46 @@
////
- Copyright (c) 2023, Holochip Corporation
-
- SPDX-License-Identifier: Apache-2.0
-
- Licensed under the Apache License, Version 2.0 the "License";
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
-
////
= Full Screen Exclusive
ifdef::site-gen-antora[]
TIP: The source for this sample can be found in the https://github.com/KhronosGroup/Vulkan-Samples/tree/main/samples/extensions/full_screen_exclusive[Khronos Vulkan samples github repository].
endif::[]
== Overview
This code sample demonstrates how to incorporate the Vulkan extension `VK_EXT_full_screen_exclusive`.
This extension provides a solution for the full screen exclusion issue on Windows prior to the 11 version.
Windows prior to 11 cannot correctly get an exclusive full screen window, `VK_EXT_full_screen_exclusive` is applicable on Windows prior to version 11 platform alone.
== Introduction
This sample provides a detailed procedure to activate full screen exclusive mode on Windows applications.
Users can switch display modes from: 1) windowed, 2) borderless fullscreen, and 3) exclusive fullscreen using keyboard inputs.
== *Reminder
Configuring the `swapchain create info` using full screen exclusive extension *DOES NOT* automatically set the application window to full screen mode.
The following procedure shows how to activate full screen exclusive mode correctly:
1) recreate the `swapchain` using `full screen exclusive`.
2) recreate the `frame buffers` with the new `swapchain`.
3) configure the application window to *fullscreen mode* 4) execute the `acquire full screen exclusive EXT` call.
* More details can be found in the link: https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-monitorfromwindow[MonitorFromWindow function (winuser.h)]
samples/extensions/full_screen_exclusive/full_screen_exclusive.cpp
+1060
View File
File diff suppressed because it is too large Load Diff
samples/extensions/full_screen_exclusive/full_screen_exclusive.h
+122
View File
@@ -0,0 +1,122 @@
/* Copyright (c) 2023-2025, Holochip Corporation
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0 the "License";
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* Demonstrates and showcases full_screen_exclusive and related functionalities
*/
#pragma once
#include "common/vk_common.h"
#include "core/instance.h"
#include "platform/application.h"
class FullScreenExclusive : public vkb::Application
{
private:
enum class SwapchainMode // This enum class represents all for stages from full screen exclusive EXT selections
{
Default,
Windowed,
BorderlessFullscreen,
ExclusiveFullscreen
};
enum class ApplicationWindowMode // This enum class represents the application window modes
{
Windowed,
Fullscreen
};
struct PerFrame
{
VkDevice device = VK_NULL_HANDLE;
VkFence queue_submit_fence = VK_NULL_HANDLE;
VkCommandPool primary_command_pool = VK_NULL_HANDLE;
VkCommandBuffer primary_command_buffer = VK_NULL_HANDLE;
VkSemaphore swapchain_acquire_semaphore = VK_NULL_HANDLE;
VkSemaphore swapchain_release_semaphore = VK_NULL_HANDLE;
int32_t queue_index{};
};
struct Context
{
VkInstance instance = VK_NULL_HANDLE;
VkPhysicalDevice gpu = VK_NULL_HANDLE;
VkDevice device = VK_NULL_HANDLE;
VkQueue queue = VK_NULL_HANDLE;
VkSwapchainKHR swapchain = VK_NULL_HANDLE;
VkExtent2D swapchain_dimensions;
VkFormat swapchain_format;
VkSurfaceKHR surface = VK_NULL_HANDLE;
int32_t graphics_queue_index = -1;
std::vector<VkImageView> swapchain_image_views{};
std::vector<VkFramebuffer> swapchain_framebuffers{};
VkRenderPass render_pass = VK_NULL_HANDLE;
VkPipeline pipeline = VK_NULL_HANDLE;
VkPipelineLayout pipeline_layout = VK_NULL_HANDLE;
VkDebugUtilsMessengerEXT debug_callback = VK_NULL_HANDLE;
std::vector<VkSemaphore> recycled_semaphores{};
std::vector<PerFrame> per_frame{};
};
private:
Context context{};
std::unique_ptr<vkb::core::InstanceC> vk_instance{};
HWND HWND_application_window{}; // sync the application HWND handle
bool is_windowed = true; // this is to tell if the application window is already set in the desired mode
WINDOWPLACEMENT wpc{}; // window placement information
LONG HWND_style = 0; // current Hwnd style
LONG HWND_extended_style = 0; // previous Hwnd style
VkSurfaceFullScreenExclusiveInfoEXT surface_full_screen_exclusive_info_EXT{}; // it can be created locally, however, it is a good reminder that they are declared here as a class variable
VkSurfaceFullScreenExclusiveWin32InfoEXT surface_full_screen_exclusive_Win32_info_EXT{};
bool is_full_screen_exclusive = false; // this is to tell if the screen is in full screen EXCLUSIVE or not
ApplicationWindowMode application_window_status = ApplicationWindowMode::Windowed; // declare and initialize the application window mode
SwapchainMode full_screen_status = SwapchainMode::Default; // declare and initialize the swapchain mode
private:
VkExtent2D get_current_max_image_extent() const; // This detects the maximum surface resolution and return them in vkExtent2D format
void input_event(const vkb::InputEvent &input_event) override; // This is to introduce a customized input events for switching application window and swapchain modes.
void update_application_window(); // This switches application window modes corresponding to the selected swapchain modes
void recreate(); // to recreate the swapchain and related per switch of display mode
public:
FullScreenExclusive() = default;
~FullScreenExclusive() override;
void initialize_windows();
bool prepare(const vkb::ApplicationOptions &options) override; // This syncs all required extensions and booleans is a Windows platform is detected
void update(float delta_time) override;
bool resize(uint32_t width, uint32_t height) override;
static bool validate_extensions(const std::vector<const char *> &required, const std::vector<VkExtensionProperties> &available);
void init_instance(const std::vector<const char *> &required_instance_extensions, const std::vector<const char *> &required_validation_layers);
void init_device(const std::vector<const char *> &required_device_extensions);
void init_per_frame(PerFrame &per_frame) const;
void teardown_per_frame(PerFrame &per_frame) const;
void init_swapchain();
void init_render_pass();
VkShaderModule load_shader_module(const char *path) const;
void init_pipeline();
VkResult acquire_next_image(uint32_t *image);
void render_triangle(uint32_t swapchain_index);
VkResult present_image(uint32_t index);
void init_framebuffers();
void teardown_framebuffers();
void teardown();
};
std::unique_ptr<vkb::Application> create_full_screen_exclusive();