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() | |
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 規則 も 必要です。
メンバ関数ドキュメント
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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。