QVector3D

La classe QVector3D représente un vecteur ou un vertex dans un espace en trois dimensions. Plus d'informations...

#include <QVector3D>

Voir la position dans l'arbre des classes.

Cette classe a été introduite dans Qt 4.6.

Description détaillée

La classe QVector3D représente un vecteur ou un vertex dans un espace en trois dimensions.

Les vecteurs sont l'un des blocs les plus importants de la représentation de scènes 3D et de leur rendu. Ils sont composés de trois coordonnées, traditionnellement appelées x, y et z.

La classe QVector3D peut aussi être utilisée pour représenter des vertex dans un espace en trois dimensions. On n'a donc pas besoin de fournir une classe supplémentaire pour les vertex.

Voir aussi QVector2D, QVector4D et QQuaternion.

Fonctions membres

QVector3D::QVector3D ()

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

QVector3D::QVector3D ( qreal xpos, qreal ypos, qreal zpos )

Construit un vecteur avec les coordonnées (xpos, ypos, zpos).

QVector3D::QVector3D ( const QPoint & point )

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

QVector3D::QVector3D ( const QPointF & point )

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

QVector3D::QVector3D ( const QVector2D & vector )

Construit un vecteur 3D à partir du vecteur 2D vector spécifié. La coordonnée z est définie à 0.

Voir aussi toVector2D().

QVector3D::QVector3D ( const QVector2D & vector, qreal zpos )

Construit un vecteur 3D à partir du vecteur 2D vector spécifié. La coordonnée z est définie à zpos.

Voir aussi toVector2D().

QVector3D::QVector3D ( const QVector4D & vector )

Construit un vecteur 3D avec les coordonnées du vecteur 4D vector. La coordonnée w est oubliée.

Voir aussi toVector4D().

QVector3D QVector3D::crossProduct ( const QVector3D & v1, const QVector3D & v2 ) [static]

Retourne le produit vectoriel des vecteurs v1 et v2, ce qui correspond au vecteur normal au plan défini par v1 et v2.

Voir aussi normal().

qreal QVector3D::distanceToLine ( const QVector3D & point, const QVector3D & direction ) const

Retourne la distance entre ce vertex et la ligne définie par point et le vecteur unité direction.

Si direction est un vecteur nul, alors aucune ligne n'est définie. Dans ce cas, la distance entre le point et ce vertex est retournée.

Voir aussi distanceToPlane().

qreal QVector3D::distanceToPlane ( const QVector3D & plane, const QVector3D & normal ) const

Retourne la distance entre ce vertex et le plan défini par le vecteur plane et un vecteur unité normal. Le paramètre normal est supposé avoir été normalisé.

La valeur retournée sera négative si le vertex est sous le plan ou zéro s'il est sur le plan.

Voir aussi normal() et distanceToLine().

qreal QVector3D::distanceToPlane ( const QVector3D & plane1, const QVector3D & plane2, const QVector3D & plane3 ) const

Il s'agit d'une fonction surchargée.

Retourne la distance entre ce vertex et un plan défini par les vertex plane1, plane2 et plane3.

La valeur retournée sera négative si le vertex est sous le plan ou zéro 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().

qreal QVector3D::dotProduct ( const QVector3D & v1, const QVector3D & v2 ) [static]

Retourne le produit scalaire de v1 et v2.

bool QVector3D::isNull () const

Retourne true si les coordonnées x, y et z sont définies à 0.0, sinon retourne false.

qreal QVector3D::length () const

Retourne la longueur de ce vecteur à partir de son origine.

Voir aussi lengthSquared() et normalized().

qreal QVector3D::lengthSquared () const

Retourne la longueur au carré de ce vecteur à partir de son origine. C'est équivalent à effectuer un produit scalaire de ce vecteur avec lui-même.

Voir aussi length() et dotProduct().

QVector3D QVector3D::normal ( const QVector3D & v1, const QVector3D & v2 ) [static]

Retourne le vecteur normal au plan défini par les vecteurs v1 et v2, normalisé pour être un vecteur unité.

On utilise crossProduct() pour calculer le produit vectoriel de v1 et v2 si on n'a pas besoin que le résultat soit normalisé.

Voir aussi crossProduct() et distanceToPlane().

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

Il s'agit d'une fonction surchargée.

Retourne le vecteur normal au plan défini par les vecteurs v2 - v1 et v3 - v1, normalisé pour être un vecteur unité.

On utilise crossProduct() pour calculer le produit vectoriel de v2 - v1 et v3 - v1 si on n'a pas besoin que le résultat soit normalisé.

Voir aussi crossProduct() et distanceToPlane().

void QVector3D::normalize ()

Normalise ce vecteur. Rien ne se passe si le vecteur est nul ou si la longueur de ce vecteur est proche de 1.

Voir aussi length() et normalized().

QVector3D QVector3D::normalized () const

Retourne le vecteur unité normalisé créé à partir de ce vecteur.

Si ce vecteur est nul, alors un vecteur nul est retourné. Si la longueur de ce vecteur est très proche de 1, alors le vecteur va être retourné tel quel. Sinon la forme normalisée du vecteur avec une longueur de 1 sera retournée.

Voir aussi length() et normalize().

void QVector3D::setX ( qreal x )

Définit la coordonnée x de ce point à la coordonnée x donnée

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

void QVector3D::setY ( qreal y )

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

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

