Package com.luciad.fusion.tilestore.metadata

Class TLfnVectorCoverageMetadata.Builder

java.lang.Object
com.luciad.fusion.tilestore.metadata.ALfnResourceMetadata.Builder<TLfnVectorCoverageMetadata.Builder>
com.luciad.fusion.tilestore.metadata.ALfnCoverageMetadata.Builder<TLfnVectorCoverageMetadata.Builder>
com.luciad.fusion.tilestore.metadata.TLfnVectorCoverageMetadata.Builder
Enclosing class:
TLfnVectorCoverageMetadata
public static class TLfnVectorCoverageMetadata.Builder extends ALfnCoverageMetadata.Builder<TLfnVectorCoverageMetadata.Builder>
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.
Builder for vector coverage metadata. See the super class for more information.
Since:
11.0
See Also:

  • Method Details

    • 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:

    • 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:

    • 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:

    • 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:

    • 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:

    • 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:

    • getLineSimplificationFactor

      public double getLineSimplificationFactor()
      Deprecated.

      Gets the line simplification factor.

      Returns:
      the line simplification factor
      Since:
      2013.0
      See Also:

    • 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:

    • 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:

    • 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:

    • 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:

    • getAreaSimplificationFactor

      public double getAreaSimplificationFactor()
      Deprecated.

      Gets the area simplification factor.

      Returns:
      the area simplification factor
      Since:
      2013.0
      See Also:

    • 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:

    • 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:

    • 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:

    • 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:

    • 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