QVulkanInstance Class

    int main(int argc, char **argv)
    {
        QGuiApplication app(argc, argv);

        QVulkanInstance inst;
        if (!inst.create())
            return 1;

        // ...
        window->setVulkanInstance(&inst);
        window->show();

        return app.exec();
    }

    QVulkanInstance inst;

    // Enable validation layer, if supported. Messages go to qDebug by default.
    inst.setLayers({ "VK_LAYER_KHRONOS_validation" });

    bool ok = inst.create();
    if (!ok) {
        // ... Vulkan not available
    }

    if (!inst.layers().contains("VK_LAYER_KHRONOS_validation")) {
        // ... validation layer not available
    }

    QVulkanInstance inst;

    if (inst.supportedLayers().contains("VK_LAYER_KHRONOS_validation")) {
        // ...
    }
    bool ok = inst.create();
    // ...

clase VulkanWindow : public QWindow
{public: VulkanWindow() { setSurfaceType(VulkanSurface); } void exposeEvent(QExposeEvent *) { if (isExposed()) { if (!m_initialized) { m_initialized = true; // inicializar dispositivo, swapchain, etc.    QVulkanInstance *inst = vulkanInstance();                QVulkanFunctions *f =  inst->functions(); uint32_t devCount = 0;  f->vkEnumeratePhysicalDevices(inst->vkInstance(), &devCount, nullptr); // ... // construye el primer framerender(); } } } bool event(QEvent *e) { if (e->type() == QEvent::UpdateRequest) render(); return QWindow::event(e); } void render() { // ...requestUpdate(); // render continuamente}private: bool m_initialized = false; };int main(int argc, char**argv) { QGuiApplication app(argc, argv);    QVulkanInstance inst; if (!inst.create()) {        qWarning("Vulkan not available");
       return 1; } VulkanWindow window; window.showMaximized(); return app.exec(); }

bool myDebugFilter(VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT objectType, uint64_t object,
                   size_t location, int32_t messageCode, const char *pLayerPrefix, const char *pMessage)

std::function<bool(DebugMessageSeverityFlags severity, DebugMessageTypeFlags type, const void *message)>;

Documentación de la Función Miembro

QVulkanInstance::QVulkanInstance()

Construye una nueva instancia.

[noexcept] QVulkanInstance::~QVulkanInstance()

Destructor.

QVersionNumber QVulkanInstance::apiVersion() const

Devuelve la versión solicitada de la API Vulkan contra la que la aplicación espera ejecutarse, o un número de versión nulo si setApiVersion() no fue llamada antes de create().

Véase también setApiVersion().

[since 6.5] void QVulkanInstance::clearDebugOutputFilters()

Elimina todas las funciones de filtro instaladas previamente por installDebugOutputFilter().

Esta función se introdujo en Qt 6.5.

Véase también installDebugOutputFilter().

bool QVulkanInstance::create()

Inicializa la biblioteca Vulkan y crea una instancia Vulkan nueva o adopta una existente.

Devuelve true en caso de éxito, false en caso de error o cuando Vulkan no está soportado.

Si tiene éxito, el puntero a este QVulkanInstance es recuperable a través de vkInstance().

La instancia Vulkan y la biblioteca están disponibles mientras exista este QVulkanInstance, o hasta que se llame a destroy().

Por defecto, la VkInstance se crea con el flag VK_INSTANCE_CREATE_ENUMERATE_PORTABILITY_BIT_KHR activado. Esto significa que los dispositivos físicos de Portabilidad Vulkan son enumerados también. Si esto no se desea, establezca la bandera NoPortabilityDrivers.

void QVulkanInstance::destroy()

Destruye la instancia de la plataforma subyacente, destruyendo así la VkInstance (cuando se posee). El objeto QVulkanInstance sigue siendo reutilizable llamando de nuevo a create().

QVulkanDeviceFunctions *QVulkanInstance::deviceFunctions(VkDevice device)

Devuelve el objeto QVulkanDeviceFunctions que expone el conjunto de comandos Vulkan del núcleo a nivel de dispositivo y está garantizado para ser funcional multiplataforma.

Las funciones del núcleo de la API Vulkan 1.0 estarán siempre disponibles. Cuando se trata de versiones superiores de Vulkan, tales como, 1.1 y 1.2, el objeto QVulkanDeviceFunctions intentará resolver las funciones del núcleo de la API para estos también, pero si el dispositivo físico Vulkan en tiempo de ejecución no tiene soporte para estos, llamar a cualquier función no soportada dará lugar a un comportamiento no especificado. Para habilitar correctamente la compatibilidad con versiones de Vulkan superiores a la 1.0, puede ser necesario establecer una versión de API de instancia adecuada llamando a setApiVersion() antes de create(). Además, se espera que las aplicaciones comprueben el dispositivo físico apiVersion en VkPhysicalDeviceProperties.

Véase también functions() y resetDeviceFunctions().

VkResult QVulkanInstance::errorCode() const

Devuelve el código de error de Vulkan después de un create() fallido, VK_SUCCESS en caso contrario.

El valor es típicamente el valor de retorno de vkCreateInstance() (cuando se crea una nueva instancia Vulkan en lugar de adoptar una existente), pero también puede ser VK_NOT_READY si el plugin de plataforma no soporta Vulkan.

QByteArrayList QVulkanInstance::extensions() const

Devuelve las extensiones de instancia habilitadas, si se llamó a create() y tuvo éxito. Las extensiones solicitadas en caso contrario.

Véase también setExtensions().

QVulkanInstance::Flags QVulkanInstance::flags() const

Devuelve las banderas solicitadas.

Véase también setFlags().

QVulkanFunctions *QVulkanInstance::functions() const

Devuelve el objeto QVulkanFunctions correspondiente que expone el conjunto de comandos principales de Vulkan, excluyendo las funciones de nivel de dispositivo, y se garantiza que sea funcional en todas las plataformas.

Las funciones del núcleo de la API Vulkan 1.0 estarán siempre disponibles. Cuando se trate de versiones superiores de Vulkan, como 1.1 y 1.2, el objeto QVulkanFunctions intentará resolver también las funciones de la API del núcleo para esas versiones, pero si la implementación de la instancia Vulkan en tiempo de ejecución no tiene soporte para esas funciones, la llamada a cualquier función no soportada provocará un comportamiento no especificado. Además, para habilitar correctamente la compatibilidad con versiones de Vulkan superiores a la 1.0, puede ser necesario establecer una versión de API de instancia adecuada llamando a setApiVersion() antes de create(). Para consultar la versión a nivel de instancia de la implementación de Vulkan, llame a supportedApiVersion().

Véase también deviceFunctions() y supportedApiVersion().

PFN_vkVoidFunction QVulkanInstance::getInstanceProcAddr(const char *name)

Resuelve la función Vulkan con la dirección name.

Para los comandos principales de Vulkan, es preferible utilizar las envolturas de funciones recuperables de functions() y deviceFunctions().

[since 6.5] void QVulkanInstance::installDebugOutputFilter(QVulkanInstance::DebugUtilsFilter filter)

Instala una función filter que es llamada para cada mensaje de depuración Vulkan. Cuando la llamada de retorno devuelve true, el mensaje se detiene (se filtra) y no aparecerá en la salida de depuración.

Esta función se introdujo en Qt 6.5.

Véase también clearDebugOutputFilters().

void QVulkanInstance::installDebugOutputFilter(QVulkanInstance::DebugFilter filter)

Instala una función filter que es llamada para cada mensaje de depuración Vulkan. Cuando la llamada de retorno devuelve true, el mensaje se detiene (se filtra) y no aparecerá en la salida de depuración.

Véase también removeDebugOutputFilter().

bool QVulkanInstance::isValid() const

Devuelve true si create() tuvo éxito y la instancia es válida.

QByteArrayList QVulkanInstance::layers() const

Devuelve las capas de instancia habilitadas, si se llamó a create() y tuvo éxito. Las capas solicitadas en caso contrario.

Véase también setLayers().

void QVulkanInstance::presentAboutToBeQueued(QWindow *window)

Esta función debe ser llamada por el renderizador de la aplicación antes de poner en cola una operación presente para window.

Mientras que en algunas plataformas esto será un no-op, algunas pueden realizar una sincronización dependiente del sistema de ventanas. Por ejemplo, en Wayland esto añadirá enviar una petición wl_surface.frame para evitar que el controlador se bloquee por ventanas minimizadas.

void QVulkanInstance::presentQueued(QWindow *window)

Esta función debe ser llamada por el renderizador de la aplicación después de poner en cola una operación presente para window.

Mientras que en algunas plataformas esto será un no-op, algunas pueden realizar una sincronización dependiente del sistema de ventanas. Por ejemplo, en X11 esto actualizará _NET_WM_SYNC_REQUEST_COUNTER.

void QVulkanInstance::removeDebugOutputFilter(QVulkanInstance::DebugFilter filter)

Elimina una función filter previamente instalada por installDebugOutputFilter().

Véase también installDebugOutputFilter().

void QVulkanInstance::resetDeviceFunctions(VkDevice device)

Invalida y destruye el objeto QVulkanDeviceFunctions para el device dado.

Esta función debe ser llamada cuando un VkDevice, para el cual deviceFunctions() fue llamado, es destruido mientras la aplicación intenta continuar ejecutándose, posiblemente creando un nuevo dispositivo Vulkan lógico más tarde.

No es necesario llamar a esta función antes de destruir QVulkanInstance ya que la limpieza se realiza automáticamente.

Véase también deviceFunctions().

void QVulkanInstance::setApiVersion(const QVersionNumber &vulkanVersion)

Especifica la versión más alta de la API Vulkan que la aplicación está diseñada para utilizar.

Por defecto vulkanVersion es 0, que corresponde a Vulkan 1.0.

Se recomienda a los desarrolladores de aplicaciones que se familiaricen con las notas de apiVersion en la especificación Vulkan.

Véase también apiVersion() y supportedApiVersion().

void QVulkanInstance::setExtensions(const QByteArrayList &extensions)

Especifica la lista de instancias adicionales extensions a habilitar. Es seguro especificar extensiones no soportadas también porque estas son ignoradas cuando no son soportadas en tiempo de ejecución.

Véase también extensions().

void QVulkanInstance::setFlags(QVulkanInstance::Flags flags)

Configura el comportamiento de create() basándose en el flags proporcionado.

Véase también flags().

void QVulkanInstance::setLayers(const QByteArrayList &layers)

Especifica la lista de instancias layers a habilitar. Es seguro especificar también las capas no soportadas porque éstas se ignoran cuando no son soportadas en tiempo de ejecución.

Véase también layers().

void QVulkanInstance::setVkInstance(VkInstance existingVkInstance)

Hace que QVulkanInstance adopte un manejador VkInstance existente en lugar de crear uno nuevo.

Véase también vkInstance().

QVersionNumber QVulkanInstance::supportedApiVersion() const

Devuelve la versión de la funcionalidad a nivel de instancia soportada por la implementación de Vulkan.

En la práctica este es el valor devuelto por vkEnumerateInstanceVersion, si esa función está disponible (con Vulkan 1.1 y posteriores), o 1.0.

Las aplicaciones que quieran bifurcar su característica Vulkan y el uso de la API basándose en qué versión de Vulkan está disponible en tiempo de ejecución, pueden usar esta función para determinar qué versión pasar a setApiVersion() antes de llamar a create().

Véase también setApiVersion().

QVulkanInfoVector<QVulkanExtension> QVulkanInstance::supportedExtensions() const

Devuelve la lista de extensiones a nivel de instancia soportadas.

QVulkanInfoVector<QVulkanLayer> QVulkanInstance::supportedLayers() const

Devuelve la lista de capas de nivel de instancia soportadas.

bool QVulkanInstance::supportsPresent(VkPhysicalDevice physicalDevice, uint32_t queueFamilyIndex, QWindow *window)

Devuelve true si la familia de colas con queueFamilyIndex dentro de physicalDevice admite la presentación a window.

Llama a esta función cuando examina las colas de un dispositivo Vulkan dado, con el fin de decidir qué cola se puede utilizar para realizar la presentación.

[static] VkSurfaceKHR QVulkanInstance::surfaceForWindow(QWindow *window)

Crea o recupera el manejador VkSurfaceKHR ya existente para el window dado.

Devuelve el manejador de superficie Vulkan o 0 si falla.

VkInstance QVulkanInstance::vkInstance() const

Devuelve el manejador VkInstance que envuelve este QVulkanInstance, o nullptr si create() no ha sido llamado con éxito y no se ha proporcionado una instancia existente a través de setVkInstance().

Véase también setVkInstance().