Getting Started

 
Changed in 2024.0

Installation

Finish your installation and set up your IDE to start developing.

What's new

The feature highlights of this version.

Choose your technology

Overview of the technology options for your application.

Basic application

Write your first basic LuciadLightspeed applications.

Basic 2D application

Write your first basic 2D LuciadLightspeed applications.

Basic Lucy addon

Write your first basic Lucy application addon.

Upgrading LuciadLightspeed

Upgrade to a new version.

User guides

End user guides for elaborate demo or sample applications.

Product reference information

Discover the data types supported in LuciadLightspeed and LuciadLightspeed tier information.

Architecture

 

Core concepts

Find out how the API supports the development of a Model-View-Controller (MVC) application, and how to approach models, views, and layers starting from those MVC principles.

Threads and locks

Efficiently use threads and locks.

Services mechanism

Learn about the service loader mechanism.

Performance guidelines

Design and implement a smoothly running application.

Logging

Set up your logging framework.

Packaging

Learn how to integrate LuciadLightspeed into your application, package it, and prepare it for deployment.

Models

 

Reading and writing

Learn how to access and modify model data.

Working with domain object properties

Learn how to use the ILcdDataObject interface to retrieve and display the properties of vector domain objects.

Supporting custom formats

Learn how to add support for your own business data.
Changed in 2024.0

Model references

All about georeferencing your data.

Handling vector data

How to handle vector domain objects.

Handling raster data

How to work with raster data, including RGB, multi-spectral, and HDR imagery.

Handling multi-dimensional data

Decoding multi-dimensional data.

Clustering model objects

Clustering objects in models with many objects.

ISO metadata standards

Supporting metadata standards ISO 19115 and ISO19139.

OpenCL

The Open Computing language (OpenCL) allows applications to perform computations on the GPU.

Accessing cloud data

Learn how to access data stored in the cloud.

Lightspeed Views

 

Working with the view

Set up and customize the Lightspeed view.

Working with a JavaFX view

Use JavaFX in your LuciadLightspeed application.

Visualizing vector data

Learn how to display, style and label vector data.

Visualizing raster data

Learn how to display and style raster data.

Visualizing a grid

Add a grid to the view.

Interacting with the view

Learn how to use controllers to navigate, select, edit, create and measure on the view.

Adding graphical effects

Learn how to add lighting, atmosphere, and fog to your view.

Printing and exporting

Learn how to print the maps displayed in a view, or export them to a file.

Vertical view

Learn how to display your data in a vertical view.

UI widgets

Learn about the available UI widgets for a Lightspeed view.

Offscreen views

Learn how to use offscreen Lightspeed views.

Performance

Boost Lightspeed view performance.

Troubleshooting

Known issues and troubleshooting tips and tricks.

.NET integration

Integrating LuciadLightspeed view in a .NET application.

OpenGL

LuciadLightspeed applications with a Lightspeed view make use of OpenGL. OpenGL is a cross-platform standard API for hardware-accelerated 3D rendering.

Lucy

 

Getting started

Learn the basics about the Lucy architecture and set up your Lucy project.

The Lucy services mechanism

Learn more about how to use the service registry to share objects between add-ons.

Writing add-ons

The basic building blocks to create your own add-ons.

Preferences

An application-wide preferences mechanism where add-ons can store information in.

Lightspeed maps

Create, manage and modify maps containing a Lightspeed view.

GXY maps

Create, manage and modify maps containing a GXY view.

Loading data

Load data and connect to servers using the API.

Support custom data

Add support for your own custom data to Lucy.

Action bars

Add and remove items from the menu bars, tool bars and popup menus in Lucy.

UI panels

Adding or removing panels (called application panes) to the Lucy UI.

Customizer panels

The API behind the panels containing a user interface to customize some object.

Workspaces

Store and restore the state of your Lucy application.

Progress reporting

Show progress and receive progress notifications about long running tasks.

Internationalization (i18n)

Translate your Lucy-based application.

Backend

The backend exposes functionality that is shared among the different add-ons.

Frontend

Use a custom frontend for your Lucy application.

Lucy MapCentric

Learn about the customization options for the map centric front-end of Lucy.

Deployment

Deploy your Lucy application.

Lucy Add-ons

 

AIXM5 add-on

The TLcyAIXM51AddOn, TLcyLspAIXM51FormatAddOn and TLcyAIXM51RealtimeAddOn provide visualization support for AIXM 5.1 data.

Asynchronous painting add-on

The TLcyAsynchronousPaintAddOn offers support for painting GXY layers in a thread that differs from the EDT, keeping the view responsive.

Camera linking add-on

