LevelOfDetail QML Type
LevelOfDetail を使用すると、画面上のサイズに基づいて、レンダリングされるエンティティの複雑さを制御することができます。詳細...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QLevelOfDetail |
| Inherits: | |
| Status: | Deprecated |
この型は非推奨です。新しいコードでの使用は強く推奨しません。
プロパティ
- ThresholdType : enumeration
- camera : Camera
- currentIndex : int
- thresholdType : int
- thresholds : QList<qreal>
- volumeOverride : int
詳細な説明
LevelOfDetail を使用すると、オブジェクトがオブザーバーからの距離や画面上のサイズに基づいて、その表示方法を制御できます。
レンダリングパフォーマンスを向上させるため、非常に小さいオブジェクトは、ジオメトリやテクスチャのディテールを大幅に抑えてレンダリングすることができます。
このコンポーネントは、カメラからの距離または画面サイズとして解釈される値のしきい値を指定することで制御されます。
視点が変化すると、currentIndex プロパティが変更され、range 配列内の対応する値が反映されます。
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
カメラからの現在の距離または画面サイズに対応する、range配列内のインデックス。
thresholdType : int
範囲の値がどのように解釈されるかを指定します。
thresholds : QList<qreal>
範囲の値を浮動小数点数で表した配列。最も詳細な表現の値を最初に指定する必要があります。
LevelOfDetail::thresholdType がLevelOfDetail.DistanceToCameraThresholdに設定されている場合、値はカメラ座標系において昇順で指定する必要があります
LevelOfDetail::thresholdType がLevelOfDetail.DistanceToCameraThresholdに設定されている場合、値はカメラ座標系で昇順に指定する必要があります。画面座標系では、ピクセル単位で降順に指定する必要があります。
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.