QRhiRenderPassDescriptor Class

Dokumentation der Mitgliedsfunktionen

[pure virtual] bool QRhiRenderPassDescriptor::isCompatible(const QRhiRenderPassDescriptor *other) const

Gibt true zurück, wenn die other QRhiRenderPassDescriptor mit dieser kompatibel ist, d.h. this und other können in QRhiGraphicsPipeline::setRenderPassDescriptor() abwechselnd verwendet werden.

Das Konzept der Kompatibilität von Renderpass-Deskriptoren ist ähnlich wie das layout compatibility von QRhiShaderResourceBindings Instanzen. Sie ermöglichen eine bessere Wiederverwendung von QRhiGraphicsPipeline Instanzen: zum Beispiel wird erwartet, dass ein QRhiGraphicsPipeline Instanz-Cache diese Funktionen verwendet, um nach einer passenden Pipeline zu suchen, anstatt nur Zeiger zu vergleichen, so dass ein anderes QRhiRenderPassDescriptor und QRhiShaderResourceBindings in Kombination mit der Pipeline verwendet werden kann, solange sie kompatibel sind.

Die genauen Details der Kompatibilität hängen von der zugrunde liegenden Grafik-API ab. Zwei Renderpass-Deskriptoren created von derselben QRhiTextureRenderTarget sind immer kompatibel.

Ähnlich wie bei QRhiShaderResourceBindings kann die Kompatibilität auch getestet werden, ohne dass zwei vorhandene Objekte verfügbar sind. Das Extrahieren des opaken Blob durch den Aufruf von serializedFormat() ermöglicht das Testen der Kompatibilität durch den Vergleich des zurückgegebenen Vektors mit einem anderen QRhiRenderPassDescriptor's serializedFormat(). Dies ist in bestimmten Situationen von Vorteil, da die Kompatibilität eines QRhiRenderPassDescriptor mit einem QRhiGraphicsPipeline auch dann getestet werden kann, wenn das QRhiRenderPassDescriptor, mit dem die Pipeline ursprünglich erstellt wurde, nicht mehr verfügbar ist (aber die von serializedFormat() zurückgegebenen Daten noch vorhanden sind).

Siehe auch newCompatibleRenderPassDescriptor() und serializedFormat().

[virtual] const QRhiNativeHandles *QRhiRenderPassDescriptor::nativeHandles()

Gibt einen Zeiger auf eine Backend-spezifische QRhiNativeHandles Unterklasse zurück, wie z.B. QRhiVulkanRenderPassNativeHandles. Der zurückgegebene Wert ist nullptr, wenn die zugrundeliegenden nativen Ressourcen vom Backend nicht unterstützt werden.

Siehe auch QRhiVulkanRenderPassNativeHandles.

[pure virtual] QRhiRenderPassDescriptor *QRhiRenderPassDescriptor::newCompatibleRenderPassDescriptor() const

Gibt ein neues QRhiRenderPassDescriptor zurück, das mit diesem compatible identisch ist.

Mit dieser Funktion kann ein QRhiRenderPassDescriptor geklont werden. Das zurückgegebene Objekt ist einsatzbereit, und das Eigentum geht auf den Aufrufer über. Das Klonen eines QRhiRenderPassDescriptor -Objekts kann in Situationen nützlich sein, in denen das Objekt in Datenstrukturen gespeichert ist, die mit Grafikpipelines zusammenhängen (um die Erstellung neuer Pipelines zu ermöglichen, die wiederum ein Renderpass-Deskriptor-Objekt erfordern), und die Lebensdauer des Renderpass-Deskriptors, der von einem Rendering-Ziel erstellt wird, kürzer sein kann als die der Pipelines. (z.B. weil die Engine Renderpasses zusammen mit den Texturen und Rendertargets, aus denen sie erstellt wurden, verwaltet und vernichtet) In einer solchen Situation kann es von Vorteil sein, eine geklonte Version in den Datenstrukturen zu speichern und damit auch die Eigentumsrechte zu übertragen.

Siehe auch isCompatible().

[override virtual] QRhiResource::Type QRhiRenderPassDescriptor::resourceType() const

Reimplements: QRhiResource::resourceType() const.

Gibt den Ressourcentyp zurück.

[pure virtual] QVector<quint32> QRhiRenderPassDescriptor::serializedFormat() const

Gibt einen Vektor von Ganzzahlen zurück, der einen undurchsichtigen Blob enthält, der die für compatibility relevanten Daten beschreibt.

Bei zwei QRhiRenderPassDescriptor Objekten rp1 und rp2 gilt: Sind die von dieser Funktion zurückgegebenen Daten identisch, dann gilt auch rp1->isCompatible(rp2) und umgekehrt.

Siehe auch isCompatible().