Qt3DRender::QRenderSurfaceSelector Class
class Qt3DRender::QRenderSurfaceSelectorPermet 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
- externalRenderTargetSize : QSize
- surface : QObject*
- surfacePixelRatio : float
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.