ReflectionProbe QML Type
Define una sonda de reflexión en la escena. Más...
| Import Statement: | import QtQuick3D |
| Inherits: |
Propiedades
- boxOffset : vector3d
- boxSize : vector3d
- clearColor : Color
- debugView : bool
(since 6.4) - parallaxCorrection : bool
- quality : enumeration
- refreshMode : enumeration
- texture : CubeMapTexture
(since 6.5) - timeSlicing : enumeration
Métodos
- void scheduleUpdate()
Descripción detallada
Una sonda de reflexión se utiliza para proporcionar reflejos de la escena actual a los objetos. La sonda proporciona propiedades al tiempo de ejecución que luego se utilizan para renderizar la escena en un mapa cúbico. A continuación, el mapa cúbico se utiliza como información de reflexión para los objetos reflectantes.
Véase también Qt Quick 3D - Ejemplo de sondas de reflexión.
Documentación de propiedades
boxOffset : vector3d
El desplazamiento de la caja se utiliza para mover la caja con respecto a la posición de la sonda de reflexión. Dado que la sonda captura el entorno desde su posición, esta propiedad permite mover la caja sin afectar a la posición desde la que la sonda captura el entorno. Esta propiedad, junto con « ReflectionProbe::boxSize » (Sonda de reflexión), se utilizará para determinar qué objetos se encuentran dentro de la caja. Si se activa la opción « ReflectionProbe::parallaxCorrection » (Sincronización de la caja con la sonda), esta propiedad se puede utilizar para colocar la caja de forma que se obtengan reflejos más precisos.
Véase también « parallaxCorrection ».
boxSize : vector3d
El tamaño del cuadro se utiliza para determinar qué objetos obtienen sus reflejos de este ReflectionProbe. Los objetos que se encuentran dentro del cuadro están bajo la influencia de este ReflectionProbe. Si un objeto se encuentra dentro de más de una sonda de reflexión al mismo tiempo, se considera que el objeto está dentro de la sonda de reflexión más cercana. Con la opción « ReflectionProbe::parallaxCorrection » activada, el tamaño también se utiliza para calcular la distancia de los reflejos en el mapa cúbico.
Véase también parallaxCorrection.
clearColor : Color
El «color de borrado» es el color que se utiliza para borrar el mapa cúbico antes de renderizar la escena.
debugView : bool [since 6.4]
Si esta propiedad se establece en «true», se representa una estructura alámbrica para visualizar el cuadro de sonda de reflexión.
Esta propiedad se introdujo en Qt 6.4.
parallaxCorrection : bool
Por defecto, se supone que los reflejos proporcionados por la sonda de reflexión proceden de una distancia infinita, de forma similar al skybox. Esto funciona bien para los reflejos ambientales, pero en espacios reducidos provoca errores de perspectiva en los reflejos. Para solucionarlo, se puede activar la corrección de paralaje. La distancia del reflejo viene determinada entonces por la propiedad « ReflectionProbe::boxSize ».
Véase también « boxSize ».
quality : enumeration
La calidad determina la resolución del mapa cúbico.
Los valores posibles son:
| Constante | Descripción |
|---|---|
ReflectionProbe.VeryLow | Renderiza un mapa de reflejos utilizando una textura de 128x128. |
ReflectionProbe.Low | Renderiza un mapa de reflexión utilizando una textura de 256x256. |
ReflectionProbe.Medium | Renderiza un mapa de reflexión utilizando una textura de 512x512. |
ReflectionProbe.High | Renderiza un mapa de reflexión utilizando una textura de 1024x1024. |
ReflectionProbe.VeryHigh | Renderiza un mapa de reflejos utilizando una textura de 2048x2048. |
El valor por defecto es ReflectionProbe.Low
refreshMode : enumeration
El modo de actualización indica al motor de ejecución con qué frecuencia debe actualizarse el mapa de cubo.
Los valores posibles son:
| Constante | Descripción |
|---|---|
ReflectionProbe.FirstFrame | Renderiza la escena en el primer fotograma. |
ReflectionProbe.EveryFrame | Renderiza la escena en cada fotograma. |
El valor por defecto es ReflectionProbe.EveryFrame
Nota: Utiliza « ReflectionProbe.FirstFrame » para mejorar el rendimiento.
texture : CubeMapTexture [since 6.5]
En lugar de renderizar la escena, esta textura de mapa cúbico se utiliza para mostrar los reflejos en los objetos afectados por esta sonda de reflexión.
Esta propiedad se introdujo en Qt 6.5.
Véase también CubeMapTexture.
timeSlicing : enumeration
La división temporal determina cómo se sincroniza el renderizado del mapa cúbico.
Los valores posibles son:
| Constante | Descripción |
|---|---|
ReflectionProbe.None | Todas las caras del mapa cúbico se renderizan y se prefiltran durante un fotograma. |
ReflectionProbe.AllFacesAtOnce | Todas las caras se renderizan durante un fotograma, pero el prefiltrado se divide en fotogramas sucesivos, gestionándose cada nivel de mip en su propio fotograma. De este modo, los reflejos de las superficies rugosas se actualizan cada seis fotogramas, mientras que los de las superficies lisas se actualizan en cada fotograma. |
ReflectionProbe.IndividualFaces | Cada cara se renderiza y se prefiltra en un fotograma independiente. De este modo, todos los reflejos se actualizan cada seis fotogramas. |
El valor por defecto es ReflectionProbe.None
Nota: Utiliza ReflectionProbe.AllFacesAtOnce o ReflectionProbe.IndividualFaces para mejorar el rendimiento.
Documentación del método
void scheduleUpdate()
Actualiza el renderizado de la sonda de reflexión cuando se invoca mientras « ReflectionProbe::refreshMode » está configurado como « ReflectionProbe.FirstFrame ».
© 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.