Qt3DRender::QRenderSurfaceSelector Class
class Qt3DRender::QRenderSurfaceSelectorBietet eine Möglichkeit, die Renderfläche festzulegen. Mehr...
| Überschrift: | #include <qrendersurfaceselector.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| In QML: | RenderSurfaceSelector |
| Erbt von: | Qt3DRender::QFrameGraphNode |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
- externalRenderTargetSize : QSize
- surface : QObject*
- surfacePixelRatio : float
Öffentliche Funktionen
| QRenderSurfaceSelector(Qt3DCore::QNode *parent = nullptr) | |
| QSize | externalRenderTargetSize() const |
| QObject * | surface() const |
| float | surfacePixelRatio() const |
Öffentliche Slots
| void | setExternalRenderTargetSize(const QSize &size) |
| void | setSurface(QObject *surfaceObject) |
| void | setSurfacePixelRatio(float ratio) |
Signale
| void | externalRenderTargetSizeChanged(const QSize &size) |
| void | surfaceChanged(QObject *surface) |
| void | surfacePixelRatioChanged(float ratio) |
Ausführliche Beschreibung
Mit dem Parameter „ Qt3DRender::QRenderSurfaceSelector “ kann die Oberfläche ausgewählt werden, auf der Qt3D den Inhalt rendert. Bei der Oberfläche kann es sich entweder um eine Fensteroberfläche oder eine Offscreen-Oberfläche handeln. Der Parameter „ externalRenderTargetSize “ dient zur Angabe der tatsächlichen Größe der Oberfläche, wenn eine Offscreen-Oberfläche verwendet wird.
Wenn das System eine DPI-Skalierung verwendet, können die logische Oberflächengröße, die für Mausereignisse verwendet wird, und die tatsächliche „physikalische“ Größe der Oberfläche voneinander abweichen. Der Parameter ` surfacePixelRatio ` ist der Faktor zur Umrechnung der logischen Größe in die physikalische Größe.
Siehe auch „ QWindow “, „ QOffscreenSurface “ und „ QSurface “.
Eigenschaftsdokumentation
externalRenderTargetSize : QSize
Enthält die Größe des externen Renderziels.
Zugriffsfunktionen:
| QSize | externalRenderTargetSize() const |
| void | setExternalRenderTargetSize(const QSize &size) |
Notifier-Signal:
| void | externalRenderTargetSizeChanged(const QSize &size) |
surface : QObject*
Hält die Oberfläche fest
Zugriffsfunktionen:
| QObject * | surface() const |
| void | setSurface(QObject *surfaceObject) |
Signal des Notifiers:
| void | surfaceChanged(QObject *surface) |
surfacePixelRatio : float
Enthält den Wert „surfacePixelRatio“ der Oberfläche.
Zugriffsfunktionen:
| float | surfacePixelRatio() const |
| void | setSurfacePixelRatio(float ratio) |
Notifier-Signal:
| void | surfacePixelRatioChanged(float ratio) |
Dokumentation zu den Mitgliedsfunktionen
[explicit] QRenderSurfaceSelector::QRenderSurfaceSelector(Qt3DCore::QNode *parent = nullptr)
Erstellt ein `QRenderSurfaceSelector`-Objekt mit dem angegebenen ` parent`.
[slot] void QRenderSurfaceSelector::setExternalRenderTargetSize(const QSize &size)
Legt die Größe des Renderziels fest: size, falls diese von der Größe der zugrunde liegenden Oberfläche abweicht. Gibt der Auswahlfunktion die richtige Größe an.
Hinweis: Setter -Funktion für die Eigenschaft ` externalRenderTargetSize`.
Siehe auch ` externalRenderTargetSize()`.
[slot] void QRenderSurfaceSelector::setSurface(QObject *surfaceObject)
Setzt „ surfaceObject “.
Hinweis: Setter -Funktion für die Eigenschaft „ surface “.
Siehe auch „ 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.
