Sur cette page

Qt3DRender::QRenderSurfaceSelector Class

class Qt3DRender::QRenderSurfaceSelector

Permet de spécifier la surface de rendu. Plus d'informations...

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

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'adresse Qt3DRender::QRenderSurfaceSelector peut être utilisée pour sélectionner la surface sur laquelle Qt3D effectue le rendu du contenu. La surface peut être la surface de la fenêtre ou la surface hors écran. L'adresse externalRenderTargetSize est utilisée pour spécifier la taille réelle de la surface lorsque la 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 la souris, et la taille "physique" réelle de la surface peuvent différer. La valeur surfacePixelRatio est le facteur qui permet de convertir la taille logique en taille physique.

Voir également QWindow, QOffscreenSurface, et QSurface.

Documentation sur les propriétés

externalRenderTargetSize : QSize

Indique 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*

Maintient la surface

Fonctions d'accès :

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

Signal de notification :

void surfaceChanged(QObject *surface)

surfacePixelRatio : float

Contient le rapport surface-pixel de la surface.

Fonctions d'accès :

float surfacePixelRatio() const
void setSurfacePixelRatio(float ratio)

Signal de notification :

void surfacePixelRatioChanged(float ratio)

Fonction membre Documentation

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

Construit QRenderSurfaceSelector avec parent.

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

Définit la cible de rendu size si elle est différente de la taille de la surface sous-jacente. Indique la taille correcte.

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

Voir également externalRenderTargetSize().

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

Définit surfaceObject.

Note : Fonction de définition de la propriété surface.

Voir également 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.