QCanvasPainter Class

QRectF rect(40, 70, 120, 60);
QRectF shadowRect = rect.translated(2, 4);
// Paint shadow
QCanvasBoxShadow shadow(shadowRect);
shadow.setRadius(30);
shadow.setBlur(15);
shadow.setColor("#60373F26");
p->drawBoxShadow(shadow);
// Paint rounded rect
p->beginPath();
p->roundRect(rect, 30);
p->setFillStyle("#DBEB00");
p->fill();
// Paint text
p->setTextAlign(QCanvasPainter::TextAlign::Center);
p->setTextBaseline(QCanvasPainter::TextBaseline::Middle);
QFont font("Titillium Web", 18);
p->setFont(font);
p->setFillStyle("#373F26");
p->fillText("CLICK!", rect);

// Paint grid
QCanvasGridPattern grid(0, 0, 10, 10);
grid.setLineColor("#404040");
grid.setBackgroundColor("#202020");
p->setFillStyle(grid);
p->fillRect(0, 0, width(), height());
// Paint axis
p->setFillStyle(QColorConstants::White);
p->fillRect(0, 0.5 * height() - 1, width(), 2);
p->fillRect(0.5 * width() - 1, 0, 2, height());
// Paint shadowed graph
p->beginPath();
p->moveTo(20, height() * 0.8);
p->bezierCurveTo(width() * 0.2, height() * 0.4,
                 width() * 0.5, height() * 0.8,
                 width() - 20, height() * 0.2);
p->setAntialias(10);
p->setLineWidth(12);
p->setStrokeStyle("#D0000000");
p->stroke();
p->setAntialias(1);
p->setLineWidth(6);
QCanvasLinearGradient lg(0, 0, 0, height());
lg.setStartColor(QColorConstants::Red);
lg.setEndColor(QColorConstants::Green);
p->setStrokeStyle(lg);
p->stroke();

p->setWindingEnforce(false);
p->beginPath();
// Outer shape, counterclockwise
p->moveTo(20, 20);
p->lineTo(100, 180);
p->lineTo(180, 20);
p->closePath();
// Inner shape, clockwise
p->moveTo(100, 40);
p->lineTo(125, 90);
p->lineTo(75, 90);
p->closePath();
p->fill();
p->stroke();

p->beginPath();
p->roundRect(20, 20, 160, 160, 30);
// Start painting holes
p->beginHoleSubPath();
p->roundRect(40, 40, 120, 120, 10);
// Start painting solid
p->beginSolidSubPath();
p->rect(60, 60, 80, 20);
p->circle(100, 120, 20);
p->fill();
p->stroke();

メンバ関数のドキュメント

QCanvasPainter::QCanvasPainter()

ペインターを構築します。

[noexcept] QCanvasPainter::~QCanvasPainter()

画家を破滅させる。

qsizetype QCanvasPainter::activeImageCount() const

このQCanvasPainter に登録されている、アクティブなQCanvasImage オブジェクトの数を返します。これには、gradients 用に内部で作成された画像も含まれます。

QCanvasImage QCanvasOffscreenCanvas インスタンスの登録によって作成されたオブジェクトや、外部で管理されているテクスチャは、この関数では考慮されません。

activeImageMemoryUsage()、addImage()、およびremoveImage()も参照してください 。

qsizetype QCanvasPainter::activeImageMemoryUsage() const

このペインターに対して、QImage を引数とするaddImage()のオーバーロードによって作成された、すべてのアクティブなQCanvasImage インスタンスについて、画像（ピクセル）データが使用するメモリのおおよその量（キロバイト単位）を返します。これには、gradients 用に内部で作成された画像のデータも含まれます。

QCanvasPainter addImage()が返った後、CPU側の データのコピーは保持されません。したがって、この関数の結果は、テクスチャに使用されるGPUメモリの近似値となります。QImage

addImage() の他のオーバーロードを介して登録されたオフスクリーン・キャンバスや外部管理のテクスチャは、この関数では考慮されません。