The TLcyLspCameraLinkAddOn adds tracking camera functionality to Lightspeed maps.

Contours add-on

The TLcyContourAddOn computes and visualizes height lines for ILcdShape objects.

Debugging add-on

The TLcyDebugAddOn adds UI elements to Lucy which facilitates debugging.

Drawing add-on

The TLcyDrawingAddOn and TLcyLspDrawingAddOn allow the user to make annotations on the map.

Extreme points add-on

The TLcyExtremePointAddOn computes and visualizes highest and lowest points for ILcdShape objects.

Format bar add-on

The TLcyFormatBarAddOn shows a tool bar which allows to create and edit shapes.

GXY map add-on

The TLcyMapAddOn is responsible for the creation and management of map components with a GXY view.

Hypsometry add-on

The TLcyHypsometryAddon computes and visualizes hypsometric information for a given layer or the entire view.

Lightspeed map add-on

The TLcyLspMapAddOn is responsible for the creation and management of map components with a Lightspeed view.

Line of Sight coverage (GXY) add-on

The TLcyLOSCoverageAddOn computes and visualizes line-of-sight coverages (LOS coverages) for Lucy GXY.

Line of Sight coverage add-on

The TLcyLOSAddOn and TLcyLspLOSAddOn compute and visualize line-of-sight coverages (LOS coverages) for Lucy on Lightspeed maps.

Map editing units add-on

The TLcyMapEditUnitAddOn supports the selection of unit formatting for physical values, such as longitude, latitude, speed, and duration.

Map overview add-on

The TLcyMapOverviewAddOn and TLcyLspMapOverviewAddOn provide an overview map which contains an indication of the area of the main map.

Military symbology add-ons

The MS2525B and APP6A addons allow you to visualize and edit MIL-STD-2525 and APP-6 data on Lucy maps.

Persistent preferences add-on

The TLcyPersistentPreferencesAddOn stores and restores the preferences to persistent storage.

Preview add-on

The TLcyPreviewAddOn and TLcyLspPreviewAddOn provide controls to play back time-dependent data.

Printing add-on

The TLcyPrintAddOn and TLcyLspPrintAddOn allow you to print a map.

Search add-on

The TLcySearchAddOn is responsible for the search box and its search logic.

Selection editor add-on

The TLcySelectionEditorAddOn is responsible for showing the Object Properties panel.

Table view add-on

The TLcyToteAddOn and TLcyLspToteAddOn provide a customizer panel which shows the model contents as a tabular view.

TEA controller add-on

The TLcyTEAControllerAddOn shows a tooltip for elevation data and allows you to inspect the height of an area specified by a line segment.

Tree table view add-on

The TLcyTreeTableViewAddOn provides a customizer panel which can show the properties of an object.

Undo/redo add-on

The TLcyUndoAddOn adds menu entries to undo and redo the last operations.

Vertical view add-on

The TLcyVerticalViewAddOn allows to display a vertical (or profile) view along some polyline.

Viewshed add-on

The TLcyViewshedAddOn computes and visualizes visibility for a 3D scene composed of terrain, buildings and 3D meshes.

Visibility (GXY) add-on

The TLcyVisibilityAddOn computes and visualizes what parts of one or more objects can be seen from one or more other objects.

Visibility add-on

The TLcyShapeVisibilityAddOn and TLcyLspShapeVisibilityFormatAddOn compute and visualize what parts of one or more objects can be seen from one or more points.

WCS client add-on

The TLcyWCSClientAddOn and TLcyLspWCSClientAddOn allow you to connect to WCS servers, and visualize the data offered by the server.

WFS client add-on

The TLcyWFSClientAddOn and TLcyLspWFSClientAddOn allow you to connect to WFS servers, and visualize the data offered by the server.

WMS client add-on

The TLcyWMSClientAddOn and TLcyLspWMSClientAddOn allow you to connect to WMS servers, and visualize the data offered by the server.

WMTS client add-on

The TLcyWMTSClientAddOn and TLcyLspWMTSClientAddOn allow you to connect to WMTS servers, and visualize the data offered by the server.

GXY Views

 

Working with the GXY view

Set up and customize the GXY view.

Visualizing vector data

Learn how to display, style and label vector data.

Visualizing raster data

Learn how to display and style raster data.

Visualizing a grid

Add a grid to the GXY view.

Interacting with the view

Learn how to use controllers to navigate, select, edit, create and measure on the view.

Asynchronous painting

Paint data asynchronously to optimize responsiveness.

Printing

Learn how to print the maps displayed in a view.

Vertical view

Learn how to display your data in a vertical view.

UI widgets

Learn about the available UI widgets for a GXY view.

