Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QVector2D Class

QVector2D 클래스는 2차원 공간 내의 벡터 또는 정점을 나타냅니다. 더 보기...

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

공개 함수

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

정적 공용 멤버

float dotProduct(QVector2D v1, QVector2D v2)
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)

상세 설명

벡터는 2D 표현 및 그리기의 주요 구성 요소 중 하나입니다. 벡터는 전통적으로 x와 y라고 불리는 두 개의 유한한 부동 소수점 좌표로 구성됩니다.

QVector2D 클래스는 2D 공간의 정점을 표현하는 데에도 사용할 수 있습니다. 따라서 별도의 정점 클래스를 제공할 필요가 없습니다.

QVector3D, QVector4D, QQuaternion도 참조하십시오 .

멤버 함수 설명서

[constexpr noexcept] QVector2D::QVector2D()

좌표가 (0, 0)인, 즉 영 벡터를 생성합니다.

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

2차원 point 에서 x 및 y 좌표를 가진 벡터를 생성합니다.

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

2차원 point 에서 x 및 y 좌표를 가진 벡터를 생성합니다.

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

3차원 ` vector` 객체로부터 x 및 y 좌표를 가진 벡터를 생성합니다. ` vector `의 z 좌표는 제외됩니다.

toVector3D()도 참조하십시오 .

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

3차원 vector 에서 x 및 y 좌표를 가진 벡터를 생성합니다. vector 의 z 및 w 좌표는 제외됩니다.

toVector4D()도 참조하십시오 .

[constexpr noexcept] QVector2D::QVector2D(float xpos, float ypos)

좌표 (xpos, ypos)를 갖는 벡터를 생성합니다. 두 좌표 모두 유한해야 합니다.

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

이 정점이 point 와 단위 벡터 direction 로 정의된 직선으로부터의 거리를 반환합니다.

direction 가 영 벡터인 경우, 이는 직선을 정의하지 않습니다. 이 경우, point 에서 이 정점까지의 거리가 반환됩니다.

distanceToPoint()도 참조하십시오 .

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

이 정점과 정점 point 로 정의된 점 사이의 거리를 반환합니다.

distanceToLine()도 참조하십시오 .

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

v1 와 v2 의 내적을 반환합니다.

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

x 및 y 좌표가 0.0으로 설정된 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

[noexcept] float QVector2D::length() const

원점으로부터의 벡터 길이를 반환합니다.

lengthSquared() 및 normalized()도 참조하십시오 .

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

원점으로부터의 벡터 길이의 제곱을 반환합니다. 이는 해당 벡터와 그 자체의 내적과 동일합니다.

length() 및 dotProduct()도 참조하십시오 .

[noexcept] void QVector2D::normalize()

현재 벡터를 제자리에서 정규화합니다. 이 벡터가 0벡터이거나 벡터의 길이가 1에 매우 가까운 경우에는 아무런 작업도 수행되지 않습니다.

length() 및 normalized()도 참조하십시오 .

[noexcept] QVector2D QVector2D::normalized() const

이 벡터의 정규화된 단위 벡터 형태를 반환합니다.

이 벡터가 null인 경우, null 벡터가 반환됩니다. 벡터의 길이가 1에 매우 가까운 경우, 벡터는 있는 그대로 반환됩니다. 그렇지 않은 경우, 길이가 1인 벡터의 정규화된 형태가 반환됩니다.

length() 및 normalize()도 참조하십시오 .

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

이 점의 x 좌표를 주어진 유한한 x 좌표로 설정합니다.

x() 및 setY()도 참조하십시오 .

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

이 점의 y 좌표를 주어진 유한한 y 좌표로 설정합니다.

y() 및 setX()도 참조하십시오 .

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

이 2차원 벡터를 ` QPoint ` 형식으로 반환합니다. 각 좌표는 가장 가까운 정수로 반올림됩니다.

toPointF() 및 toVector3D()도 참조하십시오 .

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

이 2차원 벡터를 QPointF 형식으로 반환합니다.

toPoint() 및 toVector3D()도 참조하십시오 .

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

이 2차원 벡터의 3차원 형태를 반환하며, z 좌표는 0으로 설정됩니다.

toVector4D() 및 toPoint()도 참조하십시오 .

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

이 2차원 벡터를 4차원 형태로 반환하며, z 및 w 좌표는 0으로 설정됩니다.

toVector3D() 및 toPoint()도 참조하십시오 .

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

이 점의 x 좌표를 반환합니다.

setX() 및 y()도 참조하십시오 .

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

이 점의 y 좌표를 반환합니다.

setY() 및 x()도 참조하십시오 .

QVector2D::operator QVariant() const

2차원 벡터를 ` QVariant` 형식으로 반환합니다.

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

