이 페이지에서

Qt3DRender::QScreenRayCaster Class

class Qt3DRender::QScreenRayCaster

화면 좌표를 기반으로 레이 캐스팅 테스트를 수행합니다. 더 보기...

헤더: #include <qscreenraycaster.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML에서: ScreenRayCaster
상속: Qt3DRender::QAbstractRayCaster
상태: 사용 중단됨

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

속성

공개 함수

QPoint position() const

공개 슬롯

void setPosition(const QPoint &position)
void trigger()
void trigger(const QPoint &position)

신호

void positionChanged(const QPoint &position)

상세 설명

QScreenRayCaster를 사용하면 화면 좌표계의 좌표를 지정하여 레이 캐스팅 테스트를 수행할 수 있으며, 이 좌표는 근면과 원면 사이의 실제 3D 레이를 구성하는 데 사용됩니다.

QRayCaster 및 QNoPicking도 참조하십시오 .

속성 문서

position : QPoint

교차 검사에 사용되는 실제 3D 광선을 계산하는 데 활용되는 스크린 공간 위치를 저장합니다.

참고: 좌표가 유효한 범위 내에 있는 한, 사용 가능한 모든 렌더링 표면에 대해 이 좌표가 사용됩니다.

액세스 함수:

QPoint position() const
void setPosition(const QPoint &position)

알림 신호:

void positionChanged(const QPoint &position)

멤버 함수 문서

[slot] void QScreenRayCaster::trigger()

현재 좌표 값을 사용하여 컴포넌트를 활성화하고 테스트를 실행할 수 있는 편리한 방법입니다.

참고: 이 슬롯은 오버로드되어 있습니다. 이 슬롯에 연결하려면:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        screenRayCaster, qOverload<>(&QScreenRayCaster::trigger));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        screenRayCaster, [receiver = screenRayCaster]() { receiver->trigger(); });
더 많은 예제와 접근 방법은 ‘오버로드된 슬롯에 연결하기’를 참조하십시오.

[slot] void QScreenRayCaster::trigger(const QPoint &position)

position 의 좌표 값을 설정하고 컴포넌트가 테스트를 트리거할 수 있도록 하는 편리한 방법입니다.

참고: 이 슬롯은 오버로드되어 있습니다. 이 슬롯에 연결하려면:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        screenRayCaster, qOverload(&QScreenRayCaster::trigger));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        screenRayCaster, [receiver = screenRayCaster](const QPoint &position) { receiver->trigger(position); });
더 많은 예제와 방법에 대해서는 오버로드된 슬롯 연결을 참조하십시오.

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