LevelOfDetail QML Type
LevelOfDetail permite controlar la complejidad de las entidades representadas en función de su tamaño en pantalla. Más información...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QLevelOfDetail |
| Inherits: | |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- ThresholdType : enumeration
- camera : Camera
- currentIndex : int
- thresholdType : int
- thresholds : QList<qreal>
- volumeOverride : int
Descripción detallada
LevelOfDetail se puede utilizar para controlar la representación de una entidad en función de la distancia al observador o del tamaño en pantalla.
Para mejorar el rendimiento del renderizado, los objetos muy pequeños pueden renderizarse con muchos menos detalles, tanto en geometría como en textura.
El componente se controla especificando umbrales de valores que se interpretan como distancias desde la cámara o como tamaño de 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 » puede utilizarse, por ejemplo, para activar o desactivar entidades, cambiar la fuente en un « EntityLoader » o el 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 la propiedad
ThresholdType : enumeration
Especifica cómo se interpretan los valores de los umbrales
- DistanceToCameraThreshold: Distancia entre la entidad y la cámara seleccionada
- ProjectedScreenPixelSizeThreshold: tamaño de la entidad cuando se proyecta en la pantalla tal y como se ve desde la cámara seleccionada, expresado en número de píxeles en el lado del cuadrado delimitador en el espacio de la pantalla.
Véase también Qt3DRender::QLevelOfDetail::ThresholdType.
camera : Camera
Contiene el identificador de la cámara que se utiliza para calcular la distancia real o el tamaño de la pantalla.
currentIndex : int
El índice del array «range» que se corresponde con la distancia actual a la cámara o con el tamaño de la pantalla.
thresholdType : int
Especifica cómo se interpretan los valores del rango.
thresholds : QList<qreal>
Matriz de valores de rango expresados como números de punto flotante. El valor correspondiente a la representación más detallada debe especificarse en primer lugar.
Si LevelOfDetail::thresholdType se establece en LevelOfDetail.DistanceToCameraThreshold, los valores deben especificarse en orden ascendente, en coordenadas del espacio de la cámara
Si LevelOfDetail::thresholdType se establece en LevelOfDetail.ProjectedScreenPixelSizeThreshold, los valores deben especificarse en orden descendente, en píxeles del espacio de la pantalla.
volumeOverride : int
Especifica qué se utiliza para calcular la distancia o el tamaño de la pantalla.
El valor por defecto es una esfera de radio 1 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.