En esta página

Qt Quick 3D - Ejemplo de sondas de reflexión

Demuestra el uso de sondas de reflexión en Qt Quick 3D.

Esferas reflectantes sobre plataforma con controles de sonda

Este ejemplo demuestra las características de las sondas de reflexión. Proporciona al usuario un panel para seleccionar diferentes propiedades que afectarán a la forma en que la sonda va a renderizar el mapa cúbico, así como la forma en que los modelos utilizarán este mapa cúbico para reflejar su entorno.

La escena

La escena consiste en algunos modelos, dos sistemas de partículas, una sonda de luz y dos sondas de reflexión. Hay tres esferas en el centro de la escena, así como dos cubos que actúan como suelo y pared. Los dos sistemas de partículas en el centro de la escena están desactivados por defecto y pueden activarse desde el panel de configuración. Pueden utilizarse para mostrar cómo funcionan las partículas con las sondas de reflexión. La primera sonda de reflexión está situada en el origen y la otra se mueve con la esfera en el centro. Un modelo utilizará el mapa del cubo capturado por la sonda de reflexión más cercana cuando esté reflejando su entorno.

Panel de configuración

Ajustes del mapa de reflexión

El usuario puede controlar cómo la sonda de reflexión renderiza el mapa cúbico de reflexión. Dependiendo de los ajustes seleccionados, el rendimiento variará drásticamente.

Time Slicing controla la frecuencia con la que se renderiza cada cara del mapa de reflexión. Por ejemplo, si se selecciona Caras individuales, la sonda de reflexión renderizará una cara por fotograma. Esto mejora el rendimiento, pero a costa de la calidad.

Modo de actualización controla la frecuencia con la que la sonda de reflexión renderizará todo el mapa de reflexión. Si se selecciona Primer fotograma, la sonda de reflexión renderizará el mapa de reflexión una vez. Esto tiene un mejor rendimiento, pero producirá un efecto no deseado cuando se utiliza en una escena que tiene animaciones.

Por último, Reflection Map Quality controla la resolución del mapa cúbico generado.

Configuración de la sonda de reflexión

El tamaño de la caja de la sonda de reflexión se utiliza para determinar qué objetos se encuentran dentro de la sonda de reflexión. Si un objeto se encuentra dentro de la sonda, se utilizará el mapa generado por esta sonda. El tamaño de la caja también se utiliza con la corrección de paralaje. El mapa de reflexión se considera infinitamente lejano cuando se renderiza. Aunque esto puede funcionar para escenas exteriores, las escenas interiores producirán efectos no deseados. La corrección de paralaje hace que el mapa de reflexión tenga en cuenta el tamaño de la caja así como la posición de la cámara. Desactivar la corrección de paralaje afectará a la forma en que el suelo refleja su entorno. Una escena de interior debe utilizar una sonda de reflexión con el mismo tamaño que el área interior.

La posición de la sonda se utiliza para mover la sonda en la escena. También afectará al lugar desde el que la sonda va a renderizar el mapa del cubo.

Configuración de partículas

Estos ajustes se pueden utilizar para añadir algunas partículas a la escena para mostrar cómo funcionan las sondas de reflexión con partículas. Tanto las partículas 3D como las Sprite aparecen en los mapas de reflexión, pero sólo las partículas 3D pueden usar el mapa de reflexión para reflejar su entorno.

Configuración del modelo

El usuario puede controlar la rugosidad del material utilizado por la esfera que afectará a los reflejos renderizados por este modelo. El usuario también puede elegir si el modelo debe recibir reflexiones o no mediante el uso de la recibe reflexiones casillas de verificación.

Proyecto de ejemplo @ code.qt.io

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