QVulkanDeviceFunctions Class

Detaillierte Beschreibung

Qt und Qt-Anwendungen binden standardmäßig keine Vulkan-Bibliotheken ein. Stattdessen werden alle Funktionen dynamisch während der Laufzeit aufgelöst. Jedes QVulkanInstance bietet ein QVulkanFunctions Objekt, das über QVulkanInstance::functions() abrufbar ist. Dieses enthält keine Funktionen auf Geräteebene, um den potenziellen Overhead eines internen Dispatchings zu vermeiden. Stattdessen werden Funktionen, die auf ein Gerät oder ein dispatchbares Kindobjekt eines Geräts angewiesen sind, über QVulkanDeviceFunctions und QVulkanInstance::deviceFunctions() zur Verfügung gestellt. QVulkanFunctions und QVulkanDeviceFunctions bieten zusammen Zugriff auf die gesamte Kern-Vulkan-API, mit Ausnahme aller Erweiterungen.

Die typische Verwendung ist die folgende:

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

Das QVulkanDeviceFunctions-Objekt, das für das bereitgestellte VkDevice spezifisch ist, wird erstellt, wenn QVulkanInstance::deviceFunctions() zum ersten Mal mit dem fraglichen Gerät aufgerufen wird. Das Objekt wird dann intern zwischengespeichert.

Um auf zusätzliche Funktionen zuzugreifen, können Anwendungen QVulkanInstance::getInstanceProcAddr() und vkGetDeviceProcAddr() verwenden. Anwendungen können sich auch dafür entscheiden, sich direkt mit einer Vulkan-Bibliothek zu verbinden, da viele Implementierungen Funktionssymbole für die Kernbefehle exportieren. Weitere Informationen finden Sie in der Man Page für vkGetInstanceProcAddr.