QVulkanFunctions 類

The QVulkanFunctions class provides cross-platform access to the instance level core Vulkan 1.2 API. 更多...

頭：	#include <QVulkanFunctions>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake:	QT += gui

QVulkanFunctions is part of 3D 渲染 .

詳細描述

默認情況下，Qt 和 Qt 應用程序未鏈接到任何 Vulkan 庫。相反，在運行時動態解析所有函數。每個 QVulkanInstance 提供 QVulkanFunctions 可檢索對象憑藉 QVulkanInstance::functions (). This does not contain device level functions in order to avoid the potential overhead of an internal dispatching. Instead, functions that rely on a device, or a dispatchable child object of a device, are exposed via QVulkanDeviceFunctions and QVulkanInstance::deviceFunctions ()。QVulkanFunctions 和 QVulkanDeviceFunctions together provides access to the full core Vulkan API, excluding any extensions.

注意： 不可以直接構造 QVulkanFunctions 實例。

典型用法如下：

void Window::render()
{
    QVulkanInstance *inst = vulkanInstance();
    QVulkanFunctions *f = inst->functions();
    // ...
    VkResult err = f->vkAllocateCommandBuffers(device, &cmdBufInfo, &cmdBuf);
    // ...
}

注意： Windowing system interface (WSI) specifics and extensions are excluded. This class only covers core Vulkan commands, with the exception of instance creation, destruction, and function resolving, since such functionality is covered by QVulkanInstance 本身。

要訪問額外函數，應用程序可以使用 QVulkanInstance::getInstanceProcAddr () and vkGetDeviceProcAddr(). Applications can also decide to link to a Vulkan library directly, as platforms with an appropriate loader will typically export function symbols for the core commands. See vkGetInstanceProcAddr 手冊頁瞭解更多信息。

注意： The member function prototypes for Vulkan 1.1 and 1.2 commands are ifdefed with the appropriate VK_VERSION_1_x that is defined by the Vulkan headers. Therefore these functions will only be callable by an application when the system's (on which the application is built) Vulkan header is new enough and it contains 1.1 and 1.2 Vulkan API definitions. When building Qt from source, this has an additional consequence: the Vulkan headers on the build environment must also be 1.1 and 1.2 capable in order to get a Qt build that supports resolving the 1.1 and 1.2 API commands. If either of these conditions is not met, applications will only be able to call the Vulkan 1.0 commands through QVulkanFunctions and QVulkanDeviceFunctions .

另請參閱 QVulkanInstance , QVulkanDeviceFunctions , QWindow::setVulkanInstance ()，和 QWindow::setSurfaceType ().

內容

詳細描述