QRhiScissor Class
Legt ein Scherenrechteck fest. 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 |
Öffentliche Funktionen
| QRhiScissor() | |
| QRhiScissor(int x, int y, int w, int h) | |
| std::array<int, 4> | scissor() const |
| void | setScissor(int x, int y, int w, int h) |
Verwandte Nicht-Mitglieder
| size_t | qHash(const QRhiScissor &key, size_t seed = 0) |
| bool | operator!=(const QRhiScissor &a, const QRhiScissor &b) |
| bool | operator==(const QRhiScissor &a, const QRhiScissor &b) |
Detaillierte Beschreibung
Wird mit ` QRhiCommandBuffer::setScissor()` verwendet. Das Festlegen eines Scherenrechtecks ist nur mit einem ` QRhiGraphicsPipeline ` möglich, für das ` QRhiGraphicsPipeline::UsesScissor ` gesetzt ist.
QRhi Es werden Scherenkoordinaten im OpenGL-Stil vorausgesetzt, d. h., x und y beziehen sich auf die linke untere Ecke. Negative Breiten- oder Höhenwerte sind nicht zulässig. Abgesehen davon gilt jedoch die flexible OpenGL-Semantik: Negative x- und y-Werte, teilweise außerhalb des Bereichs liegende Rechtecke usw. werden korrekt verarbeitet und gegebenenfalls entsprechend begrenzt. Daher kann jede auf OpenGL ausgerichtete Rendering-Logik Scissor-Rechtecke unverändert und ohne Anpassungen an QRhiScissor übergeben.
Hinweis: Hierbei handelt es sich um eine RHI-API mit eingeschränkten Kompatibilitätsgarantien; weitere Informationen finden Sie unter QRhi.
Siehe auch QRhiCommandBuffer::setScissor() und QRhiViewport.
Dokumentation der Mitgliedsfunktionen
[constexpr noexcept default] QRhiScissor::QRhiScissor()
Erzeugt eine leere Schere.
QRhiScissor::QRhiScissor(int x, int y, int w, int h)
Erstellt eine Schere mit dem Rechteck, das durch x, y, w und h angegeben wird.
Hinweis: Es wird davon ausgegangen, dassx und y die Position unten links angeben. Negative Werte für w oder h sind nicht zulässig; solche Scherenrechtecke werden von QRhiCommandBuffer ignoriert. Ansonsten gelten die flexiblen OpenGL-Semantiken: Negative x- und y-Werte, teilweise außerhalb des Bereichs liegende Rechtecke usw. werden elegant behandelt und entsprechend begrenzt.
std::array<int, 4> QRhiScissor::scissor() const
Gibt die Position und Größe der Schere zurück.
Siehe auch ` setScissor()`.
void QRhiScissor::setScissor(int x, int y, int w, int h)
Legt die Position und Größe der Schere auf x, y, w, h fest.
Hinweis: Die Position muss immer in einem Koordinatensystem angegeben werden, dessen Ursprung in der unteren linken Ecke liegt, wie bei OpenGL.
Siehe auch scissor().
Verwandte Nicht-Mitglieder
[noexcept] size_t qHash(const QRhiScissor &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 QRhiScissor &a, const QRhiScissor &b)
Gibt „ false “ zurück, wenn die Werte in den beiden „ QRhiScissor “-Objekten „ a “ und „ b “ identisch sind; andernfalls wird „ true “ zurückgegeben.
[noexcept] bool operator==(const QRhiScissor &a, const QRhiScissor &b)
Gibt „ true “ zurück, wenn die Werte in den beiden „ QRhiScissor “-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.
