QPainterPathStroker Class
QPainterPathStroker クラスは、指定されたペインターパスに対して塗りつぶし可能なアウトラインを生成するために使用されます。詳細...
| ヘッダー: | #include <QPainterPathStroker> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- QPainterPathStrokerは、Paintingクラス群の一部です。
パブリック関数
| 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 |
詳細な説明
createStroke() 関数を呼び出し、引数として指定されたQPainterPath を渡すことで、そのパスの輪郭を表す新しいペインターパスが作成されます。その後、新しく作成されたペインターパスに塗りつぶしを行うことで、元のペインターパスの輪郭を描画することができます。
以下の関数を使用して、アウトラインのさまざまなデザイン要素(幅、端のスタイル、接続スタイル、ダッシュパターン)を制御できます。
setDashPattern() 関数は、引数として `Qt::PenStyle ` オブジェクトと、パターンのリスト表現の両方を受け付けます。
さらに、setCurveThreshold() 関数を使用することで、曲線のしきい値を指定し、曲線が描画される細かさを制御することができます。デフォルトのしきい値は適切に調整された値(0.25)であり、通常は変更する必要はありません。ただし、この値を小さくすることで、曲線の見た目をより滑らかにすることができます。
また、setMiterLimit()関数を使用して、生成されるアウトラインのマイター制限を制御することもできます。マイター制限は、各接合部からマイター接合がどこまで伸びることができるかを指定します。制限は幅の単位で指定されるため、ピクセル単位のマイター制限はmiterlimit * width となります。この値は、接合スタイルがQt::MiterJoin の場合にのみ使用されます。
createStroke() 関数によって生成されたペインターパスは、指定されたペインターパスのアウトライン描画にのみ使用してください。それ以外の場合、予期しない動作を引き起こす可能性があります。生成されたアウトラインには、デフォルトで設定されているQt::WindingFill ルールも必要です。
メンバー関数のドキュメント
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()も参照してください 。
© 2026 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.