QCanvasPath Class

// m_path is QCanvasPath with lots of commands in it
const int pathGroup = 5;

// in every frame:
  painter->stroke(m_path, pathGroup);
  // ... other draw commands
  painter->translate(100, 0);
  painter->stroke(m_path, pathGroup);
  // ... other draw commands

// m_path is QCanvasPath with lots of commands in it
const int pathGroup = 5;

// in every frame:
  painter->setStrokeWidth(4);
  painter->stroke(m_path, pathGroup);
  // ... other draw commands
  painter->translate(100, 0);
  painter->setStrokeWidth(8);
  painter->stroke(m_path, pathGroup);
  // ... other draw commands

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

QCanvasPath::QCanvasPath()

空のパスを構築します。

[explicit] QCanvasPath::QCanvasPath(qsizetype commandsSize, qsizetype commandsDataSize = -1)

空のパスを構築し、commandsSize 個のコマンド分と、オプションでcommandsDataSize 分のデータ分の領域を割り当てます。commandsDataSize パラメータが指定されていない場合、2 * commandsSize 分のデータ分が自動的に確保されます。これは、パスのコマンドが直線（moveTo()、lineTo()、rect()）である場合に最適な量です。

適切なスペースを確保することは、パスの作成とメモリ使用量の最適化につながります。ただし、パスにコマンドを追加する際に十分なスペースが自動的に確保されるため、これは必須ではありません。

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

QCanvasPath::QCanvasPath(const QCanvasPath &path)

指定されたpath のコピーとなるパスを構築します。

[noexcept] QCanvasPath::QCanvasPath(QCanvasPath &&other)

other から新しい QCanvasPath を生成します。

[noexcept] QCanvasPath::~QCanvasPath()

パスを削除します。

[since 6.12] void QCanvasPath::addPath(QStringView svgPath, const QTransform &transform = QTransform())

このパスにsvgPath を追加します。必要に応じて、transform を使用してパスのポイントを変更することもできます。パスの推定サイズがわかっている場合は、その前にreserve()を呼び出すことを検討してください。

このフォーマットの詳細については、W3C SVG Path Data を参照してください。

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

void QCanvasPath::addPath(const QCanvasPath &path, const QTransform &transform = QTransform())

このパスにpath を追加します。必要に応じてtransform を使用してパスポイントを変更することもできます。transform が指定されていない場合（またはそれが単位行列である場合）、パスデータを再利用するため、この操作は非常に高速に実行されます。

void QCanvasPath::addPath(const QCanvasPath &path, qsizetype start, qsizetype count, const QTransform &transform = QTransform())

start のコマンドから始まり、count 個のコマンドを含む、path を現在のパスに追加します。オプションで、transform を使用してパスポイントを変更することもできます。start とcount の範囲がチェックされるため、QCanvasPath::commandsSize( ) を超えるコマンドにはアクセスされません。現在のパス位置からパスを継続させない場合は、まずpath.positionAt(start - 1) を指定してmoveTo() を呼び出してください。

void QCanvasPath::arc(qreal centerX, qreal centerY, qreal radius, qreal a0, qreal a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

QPointF （centerX 、centerY ）を中心とし、指定されたradius を持つ円弧を作成します。この円弧は、a0 ラジアンの角度から始まり、a1 ラジアンの角度で終わります。この円弧は、指定されたdirection の範囲をカバーします。connection がNotConnected の場合、前のパスが閉じられ、新しいサブパスが開始されます。

void QCanvasPath::arc(QPointF centerPoint, qreal radius, qreal a0, qreal a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

centerPoint を中心とし、指定されたradius を用いて、a0 ラジアンの角度から始まり、a1 ラジアンの角度で終わる弧を作成します。この弧は、指定されたdirection の範囲をカバーします。connection がNotConnected の場合、前のパスは閉じられ、新しいサブパスが開始されます。

void QCanvasPath::arcTo(qreal x1, qreal y1, qreal x2, qreal y2, qreal radius)

QPointF （x1 、y1 ）およびQPointF （x2 、y2 ）の各点と、指定されたradius を用いて円弧を作成します。

void QCanvasPath::arcTo(QPointF point1, QPointF point2, qreal radius)

指定されたradius を用いて、点point1 およびpoint2 からなる円弧を作成します。

void QCanvasPath::beginHoleSubPath()

「hole」サブパスを開始します。これは、setPathWinding(QCanvasPainter::PathWinding::ClockWise)) と同等です。

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

void QCanvasPath::beginSolidSubPath()

堅実なサブパスを開始します。これは、setPathWinding(QCanvasPainter::PathWinding::CounterClockWise)) と同等です。

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

