이 페이지에서

LevelOfDetail QML Type

LevelOfDetail은 화면상의 크기에 따라 렌더링되는 엔티티의 복잡도를 제어하는 방법을 제공합니다. 더 보기...

Import Statement: import Qt3D.Render 2.12
In C++: QLevelOfDetail
Inherits:

Component3D

Status: Deprecated

이 유형은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.

속성

상세 설명

LevelOfDetail은 관찰자와의 거리나 화면상의 크기에 따라 엔티티의 표현을 제어하는 데 사용할 수 있습니다.

렌더링 성능을 향상시키기 위해, 매우 작은 오브젝트는 지오메트리나 텍스처의 디테일을 훨씬 덜 사용하여 렌더링할 수 있습니다.

이 컴포넌트는 카메라와의 거리 또는 화면 크기로 해석되는 값의 임계값을 지정하여 제어됩니다.

시점이 변경되면, currentIndex 속성이 범위 배열의 해당 값을 반영하도록 변경됩니다.

currentIndex 속성은 예를 들어, 엔티티를 활성화하거나 비활성화하거나, EntityLoader 의 소스를 변경하거나, 머티리얼을 변경하는 데 사용할 수 있습니다.

LevelOfDetail 컴포넌트는 여러 엔티티 간에 공유할 수 없습니다.

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

속성 설명서

ThresholdType : enumeration

임계값의 값이 어떻게 해석되는지 지정합니다

  • DistanceToCameraThreshold 엔티티에서 선택된 카메라까지의 거리
  • ProjectedScreenPixelSizeThreshold: 선택한 카메라 시점에서 화면에 투영되었을 때 엔티티의 크기로, 화면 공간 내 경계 사각형의 한 변 길이를 픽셀 수로 나타낸 값입니다.

Qt3DRender::QLevelOfDetail::ThresholdType도 참조하십시오 .

camera : Camera

실제 거리 또는 화면 크기를 계산하는 데 사용되는 카메라의 ID를 저장합니다.

currentIndex : int

카메라와의 현재 거리 또는 화면 크기와 일치하는 범위 배열 내의 인덱스입니다.

thresholdType : int

범위 값이 어떻게 해석되는지 지정합니다.

thresholds : QList<qreal>

범위 값을 부동 소수점 숫자로 표현한 배열입니다. 가장 세밀한 표현에 해당하는 값을 먼저 지정해야 합니다.

LevelOfDetail::thresholdType 가 LevelOfDetail.DistanceToCameraThreshold로 설정된 경우, 값은 카메라 공간 좌표계에서 오름차순으로 지정해야 합니다.

LevelOfDetail::thresholdType 가 LevelOfDetail.ProjectedScreenPixelSizeThreshold로 설정된 경우, 값은 화면 공간 픽셀 단위로 내림차순으로 지정되어야 합니다.

volumeOverride : int

거리 또는 화면 크기를 계산하는 데 사용되는 기준을 지정합니다.

기본값은 반지름이 1이고 엔티티의 로컬 원점을 중심으로 하는 구입니다. 이 대리 볼륨은 카메라까지의 거리나 화면 투영 크기를 계산하는 데 사용됩니다.

이 값이 null인 경우, 엔티티의 바운딩 볼륨이 사용됩니다. 이 바운딩 볼륨이 유효하지 않게 되지 않도록 주의해야 합니다.

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.