En esta página

Ejemplo de «Hola» con el triángulo de Vulkan

Muestra los conceptos básicos del renderizado con « QVulkanWindow » y la API de Vulkan.

El ejemplo «Hello Vulkan Triangle» crea un proceso gráfico completo, que incluye un sombreador de vértices y un sombreador de fragmentos, para renderizar un triángulo.

Captura de pantalla de un ejemplo

Inicio

Cada aplicación Qt que utilice Vulkan deberá contar con un objeto ` Vulkan instance `, que encapsula el estado a nivel de aplicación e inicializa una biblioteca Vulkan.

Un objeto « QVulkanWindow » debe estar siempre asociado a un objeto « QVulkanInstance » y, por lo tanto, en el ejemplo se crea la instancia antes que la ventana. El objeto « QVulkanInstance » también debe permanecer activo más tiempo que la ventana.

    QVulkanInstance inst;
    inst.setLayers({ "VK_LAYER_KHRONOS_validation" });
    if (!inst.create())
        qFatal("Failed to create Vulkan instance: %d", inst.errorCode());

El ejemplo habilita las capas de validación, siempre que sean compatibles. Si las capas solicitadas no están presentes, la solicitud se ignorará. Se pueden habilitar capas y extensiones adicionales de forma similar.

    VulkanWindow w;
    w.setVulkanInstance(&inst);

    w.resize(1024, 768);
    w.show();

Una vez que la instancia está lista, es el momento de crear una ventana. Ten en cuenta que ` w ` reside en la pila y se declara después de ` inst`.

La subclase QVulkanWindow

Para añadir funcionalidad personalizada a un ` QVulkanWindow`, se utiliza la subclasificación. Esto sigue los patrones existentes de ` QOpenGLWindow ` y ` QOpenGLWidget`. Sin embargo, ` QVulkanWindow ` utiliza un objeto ` QVulkanWindowRenderer ` independiente.

La subclase ` QVulkanWindow ` reimplementa la función de fábrica ` QVulkanWindow::createRenderer()`. Esta simplemente devuelve una nueva instancia de la subclase ` QVulkanWindowRenderer `. Para poder acceder a diversos recursos de Vulkan a través del objeto `window`, se pasa un puntero a la ventana y se almacena mediante el constructor.

class VulkanWindow : public QVulkanWindow
{
public:
    QVulkanWindowRenderer *createRenderer() override;
};

El renderizado real

QVulkanWindow Las subclases ponen en cola sus llamadas de dibujo en su reimplementación de ` QVulkanWindowRenderer::startNextFrame()`. Una vez hecho esto, deben llamar de nuevo a ` QVulkanWindow::frameReady()`. El ejemplo no incluye generación asíncrona de comandos, por lo que la llamada a `frameReady()` se realiza directamente desde `startNextFrame()`. Para obtener actualizaciones continuas, el ejemplo simplemente invoca ` QWindow::requestUpdate()` con el fin de programar un repintado.

El ejemplo también muestra el antialiasing multimuestra. Basándose en el número de muestras compatibles indicado por QVulkanWindow::supportedSampleCounts(), el ejemplo elige entre 8x, 4x o ningún multimuestreo. Una vez configurado mediante `QVulkanWindow::setSamples()`, ` QVulkanWindow ` se encarga del resto: los búferes de color multimuestra adicionales se crean automáticamente, y la resolución en los búferes de la cadena de intercambio se lleva a cabo al final de la pasada de renderizado predeterminada para cada fotograma.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Proyecto de ejemplo en code.qt.io

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.