Class TLspDensityLayerBuilder
java.lang.Object
com.luciad.view.lightspeed.layer.ALspLayerBuilder
com.luciad.view.lightspeed.layer.density.TLspDensityLayerBuilder
Deprecated.
Builder for creating
ILspLayer
instances that visualize density plots of geometric shapes. This builder is the
recommended way of creating new density plots of a model that contains
ILcdShape
elements.
This layer builder uses the following default settings to allow for easy
layer setup, they can all be overridden using the methods available on this
builder:
- Default styles for points, curves and surfaces are used if none are
specified. The actual styling parameters are taken from
TLspDensityPointStyle
,TLspDensityLineStyle
andTLspDensityFillStyle
. - Default style for the false color index
- Labeling is disabled.
- The model descriptor display name is used as layer label.
- Culling is enabled.
- Density plots are not draped
ALspDensityStyle
instances, the painter also accepts
TLspIconStyle
, TLspLineStyle
, TLspWorldSizedLineStyle
,
and TLspFillStyle
. Note that
the style should use gray-scale colors.- Since:
- 2012.0
-
Method Summary
Modifier and TypeMethodDescriptionbodyScaleRange
(ILcdInterval aBodyScaleRange) Deprecated.Sets the scale range for the body of the layer.bodyStyler
(ILspStyler aBodyStyler) Deprecated.Sets the given body styler for the given paint state.bodyStyles
(ALspStyle... aBodyStyles) Deprecated.Sets the given body styles.build()
Deprecated.Creates a new layer instance.culling
(boolean aUseCulling) Deprecated.Sets whether the layer should use culling or not, enabled by default.densityScaleFactor
(float aDensityScaleFactor) Deprecated.When replacing the deprecatedTLspDensityPainter
with aTLspShapePainter
, you can specify the density scale factor on theTLspIndexColorModelStyle
(seeTLspIndexColorModelStyle.getScaleFactor()
).elevationMode
(ILspWorldElevationStyle.ElevationMode aElevationMode) Deprecated.When replacing the deprecatedTLspDensityPainter
with aTLspShapePainter
, you can specify the elevation mode in the density styles (seeALspDensityStyle.getElevationMode()
).filter
(ILcdDynamicFilter aFilter) Deprecated.Sets a filter that will be used to filter objects to prevent them from being painted by the layer.Deprecated.Sets the icon of the layer.indexColorModel
(TLspIndexColorModelStyle aIndexColorModelStyle) Deprecated.When replacing the deprecatedTLspDensityPainter
with aTLspShapePainter
, you can let the styler submit aTLspIndexColorModelStyle
in combination withALspDensityStyle
.Deprecated.Sets the label of the layer.labeled()
Deprecated.Sets whether to show labels with a default style.labelEditable
(boolean aEditable) Deprecated.Sets whether the labels of the layer should be editable.labelEditor
(ILspEditor aEditor) Deprecated.Sets a custom label editor for the layer, alternatively you can uselabelEditable(boolean)
to enable a default label editor.labelPainter
(ILspPainter aPainter) Deprecated.Allows setting a custom label painter on the layer.labelScaleRange
(ILcdInterval aLabelScaleRange) Deprecated.Sets the scale range for the labels of the layerlabelStyler
(TLspPaintState aPaintState, ILspStyler aLabelStyler) Deprecated.Sets the given label styles for the given paint state.labelStyles
(TLspPaintState aPaintState, ALspStyle... aLabelStyles) Deprecated.Sets the given label styles for the given paint state.layerStyle
(TLspLayerStyle aLayerStyle) Deprecated.Set a layer style to be used during the rendering of the layer.layerType
(ILspLayer.LayerType aLayerType) Deprecated.Sets the layer type of the layer.minimumObjectSizeForPainting
(double aMinimumObjectSizeForPainting) Deprecated.Sets the minimum size of an object in the view for it to be painted and handled otherwise.Deprecated.Sets the model of the layer.static TLspDensityLayerBuilder
Deprecated.static TLspDensityLayerBuilder
newBuilder
(ILspLayer.LayerType aLayerType) Deprecated.Creates a TLspDensityLayerBuilder.newBuilder with the given layer type.Methods inherited from class com.luciad.view.lightspeed.layer.ALspLayerBuilder
getIcon, getLabel, getLayerStyle, getLayerType, getModel
-
Method Details
-
newBuilder
Deprecated.- Returns:
- a new layer builder with the default settings.
-
newBuilder
Deprecated.Creates a TLspDensityLayerBuilder.newBuilder with the given layer type. When creating a layer for use with dynamic data, it is highly recommended to use theILspLayer.LayerType.REALTIME
layer type, since it provides various performance enhancements for dynamic data. Failing to do so may result in a non-negligible performance cost.- Parameters:
aLayerType
- the layer type for the layer built by this builder- Returns:
- a new layer builder with the given layer type
-
build
Deprecated.Description copied from class:ALspLayerBuilder
Creates a new layer instance.
- Specified by:
build
in classALspLayerBuilder
- Returns:
- the new layer instance
-
labelEditable
Deprecated.Sets whether the labels of the layer should be editable. A default label editor will be used if no label editor is provided.- Parameters:
aEditable
- whether the labels of the layer should be editable- Returns:
this
- See Also:
-
labeled
Deprecated.Sets whether to show labels with a default style. TheObject.toString()
method will be used to retrieve the label text.- Returns:
this
-
bodyStyler
Deprecated.Sets the given body styler for the given paint state. The following styles are supported:TLspDensityFillStyle
: can be applied to closed shapes such as circles or polygonsTLspDensityLineStyle
: can be applied to closed and non-closed shapes such as arcs and polylinesTLspDensityPointStyle
: can be applied to point shapes and point lists
- Parameters:
aBodyStyler
- the new body styler for the layer- Returns:
this
-
bodyStyles
Deprecated.Sets the given body styles. The following styles are supported:TLspDensityFillStyle
: can be applied to closed shapes such as circles or polygonsTLspDensityLineStyle
: can be applied to closed and non-closed shapes such as arcs and polylinesTLspDensityPointStyle
: can be applied to point shapes and point lists
- Parameters:
aBodyStyles
- the new body styles for the layer- Returns:
this
-
labelStyler
Deprecated.Sets the given label styles for the given paint state.If you need control over other labeling aspects such as positioning or priorities, use an
The following styles are supported:ALspLabelStyler
.- TLspTextStyle to get text with a specific font, font color, size, halo etc.
- TLspIconStyle to get custom images.
- ALspLabelTextProviderStyle to specify which text to use (default is
toString()
). See also TLspDataObjectLabelTextProviderStyle.- TLspLabelBoxStyle to specify fill color or frames
- TLspLabelOpacityStyle to specify the opacity and modulation color.
- TLspPinLineStyle to draw pins for the labels (see TLspLabelPainter)
- Parameters:
aPaintState
- the paint state for which to set the label styleraLabelStyler
- the new label styler for the layer- Returns:
this
-
labelStyles
Deprecated.Sets the given label styles for the given paint state. The following styles are supported:- TLspTextStyle to get text with a specific font, font color, size, halo etc.
- TLspIconStyle to get custom images.
- ALspLabelTextProviderStyle to specify which text to use (default is
toString()
). See also TLspDataObjectLabelTextProviderStyle.- TLspLabelBoxStyle to specify fill color or frames
- TLspLabelOpacityStyle to specify the opacity and modulation color.
- TLspPinLineStyle to draw pins for the labels (see TLspLabelPainter)
- Parameters:
aPaintState
- the paint state for which to set the label stylesaLabelStyles
- the new label styles for the layer- Returns:
this
-
labelPainter
Deprecated.Allows setting a custom label painter on the layer. In almost any case, it is better to configure the default label painter using thelabelStyler(TLspPaintState, ILspStyler)
orlabelStyles(TLspPaintState, ALspStyle...)
methods instead.- Parameters:
aPainter
- the label painter for the layer- Returns:
this
- See Also:
-
labelEditor
Deprecated.Sets a custom label editor for the layer, alternatively you can uselabelEditable(boolean)
to enable a default label editor.- Parameters:
aEditor
- the label editor for the layer- Returns:
this
- See Also:
-
bodyScaleRange
Deprecated.Sets the scale range for the body of the layer. By default, no scale range is used.- Parameters:
aBodyScaleRange
- the scale range for the body of the layer- Returns:
this
-
labelScaleRange
Deprecated.Sets the scale range for the labels of the layer- Parameters:
aLabelScaleRange
- the scale range for the labels of the layer- Returns:
this
-
culling
Deprecated.Sets whether the layer should use culling or not, enabled by default.- Parameters:
aUseCulling
- whether the layer should use culling or not- Returns:
this
-
filter
Deprecated.Sets a filter that will be used to filter objects to prevent them from being painted by the layer. No filter is set by default.- Parameters:
aFilter
- the filter- Returns:
this
-
elevationMode
@Deprecated public TLspDensityLayerBuilder elevationMode(ILspWorldElevationStyle.ElevationMode aElevationMode) Deprecated.When replacing the deprecatedTLspDensityPainter
with aTLspShapePainter
, you can specify the elevation mode in the density styles (seeALspDensityStyle.getElevationMode()
). Note that you have to specify the same elevation mode in all the density styles. Mixing different elevation modes was not supported by thisTLspDensityPainter
class, and is also not supported by theTLspShapePainter
.Sets the elevation mode. With density plots styles with different elevation modes cannot be mixed. Styles with other elevation modes are adapted to use the elevation mode supplied here. The default elevation mode isILspWorldElevationStyle.ElevationMode.ABOVE_ELLIPSOID
- Parameters:
aElevationMode
- the new elevation mode- Returns:
this
-
indexColorModel
@Deprecated public TLspDensityLayerBuilder indexColorModel(TLspIndexColorModelStyle aIndexColorModelStyle) Deprecated.When replacing the deprecatedTLspDensityPainter
with aTLspShapePainter
, you can let the styler submit aTLspIndexColorModelStyle
in combination withALspDensityStyle
.Sets the index color model with which to visualize the density plot.- Parameters:
aIndexColorModelStyle
- the new index color model- Returns:
this
-
minimumObjectSizeForPainting
Deprecated.Sets the minimum size of an object in the view for it to be painted and handled otherwise. So objects that are smaller as this minimum size are ignored during painting and duringapplyOnInteract
(which is for example used during selection). A value of 0 will always paint all objects, no matter how small they appear. Larger values can discard more objects. This typically improves the painting speed, although it might leave undesirable gaps in models containing many small objects. The default value is 1 pixel.- Parameters:
aMinimumObjectSizeForPainting
- The minimal size, expressed in pixels.- Returns:
this
-
densityScaleFactor
Deprecated.When replacing the deprecatedTLspDensityPainter
with aTLspShapePainter
, you can specify the density scale factor on theTLspIndexColorModelStyle
(seeTLspIndexColorModelStyle.getScaleFactor()
).Sets a global scale factor with which density values are multiplied prior to looking them up in the color model.- Parameters:
aDensityScaleFactor
- the scale factor for density values- Returns:
this
-
model
Deprecated.Description copied from class:ALspLayerBuilder
Sets the model of the layer. The default value isnull
.- Overrides:
model
in classALspLayerBuilder
- Parameters:
aModel
- a model- Returns:
- this builder
- See Also:
-
label
Deprecated.Description copied from class:ALspLayerBuilder
Sets the label of the layer. This is a short textual representation for it, often used to represent the layer to end-users. The default value isnull
.- Overrides:
label
in classALspLayerBuilder
- Parameters:
aLabel
- the label- Returns:
- this builder
- See Also:
-
layerType
Deprecated.Description copied from class:ALspLayerBuilder
Sets the layer type of the layer. The default value isILspLayer.LayerType.EDITABLE
.- Overrides:
layerType
in classALspLayerBuilder
- Parameters:
aLayerType
- the layer type- Returns:
- this builder
- See Also:
-
icon
Deprecated.Description copied from class:ALspLayerBuilder
Sets the icon of the layer. The default value isnull
.- Overrides:
icon
in classALspLayerBuilder
- Parameters:
aIcon
- the icon- Returns:
- this builder
- See Also:
-
layerStyle
Deprecated.Description copied from class:ALspLayerBuilder
Set a layer style to be used during the rendering of the layer.TLspLayerStyle
is used to style the layer as a whole. Layer style can for example modify the transparency of a layer. Also, layer style can be modified after building the layer by callingILspLayer.setLayerStyle(TLspLayerStyle)
.- Overrides:
layerStyle
in classALspLayerBuilder
- Parameters:
aLayerStyle
- the layer style. Must not benull
. If you want to set the default layer style, setTLspLayerStyle.newBuilder().build()
- Returns:
- this
- See Also:
-
TLspLayer
and its corresponding builderTLspShapeLayerBuilder
can deal with density styles. Consult the class javadoc ofTLspShapePainter
for more information on how to use density styling with a regular shape layer.