com.luciad.fusion.tilestore.metadata

LuciadFusionClass TLfnVectorCoverageMetadata.Builder

java.lang.Object

com.luciad.fusion.tilestore.metadata.ALfnResourceMetadata.Builder<B>

com.luciad.fusion.tilestore.metadata.ALfnCoverageMetadata.Builder<TLfnVectorCoverageMetadata.Builder>

com.luciad.fusion.tilestore.metadata.TLfnVectorCoverageMetadata.Builder

Enclosing class:

TLfnVectorCoverageMetadata

Deprecated.

Since 2017.0 support for coverages of type VECTOR has been superseded with other mechanisms. Please refer to the Fusion migration guide for more information.

public static class TLfnVectorCoverageMetadata.Builder
extends ALfnCoverageMetadata.Builder<TLfnVectorCoverageMetadata.Builder>

Builder for vector coverage metadata. See the super class for more information.

Since:

11.0

See Also:

TLfnVectorCoverageMetadata

Method Summary

Modifier and Type	Method and Description
TLfnVectorCoverageMetadata.Builder	areaSimplificationFactor(double aFactor) Deprecated. Sets the area simplification factor.
TLfnVectorCoverageMetadata	build() Deprecated. Builds an immutable vector coverage metadata.
TLfnVectorCoverageMetadata.Builder	buildDataModel(Collection<TLcdDataModel> aAssetDataModels) Deprecated. instead use ALfnCoverageMetadata.Builder.addAssetInfo(ALfnAssetMetadata, String) and leave the data model to the default, which also has the effect that the coverage data model will be generated from the asset's data models
TLfnVectorCoverageMetadata.Builder	buildDataModel(TLcdDataModel... aAssetDataModels) Deprecated. instead use ALfnCoverageMetadata.Builder.addAssetInfo(ALfnAssetMetadata, String) and leave the data model to the default, which also has the effect that the coverage data model will be generated from the asset's data models
TLfnVectorCoverageMetadata.Builder	dataModel(TLcdDataModel aDataModel) Deprecated. Sets the data model of the coverage.
TLfnVectorCoverageMetadata.Builder	filter(Map<Integer,TLcdOGCFilter> aFiltersByScaleDenominator) Deprecated. use filters(java.util.Map) instead
TLfnVectorCoverageMetadata.Builder	filters(Map<Integer,TLcdOGCFilter> aFiltersByScaleDenominator) Deprecated. Sets the OGC filters to be used for this coverage.
TLfnVectorCoverageMetadata.Builder	forceLinearInterpolation(boolean aOn) Deprecated. Sets whether forcing linear interpolation is enabled or not.
double	getAreaSimplificationFactor() Deprecated. Gets the area simplification factor.
TLcdDataModel	getDataModel() Deprecated. Gets this builder's current data model.
Map<Integer,TLcdOGCFilter>	getFilters() Deprecated. Gets an immutable map of the filters, ordered by scale denominator.
double	getLineSimplificationFactor() Deprecated. Gets the line simplification factor.
int	getMaxLevel() Deprecated. Gets this builder's current maximum level.
boolean	isForceLinearInterpolation() Deprecated. Gets whether forcing linear interpolation is enabled or not.
boolean	isSimplifyAreas() Deprecated. Gets whether area simplification is enabled or not.
boolean	isSimplifyLines() Deprecated. Gets whether line simplification is enabled or not.
TLfnVectorCoverageMetadata.Builder	lineSimplificationFactor(double aFactor) Deprecated. Sets the line simplification factor.
TLfnVectorCoverageMetadata.Builder	maxLevel(int aMaxLevel) Deprecated. Sets the maximum level (most detailed level).
TLfnVectorCoverageMetadata.Builder	setDataModel(TLcdDataModel aDataModel) Deprecated. use dataModel(com.luciad.datamodel.TLcdDataModel) instead
TLfnVectorCoverageMetadata.Builder	setMaxLevel(int aMaxLevel) Deprecated. use maxLevel(int) instead
TLfnVectorCoverageMetadata.Builder	simplifyAreas() Deprecated. Enables area simplification using the default settings.
TLfnVectorCoverageMetadata.Builder	simplifyAreas(boolean aOn) Deprecated. Enables or disables area simplification using the default settings.
TLfnVectorCoverageMetadata.Builder	simplifyLines() Deprecated. Enables line simplification using the default settings.
TLfnVectorCoverageMetadata.Builder	simplifyLines(boolean aOn) Deprecated. Enables or disables line simplification using the default settings.
TLfnVectorCoverageMetadata.Builder	type(ELfnDataType aType) Deprecated. Sets the required type of the coverage.

