En esta página

Qt3DExtras::QForwardRenderer Class

class Qt3DExtras::QForwardRenderer

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