QQuickRenderTarget Class
La clase QQuickRenderTarget proporciona un contenedor opaco para recursos gráficos nativos que especifican un destino de renderizado y los metadatos asociados. Más información...
| Encabezado: | #include <QQuickRenderTarget> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Desde: | Qt 6.0 |
Tipos públicos
Funciones públicas
| QQuickRenderTarget() | |
| ~QQuickRenderTarget() | |
(since 6.8) QRhiTexture * | depthTexture() const |
(since 6.3) qreal | devicePixelRatio() const |
| bool | isNull() const |
(since 6.4) bool | mirrorVertically() const |
(since 6.8) void | setDepthTexture(QRhiTexture *texture) |
(since 6.3) void | setDevicePixelRatio(qreal ratio) |
(since 6.4) void | setMirrorVertically(bool enable) |
Miembros públicos estáticos
(since 6.4) QQuickRenderTarget | fromD3D11Texture(void *texture, uint format, const QSize &pixelSize, int sampleCount = 1) |
| QQuickRenderTarget | fromD3D11Texture(void *texture, const QSize &pixelSize, int sampleCount = 1) |
(since 6.8) QQuickRenderTarget | fromD3D11Texture(void *texture, uint format, QSize pixelSize, int sampleCount, QQuickRenderTarget::Flags flags) |
(since 6.6) QQuickRenderTarget | fromD3D12Texture(void *texture, int resourceState, uint format, const QSize &pixelSize, int sampleCount = 1) |
(since 6.8) QQuickRenderTarget | fromD3D12Texture(void *texture, int resourceState, uint format, uint viewFormat, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags) |
(since 6.4) QQuickRenderTarget | fromMetalTexture(MTLTexture *texture, uint format, const QSize &pixelSize, int sampleCount = 1) |
| QQuickRenderTarget | fromMetalTexture(MTLTexture *texture, const QSize &pixelSize, int sampleCount = 1) |
(since 6.8) QQuickRenderTarget | fromMetalTexture(MTLTexture *texture, uint format, uint viewFormat, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags) |
(since 6.2) QQuickRenderTarget | fromOpenGLRenderBuffer(uint renderbufferId, const QSize &pixelSize, int sampleCount = 1) |
(since 6.4) QQuickRenderTarget | fromOpenGLTexture(uint textureId, uint format, const QSize &pixelSize, int sampleCount = 1) |
| QQuickRenderTarget | fromOpenGLTexture(uint textureId, const QSize &pixelSize, int sampleCount = 1) |
(since 6.8) QQuickRenderTarget | fromOpenGLTexture(uint textureId, uint format, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags) |
(since 6.4) QQuickRenderTarget | fromPaintDevice(QPaintDevice *device) |
(since 6.6) QQuickRenderTarget | fromRhiRenderTarget(QRhiRenderTarget *renderTarget) |
(since 6.4) QQuickRenderTarget | fromVulkanImage(VkImage image, VkImageLayout layout, VkFormat format, const QSize &pixelSize, int sampleCount = 1) |
| QQuickRenderTarget | fromVulkanImage(VkImage image, VkImageLayout layout, const QSize &pixelSize, int sampleCount = 1) |
(since 6.8) QQuickRenderTarget | fromVulkanImage(VkImage image, VkImageLayout layout, VkFormat format, VkFormat viewFormat, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags) |
Elementos no miembros relacionados
| bool | operator!=(const QQuickRenderTarget &a, const QQuickRenderTarget &b) |
| bool | operator==(const QQuickRenderTarget &a, const QQuickRenderTarget &b) |
Véase también QQuickWindow::setRenderTarget() y QQuickGraphicsDevice.
Documentación sobre el tipo de miembro
[since 6.8] enum class QQuickRenderTarget::Flag
flags QQuickRenderTarget::Flags
Parámetros para las funciones constructoras estáticas de ` QQuickRenderTarget `.
| Constante | Valor | Descripción |
|---|---|---|
QQuickRenderTarget::Flag::MultisampleResolve | 0x01 | Indica que el argumento ` sampleCount ` no es el número de muestras de la textura proporcionada (y que la textura sigue siendo una textura no multisample), sino más bien el número de muestras deseado para el antialiasing multisample. Activa la creación y gestión automáticas de una textura multisample intermedia (o matriz de texturas) como búfer de color, de forma transparente para la aplicación. Las muestras se resuelven automáticamente en la textura proporcionada al final de la pasada de renderizado. Cuando este indicador no está activado y el argumento ` sampleCount ` es mayor que 1, se deduce que la textura proporcionada es multisample. El indicador no tiene ningún efecto si ` sampleCount ` es 1 (lo que indica que no se utiliza el multisampling). |
Esta enumeración se introdujo en Qt 6.8.
El tipo Flags es un typedef de QFlags<Flag>. Almacena una combinación OR de valores de Flag.
Documentación de las funciones miembro
QQuickRenderTarget::QQuickRenderTarget()
Crea un objeto QQuickRenderTarget predeterminado que no hace referencia a ningún objeto nativo.
[noexcept] QQuickRenderTarget::~QQuickRenderTarget()
Destructor.
[since 6.8] QRhiTexture *QQuickRenderTarget::depthTexture() const
Devuelve la textura de profundidad establecida actualmente o, en la mayoría de los casos, ` nullptr`.
El valor solo es distinto de nulo cuando se ha llamado a ` setDepthTexture()`.
Esta función se introdujo en Qt 6.8.
Véase también ` setDepthTexture()`.
[since 6.3] qreal QQuickRenderTarget::devicePixelRatio() const
Devuelve la relación de píxeles del dispositivo para el destino de renderizado. Se trata de la relación entre los píxeles del dispositivo y los píxeles independientes del dispositivo.
La relación de píxeles del dispositivo por defecto es 1,0.
Esta función se introdujo en Qt 6.3.
Véase también setDevicePixelRatio().
[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromD3D11Texture(void *texture, uint format, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de textura D3D11 especificado por ` texture`.
format especifica el DXGI_FORMAT de la textura. Solo deben utilizarse formatos de textura compatibles con la infraestructura de renderizado de Qt.
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada.
La textura se utiliza como el primer adjunto de color del destino de renderizado utilizado por el grafo de escena de « Qt Quick ». Si procede, se crea y se utiliza automáticamente un búfer de profundidad-estencil.
Nota: el « QQuickRenderTarget » resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados sobre el tamaño y el número de muestras. Es responsabilidad de quien llama a la función asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
Esta función se introdujo en Qt 6.4.
Véase también « QQuickWindow::setRenderTarget()» y « QQuickRenderControl ».
[static] QQuickRenderTarget QQuickRenderTarget::fromD3D11Texture(void *texture, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de textura D3D11 especificado por ` texture`. Se supone que la textura tiene el formato `DXGI_FORMAT_R8G8B8A8_UNORM`.
pixelSize especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada.
La textura se utiliza como el primer adjunto de color del objetivo de renderizado utilizado por el grafo de escena « Qt Quick ». Si procede, se crea y se utiliza automáticamente un búfer de profundidad-plantilla.
Nota: el ` QQuickRenderTarget ` resultante no es propietario de ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad de quien llama a la función asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
Esta es una función sobrecargada.
Véase también ` QQuickWindow::setRenderTarget()` y ` QQuickRenderControl`.
[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromD3D11Texture(void *texture, uint format, QSize pixelSize, int sampleCount, QQuickRenderTarget::Flags flags)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de textura D3D11 especificado por ` texture`.
format especifica el DXGI_FORMAT de la textura. Solo deben utilizarse formatos de textura compatibles con la infraestructura de renderizado de Qt.
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada, excepto cuando ` flags ` contiene ` MultisampleResolve`. En ese caso, se asume que ` texture ` es una textura 2D sin multimuestreo y ` sampleCount ` define el número de muestras deseado. El « QQuickRenderTarget » resultante utilizará como adjunto de color una textura multisample intermedia creada automáticamente, y resolverá las muestras en texture. Este es el método recomendado para aplicar MSAA cuando la textura nativa aún no es multisample.
La textura se utiliza como primer adjunto de color del objetivo de renderizado utilizado por el grafo de escena Qt Quick. Si procede, se crea y se utiliza automáticamente un búfer de profundidad-plantilla. Cuando el búfer de color es multimuestra, el búfer de profundidad-plantilla también será automáticamente multimuestra.
Nota: el ` QQuickRenderTarget ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados sobre el tamaño y el número de muestras. Es responsabilidad de quien realiza la llamada asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
Véase también QQuickWindow::setRenderTarget(), QQuickRenderControl y fromD3D11Texture().
[static, since 6.6] QQuickRenderTarget QQuickRenderTarget::fromD3D12Texture(void *texture, int resourceState, uint format, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de textura D3D12 especificado por ` texture`.
resourceState debe ser una máscara de bits válida con bits de D3D12_RESOURCE_STATES, que especifique el estado actual del recurso.
format especifica el DXGI_FORMAT de la textura. Solo deben utilizarse formatos de textura compatibles con la infraestructura de renderizado de Qt.
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada.
La textura se utiliza como el primer adjunto de color del destino de renderizado utilizado por el grafo de escena de Qt Quick. Si procede, se crea y se utiliza automáticamente un búfer de profundidad y estencil.
Nota: el ` QQuickRenderTarget ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad del llamante asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
Esta función se introdujo en Qt 6.6.
Véase también ` QQuickWindow::setRenderTarget()` y ` QQuickRenderControl`.
[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromD3D12Texture(void *texture, int resourceState, uint format, uint viewFormat, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a una textura 2D de D3D12 o a un objeto de matriz de texturas 2D especificado por ` texture`.
resourceState debe ser una máscara de bits válida con bits de D3D12_RESOURCE_STATES, que especifique el estado actual del recurso.
format especifica el DXGI_FORMAT de la textura. Solo deben utilizarse formatos de textura compatibles con la infraestructura de renderizado de Qt.
viewFormat es el DXGI_FORMAT utilizado para la vista de destino de renderizado (RTV). A menudo es igual que format. Solo funciona cuando el controlador admite la conversión de formato relajada; en caso contrario, se ignora el argumento. En la práctica, se espera que la compatibilidad esté siempre disponible en Windows 10 1703 y versiones posteriores.
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D y matrices de texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada, salvo cuando flags contiene MultisampleResolve. En ese caso, se supone que texture es una textura 2D o una matriz de texturas 2D sin multimuestreo, y sampleCount define el número de muestras deseado. El objeto ` QQuickRenderTarget ` resultante utilizará una textura multimuestra (o matriz de texturas) intermedia, creada automáticamente, como su adjunto de color, y resolverá las muestras en ` texture`. Este es el método recomendado para aplicar MSAA cuando la textura nativa de D3D12 aún no es multimuestra.
El número de elementos de la matriz (capas) se indica en arraySize. Cuando es mayor que 1, implica un renderizado multivista (instanciación de vistas), lo cual puede ser especialmente relevante en el caso de la RV/RA. arraySize es el número de vistas, normalmente 2. Consulta QSGMaterial::viewCount() para obtener más detalles sobre cómo habilitar el renderizado multivista dentro del grafo de escena de Qt Quick.
La textura se utiliza como el primer adjunto de color del destino de renderizado utilizado por el grafo de escena Qt Quick. Si procede, se crea y se utiliza automáticamente un búfer de profundidad-estencil. Cuando el búfer de color es multimuestra, el búfer de profundidad-estencil también será automáticamente multimuestra. Para el renderizado multivista, la textura de profundidad-estencil se convertirá automáticamente en una matriz con un « arraySize » correspondiente.
Nota: el ` QQuickRenderTarget ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad del llamante garantizar que el recurso nativo exista durante el tiempo que sea necesario.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
Véanse también QQuickWindow::setRenderTarget() y QQuickRenderControl.
[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromMetalTexture(MTLTexture *texture, uint format, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de textura Metal especificado por ` texture`.
format especifica el MTLPixelFormat de la textura. Solo deben utilizarse formatos de textura compatibles con la infraestructura de renderizado de Qt.
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada.
La textura se utiliza como el primer adjunto de color del objetivo de renderizado utilizado por el grafo de escena Qt Quick. Si procede, se crea y se utiliza automáticamente un búfer de profundidad-plantilla.
Nota: el « QQuickRenderTarget » resultante no es propietario de ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad de quien llama a la función asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
Esta función se introdujo en Qt 6.4.
Véase también ` QQuickWindow::setRenderTarget()` y ` QQuickRenderControl`.
[static] QQuickRenderTarget QQuickRenderTarget::fromMetalTexture(MTLTexture *texture, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de textura Metal especificado por ` texture`. Se supone que la textura tiene el formato `MTLPixelFormatRGBA8Unorm`.
pixelSize especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada.
La textura se utiliza como primer adjunto de color del destino de renderizado utilizado por el grafo de escena de Qt Quick. Si procede, se crea y se utiliza automáticamente un búfer de profundidad-plantilla.
Nota: el ` QQuickRenderTarget ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad del llamante garantizar que el recurso nativo exista durante el tiempo que sea necesario.
Esta es una función sobrecargada.
Véase también ` QQuickWindow::setRenderTarget()` y ` QQuickRenderControl`.
[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromMetalTexture(MTLTexture *texture, uint format, uint viewFormat, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a una textura 2D de Metal o a una matriz de texturas 2D especificada en ` texture`.
format Especifica el MTLPixelFormat de la textura. Solo deben utilizarse los formatos de textura compatibles con la infraestructura de renderizado de Qt.
viewFormat Normalmente se establece en el mismo valor que ` format`. En algunos casos, como cuando se renderiza en una textura con un formato ` _SRGB ` y no se desea la conversión implícita de lineal a sRGB en las escrituras del shader, el valor puede ser diferente. Sin embargo, ten en cuenta que Qt puede ignorar el valor si, en tiempo de ejecución, ` QRhi ` informa de que la función ` QRhi::TextureViewFormat ` no es compatible.
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D y matrices de texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada, salvo cuando flags contiene MultisampleResolve. En ese caso, se supone que texture es una textura 2D o una matriz de texturas 2D sin multimuestreo, y sampleCount define el número de muestras deseado. El QQuickRenderTarget resultante utilizará una textura multimuestra (o matriz de texturas) intermedia, creada automáticamente, como su adjunto de color, y resolverá las muestras en texture. Este es el método recomendado para aplicar MSAA cuando la textura nativa de Metal aún no es multimuestra.
El número de elementos de la matriz (capas) se indica en arraySize. Cuando es mayor que 1, implica un renderizado multivista, lo que puede ser especialmente relevante en el caso de la RV/RA. arraySize es el número de vistas, normalmente 2. Consulte QSGMaterial::viewCount() para obtener más detalles sobre cómo habilitar el renderizado multivista dentro del grafo de escena Qt Quick.
La textura se utiliza como el primer adjunto de color del destino de renderizado utilizado por el grafo de escena Qt Quick. Si procede, se crea y se utiliza automáticamente un búfer de profundidad-plantilla. Cuando el búfer de color es multimuestra, el búfer de profundidad-plantilla también será automáticamente multimuestra. Para el renderizado multivista, la textura de profundidad-plantilla se convertirá automáticamente en una matriz con un ` arraySize` correspondiente.
Nota: el ` QQuickRenderTarget ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad del llamante garantizar que el recurso nativo exista durante el tiempo que sea necesario.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
Véase también QQuickWindow::setRenderTarget() y QQuickRenderControl.
[static, since 6.2] QQuickRenderTarget QQuickRenderTarget::fromOpenGLRenderBuffer(uint renderbufferId, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto « QQuickRenderTarget » que hace referencia a un objeto de búfer de renderizado de OpenGL especificado por « renderbufferId ».
El renderbuffer se utilizará como anexo de color para el objeto framebuffer interno. Esta función se proporciona para permitir dirigir los renderbuffers creados por la aplicación con algún búfer externo subyacente, como un EGLImageKHR. Una vez que la aplicación haya llamado a glEGLImageTargetRenderbufferStorageOES, el renderbuffer se puede pasar a esta función.
pixelSize especifica el tamaño de la imagen, en píxeles.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es un búfer de renderizado multimuestreado.
Nota: el objeto ` QQuickRenderTarget ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al recuento de muestras. Es responsabilidad de quien realiza la llamada asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
Esta función se introdujo en Qt 6.2.
Véase también QQuickWindow::setRenderTarget() y QQuickRenderControl.
[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromOpenGLTexture(uint textureId, uint format, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de textura de OpenGL especificado por ` textureId`.
format especifica el formato interno nativo de la textura. Solo deben utilizarse formatos de textura compatibles con la infraestructura de renderizado de Qt.
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada.
La textura se utiliza como el primer complemento de color del destino de renderizado utilizado por el grafo de escena Qt Quick. Si procede, se crea y utiliza automáticamente un búfer de profundidad-plantilla.
El nombre del objeto OpenGL « textureId » debe ser un nombre válido en el contexto de renderizado utilizado por el grafo de escena « Qt Quick ».
Nota: el QQuickRenderTarget resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad del llamante asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
Esta función se introdujo en Qt 6.4.
Véase también QQuickWindow::setRenderTarget() y QQuickRenderControl.
[static] QQuickRenderTarget QQuickRenderTarget::fromOpenGLTexture(uint textureId, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de textura de OpenGL especificado por ` textureId`. Se supone que la textura tiene un formato GL_RGBA (GL_RGBA8).
pixelSize especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada.
La textura se utiliza como el primer complemento de color del destino de renderizado utilizado por el grafo de escena de Qt Quick. Si procede, se crea y se utiliza automáticamente un búfer de profundidad-estencil.
El nombre del objeto OpenGL « textureId » debe ser un nombre válido en el contexto de renderizado utilizado por el grafo de escena « Qt Quick ».
Nota: el ` QQuickRenderTarget ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad del llamante garantizar que el recurso nativo exista durante el tiempo que sea necesario.
Esta es una función sobrecargada.
Véase también QQuickWindow::setRenderTarget() y QQuickRenderControl.
[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromOpenGLTexture(uint textureId, uint format, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a una textura 2D de OpenGL o a un objeto de matriz de texturas especificado por ` textureId`.
format especifica el formato interno nativo de la textura. Solo deben utilizarse formatos de textura compatibles con la infraestructura de renderizado de Qt.
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D y matrices de texturas 2D.
sampleCount especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada, salvo cuando flags contiene MultisampleResolve. En ese caso, se supone que textureId es una textura 2D o una matriz de texturas 2D sin multimuestreo, y sampleCount define el número de muestras deseado. El objeto ` QQuickRenderTarget ` resultante utilizará una textura (o matriz de texturas) multimuestra intermedia, creada automáticamente, como su adjunto de color, y resolverá las muestras en ` textureId`. Este es el método recomendado para aplicar MSAA cuando la textura nativa de OpenGL aún no es multimuestra.
Cuando ` arraySize ` es mayor que 1, implica un renderizado multivista (GL_OVR_multiview, ` QRhiColorAttachment::setMultiViewCount()`), lo cual puede ser especialmente relevante en entornos de RV/RA. En este caso, ` arraySize ` es el número de vistas, normalmente ` 2`. Consulte ` QSGMaterial::viewCount()` para obtener más detalles sobre cómo habilitar el renderizado multivista dentro del grafo de escena ` Qt Quick `.
Si procede, se crea y se utiliza automáticamente un búfer de profundidad-estencil. Cuando el búfer de color es multisample, el búfer de profundidad-estencil también será automáticamente multisample. Para el renderizado multivista, la textura de profundidad-estencil se convertirá automáticamente en una matriz con un arraySize correspondiente.
El nombre del objeto OpenGL ` textureId ` debe ser un nombre de textura 2D válido en el contexto de renderizado utilizado por el grafo de escena de « Qt Quick ». Cuando ` arraySize ` es mayor que 1, ` textureId ` debe ser un nombre de matriz de texturas 2D válido.
Nota: el objeto ` QQuickRenderTarget ` resultante no es propietario de ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados sobre el tamaño y el número de muestras. Es responsabilidad del llamante asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
Nota: La implementación de esta sobrecarga no es compatible con OpenGL ES 2.0 ni 3.0, y requiere como mínimo OpenGL ES 3.1. (o OpenGL 3.0 en ordenadores de sobremesa)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
Véase también QQuickWindow::setRenderTarget(), QQuickRenderControl y fromOpenGLTexture().
[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromPaintDevice(QPaintDevice *device)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de dispositivo de pintura especificado por ` device`.
Esta opción de redirigir el renderizado a un ` QPaintDevice ` solo está disponible cuando se ejecuta con el backend ` software ` de ` Qt Quick`.
Nota: El QQuickRenderTarget no asume la propiedad de device; es responsabilidad del llamante garantizar que el objeto exista durante el tiempo que sea necesario.
Esta función se introdujo en Qt 6.4.
Véase también QQuickWindow::setRenderTarget() y QQuickRenderControl.
[static, since 6.6] QQuickRenderTarget QQuickRenderTarget::fromRhiRenderTarget(QRhiRenderTarget *renderTarget)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un ` renderTarget` ya existente.
renderTarget En la mayoría de los casos será un ` QRhiTextureRenderTarget`, lo que permite dirigir el renderizado de la escena ` Qt Quick ` a un ` QRhiTexture`.
Nota: el QQuickRenderTarget resultante no es propietario de renderTarget ni de ningún recurso nativo subyacente, sino que simplemente contiene referencias y los metadatos asociados sobre el tamaño y el número de muestras. Es responsabilidad de quien llama a la función asegurarse de que los recursos a los que se hace referencia existan durante el tiempo que sea necesario.
Esta función se introdujo en Qt 6.6.
Véase también QQuickWindow::setRenderTarget() y QQuickRenderControl.
[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromVulkanImage(VkImage image, VkImageLayout layout, VkFormat format, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de imagen de Vulkan especificado por ` image`. También debe proporcionarse el ` layout ` actual de la imagen.
format especifica el VkFormat de la imagen. Solo deben utilizarse formatos de imagen compatibles con la infraestructura de renderizado de Qt.
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada.
La imagen se utiliza como el primer adjunto de color del destino de renderizado utilizado por el grafo de escena « Qt Quick ». Si procede, se crea y se utiliza automáticamente un búfer de profundidad-estencil.
Nota: el « QQuickRenderTarget » resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad del llamante garantizar que el recurso nativo exista durante el tiempo que sea necesario.
Esta función se introdujo en Qt 6.4.
Véase también ` QQuickWindow::setRenderTarget()` y ` QQuickRenderControl`.
[static] QQuickRenderTarget QQuickRenderTarget::fromVulkanImage(VkImage image, VkImageLayout layout, const QSize &pixelSize, int sampleCount = 1)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de imagen de Vulkan especificado mediante ` image`. Se supone que la imagen tiene el formato `VK_FORMAT_R8G8B8A8_UNORM`.
pixelSize especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada.
La textura se utiliza como el primer adjunto de color del objetivo de renderizado utilizado por el grafo de escena de « Qt Quick ». Si procede, se crea y se utiliza automáticamente un búfer de profundidad-plantilla.
Nota: el ` QQuickRenderTarget ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados sobre el tamaño y el número de muestras. Es responsabilidad del llamante asegurarse de que el recurso nativo exista durante el tiempo que sea necesario.
Esta es una función sobrecargada.
Véase también ` QQuickWindow::setRenderTarget()` y ` QQuickRenderControl`.
[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromVulkanImage(VkImage image, VkImageLayout layout, VkFormat format, VkFormat viewFormat, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags)
Devuelve un nuevo objeto ` QQuickRenderTarget ` que hace referencia a un objeto de imagen de Vulkan especificado mediante ` image`. También debe proporcionarse el ` layout ` actual de la imagen. La imagen debe ser una textura 2D o una matriz de texturas 2D.
format Especifica el VkFormat de la imagen. Solo deben utilizarse formatos de imagen compatibles con la infraestructura de renderizado de Qt.
viewFormat Suele establecerse en el mismo valor que format. En algunos casos, como cuando se renderiza en una textura con un formato _SRGB y no se desea la conversión implícita de lineal a sRGB en las escrituras del shader, el valor puede ser diferente. (Por ejemplo, un format de VK_FORMAT_R8G8B8A8_SRGB y un viewFormat de VK_FORMAT_R8G8B8A8_UNORM).
pixelSize Especifica el tamaño de la imagen, en píxeles. Actualmente solo se admiten texturas 2D.
sampleCount Especifica el número de muestras. 0 o 1 significa que no hay multimuestreo, mientras que un valor como 4 u 8 indica que el objeto nativo es una textura multimuestreada, salvo cuando flags contiene MultisampleResolve. En ese caso, se supone que image es una textura 2D sin multimuestreo o una matriz de texturas 2D, y sampleCount define el número de muestras deseado. El ` QQuickRenderTarget ` resultante utilizará una textura (o matriz de texturas) multimuestra intermedia, creada automáticamente, como su adjunto de color, y resolverá las muestras en ` image`. Este es el enfoque recomendado para aplicar MSAA cuando la imagen nativa de Vulkan aún no es multimuestra.
El número de elementos de la matriz (capas) se indica en arraySize. Cuando es mayor que 1, implica un renderizado multivista (VK_KHR_multiview), lo cual puede ser especialmente relevante en el caso de la RV/RA. arraySize es el número de vistas, normalmente 2. Consulte QSGMaterial::viewCount() para obtener más detalles sobre cómo habilitar el renderizado multivista dentro del grafo de escena Qt Quick.
La textura se utiliza como el primer adjunto de color del objetivo de renderizado utilizado por el grafo de escena Qt Quick. Si procede, se crea y se utiliza automáticamente un búfer de profundidad-plantilla. Cuando el búfer de color es multimuestra, el búfer de profundidad-plantilla también será automáticamente multimuestra. Para el renderizado multivista, la textura de profundidad-estencil se convertirá automáticamente en una matriz con una « arraySize » correspondiente.
Nota: el objeto ` QQuickRenderTarget ` resultante no posee ningún recurso nativo, sino que simplemente contiene referencias y los metadatos asociados relativos al tamaño y al número de muestras. Es responsabilidad del llamante garantizar que el recurso nativo exista durante el tiempo que sea necesario.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
Véase también QQuickWindow::setRenderTarget() y QQuickRenderControl.
bool QQuickRenderTarget::isNull() const
Devuelve «true» si este objeto ` QQuickRenderTarget ` se ha creado mediante la construcción por defecto y no hace referencia a ningún objeto nativo.
[since 6.4] bool QQuickRenderTarget::mirrorVertically() const
Devuelve si el destino de renderizado está reflejado verticalmente.
El valor por defecto es ` false`.
Esta función se introdujo en Qt 6.4.
Véase también ` setMirrorVertically()`.
[since 6.8] void QQuickRenderTarget::setDepthTexture(QRhiTexture *texture)
Las solicitudes que utilizan el « texture » indicado como búfer de profundidad o de profundidad-estencil. No se asume la propiedad de « texture ».
La solicitud solo se tiene en cuenta cuando es pertinente. Por ejemplo, llamar a esta función no tiene ningún efecto con fromRhiRenderTarget(), fromPaintDevice() o fromOpenGLRenderBuffer().
Normalmente, se crea automáticamente un búfer de profundidad-plantilla, de forma transparente para el usuario de ` QQuickRenderTarget`. Por lo tanto, en la mayoría de los casos no es necesario llamar a esta función cuando se trabaja con QQuickRenderTarget. Sin embargo, en circunstancias especiales, puede resultar esencial poder proporcionar una textura en la que renderizar los datos de profundidad (o de profundidad y estarcido), en lugar de dejar que Qt Quick cree sus propias texturas o búferes intermedios. Un ejemplo de ello es OpenXR y sus extensiones, como XR_KHR_composition_layer_depth. Para «enviar el búfer de profundidad» al compositor XR, en la práctica hay que recuperar una textura de profundidad (profundidad-plantilla) ya creada de OpenXR (desde el XrSwapchain) y utilizar esa textura como destino de renderizado para los datos de profundidad. Esto no sería posible sin esta función.
Nota: Se esperaque « texture » sea siempre una textura 2D sin multimuestreo o una matriz de texturas (para vistas múltiples). Si se utiliza MSAA, las muestras se resuelven en un « texture » al final de la pasada de renderizado, independientemente de si se ha activado o no el indicador « MultisampleResolve ». El MSAA solo es compatible con texturas de profundidad (profundidad-estencil) cuando la API 3D subyacente lo admite, y esta compatibilidad no está disponible de forma universal. Consulta the relevant QRhi feature flag para obtener más detalles. Cuando no se admite y se solicita el multimuestreo en combinación con una textura de profundidad personalizada, no se modificará « texture » durante el renderizado y se mostrará una advertencia.
Nota: En lo que respecta a OpenGL y OpenGL ES, el uso de texturas de profundidad no funciona en OpenGL ES 2.0 y requiere como mínimo OpenGL ES 3.0. La compatibilidad con el multimuestreo (MSAA) no está disponible sin, como mínimo, OpenGL ES 3.1 u OpenGL 3.0 en ordenadores de sobremesa.
Esta función se introdujo en Qt 6.8.
Véase también depthTexture().
[since 6.3] void QQuickRenderTarget::setDevicePixelRatio(qreal ratio)
Establece la relación de píxeles del dispositivo para este destino de renderizado en ratio. Se trata de la relación entre los píxeles del dispositivo y los píxeles independientes del dispositivo.
Ten en cuenta que el valor especificado para la relación de píxeles del dispositivo se ignorará si se reimplementa ` QQuickRenderControl::renderWindow()` para que devuelva un ` QWindow` válido.
Esta función se introdujo en Qt 6.3.
Véase también ` devicePixelRatio()`.
[since 6.4] void QQuickRenderTarget::setMirrorVertically(bool enable)
Establece el tamaño del destino de renderizado cuyo contenido debe reflejarse verticalmente en enable al dibujar. Esto permite integrar fácilmente código de renderizado de terceros que no se ajuste a las expectativas estándar.
Nota: Esta función no debe utilizarse cuando se emplea el backend « software ».
Esta función se introdujo en Qt 6.4.
Véase también mirrorVertically().
Elementos no miembros relacionados
[noexcept] bool operator!=(const QQuickRenderTarget &a, const QQuickRenderTarget &b)
Devuelve «true» si a y b hacen referencia a un conjunto diferente de objetos nativos, o si los datos asociados (tamaño, número de muestras) no coinciden.
[noexcept] bool operator==(const QQuickRenderTarget &a, const QQuickRenderTarget &b)
Devuelve «true» si a y b hacen referencia al mismo conjunto de objetos nativos y tienen datos asociados coincidentes (tamaño, número de muestras).
© 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.