QTransform Class

멤버 함수 문서

QTransform::QTransform()

아이덴티티 행렬을 구축합니다.

m11 및 m22 (스케일 지정)과 m33 을 제외한 모든 요소는 0으로 설정되며, 은 1로 설정됩니다.

reset()도 참조하세요 .

QTransform::QTransform(qreal m11, qreal m12, qreal m21, qreal m22, qreal dx, qreal dy)

m11, m12, m21, m22, dx 및 dy 요소로 행렬을 구성합니다.

setMatrix()도 참조하세요 .

QTransform::QTransform(qreal m11, qreal m12, qreal m13, qreal m21, qreal m22, qreal m23, qreal m31, qreal m32, qreal m33)

m11, m12, m13, m21, m22, m23, m31, m32, m33 요소로 행렬을 구성합니다.

setMatrix()도 참조하세요 .

qreal QTransform::m11() const

수평 스케일링 계수를 반환합니다.

scale() 및 Basic Matrix Operations도 참조하세요 .

qreal QTransform::m12() const

수직 전단 계수를 반환합니다.

shear() 및 Basic Matrix Operations도 참조하세요 .

qreal QTransform::m13() const

수평 투영 계수를 반환합니다.

translate() 및 Basic Matrix Operations 을참조하십시오 .

qreal QTransform::m21() const

수평 전단 계수를 반환합니다.

shear() 및 Basic Matrix Operations도 참조하십시오 .

qreal QTransform::m22() const

수직 스케일링 계수를 반환합니다.

scale() 및 Basic Matrix Operations도 참조하세요 .

qreal QTransform::m23() const

수직 투영 계수를 반환합니다.

translate() 및 Basic Matrix Operations도 참조하세요 .

qreal QTransform::m31() const

수평 이동 계수를 반환합니다.

dx(), translate() 및 Basic Matrix Operations도 참조하세요 .

qreal QTransform::m32() const

수직 변환 계수를 반환합니다.

dy(), translate() 및 Basic Matrix Operations도 참조하세요 .

qreal QTransform::m33() const

나눗셈 계수를 반환합니다.

translate() 및 Basic Matrix Operations도 참조하세요 .

QTransform QTransform::adjoint() const

이 행렬의 부속 행렬을 반환합니다.

qreal QTransform::determinant() const

행렬의 행렬식을 반환합니다.

qreal QTransform::dx() const

수평 이동 계수를 반환합니다.

m31(), translate() 및 Basic Matrix Operations도 참조하세요 .

qreal QTransform::dy() const

수직 변환 계수를 반환합니다.

translate() 및 Basic Matrix Operations도 참조하세요 .

[static] QTransform QTransform::fromScale(qreal sx, qreal sy)

가로로 sx, 세로로 sy 배율에 해당하는 행렬을 만듭니다. 이는 QTransform().scale(sx, sy)와 동일하지만 약간 더 빠릅니다.

[static] QTransform QTransform::fromTranslate(qreal dx, qreal dy)

x축을 따라 dx, y축을 따라 dy 번역에 해당하는 행렬을 만듭니다. QTransform ().translate(dx, dy)와 동일하지만 약간 더 빠릅니다.

QTransform QTransform::inverted(bool *invertible = nullptr) const

이 행렬의 반전된 복사본을 반환합니다.

행렬이 단수(반전 가능하지 않음)인 경우 반환되는 행렬은 동일 행렬입니다. invertible 가 유효하면(즉, 0이 아닌 경우) 행렬이 반전 가능하면 그 값은 참으로 설정되고, 그렇지 않으면 거짓으로 설정됩니다.

isInvertible()도 참조하세요 .

bool QTransform::isAffine() const

행렬이 아핀 변환을 나타내는 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QTransform::isIdentity() const

행렬이 아이덴티티 행렬이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

reset()도 참조하세요 .

bool QTransform::isInvertible() const

행렬이 반전 가능하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

inverted()도 참조하세요 .

bool QTransform::isRotating() const

행렬이 일종의 회전 변환을 나타내는 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

reset()도 참조하세요 .

bool QTransform::isScaling() const

행렬이 스케일링 변환을 나타내는 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

reset()도 참조하세요 .

bool QTransform::isTranslating() const

행렬이 번역 변환을 나타내는 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

