En esta página

QVulkanWindowRenderer Class

La clase `QVulkanWindowRenderer` se utiliza para implementar la lógica de renderizado específica de la aplicación para un ` QVulkanWindow`. Más información...

Encabezado: #include <QVulkanWindowRenderer>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Funciones públicas

virtual ~QVulkanWindowRenderer()
virtual void initResources()
virtual void initSwapChainResources()
virtual void logicalDeviceLost()
virtual void physicalDeviceLost()
virtual void preInitResources()
virtual void releaseResources()
virtual void releaseSwapChainResources()
virtual void startNextFrame() = 0

Descripción detallada

Las aplicaciones suelen crear subclases tanto de ` QVulkanWindow ` como de `QVulkanWindowRenderer`. La primera permite gestionar eventos, por ejemplo, de entrada, mientras que la segunda permite implementar la gestión de recursos de Vulkan y la creación del búfer de comandos que conforman el renderizado de la aplicación.

Además de la gestión de eventos, la subclase de QVulkanWindow también se encarga de proporcionar una implementación para QVulkanWindow::createRenderer(). Aquí es donde se conectan la ventana y el renderizador. Una implementación típica se limitará a crear una nueva instancia de una subclase de QVulkanWindowRenderer.

Documentación de las funciones miembro

[virtual noexcept] QVulkanWindowRenderer::~QVulkanWindowRenderer()

Destructor virtual.

[virtual] void QVulkanWindowRenderer::initResources()

Esta función virtual se invoca cuando llega el momento de crear los recursos gráficos del renderizador.

Dependiendo del indicador « QVulkanWindow::PersistentResources », de situaciones de pérdida del dispositivo, etc., esta función puede llamarse más de una vez durante el ciclo de vida de un ` QVulkanWindow`. Sin embargo, las invocaciones posteriores siempre van precedidas de una llamada a ` releaseResources()`.

Solo se garantiza que los accesores como `device()`, `graphicsQueue()` y `graphicsCommandPool()` devuelvan valores válidos dentro de esta función y posteriormente, hasta que se llame a ` releaseResources()`.

La implementación por defecto está vacía.

[virtual] void QVulkanWindowRenderer::initSwapChainResources()

Esta función virtual se invoca cuando se puede llevar a cabo la inicialización relacionada con la cadena de intercambio (swapchain), el búfer de fotogramas (framebuffer) o el paso de renderizado (renderpass). La cadena de intercambio y los recursos relacionados se reinician y, a continuación, se vuelven a crear en respuesta a los eventos de cambio de tamaño de la ventana; por lo tanto, entre un par de llamadas a ` initResources()` y ` releaseResources()` puede haber varias llamadas a `initSwapChainResources()` y ` releaseSwapChainResources()`.

Solo se garantiza que los accesores como ` QVulkanWindow::swapChainImageSize()` devuelvan valores válidos dentro de esta función y posteriormente, hasta que se llame a ` releaseSwapChainResources()`.

Este es también el lugar donde deben realizarse los cálculos dependientes del tamaño (por ejemplo, la matriz de proyección), ya que esta función se invoca efectivamente cada vez que se cambia el tamaño.

La implementación por defecto está vacía.

[virtual] void QVulkanWindowRenderer::logicalDeviceLost()

Esta función virtual se invoca cuando se pierde el dispositivo lógico (VkDevice), lo que significa que alguna operación ha fallado con el error « VK_ERROR_DEVICE_LOST ».

La implementación por defecto está vacía.

Normalmente no es necesario realizar ninguna acción especial en esta función. QVulkanWindow liberará automáticamente todos los recursos (invocando releaseSwapChainResources() y releaseResources() según sea necesario) e intentará reinicializarse, adquiriendo un nuevo dispositivo. Cuando también se ha perdido el dispositivo físico, este intento de reinicialización puede dar lugar a physicalDeviceLost().

Véase también physicalDeviceLost().

[virtual] void QVulkanWindowRenderer::physicalDeviceLost()

Esta función virtual se invoca cuando se pierde el dispositivo físico, lo que significa que la creación del dispositivo lógico falla con el error « VK_ERROR_DEVICE_LOST ».

