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 !