Auf dieser Seite

Qt3DRender::QViewport Class

class Qt3DRender::QViewport

Ein Ansichtsfenster der Qt3D-Szene. Mehr...

Überschrift: #include <qviewport.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
In QML: Viewport
Erbt von: Qt3DRender::QFrameGraphNode
Status: Veraltet

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Eigenschaften

Öffentliche Funktionen

QViewport(Qt3DCore::QNode *parent = nullptr)
float gamma() const
QRectF normalizedRect() const

Öffentliche Slots

void setGamma(float gamma)
void setNormalizedRect(const QRectF &normalizedRect)

Signale

void gammaChanged(float gamma)
void normalizedRectChanged(const QRectF &normalizedRect)

Detaillierte Beschreibung

Qt3DRender::QViewport der Szene legt fest, auf welchen Teil der Renderfläche Qt3D rendert. Der Bereich außerhalb des Ansichtsfensters bleibt unberührt. Außerdem steuert sie globale Parameter für das Rendering in diesem Ansichtsfenster, wie beispielsweise den Gammawert.

Dokumentation der Eigenschaften

gamma : float

Legt den Gamma-Faktor für den Ansichtsbereich fest. Der Standardwert ist 2,2, was auf den meisten Bildschirmen zu korrekten Ergebnissen führen sollte.

Zugriffsfunktionen:

float gamma() const
void setGamma(float gamma)

Notifier-Signal:

void gammaChanged(float gamma)

normalizedRect : QRectF

Legt das normierte Rechteck für den Ansichtsbereich fest, d. h., das Ansichtsbereichsrechteck wird relativ zur Größe der Renderfläche angegeben. Ein Ansichtsbereich in der Größe der gesamten Fläche wird als [0,0, 0,0, 1,0, 1,0] angegeben, was der Standardwert ist.

Zugriffsfunktionen:

QRectF normalizedRect() const
void setNormalizedRect(const QRectF &normalizedRect)

Benachrichtigungssignal:

void normalizedRectChanged(const QRectF &normalizedRect)

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein `QViewport` mit dem angegebenen ` parent`.

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