La implementación por defecto está vacía.

Normalmente no es necesario realizar ninguna acción especial en esta función, ya que QVulkanWindow volverá a intentar inicializarse automáticamente tras un tiempo determinado.

Véase también ` logicalDeviceLost()`.

[virtual] void QVulkanWindowRenderer::preInitResources()

Esta función virtual se invoca justo antes de que comience la inicialización de gráficos, que culmina con la llamada a ` initResources()`.

Normalmente no es necesario reimplementar esta función. Sin embargo, hay casos que implican decisiones basadas tanto en el dispositivo físico como en la superficie. Estas no suelen poder llevarse a cabo antes de hacer visible ` QVulkanWindow `, ya que la superficie de Vulkan no es recuperable en esa fase.

En su lugar, las aplicaciones pueden reimplementar esta función. En este caso, tanto ` QVulkanWindow::physicalDevice()` como ` QVulkanInstance::surfaceForWindow()` son funcionales, pero aún no se ha llevado a cabo ninguna inicialización lógica adicional del dispositivo.

La implementación por defecto está vacía.

[virtual] void QVulkanWindowRenderer::releaseResources()

Esta función virtual se invoca cuando es necesario liberar los recursos gráficos del renderizador.

La implementación debe estar preparada para que una llamada a esta función pueda ir seguida de un ` initResources()` en un momento posterior.

QVulkanWindow Se encarga de esperar a que el dispositivo quede inactivo antes y después de invocar esta función.

La implementación por defecto está vacía.

[virtual] void QVulkanWindowRenderer::releaseSwapChainResources()

Esta función virtual se invoca cuando es necesario liberar recursos relacionados con la cadena de intercambio, el búfer de fotogramas o la pasada de renderizado.

La implementación debe estar preparada para que una llamada a esta función pueda ir seguida de una nueva llamada a initSwapChainResources() en un momento posterior.

QVulkanWindow Se encarga de esperar a que el dispositivo quede inactivo antes y después de invocar esta función.

La implementación por defecto está vacía.

Nota: Este es el último momento en el que se puede actuar con todos los recursos gráficos intactos antes de que ` QVulkanWindow ` comience a liberarlos. Por lo tanto, es esencial que las implementaciones con un ` startNextFrame()` asíncrono, y potencialmente multihilo, realicen una espera bloqueante y llamen a ` QVulkanWindow::frameReady()` antes de salir de esta función, en caso de que haya un envío de fotograma pendiente.

[pure virtual] void QVulkanWindowRenderer::startNextFrame()

Esta función virtual se invoca cuando hay que añadir al búfer de comandos las llamadas de dibujo correspondientes al siguiente fotograma.

Cada llamada a esta función debe ir seguida de una llamada a ` QVulkanWindow::frameReady()`. Si no se hace así, el bucle de renderizado se bloqueará. La llamada también puede realizarse más tarde, tras regresar de esta función. Esto significa que es posible iniciar tareas asíncronas y actualizar el búfer de comandos y notificar a ` QVulkanWindow ` solo cuando dichas tareas hayan finalizado.

Todos los recursos de Vulkan están inicializados y listos cuando se invoca esta función. El framebuffer actual y el búfer de comandos principal se pueden recuperar mediante QVulkanWindow::currentFramebuffer() y QVulkanWindow::currentCommandBuffer(). El dispositivo lógico y la cola de gráficos activa están disponibles mediante QVulkanWindow::device() y QVulkanWindow::graphicsQueue(). Las implementaciones pueden crear búferes de comandos adicionales a partir del conjunto devuelto por QVulkanWindow::graphicsCommandPool(). Para mayor comodidad, el índice de un tipo de memoria visible para el host y el índice de un tipo de memoria local del dispositivo se exponen mediante QVulkanWindow::hostVisibleMemoryIndex() y QVulkanWindow::deviceLocalMemoryIndex(). Todos estos accesores pueden invocarse de forma segura desde cualquier hilo.

Véanse también QVulkanWindow::frameReady() y QVulkanWindow.

© 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.