Get Started

World Wind is an SDK (software development kit) that software engineers can use to build their own applications. To run a World Wind demo application, visit the Demos page. Follow these instructions to download, run, and deploy an application using World Wind.

Run an Application Using World Wind

1. Download
Download the latest release from the World Wind GitHub Releases.

2. Extract
Extract the World Wind SDK to a folder anywhere on your hard drive. The following steps refer to the extracted folder as WorldWind.

3. Run a World Wind Demo
Open WorldWind/README.txt and follow the instructions under Running a Basic Demo Application.

4. Create and Run Your Application Using World Wind
Create an app by reviewing the programming examples in WorldWind/src/gov/nasa/worldwindx/examples. Start with SimplestPossibleExample and ApplicationTemplate, then refer to the Examples page for more advanced topics. Here are examples of running your app from the command-line, assuming your app’s JAR file is MyApp.jar, and your main class is worldwinddemo.MyBasicDemo.

On Mac OS X and Linux

java -Xmx1024m -cp MyApp.jar:worldwind.jar:worldwindx.jar:jogl-all.jar:gluegen-rt.jar:gdal.jar worldwinddemo.MyBasicDemo

On Windows

java -Xmx1024m -Dsun.java2d.noddraw=true -cp MyApp.jar;worldwind.jar;worldwindx.jar;jogl-all.jar;gluegen-rt.jar;gdal.jar worldwinddemo.MyBasicDemo

Note: All *.dll, *.jnilib, and *.so files in the WorldWind folder must be in the same folder as MyApp.jar.

Deploy an Application Using Java Web Start

1. Create a Java Web Start Application JNLP File
Modify the template JNLP file WorldWind/webstart/JavaWebStartTemplate.jnlp to fit your app.

2. Add World Wind Libraries to Your Application JNLP
Insert the following XML extension elements in the resources block of your app’s JNLP file, depending on your app’s needs:

World Wind Core Library (required)

<extension name="worldwind" href="http://worldwind.arc.nasa.gov/java/v2.1.0/webstart/worldwind.jnlp"/>

World Wind Extensions Library (required if your app uses the gov.nasa.worldwindx package)

<extension name="worldwindx" href="http://worldwind.arc.nasa.gov/java/v2.1.0/webstart/worldwindx.jnlp"/>

GDAL Library (optional, include if your app uses World Wind’s data import feature)

<extension name="gdal" href="http://worldwind.arc.nasa.gov/java/v2.1.0/webstart/gdal.jnlp"/>

3. Prepare Your Application’s JAR Files
JAR files used by a Java Web Start application must be signed by a recognized authority, and must specify the Permissions manifest attribute. World Wind’s JAR files have already been signed and contain the necessary manifest attributes. See Oracle’s documentation on Signing JAR Files and JAR File Manfiest Attributes for Security.

4. Deploy Your Application
Determine a URL to host your app at, such as http://myworldwinddemo.org/. Set your JNLP file’s codebase attribute to this URL, then host your JNLP file and any JAR files referenced by your JNLP at this URL. See Oracle’s documentation on Rich Internet Application Deployment for more information.

Something to say about this?

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

WordPress.com Logo

You are commenting using your WordPress.com 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