QCanvasRhiPaintDriver Class

Dokumentation der Mitgliedsfunktionen

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

Beginnt mit dem Zeichnen auf die angegebene Offscreen- canvas und zeichnet die Rendering-Befehle in den Befehlspuffer cb auf.

Das Löschen erfolgt über den „ fill color set on the canvas “, es sei denn, das Flag „ QCanvasOffscreenCanvas::Flag::PreserveContents “ ist gesetzt; in diesem Fall findet kein Löschen statt 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 Zeichnen auf das Renderziel rt und zeichnet die Renderbefehle in den Befehlspuffer cb auf.

Diese Überladung akzeptiert eine benutzerdefinierte ` matrix`, die zur Transformation der Scheitelpunkte verwendet wird. Die Matrix muss für Scheitelpunkte geeignet sein, deren Koordinaten in Pixeln angegeben sind. Ein häufiger Anwendungsfall ist die Übergabe der `modelview-projection`-Matrix von ` Qt Quick` bei der Implementierung von ` QCanvasPainter`-basiertem Rendering innerhalb einer Unterklasse von ` QSGRenderNode `.

Die Größe des Ansichtsfensters und das Gerätepixelverhältnis werden aus dem Renderziel übernommen.

Diese Überladung akzeptiert keine Füllfarbe, da in der Praxis davon ausgegangen wird, dass anschließend ein Aufruf von ` endPaint()` mit gesetztem Flag ` EndPaintFlag::DoNotRecordRenderPass ` folgt.

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

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

Beginnt mit dem Zeichnen auf das Renderziel rt und speichert dabei die Renderbefehle im Befehlspuffer cb.

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

logicalSize ist optional. Ist der Wert nicht leer, 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 benötigt, da standardmäßig automatisch die Größe des Renderziels verwendet wird.

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

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

Leert den Puffer und zeichnet alle von den Zeichnungsbefehlen „ QCanvasPainter “ erzeugten „ QRhi “-Renderings auf.

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

flags kann verwendet werden, um die Aufzeichnung eines Render-Passes zu steuern, da es in manchen Fällen nicht wünschenswert ist, dass endPaint() eine vollständige beginPass()-endPass()-Sequenz auslöst.

Die folgenden beiden Codeausschnitte liefern identische Ergebnisse, doch der zweite bietet mehr Flexibilität, falls die Anwendung innerhalb desselben Render-Passes weitere Aufgaben ausführen 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()“.

template <typename Functor> void QCanvasRhiPaintDriver::grabCanvas(const QCanvasOffscreenCanvas &canvas, const QObject *context, Functor &&callback)

Gibt eine Anforderung zum Zurücklesen einer Textur für „ canvas “ aus und ordnet diese „ context “ zu.

callback wird entweder vor der Rückgabe der Funktion oder später aufgerufen, abhängig von der zugrunde liegenden Implementierung von ` QRhi ` und der 3D-API. Das Zurücklesen von Texturinhalten kann je nach GPU-Architektur eine Kopie von der GPU zur CPU erfordern. Die Funktion nimmt ein einziges ` const QImage & `-Argument entgegen und kann ein beliebiger Funktor sein, einschließlich solcher, die nur eine Verschiebung zulassen.

Wird ` context ` zerstört, bevor das Zurücklesen abgeschlossen ist, wird der Grab-Vorgang abgebrochen und ` callback ` nicht aufgerufen. Dadurch ist es für den Callback sicher, auf Objekte zu verweisen, die möglicherweise nicht länger bestehen als der noch ausstehende Lesevorgang.

Diese Funktion kann sowohl innerhalb eines „ beginPaint() – endPaint()“-Blocks als auch außerhalb aufgerufen werden. Bei einem Aufruf außerhalb des Blocks ruft sie intern „ QRhi::beginOffscreenFrame()“ usw. auf, wodurch „grabs“ jederzeit durchgeführt werden können.

Beispielsweise würde der folgende Code den Inhalt einer nicht im Bildschirmbereich angezeigten Leinwand in einer PNG-Datei speichern:

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

void QCanvasRhiPaintDriver::renderPaint()

Zeichnet alle durch die Zeichnungsbefehle „ QCanvasPainter “ erzeugten Renderings von „ QRhi “ auf. Rufen Sie diese Funktion nur auf, wenn „ endPaint()“ mit „ DoNotRecordRenderPass “ aufgerufen wurde. Andernfalls darf sie nicht aufgerufen werden.

Das zugehörige ` QRhi ` muss zum Zeitpunkt des Aufrufs dieser Funktion einen Renderdurchlauf aufzeichnen.

Siehe auch endPaint().

void QCanvasRhiPaintDriver::resetForNewFrame()

Setzt den Status der Painter-Engine zurück. Diese Funktion sollte einmal beim Start eines komplett neuen Frames aufgerufen werden, typischerweise nach ` QRhi::beginFrame()` oder ` QRhi::beginOffscreenFrame()`.