QVector2D Class
La clase QVector2D representa un vector o un vértice en el espacio bidimensional. Más información...
| Encabezado: | #include <QVector2D> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Lista de todos los miembros, incluidos los heredados
- QVector2D forma parte de las clases de pintura y renderizado en 3D.
Funciones públicas
| QVector2D() | |
| QVector2D(QPoint point) | |
| QVector2D(QPointF point) | |
| QVector2D(QVector3D vector) | |
| QVector2D(QVector4D vector) | |
| QVector2D(float xpos, float ypos) | |
| float | distanceToLine(QVector2D point, QVector2D direction) const |
| float | distanceToPoint(QVector2D point) const |
| bool | isNull() const |
| float | length() const |
| float | lengthSquared() const |
| void | normalize() |
| QVector2D | normalized() const |
| void | setX(float x) |
| void | setY(float y) |
| QPoint | toPoint() const |
| QPointF | toPointF() const |
| QVector3D | toVector3D() const |
| QVector4D | toVector4D() const |
| float | x() const |
| float | y() const |
| operator QVariant() const | |
| QVector2D & | operator*=(QVector2D vector) |
| QVector2D & | operator*=(float factor) |
| QVector2D & | operator+=(QVector2D vector) |
| QVector2D & | operator-=(QVector2D vector) |
| QVector2D & | operator/=(QVector2D vector) |
| QVector2D & | operator/=(float divisor) |
| float & | operator[](int i) |
| float | operator[](int i) const |
Miembros públicos estáticos
| float | dotProduct(QVector2D v1, QVector2D v2) |
Elementos no miembros relacionados
| bool | qFuzzyCompare(QVector2D v1, QVector2D v2) |
(since 6.12) size_t | qHash(QVector2D key, size_t seed = 0) |
| bool | operator!=(QVector2D v1, QVector2D v2) |
| QVector2D | operator*(QVector2D v1, QVector2D v2) |
| QVector2D | operator*(QVector2D vector, float factor) |
| QVector2D | operator*(float factor, QVector2D vector) |
| QVector2D | operator+(QVector2D v1, QVector2D v2) |
| QVector2D | operator-(QVector2D v1, QVector2D v2) |
| QVector2D | operator-(QVector2D vector) |
| QVector2D | operator/(QVector2D vector, QVector2D divisor) |
| QVector2D | operator/(QVector2D vector, float divisor) |
| QDataStream & | operator<<(QDataStream &stream, QVector2D vector) |
| bool | operator==(QVector2D v1, QVector2D v2) |
| QDataStream & | operator>>(QDataStream &stream, QVector2D &vector) |
Descripción detallada
Los vectores son uno de los componentes fundamentales de la representación y el dibujo en 2D. Consisten en dos coordenadas finitas de punto flotante, denominadas tradicionalmente x e y.
La clase QVector2D también se puede utilizar para representar vértices en el espacio 2D. Por lo tanto, no es necesario proporcionar una clase de vértices independiente.
Véase también QVector3D, QVector4D y QQuaternion.
Documentación de las funciones miembro
[constexpr noexcept] QVector2D::QVector2D()
Crea un vector nulo, es decir, con coordenadas (0, 0).
[explicit constexpr noexcept] QVector2D::QVector2D(QPoint point)
Crea un vector con coordenadas x e y a partir de un objeto 2D de tipo « point ».
[explicit constexpr noexcept] QVector2D::QVector2D(QPointF point)
Crea un vector con coordenadas x e y a partir de un objeto 2D de tipo « point ».
[explicit constexpr noexcept] QVector2D::QVector2D(QVector3D vector)
Crea un vector con las coordenadas x e y a partir de un objeto 3D de tipo « vector ». Se omite la coordenada z de « vector ».
Véase también toVector3D().
[explicit constexpr noexcept] QVector2D::QVector2D(QVector4D vector)
Crea un vector con las coordenadas x e y a partir de un objeto 3D de tipo « vector ». Las coordenadas z y w de « vector » se omiten.
Véase también toVector4D().
[constexpr noexcept] QVector2D::QVector2D(float xpos, float ypos)
Crea un vector con las coordenadas (xpos, ypos). Ambas coordenadas deben ser finitas.
[noexcept] float QVector2D::distanceToLine(QVector2D point, QVector2D 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 distanceToPoint().
[noexcept] float QVector2D::distanceToPoint(QVector2D point) const
Devuelve la distancia desde este vértice hasta un punto definido por el vértice point.
Véase también distanceToLine().
[static constexpr noexcept] float QVector2D::dotProduct(QVector2D v1, QVector2D v2)
Devuelve el producto escalar de v1 y v2.
[constexpr noexcept] bool QVector2D::isNull() const
Devuelve « true » si las coordenadas x e y están establecidas en 0,0; en caso contrario, devuelve « false ».
[noexcept] float QVector2D::length() const
Devuelve la distancia del vector respecto al origen.
Véase también lengthSquared() y normalized().
[constexpr noexcept] float QVector2D::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 QVector2D::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] QVector2D QVector2D::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, se devuelve el vector 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 QVector2D::setX(float x)
Establece la coordenada x de este punto en la coordenada finita x indicada.
[constexpr noexcept] void QVector2D::setY(float y)
Establece la coordenada y de este punto en la coordenada finita y indicada.
[constexpr noexcept] QPoint QVector2D::toPoint() const
Devuelve la forma « QPoint » de este vector 2D. Cada coordenada se redondea al entero más cercano.
Véase también toPointF() y toVector3D().
[constexpr noexcept] QPointF QVector2D::toPointF() const
Devuelve este vector 2D en formato « QPointF ».
Véase también ` toPoint()` y ` toVector3D()`.
[constexpr noexcept] QVector3D QVector2D::toVector3D() const
Devuelve la forma 3D de este vector 2D, con la coordenada z establecida en cero.
Véase también toVector4D() y toPoint().
[constexpr noexcept] QVector4D QVector2D::toVector4D() const
Devuelve la forma 4D de este vector 2D, con las coordenadas z y w establecidas en cero.
Véase también toVector3D() y toPoint().
[constexpr noexcept] float QVector2D::x() const
Devuelve la coordenada x de este punto.
[constexpr noexcept] float QVector2D::y() const
Devuelve la coordenada y de este punto.
QVector2D::operator QVariant() const
Devuelve el vector 2D como un objeto ` QVariant`.
[constexpr noexcept] QVector2D &QVector2D::operator*=(QVector2D vector)
Multiplica cada componente de este vector por el componente correspondiente de vector y devuelve una referencia a este vector.
Nota: Nose trata del producto vectorial de este vector con vector. (La suma de sus componentes equivale al producto escalar de este vector y vector.)
Véase también operator/=() y operator*().
[constexpr noexcept] QVector2D &QVector2D::operator*=(float factor)
Multiplica las coordenadas de este vector por el factor finito indicado y devuelve una referencia a este vector.
Véase también operator/=() y operator*().
[constexpr noexcept] QVector2D &QVector2D::operator+=(QVector2D vector)
Añade el vector indicado a este vector y devuelve una referencia a este vector.
Véase también ` operator-=()`.
[constexpr noexcept] QVector2D &QVector2D::operator-=(QVector2D vector)
Resta el vector dado vector de este vector y devuelve una referencia a este vector.
Véase también operator+=().
[constexpr] QVector2D &QVector2D::operator/=(QVector2D vector)
Divide cada componente de este vector entre 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] QVector2D &QVector2D::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 &QVector2D::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 < 2).
[constexpr] float QVector2D::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 < 2).
Elementos no miembros relacionados
[noexcept] bool qFuzzyCompare(QVector2D v1, QVector2D 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(QVector2D 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!=(QVector2D v1, QVector2D 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] QVector2D operator*(QVector2D v1, QVector2D v2)
Devuelve el objeto ` QVector2D ` 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 QVector2D::operator*=().
[constexpr noexcept] QVector2D operator*(QVector2D vector, float factor)
Devuelve una copia del « vector » dado, multiplicado por el « factor » finito dado.
Véase también QVector2D::operator*=().
[constexpr noexcept] QVector2D operator*(float factor, QVector2D vector)
Devuelve una copia del « vector » dado, multiplicado por el « factor » finito dado.
Véase también QVector2D::operator*=().
[constexpr noexcept] QVector2D operator+(QVector2D v1, QVector2D v2)
Devuelve un objeto ` QVector2D ` que es la suma de los vectores indicados, ` v1 ` y ` v2`; cada componente se suma por separado.
Véase también QVector2D::operator+=().
[constexpr noexcept] QVector2D operator-(QVector2D v1, QVector2D v2)
Devuelve un objeto ` QVector2D ` que se obtiene restando ` v2 ` de ` v1`; cada componente se resta por separado.
Véase también QVector2D::operator-=().
[constexpr noexcept] QVector2D operator-(QVector2D vector)
Devuelve un objeto ` QVector2D ` que se obtiene cambiando el signo de cada componente del objeto ` vector` dado.
Equivalente a ` QVector2D(0,0) - vector`.
Esta es una función sobrecargada.
[constexpr] QVector2D operator/(QVector2D vector, QVector2D divisor)
Devuelve el objeto ` QVector2D ` 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 QVector2D::operator/=().
[constexpr] QVector2D operator/(QVector2D vector, float divisor)
Devuelve el objeto ` QVector2D ` 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 QVector2D::operator/=().
QDataStream &operator<<(QDataStream &stream, QVector2D vector)
Escribe el objeto ` vector ` especificado en el objeto ` stream ` especificado y devuelve una referencia al flujo.
Véase también «Serialización detipos de datos de Qt».
[constexpr noexcept] bool operator==(QVector2D v1, QVector2D 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, QVector2D &vector)
Lee un vector 2D desde el archivo « stream » especificado y lo carga 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.