void QCanvasPath::bezierCurveTo(qreal cp1X, qreal cp1Y, qreal cp2X, qreal cp2Y, qreal x, qreal y)

cp1X 、cp1Y 、cp2X 、およびcp2Y で指定された制御点を使用し、現在の位置とx およびy で指定された終点との間に3次ベジェ曲線を追加します。

曲線が追加されると、現在の位置は曲線の終点に更新されます。

void QCanvasPath::bezierCurveTo(QPointF controlPoint1, QPointF controlPoint2, QPointF endPoint)

controlPoint1 で指定された制御点とcontrolPoint2 を使用して、現在の位置と指定されたendPoint の間に3次ベジェ曲線を追加します。

曲線が追加された後、現在の位置は曲線の終点に更新されます。

void QCanvasPath::circle(qreal x, qreal y, qreal radius)

QPointF(x,y) を中心とし、指定されたradius を持つ円をパスに追加します。

void QCanvasPath::circle(QPointF centerPoint, qreal radius)

centerPoint を中心とし、指定されたradius を持つ円をパスに追加します。

void QCanvasPath::clear()

パスコマンドとデータをクリアします。

パスコマンドが変更された際に、この関数を呼び出してパスを再構築してください。これはメモリ使用量には影響しません。メモリ使用量の管理には、reserve() およびsqueeze() を使用してください。

reserve() およびsqueeze()も参照してください 。

void QCanvasPath::closePath()

現在のサブパスを、その先頭まで線を引いて閉じ、自動的に新しいパスを開始します。

qsizetype QCanvasPath::commandsCapacity() const

パス内のコマンドの容量を返します。

commandsDataCapacity() およびreserve()も参照してください 。

qsizetype QCanvasPath::commandsDataCapacity() const

指定されたパスにある「commands」データの容量を返します。

commandsCapacity() およびreserve()も参照してください 。

qsizetype QCanvasPath::commandsDataSize() const

パス内のコマンドデータの数を返します。

コマンドデータとは、基本的にコマンドに必要なポイントを指します。

qsizetype QCanvasPath::commandsSize() const

パス内のコマンドの数を返します。

QPointF QCanvasPath::currentPosition() const

パスの現在の位置を返します。これは、直前のパスコマンド（moveTo 、lineTo 、bezierCurveTo など）が終了した位置を指します。パスが空の場合は、(0.0, 0.0)を返します。

void QCanvasPath::ellipse(qreal x, qreal y, qreal radiusX, qreal radiusY)

(x,y) を中心とし、半径をradiusX 、radiusY で定義された楕円を作成し、それを閉じたサブパスとしてパスに追加します。

void QCanvasPath::ellipse(const QRectF &rect)

矩形rect 内に楕円を作成し、それを閉じたサブパスとしてパスに追加します。

bool QCanvasPath::isEmpty() const

パスが空の場合、true を返します。

clearも参照してください 。

void QCanvasPath::lineTo(QPointF point)

現在の位置から指定されたpoint まで直線を追加します。線が描画された後、現在の位置は線の終点に更新されます。

void QCanvasPath::lineTo(qreal x, qreal y)

現在の位置から点 (x,y) まで線を引きます。

void QCanvasPath::moveTo(QPointF point)

現在のポイントを指定されたpoint に移動し、暗黙的に新しいサブパスを開始するとともに、前のサブパスを終了します。

void QCanvasPath::moveTo(qreal x, qreal y)

現在の位置を (x,y) に移動し、新しいサブパスを開始すると同時に、前のパスを暗黙的に閉じます。

QPointF QCanvasPath::positionAt(qsizetype index) const

index におけるパスの位置を返します。これは、index における path コマンド（moveTo 、lineTo 、bezierCurveTo など）の位置を指します。インデックスは、0 からcommandsSize() - 1 の範囲内である必要があります。パスが空の場合、(0.0, 0.0) を返します。

void QCanvasPath::quadraticCurveTo(qreal cpX, qreal cpY, qreal x, qreal y)

現在の点と終点 (x,y) の間に、制御点 (cpX,cpY) で指定された2次ベジェ曲線を追加します。

void QCanvasPath::quadraticCurveTo(QPointF controlPoint, QPointF endPoint)

