PerspectiveCamera QML Type

Definiert eine perspektivische Kamera zur Betrachtung des Inhalts einer 3D-Szene. Mehr...

Import Statement: import QtQuick3D
Inherits:

Camera

Inherited By:

FrustumCamera

Eigenschaften

Detaillierte Beschreibung

Ein Camera definiert, wie der Inhalt der 3D-Szene auf eine 2D-Oberfläche projiziert wird, z. B. ein View3D. Eine Szene benötigt mindestens ein Camera, um ihren Inhalt zu visualisieren.

Es ist möglich, die Camera wie jede andere räumliche Node in der Szene zu positionieren und zu drehen. Die Position und Ausrichtung des Node bestimmt, wo sich das Camera in der Szene befindet und in welche Richtung es zeigt. Bei der Standardausrichtung von Camera zeigt der Vorwärtsvektor auf die negative Z-Achse und der Aufwärtsvektor auf die positive Y-Achse.

PerspectiveCamera ist der Standardtyp Camera. Er liefert eine realistische Projektion der Szene, bei der weit entfernte Objekte als kleiner wahrgenommen werden. Der Kegelstumpf wird durch die Eigenschaft fieldOfView sowie durch nahe und ferne Clipebenen definiert.

Das folgende Beispiel erzeugt eine PerspectiveCamera an der Position [0, 200, 300] in der Szene, mit einem Sichtfeld von 90 Grad und einer Neigung von 30 Grad nach unten.

PerspectiveCamera {
    position: Qt.vector3d(0, 200, 300)
    eulerRotation.x: -30
    fieldOfView: 90
}

Siehe auch Qt Quick 3D - View3D Beispiel, OrthographicCamera, FrustumCamera, und CustomCamera.

Eigenschaft Dokumentation

clipFar : real

Diese Eigenschaft definiert die entfernte Clipebene des Kegelstumpfes von PerspectiveCamera. Geometrien, die weiter von Camera entfernt sind als die ferne Clipebene, sind nicht sichtbar.

Der Standardwert ist 10000.0. Die Einheit hängt von den Geometrieeinheiten des Benutzers ab, und der Wert ist relativ zur globalen Kameraposition.


clipNear : real

Diese Eigenschaft definiert die nahe Clipebene des Kegelstumpfes von PerspectiveCamera. Geometrien, die sich näher an Camera befinden als die nahe Clipping-Ebene, sind nicht sichtbar.

Der Standardwert ist 10.0. Die Einheit hängt von den Geometrieeinheiten des Benutzers ab, und der Wert ist relativ zur globalen Kameraposition.


fieldOfView : real

Diese Eigenschaft gibt das Sichtfeld der Kamera in Grad an. Dies kann entweder das vertikale oder das horizontale Sichtfeld sein, je nachdem, ob die Eigenschaft fieldOfViewOrientation auf PerspectiveCamera.Vertical oder PerspectiveCamera.Horizontal eingestellt ist.

Der Standardwert ist 60,0.


fieldOfViewOrientation : enumeration

Diese Eigenschaft enthält die Ausrichtung, in der das Sichtfeld der Kamera angegeben wird.

KonstanteBeschreibung
PerspectiveCamera.VerticalDas angegebene Sichtfeld ist vertikal, d.h. das Sichtfeld ist der Winkel zwischen der Linie, die von der Kamera zur oberen Mitte des Sichtfensters gezogen wird, und der Linie von der Kamera zur unteren Mitte des Sichtfensters. Das horizontale Seitenverhältnis wird angepasst, um das Seitenverhältnis beizubehalten.
PerspectiveCamera.HorizontalDas vorgesehene Sichtfeld ist horizontal, d. h. das Sichtfeld ist der Winkel zwischen der Linie, die von der Kamera zur linken Mitte des Sichtfensters gezogen wird, und der Linie von der Kamera zur rechten Mitte des Sichtfensters. Das vertikale Seitenverhältnis wird angepasst, um das Seitenverhältnis beizubehalten.

Der Standardwert ist PerspectiveCamera.Vertical.


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