QPainterPathStroker Class

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

Header: #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

Miter Limit関数は、生成されたアウトラインのマイタ制限を返します。

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()も参照して ください。

このドキュメントに含まれるコントリビューションの著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。