Interface Summary
Interface	Description
ILspAWTView	Defines an `ILspView` which is represented on screen by an AWT or Swing component.
ILspPaintingOrder	Determines the order in which layers and their various painters are invoked in an `ILspView`.
ILspView	An `ILcdView` to visualize geospatial data in 2D or 3D, based on OpenGL.
ILspViewListener	Listener that can be added to an `ILspView` to be informed of initialization, dispose and render events.

Class Summary
Class	Description
ALspAWTView	Abstract base class for implementations of `ILspAWTView`.
ALspViewAdapter	Empty implementation of `ILspViewListener`.
ILspPaintingOrder.PaintStep	Identifies a painting step consisting of an `ILspLayer` and a `TLspPaintRepresentationState`.
TLspAWTView	An `ILspView` which is represented by an AWT component.
TLspContext	Provides context information to be used when painting or editing an object in an `ILspView`.
~~TLspExternalView~~	Deprecated Integration of LuciadLightspeed in C++ applications is no longer actively supported as of V2020.0.
TLspFXView	An `ILspView` which is represented by a JavaFX node.
TLspOffscreenView	An offscreen Lightspeed view that uses an internal buffer to render images to.
TLspOpenGLProfile	Provides a mechanism to classify the level of OpenGL support on an end-user system.
TLspPaintingOrder	Default implementation of `ILspPaintingOrder`.
TLspPaintPass	Combination of a paint phase and paint representation state that describes which object representation to paint during a given paint pass.
TLspPaintPhase	Class that describes the current paint phase.
TLspPaintProgress	Class describing the progress of paint operations in an `ILspView`.
TLspStereoDeviceBuilder	Builder to create a `TLspStereoscopicDevice`, which can be used to create a stereoscopic 3D view, (see `TLspViewBuilder.buildStereoscopicView(TLspStereoscopicDevice)`).
TLspStereoscopicDevice	This class can be used to create stereoscopic views for stereoscopic devices.
TLspSwingView	An `ILspAWTView` which is represented by a Swing component.
TLspViewBuilder	Builder for creating `ILspView` instances.
TLspViewPaintingHints	Defines hints that influence the behavior of `ILspView`, allowing the user to bias either towards higher performance or towards better visual quality.
TLspViewPaintingHints.Builder	Builder for `TLspViewPaintingHints` objects.
TLspViewPrintSettings	Provides configuration parameters used for printing the contents of an `ILspView`.
TLspViewPrintSettings.Builder	Builder for TLspViewPrintSettings objects.
TLspViewServices	An `ILspView` provides a number of useful services that can be leveraged by its layers, for performance or other reasons: A render target stack allows for nested rendering into offscreen buffers.

Enum Summary
Enum	Description
ELspQualityHint	Enumeration of quality hints, which indicate a user preference towards either high performance (ELspQualityHint.FASTEST) or correctness/visual quality (ELspQualityHint.NICEST) for data painted in an ILspView.
ILspView.ViewType	View type enumeration that distinguishes between 2D and 3D views.
TLspPaintPhase.PaintDraping	Identifies how the objects are added to the world: draped on terrain or not.
TLspPaintPhase.PaintOpacity	Identifies the current paint phase in the transparency algorithm and hence which objects should be drawn.
TLspPaintPhase.PaintStereo	Identifies for which eye the view should be rendered for a stereoscopic view.

Package com.luciad.view.lightspeed Description

Provides support for OpenGL-based 2D and 3D visualization of data. The main interface in this package is ILspView, which defines a view consisting of a number of ILspLayers.

Creating a view

The main view implementations are

TLspAWTView, which uses a heavyweight GLCanvas component;
TLspSwingView, which uses a lightweight GLJPanel component;
TLspOffscreenView, which uses an offscreen buffer.

Most applications will want to use TLspAWTView. TLspViewBuilder provides a convenient mechanism to create views and to initialize their most important properties.

2D and 3D views

A view can be 2D or 3D depending on its ALspViewXYZWorldTransformation. Typically, 3D views will use a geocentric world reference, whereas 2D views will have a grid reference with a particular map projection. The class TLspViewTransformationUtil offers convenient methods to switch a view between 2D and 3D.

3D views support the use of graphics effects such as lighting and fog to produce more visually striking images. TLspViewBuilder.defaultEffects() provides a useful default setup. For manual configuration of effects, see the com.luciad.view.lightspeed.services.effects package.

Adding data to a view

Depending on the type of data you wish to visualize, various layer builders are available to create ILspLayer instances which can then be added to a view. The main ones are:

TLspShapeLayerBuilder for models that contain vector shapes (points, polylines, polygons, ...) or for density plots.
TLspRasterLayerBuilder for raster-based elevation and imagery data
TLspLonLatGridLayerBuilder for visualizing longitude/latitude grid lines in the view

Most layers support the use of the styling API to customize the visualization of your data.

Note that TLspViewNavigationUtil can be used to fit the extents of the view to the data present in a particular layer or set of layers.

Working with elevation data

Lightspeed views have built-in support for visualization elevation data in the form of a 3D terrain. As mentioned above, TLspRasterLayerBuilder can be used to create layers for elevation models. The view will automatically pick up any such layers and merge them into a single 3D terrain which is displayed when the view is 3D. Layers which contain 2D raster or vector data can be draped over the 3D terrain. In most cases, 2D shapes and rasters will be draped automatically. If manual control is needed, draping can be controlled with fine granularity using the styling API. All styles which implement ILspWorldElevationStyle can be used to indicate whether or not affected shapes should be draped on the terrain.

Interacting with a view

Interaction with a view is handled by an ILspController. Various implementations of this interface are available in the com.luciad.view.lightspeed.controller package to support actions such as navigation, selection and drawing. Newly created views have a default controller which combines navigation and selection functionality.

Navigation is also possible using GUI components that can be overlaid on the view. See TLspNavigationControlsBuilder for more information.

Since:: 2012.0