En esta página

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

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

Esferas reflectantes sobre una plataforma con mandos de control de la sonda

Este ejemplo muestra las características de las sondas de reflexión. Ofrece al usuario un panel para seleccionar diferentes propiedades que influirán en cómo la sonda renderizará el mapa cúbico, así como en cómo los modelos utilizarán dicho mapa para reflejar su entorno.

La escena

La escena consta de varios 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 del centro de la escena están desactivados por defecto y pueden activarse desde el panel de configuración. Pueden utilizarse para mostrar cómo interactúan 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 junto con la esfera del centro. Un modelo utilizará el mapa cúbico capturado por la sonda de reflexión más cercana a la hora de reflejar su entorno.

Panel de configuración

Configuración 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.

La opción «Time Slicing» controla la frecuencia con la que se renderiza cada cara del mapa de reflexión. Por ejemplo, al seleccionar «Individual Faces», la sonda de reflexión renderizará una cara por fotograma. Esto ofrece un mejor 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 sola vez. Esto ofrece un mejor rendimiento, pero producirá un efecto no deseado cuando se utilice en una escena que contenga animaciones.

Por último, «Calidad del mapa de reflexión» controla la resolución del mapa cúbico generado.

Ajustes de la sonda de reflexión

El tamaño del cuadro de la sonda de reflexión se utiliza para determinar qué objetos se encuentran dentro de la sonda. Si un objeto se encuentra dentro de la sonda, utilizará el mapa generado por esta. El tamaño del cuadro también se utiliza con la corrección de paralaje. Se considera que el mapa de reflexión está infinitamente lejos cuando se renderiza. Aunque esto puede funcionar para escenas en exteriores, en las escenas en interiores producirá efectos no deseados. La corrección de paralaje hace que el mapa de reflexión tenga en cuenta tanto el tamaño de la caja 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 en interiores debería utilizar una sonda de reflexión del mismo tamaño que el área interior.

La posición de la sonda se utiliza para moverla dentro de la escena. También influirá en el lugar desde el que la sonda renderizará el mapa cúbico.

Configuración de partículas

Estos ajustes pueden utilizarse para añadir algunas partículas a la escena y mostrar cómo funcionan las sondas de reflexión con las partículas. Tanto las partículas 3D como las de sprite aparecen en los mapas de reflexión, pero solo las partículas 3D pueden utilizar 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, lo que afectará a los reflejos renderizados por este modelo. El usuario también puede elegir si el modelo debe recibir reflejos o no mediante las casillas de verificación «Recibe reflejos».

Proyecto de ejemplo en 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.