QRhiRenderTarget Class
Stellt ein Renderziel auf dem Bildschirm (Swapchain) oder außerhalb des Bildschirms (Textur) dar. Mehr...
| Header: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| Seit: | Qt 6.6 |
| Erbt von: | QRhiResource |
| Vererbt an: |
Öffentliche Funktionen
| virtual float | devicePixelRatio() const = 0 |
| virtual QSize | pixelSize() const = 0 |
| QRhiRenderPassDescriptor * | renderPassDescriptor() const |
| virtual int | sampleCount() const = 0 |
| void | setRenderPassDescriptor(QRhiRenderPassDescriptor *desc) |
Ausführliche Beschreibung
Anwendungen erstellen keine Instanz dieser Klasse direkt. Vielmehr ist es die Unterklasse „ QRhiTextureRenderTarget “, die von Clients der API über „ newTextureRenderTarget()“ instanziiert werden kann. Die andere Unterklasse ist „ QRhiSwapChainRenderTarget “, die als Typ von „ QRhiSwapChain “ zurückgegeben wird, wenn „ currentFrameRenderTarget()“ aufgerufen wird.
Hinweis: Hierbei handelt es sich um eine RHI-API mit eingeschränkten Kompatibilitätsgarantien; weitere Informationen finden Sie unter QRhi.
Siehe auch QRhiSwapChainRenderTarget und QRhiTextureRenderTarget.
Dokumentation zu den Member-Funktionen
[pure virtual] float QRhiRenderTarget::devicePixelRatio() const
Gibt das Gerätepixelverhältnis zurück. Bei „ QRhiTextureRenderTarget “ ist dieser Wert immer 1. Bei Zielen, die über „ QRhiSwapChain “ abgerufen werden, entspricht der Wert dem „ device pixel ratio “ des Ziel- QWindow s.
[pure virtual] QSize QRhiRenderTarget::pixelSize() const
Gibt die Größe in Pixeln zurück.
Gilt nur, nachdem `create()` erfolgreich aufgerufen wurde. Bis dahin ist das Ergebnis ein standardmäßig konstruiertes ` QSize`.
Bei ` QRhiTextureRenderTarget ` entspricht die zurückgegebene Größe der Größe der zugehörigen Anhänge zum Zeitpunkt des Aufrufs von `create()`; in der Praxis ist dies die Größe des ersten Farb-Anhangs oder, falls keine Farb-Anhänge vorhanden sind, die Größe des Tiefen- bzw. Stencil-Puffers. Werden die zugehörigen Texturen oder Renderbuffer anschließend in ihrer Größe angepasst und neu erstellt, führt `pixelSize()` einen impliziten Aufruf von `create()` durch, um die zugrunde liegenden Datenstrukturen neu aufzubauen. Diese implizite Überprüfung ähnelt der Funktionsweise von ` QRhiCommandBuffer::beginPass()` und stellt sicher, dass die zurückgegebene Größe stets auf dem neuesten Stand ist.
QRhiRenderPassDescriptor *QRhiRenderTarget::renderPassDescriptor() const
Gibt das zugehörige ` QRhiRenderPassDescriptor` zurück.
Siehe auch setRenderPassDescriptor().
[pure virtual] int QRhiRenderTarget::sampleCount() const
Gibt die Anzahl der Abtastungen zurück oder 1, wenn Multisample-Antialiasing für dieses Renderziel nicht relevant ist.
void QRhiRenderTarget::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)
Legt die „ QRhiRenderPassDescriptor “ desc für die Verwendung mit diesem Renderziel fest.
Siehe auch renderPassDescriptor().
© 2026 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.