이 벡터의 각 성분을 vector 의 해당 성분과 곱한 후, 이 벡터에 대한 참조를 반환합니다.

참고: 이는 이 벡터와 vector 의 외적이 아닙니다. (이 벡터와 vector 의 내적의 합과 같습니다.)

operator/=() 및 operator*()도 참조하십시오 .

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

이 벡터의 좌표를 주어진 유한 행렬 factor 로 곱한 후, 이 벡터에 대한 참조를 반환합니다.

operator/=() 및 operator*()도 참조하십시오 .

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

지정된 vector 를 이 벡터에 더하고, 이 벡터에 대한 참조를 반환합니다.

operator-=()도 참조하십시오 .

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

지정된 vector 를 이 벡터에서 빼고, 이 벡터에 대한 참조를 반환합니다.

operator+=()도 참조하십시오 .

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

이 벡터의 각 성분을 ` vector `의 해당 성분으로 나눈 후, 이 벡터에 대한 참조를 반환합니다.

vector 에는 0이거나 NaN인 성분이 없어야 합니다.

operator*=() 및 operator/()도 참조하십시오 .

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

이 벡터의 좌표를 지정된 divisor 로 나눈 뒤, 이 벡터에 대한 참조를 반환합니다. divisor 는 0이나 NaN이어서는 안 됩니다.

operator*=()도 참조하십시오 .

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

벡터의 인덱스 위치 i 에 있는 성분을 수정 가능한 참조로 반환합니다.

i i 는 벡터 내에서 유효한 인덱스 위치여야 합니다(즉, 0 <= < 2).

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

벡터의 인덱스 위치 i 에 있는 성분을 반환합니다.

i i 는 벡터 내에서 유효한 인덱스 위치여야 합니다(즉, 0 <= < 2).

관련 비멤버

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

v1 와 v2 가 같을 경우(부동소수점 비교 시 약간의 오차 범위를 허용함) true 를 반환하고, 그렇지 않은 경우 false를 반환합니다.

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

seed 를 계산의 시드로 사용하여 key 의 해시 값을 반환합니다.

이 함수는 Qt 6.12에서 도입되었습니다.

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

v1 가 v2 와 같지 않으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다. 이 연산자는 정확한 부동소수점 비교를 사용합니다.

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

v1 의 각 성분을 v2 의 해당 성분과 곱하여 형성된 QVector2D 객체를 반환합니다.

참고: 이는 어떤 의미에서도 v1 와 v2 의 외적(cross product)이 아닙니다. (이 객체의 성분들의 합은 v1 와 v2 의 내적(dot product)과 같습니다.)

QVector2D::operator*=()도 참조하십시오 .

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

주어진 vector 의 복사본에, 주어진 유한 factor 를 곱한 값을 반환합니다.

QVector2D::operator*=()도 참조하십시오 .

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

주어진 vector 의 복사본에, 주어진 유한 factor 를 곱한 값을 반환합니다.

QVector2D::operator*=()도 참조하십시오 .

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

주어진 벡터 ` v1 `와 ` v2`의 합을 나타내는 ` QVector2D ` 객체를 반환합니다. 각 성분은 별도로 더합니다.

QVector2D::operator+=()도 참조하십시오 .

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

v2 을 v1 에서 뺀 값으로 구성된 ` QVector2D ` 객체를 반환합니다. 각 성분은 별도로 뺍니다.

QVector2D::operator-=()도 참조하십시오 .

[constexpr noexcept] QVector2D operator-(QVector2D vector)

주어진 ` vector`의 각 성분의 부호를 반전시켜 생성된 ` QVector2D ` 객체를 반환합니다.

QVector2D(0,0) - vector 와 동일합니다.

이 함수는 오버로드된 함수입니다.

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

주어진 ` vector `의 각 성분을 주어진 ` divisor`의 해당 성분으로 나눈 값으로 구성된 ` QVector2D ` 객체를 반환합니다.

divisor 에는 0이거나 NaN인 성분이 포함되어서는 안 됩니다.

QVector2D::operator/=()도 참조하십시오 .

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

주어진 ` vector `의 각 성분을 주어진 ` divisor`로 나눈 값으로 구성된 ` QVector2D ` 객체를 반환합니다.

divisor 는 0이나 NaN이어서는 안 됩니다.

QVector2D::operator/=()도 참조하십시오 .

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

지정된 ` vector `을 지정된 ` stream `에 기록하고, 해당 스트림에 대한 참조를 반환합니다.

Qt 데이터 유형 직렬화항목도 참조하십시오 .

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

v1 가 v2 와 같으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다. 이 연산자는 정확한 부동소수점 비교를 사용합니다.

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

지정된 ` stream `에서 2차원 벡터를 지정된 ` vector `로 읽어들이고, 해당 스트림에 대한 참조를 반환합니다.

'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.