Camera QML Type

Definiert einen Blickpunkt, durch den die Szene gerendert wird. Mehr...

Import Statement: import Qt3D.Render 2.8
In C++: QCamera
Inherits:

Entity

Status: Deprecated

Eigenschaften

Methoden

Detaillierte Beschreibung

Eigenschaft Dokumentation

aspectRatio : real

Enthält das aktuelle Seitenverhältnis der Kamera.


bottom : real

Enthält den aktuellen Boden der Kamera.

Diese Eigenschaft ist nur relevant, wenn projectionType CameraLens ist. OrthographicProjection.


exposure : real

Enthält die aktuelle Belichtung der Kamera.

Der Standardwert ist 0.0.

Das MetalRoughMaterial in Qt 3D Extras ist derzeit das einzige bereitgestellte Material, das die Kamerabelichtung verwendet. Negative Werte lassen das Material dunkler erscheinen, positive Werte heller.

Benutzerdefinierte Materialien können den Wert anders interpretieren.


farPlane : real

Enthält die aktuelle kameraferne Ebene der Kamera. Objekte, die weiter von der Kamera entfernt sind als die farPlane, werden nicht gerendert.


fieldOfView : real

Enthält das aktuelle vertikale Sichtfeld der Kamera in Grad.

Zusammen mit aspectRatio bestimmt diese Eigenschaft, wie viel von der Szene für die Kamera sichtbar ist. In dieser Hinsicht könnte man sie als Analogie zur Wahl eines Weitwinkel- (breites horizontales Sichtfeld) oder Teleobjektivs (enges horizontales Sichtfeld) betrachten, je nachdem, wie viel von der Szene man erfassen möchte.

fieldOfView ist nur relevant, wenn projectionType ist CameraLens.PerspectiveProjection.


left : real

Enthält die aktuelle linke Seite der Kamera.

Diese Eigenschaft ist nur relevant, wenn projectionType gleich CameraLens ist .OrthographicProjection.


lens : CameraLens [read-only]

Enthält die CameraLens Komponente der Kamera.


nearPlane : real

Enthält die aktuelle kameranahe Ebene der Kamera. Objekte, die sich näher an der Kamera befinden als die nearPlane, werden nicht gerendert.


position : vector3d

Enthält die aktuelle Position der Kamera in Koordinaten relativ zur übergeordneten Entität.


projectionMatrix : matrix4x4

Enthält die aktuelle Projektionsmatrix der Kamera.


projectionType : enumeration

Enthält den Typ der Kameraprojektion. Der Standardwert ist CameraLens.PerspectiveProjection.

  • CameraLens.OrthographicProjection - Parallele Linien erscheinen parallel. Objekte erscheinen unabhängig von der Entfernung in der gleichen Größe.
  • CameraLens.PerspectiveProjection - Parallele Linien scheinen sich in der Ferne zu treffen. Objekte scheinen zu schrumpfen, je weiter sie von der Kamera entfernt sind.
  • CameraLens.FrustumProjektion
  • CameraLens.BenutzerdefinierteProjektion

Siehe auch Qt3DRender::QCameraLens::ProjectionType.


right : real

Enthält das aktuelle Recht der Kamera.

Diese Eigenschaft ist nur relevant, wenn projectionType CameraLens .OrthographicProjection ist.


top : real

Enthält den aktuellen oberen Rand der Kamera.

Diese Eigenschaft ist nur relevant, wenn projectionType CameraLens ist. OrthographicProjection.


transform : Transform [read-only]

Enthält die Transform-Komponente der Kamera.


upVector : vector3d

Enthält den aktuellen Aufwärtsvektor der Kamera in Koordinaten relativ zum übergeordneten Objekt.

Der Aufwärtsvektor gibt an, in welche Richtung die Oberseite der Kamera gerichtet ist. Stellen Sie sich vor, Sie nehmen ein Foto auf: Nachdem Sie sich positioniert und die Kamera auf Ihr Ziel gerichtet haben, können Sie die Kamera nach links oder rechts drehen, um ein Hoch- oder Querformat (oder einen Winkel!) zu erhalten. upVector ermöglicht es Ihnen, diese Art der Bewegung zu steuern.


viewCenter : vector3d

Enthält das aktuelle Ansichtszentrum der Kamera in Koordinaten relativ zum übergeordneten Objekt.

