QQuickGraphicsDevice Class
La clase `QQuickGraphicsDevice` proporciona un contenedor opaco para objetos gráficos nativos que representan dispositivos o contextos gráficos. Más información...
| Encabezado: | #include <QQuickGraphicsDevice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Desde: | Qt 6.0 |
Funciones públicas
| QQuickGraphicsDevice() | |
| ~QQuickGraphicsDevice() | |
| bool | isNull() const |
Miembros públicos estáticos
| QQuickGraphicsDevice | fromAdapter(quint32 adapterLuidLow, qint32 adapterLuidHigh, int featureLevel = 0) |
| QQuickGraphicsDevice | fromDeviceAndCommandQueue(MTLDevice *device, MTLCommandQueue *commandQueue) |
| QQuickGraphicsDevice | fromDeviceAndContext(void *device, void *context) |
| QQuickGraphicsDevice | fromDeviceObjects(VkPhysicalDevice physicalDevice, VkDevice device, int queueFamilyIndex, int queueIndex = 0) |
| QQuickGraphicsDevice | fromOpenGLContext(QOpenGLContext *context) |
| QQuickGraphicsDevice | fromPhysicalDevice(VkPhysicalDevice physicalDevice) |
(since 6.6) QQuickGraphicsDevice | fromRhi(QRhi *rhi) |
(since 6.10) QQuickGraphicsDevice | fromRhiAdapter(QRhiAdapter *adapter) |
Véase también QQuickWindow::setGraphicsDevice() y QQuickRenderTarget.
Documentación de funciones de miembro
QQuickGraphicsDevice::QQuickGraphicsDevice()
Crea un objeto QQuickGraphicsDevice predeterminado que no hace referencia a ningún objeto nativo.
[noexcept] QQuickGraphicsDevice::~QQuickGraphicsDevice()
Destructor.
[static] QQuickGraphicsDevice QQuickGraphicsDevice::fromAdapter(quint32 adapterLuidLow, qint32 adapterLuidHigh, int featureLevel = 0)
Devuelve un nuevo objeto ` QQuickGraphicsDevice ` que describe un adaptador DXGI y un nivel de características de D3D.
Esta función de fábrica es adecuada para Direct3D 11 y 12, especialmente en combinación con OpenXR. Los parámetros « adapterLuidLow » y « adapterLuidHigh » especifican conjuntamente un LUID, mientras que «featureLevel» especifica un valor de « D3D_FEATURE_LEVEL_ ». « featureLevel » puede establecerse en 0 si no se pretende especificarlo, en cuyo caso se utilizarán los valores predeterminados del grafo de escena.
Nota: En Direct 3D 12, ` featureLevel ` especifica el nivel de características de ` minimum ` que se pasa a `D3D12CreateDevice()`.
[static] QQuickGraphicsDevice QQuickGraphicsDevice::fromDeviceAndCommandQueue(MTLDevice *device, MTLCommandQueue *commandQueue)
Devuelve un nuevo objeto ` QQuickGraphicsDevice ` que hace referencia a un objeto ` device ` y a un objeto ` commandQueue ` ya existentes.
Esta función de fábrica es compatible con Metal.
Nota: el objeto ` QQuickGraphicsDevice ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias. Es responsabilidad de quien realiza la llamada asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
[static] QQuickGraphicsDevice QQuickGraphicsDevice::fromDeviceAndContext(void *device, void *context)
Devuelve un nuevo objeto ` QQuickGraphicsDevice ` que hace referencia a un dispositivo nativo y a un objeto de contexto.
Esta función de fábrica es compatible con Direct3D 11. Se espera que ` device ` sea un ` ID3D11Device*` y que ` context ` sea un ` ID3D11DeviceContext*`.
También es compatible con Direct 3D 12, si esa es la API 3D utilizada en tiempo de ejecución. Con D3D12, ` context ` no se utiliza y puede establecerse en `null`. Se espera que ` device ` sea un ` ID3D12Device*`.
Nota: el objeto ` QQuickGraphicsDevice ` resultante no es propietario de ningún recurso nativo, sino que simplemente contiene referencias. Es responsabilidad del llamante garantizar que el recurso nativo exista durante el tiempo que sea necesario.
[static] QQuickGraphicsDevice QQuickGraphicsDevice::fromDeviceObjects(VkPhysicalDevice physicalDevice, VkDevice device, int queueFamilyIndex, int queueIndex = 0)
Devuelve un nuevo objeto ` QQuickGraphicsDevice ` que hace referencia a un objeto ` device ` ya existente.
Esta función de fábrica es adecuada para Vulkan. Siempre deben proporcionarse los parámetros ` physicalDevice`, ` device ` y ` queueFamilyIndex `. El parámetro ` queueIndex ` es opcional, ya que el valor por defecto, 0, suele ser adecuado.
Nota: el objeto ` QQuickGraphicsDevice ` resultante no es propietario de ningún recurso nativo, sino que simplemente contiene referencias. Es responsabilidad de quien realiza la llamada asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
[static] QQuickGraphicsDevice QQuickGraphicsDevice::fromOpenGLContext(QOpenGLContext *context)
Devuelve un nuevo objeto ` QQuickGraphicsDevice ` que hace referencia a un objeto ` context` de OpenGL ya existente.
Esta función de fábrica es adecuada para OpenGL.
Nota: Es responsabilidad del llamante asegurarse de que context sea compatible y utilizable con QQuickWindow. Es responsabilidad del llamante evitar las incompatibilidades específicas de la plataforma en el QSurfaceFormat asociado, así como los problemas de subprocesos derivados de intentar utilizar context en varios subprocesos.
[static] QQuickGraphicsDevice QQuickGraphicsDevice::fromPhysicalDevice(VkPhysicalDevice physicalDevice)
Devuelve un nuevo objeto ` QQuickGraphicsDevice ` que hace referencia a un objeto ` physicalDevice` ya existente.
Esta función de fábrica es adecuada para Vulkan, especialmente en combinación con OpenXR.
Nota: el ` QQuickGraphicsDevice ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias. Es responsabilidad de quien realiza la llamada asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
[static, since 6.6] QQuickGraphicsDevice QQuickGraphicsDevice::fromRhi(QRhi *rhi)
Devuelve un nuevo objeto ` QQuickGraphicsDevice ` que hace referencia a un objeto ` rhi ` ya existente.
Nota: Al igual que con fromOpenGLContext(), el usuario debe tener cuidado de compartir únicamente un QRhi (y, por tanto, el contexto gráfico o dispositivo subyacente) entre QQuickWindows que se sepa que son compatibles, sin infringir las normas de la API gráfica subyacente en lo que respecta a subprocesos, formatos de píxeles, etc.
Esta función se introdujo en Qt 6.6.
[static, since 6.10] QQuickGraphicsDevice QQuickGraphicsDevice::fromRhiAdapter(QRhiAdapter *adapter)
Devuelve un nuevo objeto ` QQuickGraphicsDevice ` que hace referencia a un objeto ` adapter ` existente de tipo ` QRhiAdapter `.
No es aplicable a los backends de « QRhi » ni a las API gráficas en las que « QRhiAdapter » no tenga una implementación real.
Equivalente a ` fromAdapter()` para Direct 3D y a ` fromPhysicalDevice()` para Vulkan.
Nota: No se adquierela propiedad de ` adapter`, y debe permanecer válido como mínimo hasta que se inicialice el grafo de escena, lo que probablemente ocurra cuando el ` QQuickWindow ` asociado quede expuesto.
Esta función se introdujo en Qt 6.10.
Véase también QRhi::enumerateAdapters().
bool QQuickGraphicsDevice::isNull() const
Devuelve «true» si se trata de un dispositivo gráfico creado de forma predeterminada que no hace referencia a ningún objeto nativo.
© 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.