Grafo de escena: Vulkan en QML
Muestra cómo renderizar directamente con Vulkan en una escena de « Qt Quick ».

Nota: Para compilar este ejemplo se necesita un SDK. Consulta la sección «Integración con Vulkan» para obtener información sobre qué instalar.
Descripción general
Este ejemplo utiliza las señales « QQuickWindow::beforeRendering()» y « QQuickWindow::beforeRenderPassRecording()» para dibujar contenido personalizado de Vulkan en una escena « Qt Quick ». Se utiliza QML para renderizar una etiqueta de texto en la parte superior.
El ejemplo es equivalente en la mayoría de los aspectos a los ejemplos «OpenGL bajo QML», «Direct3D 11 bajo QML» y «Metal bajo QML»; todos ellos representan el mismo contenido personalizado, solo que a través de diferentes API nativas.
En esta documentación se tratarán los aspectos específicos del uso de QML sin profundizar en los detalles del renderizado personalizado de Vulkan.
Cómo influir en el renderizado de Vulkan desde QML
El ejemplo muestra cómo utilizar valores expuestos a QML para controlar el renderizado de Vulkan.
Para exponer el valor umbral t a QML, en la definición de VulkanSquircle, utilizamos las macros Q_OBJECT, Q_PROPERTY y QML_ELEMENT de la siguiente manera:
class VulkanSquircle : public QQuickItem
{
Q_OBJECT
Q_PROPERTY(qreal t READ t WRITE setT NOTIFY tChanged)
QML_ELEMENTA continuación, declaramos elementos públicos y privados:
public:
VulkanSquircle();
qreal t() const { return m_t; }
void setT(qreal t);
signals:
void tChanged();
public slots:
void sync();
void cleanup();
private slots:
void handleWindowChanged(QQuickWindow *win);
private:
void releaseResources() override;
qreal m_t = 0;
SquircleRenderer *m_renderer = nullptr;A continuación, en ` main.qml ` animamos el valor umbral utilizando un ` NumberAnimation`.
VulkanSquircle {
SequentialAnimation on t {
NumberAnimation { to: 1; duration: 2500; easing.type: Easing.InQuad }
NumberAnimation { to: 0; duration: 2500; easing.type: Easing.OutQuad }
loops: Animation.InfiniteLa variable ` t ` es utilizada en última instancia por el programa de sombreado SPIR-V que dibuja los «squircles».
Uso de señales para renderizar contenido personalizado de Vulkan
Se utilizan las señales QQuickWindow::beforeRendering() y QQuickWindow::beforeRenderPassRecording().
La señal QQuickWindow::beforeRendering() se emite al inicio de cada fotograma, antes de que el grafo de escena comience su renderizado. Esto significa que cualquier llamada de dibujo de Vulkan que se realice en respuesta a esta señal se apilará bajo los elementos Qt Quick. Hay dos señales porque los comandos personalizados de Vulkan se registran en el mismo búfer de comandos que utiliza el grafo de escena.
La función beforeRendering() por sí sola no es suficiente para esto, ya que se emite al inicio del fotograma, antes de que se registre el inicio de una instancia de renderpass mediante vkCmdBeginRenderPass.
La solución: al conectarse a beforeRenderPassRecording(), los comandos propios de la aplicación y la estructura del grafo de escena quedarán en el orden correcto.
La conexión de las señales se realiza mediante la función ` sync() `:
void VulkanSquircle::sync()
{
if (!m_renderer) {
m_renderer = new SquircleRenderer;
// Initializing resources is done before starting to record the
// renderpass, regardless of wanting an underlay or overlay.
connect(window(), &QQuickWindow::beforeRendering, m_renderer, &SquircleRenderer::frameStart, Qt::DirectConnection);
// Here we want an underlay and therefore connect to
// beforeRenderPassRecording. Changing to afterRenderPassRecording
// would render the squircle on top (overlay).
connect(window(), &QQuickWindow::beforeRenderPassRecording, m_renderer, &SquircleRenderer::mainPassRecordingStart, Qt::DirectConnection);
}
m_renderer->setViewportSize(window()->size() * window()->devicePixelRatio());
m_renderer->setT(m_t);Otra forma de renderizar contenido Vulkan sobre la escena de ` Qt Quick ` es conectándose a las señales ` QQuickWindow::afterRendering()` y ` QQuickWindow::afterRenderPassRecording()`.
© 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.