QVector3D Class

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept] QVector3D::QVector3D()

Erzeugt einen Nullvektor, d. h. mit den Koordinaten (0, 0, 0).

[explicit constexpr noexcept] QVector3D::QVector3D(QPoint point)

Erzeugt einen Vektor mit x- und y-Koordinaten aus einem 2D- point sowie einer z-Koordinate von 0.

[explicit constexpr noexcept] QVector3D::QVector3D(QPointF point)

Erstellt einen Vektor mit x- und y-Koordinaten aus einem 2D- point sowie einer z-Koordinate von 0.

[explicit constexpr noexcept] QVector3D::QVector3D(QVector2D vector)

Erstellt einen 3D-Vektor aus dem angegebenen 2D- vector. Die z-Koordinate wird auf Null gesetzt.

Siehe auch „ toVector2D()“.

[explicit constexpr noexcept] QVector3D::QVector3D(QVector4D vector)

Erstellt einen 3D-Vektor aus dem angegebenen 4D- vector. Die w-Koordinate wird verworfen.

Siehe auch toVector4D().

[constexpr noexcept] QVector3D::QVector3D(QVector2D vector, float zpos)

Erzeugt einen 3D-Vektor aus dem angegebenen 2D- vector. Die z-Koordinate wird auf zpos gesetzt, wobei dieser Wert endlich sein muss.

Siehe auch ` toVector2D()` .

[constexpr noexcept] QVector3D::QVector3D(float xpos, float ypos, float zpos)

Erzeugt einen Vektor mit den Koordinaten (xpos, ypos, zpos). Alle Parameter müssen endlich sein.

[static constexpr noexcept] QVector3D QVector3D::crossProduct(QVector3D v1, QVector3D v2)

Gibt das Vektorprodukt der Vektoren v1 und v2 zurück, das senkrecht zu der Ebene steht, die durch v1 und v2 aufgespannt wird. Es ist gleich Null, wenn die beiden Vektoren parallel sind.

Siehe auch normal().

[noexcept] float QVector3D::distanceToLine(QVector3D point, QVector3D direction) const

Gibt den Abstand dieses Scheitelpunkts zu einer Geraden zurück, die durch point und den Einheitsvektor direction definiert ist.

Ist ` direction ` ein Nullvektor, so definiert er keine Gerade. In diesem Fall wird der Abstand von ` point ` zu diesem Scheitelpunkt zurückgegeben.

Siehe auch distanceToPlane().

[constexpr noexcept] float QVector3D::distanceToPlane(QVector3D plane, QVector3D normal) const

Gibt den Abstand dieses Scheitelpunkts zu einer Ebene zurück, die durch den Scheitelpunkt plane und einen Einheitsvektor normal definiert ist. Es wird davon ausgegangen, dass der Parameter normal auf einen Einheitsvektor normiert wurde.

Der Rückgabewert ist negativ, wenn der Scheitelpunkt unterhalb der Ebene liegt, oder null, wenn er auf der Ebene liegt.

Siehe auch normal() und distanceToLine().

[noexcept] float QVector3D::distanceToPlane(QVector3D plane1, QVector3D plane2, QVector3D plane3) const

Gibt den Abstand dieses Scheitelpunkts zu einer Ebene zurück, die durch die Scheitelpunkte plane1, plane2 und plane3 definiert ist.

Der Rückgabewert ist negativ, wenn der Scheitelpunkt unterhalb der Ebene liegt, oder gleich Null, wenn er auf der Ebene liegt.

Die beiden Vektoren, die die Ebene definieren, sind plane2 – plane1 und plane3 – plane1.

Siehe auch normal() und distanceToLine().

[noexcept] float QVector3D::distanceToPoint(QVector3D point) const

Gibt den Abstand von diesem Scheitelpunkt zu einem Punkt zurück, der durch die Koordinaten point definiert ist.

Siehe auch distanceToPlane() und distanceToLine().

[static constexpr noexcept] float QVector3D::dotProduct(QVector3D v1, QVector3D v2)

Gibt das Skalarprodukt von ` v1 ` und ` v2` zurück.

[constexpr noexcept] bool QVector3D::isNull() const

Gibt „ true “ zurück, wenn die x-, y- und z-Koordinaten auf 0,0 gesetzt sind, andernfalls „ false “.

