En esta página

QVector4D Class

La clase QVector4D representa un vector o un vértice en el espacio 4D. Más información...

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

Funciones públicas

QVector4D()
QVector4D(QPoint point)
QVector4D(QPointF point)
QVector4D(QVector2D vector)
QVector4D(QVector3D vector)
QVector4D(QVector3D vector, float wpos)
QVector4D(QVector2D vector, float zpos, float wpos)
QVector4D(float xpos, float ypos, float zpos, float wpos)
bool isNull() const
float length() const
float lengthSquared() const
void normalize()
QVector4D normalized() const
void setW(float w)
void setX(float x)
void setY(float y)
void setZ(float z)
QPoint toPoint() const
QPointF toPointF() const
QVector2D toVector2D() const
QVector2D toVector2DAffine() const
QVector3D toVector3D() const
QVector3D toVector3DAffine() const
float w() const
float x() const
float y() const
float z() const
operator QVariant() const
QVector4D &operator*=(QVector4D vector)
QVector4D &operator*=(float factor)
QVector4D &operator+=(QVector4D vector)
QVector4D &operator-=(QVector4D vector)
QVector4D &operator/=(QVector4D vector)
QVector4D &operator/=(float divisor)
float &operator[](int i)
float operator[](int i) const

Miembros públicos estáticos

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

Descripción detallada

Los vectores son uno de los principales componentes básicos de las representaciones afines en 4D del espacio 3D. Constan de cuatro coordenadas finitas en coma flotante, denominadas tradicionalmente x, y, z y w.

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

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

Documentación de las funciones miembro

[constexpr noexcept] QVector4D::QVector4D()

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

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

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

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

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

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

Crea un vector de 4 dimensiones a partir del vector de 2 dimensiones especificado vector. Las coordenadas z y w se establecen en cero.

Véase también toVector2D().

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

Crea un vector de 4 dimensiones a partir del vector de 3 dimensiones especificado vector. La coordenada w se establece en cero.

Véase también toVector3D().

[constexpr noexcept] QVector4D::QVector4D(QVector3D vector, float wpos)

Crea un vector 4D a partir del vector 3D especificado vector. La coordenada w se establece en wpos, que debe ser un valor finito.

Véase también toVector3D().

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

Crea un vector de 4 dimensiones a partir del vector de 2 dimensiones especificado vector. Las coordenadas z y w se establecen en zpos y wpos, respectivamente, y ambas deben ser valores finitos.

Véase también toVector2D().

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

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

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

Devuelve el producto escalar de v1 y v2.

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

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

[noexcept] float QVector4D::length() const

Devuelve la distancia del vector respecto al origen.

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

[constexpr noexcept] float QVector4D::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().

[noexcept] void QVector4D::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] QVector4D QVector4D::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().

[constexpr noexcept] void QVector4D::setW(float w)

Establece la coordenada «w» de este punto en la coordenada finita dada w.

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

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

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

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

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

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

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

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

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

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

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

Devuelve la forma « QPoint » de este vector 4D. Se omiten las coordenadas z y w. Las coordenadas x e y se redondean al entero más cercano.

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

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

Devuelve la forma « QPointF » de este vector 4D. Se omiten las coordenadas z y w.

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

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

Devuelve la forma de vector 2D de este vector 4D, omitiendo las coordenadas z y w.

Véase también toVector2DAffine(), toVector3D() y toPoint().

[constexpr noexcept] QVector2D QVector4D::toVector2DAffine() const

Devuelve la forma vectorial bidimensional de este vector de cuatro dimensiones, dividiendo las coordenadas x e y por la coordenada w y omitiendo la coordenada z. Devuelve un vector nulo si w es cero.

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

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

Devuelve la forma vectorial 3D de este vector 4D, omitiendo la coordenada w.

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

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

Devuelve la forma de vector 3D de este vector 4D, dividiendo las coordenadas x, y y z entre la coordenada w. Devuelve un vector nulo si w es cero.

Véase también toVector3D(), toVector2DAffine() y toPoint().

[constexpr noexcept] float QVector4D::w() const

Devuelve la coordenada «w» de este punto.

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

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

Devuelve la coordenada x de este punto.

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

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

Devuelve la coordenada y de este punto.

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

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

Devuelve la coordenada z de este punto.

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

QVector4D::operator QVariant() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[constexpr] QVector4D &QVector4D::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*=().

[constexpr] float &QVector4D::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 < 4).

[constexpr] float QVector4D::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 < 4).

Elementos no miembros relacionados

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

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

[constexpr noexcept, since 6.12] size_t qHash(QVector4D 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!=(QVector4D v1, QVector4D v2)

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

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

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

Nota: Esto no es un producto vectorial de v1 y v2 en ningún sentido. (La suma de sus componentes equivale al producto escalar de v1 y v2.)

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

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

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

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

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

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

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

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

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

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

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

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

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

[constexpr noexcept] QVector4D operator-(QVector4D vector)

Devuelve un objeto ` QVector4D ` que se forma cambiando el signo de los tres componentes de la ` vector` dada.

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

Esta es una función sobrecargada.

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

Devuelve el objeto ` QVector4D ` 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 QVector4D::operator/=().

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

Devuelve el objeto ` QVector4D ` obtenido al dividir cada componente del ` vector ` dado por el ` divisor` dado.

El objeto divisor no debe ser ni cero ni NaN.

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

QDataStream &operator<<(QDataStream &stream, QVector4D 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==(QVector4D v1, QVector4D 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, QVector4D &vector)

Lee un vector 4D desde el archivo « stream » en el archivo « vector » 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.