LevelOfDetail QML Type

LevelOfDetail permet de contrôler la complexité des entités rendues en fonction de leur taille à l'écran. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• ThresholdType : enumeration
• camera : Camera
• currentIndex : int
• thresholdType : int
• thresholds : QList<qreal>
• volumeOverride : int

Description détaillée

LevelOfDetail peut être utilisé pour contrôler la représentation d'une entité en fonction de sa distance par rapport à l'observateur ou de sa taille à l'écran.

Afin d'améliorer les performances de rendu, les objets très petits peuvent être rendus en utilisant beaucoup moins de détails, dans la géométrie ou la texture.

Le composant est contrôlé en spécifiant des seuils de valeurs qui sont interprétés comme des distances par rapport à la caméra ou comme la taille de l'écran.

Lorsque le point de vue change, la propriété currentIndex est modifiée pour refléter la valeur correspondante dans le tableau des valeurs.

La propriété currentIndex peut ensuite être utilisée, par exemple, pour activer ou désactiver des entités, changer la source d'une EntityLoader, ou un matériau.

Le composant LevelOfDetail n'est pas partageable entre plusieurs entités.

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 ]
    }
}

Documentation sur les propriétés

ThresholdType : enumeration

Spécifie comment les valeurs des seuils sont interprétées.

• DistanceToCameraThreshold Distance entre l'entité et la caméra sélectionnée
• ProjectedScreenPixelSizeThreshold Taille de l'entité projetée à l'écran, vue de la caméra sélectionnée, exprimée en nombre de pixels sur le côté du carré de délimitation dans l'espace de l'écran.

Voir également Qt3DRender::QLevelOfDetail::ThresholdType.

camera : Camera

Contient l'identifiant de la caméra utilisée pour calculer la distance réelle ou la taille de l'écran.

currentIndex : int

L'index du tableau d'intervalles qui correspond à la distance actuelle à la caméra ou à la taille de l'écran.

thresholdType : int

Spécifie comment les valeurs de l'intervalle sont interprétées.

thresholds : QList<qreal>

Tableau de valeurs de plage sous forme de nombres à virgule flottante. La valeur correspondant à la représentation la plus détaillée doit être spécifiée en premier.

Si LevelOfDetail::thresholdType est défini sur LevelOfDetail.DistanceToCameraThreshold, les valeurs doivent être spécifiées dans l'ordre croissant, dans les coordonnées de l'espace de la caméra.

Si LevelOfDetail::thresholdType est défini sur LevelOfDetail.ProjectedScreenPixelSizeThreshold, les valeurs doivent être spécifiées dans l'ordre décroissant, en pixels de l'espace de l'écran.

volumeOverride : int

Spécifie ce qui est utilisé pour évaluer la distance ou la taille de l'écran.

La valeur par défaut est une sphère de rayon 1 centrée sur l'origine locale de l'entité. Ce volume proxy est utilisé pour calculer la distance par rapport à la caméra ou la taille de l'écran de projection.

Si cette valeur est nulle, le volume de délimitation de l'entité est utilisé. Il convient de veiller à ce que ce volume de délimitation ne devienne jamais invalide.

Voir également Qt3DRender::QLevelOfDetailBoundingSphere.