[noexcept] float QVector3D::length() const

Gibt die Länge des Vektors vom Ursprung aus zurück.

Siehe auch lengthSquared() und normalized().

[constexpr noexcept] float QVector3D::lengthSquared() const

Gibt das Quadrat der Länge des Vektors vom Ursprung aus zurück. Dies entspricht dem Skalarprodukt des Vektors mit sich selbst.

Siehe auch length() und dotProduct().

[static noexcept] QVector3D QVector3D::normal(QVector3D v1, QVector3D v2)

Gibt den Einheitsnormalenvektor einer Ebene zurück, die durch die Vektoren v1 und v2 aufgespannt wird, wobei diese nicht parallel zueinander sein dürfen.

Verwenden Sie crossProduct(), um das Vektorprodukt von v1 und v2 zu berechnen, wenn das Ergebnis nicht auf einen Einheitsvektor normiert werden muss.

Siehe auch crossProduct() und distanceToPlane().

[static noexcept] QVector3D QVector3D::normal(QVector3D v1, QVector3D v2, QVector3D v3)

Gibt den Einheitsnormalenvektor einer Ebene zurück, die durch die Vektoren v2 – v1 und v3 – v1 aufgespannt wird, wobei diese Vektoren nicht parallel zueinander sein dürfen.

Verwenden Sie crossProduct(), um das Vektorprodukt von v2 – v1 und v3 – v1 zu berechnen, wenn das Ergebnis nicht auf einen Einheitsvektor normiert sein muss.

Siehe auch crossProduct() und distanceToPlane().

[noexcept] void QVector3D::normalize()

Normalisiert den aktuellen Vektor an Ort und Stelle. Es geschieht nichts, wenn dieser Vektor ein Nullvektor ist oder die Länge des Vektors sehr nahe bei 1 liegt.

Siehe auch length() und normalized().

[noexcept] QVector3D QVector3D::normalized() const

Gibt diesen Vektor in der Form eines normierten Einheitsvektors zurück.

Ist dieser Vektor null, wird ein Nullvektor zurückgegeben. Liegt die Länge des Vektors sehr nahe bei 1, wird der Vektor unverändert zurückgegeben. Andernfalls wird die normierte Form des Vektors der Länge 1 zurückgegeben.

Siehe auch length() und normalize().

QVector3D QVector3D::project(const QMatrix4x4 &modelView, const QMatrix4x4 &projection, const QRect &viewport) const

Gibt die Fensterkoordinaten dieses Vektors zurück, die ursprünglich in Objekt-/Modellkoordinaten vorliegen, unter Verwendung der Modell-Ansichts-Matrix modelView, der Projektionsmatrix projection und der Ansichtsfensterabmessungen viewport.

Bei der Transformation vom Clip- in den normierten Raum erfolgt eine Division der Vektorkomponenten durch die w-Komponente. Um eine Division durch 0 zu vermeiden, wenn w gleich 0 ist, wird w auf 1 gesetzt.

Siehe auch unproject().

[constexpr noexcept] void QVector3D::setX(float x)

Setzt die x-Koordinate dieses Punktes auf die angegebene endliche Koordinate x.

Siehe auch x(), setY() und setZ().

[constexpr noexcept] void QVector3D::setY(float y)

Setzt die y-Koordinate dieses Punktes auf die angegebene endliche y -Koordinate.

Siehe auch y(), setX() und setZ().

[constexpr noexcept] void QVector3D::setZ(float z)

Setzt die z-Koordinate dieses Punktes auf die angegebene, endliche z -Koordinate.

Siehe auch z(), setX() und setY().

[constexpr noexcept] QPoint QVector3D::toPoint() const

Gibt die Form „ QPoint “ dieses 3D-Vektors zurück. Die z-Koordinate wird weggelassen. Die x- und y-Koordinaten werden auf die nächsten ganzen Zahlen gerundet.

Siehe auch „ toPointF()“ und „ toVector2D()“.

[constexpr noexcept] QPointF QVector3D::toPointF() const

Gibt die Form „ QPointF “ dieses 3D-Vektors zurück. Die z-Koordinate wird dabei weggelassen.

Siehe auch „ toPoint()“ und „ toVector2D()“.

[constexpr noexcept] QVector2D QVector3D::toVector2D() const

