Camera QML Type

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

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• Veraltete 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)

Ausführliche Beschreibung

Objektdokumentation

aspectRatio : real

Behält das aktuelle Seitenverhältnis der Kamera bei.

bottom : real

Enthält die aktuelle Unterkante der Kamera.

Diese Eigenschaft ist nur relevant, wenn „ projectionType “ auf „CameraLens.OrthographicProjection“ gesetzt ist.

exposure : real

Speichert die aktuelle Belichtung der Kamera.

Der Standardwert ist 0,0.

Das „MetalRoughMaterial“ in „ Qt 3D Extras“ ist derzeit das einzige bereitgestellte Material, das die Belichtung der Kamera nutzt. Negative Werte führen dazu, dass das Material dunkler wird, positive Werte hingegen, dass es heller wird.

Benutzerdefinierte Materialien können den Wert möglicherweise anders interpretieren.

farPlane : real

Speichert die aktuelle Fernebene der Kamera. Objekte, die weiter von der Kamera entfernt sind als die „farPlane“, werden nicht gerendert.

fieldOfView : real

Gibt das aktuelle vertikale Sichtfeld der Kamera in Grad an.

Zusammen mit „ aspectRatio “ bestimmt diese Eigenschaft, wie viel von der Szene für die Kamera sichtbar ist. In dieser Hinsicht kann man sich das analog zur Wahl eines Weitwinkelobjektivs (breites horizontales Sichtfeld) oder eines Teleobjektivs (enges horizontales Sichtfeld) vorstellen, je nachdem, wie viel von einer Szene man erfassen möchte.

„fieldOfView“ ist nur relevant, wenn „ projectionType “ auf „CameraLens.PerspectiveProjection“ gesetzt ist.

left : real

Enthält die aktuelle Position der Kamera auf der linken Seite.

Diese Eigenschaft ist nur relevant, wenn „ projectionType “ auf „CameraLens.OrthographicProjection“ gesetzt ist.

lens : CameraLens [read-only]

Enthält die „CameraLens“-Komponente der Kamera.

nearPlane : real

Hält die aktuelle Kamera in der Nähe der Kameraebene. Objekte, die näher an der Kamera liegen als die nearPlane, werden nicht gerendert.

position : vector3d

Speichert 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 ihrer Entfernung gleich groß.
• CameraLens.PerspectiveProjection – Parallele Linien scheinen sich in der Ferne zu treffen. Objekte erscheinen umso kleiner, je weiter sie von der Kamera entfernt sind.
• CameraLens.FrustumProjection
• CameraLens.CustomProjection

Siehe auch „ Qt3DRender::QCameraLens::ProjectionType “.

right : real

Enthält die aktuelle Ausrichtung der Kamera.

Diese Eigenschaft ist nur relevant, wenn „ projectionType “ auf „CameraLens.OrthographicProjection“ gesetzt ist.

top : real

Enthält die aktuelle Oberkante der Kamera.

Diese Eigenschaft ist nur relevant, wenn „ projectionType “ auf „CameraLens.OrthographicProjection“ gesetzt ist.

transform : Transform [read-only]

Enthält die Transformationskomponente der Kamera.

upVector : vector3d

Enthält den aktuellen Aufwärtsvektor der Kamera in Koordinaten relativ zur übergeordneten Entität.

Der „up“-Vektor gibt an, in welche Richtung die Oberseite der Kamera zeigt. Stellen Sie sich vor, Sie machen ein Foto: Nachdem Sie sich positioniert und die Kamera auf Ihr Motiv gerichtet haben, drehen Sie die Kamera möglicherweise nach links oder rechts, um eine Aufnahme im Hoch- oder Querformat (oder in einem Winkel!) zu erhalten. Mit „upVector“ können Sie diese Art von Bewegung steuern.

viewCenter : vector3d

Speichert den aktuellen Blickpunkt der Kamera in Koordinaten relativ zur übergeordneten Entität.

Intuitiv gesehen ist der „viewCenter“ der Ort, auf den die Kamera gerichtet ist.

viewVector : vector3d [read-only]

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

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

Methodendokumentation

void pan(real angle)

Passt den Schwenkwinkel der Kamera um angle in Grad an.

void pan(real angle, vector3d axis)

Passt die Kameraschwenkung um die Bildmitte um angle Grad auf axis an.

void panAboutViewCenter(real angle)

Passt die Kamerabewegung um den Blickpunkt um angle Grad an.

void panAboutViewCenter(real angle, vector3d axis)

Passt die Kameraschwenkung um die Bildmitte um angle Grad auf axis an.

quaternion panRotation(real angle)

Gibt die berechnete Schwenkdrehung in Bezug auf die „ angle “ in Grad zurück, die zur Anpassung der Schwenkbewegung oder der Drehung nach links/rechts der Kamera um die Y-Achse herangezogen wird.

void roll(real angle)

Passt die Kameraneigung um angle in Grad an.

void rollAboutViewCenter(real angle)

Passt die Kamerarollung um angle Grad um den Blickpunkt an.

quaternion rollRotation(real angle)

Gibt die berechnete Rollrotation in Bezug auf die „ angle “ in Grad zurück, die zur Anpassung der Roll- oder Neigungsrotation der Kamera nach links/rechts um die Z-Achse herangezogen wird.

void rotate(quaternion q)

Dreht die Kamera mithilfe eines Quaternions in „ q “.

void rotateAboutViewCenter(quaternion q)

Dreht die Kamera mithilfe eines Quaternions in „ q “ um den Blickpunkt.

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 Neigung der Kamera um den Blickpunkt herum um angle Grad an.

quaternion tiltRotation(real angle)

Gibt die berechnete Neigungsdrehung in Grad relativ zur „ angle “ zurück, die zur Anpassung der Neigung oder der Drehung der Kamera um die X-Achse (nach oben/unten) herangezogen wird.

void translate(vector3d vLocal, enumeration option)

Verschiebt die Position der Kamera und ihren Blickvektor um vLocal in lokalen Koordinaten. Mit dem Schalter „ option “ kann festgelegt werden, ob der Blickpunkt 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 Blickvektor um vWorld in Weltkoordinaten. Mit dem Schalter „ option “ kann festgelegt werden, ob der Blickpunkt verschoben werden soll.

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

Siehe auch „ Qt3DRender::QCamera::CameraTranslationOption “.

void viewAll()

Dreht und verschiebt die Kamera so, dass ihr „ viewCenter “ im Mittelpunkt des Begrenzungsvolumens der Szene liegt und die gesamte Szene in den Ansichtsbereich passt.

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

void viewEntity(Entity entity)

Dreht und verschiebt die Kamera so, dass ihr „ viewCenter “ im Mittelpunkt des Begrenzungsvolumens des Objekts liegt und das gesamte „ entity “ in den Ansichtsbereich passt.

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

void viewSphere(vector3d center, real radius)

Dreht und verschiebt die Kamera so, dass ihr „ viewCenter “ auf „ center “ gesetzt ist und eine Kugel mit den Koordinaten „ radius “ in den Ansichtsbereich passt.

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