QSGClipNode Class

QSGClipNode 클래스는 씬 그래프에서 클리핑 기능을 구현합니다. 더 보기...

헤더: #include <QSGClipNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
상속합니다: QSGBasicGeometryNode

공용 함수

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 로 설정합니다.

이는 렌더러가 스텐실 대신 훨씬 더 빠른 가위질을 사용할 수 있도록 하는 최적화 힌트입니다.

이 힌트를 설정하고 적용하면 클립 영역이 geometry()가 아닌 clipRect()에서 생성됩니다.

기본적으로 이 속성은 false 입니다.

isRectangular()도 참조하세요 .

© 2025 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.