Specifies a scissor rectangle. More...
| Header: | #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 |
| 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) |
| 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) |
Used with QRhiCommandBuffer::setScissor(). Setting a scissor rectangle is only possible with a QRhiGraphicsPipeline that has QRhiGraphicsPipeline::UsesScissor set.
QRhi assumes OpenGL-style scissor coordinates, meaning x and y are bottom-left. Negative width or height are not allowed. However, apart from that, the flexible OpenGL semantics apply: negative x and y, partially out of bounds rectangles, etc. will be handled gracefully, clamping as appropriate. Therefore, any rendering logic targeting OpenGL can feed scissor rectangles into QRhiScissor as-is, without any adaptation.
Note: This is a RHI API with limited compatibility guarantees, see QRhi for details.
See also QRhiCommandBuffer::setScissor() and QRhiViewport.
[constexpr noexcept] QRhiScissor::QRhiScissor()Constructs an empty scissor.
Constructs a scissor with the rectangle specified by x, y, w, and h.
Note: x and y are assumed to be the bottom-left position. Negative w or h are not allowed, such scissor rectangles will be ignored by QRhiCommandBuffer. Other than that, the flexible OpenGL semantics apply: negative x and y, partially out of bounds rectangles, etc. will be handled gracefully, clamping as appropriate.
Returns the scissor position and size.
See also setScissor().
Sets the scissor position and size to x, y, w, h.
Note: The position is always expected to be specified in a coordinate system that has its origin in the bottom-left corner, like OpenGL.
See also scissor().
[noexcept] size_t qHash(const QRhiScissor &key, size_t seed = 0)Returns the hash value for key, using seed to seed the calculation.
[noexcept] bool operator!=(const QRhiScissor &a, const QRhiScissor &b)Returns false if the values in the two QRhiScissor objects a and b are equal; otherwise returns true.
[noexcept] bool operator==(const QRhiScissor &a, const QRhiScissor &b)Returns true if the values in the two QRhiScissor objects a and b are equal.
As part of the free Business evaluation, we offer a free welcome call for companies, to talk about your requirements, and how the Felgo SDK & Services can help you. Just sign up and schedule your call.
Sign up now to start your free Business evaluation:
