QTransform Class

メンバ関数ドキュメント

QTransform::QTransform()

単位行列を構築する。

m11 とm22 (スケールを指定) とm33 が 1 に設定される以外は、すべての要素が 0 に設定される。

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

adjoint関数は、この行列のアジョイントを返します。

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)

dx を x 軸方向に，dy を y 軸方向に平行移動した行列を作成します．これはQTransform().translate(dx, dy) と同じですが，若干高速です．

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

この行列の逆コピーを返します．

行列が特異行列（反転できない行列）である場合，返される行列は単位行列となります．invertible が有効な場合（つまり 0 ではない場合），行列が反転可能であればその値は true にセットされ，そうでなければ false にセットされます．

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

rotation または shearing が指定されている場合，この関数は外接矩形を返します．与えられた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)

四辺形多角形one を別の四辺形多角形two に写す変換行列trans を作成します．変換が可能な場合はtrue を返し，そうでない場合は false を返します．

これはquadToSquare() とsquareToQuad() を組み合わせた便利なメソッドです。これにより、入力四角形を他の任意の四角形に変換することができます。

squareToQuad() およびquadToSquare()も参照してください 。

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

四辺形多角形quad を単位正方形に写す変換行列trans を作成します。変換行列が作成された場合はtrue を返し、そのような変換行列が存在しない場合は false を返します。

squareToQuad() およびquadToQuad()も参照してください 。

void QTransform::reset()

行列を単位行列にリセットします．つまり，すべての要素が 0 にセットされます．ただし，m11 とm22 （スケールを指定）とm33 は 1 にセットされます．

QTransform()，isIdentity()，Basic Matrix Operationsも参照してください ．

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

座標系を，スクリーンからの距離distanceToPlane で指定されたaxis を中心に，与えられた角度a だけ反時計回りに回転させ，その行列への参照を返す。

ウィジェット座標で定義された点にQTransform 、y軸が下を向いているため、回転方向は時計回りになることに注意してください。

角度は度単位で指定します。

distanceToPlane がゼロの場合、無視されます。これは、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 がゼロの場合、無視されます。これは、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 を返します．