LevelOfDetail QML Type
LevelOfDetail proporciona una forma de controlar la complejidad de las entidades renderizadas en función de su tamaño en la pantalla. Más...
| Import Statement: | import Qt3D.Render 2.11 |
| In C++: | QLevelOfDetail |
| Inherits: | |
| Status: | Deprecated |
Propiedades
- ThresholdType : enumeration
- camera : Camera
- currentIndex : int
- thresholdType : int
- thresholds : QList<qreal>
- volumeOverride : int
Descripción detallada
LevelOfDetail puede utilizarse para controlar la representación de una entidad en función de la distancia al observador o del tamaño en la pantalla.
Para mejorar el rendimiento de la representación, los objetos muy pequeños pueden representarse con muchos menos detalles, en geometría o textura.
El componente se controla especificando umbrales de valores que se interpretan como distancias desde la cámara o tamaño de la pantalla.
A medida que cambia el punto de vista, la propiedad currentIndex cambiará para reflejar el valor correspondiente en la matriz de rangos.
La propiedad currentIndex se puede utilizar, por ejemplo, para activar o desactivar entidades, cambiar la fuente en un EntityLoader, o material.
El componente LevelOfDetail no se puede compartir entre varias entidades.
import Qt3D.Core 2.0 import Qt3D.Render 2.0 Entity { id: root // Scene Camera { id: mainCamera } LevelOfDetail { id: lod camera: mainCamera thresholds: [20, 35, 50, 65] thresholdType: LevelOfDetail.DistanceToCameraThreshold } GeometryRenderer { id: mesh view: CylinderMesh { property var sliceValues: [20, 10, 6, 4] slices: sliceValues[lod.currentIndex] } } Entity { id: renderableEntity components: [ mesh, lod ] } }
Documentación de propiedades
ThresholdType : enumeration
Especifica cómo se interpretan los valores de los umbrales
- DistanceToCameraThreshold Distancia de la entidad a la cámara seleccionada
- ProjectedScreenPixelSizeThreshold Tamaño de la entidad cuando se proyecta en la pantalla vista desde la cámara seleccionada, expresado en número de píxeles del lado del cuadrado delimitador en el espacio de la pantalla.
Véase también Qt3DRender::QLevelOfDetail::ThresholdType.
camera : Camera
Contiene el id de la cámara que se utiliza para calcular la distancia real o el tamaño de la pantalla.
currentIndex : int
El índice de la matriz de rango que coincide con la distancia actual a la cámara o el tamaño de la pantalla.
thresholdType : int
Especifica cómo se interpretan los valores de rango.
thresholds : QList<qreal>
Matriz de valores de rango como números en coma flotante. Debe especificarse primero el valor de la representación más detallada.
Si LevelOfDetail::thresholdType es igual a LevelOfDetail.DistanceToCameraThreshold, los valores deben especificarse en orden ascendente, en coordenadas de espacio de cámara.
Si LevelOfDetail::thresholdType está configurado como LevelOfDetail.ProjectedScreenPixelSizeThreshold, los valores deben especificarse en orden descendente, en píxeles de espacio de pantalla.
volumeOverride : int
Especifica qué se utiliza para evaluar la distancia o el tamaño de la pantalla.
Por defecto es una esfera de radio 1 y centrada en el origen local de la entidad. Este volumen proxy se utiliza para calcular la distancia a la cámara o el tamaño de la proyección en pantalla.
Si este valor es nulo, se utiliza el volumen delimitador de la entidad. Hay que tener cuidado de que este volumen delimitador nunca deje de ser válido.
Véase también Qt3DRender::QLevelOfDetailBoundingSphere.
© 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.