QTransform Class

メンバ関数のドキュメント

QTransform::QTransform()

単位行列を作成します。

m11 、m22 （スケールを指定する）、およびm33 を除くすべての要素は0に設定され、これら3つの要素は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()も参照してください 。

[constexpr noexcept default] QTransform::QTransform(const QTransform &other)

QTransform のインスタンスをコピーして生成します。

[constexpr noexcept default] QTransform::QTransform(QTransform &&other)

QTransform のインスタンスをMoveコンストラクタで生成します。

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)

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

回転やせん断が指定されている場合、この関数は境界矩形を返します。指定された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 を除くすべての要素がゼロに設定され、これら3つの要素は1に設定されます。

QTransform()、isIdentity()、およびBasic Matrix Operationsも参照してください 。

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

指定された角度 `a ` だけ、画面から距離 `distanceToPlane ` の位置にある指定された点 `axis ` を軸として座標系を反時計回りに回転させ、行列への参照を返します。

なお、ウィジェット座標で定義された点にQTransform を適用する場合、y軸は下向きであるため、回転方向は時計回りになります。

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

distanceToPlane が 0 の場合は、無視されます。これは、z 座標を投影するのではなく削除すべき正射影を実装するのに適しています。

この関数は Qt 6.5 で導入されました。

setMatrix()も参照してください 。

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

指定された角度a だけ、画面から距離1024.0にある指定されたaxis を中心に座標系を反時計回りに回転させ、行列への参照を返します。

なお、ウィジェット座標で定義された点にQTransform を適用する場合、y軸は下向きであるため、回転の方向は時計回りになります。

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

setMatrixも参照してください 。

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

指定された角度a だけ、画面から距離distanceToPlane の位置にある指定されたaxis を中心に座標系を反時計回りに回転させ、行列への参照を返します。

なお、ウィジェット座標で定義された点にQTransform を適用する場合、y軸は下向きであるため、回転方向は時計回りになります。

角度はラジアン単位で指定します。

distanceToPlane が 0 の場合、この引数は無視されます。これは、z 座標を投影せずに省略する正投影を実装するのに適しています。

この関数は Qt 6.5 で導入されました。

setMatrix()も参照してください 。

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

指定された角度a だけ、画面から距離1024.0の位置にある指定されたaxis を中心に座標系を反時計回りに回転させ、行列への参照を返します。

なお、ウィジェット座標で定義された点に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)

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

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

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

座標系をx軸方向にはdx 、y軸方向にはdy だけ移動させ、その行列への参照を返します。

setMatrix()も参照してください 。

QTransform QTransform::transposed() const

この行列の転置を返します。

QTransform::TransformationType QTransform::type() const

この行列の変換タイプを返します。

変換タイプとは、その行列のすべての変換を網羅する最も大きな列挙値のことです。たとえば、行列が拡大・縮小とせん断の両方を行っている場合、タイプはTxShear となります。これは、TxShear の列挙値がTxScale よりも大きいためです。

行列の変換タイプを把握することは、最適化に役立ちます。多くの場合、一般的なケースを扱うよりも、特定のタイプを扱う方がより最適に処理できるからです。

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 default] QTransform &QTransform::operator=(QTransform &&other)

other をこのQTransform インスタンスに割り当てます。

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

指定されたmatrix の値を、この行列に割り当てます。

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

この行列が指定されたmatrix と等しい場合はtrue を返し、そうでない場合はfalse を返します。