Sur cette page

Qt3DRender::QScreenRayCaster Class

class Qt3DRender::QScreenRayCaster

Effectuer un test de ray casting à partir des coordonnées à l'écran. En savoir plus...

En-tête : #include <qscreenraycaster.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : ScreenRayCaster
Hérite de : Qt3DRender::QAbstractRayCaster
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

QPoint position() const

Emplacements publics

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

Signaux

void positionChanged(const QPoint &position)

Description détaillée

QScreenRayCaster permet d'effectuer des tests de ray casting en spécifiant des coordonnées dans l'espace écran, qui seront utilisées pour construire un rayon 3D réel entre les plans proche et lointain.

Voir également QRayCaster et QNoPicking.

Documentation sur les propriétés

position : QPoint

Contient la position dans l'espace à l'écran utilisée pour calculer le rayon 3D effectif dans le cadre des tests d'intersection.

Remarque : les coordonnées seront utilisées pour chaque surface de rendu disponible tant qu'elles se situent dans la plage valide.

Fonctions d'accès :

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

Signal de notification :

void positionChanged(const QPoint &position)

Documentation des fonctions membres

[slot] void QScreenRayCaster::trigger()

Méthode pratique permettant d'activer le composant et de déclencher des tests à l'aide de la valeur de coordonnée actuelle.

Remarque : ce slot est surchargé. Pour vous connecter à ce slot :

// 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(); });
Pour plus d'exemples et d'approches, consultez la section « Connexion à des slots surchargés ».

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

Méthode pratique pour définir la valeur de coordonnée position et permettre au composant de déclencher des tests.

Remarque : ce slot est surchargé. Pour vous connecter à ce slot :

// 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); });
Pour plus d’exemples et d’approches, consultez la section « Connexion à des slots surchargés ».

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