Common Problems

Many problems encountered by World Wind developers and their application users  have common causes. They therefore have the same solution. Those problems and their fix are listed here.

Problem: NASA Map Layers do not download (HTTP 301)

As of January 2017 World Wind map servers (worldwind*,, and exclusively use HTTPS.  HTTP requests return a redirect (301) to the HTTPS endpoint. The Oracle Java VM does not automatically follow the redirect protocol. Clients map layer configuration files must be updated to use HTTPS endpoints. You may see the following errors:

FINE: Response code 301, Content length 534, Content type text/html; charset=iso-8859-1, retrieving
SEVERE: Retrieval returned no content for

Option 1: Upgrade to World Wind Java v2.1.0 (Preferred)

World Wind Java v2.1.0 uses HTTPS map layers exclusively. SDK v2.1.0 and v2.0.0 are interface compatible.

Option 2: Update v2.0.0 Patch

Download the World Wind Java v2.0.0 HTTPS Patch jar from GitHub. Place the jar in the classpath of your project and add the following argument to your application launch script.

$ java

The patch jar includes a new PlaceNames layer: This class is a copy of the NASAWFSPlaceNamesLayer class but updates the hard coded service link to HTTPS.

To summarize, the best option, if available, is to update to v2.1.0. In addition to HTTPS endpoints specified by default, there are a number of improvements and bug fixes. Please note some WMS layer sources have been deprecated in v2.1.0. The configuration files have been maintained with a deprecated comment in order to maintain your on disk cache of the data. All versions of World Wind Java support HTTPS, as World Wind is using the Java URLConnection class. Specifying an HTTPS endpoint on an older World Wind Java version will work. The problem arises in the URLConnection class not following the protocol redirection provided by the server.

If you still need help or have questions, please search/post on the forum or GitHub.

Problem: I don’t see a globe

The video card drivers are out of date. Installing updated drivers almost always fixes the problem.  Here are links to the support sites of the three major video card manufacturers: ATI/AMD, Nvidia, Intel.

Problem: The change I made didn’t show up on the screen

  1. Be sure to call WorldWindow.redraw() when you’ve finished making changes to shapes, layers, the view, or anything else. World Wind does not automatically update the screen when the app makes changes. Apps usually make several changes in reaction to user requests, Redrawing at every one of those intermediate changes would show intermediate states and decrease performance. World Wind does redraw in response to its input handler or when data requested from a server arrives.
  2. Be sure to make changes to World Wind on the event dispatch thread (EDT). That’s the drawing thread. If changes are made to shapes, layers, views, etc. on a separate thread, they could occur while the model is being drawn and the drawing thread could encounter inconsistent or incoherent state.

Problem: My shapes are bigger than they’re supposed to me

  • Be sure the shapes are specified in meters. World Wind assumes all linear measures such as elevation, altitude and length are in meters. If they’re in feet instead, all the shapes will be larger than expected.

Problem: The globe became dark

  • If you’re using classes that you’ve created or extended, and they draw using OpenGL, be sure they restore the OpenGL state to what it was when given control. All World Wind shapes assume they inherit the default OpenGL state when they draw. If the inherited state is different from the default, the shape will likely display incorrectly. And if one class does not restore the state, everything subsequently drawn will likely be incorrect in some way. The causes are typically one of these:
  1. The most common mistake is failure to push and pop attribute masks or transforms for the state changed by the drawing code.
  2. It could also happen when an exception occurred after the OpenGL state is set but before it’s restored. The best practice is to set state within a try block with a finally clause that performs the restoration, like this:
GL2 gl = dc.getGL().getGL2(); // Get JOGL's GL2 interface from the draw context.
OGLStackHandler osh = new OGLStackHandler();
gl.glVertex2d(0d, 0d);
gl.glVertex2d(1, 0d);
gl.glVertex2d(1, 1);

Notice that World Wind’s OGLStackHandler class is used to push and pop an identity projection matrix. The texture control is explicit because pushing and popping texture state is expensive.

Problem: Can’t load IA 32-bit .dll on a AMD 64-bit platform

Note: This problem applies to World Wind 1.5 and earlier. World Wind 2.0 manages the loading of 32-bit and 64-bit versions of JOGL automatically.

This error indicates that World Wind is running in a 64-bit Java Virtual Machine, but attempting to load a 32-bit version of JOGL (the Java OpenGL binding). To correct the problem, you need to extract the 64-bit libraries for Windows included in the World Wind release:

  1. Open a terminal.
  2. cd to the World Wind release folder.
  3. jar xf jogl-natives-windows-amd64.jar
  4. jar xf gluegen-rt-natives-windows-amd64.jar

64-bit libraries for Linux are not included with the release, but can be downloaded from:

Follow instructions above to extract the archives into the World Wind release folder.

Problem: Cannot extract JOGL runtime binaries

JOGL 2 performs runtime extraction of native binaries. Some deployment situations may not allow this because it extracts the binaries to the application user’s temp directory. Runtime extraction can be avoided by following the instructions in World Wind’s README.txt file in the “New features and improvements in World Wind Java SDK 2.0.0” section.

Problem: Memory leaks on Intel integrated graphics devices. Application eventually crashes.

The Intel integrated graphics driver has a memory leak. It does not free memory when OpenGL resources such as VBOs are deleted. System memory usage therefore continues to grow unbounded until the application crashes. The best way to mitigate this is to set the World Wind VBOUsage configuration  property to false in config/worldwind.xml.

Console Message:
GLDrawableHelper.reshape: pre-existing GL error

An OpenGL error has been detected during rendering. Identify the problematic OpenGL call by enabling the OpenGL debugger. Add the following JVM argument and run the application again:


When the OpenGL debugger is enabled, problematic OpenGL calls that went unreported now result in an exception. These exceptions are caught by World Wind and written to the log. For example, modifying TextureTile.setTextureParameters to produce an OpenGL error results in:

Sep 06, 2016 1:29:06 PM gov.nasa.worldwind.render.SurfaceTileRenderer renderTiles
SEVERE: Exception while rendering layer gov.nasa.worldwind.render.GeographicSurfaceTileRenderer Thread[AWT-EventQueue-0,6,main] glGetError() returned the following error codes after a call to glTexParameteri( 0xDE1,  0x2801,  0x1907): GL_INVALID_ENUM ( 1280 0x500), 
    at gov.nasa.worldwind.layers.TextureTile.setTextureParameters(

Warning: The OpenGL debugger impacts rendering performance, and must not be used in production.

Something to say about this?

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s