Sur cette page

Qt3DRender::QRenderSurfaceSelector Class

class Qt3DRender::QRenderSurfaceSelector

Permet de définir la surface de rendu. En savoir plus...

En-tête : #include <qrendersurfaceselector.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : RenderSurfaceSelector
Hérite de : Qt3DRender::QFrameGraphNode
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

QRenderSurfaceSelector(Qt3DCore::QNode *parent = nullptr)
QSize externalRenderTargetSize() const
QObject *surface() const
float surfacePixelRatio() const

Emplacements publics

void setExternalRenderTargetSize(const QSize &size)
void setSurface(QObject *surfaceObject)
void setSurfacePixelRatio(float ratio)

Signaux

void externalRenderTargetSizeChanged(const QSize &size)
void surfaceChanged(QObject *surface)
void surfacePixelRatioChanged(float ratio)

Description détaillée

L'objet ` Qt3DRender::QRenderSurfaceSelector ` permet de sélectionner la surface sur laquelle Qt3D affiche le contenu. Il peut s'agir d'une surface de fenêtre ou d'une surface hors écran. L'objet ` externalRenderTargetSize ` sert à spécifier la taille réelle de la surface lorsqu'une surface hors écran est utilisée.

Lorsque le système utilise la mise à l'échelle DPI, la taille logique de la surface, qui est utilisée par les événements de souris, et la taille « physique » réelle de la surface peuvent différer. Le paramètre ` surfacePixelRatio ` est le facteur permettant de convertir la taille logique en taille physique.

Voir également QWindow, QOffscreenSurface et QSurface.

Documentation sur les propriétés

externalRenderTargetSize : QSize

Contient la taille de la cible de rendu externe.

Fonctions d'accès :

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

Signal de notification :

void externalRenderTargetSizeChanged(const QSize &size)

surface : QObject*

Assure l'adhérence à la surface

Fonctions d'accès :

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

Signal de notification :

void surfaceChanged(QObject *surface)

surfacePixelRatio : float

Contient la valeur `surfacePixelRatio` de la surface.

Fonctions d'accès :

float surfacePixelRatio() const
void setSurfacePixelRatio(float ratio)

Signal de notification :

void surfacePixelRatioChanged(float ratio)

Documentation des fonctions membres

[explicit] QRenderSurfaceSelector::QRenderSurfaceSelector(Qt3DCore::QNode *parent = nullptr)

Construit un objet `QRenderSurfaceSelector` à partir de l'parent` fournie.

[slot] void QRenderSurfaceSelector::setExternalRenderTargetSize(const QSize &size)

Définit l'size de la cible de rendu si celle-ci diffère de la taille de la surface sous-jacente. Indique la taille correcte au système de sélection.

Remarque : fonctionde définition de la propriété externalRenderTargetSize.

Voir aussi externalRenderTargetSize().

[slot] void QRenderSurfaceSelector::setSurface(QObject *surfaceObject)

Définit surfaceObject.

Remarque : fonctionde définition de la propriété surface.

Voir aussi surface().

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