QMatrix4x4 Class

멤버 함수 문서

QMatrix4x4::QMatrix4x4()

아이덴티티 매트릭스를 구성합니다.

[explicit] template <int N, int M> QMatrix4x4::QMatrix4x4(const QGenericMatrix<N, M, float> &matrix)

matrix 의 가장 왼쪽 4개의 열과 가장 위쪽 4개의 행으로 4x4 행렬을 구성합니다. matrix 의 열 또는 행이 4개 미만인 경우 나머지 요소는 ID 행렬의 요소로 채워집니다.

toGenericMatrix()도 참조하세요 .

QMatrix4x4::QMatrix4x4(const QTransform &transform)

기존의 Qt 2D 변환 행렬 transform 로부터 4x4 행렬을 구축합니다.

transform 에 특수 유형(identity, translate, scale 등)이 있는 경우, 프로그래머는 이 생성자 뒤에 optimize() 호출을 추가하여 QMatrix4x4 가 translate(), scale() 등의 호출을 최적화할 수 있도록 해야 합니다.

toTransform() 및 optimize()도 참조하십시오 .

[explicit] QMatrix4x4::QMatrix4x4(const float *values)

주어진 16개의 부동소수점 values 으로부터 행렬을 구축합니다. values 배열의 내용은 행 대소문자 순이라고 가정합니다.

행렬에 특수한 유형(identity, translate, scale 등)이 있는 경우 프로그래머는 이 생성자 뒤에 optimize()를 호출하여 QMatrix4x4가 translate(), scale() 등에 대한 추가 호출을 최적화할 수 있도록 해야 합니다.

copyDataTo() 및 optimize()도 참조하십시오 .

QMatrix4x4::QMatrix4x4(float m11, float m12, float m13, float m14, float m21, float m22, float m23, float m24, float m31, float m32, float m33, float m34, float m41, float m42, float m43, float m44)

16개의 요소 m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44 로 행렬을 구성합니다. 요소는 행 대소문자 순서로 지정됩니다.

행렬에 특수한 유형(ID, 변환, 스케일 등)이 있는 경우 프로그래머는 이 생성자 뒤에 translate(), scale() 등에 대한 추가 호출을 최적화하기 위해 optimize() 호출을 수행해야 합니다.

optimize()도 참조하십시오 .

QVector4D QMatrix4x4::column(int index) const

index 열의 요소를 4D 벡터로 반환합니다.

setColumn() 및 row()도 참조하세요 .

const float *QMatrix4x4::constData() const

이 행렬의 원시 데이터에 대한 상수 포인터를 반환합니다. 이 원시 데이터는 열-주 형식으로 저장됩니다.

data()도 참조하세요 .

void QMatrix4x4::copyDataTo(float *values) const

이 행렬의 16개 항목을 검색하여 행 대소문자 순서대로 values 에 복사합니다.

float *QMatrix4x4::data()

이 행렬의 원시 데이터에 대한 포인터를 반환합니다.

constData() 및 optimize()도 참조하세요 .

const float *QMatrix4x4::data() const

이 행렬의 원시 데이터에 대한 상수 포인터를 반환합니다. 이 원시 데이터는 열-주 형식으로 저장됩니다.

constData()도 참조하세요 .

double QMatrix4x4::determinant() const

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

void QMatrix4x4::fill(float value)

이 매트릭스의 모든 요소를 value 로 채웁니다.

void QMatrix4x4::frustum(float left, float right, float bottom, float top, float nearPlane, float farPlane)

이 행렬에 왼쪽 아래 모서리(left, bottom), 오른쪽 위 모서리(right, top) 및 지정된 nearPlane 및 farPlane 클리핑 평면이 있는 창에 원근 절두체 투영을 적용하는 다른 행렬을 곱합니다.

ortho() 및 perspective()도 참조하십시오 .

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

이 행렬의 역을 반환합니다. 이 행렬을 반전할 수 없는 경우, 즉 determinant()가 0인 경우 행렬의 행렬식을 반환합니다. invertible 가 null이 아닌 경우 행렬을 반전시킬 수 있으면 해당 위치에 참을, 그렇지 않으면 거짓을 기록합니다.

행렬이 동일 행렬 또는 직교 행렬로 인식되는 경우 이 함수는 최적화된 루틴을 사용하여 행렬을 빠르게 반전시킵니다.

determinant() 및 normalMatrix()도 참조하세요 .

