Sur cette page

Qt3DExtras::QForwardRenderer Class

class Qt3DExtras::QForwardRenderer

Le QForwardRenderer fournit une implémentation par défaut d'un FrameGraph d'un moteur de rendu en aval. Plus d'informations...

En-tête : #include <QForwardRenderer>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3dextras)
target_link_libraries(mytarget PRIVATE Qt6::3dextras)
qmake : QT += 3dextras
En QML : ForwardRenderer
Hérite : Qt3DRender::QTechniqueFilter
Statut : Déclassé

Propriétés

Fonctions publiques

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

Emplacements publics

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)

Signaux

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)

Description détaillée

Le rendu avant est ce qu'OpenGL utilise traditionnellement. Il rend directement dans le backbuffer un objet à la fois en l'ombrant au fur et à mesure.

QForwardRenderer est un arbre FrameGraph à une seule feuille qui contient un Qt3DRender::QViewport, un Qt3DRender::QCameraSelector, et un Qt3DRender::QClearBuffers. Le QForwardRenderer a une clé de filtre d'exigence par défaut dont le nom est "renderingStyle" et la valeur "forward". Si vous devez filtrer vos techniques, vous devez le faire en fonction de cette clé de filtrage.

Par défaut, la fenêtre de visualisation occupe tout l'écran et la couleur claire est le blanc. Le filtrage des images est également activé.

Documentation sur les propriétés

buffersToClear : Qt3DRender::QClearBuffers::BufferType

Contient les tampons actuels à effacer. La valeur par défaut est ColorDepthBuffer.

Fonctions d'accès :

Qt3DRender::QClearBuffers::BufferType buffersToClear() const
void setBuffersToClear(Qt3DRender::QClearBuffers::BufferType)

Signal de notification :

void buffersToClearChanged(Qt3DRender::QClearBuffers::BufferType)

camera : Qt3DCore::QEntity*

Contient l'entité caméra utilisée pour le rendu de la scène.

Remarque : une caméra est une QEntity dont l'un des composants est une QCameraLens.

Fonctions d'accès :

Qt3DCore::QEntity *camera() const
void setCamera(Qt3DCore::QEntity *camera)

Signal Notifier :

void cameraChanged(Qt3DCore::QEntity *camera)

clearColor : QColor

Contient la couleur claire actuelle de la scène. Le frame buffer est initialisé à la couleur claire avant le rendu.

Fonctions d'accès :

QColor clearColor() const
void setClearColor(const QColor &clearColor)

Signal de notification :

void clearColorChanged(const QColor &clearColor)

externalRenderTargetSize : QSize

Contient la taille de la cible de rendu externe. Les cibles de rendu externes sont pertinentes lorsque le rendu ne cible pas la surface d'une fenêtre (comme défini dans surface).

Fonctions d'accès :

QSize externalRenderTargetSize() const
void setExternalRenderTargetSize(const QSize &size)

Signal de notification :

void externalRenderTargetSizeChanged(const QSize &size)

frustumCulling : bool

Indique si le moteur de rendu applique le frustum culling à la scène.

Fonctions d'accès :

bool isFrustumCullingEnabled() const
void setFrustumCullingEnabled(bool enabled)

Signal de notification :

void frustumCullingEnabledChanged(bool enabled)

gamma : float

Contient la valeur gamma que le moteur de rendu applique à la scène.

Fonctions d'accès :

float gamma() const
void setGamma(float gamma)

Signal de notification :

void gammaChanged(float gamma)

showDebugOverlay : bool

Si cette option est activée, une couche de débogage sera affichée sur la scène. Il affichera des informations détaillées sur l'état du rendu pendant l'exécution, permettra à l'utilisateur d'activer et de désactiver la journalisation, etc.

Fonctions d'accès :

bool showDebugOverlay() const
void setShowDebugOverlay(bool showDebugOverlay)

Signal de notification :

void showDebugOverlayChanged(bool showDebugOverlay)

surface : QObject*

Détient la surface de rendu actuelle.

Fonctions d'accès :

QObject *surface() const
void setSurface(QObject *surface)

Signal du notificateur :

void surfaceChanged(QObject *surface)

viewportRect : QRectF

Contient le rectangle de visualisation normalisé actuel.

Fonctions d'accès :

QRectF viewportRect() const
void setViewportRect(const QRectF &viewportRect)

Signal de notification :

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.