ModelDetailEstimate Class
Estimated detail of a 3D model written by MapPackageModelWriter.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CEDataSets assembly)
Syntax
public class ModelDetailEstimate : EngineObjectRemarks
This class describes the estimated detail level, in terms of texture and mesh-triangle density, that would result from writing a model to a GeoPackage using MapPackageModelWriter. Values of this class are the results of using the estimation functionality on MapPackageModelWriter. See MapPackageModelWriter.Estimate.
Each ModelDetailEstimate object describes the estimate for the detail level given in TileLevel, corresponding to a tile level in a GlobeView. See for example GlobeView.ExtraTileLevels for a description of GlobeView tile levels. In short, GlobeView recursively divides the earth into square tiles, and each tile can be subdivided into four tiles with higher detail. Those four are said to be one tile level higher than the one they subdivide. GlobeView dynamically chooses how far to subdivide – that is, which tile level to display – depending on distance to the camera.
The estimated detail is expressed as a factor relative to a suggested value appropriate for the TileLevel. This means that a TexelDensityFactor and TriangleDensityFactor of 1.0 is the suggested target to aim for (although this suggestion might not be appropriate for all applications).
As an example, if MapPackageModelWriter.Estimate results in a TexelDensityFactor or TriangleDensityFactor around 0.25 for most tile levels, then you may try setting MapPackageModelTable.LevelOfDetailMultiplier to 4.0 before converting using MapPackageModelWriter.Convert, or else the output models will likely have too little detail. Similarly, if the values are much higher than 1.0, the detail will probably be too great, resulting in slow model conversion, high runtime memory usage, and slow rendering performance.
Often, it is not possible to get densities close to 1.0 at every tile level, since the assignment of input data to tile levels is based on level-of-detail information gathered from input metadata, which might not distribute texel and triangle densities perfectly evenly; and because there may be fewer detail levels present in the input data than in the output tile levels. This is not necessarily a problem: not every tile level must have the exact suggested detail density as this method recommends to give good results. Instead, the densities ought to be taken only as a hint.
The method MapPackageModelWriter.DeduceDetailSettings automatically deduces detail settings that result in densities as close to 1.0 as possible for each tile level.
Inheritance Hierarchy
System.Object (not available in C#)
EngineObject
ModelDetailEstimate
Platforms
Windows, Linux, Android
See Also
Reference
DataSets Module
MapPackageModelWriter
MapPackageModelWriter.Estimate
MapPackageModelWriter.DeduceDetailSettings
ModelDetailEstimate Members
The ModelDetailEstimate type has the following members.
Properties
| Name | Description |
|---|---|
| IsDisposed | Gets a value that tells whether the current ModelDetailEstimate has been disposed. Inherited from EngineObject |
| NativeHandle | Gets the native Carmenta Engine kernel object the current ModelDetailEstimate represents. Inherited from EngineObject |
| TexelDensityFactor | Density factor for textures. |
| TileLevel | Which tile level this estimate describes. |
| TriangleDensityFactor | Density factor for mesh triangles. |
Methods
| Name | Description |
|---|---|
| Clone | Creates a copy of an object. Inherited from EngineObject |
| Dispose | Releases the reference to the native Carmenta Engine kernel instance the EngineObject represents. Inherited from EngineObject |
| Equals | Determines whether this instance is equal to another. Inherited from EngineObject |