QVector3D Class

Documentation des fonctions membres

[constexpr noexcept] QVector3D::QVector3D()

Construit un vecteur nul, c'est-à-dire dont les coordonnées sont (0, 0, 0).

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

Construit un vecteur avec les coordonnées x et y d'un site 2D point, et une coordonnée z de 0.

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

Construit un vecteur avec les coordonnées x et y d'un site 2D point, et une coordonnée z de 0.

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

Construit un vecteur 3D à partir du vecteur 2D spécifié vector. La coordonnée z est mise à zéro.

Voir également toVector2D().

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

Construit un vecteur 3D à partir du vecteur 4D spécifié vector. La coordonnée w est abandonnée.

Voir également toVector4D().

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

Construit un vecteur 3D à partir du vecteur 2D spécifié vector. La coordonnée z est fixée à zpos, qui doit être finie.

Voir également toVector2D().

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

Construit un vecteur dont les coordonnées sont (xpos, ypos, zpos). Tous les paramètres doivent être finis.

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

Renvoie le produit croisé des vecteurs v1 et v2, qui est normal au plan couvert par v1 et v2. Il sera nul si les deux vecteurs sont parallèles.

Voir aussi normal().

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

Renvoie la distance entre ce sommet et une ligne définie par point et le vecteur unitaire direction.

Si direction est un vecteur nul, il ne définit pas de ligne. Dans ce cas, la distance entre point et ce sommet est renvoyée.

Voir également distanceToPlane().

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

Renvoie la distance entre ce sommet et un plan défini par le sommet plane et un vecteur unitaire normal. Le paramètre normal est supposé avoir été normalisé à un vecteur unitaire.

La valeur de retour sera négative si le sommet est en dessous du plan, ou nulle s'il est sur le plan.

Voir aussi normal() et distanceToLine().

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

Renvoie la distance entre ce sommet et un plan défini par les sommets plane1, plane2 et plane3.

La valeur de retour sera négative si le sommet est en dessous du plan, ou nulle s'il est sur le plan.

Les deux vecteurs qui définissent le plan sont plane2 - plane1 et plane3 - plane1.

Voir aussi normal() et distanceToLine().

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

Renvoie la distance entre ce sommet et un point défini par le sommet point.

Voir également distanceToPlane() et distanceToLine().

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

Renvoie le produit point de v1 et v2.

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

Renvoie true si les coordonnées x, y et z sont fixées à 0,0, sinon renvoie false.

[noexcept] float QVector3D::length() const

Renvoie la longueur du vecteur à partir de l'origine.

Voir aussi lengthSquared() et normalized().

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

Renvoie le carré de la longueur du vecteur à partir de l'origine. Ceci est équivalent au produit du point du vecteur avec lui-même.

Voir aussi length() et dotProduct().

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

Renvoie le vecteur normal unitaire d'un plan traversé par les vecteurs v1 et v2, qui ne doivent pas être parallèles l'un à l'autre.

Utilisez crossProduct() pour calculer le produit croisé de v1 et v2 si vous n'avez pas besoin que le résultat soit normalisé à un vecteur unitaire.

Voir également crossProduct() et distanceToPlane().

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

Renvoie le vecteur normal unitaire d'un plan traversé par les vecteurs v2 - v1 et v3 - v1, qui ne doivent pas être parallèles entre eux.

Utilisez crossProduct() pour calculer le produit croisé de v2 - v1 et v3 - v1 si vous n'avez pas besoin que le résultat soit normalisé à un vecteur unitaire.

Voir également crossProduct() et distanceToPlane().

[noexcept] void QVector3D::normalize()

Normalise le vecteur courant en place. Rien ne se passe si ce vecteur est un vecteur nul ou si la longueur du vecteur est très proche de 1.

Voir aussi length() et normalized().

[noexcept] QVector3D QVector3D::normalized() const

Renvoie la forme vectorielle unitaire normalisée de ce vecteur.

