En esta página

Qt3DRender::QScreenRayCaster Class

class Qt3DRender::QScreenRayCaster

Realizar una prueba de ray casting basada en las coordenadas de la pantalla. Más...

Encabezado: #include <qscreenraycaster.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: ScreenRayCaster
Heredado de: Qt3DRender::QAbstractRayCaster
Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

QPoint position() const

Ranuras públicas

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

Señales

void positionChanged(const QPoint &position)

Descripción detallada

QScreenRayCaster se puede utilizar para realizar pruebas de trazado de rayos especificando coordenadas en el espacio de la pantalla, que se utilizarán para construir un rayo 3D real entre los planos cercano y lejano.

Véase también QRayCaster y QNoPicking.

Documentación de propiedades

position : QPoint

Almacena la posición en el espacio de la pantalla que se utiliza para calcular el rayo 3D real en las pruebas de intersección.

Nota: las coordenadas se utilizarán para todas las superficies de renderizado disponibles, siempre que se encuentren dentro del rango válido.

Funciones de acceso:

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

Señal de notificación:

void positionChanged(const QPoint &position)

Documentación de las funciones de miembro

[slot] void QScreenRayCaster::trigger()

Método práctico para activar el componente y ejecutar pruebas utilizando el valor de coordenadas actual.

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// 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(); });
Para ver más ejemplos y enfoques, consulta la sección «Conexión a ranuras sobrecargadas».

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

Método práctico para establecer el valor de las coordenadas position y permitir que el componente active las pruebas.

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// 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); });
Para ver más ejemplos y enfoques, consulta la sección sobre cómo conectarse a ranuras sobrecargadas.

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