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 reflexiones de la escena actual a los objetos. La sonda proporciona propiedades al tiempo de ejecución que se utilizan para representar la escena en un mapa cúbico. El mapa cúbico se utiliza como información de reflexión para los objetos que se reflejan.
Consulte 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 se puede utilizar para mover la caja sin afectar a la posición en la que la sonda captura el entorno. Esta propiedad junto con ReflectionProbe::boxSize se utilizará para determinar el objeto que cae dentro de la caja. Con ReflectionProbe::parallaxCorrection activado, esta propiedad se puede utilizar para posicionar la caja para obtener reflexiones más precisas.
Véase también parallaxCorrection.
boxSize : vector3d
El tamaño de la caja se utiliza para determinar qué objetos obtienen sus reflejos de este ReflectionProbe. Los objetos que están dentro de la caja 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 ReflectionProbe::parallaxCorrection activado, el tamaño también se utiliza para calcular la distancia de las reflexiones en el mapa del cubo.
Véase también parallaxCorrection.
clearColor : Color
El color de borrado es el color utilizado para borrar el mapa del cubo antes de renderizar la escena.
debugView : bool [since 6.4]
Si esta propiedad está establecida a true, se renderiza un wireframe para visualizar la caja de la sonda de reflexión.
Esta propiedad se introdujo en Qt 6.4.
parallaxCorrection : bool
Por defecto, las reflexiones proporcionadas por la sonda de reflexión se suponen desde una distancia infinita similar a la del skybox. Esto funciona bien para las reflexiones ambientales, pero en espacios reducidos provoca errores de perspectiva en las reflexiones. Para solucionarlo, se puede activar la corrección de paralaje. La distancia del reflejo es entonces determinada por la propiedad ReflectionProbe::boxSize.
Véase también boxSize.
quality : enumeration
La calidad determina la resolución del mapa del cubo.
Los valores posibles son:
| Constante | Descripción |
|---|---|
ReflectionProbe.VeryLow | Renderiza un mapa de reflexión usando una textura de 128x128. |
ReflectionProbe.Low | Renderiza un mapa de reflexión usando una textura de 256x256. |
ReflectionProbe.Medium | Renderiza un mapa de reflexión usando una textura de 512x512. |
ReflectionProbe.High | Renderiza un mapa de reflexión usando una textura de 1024x1024. |
ReflectionProbe.VeryHigh | Renderiza un mapa de reflexión usando una textura de 2048x2048. |
El valor por defecto es ReflectionProbe.Low
refreshMode : enumeration
El modo de actualización indica al programa la frecuencia con la que debe actualizarse el mapa del cubo.
Los valores posibles son:
| Constante | Descripción |
|---|---|
ReflectionProbe.FirstFrame | Renderiza la escena en el primer fotograma. |
ReflectionProbe.EveryFrame | Renderiza la escena cada fotograma. |
El valor por defecto es ReflectionProbe.EveryFrame
Nota: Utilice 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
Time slicing determina cómo se temporiza el renderizado del mapa cúbico.
Los valores posibles son:
| Constante | Descripción |
|---|---|
ReflectionProbe.None | Todas las caras del mapa del cubo se renderizan y prefiltran durante un fotograma. |
ReflectionProbe.AllFacesAtOnce | Todas las caras se renderizan en un fotograma, pero el prefiltrado se divide en fotogramas subsiguientes y cada nivel mip se gestiona en su propio fotograma. Los reflejos de las superficies rugosas se actualizan cada seis fotogramas, mientras que los de las superficies lisas se actualizan cada fotograma. |
ReflectionProbe.IndividualFaces | Cada cara se renderiza y prefiltra en un fotograma independiente. Por lo tanto, todos los reflejos se actualizan cada seis fotogramas. |
El valor por defecto es ReflectionProbe.None
Nota: Utilice ReflectionProbe.AllFacesAtOnce o ReflectionProbe.IndividualFaces para aumentar el rendimiento.
Documentación del método
void scheduleUpdate()
Actualiza el render de la sonda de reflexión cuando se llama mientras ReflectionProbe::refreshMode se establece 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.