Methods inherited from class com.luciad.fusion.tilestore.metadata.ALfnCoverageMetadata.Builder

addAssetInfo, addAssetInfo, assetInfos, assetInfos, assetSourcesInTileStore, boundingBox, dataDensity, featureTypeStyles, featureTypeStyles, format, formatVersion, geoReference, getAssetInfos, getBoundingBox, getDataDensity, getFeatureTypeStyles, getFormat, getFormatVersion, getGeoReference, getLevel0ColumnCount, getLevel0RowCount, getMessageDigestAlgorithm, getScaleDenominators, getType, ignoreNonFatalFailures, ignoreNonFatalFailures, isAssetSourcesInTileStore, isIgnoreNonFatalFailures, layout, level0ColumnCount, level0RowCount, messageDigestAlgorithm, scaleDenominators, scaleDenominators, setAssetInfos, setAssetInfos, setBoundingBox, setCoverageLayout, setDataDensity, setFormat, setFormatVersion, setGeoReference, setLevel0ColumnCount, setLevel0RowCount, setMessageDigestAlgorithm, setScaleDenominators, setScaleDenominators, setType, tileFormat

Methods inherited from class com.luciad.fusion.tilestore.metadata.ALfnResourceMetadata.Builder

abstract_, getAbstract, getGlobalUpdateSequence, getId, getISO19115Metadata, getName, getUpdateSequence, globalUpdateSequence, id, iso19115Metadata, name, setAbstract, setId, setISO19115Metadata, setName, setUpdateSequence, updateSequence

Methods inherited from class java.lang.Object

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

Method Detail

type

public TLfnVectorCoverageMetadata.Builder type(ELfnDataType aType)

Deprecated.

Description copied from class: ALfnCoverageMetadata.Builder

Sets the required type of the coverage. If not set, or if set to null, the default type will be used.

For vector coverages, the default type is VECTOR.

For raster coverages, the default type depends on the asset metadatas.

• If no asset metadatas have been set, the default type is IMAGE.
• If the asset metadatas have a common type, then this will be the default.
• If the asset metadatas have a mixture of types, the default will be IMAGE since it is the greatest common denominator.

As a consequence of this method, the default tile size will be adjusted, and possibly also the default bounding box, aiming for square pixels.

For non-tiled coverages, the type is always null.

Overrides:

type in class ALfnCoverageMetadata.Builder<TLfnVectorCoverageMetadata.Builder>

Parameters:

aType - a type, or null to indicate the default type

Returns:

this builder

dataModel

public final TLfnVectorCoverageMetadata.Builder dataModel(TLcdDataModel aDataModel)

Deprecated.

Sets the data model of the coverage. The data model should conform to the structure and conventions of a coverage data model. If not set or if set to null, the default data model will be used. In order for this to work, the asset metadatas must have been set using ALfnCoverageMetadata.Builder.addAssetInfo(ALfnAssetMetadata, String).

The default data model is built automatically from the asset's data models, according to the structure and conventions of a coverage data model. Each existing data model will become a named data model in the coverage data model (with a prefixed name), containing all of its declared data types.

Usually it suffices to leave the data model to the default. The cases where you explicitly want to build your own custom coverage data model should be rare.

Parameters:

aDataModel - the anonymous data model for the coverage, or null to reset to default

Returns:

this builder

Since:

2013.0

See Also:

buildDataModel(com.luciad.datamodel.TLcdDataModel...)

setDataModel

public final TLfnVectorCoverageMetadata.Builder setDataModel(TLcdDataModel aDataModel)

Deprecated. use dataModel(com.luciad.datamodel.TLcdDataModel) instead

maxLevel

public final TLfnVectorCoverageMetadata.Builder maxLevel(int aMaxLevel)

Deprecated.

Sets the maximum level (most detailed level). Sane values are in the range [0..23]. If not set or if set to a negative value, the default max. level will be used. The default max. level is based on the SLD feature type styles, the scale denominators for the OGC filters, and the scale denominators of the asset parts.

• SLD feature type styles take precendence if set. The default max. level is based on the minimum of the max. scale denominators of all the SLD rules.
• As a fallback, OGC filters are used. The default max. level is based on the minimum of the scale denominators for which OGC filters are defined.
• As a second fallback, the asset part's scale denominators are used. The default max. level is based on a weighted average of the scale denominators of the asset parts. The weights are relative to the bounding boxes, transformed to the coverage's geographic reference if necessary. Asset parts with unknown scale denominators have 0 weight (are effectively ignored).
• If no asset parts have known scale denominators, max. level 0 is used as ultimate fallback.

Parameters:

aMaxLevel - a max level

Returns:

this builder

Since:

2013.0

setMaxLevel

public final TLfnVectorCoverageMetadata.Builder setMaxLevel(int aMaxLevel)

Deprecated. use maxLevel(int) instead

forceLinearInterpolation

public final TLfnVectorCoverageMetadata.Builder forceLinearInterpolation(boolean aOn)

Deprecated.

Sets whether forcing linear interpolation is enabled or not.

The default value is false.

Parameters:

aOn - true if the interpolation is forced to linear, even if the data indicates otherwise

Returns:

this builder

Since:

2013.0

See Also:

TLfnVectorCoverageMetadata.isForceLinearInterpolation()

simplifyLines

public TLfnVectorCoverageMetadata.Builder simplifyLines()

Deprecated.

Enables line simplification using the default settings.

Short for:

   simplifyLines( true )
 

Returns:

this builder

Since:

2013.0

See Also:

lineSimplificationFactor(double), TLfnVectorCoverageMetadata.getLineSimplificationFactor()

simplifyLines

public TLfnVectorCoverageMetadata.Builder simplifyLines(boolean aOn)

Deprecated.

Enables or disables line simplification using the default settings.

By default, line simplification is disabled.

Parameters:

aOn - true or false to enable or disables line simplification

Returns:

this builder

Since:

2013.0

See Also:

TLfnVectorCoverageMetadata.getLineSimplificationFactor()

isSimplifyLines

public boolean isSimplifyLines()

Deprecated.

Gets whether line simplification is enabled or not.

Returns:

whether line simplification is enabled or not

Since:

2013.0

See Also:

simplifyLines(boolean)

lineSimplificationFactor

public TLfnVectorCoverageMetadata.Builder lineSimplificationFactor(double aFactor)

Deprecated.

Sets the line simplification factor. This factor determines the number of points which are removed from a line at a certain scale.

Possible values:

• 1.0: built-in default simplification factor
• >1.0: more simplification
• <1.0: less simplification
• 0.0: no simplification

See TLfnVectorCoverageMetadata.getLineSimplificationFactor() for more information.

Parameters:

aFactor - the line simplification factor

Returns:

this builder

Since:

2013.0

See Also:

TLfnVectorCoverageMetadata.getLineSimplificationFactor()

getLineSimplificationFactor

public double getLineSimplificationFactor()

Deprecated.

Gets the line simplification factor.

Returns:

the line simplification factor

Since:

2013.0

See Also:

TLfnVectorCoverageMetadata.getLineSimplificationFactor()

simplifyAreas

public TLfnVectorCoverageMetadata.Builder simplifyAreas()

Deprecated.

Enables area simplification using the default settings.

Short for:

   simplifyAreas( true )
 

Returns:

this builder.

Since:

2013.0

See Also:

areaSimplificationFactor(double), TLfnVectorCoverageMetadata.getAreaSimplificationFactor()

simplifyAreas

public TLfnVectorCoverageMetadata.Builder simplifyAreas(boolean aOn)

Deprecated.

Enables or disables area simplification using the default settings.

By default, area simplification is disabled.

Parameters:

aOn - true enables area simplification, false disables area simplification

Returns:

this builder

Since:

2013.0

See Also:

TLfnVectorCoverageMetadata.getAreaSimplificationFactor()

isSimplifyAreas

public boolean isSimplifyAreas()

Deprecated.

Gets whether area simplification is enabled or not.

Returns:

whether area simplification is enabled or not

Since:

2013.0

See Also:

simplifyAreas(boolean)

areaSimplificationFactor

public TLfnVectorCoverageMetadata.Builder areaSimplificationFactor(double aFactor)

Deprecated.

Sets the area simplification factor. This factor determines the size of the areas which are removed at a certain scale.

Possible values:

• 1.0: built-in default simplification factor
• >1.0: more simplification
• <1.0: less simplification
• 0.0: no simplification

See TLfnVectorCoverageMetadata.getAreaSimplificationFactor() for more information.

Parameters:

aFactor - the area simplification factor

Returns:

this builder

Since:

2013.0

See Also:

TLfnVectorCoverageMetadata.getAreaSimplificationFactor()

getAreaSimplificationFactor

public double getAreaSimplificationFactor()

Deprecated.

Gets the area simplification factor.

Returns:

the area simplification factor

Since:

2013.0

See Also:

TLfnVectorCoverageMetadata.getAreaSimplificationFactor()

filters

public final TLfnVectorCoverageMetadata.Builder filters(Map<Integer,TLcdOGCFilter> aFiltersByScaleDenominator)

Deprecated.

Sets the OGC filters to be used for this coverage. The OGC filters define which features should be visible at which scale denominator. If not ser or if set to null, the default OGC filters will be used, which is an empty map.

