En esta página

QVector3D Class

La clase QVector3D representa un vector o un vértice en el espacio tridimensional. Más información...

Encabezado: #include <QVector3D>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Funciones públicas

QVector3D()
QVector3D(QPoint point)
QVector3D(QPointF point)
QVector3D(QVector2D vector)
QVector3D(QVector4D vector)
QVector3D(QVector2D vector, float zpos)
QVector3D(float xpos, float ypos, float zpos)
float distanceToLine(QVector3D point, QVector3D direction) const
float distanceToPlane(QVector3D plane, QVector3D normal) const
float distanceToPlane(QVector3D plane1, QVector3D plane2, QVector3D plane3) const
float distanceToPoint(QVector3D point) const
bool isNull() const
float length() const
float lengthSquared() const
void normalize()
QVector3D normalized() const
QVector3D project(const QMatrix4x4 &modelView, const QMatrix4x4 &projection, const QRect &viewport) const
void setX(float x)
void setY(float y)
void setZ(float z)
QPoint toPoint() const
QPointF toPointF() const
QVector2D toVector2D() const
QVector4D toVector4D() const
QVector3D unproject(const QMatrix4x4 &modelView, const QMatrix4x4 &projection, const QRect &viewport) const
float x() const
float y() const
float z() const
operator QVariant() const
QVector3D &operator*=(float factor)
QVector3D &operator*=(QVector3D vector)
QVector3D &operator+=(QVector3D vector)
QVector3D &operator-=(QVector3D vector)
QVector3D &operator/=(QVector3D vector)
QVector3D &operator/=(float divisor)
float &operator[](int i)
float operator[](int i) const

Miembros públicos estáticos

QVector3D crossProduct(QVector3D v1, QVector3D v2)
float dotProduct(QVector3D v1, QVector3D v2)
QVector3D normal(QVector3D v1, QVector3D v2)
QVector3D normal(QVector3D v1, QVector3D v2, QVector3D v3)
bool qFuzzyCompare(QVector3D v1, QVector3D v2)
(since 6.12) size_t qHash(QVector3D key, size_t seed = 0)
bool operator!=(QVector3D v1, QVector3D v2)
QVector3D operator*(QVector3D v1, QVector3D v2)
QVector3D operator*(QVector3D vector, float factor)
QVector3D operator*(float factor, QVector3D vector)
QVector3D operator+(QVector3D v1, QVector3D v2)
QVector3D operator-(QVector3D v1, QVector3D v2)
QVector3D operator-(QVector3D vector)
QVector3D operator/(QVector3D vector, QVector3D divisor)
QVector3D operator/(QVector3D vector, float divisor)
QDataStream &operator<<(QDataStream &stream, QVector3D vector)
bool operator==(QVector3D v1, QVector3D v2)
QDataStream &operator>>(QDataStream &stream, QVector3D &vector)

Descripción detallada

Los vectores son uno de los componentes fundamentales de la representación y el dibujo en 3D. Se componen de tres coordenadas de punto flotante finitas, denominadas tradicionalmente x, y y z.

La clase QVector3D también se puede utilizar para representar vértices en el espacio 3D. Por lo tanto, no es necesario definir una clase de vértices independiente.

Véase también QVector2D, QVector4D y QQuaternion.

Documentación de las funciones miembro

[constexpr noexcept] QVector3D::QVector3D()

Crea un vector nulo, es decir, con coordenadas (0, 0, 0).

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

Crea un vector con coordenadas x e y a partir de un objeto 2D ` point`, y una coordenada z igual a 0.

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

Crea un vector con coordenadas x e y a partir de un objeto « point » bidimensional, y una coordenada z igual a 0.

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

Crea un vector 3D a partir del vector 2D especificado vector. La coordenada z se establece en cero.

Véase también toVector2D().

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

Crea un vector 3D a partir del vector 4D especificado vector. Se omite la coordenada w.

Véase también toVector4D().

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

Crea un vector 3D a partir del vector 2D especificado vector. La coordenada z se establece en zpos, que debe ser un valor finito.

Véase también toVector2D().

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

Crea un vector con las coordenadas (xpos, ypos, zpos). Todos los parámetros deben ser finitos.

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

Devuelve el producto vectorial de los vectores v1 y v2, que es normal al plano generado por v1 y v2. Será cero si los dos vectores son paralelos.

Véase también normal().

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

Devuelve la distancia a la que se encuentra este vértice de una recta definida por point y el vector unitario direction.

Si direction es un vector nulo, entonces no define una recta. En ese caso, se devuelve la distancia desde point hasta este vértice.

Véase también distanceToPlane().

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

Devuelve la distancia desde este vértice hasta un plano definido por el vértice plane y un vector unitario normal. Se supone que el parámetro normal ha sido normalizado a un vector unitario.

El valor devuelto será negativo si el vértice se encuentra por debajo del plano, o cero si se encuentra en el plano.

Véanse también normal() y distanceToLine().

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

