QCanvasPainterItemRenderer Class

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

QCanvasPainterItemRenderer::QCanvasPainterItemRenderer()

QCanvasPainterItemRenderer を生成します。

[override virtual noexcept] QCanvasPainterItemRenderer::~QCanvasPainterItemRenderer()

QCanvasPainterItemRenderer を削除します。

[protected] void QCanvasPainterItemRenderer::beginCanvasPainting(QCanvasOffscreenCanvas &canvas)

canvas を対象としたQCanvasPainter の描画コマンドの記録を開始します。

prePaint() から戻る前に、beginCanvasPainting() の後には必ず対応するendCanvasPainting() が続く必要があります。

[protected] void QCanvasPainterItemRenderer::endCanvasPainting()

beginCanvasPainting() で指定されたキャンバスを対象とする描画の終了を示します。

beginCanvasPainting prePaint() から戻る前に、() の後には必ず対応する endCanvasPainting() を呼び出す必要があります。

QColor QCanvasPainterItemRenderer::fillColor() const

アイテムの現在の塗りつぶし色を返します。これは、親のQCanvasPainterItem によって設定できます。

[protected] template <typename Functor> void QCanvasPainterItemRenderer::grabCanvas(const QCanvasOffscreenCanvas &canvas, const QObject *context, Functor &&callback)

canvas に対してテクスチャの読み出しリクエストを発行し、これをcontext と関連付けます。

callback この関数は、基盤となるQRhi および3D APIの実装に応じて、関数が戻る前、あるいはそれ以降に、レンダリングスレッド上で呼び出されます。テクスチャ内容の読み出しには、GPUアーキテクチャによってはGPU→CPU間のコピーが含まれる場合があります。この関数は単一のconst QImage & 引数を取り、移動専用を含む任意のファンクタを指定できます。

読み込みが完了する前にcontext が破棄された場合、グラブはキャンセルされ、callback は呼び出されません。これにより、コールバックが、保留中の読み込みよりも短命となる可能性のあるオブジェクトを参照しても安全になります。

たとえば、以下のコードは、画面外にあるキャンバスの内容をPNGファイルに保存します：

grabCanvas(offscreenCanvas, item, [](const QImage &image) {
    image.save("result.png");
});

bool QCanvasPainterItemRenderer::hasSharedPainter() const

このアイテムレンダラーが共有ペインターを使用している場合、true を返します。

setSharedPainterも参照してください 。

qreal QCanvasPainterItemRenderer::height() const

描画された領域の高さを、論理単位で、scale factor (device pixel ratio) を除いて返します。QQuickRhiItem::fixedColorBufferHeight が設定されていない限り、これは通常、ペインター項目のheight と同じ値になります。

[override virtual protected] void QCanvasPainterItemRenderer::initialize(QRhiCommandBuffer *cb)

QQuickRhiItemRenderer::initialize(QRhiCommandBuffer *cb) を再実装します。

[virtual protected] void QCanvasPainterItemRenderer::initializeResources(QCanvasPainter *painter)

painter を使用してリソースを初期化するために、このメソッドを再実装してください。このメソッドは、最初のsynchronizeData() が呼び出される前に1 回呼び出されます。

QCanvasPainter::addImage およびQCanvasPainter::createCanvasも参照してください 。

[virtual protected] void QCanvasPainterItemRenderer::paint(QCanvasPainter *painter)

painter を使用して描画を行うよう、このメソッドを再実装してください。

このメソッドは、fillColor() によってアイテムが塗りつぶされた後に呼び出されます。

paint() はレンダラースレッドから呼び出されます。アイテムのデータに安全にアクセスするには、synchronizeData() 内でデータをコピーしてください。

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

QCanvasPainter *QCanvasPainterItemRenderer::painter() const

このペインター項目に関連付けられているペインターを返します。

[virtual protected] void QCanvasPainterItemRenderer::prePaint(QCanvasPainter *painter)

この関数は、painter を使用してレンダリングを開始する際、paint() の前に呼び出されます。

この関数が呼び出される時点では、アクティブなレンダリングターゲットは存在しません。オフスクリーンキャンバスへの描画を初期化するには、beginCanvasPainting() を呼び出してください。

beginCanvasPainting() およびendCanvasPainting()も参照してください 。

[override virtual protected] void QCanvasPainterItemRenderer::render(QRhiCommandBuffer *cb)

QQuickRhiItemRenderer::render(QRhiCommandBuffer *cb) の再実装です。

void QCanvasPainterItemRenderer::setSharedPainter(bool enable)

enable がfalse の場合、ペインター共有を無効にしてください。

ペインター共有はデフォルトで有効になっています。

ペインター共有が有効になっている場合、同じQQuickWindow 内のすべてのペインター項目は、同じQCanvasPainter を使用します。

ペインター共有を無効にしたい場合は、この関数を十分に早い段階で、たとえば派生クラスのコンストラクタなどから呼び出す必要があります。アイテムがペイント用にすでに初期化されてしまった後で変更しても、効果はありません。

2 つのアイテムが、共有されていない専用のペインターを使用している場合、QCanvasImage や QOffscreenCanvas を裏打ちするグラフィックリソースなど、互いのグラフィックリソースは互いに表示されません。一方、アイテムが同じウィンドウ内にあり、共有が有効になっている場合は、両方が同じQCanvasPainter を使用するため、一方のアイテムが作成した画像やキャンバスを他方のアイテムで使用することができます。

「hasSharedPainter」も参照してください 。

[override virtual protected] void QCanvasPainterItemRenderer::synchronize(QQuickRhiItem *item)

QQuickRhiItemRenderer::synchronize(QQuickRhiItem *item) を再実装します。

[virtual protected] void QCanvasPainterItemRenderer::synchronizeData(QCanvasPainterItem *item)

item とアイテム・ペインターのインスタンス間のデータを同期させるために、このメソッドを再実装してください。これは、アイテムの再描画が必要になるたびに、paint() の前に呼び出されます。

このメソッドは、ペインターとアイテムが互いの変数を読み書きしても安全な唯一の場所です。

通常は、item を実際のアイテム型に static_cast してから、データを交換するようにしてください。

qreal QCanvasPainterItemRenderer::width() const

描画領域の幅を、論理単位で、scale factor (device pixel ratio) を除いて返します。QQuickRhiItem::fixedColorBufferWidth が設定されていない限り、これは通常、ペインター項目のwidth と同じ値になります。