現在の位置と指定されたendPoint の間に、controlPoint で指定された制御点を持つ2次ベジェ曲線を追加します。

void QCanvasPath::rect(qreal x, qreal y, qreal width, qreal height)

指定されたwidth およびheight を用いて、QPointF(x,y) に位置する長方形を作成します。

void QCanvasPath::rect(const QRectF &rect)

以下で指定された長方形を作成します。rect

void QCanvasPath::reserve(qsizetype commandsSize, qsizetype commandsDataSize = -1)

QCanvasPath の内部メモリに、指定された容量分の領域を確保します。

少なくともcommandsSize 個のコマンドとcommandsDataSize 個のデータポイント分のメモリを割り当てようとします。一部のパス要素では複数のコマンドが必要となる場合があります。詳細はcommandsSize() およびcommandsDataSize() を参照してください。

commandsDataSize が指定されていない場合、2 * commandsSize のデータ量分が自動的に確保されます。これは、パスコマンドが直線（moveTo()、lineTo()、rect()）である場合の最適な量です。

適切なスペースを確保することは、パスの作成とメモリ使用量の最適化につながります。ただし、パスにコマンドを追加する際に十分なスペースが自動的に確保されるため、必須ではありません。

squeeze()、commandsCapacity()、およびcommandsDataCapacity()も参照してください 。

void QCanvasPath::roundRect(qreal x, qreal y, qreal width, qreal height, qreal radius)

指定された矩形x 、y 、width 、height を、角を丸めた状態でパスに追加します。角は、指定されたradius に基づく四分円となります。

void QCanvasPath::roundRect(qreal x, qreal y, qreal width, qreal height, qreal radiusTopLeft, qreal radiusTopRight, qreal radiusBottomRight, qreal radiusBottomLeft)

角が丸い矩形x 、y 、width 、height をパスに追加します。角は、それぞれ半径radiusTopLeft 、radiusTopRight 、radiusBottomRight 、radiusBottomLeft の4分の1円となっています。

void QCanvasPath::roundRect(const QRectF &rect, qreal radius)

指定された角が丸い矩形rect をパスに追加します。角は、指定されたradius に基づく4分の1円となります。

void QCanvasPath::roundRect(const QRectF &rect, qreal radiusTopLeft, qreal radiusTopRight, qreal radiusBottomRight, qreal radiusBottomLeft)

角が丸い長方形（rect ）をパスに追加します。角は、それぞれ半径radiusTopLeft 、radiusTopRight 、radiusBottomRight 、radiusBottomLeft を持つ四分円です。

void QCanvasPath::setPathWinding(QCanvasPainter::PathWinding winding)

現在のサブパス「winding 」を、「QCanvasPainter::CounterClockWise 」（デフォルト）または「QCanvasPainter::ClockWise 」のいずれかに設定します。「CounterClockWise」は実線のサブパスを描画し、「ClockWise」は穴を描画します。

QCanvasPath QCanvasPath::sliced(qsizetype start, qsizetype count, const QTransform &transform = QTransform()) const

このパスに含まれるコマンドのうち、start にあるコマンドから始まり、count 個のコマンドを含む新しいパスを返します。必要に応じて、transform を使用してパスの分岐点を変更することもできます。

start とcount の範囲がチェックされ、commandsSize() を超えるコマンドにはアクセスされないようにします。start にあるコマンドがMoveTo でない場合、このスライスが独立したパスとなるよう、最初のコマンドはMoveTo に置き換えられます。

void QCanvasPath::squeeze()

パスコマンドやデータの保存に不要なメモリを解放します。これは、reserve() を呼び出した後のメモリ使用量を削減するために使用できます。

通常、これを使用する必要はありませんが、多くの要素を予約または追加した（lineTo 、bezierCurveTo など）ためにパスサイズが大きくなり、今後サイズが大幅に小さくなると予想される場合、まずreserve() を呼び出し、次にsqueeze() を呼び出すことで、一部のメモリを解放することができます。

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

[noexcept] void QCanvasPath::swap(QCanvasPath &other)

このパスをother と入れ替えます。この操作は非常に高速で、失敗することはありません。

QCanvasPath::operator QVariant() const

パスをQVariant として返します。

[noexcept] QCanvasPath &QCanvasPath::operator=(QCanvasPath &&other)

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

QCanvasPath &QCanvasPath::operator=(const QCanvasPath &path)

指定されたpath をこのパスに割り当て、このパスへの参照を返します。