En esta página

QRhiRenderBuffer Class

Recurso de búfer de renderizado. Más...

Encabezado: #include <rhi/qrhi.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS GuiPrivate)
target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate)
qmake: QT += gui-private
Desde: Qt 6.6
Heredado de: QRhiResource

Tipos públicos

struct NativeRenderBuffer
enum Flag { UsedWithSwapChainOnly }
flags Flags
enum Type { DepthStencil, Color }

Funciones públicas

virtual bool create() = 0
virtual bool createFrom(QRhiRenderBuffer::NativeRenderBuffer src)
QRhiRenderBuffer::Flags flags() const
QSize pixelSize() const
int sampleCount() const
void setFlags(QRhiRenderBuffer::Flags f)
void setPixelSize(const QSize &sz)
void setSampleCount(int s)
void setType(QRhiRenderBuffer::Type t)
QRhiRenderBuffer::Type type() const

Funciones públicas reimplementadas

virtual QRhiResource::Type resourceType() const override

Descripción detallada

Los renderbuffers no se pueden muestrear ni leer, pero presentan algunas ventajas con respecto a las texturas en determinados casos:

Un renderbuffer « DepthStencil » puede asignarse de forma diferida y estar respaldado por memoria transitoria con algunas API. En algunas plataformas, esto puede significar que el búfer de profundidad/estencil no utilice ningún respaldo físico en absoluto.

Esa naturaleza transitoria tiene una consecuencia: no se garantiza que el contenido de un renderbuffer de « DepthStencil » se conserve si un backend tiene que interrumpir y reiniciar internamente una pasada de renderizado. Con Metal, esto ocurre cuando una llamada de dibujo se implementa mediante buffers de comandos indirectos, como es el caso de una llamada a ` drawIndexedIndirect()` con un elevado número de dibujos, y también cuando se utiliza la teselación. Los dibujos registrados tras dicha llamada se someten entonces a una prueba de profundidad frente a un búfer de profundidad que ha perdido su contenido. Cuando esto sea relevante, adjunta un búfer de profundidad o de profundidad-estarcido QRhiTexture con setDepthTexture() en lugar de un búfer de renderizado: este se conserva tras una interrupción, a menos que se haya establecido QRhiTextureRenderTarget::DoNotStoreDepthStencilContents.

Color Los búferes de renderizado son útiles, ya que QRhi::MultisampleRenderBuffer puede ser compatible incluso cuando QRhi::MultisampleTexture no lo es.

La forma en que el backend implementa el búfer de renderizado no queda expuesta a las aplicaciones. En algunos casos puede estar respaldado por texturas normales, mientras que en otros puede utilizarse un tipo diferente de recurso nativo.

Los búferes de renderizado que se utilizan como (y solo como) búferes de profundidad y estencil en combinación con los búferes de color de un « QRhiSwapChain » deben tener activado el indicador « UsedWithSwapChainOnly ». Esto tiene un doble propósito: dichos búferes, dependiendo del backend y de las API subyacentes, son más eficientes, y QRhi proporciona un comportamiento de dimensionamiento automático para adaptarse a los búferes de color, lo que significa que no es necesario llamar a setPixelSize() ni a create() para dichos búferes de renderizado.

Nota: Se trata de una API RHI con garantías de compatibilidad limitadas; consulta QRhi para obtener más detalles.

Documentación sobre los tipos de miembros

enum QRhiRenderBuffer::Flag
flags QRhiRenderBuffer::Flags

Valores de los indicadores para flags() y setFlags()

ConstanteValorDescripción
QRhiRenderBuffer::UsedWithSwapChainOnly1 << 0En el caso de los búferes de renderizado de DepthStencil, esto indica que el búfer de renderizado solo se utiliza en combinación con un QRhiSwapChain, y nunca de ninguna otra forma. Esto proporciona un ajuste automático del tamaño y una reconstrucción automática de los recursos, por lo que no es necesario llamar a setPixelSize() o create() siempre que se establezca este indicador. Este valor de indicador también puede desencadenar un comportamiento específico del backend; por ejemplo, con OpenGL, donde se utiliza una API de interfaz del sistema de ventanas independiente (EGL, GLX, etc.), el indicador es especialmente importante, ya que evita la creación de cualquier recurso de búfer de renderizado real, puesto que el sistema de ventanas ya proporciona un búfer de profundidad/plantilla tal y como se solicita en QSurfaceFormat.