reset()도 참조하세요 .

void QTransform::map(qreal x, qreal y, qreal *tx, qreal *ty) const

주어진 좌표 x 및 y 을 이 행렬로 정의된 좌표계에 매핑합니다. 결과 값은 각각 *tx 및 *ty 에 입력됩니다.

좌표는 다음 공식을 사용하여 변환됩니다:

x' = m11*x + m21*y + dx
y' = m22*y + m12*x + dy
if (!isAffine()) {
    w' = m13*x + m23*y + m33
    x' /= w'
    y' /= w'
}

점 (x, y)는 원래 점이고 (x', y')는 변환된 점입니다.

Basic Matrix Operations도 참조하세요 .

QLine QTransform::map(const QLine &l) const

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

이 행렬에 정의된 좌표계에 매핑된 주어진 선( l)의 복사본인 QLineF 객체를 생성하고 반환합니다.

QLineF QTransform::map(const QLineF &line) const

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

이 행렬에 정의된 좌표계에 매핑된 주어진 line 의 복사본인 QLine 객체를 생성하고 반환합니다. 변환된 좌표는 가장 가까운 정수로 반올림됩니다.

QPainterPath QTransform::map(const QPainterPath &path) const

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

주어진 path 의 복사본인 QPainterPath 객체를 생성하고 이 행렬에 정의된 좌표계에 매핑된 객체를 반환합니다.

QPoint QTransform::map(const QPoint &point) const

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

이 행렬에 정의된 좌표계에 매핑된 주어진 point 의 복사본인 QPoint 객체를 생성하고 반환합니다. 변환된 좌표는 가장 가까운 정수로 반올림됩니다.

QPointF QTransform::map(const QPointF &p) const

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

이 행렬에 정의된 좌표계에 매핑된 주어진 점( p)의 복사본인 QPointF 객체를 생성하고 반환합니다.

QPolygon QTransform::map(const QPolygon &polygon) const

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

이 행렬에 정의된 좌표계에 매핑된 주어진 polygon 의 복사본인 QPolygon 객체를 생성하고 반환합니다. 변환된 좌표는 가장 가까운 정수로 반올림됩니다.

QPolygonF QTransform::map(const QPolygonF &polygon) const

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

주어진 polygon 의 복사본인 QPolygonF 객체를 생성하고 이 행렬에 정의된 좌표계에 매핑된 객체를 반환합니다.

QRegion QTransform::map(const QRegion &region) const

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

주어진 region 의 복사본인 QRegion 객체를 생성하고 이 행렬에 정의된 좌표계에 매핑된 객체를 반환합니다.

회전이나 전단을 사용하는 경우 이 메서드를 호출하는 데 다소 많은 비용이 발생할 수 있습니다.

void QTransform::map(int x, int y, int *tx, int *ty) const

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

주어진 좌표 x 및 y 을 이 행렬로 정의된 좌표계에 매핑합니다. 결과 값은 각각 *tx 및 *ty 에 입력됩니다. 변환된 좌표는 가장 가까운 정수로 반올림된다는 점에 유의하세요.

QRectF QTransform::mapRect(const QRectF &rectangle) const

주어진 rectangle 의 복사본인 QRectF 객체를 생성하고 이 행렬에 정의된 좌표계에 매핑된 객체를 반환합니다.

직사각형의 좌표는 다음 공식을 사용하여 변환됩니다:

x' = m11*x + m21*y + dx
y' = m22*y + m12*x + dy
if (!isAffine()) {
    w' = m13*x + m23*y + m33
    x' /= w'
    y' /= w'
}

회전 또는 전단이 지정된 경우 이 함수는 경계 직사각형을 반환합니다. 주어진 rectangle 이 매핑되는 정확한 영역을 검색하려면 mapToPolygon() 함수를 대신 사용합니다.

mapToPolygon() 및 Basic Matrix Operations 을참조하세요 .

QRect QTransform::mapRect(const QRect &rectangle) const

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

이 행렬에 정의된 좌표계에 매핑된 주어진 rectangle 의 복사본인 QRect 객체를 생성하고 반환합니다. 변환된 좌표는 가장 가까운 정수로 반올림됩니다.

QPolygon QTransform::mapToPolygon(const QRect &rectangle) const

