WorldWind Java composes the globe scene by stacking layers. Each frame theDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/nasaworldwind/worldwindjava/llms.txt
Use this file to discover all available pages before exploring further.
SceneController iterates the LayerList from the first entry to the last, calling render() on every enabled layer. Layers at the beginning of the list are painted first and may be obscured by layers above them; layers at the end of the list appear on top. This ordering is how imagery sits beneath shapes, which in turn sit beneath UI overlays like the compass and scalebar. Every layer is independent — it maintains its own enabled state, opacity, altitude-activation range, and network-retrieval flag — and can be added, removed, or reordered at any time.
The Layer Interface
All layers implementgov.nasa.worldwind.layers.Layer. The interface defines the complete lifecycle of a layer within the render and pick passes:
Layer interface — key method signatures
Layer Types
RenderableLayer
The most commonly used layer type. Holds a collection of
Renderable objects — any shape, path, polygon, surface image, or annotation that implements gov.nasa.worldwind.render.Renderable. Add content with addRenderable(Renderable) and remove it with removeRenderable(Renderable) or removeAllRenderables().TiledImageLayer / BasicTiledImageLayer
Displays tiled raster imagery at multiple levels of detail.
BasicTiledImageLayer is the configurable base for WMS layers and local tile pyramids. The SDK includes pre-built subclasses such as BMNGOneImage, LandsatI3, and BingImagery that are backed by remote WMS endpoints or local data.AnnotationLayer
Renders geographic
Annotation objects — text bubbles and callouts anchored to positions on the globe or screen. Subclasses include GlobeAnnotationLayer (annotations at geographic positions) and ScreenAnnotationLayer (fixed screen-space annotations).IconLayer
Manages a collection of
WWIcon objects — billboarded icons placed at geographic positions. Supports automatic decluttering and level-of-detail scaling based on eye altitude.MarkerLayer
Renders
Marker objects — simple geometric primitives (cones, cylinders, spheres) placed at geographic positions. Lighter-weight than icons; useful for large numbers of point features.CompassLayer / ScalebarLayer / WorldMapLayer
Built-in UI overlay layers.
CompassLayer draws a north-seeking compass rose. ScalebarLayer draws a distance scalebar calibrated to the current zoom level. WorldMapLayer draws a small overview map with a position indicator showing the current view center.SkyGradientLayer / StarsLayer
Atmosphere and deep-space background layers.
SkyGradientLayer renders the atmospheric limb and sky color gradient. StarsLayer renders a star field from the Hipparcos catalog, providing a realistic background at high altitudes.LatLonGraticuleLayer / GARSGraticuleLayer
Coordinate-grid overlay layers.
LatLonGraticuleLayer draws WGS84 latitude/longitude grid lines with degree labels. GARSGraticuleLayer renders the Global Area Reference System 30-minute and 15-minute cell grid used in military operations.Managing the Layer List
LayerList (gov.nasa.worldwind.layers.LayerList) extends CopyOnWriteArrayList<Layer> and adds WorldWind-specific helpers. Because it is copy-on-write, iterating it while another thread modifies it is safe — mutations produce a new backing array without disrupting ongoing reads.
LayerList operations — add, remove, reorder, and find
ApplicationTemplate class (used throughout the WorldWind examples) also provides convenience static methods for inserting layers at semantically meaningful positions:
ApplicationTemplate insertion helpers
Adding Content to a RenderableLayer
Adding a RenderableLayer with shapes to the globe
Enabling and Disabling a Layer by Name
Toggling a named layer on and off
Default Layers
WhenBasicModel is constructed from the default worldwind.xml configuration, it reads its layer list from config/worldwind.layers.xml. The following layers are loaded and enabled out-of-the-box, in bottom-to-top render order:
| Layer Class | Default Name | Notes |
|---|---|---|
StarsLayer | Stars | Hipparcos star catalog background |
SkyGradientLayer | Sky | Atmospheric limb gradient |
BMNGOneImage | Blue Marble (One Image) | Low-res earth backdrop; active above 3,000 km |
BMNGWMSLayer | Blue Marble May 2004 | WMS-sourced multi-resolution BMNG imagery |
LandsatI3 | i-cubed Landsat | 15m Landsat imagery via WMS |
USGSNAIPPlusLayer | USGS NAIP PLUS | High-res aerial (US only); loaded on request |
BingImagery | Bing Imagery | Bing satellite/aerial; loaded on request |
NASAWFSPlaceNameLayer | Place Names | NASA WFS geographic names |
WorldMapLayer | World Map | Overview map overlay |
ScalebarLayer | Scale bar | Distance scalebar |
CompassLayer | Compass | North-seeking compass rose |