Camera QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• Ausgeschiedene Mitglieder

Eigenschaften

• aspectRatio : real
• bottom : real
• exposure : real
• farPlane : real
• fieldOfView : real
• left : real
• lens : CameraLens
• nearPlane : real
• position : vector3d
• projectionMatrix : matrix4x4
• projectionType : enumeration
• right : real
• top : real
• transform : Transform
• upVector : vector3d
• viewCenter : vector3d
• viewVector : vector3d

Methoden

• void pan(real angle)
• void pan(real angle, vector3d axis)
• void panAboutViewCenter(real angle)
• void panAboutViewCenter(real angle, vector3d axis)
• quaternion panRotation(real angle)
• void roll(real angle)
• void rollAboutViewCenter(real angle)
• quaternion rollRotation(real angle)
• void rotate(quaternion q)
• void rotateAboutViewCenter(quaternion q)
• quaternion rotation(real angle, vector3d axis)
• void tilt(real angle)
• void tiltAboutViewCenter(real angle)
• quaternion tiltRotation(real angle)
• void translate(vector3d vLocal, enumeration option)
• void translateWorld(vector3d vWorld, enumeration option)
• void viewAll()
• void viewEntity(Entity entity)
• void viewSphere(vector3d center, real radius)

Detaillierte Beschreibung

Dokumentation der Eigenschaft

aspectRatio : real

Enthält das aktuelle Seitenverhältnis der Kamera.

bottom : real

Enthält die aktuelle Unterseite der Kamera.

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

exposure : real

Speichert die aktuelle Belichtung der Kamera.

Der Standardwert ist 0.0.

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

Benutzerdefinierte Materialien können diesen 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 CameraLens .PerspectiveProjection ist.

left : real

Enthält die aktuelle linke Seite der Kamera.

Diese Eigenschaft ist nur relevant, wenn projectionType CameraLens .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 zum übergeordneten Objekt.

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.

top : real

Enthält die aktuelle Oberkante der Kamera.

Diese Eigenschaft ist nur relevant, wenn projectionType CameraLens .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 Ihnen, diese Art der Bewegung zu steuern.

viewCenter : vector3d

Enthält das aktuelle Ansichtszentrum der Kamera in Koordinaten relativ zur übergeordneten Entität.

Intuitiv ist das viewCenter die Position, auf die die Kamera gerichtet ist.

viewVector : vector3d [read-only]

Enthält den Sichtvektor der Kamera in Koordinaten relativ zum übergeordneten Objekt.

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

Dokumentation der Methode

void pan(real angle)

Passt den Schwenkwinkel der Kamera über angle in Grad an.

void pan(real angle, vector3d axis)

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

void panAboutViewCenter(real angle)

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

void panAboutViewCenter(real angle, vector3d axis)

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

quaternion panRotation(real angle)

Gibt die berechnete Schwenkdrehung in Bezug auf angle in Grad zurück, die zum Einstellen 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 in Bezug auf angle in Grad zurück, um die Drehung der Kamera um die Z-Achse oder die Neigung nach links/rechts 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 den Mittelpunkt der Ansicht.

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 über angle in Grad an.

void tiltAboutViewCenter(real angle)

Passt die Kameraneigung um die Bildmitte an angle in Grad an.

quaternion tiltRotation(real angle)

Gibt die berechnete Neigungsdrehung in Bezug auf die angle in Grad zurück, die für die 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 Ansichtsvektor um vLocal in lokalen Koordinaten. Unter option kann eingestellt werden, ob das Zentrum der Ansicht verschoben werden soll.

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

Siehe auch Qt3DRender::QCamera::CameraTranslationOption.

void translateWorld(vector3d vWorld, enumeration option)

Verschiebt die Position der Kamera und ihren Ansichtsvektor um vWorld in Weltkoordinaten. Unter option kann eingestellt werden, ob das Zentrum der Ansicht verschoben werden soll.

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

Siehe auch Qt3DRender::QCamera::CameraTranslationOption.

void viewAll()

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

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

void viewEntity(Entity entity)

Dreht und verschiebt die Kamera so, dass die viewCenter in der Mitte des Bounding Volumes des Objekts liegt und die gesamte entity in den View Port passt.

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 die Sichtöffnung passt.

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