QCanvasPath Class

メンバ関数ドキュメント

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 のコピーであるパスを構築する。

QCanvasPath::QCanvasPath(QCanvasPath &&other)

移動-other から新しい QCanvasPath を構築します。

[noexcept] QCanvasPath::~QCanvasPath()

パスを破壊する。

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(float centerX, float centerY, float radius, float a0, float 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, float radius, float a0, float a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

指定されたradius で、centerPoint を中心とし、a0 ラジアンの角度で始まり、a1 ラジアンで終わる円弧を作成します。弧は、与えられたdirection にまたがる。connection がNotConnected のとき、前のパスは閉じられ、新しいサブパスが開始される。

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

点QPointF(x1,y1) と点QPointF(x2,y2) を使って、与えられたradius と弧を作る。

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

与えられたradius を持つ点point1 とpoint2 を使って円弧を作成します。

void QCanvasPath::beginHoleSubPath()

ホールサブパスを開始する。これはsetPathWinding(QCanvasPainter::PathWinding::ClockWise) と同じ。）

beginSolidSubPath()も参照のこと 。

void QCanvasPath::beginSolidSubPath()

ソリッドサブパスを開始する。これはsetPathWinding(QCanvasPainter::PathWinding::CounterClockWise) と同じである。）

beginHoleSubPath()も参照 。

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

cp1X,cp1Y,cp2X,cp2Y で指定された制御点を用いて、現在位置とx とy で指定された終点との間に三次ベジェ曲線を追加する。

曲線が追加された後、現在位置は曲線の終点になるように更新される。

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

controlPoint1 とcontrolPoint2 で指定された制御点を用いて、現在位置と与えられたendPoint の間に三次ベジェ曲線を追加する。

曲線が追加された後、現在位置は曲線の終点になるように更新される。

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

QPointF(x,y) を中心とし、与えられたradius を中心とする円をパスに追加する。

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

centerPoint を中心とし、与えられたradius を持つ円をパスに追加します。

void QCanvasPath::clear()

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

パス・コマンドが変更されたときにこれをコールして、パスを再作成する。これはメモリ使用量には影響しないので、その場合はreserve() およびsqueeze() を使用する。

reserve() およびsqueeze()も参照 。

void QCanvasPath::closePath()

サブパスの始点に線を引いて現在のサブパスを閉じ、自動的に新しいパスを開始する。

qsizetype QCanvasPath::commandsCapacity() const

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

commandsDataCapacity() およびreserve()も参照 。

qsizetype QCanvasPath::commandsDataCapacity() const

パス内のコマンドデータの容量を返す。

commandsCapacity() およびreserve()も参照 。

qsizetype QCanvasPath::commandsDataSize() const

パスに含まれるコマンドデータの量を返す。

コマンドデータとは、基本的にコマンドが必要とするポイントを意味する。

qsizetype QCanvasPath::commandsSize() const

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

QPointF QCanvasPath::currentPosition() const

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

void QCanvasPath::ellipse(float x, float y, float radiusX, float 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(float x, float y)

現在位置から点（x,y ）まで線を引く。

void QCanvasPath::moveTo(QPointF point)

point暗黙的に新しいサブパスを開始し、前のサブパスを閉じる。

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

現在の位置を (x,y) に移動し、新しいサブパスを開始し、暗黙のうちに前のパスを閉じる。

QPointF QCanvasPath::positionAt(qsizetype index) const

index におけるパスの位置を返す。これは、パスコマンド (moveTo,lineTo,bezierCurveTo など) がindex にある位置を意味する。インデックスは0 とcommandsSize() - 1 の間である必要があります。パスが空の場合、(0.0, 0.0)を返します。

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

カ レ ン ト 点 と 、 (cpX,cpY) で指定 さ れた制御点を持つ終点 (x,y) との間に、 二次ベジェ曲線を追加 し ます。

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

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

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

QPointF(x,y) の位置に、 与えられたwidth とheight を持つ矩形を作成します。

void QCanvasPath::rect(const QRectF &rect)

で指定された矩形を作成する。rect

void QCanvasPath::reserve(qsizetype commandsSize, qsizetype commandsDataSize)

QCanvasPath の内部メモリに所定の容量を確保する。

少なくともcommandsSize のコマンドとcommandsDataSize のデータポイントのためのメモリを確保しようとする。パス要素の中には複数のコマンドを必要とするものがあります。commandsSize() およびcommandsDataSize() を参照してください。

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

squeeze()、commandsCapacity()、commandsDataCapacity()も参照 。

void QCanvasPath::reserve(qsizetype commandsSize)

QCanvasPath の内部メモリーに指定された量のスペースを確保する。

少なくともcommandsSize コマンド用のメモリを確保しようとする。パス要素の中には複数のコマンドを必要とするものがある。commandsSize() とcommandsDataSize() を参照。

スペースは自動的に2 * commandsSize のデータ量分確保され、パス・コマンドが直線 (moveTo(),lineTo(),rect()) の場合に最適な量となる。

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

squeeze()、commandsCapacity()、commandsDataCapacity()も参照 。

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

与えられた矩形x,y,width,height を、 角を丸めた形でパスに追加します。角は、 与えられたradius の 4 分の 1 円です。

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

角が丸 く な っ た矩形x,y,width,height をパスに追加 し ます。角はそれぞれ半径radiusTopLeft,radiusTopRight radiusBottomRight ,radiusBottomLeft の 1/4 円です。

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

角が丸 く な っ た、 与えられた矩形rect をパスに追加 し ます。角は、与えられたradius の 4 分の 1 円です。

void QCanvasPath::roundRect(const QRectF &rect, float radiusTopLeft, float radiusTopRight, float radiusBottomRight, float 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)

Move-other をこのQCanvasPath インスタンスに割り当てる。

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

与えられたpath をこのパスに割り当て、このパスへの参照を返します。