Imagery Overlays

Imagery is added in the same way as terrain, as shown in the following example:

GlobeImageOverlay overlay = getScene().getCentralBodies().getEarth().getImagery().add(imageryPath);

Imagery is drawn on top of existing geometry, which may be the globe's ellipsoid or one or more terrain overlays as shown below.

Terrain and imagery overlays

Just imagery overlay

Images can be blended with images below them by setting their translucency. This is controlled via the Translucency (get / set) property. A translucency of 0% means the image is completely opaque, while a translucency of 100% means the image is completely transparent.

The following example sets an image's translucency to 40%:

image.setTranslucency(0.4f);

When images overlap each other on the globe, the central body's ImageCollection allows you to control which images are on top and which are below. The collection is ordered so the first image in the collection is rendered on the bottom; each subsequent image is rendered on top of the previous image if their extents overlap. The collection provides indexOf, swap, move methods to order images, as shown in the following example:

GlobeImageOverlay topOverlay = getScene().getCentralBodies().getEarth().getImagery().add(topOverlayPath);
GlobeImageOverlay bottomOverlay = getScene().getCentralBodies().getEarth().getImagery().add(bottomOverlayPath);

// Since bottom.jp2 was added after top.jp2, bottom.jp2 will be 
// drawn on top.  In order to draw top.jp2 on top, we swap the Overlays.
getScene().getCentralBodies().getEarth().getImagery().swap(topOverlay, bottomOverlay);

Imagery can have a special role, which can be either base, night or specular. These special images are drawn below all other imagery. A base image is normally used for a base globe texture. A night image is drawn only on the parts of the globe that aren't in sunlight. The specular image is drawn where the specular highlight is shown. This is typically used to dull the highlight on land areas to accentuate the shininess of the oceans.

The following example sets all three of the special images:

GlobeImageOverlay baseOverlay = new GeospatialImageGlobeOverlay(baseUri);
GlobeImageOverlay nightOverlay = new GeospatialImageGlobeOverlay(nightUri);
GlobeImageOverlay specularOverlay = new GeospatialImageGlobeOverlay(specularUri);

getScene().getCentralBodies().getEarth().setBaseOverlay(baseOverlay);
getScene().getCentralBodies().getEarth().setNightOverlay(nightOverlay);
getScene().getCentralBodies().getEarth().setSpecularOverlay(specularOverlay);

Just base image

Base and night images

Base and specular images

Since imagery files can be extremely large, the entire file is not kept in memory. Instead, a small portion of the file is kept in a memory cache. As the camera moves around, parts of the file are paged from disk into the cache. By default, the cache is 64 megabytes. If you are using high resolution imagery or the imagery appears blurry, try increasing the cache to 128 megabytes, or larger, as shown below:

SceneManager.getGlobeOverlaySettings().setImageryCacheSize(128);