Si ce vecteur est nul, un vecteur nul est renvoyé. Si la longueur du vecteur est très proche de 1, le vecteur sera retourné tel quel. Sinon, la forme normalisée du vecteur de longueur 1 sera renvoyée.

Voir aussi length() et normalize().

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

Renvoie les coordonnées de fenêtre de ce vecteur initialement en coordonnées objet/modèle en utilisant la matrice de vue du modèle modelView, la matrice de projection projection et les dimensions de la fenêtre de vue viewport.

Lors de la transformation de l'espace clip à l'espace normalisé, une division par la composante w sur les composantes du vecteur a lieu. Pour éviter une division par 0 si w est égal à 0, il est fixé à 1.

Voir aussi unproject().

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

Fixe la coordonnée x de ce point à la coordonnée finie x donnée.

Voir aussi x(), setY() et setZ().

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

Définit la coordonnée y de ce point à la coordonnée finie y donnée.

Voir aussi y(), setX() et setZ().

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

Fixe la coordonnée z de ce point à la coordonnée finie z donnée.

Voir aussi z(), setX() et setY().

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

Renvoie la forme QPoint de ce vecteur 3D. La coordonnée z est abandonnée. Les coordonnées x et y sont arrondies aux entiers les plus proches.

Voir aussi toPointF() et toVector2D().

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

Renvoie la forme QPointF de ce vecteur 3D. La coordonnée z est supprimée.

Voir aussi toPoint() et toVector2D().

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

Renvoie la forme vectorielle 2D de ce vecteur 3D, sans la coordonnée z.

Voir aussi toVector4D() et toPoint().

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

Renvoie la forme 4D de ce vecteur 3D, la coordonnée w étant fixée à zéro.

Voir aussi toVector2D() et toPoint().

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

Renvoie les coordonnées objet/modèle de ce vecteur initialement en coordonnées de fenêtre en utilisant la matrice de vue du modèle modelView, la matrice de projection projection et les dimensions de la fenêtre de visualisation viewport.

Lors de la transformation du clip en espace normalisé, une division par la composante w des composantes du vecteur a lieu. Pour éviter une division par 0 si w est égal à 0, il est fixé à 1.

Voir aussi project().

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

Renvoie la coordonnée x de ce point.

Voir aussi setX(), y() et z().

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

Renvoie la coordonnée y de ce point.

Voir aussi setY(), x() et z().

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

Renvoie la coordonnée z de ce point.

Voir aussi setZ(), x() et y().

QVector3D::operator QVariant() const

Renvoie le vecteur 3D sous forme de QVariant.

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

Multiplie les coordonnées de ce vecteur par la valeur finie donnée factor et renvoie une référence à ce vecteur.

Voir aussi operator/=() et operator*().

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

Multiplie chaque composante de ce vecteur par la composante correspondante dans vector et renvoie une référence à ce vecteur.

Remarque : il ne s'agit pas de la même chose que le produit crossProduct() de ce vecteur et de vector(ses composantes s'additionnent au produit en points de ce vecteur et de vector).

Voir aussi crossProduct(), operator/=(), et operator*().

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

Ajoute l'adresse vector à ce vecteur et renvoie une référence à ce vecteur.

Voir aussi operator-=().

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

Soustrait la valeur vector de ce vecteur et renvoie une référence à ce vecteur.

Voir aussi operator+=().

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

Divise chaque composante de ce vecteur par la composante correspondante dans vector et renvoie une référence à ce vecteur.

L'adresse vector ne doit pas avoir de composante nulle ou NaN.

Voir aussi operator*=() et operator/().

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

Divise les coordonnées de ce vecteur par divisor, et renvoie une référence à ce vecteur. L'adresse divisor ne doit pas être zéro ou NaN.

Voir aussi operator*=() et operator/().

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

Renvoie la composante du vecteur à la position d'index i sous forme de référence modifiable.

i doit être une position d'index valide dans le vecteur (c'est-à-dire 0 <= i < 3).

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

Renvoie la composante du vecteur à la position d'index i.

i doit être une position d'index valide dans le vecteur (c'est-à-dire 0 <= i < 3).