주어진 rectangle 을 이 행렬로 정의된 좌표계에 매핑한 QPolygon 표현을 생성하고 반환합니다.

직사각형의 좌표는 다음 공식을 사용하여 변환됩니다:

x' = m11*x + m21*y + dx
y' = m22*y + m12*x + dy
if (!isAffine()) {
    w' = m13*x + m23*y + m33
    x' /= w'
    y' /= w'
}

다각형과 직사각형은 변환 시 (정수 반올림으로 인해) 약간 다르게 동작하므로 matrix.map(QPolygon(rectangle)) 이 항상 matrix.mapToPolygon(rectangle) 과 같지는 않습니다.

mapRect() 및 Basic Matrix Operations 을참조하세요 .

[static] bool QTransform::quadToQuad(const QPolygonF &one, const QPolygonF &two, QTransform &trans)

4면 다각형 one 을 다른 4면 다각형 two 으로 매핑하는 변환 행렬 trans 을 생성합니다. 변환이 가능하면 true 를 반환하고, 그렇지 않으면 false를 반환합니다.

quadToSquare() 메서드와 squareToQuad() 메서드를 결합한 편리한 메서드입니다. 이 함수를 사용하면 입력된 쿼드를 다른 쿼드로 변환할 수 있습니다.

squareToQuad() 및 quadToSquare()도 참조하세요 .

[static] bool QTransform::quadToSquare(const QPolygonF &quad, QTransform &trans)

4면 다각형( quad)을 단위 정사각형에 매핑하는 변환 행렬( trans)을 생성합니다. 변환이 생성된 경우 true, 변환이 존재하지 않는 경우 false를 반환합니다.

squareToQuad() 및 quadToQuad()도 참조하세요 .

void QTransform::reset()

행렬을 동일성 행렬로 재설정합니다. 즉, m11 및 m22 (스케일 지정), m33 을 제외한 모든 요소가 0으로 설정됩니다.

QTransform(), isIdentity() 및 Basic Matrix Operations도 참조하세요 .

[since 6.5] QTransform &QTransform::rotate(qreal a, Qt::Axis axis, qreal distanceToPlane)

좌표계를 화면에서 distanceToPlane 거리의 지정된 axis 에 대해 주어진 각도 a 만큼 시계 반대 방향으로 회전하고 행렬에 대한 참조를 반환합니다.

위젯 좌표로 정의된 지점에 QTransform 을 적용하면 Y 축이 아래쪽을 가리키므로 회전 방향이 시계 방향이 됩니다.

각도는 도 단위로 지정됩니다.

distanceToPlane 이 0이면 무시됩니다. 이 함수는 z 좌표를 투영하지 않고 삭제해야 하는 직교 투영을 구현하는 데 적합합니다.

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

setMatrix()도 참조하세요 .

QTransform &QTransform::rotate(qreal a, Qt::Axis axis = Qt::ZAxis)

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

화면에서 1024.0 거리의 지정된 axis 에 대해 좌표계를 주어진 각도 a 만큼 시계 반대 방향으로 회전하고 행렬에 대한 참조를 반환합니다.

위젯 좌표로 정의된 지점에 QTransform 을 적용하면 Y 축이 아래쪽을 가리키므로 회전 방향이 시계 방향이 됩니다.

각도는 도 단위로 지정됩니다.

setMatrix 를참조하세요 .

[since 6.5] QTransform &QTransform::rotateRadians(qreal a, Qt::Axis axis, qreal distanceToPlane)

좌표계를 화면에서 distanceToPlane 거리의 지정된 axis 에 대해 주어진 각도 a 만큼 시계 반대 방향으로 회전하고 행렬에 대한 참조를 반환합니다.

위젯 좌표로 정의된 지점에 QTransform 을 적용하면 Y 축이 아래쪽을 가리키므로 회전 방향이 시계 방향이 됩니다.

각도는 라디안 단위로 지정됩니다.

distanceToPlane 이 0이면 무시됩니다. 이 함수는 z 좌표를 투영하지 않고 삭제해야 하는 직교 투영을 구현하는 데 적합합니다.

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

setMatrix()도 참조하세요 .

QTransform &QTransform::rotateRadians(qreal a, Qt::Axis axis = Qt::ZAxis)

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

