Qt3DExtras::QForwardRenderer Class
class Qt3DExtras::QForwardRendererQForwardRenderer proporciona una implementación predeterminada de FrameGraph para un renderizador directo. Más información...
| Encabezado: | #include <qforwardrenderer.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dextras) target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake: | QT += 3dextras |
| En QML: | ForwardRenderer |
| Heredado de: | Qt3DRender::QTechniqueFilter |
| Estado: | Obsoleto |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
Propiedades
|
|
Funciones públicas
| Qt3DRender::QClearBuffers::BufferType | buffersToClear() const |
| Qt3DCore::QEntity * | camera() const |
| QColor | clearColor() const |
| QSize | externalRenderTargetSize() const |
| float | gamma() const |
| bool | isFrustumCullingEnabled() const |
| bool | showDebugOverlay() const |
| QObject * | surface() const |
| QRectF | viewportRect() const |
Ranuras públicas
| void | setBuffersToClear(Qt3DRender::QClearBuffers::BufferType) |
| void | setCamera(Qt3DCore::QEntity *camera) |
| void | setClearColor(const QColor &clearColor) |
| void | setExternalRenderTargetSize(const QSize &size) |
| void | setFrustumCullingEnabled(bool enabled) |
| void | setGamma(float gamma) |
| void | setShowDebugOverlay(bool showDebugOverlay) |
| void | setSurface(QObject *surface) |
| void | setViewportRect(const QRectF &viewportRect) |
Señales
| void | buffersToClearChanged(Qt3DRender::QClearBuffers::BufferType) |
| void | cameraChanged(Qt3DCore::QEntity *camera) |
| void | clearColorChanged(const QColor &clearColor) |
| void | externalRenderTargetSizeChanged(const QSize &size) |
| void | frustumCullingEnabledChanged(bool enabled) |
| void | gammaChanged(float gamma) |
| void | showDebugOverlayChanged(bool showDebugOverlay) |
| void | surfaceChanged(QObject *surface) |
| void | viewportRectChanged(const QRectF &viewportRect) |
Descripción detallada
El renderizado directo es el que utiliza tradicionalmente OpenGL. Renderiza directamente en el búfer de fondo un objeto cada vez, aplicando el sombreado a cada uno de ellos a medida que avanza.
QForwardRenderer es un árbol FrameGraph de una sola hoja que contiene un ` Qt3DRender::QViewport`, un ` Qt3DRender::QCameraSelector` y un ` Qt3DRender::QClearBuffers`. El QForwardRenderer tiene una clave de filtro predeterminada cuyo nombre es «renderingStyle» y cuyo valor es «forward». Si necesitas filtrar tus técnicas, debes hacerlo basándote en esa clave de filtro.
Por defecto, la ventana de visualización ocupa toda la pantalla y el color de borrado es el blanco. El culling de frustum también está habilitado.
Documentación de propiedades
buffersToClear : Qt3DRender::QClearBuffers::BufferType
Contiene los búferes actuales que se van a borrar. El valor por defecto es ColorDepthBuffer
Funciones de acceso:
| Qt3DRender::QClearBuffers::BufferType | buffersToClear() const |
| void | setBuffersToClear(Qt3DRender::QClearBuffers::BufferType) |
Señal de notificación:
| void | buffersToClearChanged(Qt3DRender::QClearBuffers::BufferType) |
camera : Qt3DCore::QEntity*
Almacena la entidad de cámara actual que se utiliza para renderizar la escena.
Nota: Una cámara es una QEntity que tiene una QCameraLens como uno de sus componentes.
Funciones de acceso:
| Qt3DCore::QEntity * | camera() const |
| void | setCamera(Qt3DCore::QEntity *camera) |
Señal de notificador:
| void | cameraChanged(Qt3DCore::QEntity *camera) |
clearColor : QColor
Almacena el color de borrado actual de la escena. El búfer de fotogramas se inicializa con el color de borrado antes del renderizado.
Funciones de acceso:
| QColor | clearColor() const |
| void | setClearColor(const QColor &clearColor) |
Señal de notificación:
| void | clearColorChanged(const QColor &clearColor) |
externalRenderTargetSize : QSize
Contiene el tamaño del destino de renderizado externo. Los destinos de renderizado externos son relevantes cuando el renderizado no se dirige a la superficie de una ventana (tal y como se configura en surface).
Funciones de acceso:
| QSize | externalRenderTargetSize() const |
| void | setExternalRenderTargetSize(const QSize &size) |
Señal de notificación:
| void | externalRenderTargetSizeChanged(const QSize &size) |
frustumCulling : bool
Indica si el renderizador aplica el culling de frustum a la escena.
Funciones de acceso:
| bool | isFrustumCullingEnabled() const |
| void | setFrustumCullingEnabled(bool enabled) |
Señal de notificación:
| void | frustumCullingEnabledChanged(bool enabled) |
gamma : float
Almacena el valor de gamma que el renderizador aplica a la escena.
Funciones de acceso:
| float | gamma() const |
| void | setGamma(float gamma) |
Señal de notificación:
| void | gammaChanged(float gamma) |
showDebugOverlay : bool
Si el valor es «true», se mostrará una superposición de depuración sobre la escena. Mostrará información detallada sobre el estado de renderizado en tiempo de ejecución, permitirá al usuario activar y desactivar el registro, etc.
Funciones de acceso:
| bool | showDebugOverlay() const |
| void | setShowDebugOverlay(bool showDebugOverlay) |
Señal de notificación:
| void | showDebugOverlayChanged(bool showDebugOverlay) |
surface : QObject*
Almacena la superficie de renderizado actual.
Funciones de acceso:
| QObject * | surface() const |
| void | setSurface(QObject *surface) |
Señal de notificación:
| void | surfaceChanged(QObject *surface) |
viewportRect : QRectF
Almacena el rectángulo normalizado actual de la ventana gráfica.
Funciones de acceso:
| QRectF | viewportRect() const |
| void | setViewportRect(const QRectF &viewportRect) |
Señal de notificación:
| void | viewportRectChanged(const QRectF &viewportRect) |
© 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.