Performance

Boost GXY view performance.

OGC Standards

 

OGC filters

Use OGC filters to identify data subsets.
Changed in 2024.0

OGC SLD styling

Use OGC SLD Symbology Encoding to style your data.

Geodesy and Geometry

 
Changed in 2024.0

Geodesy

Geodesy and core geometry principles in LuciadLightspeed.

Geometry

Perform geometric calculations on shapes.

Defense

 

Military Symbology

Create and visualize data using the MIL-STD 2525 or APP-6 military standards.

Military Grids

Add a military grid (such as MGRS, GARS, or CGRS) to the view.

Real Time Data

 

Dynamic data

Learn how to work with dynamic data.

Radar feeds

Visualize radar feeds on a Lightspeed view.

Networking and Route Planning

 

Networking and Route planning

Network-related processing like route planning or creating a trace.

Terrain Analysis

 

Elevation data

Learn how to work with elevation data in the Terrain Analysis API.

Line of sight

Calculate a line of sight between two points or between a point and its environment

Visibility

Compute the visibility from one shape to another shape.

Viewsheds

Visibility calculations in a 3D scene.

Hypsometry

Compute and display hypsometric views of elevation data.

Contours

Calculate and find contours.

Extreme points

Find the lowest and highest points in an area.

Big Data

 

Large vector data sets on a Lightspeed view

Learn how to visualize large vector data sets on a Lightspeed view.

Large vector data sets on a GXY view

Learn how to visualize large vector data sets on a GXY view.

Pre-process raster data

Pre-process large raster data sets to improve visualization performance using the Tiling engine.

Pre-process point cloud data

Pre-process point cloud data sets to improve visualization performance using the Tiling engine.

Pre-process 3D meshes to OGC 3D Tiles

Optimize 3D mesh datasets by processing them to OGC 3D Tiles using a 3D Tiles Processing Engine.

Filtering data

Select and set up the right filtering.

Third Party Tools

 

ProGuard

Obfuscate your application.

OSGi(TM)

Running in OSGi.

Maven

Using LuciadLightspeed with Maven.

Data Formats

 

AIXM 3.3/4.x

Decode and visualize aeronautical data in the AIXM 3.3/4.x format.

AIXM 5

Decode and visualize aeronatuical data in the AIXM 5 format.

Arc/Info ASCII grid

Decode and visualize data in the Arc/Info ASCII grid format (*.asc, *.grd).

ARINC

Decode and visualize aeronautical data in the ARINC 424 format.

ASDI

Decode and visualize ASDI data from files and from live streams.

ASRP/USRP/ADRG

Decode and visualize data in the ASRP/USRP/ADRG format (01.THF, *01.GEN, *01.QAL, .SOU, *.IMG).

ASTERIX

Decode and visualize ASTERIX data from files and from live streams.

AutoCAD DWG and DXF

Decode and visualize AutoCAD DWG and DXF data.
New in 2024.0

Autodesk Revit

Decode data in the Autodesk Revit format (*.rvt).

BCI

Decode and visualize data in the BCI format (*.matrxmap).

BIL

Decode and visualize data in the BIL format (*.bil).

Bing Maps

Integration of the Microsoft Bing Maps imagery service into LuciadLightspeed.

Binz

Decode data in the Binz format (*.binz).

BUFR

Decode and visualize World Area Forecast System Significant Weather features in the BUFR format.

CADRG

Decode and visualize data in the CADRG format (*.toc).

CIB

Decode and visualize data in the CIB format.

Collada

The COLLADA interchange file format for 3D models (.dae files).

CSV

Geospatial data encoded in the Comma Separated Value format.

DAFIF

Decode and visualize aeronautical data in the DAFIF format.

DB2 Spatial

Connector to a DB2 Spatial database.

DIMAP

Decode and visualize DIMAP data.

DMED/DTED

Decode and visualize data in the DMED and DTED format (*.dmed, *.dt0, *.dt1, *.dt2).

E57 point clouds

E57 format for point cloud storage.

Earth tilesets

Decode and visualize preprocessed data from an Earth tileset.

ECDIS

Decode, visualize and style S57 and S63 Ecdis data using the S52 symbology.

ECRG

Decode and visualize data in the ECRG format (TOC.xml).

ECW

Decode and visualize data in the ECW format (*.ecw, *.ers).

ETOPO

Decode and visualize data in the ETOPO format (*.ETOPO2.raw.bin, *.ETOPO2v2_MSP.raw, ETOPO5.DAT).

Fusion client

Visualize elevation and imagery data preprocessed with LuciadFusion.
Changed in 2024.0

GDAL

