com.luciad.format.tiled3d.lightspeed

LuciadFusionClass TLsp3DTileLayerBuilder

java.lang.Object

com.luciad.view.lightspeed.layer.ALspLayerBuilder

com.luciad.format.tiled3d.lightspeed.TLsp3DTileLayerBuilder

public class TLsp3DTileLayerBuilder
extends ALspLayerBuilder

Layer builder for models that contain 3D tile data, such as those decoded by TLcdOGC3DTilesModelDecoder or TLcdOSGBModelDecoder. The layers created by this builder will adaptively refine the 3D tile data to create a suitable level of detail for the user's current viewpoint.

3D tile layers support the following styles:

• TLsp3DMeshStyle for mesh data (B3DM, OSGB)
• TLspPointCloudStyle for point clouds (PNTS)

The default styler installed by this builder works for both meshes and point clouds, and will use the color attribute of the point cloud if one is present.

Since:

2018.0

Method Summary

Modifier and Type	Method and Description
TLsp3DTileLayerBuilder	bodyStyler(TLspPaintState aPaintState, ILspStyler aBodyStyler)
TLsp3DTileLayerBuilder	bodyStyles(TLspPaintState aPaintState, ALspStyle... aBodyStyles)
TLspLayer	build() Creates a new layer instance.
TLsp3DTileLayerBuilder	icon(ILcdIcon aIcon) Sets the icon of the layer.
TLsp3DTileLayerBuilder	label(String aLabel) Sets the label of the layer.
TLsp3DTileLayerBuilder	layerStyle(TLspLayerStyle aLayerStyle) Set a layer style to be used during the rendering of the layer.
TLsp3DTileLayerBuilder	model(ILcdModel aModel) Sets the model of the layer.
static TLsp3DTileLayerBuilder	newBuilder()
TLsp3DTileLayerBuilder	offsetTerrain(boolean aOffsetTerrain) Sets whether or not the terrain must be offset at the location of a 3D mesh or point cloud.
TLsp3DTileLayerBuilder	qualityFactor(double aFactor) Sets a quality factor that biases the level-of-detail selection of the 3D tile layer.
TLsp3DTileLayerBuilder	synchronous(boolean aSynchronous) Specifies whether created layers should paint synchronously.

Methods inherited from class com.luciad.view.lightspeed.layer.ALspLayerBuilder

getIcon, getLabel, getLayerStyle, getLayerType, getModel, layerType

Methods inherited from class java.lang.Object

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

Method Detail

newBuilder

public static TLsp3DTileLayerBuilder newBuilder()

qualityFactor

public TLsp3DTileLayerBuilder qualityFactor(double aFactor)

Sets a quality factor that biases the level-of-detail selection of the 3D tile layer. You can use this setting to trade off between visual quality and performance.

The default value of 1.0, for meshes and point cloud data produced by LuciadFusion, results in format-specific default behavior. Higher values increase the detail level, lower values decrease it.

For point cloud data not produced by LuciadFusion, a default quality factor of 0.125 is used to safeguard against overestimation of the geometric error.

Parameters:

aFactor - the scale factor for the layer's level of detail. Values smaller than 1 will decrease the detail level. Values larger than 1 increase the detail level.

Returns:

this

offsetTerrain

public TLsp3DTileLayerBuilder offsetTerrain(boolean aOffsetTerrain)

Sets whether or not the terrain must be offset at the location of a 3D mesh or point cloud. This will prevent the terrain layer intersecting the 3D mesh or point cloud. By default this is enabled for meshes only. When set to true the offset is applied both for meshes and point clouds, when set to false the offset is never applied.

Parameters:

aOffsetTerrain -

Returns:

this

model

public TLsp3DTileLayerBuilder model(ILcdModel aModel)

Description copied from class: ALspLayerBuilder

Sets the model of the layer.

The default value is null.

Overrides:

model in class ALspLayerBuilder

Parameters:

aModel - a model

Returns:

this builder

See Also:

ILcdLayer.getModel()

label

public TLsp3DTileLayerBuilder label(String aLabel)

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 is null.

Overrides:

label in class ALspLayerBuilder

Parameters:

aLabel - the label

Returns:

this builder

See Also:

ILcdLayer.getLabel()

icon

public TLsp3DTileLayerBuilder icon(ILcdIcon aIcon)

Description copied from class: ALspLayerBuilder

Sets the icon of the layer.

The default value is null.

Overrides:

icon in class ALspLayerBuilder

Parameters:

aIcon - the icon

Returns:

this builder

See Also:

ILcdLayer.getIcon()

layerStyle

public TLsp3DTileLayerBuilder layerStyle(TLspLayerStyle aLayerStyle)

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 calling ILspLayer.setLayerStyle(TLspLayerStyle).

Overrides:

layerStyle in class ALspLayerBuilder

Parameters:

aLayerStyle - the layer style. Must not be null. If you want to set the default layer style, set TLspLayerStyle.newBuilder().build()

Returns:

this

See Also:

ILspLayer.getLayerStyle(), ILspLayer.setLayerStyle(TLspLayerStyle)

bodyStyler

public TLsp3DTileLayerBuilder bodyStyler(TLspPaintState aPaintState,
                                         ILspStyler aBodyStyler)

bodyStyles

public TLsp3DTileLayerBuilder bodyStyles(TLspPaintState aPaintState,
                                         ALspStyle... aBodyStyles)

synchronous

public TLsp3DTileLayerBuilder synchronous(boolean aSynchronous)

Specifies whether created layers should paint synchronously. The default is false and allows layers to perform shape discretization and other expensive processing using the view's ILspTaskExecutor. When synchronous mode is on, all such tasks are performed on the EDT.

It is strongly recommended to leave this setting off, to ensure that the application remains responsive. Applications that need to change the view's world reference on a regular basis, however, may want to consider synchronous mode to avoid flickering.

Parameters:

aSynchronous - true if the layer should paint synchronously

Returns:

this

build

public TLspLayer build()

Description copied from class: ALspLayerBuilder

Creates a new layer instance.

Specified by:

build in class ALspLayerBuilder

Returns:

the new layer instance