QCanvasRhiPaintDriver Class

Dokumentation der Mitgliedsfunktionen

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

Beginnt mit dem Malen auf dem angegebenen Offscreen canvas und zeichnet Rendering-Befehle in den Befehlspuffer cb auf.

Das Löschen erfolgt mit dem fill color set on the canvas, es sei denn, das QCanvasOffscreenCanvas::Flag::PreserveContents Flag ist gesetzt. In diesem Fall erfolgt kein Löschen und der Inhalt der Leinwand bleibt erhalten (mit möglichen Auswirkungen auf die Leistung, abhängig von der zugrunde liegenden GPU-Architektur).

flags gibt die optionalen Flags an, die das Rendering steuern.

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

Beginnt mit dem Malen auf das Rendering-Ziel rt und zeichnet Rendering-Befehle im Befehlspuffer cb auf.

Diese Überladung nimmt eine benutzerdefinierte matrix, die verwendet wird, um die Scheitelpunkte zu transformieren. Die Matrix muss geeignet sein, um mit Scheitelpunkten umzugehen, deren Koordinaten in Pixeln angegeben sind. Ein üblicher Anwendungsfall ist die Übergabe der Modellansichtsprojektionsmatrix von Qt Quick bei der Implementierung des QCanvasPainter-basierten Renderings innerhalb einer QSGRenderNode Unterklasse.

Die Größe des Ansichtsfensters und das Pixelverhältnis des Geräts werden aus dem Rendering-Ziel übernommen.

Diese Überladung nimmt keine Füllfarbe an, da in der Praxis erwartet wird, dass sie von einem endPaint() mit gesetztem Flag EndPaintFlag::DoNotRecordRenderPass gefolgt wird.

flags gibt die optionalen Flags an, die das Rendering steuern.

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

Beginnt mit dem Malen auf dem Rendering-Ziel rt und zeichnet Rendering-Befehle in den Befehlspuffer cb auf.

fillColor gibt die Farbe an, die zum Löschen des Farbpuffers verwendet wird. Dieser Wert wird ignoriert, wenn die Flags für endPaint() EndPaintFlag::DoNotRecordRenderPass enthalten.

logicalSize ist optional. Wenn er nicht leer ist, gibt er die Größe des Ansichtsfensters in logischen Einheiten an. dpr muss dann den Skalierungsfaktor (Gerätepixelverhältnis) angeben, damit logicalSize intern in Pixel umgerechnet werden kann. In der Praxis wird dies selten nötig sein, da die Größe des Rendering-Ziels standardmäßig automatisch verwendet wird.

flags gibt die optionalen Flags an, die das Rendering steuern.

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

Spült und zeichnet das gesamte QRhi Rendering auf, das von den QCanvasPainter Zeichenbefehlen erzeugt wird.

Standardmäßig zeichnet diese Funktion einen vollständigen Rendering-Durchgang auf, d.h. sie ruft intern QRhiCommandBuffer::beginPass() und QRhiCommandBuffer::endPass() auf. Die klare Farbe wird durch das fillColor-Argument von beginPaint() oder durch die Füllfarbe der Offscreen-Leinwand festgelegt.

flags kann verwendet werden, um die Aufzeichnung eines Rendering-Durchgangs zu steuern, da es in manchen Fällen nicht wünschenswert ist, dass endPaint() eine komplette beginPass() - endPass() Sequenz ausgibt.

Die folgenden beiden Schnipsel sind hinsichtlich der Ergebnisse identisch, aber der zweite bietet mehr Flexibilität, falls die Anwendung innerhalb desselben Rendering-Durchgangs mehr tun möchte:

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();

Siehe auch beginPaint() und renderPaint().

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

Stellt eine Texturrückleseanforderung für canvas.

callback wird entweder vor der Rückkehr der Funktion oder später aufgerufen, abhängig von der zugrunde liegenden QRhi und der 3D-API-Implementierung. Das Zurücklesen von Texturinhalten kann je nach GPU-Architektur eine GPU->CPU-Kopie beinhalten.

Diese Funktion kann sowohl innerhalb eines beginPaint() - endPaint() Blocks als auch außerhalb aufgerufen werden. Wenn sie außerhalb aufgerufen wird, ruft sie intern QRhi::beginOffscreenFrame() usw. auf, so dass Grabs zu jeder Zeit durchgeführt werden können.

void QCanvasRhiPaintDriver::renderPaint()

Zeichnet alle QRhi Renderings auf, die durch die QCanvasPainter Zeichenbefehle erzeugt wurden. Rufen Sie diese Funktion nur auf, wenn endPaint() mit DoNotRecordRenderPass aufgerufen wurde. Sie darf sonst nicht aufgerufen werden.

Die zugehörige QRhi muss einen Rendering-Durchgang aufzeichnen, wenn diese Funktion aufgerufen wird.

Siehe auch endPaint().

void QCanvasRhiPaintDriver::resetForNewFrame()

Setzt den Zustand der Malmaschine zurück. Es wird erwartet, dass diese Funktion einmal beim Start eines neuen Frames aufgerufen wird, normalerweise nach QRhi::beginFrame() oder QRhi::beginOffscreenFrame().