QRhiRenderTarget Class
Stellt ein Onscreen- (Swapchain) oder Offscreen- (Textur) Rendering-Ziel dar. Mehr...
| Kopfzeile: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| Since: | Qt 6.6 |
| Erbt: | QRhiResource |
| Geerbt von: |
Öffentliche Funktionen
| virtual float | devicePixelRatio() const = 0 |
| virtual QSize | pixelSize() const = 0 |
| QRhiRenderPassDescriptor * | renderPassDescriptor() const |
| virtual int | sampleCount() const = 0 |
| void | setRenderPassDescriptor(QRhiRenderPassDescriptor *desc) |
Detaillierte Beschreibung
Anwendungen erzeugen nicht direkt eine Instanz dieser Klasse. Vielmehr ist es die Unterklasse QRhiTextureRenderTarget, die von Clients der API über newTextureRenderTarget() instanziiert werden kann. Die andere Unterklasse ist QRhiSwapChainRenderTarget, die der Typ ist, den QRhiSwapChain beim Aufruf von currentFrameRenderTarget() zurückgibt.
Hinweis: Dies ist eine RHI-API mit begrenzten Kompatibilitätsgarantien, siehe QRhi für Details.
Siehe auch QRhiSwapChainRenderTarget und QRhiTextureRenderTarget.
Dokumentation der Mitgliedsfunktionen
[pure virtual] float QRhiRenderTarget::devicePixelRatio() const
Gibt das Pixelverhältnis des Geräts zurück. Für QRhiTextureRenderTarget ist dies immer 1. Für Ziele, die von einem QRhiSwapChain abgerufen werden, spiegelt der Wert den device pixel ratio des Ziels QWindow wider.
[pure virtual] QSize QRhiRenderTarget::pixelSize() const
Gibt die Größe in Pixel zurück.
Nur gültig, nachdem create() erfolgreich aufgerufen wurde. Bis dahin ist das Ergebnis ein standardmäßig konstruiertes QSize.
Bei QRhiTextureRenderTarget ist die zurückgegebene Größe die Größe der zugehörigen Anhänge zum Zeitpunkt von create(), in der Praxis die Größe des ersten Farbanhangs oder der Tiefen-/Schablonenpuffer, wenn es keine Farbanhänge gibt. Wenn die Größe der zugehörigen Texturen oder Renderbuffer später geändert und neu erstellt wird, führt pixelSize() einen impliziten Aufruf von create() durch, um die zugrunde liegenden Datenstrukturen neu zu erstellen. Diese implizite Überprüfung ähnelt dem, was QRhiCommandBuffer::beginPass() tut, und stellt sicher, dass die zurückgegebene Größe immer aktuell ist.
QRhiRenderPassDescriptor *QRhiRenderTarget::renderPassDescriptor() const
Gibt die zugehörige QRhiRenderPassDescriptor zurück.
Siehe auch setRenderPassDescriptor().
[pure virtual] int QRhiRenderTarget::sampleCount() const
Gibt die Anzahl der Samples zurück oder 1, wenn Multisample-Antialiasing für dieses Rendering-Ziel nicht relevant ist.
void QRhiRenderTarget::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)
Setzt die QRhiRenderPassDescriptor desc zur Verwendung mit diesem Rendering-Ziel.
Siehe auch renderPassDescriptor().
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
