• Home
• Qt 6.4
• Qt 3D
• QML Types
• Qt3D.Render
• LevelOfDetail

LevelOfDetail

LevelOfDetail provides a way of controlling the complexity of rendered entities based on their size on the screen. More...

• List of all members, including inherited members

Properties

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

Detailed Description

LevelOfDetail can be used to control the representation of an entity based on distance from the observer or size on the screen.

In order to improve rendering performance, objects that are very small can be rendered using far fewer details, in geometry or texture.

The component is controlled by specifying thresholds of values which are interpreted as either distances from the camera or screen size.

As the point of view changes, the currentIndex property will change to reflect matching value in the range array.

The currentIndex property can then be used, for example, to enable or disable entities, change source in an EntityLoader, or material.

The LevelOfDetail component is not shareable between multiple Entity'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 ]
    }
}

Property Documentation