The preferred way to define visibility of features is by using SLD feature type styles.

Setting the filters may cause changes to the default max. level.

Warning: the OGC filters and SLD feature type styles are mutually exclusive. Setting them both will throw an exception when trying to build the vector coverage metadata.

Parameters:

aFiltersByScaleDenominator - the filters to be used, or null to reset to default

Returns:

this builder

Since:

2013.0

See Also:

ALfnCoverageMetadata.Builder.featureTypeStyles(java.util.List), getFilters()

filter

public final TLfnVectorCoverageMetadata.Builder filter(Map<Integer,TLcdOGCFilter> aFiltersByScaleDenominator)

Deprecated. use filters(java.util.Map) instead

buildDataModel

public final TLfnVectorCoverageMetadata.Builder buildDataModel(TLcdDataModel... aAssetDataModels)

Deprecated. instead use ALfnCoverageMetadata.Builder.addAssetInfo(ALfnAssetMetadata, String) and leave the data model to the default, which also has the effect that the coverage data model will be generated from the asset's data models

Builds and sets a new data model created from existing (asset) data models, according to the structure and conventions of a coverage data model.

Each existing data model will become a named data model in the coverage data model (with a prefixed name), containing all of its declared data types.

In some (rare) cases, it does not suffice to create a coverage data model from the asset data models. Consider the alternative method dataModel(TLcdDataModel) for setting your own custom built coverage data model.

Parameters:

aAssetDataModels - the input data models

Returns:

this builder

See Also:

dataModel(com.luciad.datamodel.TLcdDataModel)

buildDataModel

public final TLfnVectorCoverageMetadata.Builder buildDataModel(Collection<TLcdDataModel> aAssetDataModels)

Deprecated. instead use ALfnCoverageMetadata.Builder.addAssetInfo(ALfnAssetMetadata, String) and leave the data model to the default, which also has the effect that the coverage data model will be generated from the asset's data models

Sets the asset data models from which to create the coverage data model.

Each asset data model will become a named data model in the coverage data model (with a prefixed name), containing all of its declaring data types.

In some (rare) cases, it does not suffice to create a coverage data model from the asset data models. Consider the alternative method dataModel(com.luciad.datamodel.TLcdDataModel) for setting your own custom built coverage data model.

Parameters:

aAssetDataModels - the asset data models to create the coverage data model from. May be empty but not null.

Returns:

this builder

Since:

2013.0

See Also:

dataModel(com.luciad.datamodel.TLcdDataModel)

getDataModel

public TLcdDataModel getDataModel()

Deprecated.

Gets this builder's current data model.

In case asset data models have been set on this builder with a buildDataModel(TLcdDataModel...) call, this method will trigger the generation of the coverage data model. For this, it is required that the coverage ID has also been set on this builder. If not, this method will throw IllegalStateException.

Returns:

the current data model, possibly null

Since:

2012.0

getMaxLevel

public int getMaxLevel()

Deprecated.

Gets this builder's current maximum level.

Returns:

the current maximum level

Since:

2012.0

isForceLinearInterpolation

public boolean isForceLinearInterpolation()

Deprecated.

Gets whether forcing linear interpolation is enabled or not.

Returns:

whether forcing linear interpolation is enabled or not

See Also:

TLfnVectorCoverageMetadata.isForceLinearInterpolation()

getFilters

public Map<Integer,TLcdOGCFilter> getFilters()

Deprecated.

Gets an immutable map of the filters, ordered by scale denominator. The filters define which features are visible up to which scale. Beyond that scale, features will become invisible.

Because features are filtered at discrete levels, visibility will not switch exactly at the given scales. The switch point may be a bit beyond the defined scales. For example, if a feature 'roads' is defined to be visible at scale 1:100000, the 'roads' are guaranteed to be visible at scale 1:100000, they may be visible a bit byond that, for example still visible at scale 1:120000, but they will become invisible at the scale corresponding to the first discrete level which is less detailed, for example invisible at scale 1:125000.

Returns:

a snapshot of the filters, ordered by scale denominator, possibly empty but never null

build

public TLfnVectorCoverageMetadata build()

Deprecated.

Builds an immutable vector coverage metadata.

Note that the bounding box will be converted to an equivalent bounding box if the specified bounding box is not compatible with the geographic reference. In practice this means that a conversion will occur if a geodetic reference is used and the specified bounding box type does take this into account.

Specified by:

build in class ALfnCoverageMetadata.Builder<TLfnVectorCoverageMetadata.Builder>

Returns:

an immutable vector coverage metadata

Throws:

NullPointerException - in case one or more required fields have not been set