화면에서 1024.0 거리의 지정된 axis 에 대해 좌표계를 주어진 각도 a 만큼 시계 반대 방향으로 회전하고 행렬에 대한 참조를 반환합니다.

위젯 좌표로 정의된 지점에 QTransform 을 적용하면 Y 축이 아래쪽을 가리키므로 회전 방향이 시계 방향이 됩니다.

각도는 라디안 단위로 지정됩니다.

setMatrix()도 참조하세요 .

QTransform &QTransform::scale(qreal sx, qreal sy)

좌표계를 가로로 sx, 세로로 sy 스케일링하고 행렬에 대한 참조를 반환합니다.

setMatrix()도 참조하세요 .

void QTransform::setMatrix(qreal m11, qreal m12, qreal m13, qreal m21, qreal m22, qreal m23, qreal m31, qreal m32, qreal m33)

행렬 요소를 지정된 값 m11, m12, m13 m21 , m22, m23 m31 , m32 및 m33 로 설정합니다. QTransform 은 현재 정의된 좌표계를 기반으로 다양한 행렬 요소를 조작할 수 있는 translate(), rotate(), scale() 및 shear() 편의 함수를 제공합니다.

QTransform()도 참조하세요 .

QTransform &QTransform::shear(qreal sh, qreal sv)

좌표계를 수평으로 sh, 수직으로 sv 으로 절단하고 행렬에 대한 참조를 반환합니다.

setMatrix()도 참조하세요 .

[static] bool QTransform::squareToQuad(const QPolygonF &quad, QTransform &trans)

단위 정사각형을 4면 다각형( quad)에 매핑하는 변환 행렬( trans)을 생성합니다. 변환이 구성되면 true 를 반환하고, 변환이 존재하지 않으면 false를 반환합니다.

quadToSquare() 및 quadToQuad()도 참조하세요 .

QTransform &QTransform::translate(qreal dx, qreal dy)

좌표계 dx 를 x축을 따라, dy 를 y축을 따라 이동하고 행렬에 대한 참조를 반환합니다.

setMatrix()도 참조하세요 .

QTransform QTransform::transposed() const

이 행렬의 전치를 반환합니다.

QTransform::TransformationType QTransform::type() const

이 행렬의 변환 유형을 반환합니다.

변환 유형은 행렬의 모든 변환을 캡처하는 가장 높은 열거 값입니다. 예를 들어 행렬이 스케일링과 시어링을 모두 수행하는 경우 TxShear 이 TxScale 보다 열거 값이 더 높으므로 유형은 TxShear 이 됩니다.

행렬의 변환 유형을 아는 것은 최적화에 유용합니다. 일반적인 경우를 처리하는 것보다 특정 유형을 더 최적으로 처리할 수 있는 경우가 많기 때문입니다.

QVariant QTransform::operator QVariant() const

변환을 QVariant 로 반환합니다.

bool QTransform::operator!=(const QTransform &matrix) const

이 행렬이 주어진 matrix 과 같지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

QTransform QTransform::operator*(const QTransform &matrix) const

이 행렬에 주어진 matrix 을 곱한 결과를 반환합니다.

행렬 곱셈은 정류가 아닙니다. 즉, a*b != b*a입니다.

QTransform &QTransform::operator*=(const QTransform &matrix)

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

이 행렬에 주어진 matrix 을 곱한 결과를 반환합니다.

QTransform &QTransform::operator*=(qreal scalar)

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

이 행렬에 주어진 scalar 을 요소 단위로 곱한 결과를 반환합니다.

QTransform &QTransform::operator+=(qreal scalar)

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

이 행렬의 각 요소에 주어진 scalar 을 더하여 얻은 행렬을 반환합니다.

QTransform &QTransform::operator-=(qreal scalar)

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

이 행렬의 각 요소에서 주어진 scalar 을 빼서 얻은 행렬을 반환합니다.

QTransform &QTransform::operator/=(qreal scalar)

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

이 행렬을 주어진 scalar 으로 요소 단위로 나눈 결과를 반환합니다.

[noexcept] QTransform &QTransform::operator=(const QTransform &matrix)

주어진 matrix 의 값을 이 행렬에 할당합니다.

bool QTransform::operator==(const QTransform &matrix) const

이 행렬이 주어진 matrix 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.