QRhiViewport Class
Legt ein Ansichtsfenster-Rechteck fest. Mehr...
| Kopfzeile: | #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 |
Öffentliche Funktionen
| QRhiViewport() | |
| QRhiViewport(float x, float y, float w, float h, float minDepth = 0.0f, float maxDepth = 1.0f) | |
| float | maxDepth() const |
| float | minDepth() const |
| void | setMaxDepth(float maxDepth) |
| void | setMinDepth(float minDepth) |
| void | setViewport(float x, float y, float w, float h) |
| std::array<float, 4> | viewport() const |
Verwandte Nicht-Mitglieder
| size_t | qHash(const QRhiViewport &key, size_t seed = 0) |
| bool | operator!=(const QRhiViewport &a, const QRhiViewport &b) |
| bool | operator==(const QRhiViewport &a, const QRhiViewport &b) |
Ausführliche Beschreibung
Wird mit ` QRhiCommandBuffer::setViewport()` verwendet.
QRhi Geht von Viewport-Koordinaten im OpenGL-Stil aus, d. h., x und y beziehen sich auf die linke untere Ecke. Negative Breiten- oder Höhenwerte sind nicht zulässig.
Eine typische Verwendung sieht wie folgt aus:
const QSize outputSizeInPixels = swapchain->currentPixelSize();
const QRhiViewport viewport(0, 0, outputSizeInPixels.width(), outputSizeInPixels.height());
cb->beginPass(swapchain->currentFrameRenderTarget(), Qt::black, { 1.0f, 0 });
cb->setGraphicsPipeline(ps);
cb->setViewport(viewport);
// ...Hinweis: Dies ist eine RHI-API mit eingeschränkten Kompatibilitätsgarantien; weitere Informationen finden Sie unter QRhi.
Siehe auch „ QRhiCommandBuffer::setViewport()“, „ QRhi::clipSpaceCorrMatrix()“ und „ QRhiScissor “.
Dokumentation der Member-Funktionen
[constexpr noexcept default] QRhiViewport::QRhiViewport()
Erstellt eine Viewport-Beschreibung mit einem leeren Rechteck und einem Tiefenbereich von 0,0f bis 1,0f.
Siehe auch ` QRhi::clipSpaceCorrMatrix()`.
QRhiViewport::QRhiViewport(float x, float y, float w, float h, float minDepth = 0.0f, float maxDepth = 1.0f)
Erstellt eine Viewport-Beschreibung mit dem durch x, y, w, h angegebenen Rechteck und dem Tiefenbereich minDepth und maxDepth.
Hinweis: Beix und y wird die Position unten links angenommen. w und h dürfen nicht negativ sein, da der Viewport andernfalls von QRhiCommandBuffer::setViewport() ignoriert wird.
Siehe auch QRhi::clipSpaceCorrMatrix().
float QRhiViewport::maxDepth() const
Gibt den Wert „maxDepth“ des Tiefenbereichs des Ansichtsfensters zurück.
Siehe auch „ setMaxDepth()“.
float QRhiViewport::minDepth() const
Gibt den Wert „minDepth“ des Tiefenbereichs des Ansichtsfensters zurück.
Siehe auch ` setMinDepth()`.
void QRhiViewport::setMaxDepth(float maxDepth)
Legt den Wert „ maxDepth “ für den Tiefenbereich des Ansichtsfensters fest. Standardmäßig ist dieser Wert auf 1,0f gesetzt.
Siehe auch maxDepth().
void QRhiViewport::setMinDepth(float minDepth)
Legt den Wert „ minDepth “ für den Tiefenbereich des Ansichtsfensters fest. Standardmäßig ist dieser Wert auf 0,0f gesetzt.
Siehe auch ` minDepth()`.
void QRhiViewport::setViewport(float x, float y, float w, float h)
Legt die Position und Größe des Ansichtsfensters auf x, y, w und h fest.
Hinweis: Viewports werden in einem Koordinatensystem angegeben, dessen Ursprung in der unteren linken Ecke liegt.
Siehe auch viewport().
std::array<float, 4> QRhiViewport::viewport() const
Gibt die x- und y-Koordinaten sowie die Breite und Höhe des Ansichtsbereichs zurück.
Siehe auch „ setViewport()“.
Verwandte Nicht-Mitglieder
[noexcept] size_t qHash(const QRhiViewport &key, size_t seed = 0)
Gibt den Hash-Wert für key zurück, wobei seed als Startwert für die Berechnung verwendet wird.
[noexcept] bool operator!=(const QRhiViewport &a, const QRhiViewport &b)
Gibt „ false “ zurück, wenn die Werte in den beiden „ QRhiViewport “-Objekten „ a “ und „ b “ identisch sind; andernfalls wird „ true “ zurückgegeben.
[noexcept] bool operator==(const QRhiViewport &a, const QRhiViewport &b)
Gibt „ true “ zurück, wenn die Werte in den beiden „ QRhiViewport “-Objekten „ a “ und „ b “ identisch sind.
© 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.
