QRhiResource Class

Dokumentation der Member-Funktionen

[protected delete] QRhiResource::QRhiResource(const QRhiResource &)

Erstellt eine Instanz von „ QRhiResource “ durch Kopieren. Diese Funktion wird gelöscht.

[virtual noexcept] QRhiResource::~QRhiResource()

Destruktor.

Gibt die zugrunde liegenden nativen Grafikressourcen frei (oder fordert deren verzögerte Freigabe an), sofern vorhanden.

Siehe auch ` destroy()`.

void QRhiResource::deleteLater()

Wird diese Funktion aufgerufen, ohne dass ein Frame aufgezeichnet wird, entspricht dies dem Löschen des Objekts. Zwischen einem Aufruf von ` QRhi::beginFrame()` und ` QRhi::endFrame()` verhält sich die Funktion jedoch anders: Das ` QRhiResource ` wird erst zerstört, wenn der Frame über ` QRhi::endFrame()` übermittelt wird. Damit wird die Anforderung von ` QRhi ` erfüllt, dass ` QRhiResource `-Objekte, auf die der aufgezeichnete Frame verweist, nicht verändert werden dürfen.

Wenn der „ QRhi “, der dieses Objekt erstellt hat, bereits zerstört wurde, wird das Objekt sofort gelöscht.

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

Das folgende Beispiel zeigt eine bequeme Möglichkeit, einen Einweg-Puffer zu erstellen, der nur in einem Frame verwendet und in `endFrame()` automatisch freigegeben wird. (Was die zugrunde liegenden nativen Puffer betrifft, gilt die übliche Garantie: Das QRhi -Backend verschiebt die Freigabe dieser Puffer so lange, 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 zugrunde liegenden nativen Grafikressourcen frei (oder fordert deren verzögerte Freigabe an). Der Aufruf kann mehrfach sicher erfolgen; nachfolgende Aufrufe haben dann keine Auswirkung.

Sobald `destroy()` aufgerufen wurde, kann die ` QRhiResource `-Instanz wiederverwendet werden, indem ` create() ` erneut aufgerufen wird. Dies führt dann dazu, dass darunter neue native Grafikressourcen erstellt werden.

Der Destruktor von ` QRhiResource ` führt dieselbe Aufgabe aus, sodass der Aufruf dieser Funktion vor dem Löschen eines ` QRhiResource` nicht erforderlich ist.

Siehe auch ` deleteLater()`.

quint64 QRhiResource::globalResourceId() const

Gibt die globale, eindeutige Kennung dieses „ QRhiResource “ zurück.

Der Anwendercode muss sich nur selten direkt mit diesem Wert befassen. Er wird intern zu Nachverfolgungs- und Buchhaltungszwecken verwendet.

QByteArray QRhiResource::name() const

Gibt den aktuell festgelegten 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 das „ QRhi “ zurück, das diese Ressource erstellt hat.

Wenn der „ QRhi “, der dieses Objekt erstellt hat, bereits zerstört wurde, lautet das Ergebnis „ nullptr “.

void QRhiResource::setName(const QByteArray &name)

Legt eine „ name “ für das Objekt fest.

Dadurch lassen sich aussagekräftige Namen für die nativen Grafikressourcen abrufen, 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 werden, und je nach Backend möglicherweise auch ignoriert wird, wenn „ QRhi::EnableDebugMarkers “ nicht gesetzt ist.

Siehe auch name().

[protected delete] QRhiResource &QRhiResource::operator=(const QRhiResource &)

other Weist dieser „ QRhiResource “-Instanz „ “ per Kopierzuweisung zu. Diese Funktion wird gelöscht.