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.

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:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
© 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.