Package com.luciad.view.lightspeed

package com.luciad.view.lightspeed

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

Related Packages

Package	Description
com.luciad.view	General aspects of views.
com.luciad.view.lightspeed.action	Provides various actions that affect an ILspView.
com.luciad.view.lightspeed.camera	Contains view world transformations.
com.luciad.view.lightspeed.controller	Provides support for handling user interaction on an ILspView.
com.luciad.view.lightspeed.editor	Provides support for interactive editing of domain objects in a model.
com.luciad.view.lightspeed.geometry	Provides utilities for performing geometric operations, such as visibility culling and intersection tests.
com.luciad.view.lightspeed.javafx	This package provides JavaFX components which are related to a Lightspeed view or allow interaction with a view.
com.luciad.view.lightspeed.label	Handles the placement of labels in a view.
com.luciad.view.lightspeed.layer	Provides layering support for ILspView.
com.luciad.view.lightspeed.measure	This package contains classes for working with measurement values in a lightspeed view context.
com.luciad.view.lightspeed.painter	Painter interfaces and implementations for visualizing objects in an ILspView.
com.luciad.view.lightspeed.query	Provides support for querying the objects of a layer.
com.luciad.view.lightspeed.scale	Provides control over the relation between a view's map scale and the map scale as seen by stylers.
com.luciad.view.lightspeed.style	Provides a generic model for styles.
com.luciad.view.lightspeed.swing	This package provides Swing components which are related to a view or allow interaction with a view.
com.luciad.view.lightspeed.util	Contains utility classes related to Lightspeed views.

Class	Description
ALspAWTView	Abstract base class for implementations of ILspAWTView.
ALspViewAdapter	Empty implementation of ILspViewListener.
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.
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.
ILspPaintingOrder.PaintStep	Identifies a painting step consisting of an ILspLayer and a TLspPaintRepresentationState.
ILspView	An ILcdView to visualize geospatial data in 2D or 3D, based on OpenGL.
ILspView.ViewType	View type enumeration that distinguishes between 2D and 3D views.
ILspViewListener	Listener that can be added to an ILspView to be informed of initialization, dispose and render events.
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.
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.
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.