QPainterPathStroker Class

QPainterPathStroker クラスは、与えられたペインタパスの塗りつぶし可能なアウトラインを生成するために使用されます。詳細...

ヘッダ #include <QPainterPathStroker>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

パブリック関数

QPainterPathStroker()
QPainterPathStroker(const QPen &pen)
~QPainterPathStroker()
Qt::PenCapStyle capStyle() const
QPainterPath createStroke(const QPainterPath &path) const
qreal curveThreshold() const
qreal dashOffset() const
QList<qreal> dashPattern() const
Qt::PenJoinStyle joinStyle() const
qreal miterLimit() const
void setCapStyle(Qt::PenCapStyle style)
void setCurveThreshold(qreal threshold)
void setDashOffset(qreal offset)
void setDashPattern(Qt::PenStyle style)
void setDashPattern(const QList<qreal> &dashPattern)
void setJoinStyle(Qt::PenJoinStyle style)
void setMiterLimit(qreal limit)
void setWidth(qreal width)
qreal width() const

詳細説明

引数として与えられたQPainterPath を渡してcreateStroke() 関数を呼び出すと、与えられたパスのアウトラインを表す新しいペインタパスが作成されます。新しく作成されたペインタパスは、元のペインタパスの輪郭を描画するために塗りつぶされます。

アウトラインのさまざまなデザイン面(幅、キャップスタイル、結合スタイル、ダッシュパターン)は、以下の関数を用いて制御することができます:

setDashPattern() 関数は、Qt::PenStyle オブジェクトとパターンのリスト表現の両方を引数として受け取ります。

さらに、setCurveThreshold() 関数を使用して、曲線を描く粒度を制御する曲線のしきい値を指定することができます。デフォルトの閾値はよく調整された値(0.25)であり、通常は変更する必要はありません。しかし、その値を小さくすることで、曲線の外観をより滑らかにすることができます。

また、setMiterLimit() 関数を使用して、生成されるアウトラインのマイターリミットを制御することもできます。マイターリミットは、マイター結合が各結合からどの程度まで伸びるかを表します。リミットは幅の単位で指定されるため、ピクセル単位のマイターリミットはmiterlimit * width になります。こ の値は結合ス タ イ ルがQt::MiterJoin の場合にのみ用い ら れます。

createStroke() 関数で生成されるペインターパスは、 与えられたペインターパスのアウトライン化にのみ使用されるべきです。そ う し ない と 予期 し ない動作を引 き 起 こ す可能性があ り ます。生成 さ れ る ア ウ ト ラ イ ンには、 デフ ォ ル ト で設定 さ れてい るQt::WindingFill 規則 も 必要です。

QPen およびQBrushも参照して ください。

メンバ関数ドキュメント

QPainterPathStroker::QPainterPathStroker()

新しいストローカーを作る。

[explicit] QPainterPathStroker::QPainterPathStroker(const QPen &pen)

pen をベースに新しいストローカーを作成。

[noexcept] QPainterPathStroker::~QPainterPathStroker()

ストローカーを破壊する。

Qt::PenCapStyle QPainterPathStroker::capStyle() const

生成されたアウトラインのキャップスタイルを返します。

setCapStyle()も参照してください

QPainterPath QPainterPathStroker::createStroke(const QPainterPath &path) const

与えられたpath の輪郭を表す塗りつぶし可能な領域である新しいパスを生成する。

アウトラインのさまざまなデザインは、ストローカのプロパティwidth(),capStyle(),joinStyle(),dashPattern(),curveThreshold(),miterLimit() に基づいています。

生成されたパスは、指定されたペインターパスのアウトライン化にのみ使用されるべきです。そうしないと、予期せぬ動作を引き起こす可能性があります。生成されたアウトラインには、デフォルトで設定されているQt::WindingFill ルールも必要です。

qreal QPainterPathStroker::curveThreshold() const

生成されたアウトラインのカーブ平坦化しきい値を返します。

setCurveThreshold()も参照

qreal QPainterPathStroker::dashOffset() const

生成されたアウトラインのダッシュオフセットを返します。

setDashOffset()も参照 ください。

QList<qreal> QPainterPathStroker::dashPattern() const

生成されたアウトラインのダッシュパターンを返します。

setDashPattern()も参照 ください。

Qt::PenJoinStyle QPainterPathStroker::joinStyle() const

生成されたアウトラインの結合スタイルを返します。

setJoinStyle()も参照してください

qreal QPainterPathStroker::miterLimit() const

生成されたアウトラインのマイターリミットを返します。

setMiterLimit()も参照

void QPainterPathStroker::setCapStyle(Qt::PenCapStyle style)

生成 さ れた輪郭のキ ャ ッ プ ス タ イ ルをstyle に設定 し ます。 ダ ッ シ ュ パ タ ーンが設定 さ れてい る と き は、 パ タ ーン の各セグ メ ン ト はキ ャ ッ プstyle に従います。

capStyle()も参照

void QPainterPathStroker::setCurveThreshold(qreal threshold)

カーブ平坦化threshold を指定し、生成されるアウトラインのカーブが描画される粒度を制御します。

デフォルトの閾値はよく調整された値 (0.25) で、通常は変更する必要はありません。しかし、その値を小さくすることで、曲線の外観をより滑らかにすることができます。

curveThreshold()も参照してください

void QPainterPathStroker::setDashOffset(qreal offset)

生成されるアウトラインのダッシュオフセットをoffset に設定する。

ダッシュ・オフセットの説明については、QPen::setDashOffset() のドキュメントを参照してください。

dashOffset()も参照してください

void QPainterPathStroker::setDashPattern(Qt::PenStyle style)

生成されるアウトラインのダッシュパターンをstyle に設定する。

dashPattern()も参照

void QPainterPathStroker::setDashPattern(const QList<qreal> &dashPattern)

これはオーバーロードされた関数です。

生成されるアウトラインのダッシュパターンをdashPattern に設定します。 この関数を使うと、カスタムダッシュパターンを指定することができます。

リストの各要素は、ストロークのダッシュとスペースの長さを含み、最初の要素の最初のダッシュ、2番目の要素の最初のスペースから始まり、次の要素のペアごとにダッシュとスペースを交互に繰り返します。

その場合、パターンが繰り返されるとき、最後の要素は最初の要素の長さだけ延長されます。

void QPainterPathStroker::setJoinStyle(Qt::PenJoinStyle style)

生成されたアウトラインの結合スタイルをstyle に設定します。

joinStyle()も参照

void QPainterPathStroker::setMiterLimit(qreal limit)

生成されるアウトラインのマイターリミットをlimit に設定します。

マイター限界は、マイター結合が各結合からどの程度まで拡張できるかを示します。この制限は、現在設定されている幅の単位で指定されます。つまり、ピクセル単位のマイターリミットはmiterlimit * width になります。

この値は、結合スタイルがQt::MiterJoin の場合にのみ使用されます。

miterLimit()も参照してください

void QPainterPathStroker::setWidth(qreal width)

生成 さ れ る 輪郭画家パ ス の幅をwidth に設定 し ます。

生成 さ れ る ア ウ ト ラ イ ンは、 与えられた入力パスの元のア ウ ト ラ イ ンの各辺に対 し て、width の約 50% 延びます。

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

qreal QPainterPathStroker::width() const

生成されたアウトラインの幅を返します。

setWidth()も参照ください

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.