bool QMatrix4x4::isAffine() const

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

아핀 행렬은 3행이 (0, 0, 0, 1)인 4x4 행렬로, 투영 계수가 없는 행렬입니다.

isIdentity()도 참조하세요 .

bool QMatrix4x4::isIdentity() const

이 행렬이 ID이면 true, 그렇지 않으면 false를 반환합니다.

setToIdentity()도 참조하세요 .

void QMatrix4x4::lookAt(const QVector3D &eye, const QVector3D &center, const QVector3D &up)

이 행렬에 시점에서 파생된 보기 행렬을 곱합니다. center 값은 eye 이 보고 있는 뷰의 중심을 나타냅니다. up 값은 eye 을 기준으로 어느 방향을 고려해야 하는지를 나타냅니다.

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

이 행렬에 point 을 곱하여 point 을 매핑합니다. 행렬은 미리 적용됩니다.

mapRect()도 참조하세요 .

QPointF QMatrix4x4::map(const QPointF &point) const

이 행렬에 point 을 사후 곱하여 point 을 매핑합니다. 행렬은 미리 적용됩니다.

mapRect()도 참조하세요 .

QVector3D QMatrix4x4::map(const QVector3D &point) const

이 행렬에 w 좌표에 1.0을 가정하여 4D 벡터로 확장된 point 을 곱하여 point 을 매핑합니다. 행렬은 미리 적용됩니다.

mapRect() 및 mapVector()도 참조하세요 .

QVector4D QMatrix4x4::map(const QVector4D &point) const

이 행렬에 point 을 곱하여 point 을 매핑합니다. 행렬은 미리 적용됩니다.

mapRect()도 참조하세요 .

QRect QMatrix4x4::mapRect(const QRect &rect) const

이 행렬에 rect 의 모서리를 곱하여 rect 을 매핑한 다음 결과에서 새 직사각형을 만듭니다. 반환된 직사각형은 가로축과 세로축에 평행한 변을 가진 일반 2D 직사각형이 됩니다.

map()도 참조하세요 .

QRectF QMatrix4x4::mapRect(const QRectF &rect) const

이 행렬에 rect 의 모서리를 곱하여 rect 을 매핑한 다음 결과에서 새 직사각형을 만듭니다. 반환된 직사각형은 가로축과 세로축에 평행한 변을 가진 일반 2D 직사각형이 됩니다.

map()도 참조하세요 .

QVector3D QMatrix4x4::mapVector(const QVector3D &vector) const

이 행렬의 상위 3x3 부분에 vector 을 곱하여 vector 을 매핑합니다. 이 행렬의 변환 및 투영 구성 요소는 무시됩니다. 행렬은 사전 벡터로 적용됩니다.

map()도 참조하세요 .

QMatrix3x3 QMatrix4x4::normalMatrix() const

이 4x4 변환에 대응하는 행렬을 반환합니다. 행렬은 이 4x4 행렬의 왼쪽 상단 3x3 부분의 역의 전치입니다. 3x3 하위 행렬이 반전할 수 없는 경우 이 함수는 행렬의 동일성을 반환합니다.

inverted()도 참조하세요 .

void QMatrix4x4::optimize()

현재 요소에서 이 행렬의 사용을 최적화합니다.

translate(), scale(), rotate()와 같은 일부 연산은 수정 중인 행렬이 이미 ID, 이전 translate(), 이전 scale() 등으로 알려진 경우 더 효율적으로 수행될 수 있습니다.

일반적으로 QMatrix4x4 클래스는 연산이 수행될 때 내부적으로 이 특수 유형을 추적합니다. 그러나 행렬이 operator()(int, int) 또는 data()로 직접 수정되면 QMatrix4x4 은 특수 유형을 추적하지 못하고 이후 가장 안전하지만 효율성이 가장 낮은 연산으로 되돌아갑니다.

프로그래머는 행렬을 직접 수정한 후 optimize()를 호출하여 요소가 알려진 최적화된 유형 중 하나를 따르는 것처럼 보이는 경우 QMatrix4x4 특수 유형을 복구하도록 강제할 수 있습니다.

operator()(int, int), data() 및 translate()도 참조하세요 .

void QMatrix4x4::ortho(float left, float right, float bottom, float top, float nearPlane, float farPlane)

이 행렬에 왼쪽 하단 모서리(left, bottom), 오른쪽 상단 모서리(right, top) 및 지정된 nearPlane 및 farPlane 클리핑 평면이 있는 창에 직교 투영을 적용하는 다른 행렬을 곱합니다.

