Auf dieser Seite

PerspectiveCamera QML Type

Definiert eine Perspektivkamera zur Darstellung des Inhalts einer 3D-Szene. Mehr...

Import Statement: import QtQuick3D
Inherits:

Camera

Inherited By:

FrustumCamera

Eigenschaften

Ausführliche Beschreibung

Ein „ Camera “ definiert, wie der Inhalt der 3D-Szene auf eine 2D-Fläche projiziert wird, beispielsweise auf eine „ View3D “. Eine Szene benötigt mindestens einen „ Camera “, um ihren Inhalt darzustellen.

Die „ Camera “ lässt sich wie jedes andere räumliche Objekt ( Node ) in der Szene positionieren und drehen. Die Position und Ausrichtung der „ Node “ bestimmt, wo sich die „ Camera “ in der Szene befindet und in welche Richtung sie blickt. Bei der Standardausrichtung der „ Camera “ zeigt der Vorwärtsvektor entlang der negativen Z-Achse und der Aufwärtsvektor entlang der positiven Y-Achse.

Perspektivisches Kameraprojektionsdiagramm

„PerspectiveCamera“ ist der Standardtyp für „ Camera “. Sie liefert eine realistische Projektion der Szene, bei der entfernte Objekte kleiner wahrgenommen werden. Der Sichtkegel wird durch die Eigenschaft „ fieldOfView “ sowie durch die nahe und ferne Clip-Ebene definiert.

Das folgende Beispiel erstellt 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.

Dokumentation der Eigenschaften

clipFar : real

Diese Eigenschaft definiert die hintere Schnittfläche des Sichtkegels der „ PerspectiveCamera “. Geometrie, die weiter von der „ Camera “ entfernt ist als die hintere Schnittfläche, ist nicht sichtbar.

Der Standardwert beträgt 10000,0. Die Einheit hängt von den Geometrieeinheiten des Benutzers ab, und der Wert bezieht sich auf die globale Kameraposition.

clipNear : real

Diese Eigenschaft definiert die nahe Clip-Ebene des Sichtkegels der „ PerspectiveCamera “. Geometrie, die näher an der „ Camera “ liegt als die nahe Clip-Ebene, ist nicht sichtbar.

Der Standardwert beträgt 10,0. Die Einheit hängt von den Geometrieeinheiten des Benutzers ab, und der Wert bezieht sich auf die globale Kameraposition.

fieldOfView : real

Diese Eigenschaft gibt das Sichtfeld der Kamera in Grad an. Dabei kann es sich entweder um das vertikale oder das horizontale Sichtfeld handeln, je nachdem, ob die Eigenschaft „ fieldOfViewOrientation “ auf „ PerspectiveCamera.Vertical “ oder „ PerspectiveCamera.Horizontal “ gesetzt ist.

Der Standardwert beträgt 60,0.

fieldOfViewOrientation : enumeration

Diese Eigenschaft gibt die Ausrichtung an, in der das Sichtfeld der Kamera dargestellt wird.

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

Der Standardwert lautet „ PerspectiveCamera.Vertical “.

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