QSGClipNode Class
QSGClipNode 클래스는 씬 그래프에서 클리핑 기능을 구현합니다. 더 보기...
| 헤더: | #include <QSGClipNode> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| 상속: | QSGBasicGeometryNode |
- 상속된 멤버를 포함한 모든 멤버 목록
- QSGClipNode는 Qt Quick 의 Scene Graph Node 클래스 그룹에 속합니다.
공개 함수
| QSGClipNode() | |
| virtual | ~QSGClipNode() override |
| QRectF | clipRect() const |
| bool | isRectangular() const |
| void | setClipRect(const QRectF &rect) |
| void | setIsRectangular(bool rectHint) |
상세 설명
클리핑은 노드의 하위 트리에 적용되며 중첩될 수 있습니다. 여러 클립 노드는 모든 지오메트리를 교차시켜 합산됩니다. 이 합산 과정은 렌더링의 일부로 수행됩니다.
클립 노드는 씬 그래프에 추가되기 전에 지오메트리를 가지고 있어야 합니다.
클리핑은 일반적으로 스텐실 버퍼를 사용하여 구현됩니다.
참고: QSG 접두사가 붙은모든 클래스는 장면 그래프의 렌더링 스레드에서만 사용해야 합니다. 자세한 내용은 장면 그래프 및 렌더링을 참조하십시오.
멤버 함수 문서
QSGClipNode::QSGClipNode()
지오메트리가 없는 새로운 QSGClipNode를 생성합니다.
클립 노드는 씬 그래프에 추가되기 전에 지오메트리를 가지고 있어야 합니다.
[override virtual noexcept] QSGClipNode::~QSGClipNode()
이 QSGClipNode 을 삭제합니다.
QSGNode::OwnsGeometry 플래그가 설정된 경우, 지오메트리도 함께 삭제됩니다.
QRectF QSGClipNode::clipRect() const
이 노드의 클립 사각형을 반환합니다.
setClipRect()도 참조하십시오 .
bool QSGClipNode::isRectangular() const
이 클립 노드에 직사각형 클립이 있는지 여부를 반환합니다.
setIsRectangular()도 참조하십시오 .
void QSGClipNode::setClipRect(const QRectF &rect)
이 클립 노드의 클립 영역을 rect 로 설정합니다.
setIsRectangular 와 함께 직사각형 클립이 설정된 경우, 렌더러는 경우에 따라 더 최적화된 클립 방식을 사용할 수 있습니다.
clipRect()도 참조하십시오 .
void QSGClipNode::setIsRectangular(bool rectHint)
이 클립 노드에 직사각형 클립이 적용될지 여부를 rectHint 로 설정합니다.
이는 최적화 힌트로, 렌더러가 스텐실 대신 시저링(scissoring)을 사용할 수 있게 하여 처리 속도를 대폭 향상시킵니다.
이 힌트가 설정되어 있고 적용 가능한 경우, 클립 영역은 geometry() 대신 clipRect()을 통해 생성됩니다.
기본적으로 이 속성의 값은 false 입니다.
isRectangular()도 참조하십시오 .
© 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.