Devuelve la distancia desde este vértice hasta un plano definido por los vértices plane1, plane2 y plane3.

El valor devuelto será negativo si el vértice se encuentra por debajo del plano, o cero si se encuentra en el plano.

Los dos vectores que definen el plano son plane2 - plane1 y plane3 - plane1.

Véanse también normal() y distanceToLine().

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

Devuelve la distancia entre este vértice y un punto definido por el vértice point.

Véase también distanceToPlane() y distanceToLine().

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

Devuelve el producto escalar de v1 y v2.

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

Devuelve « true » si las coordenadas x, y y z están establecidas en 0,0; en caso contrario, devuelve « false ».

[noexcept] float QVector3D::length() const

Devuelve la distancia del vector desde el origen.

Véase también lengthSquared() y normalized().

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

Devuelve la longitud al cuadrado del vector desde el origen. Esto equivale al producto escalar del vector consigo mismo.

Véase también length() y dotProduct().

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

Devuelve el vector normal unitario de un plano generado por los vectores v1 y v2, que no deben ser paralelos entre sí.

Utiliza crossProduct() para calcular el producto vectorial de v1 y v2 si no necesitas que el resultado esté normalizado a un vector unitario.

Véanse también crossProduct() y distanceToPlane().

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

Devuelve el vector normal unitario de un plano definido por los vectores v2 - v1 y v3 - v1, que no deben ser paralelos entre sí.

Utiliza crossProduct() para calcular el producto vectorial de v2 - v1 y v3 - v1 si no necesitas que el resultado se normalice a un vector unitario.

Véase también crossProduct() y distanceToPlane().

[noexcept] void QVector3D::normalize()

Normaliza el vector actual in situ. No ocurre nada si este vector es un vector nulo o si su longitud es muy cercana a 1.

Véase también length() y normalized().

[noexcept] QVector3D QVector3D::normalized() const

Devuelve la forma de vector unitario normalizado de este vector.

Si este vector es nulo, se devuelve un vector nulo. Si la longitud del vector es muy cercana a 1, el vector se devuelve tal cual. En caso contrario, se devuelve la forma normalizada del vector de longitud 1.

Véase también length() y normalize().

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

Devuelve las coordenadas de ventana de este vector, que inicialmente están expresadas en coordenadas de objeto/modelo, utilizando la matriz de vista del modelo modelView, la matriz de proyección projection y las dimensiones de la ventana de visualización viewport.

Al transformar del espacio de recorte al espacio normalizado, se realiza una división por el componente w en los componentes del vector. Para evitar dividir por 0 si w es igual a 0, se establece en 1.

Nota: las coordenadas y devueltas siguen la orientación de OpenGL. OpenGL espera que la parte inferior sea 0, mientras que en Qt la parte superior es 0.

Véase también unproject().

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

Establece la coordenada x de este punto en la coordenada finita dada x.

Véase también x(), setY() y setZ().

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

Establece la coordenada y de este punto en la coordenada finita y especificada.

Véase también y(), setX() y setZ().

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

Establece la coordenada z de este punto en la coordenada finita z especificada.

Véase también z(), setX() y setY().

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

Devuelve la forma « QPoint » de este vector 3D. Se omite la coordenada z. Las coordenadas x e y se redondean al entero más cercano.

Véase también toPointF() y toVector2D().

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

Devuelve la forma QPointF de este vector 3D. Se omite la coordenada z.

Véase también « toPoint()» y « toVector2D()».

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

Devuelve la forma de vector bidimensional de este vector tridimensional, omitiendo la coordenada z.

Véase también toVector4D() y toPoint().

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

Devuelve la forma 4D de este vector 3D, con la coordenada w establecida en cero.

Véase también toVector2D() y toPoint().

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

Devuelve las coordenadas del objeto o del modelo de este vector, que inicialmente están en coordenadas de ventana, utilizando la matriz de vista del modelo modelView, la matriz de proyección projection y las dimensiones de la ventana gráfica viewport.

Al transformar del espacio de recorte al espacio normalizado, se realiza una división por el componente w de los componentes del vector. Para evitar dividir por 0 si w es igual a 0, se establece en 1.

Nota: Las coordenadasy en viewport deben utilizar la orientación de OpenGL. OpenGL espera que la parte inferior sea 0, mientras que en Qt la parte superior es 0.

Véase también project().

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

Devuelve la coordenada x de este punto.

Véase también setX(), y() y z().

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

Devuelve la coordenada y de este punto.

Véase también setY(), x() y z().

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

Devuelve la coordenada z de este punto.

Véase también setZ(), x() y y().

QVector3D::operator QVariant() const

Devuelve el vector 3D como un objeto de tipo « QVariant ».

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

Multiplica las coordenadas de este vector por el factor finito dado y devuelve una referencia a este vector.

Véanse también operator/=() y operator*().

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

Multiplica cada componente de este vector por el componente correspondiente de vector y devuelve una referencia a este vector.

Nota: esto no es lo mismo que la función ` crossProduct()` de este vector ni que ` vector`. (La suma de sus componentes equivale al producto escalar de este vector y ` vector`.)

Esta es una función sobrecargada.

Véase también crossProduct(), operator/=() y operator*().

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

Añade el vector indicado a este vector y devuelve una referencia a dicho vector.

Véase también operator-=().

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

Resta el vector dado vector de este vector y devuelve una referencia a este vector.

Véase también ` operator+=()`.

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

Divide cada componente de este vector por el componente correspondiente de vector y devuelve una referencia a este vector.

El vector ` vector ` no debe contener ningún componente que sea cero o NaN.

Véase también ` operator*=()` y ` operator/()`.

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

Divide las coordenadas de este vector por el valor dado divisor y devuelve una referencia a este vector. El valor divisor no debe ser ni cero ni NaN.

Véase también operator*=() y operator/().

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

Devuelve el componente del vector situado en la posición de índice i como una referencia modificable.

i Debe ser una posición de índice válida en el vector (es decir, 0 <= i < 3).

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

Devuelve el componente del vector en la posición de índice i.

i Debe ser una posición de índice válida en el vector (es decir, 0 <= i < 3).

Elementos no miembros relacionados

[noexcept] bool qFuzzyCompare(QVector3D v1, QVector3D v2)

Devuelve « true » si « v1 » y « v2 » son iguales, teniendo en cuenta un pequeño margen de imprecisión para las comparaciones con números de coma flotante; en caso contrario, devuelve «false».

[constexpr noexcept, since 6.12] size_t qHash(QVector3D key, size_t seed = 0)

Devuelve el valor hash de ` key`, utilizando ` seed ` como semilla para el cálculo.

Esta función se introdujo en Qt 6.12.

[constexpr noexcept] bool operator!=(QVector3D v1, QVector3D v2)

Devuelve « true » si « v1 » no es igual a « v2 »; en caso contrario, devuelve « false ». Este operador utiliza una comparación exacta en coma flotante.

[constexpr noexcept] QVector3D operator*(QVector3D v1, QVector3D v2)

Devuelve el objeto ` QVector3D ` formado al multiplicar cada componente de ` v1 ` por el componente correspondiente de ` v2`.

Nota: Esto no es lo mismo que la función ` crossProduct()` de ` v1 ` y ` v2`. (La suma de sus componentes es igual al producto escalar de ` v1 ` y ` v2`.)

Véase también QVector3D::crossProduct().

[constexpr noexcept] QVector3D operator*(QVector3D vector, float factor)

Devuelve una copia del vector dado, multiplicado por el factor finito dado.

Véase también QVector3D::operator*=().

[constexpr noexcept] QVector3D operator*(float factor, QVector3D vector)

Devuelve una copia del vector dado, multiplicado por el factor finito dado.

Véase también QVector3D::operator*=().

[constexpr noexcept] QVector3D operator+(QVector3D v1, QVector3D v2)

Devuelve un objeto ` QVector3D ` que es la suma de los vectores indicados, ` v1 ` y ` v2`; cada componente se suma por separado.

Véase también QVector3D::operator+=().

[constexpr noexcept] QVector3D operator-(QVector3D v1, QVector3D v2)

Devuelve un objeto ` QVector3D ` que se obtiene restando ` v2 ` de ` v1`; cada componente se resta por separado.

Véase también QVector3D::operator-=().

[constexpr noexcept] QVector3D operator-(QVector3D vector)

Devuelve un objeto ` QVector3D ` que se forma cambiando el signo de cada componente del objeto ` vector` dado.

Equivalente a ` QVector3D(0,0,0) - vector`.

Esta es una función sobrecargada.

[constexpr] QVector3D operator/(QVector3D vector, QVector3D divisor)

Devuelve el objeto ` QVector3D ` formado al dividir cada componente del objeto ` vector ` dado por el componente correspondiente del objeto ` divisor` dado.

El objeto ` divisor ` no debe contener ningún componente que sea cero o `NaN`.

Véase también QVector3D::operator/=().

[constexpr] QVector3D operator/(QVector3D vector, float divisor)

Devuelve el objeto ` QVector3D ` obtenido al dividir cada componente de la matriz ` vector ` dada por la matriz ` divisor` dada.

El objeto ` divisor ` no debe ser ni cero ni NaN.

Véase también QVector3D::operator/=().

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

Escribe el objeto ` vector ` indicado en el objeto ` stream ` indicado y devuelve una referencia al flujo.

Véase también «Serialización detipos de datos de Qt».

[constexpr noexcept] bool operator==(QVector3D v1, QVector3D v2)

Devuelve « true » si « v1 » es igual a « v2 »; en caso contrario, devuelve « false ». Este operador utiliza una comparación exacta de punto flotante.

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

Lee un vector 3D desde el archivo « stream » especificado en el archivo « vector » especificado y devuelve una referencia al flujo.

Véase también Serialización detipos de datos de Qt.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.