Decode and visualize data in various raster formats supported by GDAL.

GDF

Decode and visualize Geographic Data Files (GDF).

GeoJSON

Decode and visualize data in the GeoJSON format (*.json, *.json.gz, *.json.zip, *.geojson).

GeospatialPDF

Decode and visualize data in the GeospatialPDF format (*.pdf).

GeoSPOT

Decode and visualize data in the GeoSPOT format (*.DSC, *.REP).

GeoTIFF and BigTIFF

Decode and visualize data in the GeoTIFF and BigTIFF format (*.tif, *.tiff).

GML

Decode and visualize data in the GML Geography Markup Language format.

Google Earth Enterprise repositories

Decode and visualize data encoded in a Google Earth Enterprise repository.

GRIB

Decode, visualize and query data in the GRIB format.

IFC

Decode data in the IFC format (*.ifc).

Informix Geodetic

Connector to an Informix Geodetic database.

Informix Spatial

Connector to an Informix Spatial database.

JPEG2000

Decode and visualize data in the JPEG2000 format (*.jp2, *.j2k).

JPIP

Decode and visualize data from a JPIP data stream (JPEG 2000 Interactive Protocol).

KML

Geospatial data encoded in the Keyhole Markup Language (KML) which is the Google Earth format.

LAS/LAZ

The LASer format is an exchange format for three-dimensional point clouds.

Leica Pegasus

Decode the Leica Pegasus data format.

Luciad Point Cloud format

Preprocessed LAS data (point clouds) stored in a Luciad specific format.

LuciadLightspeed JAI

Decode and visualize data in the LuciadLightspeed JAI format (*.jai).

LuciadLightspeed RST

Decode and visualize data in the LuciadLightspeed RST format (*.rst).

Magnetic north

Decode and visualize charts containing magnetic north lines from files containing the parameters of the IGRF or WMM magnetic model.

MapInfo MAP

Decode and visualize data in the MapInfo MAP format (*.map).

MapInfo MIF

Decode and visualize data in the MapInfo MIF format (*.mif).

MapInfo TAB

Decode and visualize data in the MapInfo TAB format (*.tab).

MBTiles

Decode and visualize data in the MBTiles format (*.mbtiles and TileJSON endpoints).

MGCP

Decode and visualize vector data according to the Multinational Geospatial Co-production Program (MGCP) 2.0 portrayal standard.

Microsoft SQL Server databases

Connector to a MSSQL database.

Microstation DGN

Decode and visualize data in the Microstation DGN format (*.dgn).

MrSID

Decode and visualize data in the MrSID format (*.sid).

NetCDF

Decode, visualize and query data in the NetCDF format.

NITF/NSIF

Decode and visualize data in the NITF/NSIF (STANAG 4545) format (*.ntf).

NVG

Decode and visualize data in the Nato Vector Graphics (NVG) format.

OGC 3D Tiles

Point Cloud data (PNTS) and Reality meshes (the B3DM or Batched 3D Model format) served using the OGC 3D Tiles protocol.

OGC GeoPackage

OGC GeoPackage is an open, standards-based, platform-independent, portable, self-describing, compact format for transferring geospatial information.

OGC WCS

Connect with an OGC Web Coverage Service (WCS).

OGC WFS

Connect with an OGC Web Feature Service (WFS).

OGC WMS

Connect with an OGC Web Map Service (WMS).

OGC WMTS

Connect with an OGC Web Map Tile Service (WMTS).

OpenFlight

Decode and visualize data in the OpenFlight format (*.flt).

OpenStreetMap

Decode and visualize OpenStreetMap data.

Oracle Locator

Connector to an Oracle Locator database.

Oracle Spatial

Connector for GeoRaster data stored in an Oracle Spatial database.

OSGB

Reality meshes encoded in the binary version of the OpenSceneGraph data format.

Panoramic image data

Decode panoramic image data.

POL

Decode and visualize data in the POL format (*.pol).

PostgreSQL PostGIS

Connector to an PostgreSQL PostGIS database.

SHP

The Esri Shapefile format.

SQLite SpatiaLite

Vector data encoded in a SQLite database using the SpatiaLite extension.

SwissDHM

Decode and visualize data in the SwissDHM format (*.mlt, *.mbl).

TFW/JGW

Decode and visualize data in the TFW and JGW format (*.tfw, *.jgw).

USGS DEM

Decode and visualize data in the USGS DEM format (*.dem).

VPF

Decode and visualize Vector Product Format (VPF) data.

Wavefront OBJ

Decode and visualize data in the Wavefront OBJ format (*.obj).

XML

Decode, visualize, and encode data in the XML format.