frustum() 및 perspective()도 참조하십시오 .

void QMatrix4x4::ortho(const QRect &rect)

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

이 행렬에 rect 으로 지정된 경계가 있는 창에 직교 투영을 적용하는 다른 행렬을 곱합니다. 근거리 및 원거리 클리핑 평면은 각각 -1과 1이 됩니다.

frustum() 및 perspective()도 참조하세요 .

void QMatrix4x4::ortho(const QRectF &rect)

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

이 행렬에 rect 으로 지정된 경계가 있는 창에 직교 투영을 적용하는 다른 행렬을 곱합니다. 근거리 및 원거리 클리핑 평면은 각각 -1과 1이 됩니다.

frustum() 및 perspective()도 참조하세요 .

void QMatrix4x4::perspective(float verticalAngle, float aspectRatio, float nearPlane, float farPlane)

이 행렬에 원근 투영을 적용하는 다른 행렬을 곱합니다. 수직 시야는 수평 시야를 결정하는 aspectRatio 이 지정된 창 내에서 verticalAngle 도가 됩니다. 투영에는 뷰어에서 해당 평면까지의 거리인 지정된 nearPlane 및 farPlane 클리핑 평면이 있습니다.

ortho() 및 frustum()도 참조하세요 .

void QMatrix4x4::rotate(const QQuaternion &quaternion)

이 행렬에 지정된 quaternion 에 따라 좌표를 회전하는 다른 행렬을 곱합니다. quaternion 은 정규화된 것으로 가정합니다.

scale(), translate() 및 QQuaternion 를참조하세요 .

void QMatrix4x4::rotate(float angle, const QVector3D &vector)

이 행렬에 좌표를 vector 에 대해 angle 도 회전하는 다른 행렬을 곱합니다.

scale() 및 translate()도 참조하세요 .

void QMatrix4x4::rotate(float angle, float x, float y, float z = 0.0f)

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

이 행렬에 벡터를 중심으로 좌표를 angle 도 회전하는 다른 행렬을 곱합니다(x, y, z).

scale() 및 translate()도 참조하세요 .

QVector4D QMatrix4x4::row(int index) const

index 행의 요소를 4D 벡터로 반환합니다.

setRow() 및 column()도 참조하세요 .

void QMatrix4x4::scale(const QVector3D &vector)

이 행렬에 vector 의 구성 요소로 좌표를 스케일링하는 다른 행렬을 곱합니다.

translate() 및 rotate()도 참조하세요 .

void QMatrix4x4::scale(float factor)

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

이 행렬에 주어진 factor 에 의해 좌표를 스케일링하는 다른 행렬을 곱합니다.

translate() 및 rotate()도 참조하세요 .

void QMatrix4x4::scale(float x, float y)

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

이 행렬에 컴포넌트 x 및 y 에 의해 좌표를 스케일링하는 다른 행렬을 곱합니다.

translate() 및 rotate()도 참조하세요 .

void QMatrix4x4::scale(float x, float y, float z)

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

이 행렬에 x, y, z 구성 요소로 좌표를 스케일링하는 다른 행렬을 곱합니다.

translate() 및 rotate()도 참조하세요 .

void QMatrix4x4::setColumn(int index, const QVector4D &value)

index 열의 요소를 value 의 구성 요소로 설정합니다.

column() 및 setRow()도 참조하세요 .

void QMatrix4x4::setRow(int index, const QVector4D &value)

index 행의 요소를 value 의 구성 요소로 설정합니다.

row() 및 setColumn()도 참조하세요 .

void QMatrix4x4::setToIdentity()

이 행렬을 ID로 설정합니다.

isIdentity()도 참조하세요 .

template <int N, int M> QGenericMatrix<N, M, float> QMatrix4x4::toGenericMatrix() const

이 4x4 행렬의 가장 왼쪽에 있는 N 열과 가장 위에 있는 M 행에서 NxM 일반 행렬을 구성합니다. N 또는 M이 4보다 크면 나머지 요소는 동일성 행렬의 요소로 채워집니다.

QTransform QMatrix4x4::toTransform() const

이 행렬에 대응하는 기존의 Qt 2D 변환 행렬을 반환합니다.

반환된 QTransform 은 QMatrix4x4 의 세 번째 행과 세 번째 열을 단순히 삭제하여 형성됩니다. 이는 z 좌표를 투영하는 것이 아니라 삭제해야 하는 직교 투영을 구현하는 데 적합합니다.