void QVector3D::setZ ( qreal z )

Définit la coordonnée z de ce point à la coordonnée z donnée

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

QPoint QVector3D::toPoint () const

Retourne ce vecteur 3D sous la forme d'un QPoint. La coordonnée z est ignorée.

Voir aussi toPointF() et toVector2D().

QPointF QVector3D::toPointF () const

Retourne ce vecteur 3D sous la forme d'un QPointF. La coordonnée z est ignorée.

Voir aussi toPoint() et toVector2D().

QVector2D QVector3D::toVector2D () const

Retourne ce vecteur 3D sous la forme d'un vecteur 2D, ignorant la coordonnée z.

Voir aussi toVector4D() et toPoint().

QVector4D QVector3D::toVector4D () const

Retourne ce vecteur 3D sous la forme d'un vecteur 4D, avec la coordonnée w définie à zéro.

Voir aussi toVector2D() et toPoint().

qreal QVector3D::x () const

Retourne la coordonnée x de ce point.

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

qreal QVector3D::y () const

Retourne la coordonnée y de ce point.

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

qreal QVector3D::z () const

Retourne la coordonnée z de ce point.

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

QVector3D::operator QVariant () const

Retourne le vecteur 3D comme un QVariant.

QVector3D & QVector3D::operator*= ( qreal factor )

Multiplie les coordonnées de ce vecteur par le facteur factor et retourne une référence sur ce vecteur.

Voir aussi operator/=().

QVector3D & QVector3D::operator*= ( const QVector3D & vector )

Il s'agit d'une fonction surchargée.

Multiplie les composantes de ce vecteur par les composantes correspondantes du vecteur vector.

Note : ce n'est pas identique au produit vectoriel crossProduct() de ce vecteur avec le vecteur vector.

Voir aussi crossProduct().

QVector3D & QVector3D::operator+= ( const QVector3D & vector )

Ajoute le vecteur vector donné à ce vecteur et retourne une référence sur ce vecteur.

Voir aussi operator-=().

QVector3D & QVector3D::operator-= ( const QVector3D & vector )

Soustrait le vecteur vector donné de ce vecteur et retourne une référence sur ce vecteur.

Voir aussi operator+=().

QVector3D & QVector3D::operator/= ( qreal divisor )

Divise les coordonnées de ce vecteur avec le diviseur divisor donné et retourne une référence sur ce vecteur.

Voir aussi operator*=().

En relation mais non membres de la classe

bool qFuzzyCompare ( const QVector3D & v1, const QVector3D & v2 )

Retourne true si v1 et v2 sont égaux. La comparaison utilise un petit facteur flou dans la comparaison des nombres à virgule flottante ; la fonction retourne false s'ils sont différents.

bool operator!= ( const QVector3D & v1, const QVector3D & v2 )

Retourne true si v1 et v2 ne sont pas égaux, sinon retourne false. Cet opérateur utilise une comparaison exacte des nombres flottants.

const QVector3D operator* ( qreal factor, const QVector3D & vector )

Retourne une copie du vecteur vector donné, multiplié par le facteur factor.

Voir aussi QVector3D::operator*=().

const QVector3D operator* ( const QVector3D & vector, qreal factor )

Retourne une copie de vecteur vector donné, multiplié par le facteur factor.

Voir aussi QVector3D::operator*=().

const QVector3D operator* ( const QVector3D & v1, const QVector3D & v2 )

Multiplie les composantes de v1 avec les composantes correspondantes de v2.

Note : ce n'est pas identique au produit vectoriel crossProduct() de v1 avec v2.

Voir aussi QVector3D::crossProduct().

const QVector3D operator+ ( const QVector3D & v1, const QVector3D & v2 )

Retourne un objet QVector3D qui est la somme des vecteurs donnés, v1 et v2 ; chaque composante est ajoutée séparément.

Voir aussi QVector3D::operator+=().

const QVector3D operator- ( const QVector3D & v1, const QVector3D & v2 )

Retourne un objet QVector3D qui est la soustraction de v2 de v1 ; chaque composante est soustraite séparément.

Voir aussi QVector3D::operator-=().

const QVector3D operator- ( const QVector3D & vector )

Il s'agit d'une fonction surchargée.

Retourne un objet QVector3D qui est formé par le changement de signe des composantes du vecteur vector donné.

Équivalent à QVector3D(0,0,0) - vector.

const QVector3D operator/ ( const QVector3D & vector, qreal divisor )

Retourne un objet QVector3D qui est la division des composantes du vecteur vector donné par le diviseur divisor.

Voir aussi QVector3D::operator/=().

QDataStream & operator<< ( QDataStream & stream, const QVector3D & vector )

Écrit le vecteur vector donné sur le flux stream et retourne une référence sur le flux.

Voir aussi sérialisation des types de données Qt.

bool operator== ( const QVector3D & v1, const QVector3D & v2 )

Retourne true si v1 est égal à v2 ; sinon retourne false. Cet opérateur utilise une comparaison exacte.

QDataStream & operator>> ( QDataStream & stream, QVector3D & vector )

Lit un vecteur 3D à partir du flux stream dans le vecteur vector et retourne une référence sur le flux.

Voir aussi sérialisation des types de données Qt.

Remerciements

Merci à Alexandre Laurent pour la traduction ainsi qu'à Lo?c Leguay, Jonathan Courtois et Claude Leloup pour leur relecture !