Intuitiv ist das viewCenter der Ort, auf den die Kamera zeigt.


viewVector : vector3d [read-only]

Enthält den Ansichtsvektor der Kamera in Koordinaten relativ zur übergeordneten Entität.

Dieser Vektor beschreibt die Verschiebung von der Kamera (position) zu ihrem Ziel (viewCenter).


Methode Dokumentation

void pan(real angle)

Passt den Schwenkwinkel der Kamera um angle in Grad an.


void pan(real angle, vector3d axis)

Passt den Kameraschwenk um die Ansichtsmitte um angle in Grad auf axis an.


void panAboutViewCenter(real angle)

Passt den Kameraschwenk um die Bildmitte um angle in Grad an.


void panAboutViewCenter(real angle, vector3d axis)

Passt den Kameraschwenk um die Bildmitte um angle in Grad auf axis an.


quaternion panRotation(real angle)

Gibt die berechnete Drehung der Kamera in Bezug auf angle in Grad zurück, die zur Anpassung des Kameraschwenks oder der Links-/Rechtsdrehung auf der Y-Achse verwendet wird.


void roll(real angle)

Passt die Kamerarolle um angle in Grad an.


void rollAboutViewCenter(real angle)

Passt die Kameradrehung um die Ansichtsmitte um angle in Grad an.


quaternion rollRotation(real angle)

Gibt die berechnete Drehung der Kamera im Verhältnis zu angle in Grad zurück, um die Drehung der Kamera oder die Links-/Rechtsdrehung auf der Z-Achse anzupassen.


void rotate(quaternion q)

Dreht die Kamera mit Hilfe eines Quaternions in q.


void rotateAboutViewCenter(quaternion q)

Dreht die Kamera mit Hilfe eines Quaternions in q um das Ansichtszentrum.


quaternion rotation(real angle, vector3d axis)

Gibt die berechnete Drehung in Bezug auf die angle in Grad und die gewählte axis zurück.


void tilt(real angle)

Passt den Neigungswinkel der Kamera um angle in Grad an.


void tiltAboutViewCenter(real angle)

Passt die Kameraneigung um angle in Grad an.


quaternion tiltRotation(real angle)

Gibt die berechnete Neigungsdrehung in Bezug auf die angle in Grad zurück, die zur Anpassung der Kameraneigung oder der Auf-/Abwärtsdrehung auf der X-Achse verwendet wird.


void translate(vector3d vLocal, enumeration option)

Verschiebt die Kameraposition und den Blickvektor um vLocal in lokalen Koordinaten. Unter option kann man einstellen, ob der Mittelpunkt der Ansicht verschoben werden soll.

  • Camera.TranslateViewCenter
  • Camera.DontTranslateViewCenter

Siehe auch Qt3DRender::QCamera::CameraTranslationOption.


void translateWorld(vector3d vWorld, enumeration option)

Verschiebt die Kameraposition und den Ansichtsvektor um vWorld in Weltkoordinaten. Die option erlaubt es, umzuschalten, ob das Ansichtszentrum übersetzt werden soll.

  • Camera.TranslateViewCenter
  • Camera.DontTranslateViewCenter

Siehe auch Qt3DRender::QCamera::CameraTranslationOption.


void viewAll()

Dreht und verschiebt die Kamera so, dass viewCenter das Zentrum des Bounding Volumes der Szene ist und die gesamte Szene in den View Port passt.

Hinweis: Funktioniert nur, wenn sich das Objektiv im perspektivischen oder orthografischen Projektionsmodus befindet.

Siehe auch Qt3D.Render::Camera::projectionType.


void viewEntity(Entity entity)

Dreht und bewegt die Kamera so, dass viewCenter der Mittelpunkt des Begrenzungsvolumens des Objekts ist und die gesamte entity in den Ansichtsbereich passt.

Hinweis: Funktioniert nur, wenn sich das Objektiv im perspektivischen oder orthografischen Projektionsmodus befindet.

Siehe auch Qt3D.Render::Camera::projectionType.


void viewSphere(vector3d center, real radius)

Dreht und verschiebt die Kamera so, dass viewCenter center ist und eine Kugel von radius in den Ansichtsbereich passt.

Hinweis: Funktioniert nur, wenn sich das Objektiv im perspektivischen oder orthografischen Projektionsmodus befindet.

Siehe auch Qt3D.Render::Camera::projectionType.


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