QTransform QMatrix4x4::toTransform(float distanceToPlane) const

이 행렬에 대응하는 기존 Qt 2D 변환 행렬을 반환합니다.

distanceToPlane 이 0이 아닌 경우 z 좌표를 조정하는 데 사용할 투영 계수를 나타냅니다. 1024 값은 QTransform::rotate()에서 x축과 y축에 사용하는 투영 계수에 해당합니다.

distanceToPlane 이 0이면 반환된 QTransform 은 QMatrix4x4 의 세 번째 행과 세 번째 열을 삭제하여 형성됩니다. 이는 z 좌표를 투영하지 않고 삭제해야 하는 직교 투영을 구현하는 데 적합합니다.

void QMatrix4x4::translate(const QVector3D &vector)

이 행렬에 vector 의 구성 요소로 좌표를 변환하는 다른 행렬을 곱합니다.

scale() 및 rotate()도 참조하세요 .

void QMatrix4x4::translate(float x, float y)

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

이 행렬에 좌표를 변환하는 다른 행렬 x, 및 y 을 곱합니다.

scale() 및 rotate()도 참조하세요 .

void QMatrix4x4::translate(float x, float y, float z)

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

이 행렬에 x, y, z 구성 요소로 좌표를 변환하는 다른 행렬을 곱합니다.

scale() 및 rotate()도 참조하세요 .

QMatrix4x4 QMatrix4x4::transposed() const

이 행렬을 대각선 방향으로 반전된 상태로 반환합니다.

void QMatrix4x4::viewport(float left, float bottom, float width, float height, float nearPlane = 0.0f, float farPlane = 1.0f)

이 행렬에 OpenGL에서 정규화된 장치 좌표(NDC)에서 뷰포트(창) 좌표로 변환하는 데 사용되는 배율 및 바이어스 변환을 수행하는 다른 행렬을 곱합니다. 즉, 각 차원에서 [-1, 1]을 초과하는 큐브의 점을 뷰포트의 왼쪽 하단 모서리에 가까운 (left, bottom, nearPlane) 및 크기 (width, height, farPlane - nearPlane)로 매핑합니다.

이는 glViewport() 및 glDepthRange() 함수에 의해 제어되는 고정 함수 OpenGL 뷰포트 트랜스폼에서 사용하는 트랜스폼과 일치합니다.

void QMatrix4x4::viewport(const QRectF &rect)

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

rect 으로 경계가 지정되고 근거리와 원거리가 각각 0과 1로 설정된 뷰포트에 대한 뷰포트 변환을 설정합니다.

QVariant QMatrix4x4::operator QVariant() const

행렬을 QVariant 로 반환합니다.

bool QMatrix4x4::operator!=(const QMatrix4x4 &other) const

이 행렬이 other 과 동일하지 않으면 true 을 반환하고, 그렇지 않으면 false 를 반환합니다. 이 연산자는 정확한 부동소수점 비교를 사용합니다.

float &QMatrix4x4::operator()(int row, int column)

요소를 할당할 수 있도록 이 행렬의 위치 (row, column)에 있는 요소에 대한 참조를 반환합니다.

optimize(), setColumn() 및 setRow()도 참조하세요 .

const float &QMatrix4x4::operator()(int row, int column) const

이 행렬의 위치 (row, column)에 있는 요소에 대한 상수 참조를 반환합니다.

column() 및 row()도 참조하세요 .

QMatrix4x4 &QMatrix4x4::operator*=(const QMatrix4x4 &other)

other 의 내용에 이 행렬을 곱합니다.

QMatrix4x4 &QMatrix4x4::operator*=(float factor)

이것은 과부하 함수입니다.

이 행렬의 모든 요소에 factor 을 곱합니다.

QMatrix4x4 &QMatrix4x4::operator+=(const QMatrix4x4 &other)

other 의 내용을 이 매트릭스에 추가합니다.

QMatrix4x4 &QMatrix4x4::operator-=(const QMatrix4x4 &other)

이 행렬에서 other 의 내용을 뺍니다.

QMatrix4x4 &QMatrix4x4::operator/=(float divisor)

이것은 과부하된 함수입니다.

이 행렬의 모든 요소를 divisor 로 나눕니다.

bool QMatrix4x4::operator==(const QMatrix4x4 &other) const

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