mirror/glfw
1
0
Fork 0
mirror of https://github.com/glfw/glfw.git synced 2024-11-26 22:34:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

Documentation work

Browse Source
This commit is contained in:
Camilla Berglund 2016-02-17 09:10:48 +01:00
parent b955936ee1
commit 41b82903a8
1 changed files with 21 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
docs/vulkan.dox
View File

@ -4,22 +4,24 @@
@tableofcontents @tableofcontents
This guide is intended to fill the gaps between the Vulkan documentation and the This guide is intended to fill the gaps between the [Vulkan
rest of the GLFW documentation and is not a replacement for either. documentation](https://www.khronos.org/vulkan/) and the rest of the GLFW
documentation and is not a replacement for either. It assumes some familiarity
with Vulkan concepts like loaders, devices, queues and surfaces.
To develop for Vulkan you should install an SDK for your platform, for example To develop for Vulkan you should install an SDK for your platform, for example
the [LunarG Vulkan SDK](http://lunarg.com/vulkan-sdk/). Apart from the headers the [LunarG Vulkan SDK](https://vulkan.lunarg.com/). Apart from the headers and
and libraries, it also provides the validation layers necessary for development. libraries, it also provides the validation layers necessary for development.
GLFW itself does not need a Vulkan SDK to enable support for Vulkan. However, The GLFW library does not need the Vulkan SDK to enable support for Vulkan.
any Vulkan-specific test and example programs are built only if the CMake files However, any Vulkan-specific test and example programs are built only if the
find the LunarG SDK. CMake files find a Vulkan SDK.
@section vulkan_include Including the Vulkan and GLFW header files @section vulkan_include Including the Vulkan and GLFW header files
To include the Vulkan header, define `GLFW_INCLUDE_VULKAN` before including the To include the Vulkan header, define [GLFW_INCLUDE_VULKAN](@ref build_macros)
GLFW header. before including the GLFW header.
@code @code
#define GLFW_INCLUDE_VULKAN #define GLFW_INCLUDE_VULKAN
@ -30,15 +32,15 @@ If you want to include the Vulkan header from a custom location or use your own
custom Vulkan header then you need to include them before the GLFW header. custom Vulkan header then you need to include them before the GLFW header.
@code @code
#include <custom/path/vulkan.h> #include <path/to/vulkan.h>
#include <GLFW/glfw3.h> #include <GLFW/glfw3.h>
@endcode @endcode
Unless a Vulkan header is included, either by the GLFW header or above it, any Unless a Vulkan header is included, either by the GLFW header or above it, any
GLFW functions that use Vulkan types will not be declared. GLFW functions that take or return Vulkan types will not be declared.
The `VK_USE_PLATFORM_*_KHR` macros do not need to be defined for the Vulkan part The `VK_USE_PLATFORM_*_KHR` macros do not need to be defined for the Vulkan part
of GLFW to work. of GLFW to work. Define them only if you are using these extensions directly.
@section vulkan_support Querying for Vulkan support @section vulkan_support Querying for Vulkan support
@ -110,8 +112,9 @@ be passed to @ref glfwGetPhysicalDevicePresentationSupport and @ref
glfwCreateWindowSurface. The set of extensions will vary depending on platform glfwCreateWindowSurface. The set of extensions will vary depending on platform
and may also vary depending on graphics drivers and other factors. and may also vary depending on graphics drivers and other factors.
If it fails it will return `NULL` and Vulkan window surface creation will not be If it fails it will return `NULL` and GLFW will not be able to create Vulkan
possible. You may still use Vulkan for off-screen rendering and compute work. window surfaces. You can still use Vulkan for off-screen rendering and compute
work.
The returned array will always contain `VK_KHR_surface`, so if you don't The returned array will always contain `VK_KHR_surface`, so if you don't
require any additional extensions you can pass this list directly to the require any additional extensions you can pass this list directly to the
@ -134,7 +137,7 @@ array, as it is an error to specify an extension more than once in the
@section vulkan_present Querying for Vulkan presentation support @section vulkan_present Querying for Vulkan presentation support
Not every Vulkan queue family of every device can present images to surfaces. Not every queue family of every Vulkan device can present images to surfaces.
To check whether a specific queue family of a physical device supports image To check whether a specific queue family of a physical device supports image
presentation without first having to create a window and surface, call @ref presentation without first having to create a window and surface, call @ref
glfwGetPhysicalDevicePresentationSupport. glfwGetPhysicalDevicePresentationSupport.
@ -146,15 +149,15 @@ if (glfwGetPhysicalDevicePresentationSupport(instance, physical_device, queue_fa
} }
@endcode @endcode
The `VK_KHR_surface` extension also provides the The `VK_KHR_surface` extension additionally provides the
`vkGetPhysicalDeviceSurfaceSupportKHR` function, which performs the same test on `vkGetPhysicalDeviceSurfaceSupportKHR` function, which performs the same test on
an existing Vulkan surface. an existing Vulkan surface.
@section vulkan_window Creating the window @section vulkan_window Creating the window
Unless you will be using OpenGL or OpenGL ES in addition to Vulkan, there is no Unless you will be using OpenGL or OpenGL ES with the same window as Vulkan,
need to create a context for that window. You can disable context creation by there is no need to create a context. You can disable context creation by
setting the [GLFW_CLIENT_API](@ref window_hints_ctx) hint to `GLFW_NO_API`. setting the [GLFW_CLIENT_API](@ref window_hints_ctx) hint to `GLFW_NO_API`.
@code @code