El tipo Flags es una definición de tipo (typedef) para QFlags<Flag>. Almacena una combinación OR de valores de Flag.

enum QRhiRenderBuffer::Type

Especifica el tipo del búfer de renderizado

ConstanteValorDescripción
QRhiRenderBuffer::DepthStencil0Profundidad y estencil combinados
QRhiRenderBuffer::Color1Color

Documentación de funciones de miembro

[pure virtual] bool QRhiRenderBuffer::create()

Crea los recursos gráficos nativos correspondientes. Si ya existen recursos debido a una llamada anterior a create() sin el correspondiente destroy(), entonces se invoca implícitamente primero destroy().

Devuelve ` true ` si se realiza correctamente, y ` false ` si falla alguna operación gráfica. Independientemente del valor devuelto, llamar a ` destroy()` siempre es seguro.

[virtual] bool QRhiRenderBuffer::createFrom(QRhiRenderBuffer::NativeRenderBuffer src)

Es similar a ` create()` (), salvo que no se crean nuevos objetos de búfer de renderizado nativos. En su lugar, se utiliza el objeto de búfer de renderizado nativo especificado por ` src `.

Esto permite importar un objeto de búfer de renderizado existente (que debe pertenecer al mismo dispositivo o contexto compartido, dependiendo de la API gráfica) desde un motor gráfico externo.

Nota: Actualmente,esto solo es aplicable a OpenGL. Esta función existe únicamente para permitir la importación de un objeto de búfer de renderizado vinculado a algún objeto externo especial, como un EGLImageKHR. Una vez que la aplicación haya realizado la llamada glEGLImageTargetRenderbufferStorageOES, el objeto renderbuffer puede pasarse a esta función para crear un objeto envolvente QRhiRenderBuffer, que a su vez puede pasarse como un anexo de color a un QRhiTextureRenderTarget para habilitar el renderizado en el EGLImage.

Nota: pixelSize(), sampleCount() y flags() deben seguir configurándose correctamente. Pasar tamaños u otros valores incorrectos a QRhi::newRenderBuffer() y, a continuación, llamar a createFrom() esperando que el objeto renderbuffer nativo por sí solo sea suficiente para deducir dichos valores es un error y provocará problemas.

Nota: « QRhiRenderBuffer » no asume la propiedad del objeto nativo, y « destroy()» no liberará dicho objeto.

Nota: Esta función solo se implementa cuando la característica QRhi::RenderBufferImport se indica como supported. En caso contrario, la función no realiza ninguna acción y el valor de retorno es false.

Devuelve « true » si se ejecuta correctamente, y « false » si no es compatible.

QRhiRenderBuffer::Flags QRhiRenderBuffer::flags() const

Devuelve los indicadores.

Véase también setFlags().

QSize QRhiRenderBuffer::pixelSize() const

Devuelve el tamaño en píxeles.

Véase también setPixelSize().

[override virtual] QRhiResource::Type QRhiRenderBuffer::resourceType() const

Reimplementa: ` QRhiResource::resourceType()` const.

Devuelve el tipo de recurso.

int QRhiRenderBuffer::sampleCount() const

Devuelve el número de muestras. El valor 1 indica que no se aplica el antialiasing de multimuestra.

Véase también setSampleCount().

void QRhiRenderBuffer::setFlags(QRhiRenderBuffer::Flags f)

Establece los indicadores en « f ».

Véase también flags().

void QRhiRenderBuffer::setPixelSize(const QSize &sz)

Establece el tamaño (en píxeles) en sz.

Véase también pixelSize().

void QRhiRenderBuffer::setSampleCount(int s)

Establece el número de muestras en s.

Véase también sampleCount().

void QRhiRenderBuffer::setType(QRhiRenderBuffer::Type t)

Establece el tipo en « t ».

Véase también type().

QRhiRenderBuffer::Type QRhiRenderBuffer::type() const

Devuelve el tipo de búfer de renderizado.

Véase también setType().

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