public class TLcdEarthHeightProviderFactory extends Object implements ILcdModelHeightProviderFactory
ILcdModelHeightProviderFactory
provides a method to create an
ILcdHeightProvider
that can provide height data of earth tilesets.
The ALcdModelHeightProviderFactory.KEY_GEO_REFERENCE
property should
always be passed to this factory.
KEY_SYNCHRONOUS_LEVEL
parameter is used) at the most
detailed level-of-detail available (unless the ALcdRasterModelHeightProviderFactory.KEY_PIXEL_DENSITY
parameter is specified).
The height providers created by this factory interpolate the height values (unless the
ALcdRasterModelHeightProviderFactory.KEY_INTERPOLATE_DATA
key is used with value
false
).
The height providers created by this factory are thread-safe.ILcdLayerHeightProviderFactory
,
TLcdEarthGXYLayerHeightProviderFactory
Modifier and Type | Field and Description |
---|---|
static String |
KEY_CACHE_SIZE
Key used for the property indicating the maximum number of tiles that should be cached.
|
static String |
KEY_EARTH_TERRAIN_ELEVATION_PROVIDER
Key used to pass an existing
TLcdEarthTileSetElevationProvider to this
factory. |
static String |
KEY_ELEVATION_COVERAGE
Key used for an elevation coverage property.
|
static String |
KEY_ELEVATION_OFFSET
Key used for an elevation offset value.
|
static String |
KEY_ELEVATION_SCALE
Key used for an elevation scale value.
|
static String |
KEY_SYNCHRONOUS_LEVEL
Key used for the max synchronous level.
|
static String |
KEY_TILE_SET_REFERENCE
Key used for the tileset reference.
|
KEY_GEO_REFERENCE
Constructor and Description |
---|
TLcdEarthHeightProviderFactory()
constructs a standard
TLcdEarthHeightProviderFactory . |
Modifier and Type | Method and Description |
---|---|
ILcdHeightProvider |
createHeightProvider(ILcdModel aModel,
Map<String,Object> aRequiredProperties,
Map<String,Object> aOptionalProperties)
Returns a height provider for a given
ILcdModel using the given
properties. |
public static final String KEY_ELEVATION_SCALE
TLcdEarthTileSetElevationProvider
.public static final String KEY_ELEVATION_OFFSET
TLcdEarthTileSetElevationProvider
.public static final String KEY_CACHE_SIZE
TLcdEarthTileSetElevationProvider
.public static final String KEY_TILE_SET_REFERENCE
ILcdGeoReference
.
This parameter should never be set as the tile set reference must be the same
as the model reference. This key is only available for backwards compatibility. If the key is
set anyway then its value will be used as reference of the tile set instead of the model
reference.public static final String KEY_ELEVATION_COVERAGE
ILcdEarthTileSet
. This value is used to create a
TLcdEarthTileSetElevationProvider
.public static final String KEY_EARTH_TERRAIN_ELEVATION_PROVIDER
TLcdEarthTileSetElevationProvider
to this
factory. If a TLcdEarthTileSetElevationProvider
is needed, and this property
exists, it is used. the property should be a TLcdEarthTileSetElevationProvider
.public static final String KEY_SYNCHRONOUS_LEVEL
public TLcdEarthHeightProviderFactory()
TLcdEarthHeightProviderFactory
.public ILcdHeightProvider createHeightProvider(ILcdModel aModel, Map<String,Object> aRequiredProperties, Map<String,Object> aOptionalProperties) throws TLcdMissingPropertyException, TLcdUnsupportedPropertyException
ILcdModelHeightProviderFactory
ILcdModel
using the given
properties. The returned height provider is determined by the implementation,
the ILcdModel
and the given properties.createHeightProvider
in interface ILcdModelHeightProviderFactory
aModel
- an ILcdModel
for which a height provider is created.aRequiredProperties
- the required properties. The properties can be retrieved using a
String
key describing the property type. When not all required properties
are used, an exception is thrown. aRequiredProperties
may be empty but should
not be null
. When an implementation of this interface uses a required
property, it should always remove it from the list of required properties. When the
ILcdHeightProvider
is actually made, implementations should verify that
the list of required properties is empty (and all required properties are used).aOptionalProperties
- the optional properties. The properties can be retrieved using a
String
key describing the property type. The optional properties may or may
not be used by the implementation. aOptionalProperties
may be empty but
should not be null.null
when elevation
is not supported or when no valid height provider can be created.TLcdMissingPropertyException
- when the implementation misses a necessary property.TLcdUnsupportedPropertyException
- when a required property is not used by the
implementation.TLcdModelHeightProviderFactoryUtil