有効な `QCanvasImage` については、sizeInBytes()` を呼び出すことで、個々のサイズ（バイト単位）を常に照会できます。この関数は、QCanvasImage が `QCanvasOffscreenCanvas ` または `QRhiTexture` から作成された場合にも有効な結果を返しますが、ミップマップやマルチサンプルデータは考慮しません。

activeImageCount()、addImage()、およびremoveImage()も参照してください 。

QCanvasImage QCanvasPainter::addImage(const QImage &image, QCanvasPainter::ImageFlags flags = {})

image を追加し、flags をペインターがテクスチャとして利用できるようにします。QCanvasImage を、テクスチャIDや画像に関するその他の情報とともに返します。返されたQCanvasImage は、drawImage やQCanvasImagePattern で使用できます。このメソッドを呼び出した後、image QImage をメモリ内に保持しておく必要はありません。

同じimage を使用して呼び出すことは、キャッシュヒットが見込まれるため、負荷の少ない操作です。

addImage() を 1 回だけ呼び出すように最適化を行う際は注意が必要です。アプリケーションの設計によっては、それだけでは不十分な場合もあります。 たとえば、ウィジェットが新しいトップレベルに移動されたことにより、内部でペインターが新しいQRhi に関連付けられ、基になるグラフィックリソースが失われた場合、image からネイティブのグラフィックテクスチャを再作成するには、この関数を呼び出すことが不可欠です。

drawImage() およびremoveImage()も参照してください 。

QCanvasImage QCanvasPainter::addImage(QRhiTexture *texture, QCanvasPainter::ImageFlags flags = {})

texture を追加し、flags をペインター用のテクスチャとして利用可能にします。返されるQCanvasImage は、drawImage およびQCanvasImagePattern で使用できます。

drawImage() およびremoveImage()も参照してください 。

QCanvasImage QCanvasPainter::addImage(const QCanvasOffscreenCanvas &canvas, QCanvasPainter::ImageFlags flags = {})

canvas をflags としてペインターに登録し、画像として利用できるようにします。返されるQCanvasImage は、drawImage およびQCanvasImagePattern で使用できます。

drawImage() およびremoveImage()も参照してください 。

void QCanvasPainter::addPath(const QPainterPath &path)

現在のパスに「path 」を追加します。

void QCanvasPainter::addPath(const QCanvasPath &path, const QTransform &transform = QTransform())

path を現在のパスに追加します。必要に応じてtransform を使用して、パスの各点を変更することもできます。transform が指定されていない場合（またはそれが単位行列である場合）、パスデータを再利用するため、この操作は非常に高速に行われます。

void QCanvasPainter::addPath(const QCanvasPath &path, qsizetype start, qsizetype count, const QTransform &transform = QTransform())

start のコマンドから始まり、count 個のコマンドを含む、path を現在のパスに追加します。必要に応じて、transform を使用してパスの指す先を変更できます。start とcount の範囲がチェックされるため、QCanvasPath::commandsSize() を超えるコマンドにはアクセスされません。パスを現在のパス位置から継続させない場合は、まずmoveTo() を呼び出してください（例：path.positionAt(start - 1) ）。

void QCanvasPainter::arc(qreal centerX, qreal centerY, qreal radius, qreal a0, qreal a1, QCanvasPainter::PathWinding direction = PathWinding::ClockWise, QCanvasPainter::PathConnection connection = PathConnection::Connected)

新しい円弧状のサブパスを作成します。円弧の中心はcenterX 、centerY にあり、半径はradius です。円弧は角度a0 からa1 まで描かれ、direction （ClockWise またはCounterClockWise ）でスイープされます。connection がNotConnected の場合、円弧は前のパスの位置から円弧の始点まで線を追加しません。角度はラジアン単位で指定されます。

void QCanvasPainter::arc(QPointF centerPoint, qreal radius, qreal a0, qreal a1, QCanvasPainter::PathWinding direction = PathWinding::ClockWise, QCanvasPainter::PathConnection connection = PathConnection::Connected)

新しい円弧状のサブパスを作成します。円弧の中心はcenterPoint にあり、半径はradius です。円弧は角度a0 からa1 まで描画され、direction （ClockWise またはCounterClockWise ）でスイープされます。connection がNotConnected の場合、円弧は前のパスの位置から円弧の始点までの線を追加しません。角度はラジアン単位で指定されます。

void QCanvasPainter::arcTo(qreal x1, qreal y1, qreal x2, qreal y2, qreal radius)

最後のパスポイントと、指定された2つの点（x1 、y1 およびx2 、y2 ）を、radius で結ぶ円弧のセグメントを、その角に追加します。必要に応じて、この円弧はパスの最新のポイントと直線で自動的に接続されます。

void QCanvasPainter::arcTo(QPointF controlPoint1, QPointF controlPoint2, qreal radius)

最後のパスポイントと、指定された2つの点（controlPoint1 およびcontrolPoint2 ）を、radius で結ぶ円弧セグメントを、その角に追加します。必要に応じて、この円弧はパスの最新のポイントと直線で自動的に接続されます。

void QCanvasPainter::beginHoleSubPath()

「hole」サブパスを開始します。これは、setPathWinding(QCanvasPainter::PathWinding::ClockWise)) と同等です。

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

void QCanvasPainter::beginPath()

現在のパスをクリアしながら、新しいパスの描画を開始します。

void QCanvasPainter::beginSolidSubPath()

堅牢なサブパスを開始します。これは、setPathWinding(QCanvasPainter::PathWinding::CounterClockWise)) と同等です。

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

void QCanvasPainter::bezierCurveTo(qreal cp1X, qreal cp1Y, qreal cp2X, qreal cp2Y, qreal x, qreal y)

パスの最後の点から、2つの制御点（cp1X 、cp1Y およびcp2X 、cp2Y ）を経由して、指定された点（x 、y ）まで、3次ベジエ曲線のセグメントを追加します。

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

パスの最後の点から、2つの制御点（controlPoint1 およびcontrolPoint2 ）を経由して、指定された点endPoint まで、3次ベジエ曲線のセグメントを追加します。

void QCanvasPainter::circle(qreal centerX, qreal centerY, qreal radius)

(centerX,centerY)を中心とし、半径radius の新しい円形のサブパスを作成します。

void QCanvasPainter::circle(QPointF centerPoint, qreal radius)

centerPoint を中心とし、radius の半径を持つ新しい円形のサブパスを作成します。

void QCanvasPainter::cleanupResources()

キャッシュから未使用のテクスチャを削除するスケジュール。

さらに、メモリ使用量を最小限に抑えるため、この関数の呼び出しに伴い、他のキャッシュやプールが縮小される場合があります。これにより、その後の描画処理のコストが増加する可能性があります。

void QCanvasPainter::clearRect(qreal x, qreal y, qreal width, qreal height)

x 、y 、width 、height で指定された矩形領域内のピクセルを、透明な黒で塗りつぶして消去します。消去処理にはブレンド処理が不要なため、fillRect() よりも高速に実行される場合があります。

void QCanvasPainter::clearRect(const QRectF &rect)

rect で指定された矩形領域を、透明な黒で塗りつぶして、その領域内のピクセルを消去します。これは、QRectF を使用したオーバーロードされたメソッドです。

void QCanvasPainter::closePath()

現在のサブパスを線分で閉じます。これは、最後のパス要素として `lineTo([始点])` を指定することと同等です。

QCanvasOffscreenCanvas QCanvasPainter::createCanvas(QSize pixelSize, int sampleCount = 1, QCanvasOffscreenCanvas::Flags flags = {})

指定されたpixelSize 、sampleCount 、およびflags を持つ新しいオフスクリーン・キャンバスを返します。

キャンバスのサイズはピクセル単位で指定されます。pixelSize 、sampleCount 、およびflags のプロパティは、その後変更できません。異なるサイズ、サンプル数、またはフラグを持つキャンバスを取得するには、新しいキャンバスを作成してください。

描画コマンドでオフスクリーン・キャンバスを指定するには、低レベルAPIを使用する場合は適切なQCanvasRhiPaintDriver::beginPaint()のオーバーロードを呼び出し、利便性ウィジェットやQt Quick アイテムクラスを使用する場合はQCanvasPainterWidget::beginCanvasPainting()またはQCanvasPainterItemRenderer::beginCanvasPainting()を呼び出します。

通常、キャンバスへの描画時には、その内容がクリアされます。これを無効にするには、flags 内でPreserveContents を渡してください。

キャンバスへのマルチサンプルレンダリング（マルチサンプルアンチエイリアシング、MSAA）を要求するには、サンプル数を 1 より大きい値（4 や 8 など）に設定します。ただし、マルチサンプリングが有効になっている場合、レンダリングパス間でキャンバスの内容を保持することはサポートされておらず、この場合はPreserveContents フラグは機能しません。

void QCanvasPainter::destroyCanvas(QCanvasOffscreenCanvas &canvas)

canvas を支えているリソースを破棄します。これにより、canvas はnull canvas となります。

ペインターは、破棄時に自動的にこの処理を行います。したがって、この関数を呼び出す必要があるのは、関連するリソースを直ちに解放したい場合のみです。

void QCanvasPainter::drawBoxShadow(const QCanvasBoxShadow &shadow)

shadow を使用してボックスを描画します。シャドウは、shadow で定義された位置、サイズ、色、ぼかしなどの設定に従って描画されます。このメソッドを呼び出す前にbeginPath() を呼び出す必要はありません。

QCanvasBoxShadowも参照してください 。

void QCanvasPainter::drawImage(const QCanvasImage &image, qreal x, qreal y)

image を、デフォルトのサイズでx およびy に描画します。

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

void QCanvasPainter::drawImage(const QCanvasImage &image, const QRectF &destinationRect)

image を、destinationRect の位置とサイズに合わせて描画します。

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

void QCanvasPainter::drawImage(const QCanvasImage &image, const QRectF &sourceRect, const QRectF &destinationRect)

画像のsourceRect 領域から、image をdestinationRect の位置とサイズに合わせて描画します。

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

void QCanvasPainter::drawImage(const QCanvasImage &image, qreal x, qreal y, qreal width, qreal height)

image を、指定されたwidth およびheight において、x 、y に描画します。

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

void QCanvasPainter::ellipse(qreal centerX, qreal centerY, qreal radiusX, qreal radiusY)

(centerX,centerY) を中心とし、radiusX およびradiusY を持つ新しい楕円形のサブパスを作成します。

void QCanvasPainter::ellipse(const QRectF &rect)

rect 内に、新しい楕円形のサブパスを作成します。この楕円は、rect の領域を覆うことになります。

void QCanvasPainter::ellipse(QPointF centerPoint, qreal radiusX, qreal radiusY)

centerPoint を中心とし、radiusX およびradiusY のパラメータを持つ、新しい楕円形のサブパスを作成します。

void QCanvasPainter::fill()

現在のパスに、現在の塗りつぶしスタイルと塗りつぶしルールを適用します。

setFillStyle() およびsetFillRule()も参照してください 。

[since 6.12] void QCanvasPainter::fill(QCanvasPainter::FillRule fillRule)

現在のパスを、現在の塗りつぶしスタイルおよび塗りつぶしルールfillRule で塗りつぶします。

この関数は Qt 6.12 で導入されました。

setFillStyle() およびsetFillRule()も参照してください 。

void QCanvasPainter::fill(const QCanvasPath &path, int pathGroup = -1)

path を、現在の塗りつぶしスタイルと塗りつぶしルールで塗りつぶし、pathGroup に格納します。QCanvasPath による描画は、パスに含まれるコマンドが多く、かつその大部分が静的な場合に最適です。

pathGroup が-1 の場合、パスはGPU側でキャッシュされません。これがデフォルトの設定です。パスデータのキャッシュを要求するには、0 以上の値を指定してください。パスキャッシュグループの使用に関する詳細については、QCanvasPath のドキュメントを参照してください。

このメソッドを呼び出す前にbeginPath() を呼び出す必要はありません。

setFillStyle()、setFillRule()、およびremovePathGroup()も参照してください 。

[since 6.12] void QCanvasPainter::fill(const QCanvasPath &path, QCanvasPainter::FillRule fillRule, int pathGroup = -1)

path に、現在の塗りつぶしスタイルと塗りつぶしルールを適用しますfillRule

この関数は Qt 6.12 で導入されました。

void QCanvasPainter::fillRect(qreal x, qreal y, qreal width, qreal height)

指定された位置（x 、y ）に、サイズwidth 、height の塗りつぶされた長方形を描画します。

void QCanvasPainter::fillRect(const QRectF &rect)

rect に塗りつぶされた矩形を描画します。これは、QRectF を使用したオーバーロードされたメソッドです。

void QCanvasPainter::fillText(const QString &text, qreal x, qreal y, qreal maxWidth = 0)

指定された位置（x 、y ）に、現在のtextAlignおよびtextBaselineを使用して、text 文字列を描画します。テキストを複数行に折り返すには、setTextWrapMode() を使用して、テキストの折り返しモードをデフォルトのNoWrap 以外の値に設定してください。オプションのmaxWidth パラメータのデフォルト値は0 です。つまり、例えばWordWrap が設定されている場合、テキストは単語ごとに折り返されます。maxWidth パラメータを、希望する行幅（ピクセル単位）に設定します。

setTextAlign()、setTextBaseline()、およびsetTextWrapMode()も参照してください 。

void QCanvasPainter::fillText(const QString &text, const QRectF &rect)

現在のtextAlignおよびtextBaselineを使用して、rect 内にtext 文字列を描画します。rectパラメータの幅がmaxWidthとして使用されます。

これは、QRectF を使用するオーバーロードされたメソッドです。このメソッドでテキストを描画する際、テキストのベースラインをTextBaseline::Top またはTextBaseline::Middle に設定すると便利な場合がよくあります。

setTextAlign()、setTextBaseline()、およびsetTextWrapMode()も参照してください 。

void QCanvasPainter::fillText(const QString &text, QPointF point, qreal maxWidth = 0)

指定されたpoint に、現在のtextAlignおよびtextBaselineを使用して、text 文字列を描画します。テキストを複数行に折り返すには、setTextWrapMode() を使用して、テキストの折り返しモードをデフォルトのNoWrap 以外の値に設定してください。オプションのmaxWidth パラメータのデフォルト値は0 です。つまり、例えばWordWrap が設定されている場合、テキストは単語ごとに折り返されます。maxWidth パラメータを、希望する行幅（ピクセル単位）に設定します。

これは、QPointF を使用するオーバーロードされたメソッドです。

setTextAlign()、setTextBaseline()、およびsetTextWrapMode()も参照してください 。

QTransform QCanvasPainter::getTransform() const

現在のトランスフォームを返します。

void QCanvasPainter::lineTo(qreal x, qreal y)

パスの最後の点から、(x,y) の点までの線分を追加します。

void QCanvasPainter::lineTo(QPointF point)

パスの最後の点からpoint までの線分を追加します。

void QCanvasPainter::moveTo(qreal x, qreal y)

(x,y) を最初の点として、新しいサブパスを開始します。

void QCanvasPainter::moveTo(QPointF point)

point を最初の点として、新しいサブパスを開始します。

void QCanvasPainter::quadraticCurveTo(qreal cpX, qreal cpY, qreal x, qreal y)

パスの最後の点から、制御点（cpX 、cpY ）を経由して、指定された点（x 、y ）に至る2次ベジエセグメントを追加します。

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

パスの最後の点から、controlPoint を経由して、指定されたendPoint までの2次ベジエセグメントを追加します。

void QCanvasPainter::rect(qreal x, qreal y, qreal width, qreal height)

座標x 、y の位置に、サイズwidth 、height の新しい長方形のサブパスを作成します。

void QCanvasPainter::rect(const QRectF &rect)

rect に、新しい長方形のサブパスを作成します。これは、QRectF を使用したオーバーロードされたメソッドです。

void QCanvasPainter::removeImage(const QCanvasImage &image)

image に関連付けられたリソースを解放し、ペインタから画像を削除します。

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

void QCanvasPainter::removePathGroup(int pathGroup)

pathGroup をペインターキャッシュから削除します。その後、pathGroup に対してfill()またはstroke()を呼び出すと、パスがグループキャッシュに再生成されます。

関連項目： fill() およびstroke()。

void QCanvasPainter::reset()

現在のペインターの状態をデフォルト値にリセットします。

これには、ストロークおよび塗りつぶしのスタイルと関連するプロパティ、変換行列、クリッピング領域、テキスト関連の設定、合成プロパティ、描画状態スタック、アンチエイリアシング設定が含まれます。

save() およびrestore()も参照してください 。

void QCanvasPainter::resetClipping()

クリッピングをリセットし、無効にします。

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

void QCanvasPainter::resetTransform()

現在の変換を単位行列にリセットします。

void QCanvasPainter::restore()

現在のレンダリング状態をポップして復元します。これにより、以前に保存された状態が復元されます。save() が呼び出されておらず、状態スタックが空の場合、これを呼び出しても何もしません。

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

void QCanvasPainter::rotate(qreal angle)

現在の座標系をangle だけ時計回りに回転させます。

角度はラジアン単位で指定します。度からラジアンへの変換には、qDegreesToRadians() を使用してください。

void QCanvasPainter::roundRect(qreal x, qreal y, qreal width, qreal height, qreal radius)

座標x 、y の位置に、サイズwidth 、height の新しい角丸長方形のサブパスを作成します。角の丸み半径はradius になります。

void QCanvasPainter::roundRect(const QRectF &rect, qreal radius)

rect の位置に、radius の角を持つ新しい角丸長方形のサブパスを作成します。これは、QRectF を使用したオーバーロードされたメソッドです。

void QCanvasPainter::roundRect(const QRectF &rect, qreal radiusTopLeft, qreal radiusTopRight, qreal radiusBottomRight, qreal radiusBottomLeft)

rect で、角が丸い新しい長方形形状のサブパスを作成します。角の丸み具合は、radiusTopLeft 、radiusTopRight 、radiusBottomRight 、radiusBottomLeft のように、角ごとに異なる設定が可能です。

void QCanvasPainter::roundRect(qreal x, qreal y, qreal width, qreal height, qreal radiusTopLeft, qreal radiusTopRight, qreal radiusBottomRight, qreal radiusBottomLeft)

位置x 、y に、サイズwidth 、height の新しい角丸長方形形状のサブパスを作成します。角の丸み具合は、radiusTopLeft 、radiusTopRight 、radiusBottomRight 、radiusBottomLeft のように、角ごとに異なる設定が可能です。

void QCanvasPainter::save()

現在のレンダリング状態をステートスタックにプッシュして保存します。状態を復元するには、対応するrestore()を使用する必要があります。

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

void QCanvasPainter::scale(qreal scale)

現在の座標系をscale の倍率で拡大・縮小します。x座標とy座標は均等に拡大・縮小されます。

void QCanvasPainter::scale(qreal scaleX, qreal scaleY)

現在の座標系を、scaleX およびscaleY によって拡大・縮小します。

void QCanvasPainter::setAntialias(qreal antialias)

現在のアンチエイリアシングの量を、ピクセル単位でantialias に設定します。アンチエイリアシングの値が大きいほど、描画は滑らかになります。これは塗りや線の描画にのみ影響し、画像やテキストには影響しません。デフォルト値は1.0 で、最大値は10.0 です。

アンチエイリアシングはパスごとに変更できるため、各ストロークや塗りつぶしの前に設定することができます。アンチエイリアシングを無効にしてレンダリングコストを削減するには、アンチエイリアシングを0 に設定してください。

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

void QCanvasPainter::setClipRect(qreal x, qreal y, qreal width, qreal height)

現在のクリッピング矩形を (x,y,width,height) に設定します。クリッピング矩形は、現在のトランスフォームによって変形されます。

関連項目： resetClipping()。

void QCanvasPainter::setClipRect(const QRectF &rect)

現在のシザー矩形を `rect` に設定します。シザー矩形は、現在のトランスフォームによって変換されます。

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

[since 6.12] void QCanvasPainter::setFillRule(QCanvasPainter::FillRule fillRule)

パス塗りつぶしルールを `fillRule` に設定します。この値は、ルールが設定された後のすべての `fill()` 呼び出しに適用されます。デフォルトの塗りつぶしルールはQCanvasPainter::FillRule::NonZero

この関数は Qt 6.12 で導入されました。

void QCanvasPainter::setFillStyle(QColor color)

塗りつぶしのスタイルをcolor に設定します。デフォルトの塗りつぶしスタイルは、黒一色（0, 0, 0, 1）です。

void QCanvasPainter::setFillStyle(const QCanvasBrush &brush)

塗りつぶしのスタイルを「brush 」に設定します。デフォルトの塗りつぶしスタイルは、黒の一色塗り（0, 0, 0, 1）です。

void QCanvasPainter::setFont(const QFont &font)

font を現在アクティブなフォントとして設定します。

void QCanvasPainter::setGlobalAlpha(qreal alpha)

グローバルなアルファ（透明度）値をalpha に設定します。このアルファ値は、レンダリングされるすべての図形に適用されます。すでに透明なパスも、比例してさらに透明になります。アルファ値は0.0（完全に透明）から1.0（完全に不透明）の間で指定する必要があります。デフォルトのアルファ値は1.0 です。

void QCanvasPainter::setGlobalBrightness(qreal value)

グローバルな明るさをvalue に設定します。この明るさは、レンダリングされるすべての図形に適用されます。値を0に設定すると、描画は完全に黒になります。また、値を1.0より大きく設定することで、明るさを上げることができます。デフォルトの明るさは1.0 です。

void QCanvasPainter::setGlobalCompositeOperation(QCanvasPainter::CompositeOperation operation)

グローバルな合成モードを「operation 」に設定します。このモードは、すべての描画操作に適用されます。デフォルトのモードは「QCanvasPainter::CompositeOperation::SourceOver 」です。

void QCanvasPainter::setGlobalContrast(qreal value)

グローバルなコントラストをvalue に設定します。このコントラストは、レンダリングされるすべての図形に適用されます。値を0に設定すると、描画結果は完全に灰色（0.5, 0.5, 0.5）になります。コントラストを高めるために、値を1.0より大きくすることも可能です。デフォルトでは、コントラストは1.0 に設定されています。

void QCanvasPainter::setGlobalSaturation(qreal value)

グローバルな彩度をvalue に設定します。この彩度は、レンダリングされるすべての図形に適用されます。値を0にすると彩度が無効になり、描画は完全にグレースケールになります。彩度を高めるために、値を1.0より大きくすることもできます。デフォルトの彩度は1.0 です。

void QCanvasPainter::setHighQualityStroking(bool enabled)

高品質なストロークをenabled に設定します。これをtrue に設定すると、ストロークが重なり合い、不透明度が完全ではないといった、あまり一般的ではないケースにおいて、より正確なレンダリングが行われます。これを有効にすると、レンダリングコストが高くなります。デフォルト値はfalse です。

void QCanvasPainter::setLineCap(QCanvasPainter::LineCap cap)

ストロークの線の終端を「cap 」に設定します。デフォルトの線の端は「QCanvasPainter::LineCap::Butt 」です。

void QCanvasPainter::setLineJoin(QCanvasPainter::LineJoin join)

ストロークの線接合を「join 」に設定します。デフォルトの線接合は「QCanvasPainter::LineJoin::Miter 」です。

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

void QCanvasPainter::setLineWidth(qreal width)

ストロークの線幅をwidth ピクセルに設定します。デフォルトの線幅は1.0 です。アンチエイリアシングが有効になっている場合、1ピクセルより細い線幅では不透明度が自動的にフェードされ、滑らかな出力が得られます。

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

void QCanvasPainter::setMiterLimit(qreal limit)

マイター制限をlimit に設定します。マイター制限は、鋭角な角がいつ面取りされるかを制御します。角の長さがこの制限値を超える場合、代わりに線と線の間にQCanvasPainter::LineJoin::Bevel が適用されます。これは、QCanvasPainter::LineJoin::Miter の線接続方式でのみ有効です。デフォルトの制限値は10.0 です。

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

void QCanvasPainter::setPathWinding(QCanvasPainter::PathWinding winding)

現在のサブパス「winding 」を「CounterClockWise 」（デフォルト）または「ClockWise 」のいずれかに設定します。「CounterClockWise 」は実線のサブパスを描画し、「ClockWise 」は穴を描画します。

beginHoleSubPath() およびbeginSolidSubPath()も参照してください 。

void QCanvasPainter::setStrokeStyle(QColor color)

ストロークのスタイルをcolor の塗りつぶしに設定します。デフォルトのストロークスタイルは、黒（0, 0, 0, 1）の塗りつぶしです。

void QCanvasPainter::setStrokeStyle(const QCanvasBrush &brush)

ストロークのスタイルをbrush に設定します。デフォルトのストロークスタイルは、黒の実線 (0, 0, 0, 1) です。

void QCanvasPainter::setTextAlign(QCanvasPainter::TextAlign align)

テキストの水平方向の配置をalign に設定します。デフォルトの配置はQCanvasPainter::TextAlign::Start です。

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

void QCanvasPainter::setTextAntialias(qreal antialias)

現在のテキストのアンチエイリアシング量を設定します。値「antialias 」は通常のアンチエイリアシングに対する倍率を表しており、つまり「0.0 」はアンチエイリアシングを無効にし、「2.0」はアンチエイリアシング効果を2倍にします。デフォルト値は1.0です。

void QCanvasPainter::setTextBaseline(QCanvasPainter::TextBaseline baseline)

テキストの垂直方向の配置（ベースライン）をbaseline に設定します。デフォルトの配置はQCanvasPainter::TextBaseline::Alphabetic です。

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

void QCanvasPainter::setTextDirection(QCanvasPainter::TextDirection direction)

テキストの方向をdirection に設定します。デフォルトの方向はQCanvasPainter::TextDirection::Inherit です。

void QCanvasPainter::setTextLineHeight(qreal height)

改行されるテキストの行高さを、ピクセル単位でheight に設定します。デフォルトの行高さは0 です。

void QCanvasPainter::setTextWrapMode(QCanvasPainter::WrapMode wrapMode)

テキストの折り返しモードを「wrapMode 」に設定します。デフォルトの折り返しモードは「QCanvasPainter::WrapMode::NoWrap 」です。

void QCanvasPainter::setTransform(const QTransform &transform)

現在の変換をリセットし、代わりにtransform を使用します。

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

void QCanvasPainter::setWindingEnforce(bool enabled)

ワインディングの強制設定をenabled に設定します。これをfalse に設定すると、setPathWinding()で設定された内容に合わせてパスのワインディングを強制する機能が無効になります。この機能を無効にすると、例えば、点を時計回りの順序で追加することでパスに穴を開けることが可能になります。また、無効にすることでパフォーマンスが向上する場合もあります。デフォルト値はtrue です。

void QCanvasPainter::skew(qreal angleX, qreal angleY = 0.0)

現在の座標系を、X軸方向にangleX 、Y軸方向にangleY だけ傾斜（せん断）させます。角度はラジアン単位で指定します。

void QCanvasPainter::stroke()

現在のストロークスタイルで、現在のパスを描画します。

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

void QCanvasPainter::stroke(const QCanvasPath &path, int pathGroup = -1)

path に対して、現在の描画スタイルで描画を行い、pathGroup に格納します。QCanvasPath による描画は、パスに含まれるコマンドが多く、かつその大部分が静的な場合に最適です。

pathGroup が-1 の場合、パスのレンダリング関連データはキャッシュされません。これがデフォルトの設定です。パスデータのキャッシュを要求するには、0 以上の値を指定してください。パスキャッシュグループの使用に関する詳細については、QCanvasPath のドキュメントを参照してください。

このメソッドを呼び出す前にbeginPath() を呼び出す必要はありません。

setStrokeStyle() およびremovePathGroup()も参照してください 。

void QCanvasPainter::strokeRect(qreal x, qreal y, qreal width, qreal height)

指定された位置（x 、y ）に、サイズwidth 、height の線画付き矩形を描画します。

void QCanvasPainter::strokeRect(const QRectF &rect)

rect に線画の矩形を描画します。これは、QRectF を使用したオーバーロードされたメソッドです。

QRectF QCanvasPainter::textBoundingBox(const QString &text, qreal x, qreal y, qreal maxWidth = 0) const

(x,y) における `text ` 文字列のバウンディングボックスを測定します。

複数行のテキストを測定するには、setTextWrapMode() を使用して、テキストの折り返しモードをデフォルトの `NoWrap` 以外の値に設定してください。また、オプションの `maxWidth ` パラメータを、希望する行幅（ピクセル単位）に設定してください。

QRectF を [xmin, ymin, width, height] の値で返します。測定値はローカル座標系で返されます。

QRectF QCanvasPainter::textBoundingBox(const QString &text, const QRectF &rect) const

rect にある `text ` 文字列のバウンディングボックスを測定します。値 [xmin, ymin, width, height] を含む `QRectF ` を返します。測定値はローカル座標系で返されます。

QRectF QCanvasPainter::textBoundingBox(const QString &text, QPointF point, qreal maxWidth = 0) const

point にある「text 」文字列のバウンディングボックスを測定します。

複数行のテキストを測定するには、setTextWrapMode() を使用して、テキストの折り返しモードをデフォルトのNoWrap 以外の値に設定してください。また、オプションのmaxWidth パラメータを、希望する行幅（ピクセル単位）に設定してください。

QRectF を、値 [xmin, ymin, width, height] として返します。測定値はローカル座標系で返されます。

void QCanvasPainter::transform(const QTransform &transform)

現在の座標系に、指定されたtransform を乗算します。

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

void QCanvasPainter::translate(qreal x, qreal y)

現在の座標系を、x およびy によって変換します。

void QCanvasPainter::translate(QPointF point)

現在の座標系をpoint だけ並進させます。