Gibt die 2D-Vektorform dieses 3D-Vektors zurück, wobei die z-Koordinate weggelassen wird.

Siehe auch toVector4D() und toPoint().

[constexpr noexcept] QVector4D QVector3D::toVector4D() const

Gibt die 4D-Form dieses 3D-Vektors zurück, wobei die w-Koordinate auf Null gesetzt ist.

Siehe auch toVector2D() und toPoint().

QVector3D QVector3D::unproject(const QMatrix4x4 &modelView, const QMatrix4x4 &projection, const QRect &viewport) const

Gibt die Objekt-/Modellkoordinaten dieses Vektors zurück, die ursprünglich in Fensterkoordinaten vorliegen, unter Verwendung der Modell-Ansichts-Matrix modelView, der Projektionsmatrix projection und der Viewport-Abmessungen viewport.

Bei der Transformation vom Clip- in den normalisierten Raum erfolgt eine Division durch die w-Komponente der Vektorkomponenten. Um eine Division durch 0 zu vermeiden, wenn w gleich 0 ist, wird w auf 1 gesetzt.

Siehe auch ` project()`.

[constexpr noexcept] float QVector3D::x() const

Gibt die x-Koordinate dieses Punktes zurück.

Siehe auch setX(), y() und z().

[constexpr noexcept] float QVector3D::y() const

Gibt die y-Koordinate dieses Punktes zurück.

Siehe auch setY(), x() und z().

[constexpr noexcept] float QVector3D::z() const

Gibt die z-Koordinate dieses Punktes zurück.

Siehe auch setZ(), x() und y().

QVector3D::operator QVariant() const

Gibt den 3D-Vektor als ` QVariant` zurück.

[constexpr noexcept] QVector3D &QVector3D::operator*=(float factor)

Multipliziert die Koordinaten dieses Vektors mit der angegebenen endlichen factor und gibt eine Referenz auf diesen Vektor zurück.

Siehe auch „ operator/=()“ und „ operator*()“.

[constexpr noexcept] QVector3D &QVector3D::operator*=(QVector3D vector)

Multipliziert jede Komponente dieses Vektors mit der entsprechenden Komponente in vector und gibt eine Referenz auf diesen Vektor zurück.

Hinweis: Dies ist nicht dasselbe wie die Funktion ` crossProduct()` dieses Vektors und ` vector`. (Die Summe ihrer Komponenten entspricht dem Skalarprodukt dieses Vektors und ` vector`.)

Siehe auch crossProduct(), operator/=() und operator*().

[constexpr noexcept] QVector3D &QVector3D::operator+=(QVector3D vector)

Fügt den angegebenen vector zu diesem Vektor hinzu und gibt eine Referenz auf diesen Vektor zurück.

Siehe auch ` operator-=()`.

[constexpr noexcept] QVector3D &QVector3D::operator-=(QVector3D vector)

Subtrahiert den angegebenen Vektor ` vector ` von diesem Vektor und gibt einen Verweis auf diesen Vektor zurück.

Siehe auch ` operator+=()`.

[constexpr] QVector3D &QVector3D::operator/=(QVector3D vector)

Teilt jede Komponente dieses Vektors durch die entsprechende Komponente in „ vector “ und gibt eine Referenz auf diesen Vektor zurück.

Der Vektor ` vector ` darf keine Komponente enthalten, die entweder Null oder NaN ist.

Siehe auch „ operator*=()“ und „ operator/()“.

[constexpr] QVector3D &QVector3D::operator/=(float divisor)

Teilt die Koordinaten dieses Vektors durch den angegebenen Wert „ divisor “ und gibt eine Referenz auf diesen Vektor zurück. Der Wert „ divisor “ darf weder Null noch NaN sein.

Siehe auch „ operator*=()“ und „ operator/()“.

[constexpr] float &QVector3D::operator[](int i)

Gibt die Komponente des Vektors an der Indexposition i als bearbeitbare Referenz zurück.

i muss eine gültige Indexposition im Vektor sein (d. h., 0 <= i < 3).

[constexpr] float QVector3D::operator[](int i) const

Gibt die Komponente des Vektors an der Indexposition i zurück.

i i muss eine gültige Indexposition im Vektor sein (d. h., 0 <= < 3).