Camera QML Type
Definiert einen Blickpunkt, durch den die Szene gerendert wird. Mehr...
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
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 |
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 |
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 |
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.
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.
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.
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.