QRhiResource Class

Mitgliederfunktion Dokumentation

[virtual noexcept] QRhiResource::~QRhiResource()

Destruktor.

Gibt die zugrundeliegenden nativen Grafikressourcen frei (oder fordert eine verzögerte Freigabe an), sofern welche vorhanden sind.

Siehe auch destroy().

void QRhiResource::deleteLater()

Wenn diese Funktion aufgerufen wird, ohne dass ein Frame aufgezeichnet wurde, ist sie gleichbedeutend mit dem Löschen des Objekts. Zwischen QRhi::beginFrame() und QRhi::endFrame() ist das Verhalten jedoch anders: QRhiResource wird erst zerstört, wenn der Frame über QRhi::endFrame() übermittelt wird, und erfüllt damit die Anforderung von QRhi, QRhiResource Objekte, auf die der aufgezeichnete Frame verweist, nicht zu verändern.

Wenn das QRhi, das dieses Objekt erstellt hat, bereits zerstört ist, wird das Objekt sofort gelöscht.

Die Verwendung von deleteLater() kann in vielen Fällen nützlich sein und ergänzt die Low-Level-Garantie (dass die zugrundeliegenden nativen Grafikobjekte niemals zerstört werden, bis es sicher ist, dies zu tun, und bis mit Sicherheit bekannt ist, dass sie nicht von der GPU in einem noch laufenden Frame verwendet werden), indem sie eine Möglichkeit bietet, sicherzustellen, dass die C++-Objektinstanzen (von QRhiBuffer, QRhiTexture usw.) selbst auch bis zum Ende des aktuellen Frames gültig bleiben.

Das folgende Beispiel zeigt eine bequeme Möglichkeit, einen Wegwerfpuffer zu erstellen, der nur in einem Frame verwendet wird und automatisch mit endFrame() freigegeben wird. (für die zugrundeliegenden nativen Puffer gilt die übliche Garantie: das QRhi Backend schiebt die Freigabe dieser Puffer auf, bis sichergestellt ist, dass der Frame, in dem die GPU auf den Puffer zugreift, abgeschlossen ist)

rhi->beginFrame(swapchain);
QRhiBuffer *buf = rhi->newBuffer(QRhiBuffer::Immutable, QRhiBuffer::VertexBuffer, 256);
buf->deleteLater(); // !
u = rhi->nextResourceUpdateBatch();
u->uploadStaticBuffer(buf, data);
// ... draw with buf
rhi->endFrame();

Siehe auch destroy().

[pure virtual] void QRhiResource::destroy()

Gibt die zugrundeliegenden nativen Grafikressourcen frei (oder fordert deren verzögerte Freigabe an). Sicherer mehrfacher Aufruf, nachfolgende Aufrufe sind dann ein No-op.

Nach dem Aufruf von destroy() kann die Instanz QRhiResource wiederverwendet werden, indem create() erneut aufgerufen wird. Das führt dann dazu, dass darunter neue native Grafikressourcen erzeugt werden.

Der QRhiResource Destruktor erfüllt dieselbe Aufgabe, so dass der Aufruf dieser Funktion vor dem Löschen eines QRhiResource nicht notwendig ist.

Siehe auch deleteLater().

quint64 QRhiResource::globalResourceId() const

Gibt den globalen, eindeutigen Bezeichner dieser QRhiResource zurück.

Der Benutzercode muss sich nur selten direkt mit diesem Wert befassen. Er wird intern zur Verfolgung und Buchführung verwendet.

QByteArray QRhiResource::name() const

Gibt den aktuell eingestellten Objektnamen zurück. Standardmäßig ist der Name leer.

Siehe auch setName().

[pure virtual] QRhiResource::Type QRhiResource::resourceType() const

Gibt den Typ der Ressource zurück.

QRhi *QRhiResource::rhi() const

Gibt die QRhi zurück, die diese Ressource erstellt hat.

Wenn das QRhi, das dieses Objekt erstellt hat, bereits zerstört ist, lautet das Ergebnis nullptr.

void QRhiResource::setName(const QByteArray &name)

Setzt eine name für das Objekt.

Dies ermöglicht es, beschreibende Namen für die nativen Grafikressourcen zu erhalten, die in Grafik-Debugging-Tools wie RenderDoc und XCode sichtbar sind.

Bei der Benennung nativer Objekte durch Weitergabe des Namens über die entsprechende Grafik-API ist zu beachten, dass der Name ignoriert wird, wenn QRhi::DebugMarkers nicht unterstützt wird, und je nach Backend auch ignoriert werden kann, wenn QRhi::EnableDebugMarkers nicht gesetzt ist.

Siehe auch name().