QVector3D Class

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept] QVector3D::QVector3D()

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

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

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

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

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

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

Konstruiert 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)

Konstruiert einen 3D-Vektor aus dem angegebenen 4D vector. Die w-Koordinate wird weggelassen.

Siehe auch toVector4D().

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

Konstruiert einen 3D-Vektor aus dem angegebenen 2D vector. Die z-Koordinate wird auf zpos gesetzt, die endlich sein muss.

Siehe auch toVector2D().

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

Konstruiert 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 Kreuzprodukt der Vektoren v1 und v2 zurück, das normal auf die von v1 und v2 aufgespannte Ebene ist. Es ist Null, wenn die beiden Vektoren parallel sind.

Siehe auch normal().

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

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

Wenn direction ein Nullvektor ist, dann definiert er keine Linie. 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 von diesem Scheitelpunkt zu einer Ebene zurück, die durch den Scheitelpunkt plane und einen Einheitsvektor normal definiert ist. Es wird angenommen, dass der Parameter normal auf einen Einheitsvektor normalisiert 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 von diesem Scheitelpunkt 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 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 die Entfernung von diesem Scheitelpunkt zu einem Punkt zurück, der durch den Scheitelpunkt point definiert ist.

Siehe auch distanceToPlane() und distanceToLine().

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

Gibt das Punktprodukt 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 die quadrierte Länge des Vektors vom Ursprung aus zurück. Dies ist äquivalent zum Punktprodukt des Vektors mit sich selbst.

Siehe auch length() und dotProduct().

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

Gibt den Einheitsnormalvektor einer Ebene zurück, die von den Vektoren v1 und v2 aufgespannt wird, die nicht parallel zueinander sein dürfen.

Verwenden Sie crossProduct(), um das Kreuzprodukt von v1 und v2 zu berechnen, wenn Sie das Ergebnis nicht auf einen Einheitsvektor normiert haben wollen.

Siehe auch crossProduct() und distanceToPlane().

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

Gibt den Einheitsnormalvektor einer Ebene zurück, die von den Vektoren v2 - v1 und v3 - v1 aufgespannt wird, die nicht parallel zueinander sein dürfen.

Verwenden Sie crossProduct(), um das Kreuzprodukt von v2 - v1 und v3 - v1 zu berechnen, wenn Sie das Ergebnis nicht auf einen Einheitsvektor normiert haben wollen.

Siehe auch crossProduct() und distanceToPlane().

[noexcept] void QVector3D::normalize()

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

Siehe auch length() und normalized().

[noexcept] QVector3D QVector3D::normalized() const

Gibt die normalisierte Einheitsvektorform dieses Vektors zurück.

Wenn dieser Vektor null ist, wird ein Nullvektor zurückgegeben. Wenn die Länge des Vektors sehr nahe bei 1 liegt, wird der Vektor so zurückgegeben, wie er ist. Andernfalls wird die normalisierte 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

Liefert die Fensterkoordinaten dieses Vektors zunächst in Objekt-/Modellkoordinaten unter Verwendung der Modell-View-Matrix modelView, der Projektionsmatrix projection und der Viewport-Dimensionen viewport.

Bei der Transformation vom Clip in den normalisierten Raum findet eine Division der Vektorkomponenten durch die w-Komponente statt. Um zu verhindern, dass durch 0 geteilt wird, wenn w gleich 0 ist, wird es auf 1 gesetzt.

Siehe auch unproject().

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

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

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ächstliegende Ganzzahl 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 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 wird.

Siehe auch toVector2D() und toPoint().

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

Liefert die Objekt-/Modellkoordinaten dieses Vektors zunächst in Fensterkoordinaten unter Verwendung der Modell-View-Matrix modelView, der Projektionsmatrix projection und der Viewport-Dimensionen viewport.

Bei der Transformation vom Clip in den normalisierten Raum findet eine Division durch die w-Komponente der Vektorkomponenten statt. Um zu verhindern, dass durch 0 geteilt wird, wenn w gleich 0 ist, wird es 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().

QVariant 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)

Dies ist eine überladene Funktion.

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 crossProduct() von diesem Vektor und vector. (Seine Komponenten addieren sich zum Punktprodukt von diesem Vektor 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 einen Verweis auf diesen Vektor zurück.

Siehe auch operator-=().

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

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

Siehe auch operator+=().

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

Dividiert jede Komponente dieses Vektors durch die entsprechende Komponente in vector und gibt einen Verweis auf diesen Vektor zurück.

Die vector darf keine Komponente haben, die entweder Null oder NaN ist.

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

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

Teilt die Koordinaten dieses Vektors durch die angegebene divisor und gibt einen Verweis auf diesen Vektor zurück. Die 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 änderbare 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 muss eine gültige Indexposition im Vektor sein (d. h. 0 <= i < 3).