QRhiScissor Class
Définit un rectangle en ciseaux. En savoir plus...
| En-tête : | #include <rhi/qrhi.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake : | QT += gui-private |
| Depuis : | Qt 6.6 |
Fonctions publiques
| 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) |
Éléments non membres associés
| 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) |
Description détaillée
À utiliser avec ` QRhiCommandBuffer::setScissor()`. La définition d'un rectangle de ciseaux n'est possible qu'avec un ` QRhiGraphicsPipeline ` pour lequel ` QRhiGraphicsPipeline::UsesScissor ` est défini.
QRhi Suppose des coordonnées de rectangle de découpe de type OpenGL, c'est-à-dire que les coordonnées x et y sont calculées à partir du coin inférieur gauche. Les largeurs ou hauteurs négatives ne sont pas autorisées. Cependant, en dehors de cela, la sémantique flexible d'OpenGL s'applique : les valeurs x et y négatives, les rectangles partiellement hors limites, etc. seront gérés de manière élégante, avec un écrêtage si nécessaire. Par conséquent, toute logique de rendu ciblant OpenGL peut transmettre des rectangles « scissor » à QRhiScissor tels quels, sans aucune adaptation.
Remarque : il s’agit d’une API RHI offrant des garanties de compatibilité limitées ; voir QRhi pour plus de détails.
Voir également QRhiCommandBuffer::setScissor() et QRhiViewport.
Documentation des fonctions membres
[constexpr noexcept default] QRhiScissor::QRhiScissor()
Crée une paire de ciseaux vide.
QRhiScissor::QRhiScissor(int x, int y, int w, int h)
Crée une structure en ciseaux à partir du rectangle défini par x, y, w et h.
Remarque : x et y sont supposés correspondre à la position en bas à gauche. Les valeurs négatives pour w ou h ne sont pas autorisées ; les rectangles de ciseaux correspondants seront ignorés par QRhiCommandBuffer. En dehors de cela, la sémantique flexible d’OpenGL s’applique : les valeurs x et y négatives, les rectangles partiellement hors limites, etc. seront gérés de manière élégante, avec un écrêtage si nécessaire.
std::array<int, 4> QRhiScissor::scissor() const
Renvoie la position et la taille des ciseaux.
Voir aussi setScissor().
void QRhiScissor::setScissor(int x, int y, int w, int h)
Définit la position et la taille des ciseaux sur x, y, w, h.
Remarque : la position doit toujours être spécifiée dans un système de coordonnées dont l'origine se trouve dans le coin inférieur gauche, comme en OpenGL.
Voir également scissor().
Éléments non membres associés
[noexcept] size_t qHash(const QRhiScissor &key, size_t seed = 0)
Renvoie la valeur de hachage de key, en utilisant seed comme graine pour le calcul.
[noexcept] bool operator!=(const QRhiScissor &a, const QRhiScissor &b)
Renvoie « false » si les valeurs contenues dans les deux objets « QRhiScissor » ( a et b ) sont identiques ; sinon, renvoie « true ».
[noexcept] bool operator==(const QRhiScissor &a, const QRhiScissor &b)
Renvoie « true » si les valeurs contenues dans les deux objets « QRhiScissor » a et b sont identiques.
© 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.
