QCanvasRhiPaintDriver Class

メンバ関数ドキュメント

void QCanvasRhiPaintDriver::beginPaint(QCanvasOffscreenCanvas &canvas, QRhiCommandBuffer *cb, QCanvasRhiPaintDriver::BeginPaintFlags flags = {})

指定されたオフスクリーンcanvas にペイントを開始し、コマンドバッファcb にレンダリングコマンドを記録する。

クリアはfill color set on the canvas で行われます。ただし、QCanvasOffscreenCanvas::Flag::PreserveContents フラグが設定されている場合はクリアされず、canvas の内容が保持されます（GPU アーキテクチャによってはパフォーマンスが低下する可能性があります）。

flags は、レンダリングを制御するオプションのフラグを指定します。

void QCanvasRhiPaintDriver::beginPaint(QRhiCommandBuffer *cb, QRhiRenderTarget *rt, const QMatrix4x4 &matrix, QCanvasRhiPaintDriver::BeginPaintFlags flags = {})

レンダーターゲットrt にペイントを開始し、コマンドバッファcb にレンダリングコマンドを記録する。

このオーバーロードは、頂点の変換に使用されるカスタムmatrix 。この行列は、座標がピクセル単位で与えられる頂点を扱うのに適したものでなければなりません。一般的な使用例としては、QSGRenderNode サブクラス内でQCanvasPainter-pased レンダリングを実装する際に、Qt Quick の modelview-projection 行列を渡すことが挙げられます。

ビューポートのサイズとデバイスのピクセル比率は、レンダーターゲットから取得されます。

実際には、フラグEndPaintFlag::DoNotRecordRenderPass が設定されたendPaint() が続くことが期待されるため、このオーバーロードは塗りつぶし色を取りません。

flags は、レンダリングを制御するオプションのフラグを指定します。

void QCanvasRhiPaintDriver::beginPaint(QRhiCommandBuffer *cb, QRhiRenderTarget *rt, const QColor &fillColor = Qt::black, QSize logicalSize = QSize(), float dpr = 1.0f, QCanvasRhiPaintDriver::BeginPaintFlags flags = {})

レンダーターゲットrt にペイントを開始し、コマンドバッファcb にレンダリングコマンドを記録する。

fillColor は、カラーバッファのクリアに使用する色を指定します。endPaint() のフラグにEndPaintFlag::DoNotRecordRenderPass が含まれている場合、この値は無視される。

logicalSize はオプションです。空でない場合、ビューポートサイズを論理単位で指定します。dpr 、logicalSize を内部でピクセルに変換できるように、スケールファクター（デバイスのピクセル比）を指定する必要があります。実際には、レンダーターゲットのサイズがデフォルトで自動的に使用されるため、この指定が必要になることはほとんどありません。

flags は、レンダリングを制御するオプションのフラグを指定します。

void QCanvasRhiPaintDriver::endPaint(QCanvasRhiPaintDriver::EndPaintFlags flags = {})

QCanvasPainter 描画コマンドによって生成されたすべてのQRhi レンダリングをフラッシュし、記録します。

デフォルトでは、この関数は完全なレンダリングパスを記録します。つまり、内部的にQRhiCommandBuffer::beginPass() とQRhiCommandBuffer::endPass() を呼び出します。クリアカラーは、beginPaint() の fillColor 引数、またはオフスクリーンキャンバスの塗りつぶしカラーで指定します。

flags endPaint()がbeginPass()-endPass()シーケンス全体を発行するのは望ましくない場合があるためです。

次の2つのスニペットは、結果に関しては同じですが、アプリケーションが同じレンダーパスの中でより多くのことを行いたい場合に備えて、2番目のスニペットはより柔軟性を提供します：

pd->beginPaint(cb, rt, Qt::black);
// painter->...
pd->endPaint();

pd->beginPaint(cb, rt);
// painter->...
pd->endPaint(QCanvasRhiPaintDriver::EndPaintFlag::DoNotRecordRenderPass);

cb->beginPass(rt, Qt::black, { 1.0f, 0 });
pd->renderPaint();
cb->endPass();

beginPaint() とrenderPaint()も参照してください 。

void QCanvasRhiPaintDriver::grabCanvas(const QCanvasOffscreenCanvas &canvas, std::function<void (const QImage &)> callback)

canvas に対してテクスチャのリードバック要求を発行します。

callback この関数は、QRhi と 3D API の実装に応じて、関数が戻る前に呼び出されるか、後に呼び出されます。テクスチャコンテンツのリードバックは、GPU アーキテクチャによっては GPU->CPU コピーを伴う場合があります。

この関数は、beginPaint （）-endPaint （）ブロック内でも、外でも呼び出すことができます。外部で呼び出された場合、内部的にQRhi::beginOffscreenFrame() などが呼び出され、いつでもグラブを実行できるようになります。

void QCanvasRhiPaintDriver::renderPaint()

QCanvasPainter 描画コマンドによって生成されたすべてのQRhi レンダリングを記録する。この関数は、DoNotRecordRenderPass とともにendPaint() が呼び出された場合にのみ呼び出される。それ以外の場合は呼び出してはならない。

この関数が呼び出されたとき、関連するQRhi はレンダーパスを記録していなければならない。

endPaint()も参照 。

void QCanvasRhiPaintDriver::resetForNewFrame()

ペインターエンジンの状態をリセットします。この関数は、通常QRhi::beginFrame() やQRhi::beginOffscreenFrame() の後に、新しいフレームを開始するときに一度だけ呼び出されます。