Package com.luciad.util.height

Class TLcdImageModelHeightProviderFactory

java.lang.Object

com.luciad.util.height.ALcdModelHeightProviderFactory

com.luciad.util.height.ALcdRasterModelHeightProviderFactory

com.luciad.util.height.TLcdImageModelHeightProviderFactory

All Implemented Interfaces:

ILcdModelHeightProviderFactory

public class TLcdImageModelHeightProviderFactory
extends ALcdRasterModelHeightProviderFactory

This class provides a method to create an ILcdHeightProvider when an ILcdModel is given that contains elements of the type ALcdBasicImage, ALcdImageMosaic or ALcdMultilevelImageMosaic. When the model contains elements of type ILcdRaster or ILcdMultilevelRaster, the factory will fall back to the legacy implementation in TLcdRasterModelHeightProviderFactory

The height providers created by this factory are thread-safe. However, when you need to retrieve the height at many locations its usually more efficient to create a new height provider. This avoids cache conflicts between different threads need different image data (e.g. tiles) to retrieve their heights.

Since:

2014.0

Field Summary

Fields

Modifier and Type	Field	Description
static final String	KEY_IMAGING_ENGINE	Key used to pass a user-defined imaging engine to the TLcdImageHeightProviders created by this factory.
static final String	KEY_MAX_CACHE_ENTRIES	Key for the maximal number of entries that can be stored in the provider's tile cache.
static final String	KEY_MAX_CACHE_SIZE	Key for the maximum size (in megabytes) that can be stored in the provider's tile cache.

Fields inherited from class com.luciad.util.height.ALcdRasterModelHeightProviderFactory

KEY_INTERPOLATE_DATA, KEY_MAX_VALID_HEIGHT, KEY_MIN_VALID_HEIGHT, KEY_PIXEL_DENSITY

Fields inherited from interface com.luciad.util.height.ILcdModelHeightProviderFactory

KEY_GEO_REFERENCE

Constructor Summary

Constructors

Constructor	Description
TLcdImageModelHeightProviderFactory()

Method Summary

Modifier and Type	Method	Description
protected boolean	canCreateHeightProvider(ILcdModel aModel)	Check if a height provider can be created from the given ILcdModel.
protected ILcdHeightProvider	createModelElementHeightProvider(Object aElement, Map<String,Object> aRequiredPropertiesSFCT, Map<String,Object> aOptionalProperties)	Creates an ILcdHeightProvider for the given model element.

Methods inherited from class com.luciad.util.height.ALcdRasterModelHeightProviderFactory

transformProperties

Methods inherited from class com.luciad.util.height.ALcdModelHeightProviderFactory

createHeightProvider

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

KEY_IMAGING_ENGINE

public static final String KEY_IMAGING_ENGINE

Key used to pass a user-defined imaging engine to the TLcdImageHeightProviders created by this factory. If defined, the property should be a ALcdImagingEngine. If not defined, a default imaging engine will be created for every height provider factory.

See Also:

• Constant Field Values

KEY_MAX_CACHE_ENTRIES

public static final String KEY_MAX_CACHE_ENTRIES

Key for the maximal number of entries that can be stored in the provider's tile cache. The property should be an integer.

Since:

2026.1

See Also:

• Constant Field Values

KEY_MAX_CACHE_SIZE

public static final String KEY_MAX_CACHE_SIZE

Key for the maximum size (in megabytes) that can be stored in the provider's tile cache. The property should be an integer.

Since:

2026.1

See Also:

• Constant Field Values

Constructor Details

TLcdImageModelHeightProviderFactory

public TLcdImageModelHeightProviderFactory()

Method Details

createModelElementHeightProvider

protected ILcdHeightProvider createModelElementHeightProvider(Object aElement,
 Map<String,Object> aRequiredPropertiesSFCT,
 Map<String,Object> aOptionalProperties)
                                                       throws TLcdMissingPropertyException,
TLcdUnsupportedPropertyException

Description copied from class: ALcdModelHeightProviderFactory

Creates an ILcdHeightProvider for the given model element.

Specified by:

createModelElementHeightProvider in class ALcdRasterModelHeightProviderFactory

Parameters:

aElement - a model element.

aRequiredPropertiesSFCT - the required properties.

aOptionalProperties - the optional properties.

Returns:

an ILcdHeightProvider for the given model element or null if no ILcdHeightProvider can be created.

Throws:

TLcdMissingPropertyException - when a property is missing that is necessary to create the ILcdHeightProvider.

TLcdUnsupportedPropertyException - when a required property was never used while creating the ILcdHeightProvider.

canCreateHeightProvider

protected boolean canCreateHeightProvider(ILcdModel aModel)

Description copied from class: ALcdRasterModelHeightProviderFactory

Check if a height provider can be created from the given ILcdModel. The default implementation only returns true if the model contains a TLcdRasterModelDescriptor or a TLcdMultilevelRasterModelDescriptor, and false otherwise.

Overrides:

canCreateHeightProvider in class ALcdRasterModelHeightProviderFactory

Parameters:

aModel - the given model.

Returns:

true if a height provider can be created from the given model and false otherwise.