NASA World Wind in Java
Java HTML Other
Latest commit 7a329a4 Dec 13, 2016 @emxsys emxsys Implemented a naming convention for USGS topographic map layers:
- USGS Topo Base Map
- USGS Topo Base Map Large Scale
- USGS Topo Scanned Maps 1:250K
- USGS Topo Scanned Maps 1:100K
- USGS Topo Scanned Maps 1:24K
Permalink
Failed to load latest commit information.
.idea Move libraries from ant/lib to more appropriate locations Dec 8, 2016
lib-external Move libraries from ant/lib to more appropriate locations Dec 8, 2016
milstd2525 Rearranged the contents of 'resources' to clarify its purpose Dec 8, 2016
src Implemented a naming convention for USGS topographic map layers: Dec 13, 2016
test/gov/nasa/worldwind Suppressed KML unit tests that depend on remote resources Dec 13, 2016
testData Updated the defunct example ExtrudedPolygonsFromShapefile Dec 8, 2016
testFunctional/gov/nasa/worldwind Update static file resource path to match functionalTest directory st… Dec 7, 2016
travis Added JNLP codebase replacement for issue #74 Dec 13, 2016
webstart Restored href attribute in Web Start jnlp files Dec 13, 2016
.gitignore Added encrypted keystore archive for Travis CI signing automation Dec 12, 2016
.travis.yml Corrected Travis CI script Dec 12, 2016
Design and Coding Guidelines.html Initial commit Oct 27, 2015
GDAL_README.txt Initial commit Oct 27, 2015
LICENSE.txt Updated README.md and LICENSE.txt to match World Wind repository conv… Nov 26, 2016
README.md Simplified the command line demo instructions in README.md Dec 13, 2016
README_DEVELOPER.txt Initial commit Oct 27, 2015
VPF_README.txt Initial commit Oct 27, 2015
WebView32.dll Added the execute permission to the WebView native libraries Dec 1, 2016
WebView64.dll Added the execute permission to the WebView native libraries Dec 1, 2016
WorldWind.iml Removed the unused plugin.jar dependency (unused since Applet support… Dec 8, 2016
build.macros.xml Simplified the ANT build Dec 9, 2016
build.properties Simplified the ANT build Dec 9, 2016
build.xml Consolidated Web Start configuration files Dec 13, 2016
gdal.jar Initial commit Oct 27, 2015
gluegen-rt-natives-linux-amd64.jar Initial commit Oct 27, 2015
gluegen-rt-natives-linux-i586.jar Initial commit Oct 27, 2015
gluegen-rt-natives-macosx-universal.jar Initial commit Oct 27, 2015
gluegen-rt-natives-windows-amd64.jar Initial commit Oct 27, 2015
gluegen-rt-natives-windows-i586.jar Initial commit Oct 27, 2015
gluegen-rt.jar Initial commit Oct 27, 2015
gluegen.LICENSE.txt Initial commit Oct 27, 2015
jogl-all-natives-linux-amd64.jar Initial commit Oct 27, 2015
jogl-all-natives-linux-i586.jar Initial commit Oct 27, 2015
jogl-all-natives-macosx-universal.jar Initial commit Oct 27, 2015
jogl-all-natives-windows-amd64.jar Initial commit Oct 27, 2015
jogl-all-natives-windows-i586.jar Initial commit Oct 27, 2015
jogl-all.jar Initial commit Oct 27, 2015
jogl.LICENSE.txt Initial commit Oct 27, 2015
jogl.README.txt Initial commit Oct 27, 2015
junit-4.5.jar Move libraries from ant/lib to more appropriate locations Dec 8, 2016
keystore.tar.enc Added encrypted keystore archive for Travis CI signing automation Dec 12, 2016
libwebview.jnilib Added the execute permission to the WebView native libraries Dec 1, 2016
logging.properties Initial commit Oct 27, 2015
run-demo.bash Repaired the Java classpath argument in run-demo.bash Dec 13, 2016
run-demo.bat Updated run-demo scripts to launch the ApplicationTemplate example if… Dec 13, 2016
vpf-symbols.jar Initial commit Oct 27, 2015

README.md

World Wind Java

Build Status

3D virtual globe API for desktop Java, developed by NASA. Provides a geographic context, complete with terrain, for visualizing geographic or geo-located information in 3D and 2D. World Wind Java provides high-resolution terrain and imagery, retrieved from remote servers automatically as needed. Developers can provide custom terrain and imagery. Contains a rich set of features for displaying and interacting with geographic data and representing a wide range of geometric objects. More information at worldwind.arc.nasa.gov.

Get Started

Develop a world-class World Wind application for personal computers. Setup instructions, developers guides, API documentation and more are available at worldwind.arc.nasa.gov. This GitHub repository contains the library source, examples and tutorials.

Releases and Roadmap

Official World Wind Java releases from the master branch. Releases have the latest stable features, enhancements and bug fixes ready for production use.

Daily Builds

World Wind Java builds from the develop branch. Daily builds have the newest, bleeding-edge World Wind Java features. Intended for developers and early adopters.

Run a Demo

From a Web Browser
From a Windows Development Environment
cd [World Wind release]
run-demo.bat
From a Linux or macOS Development Environment
cd [World Wind release]
sh run-demo.bash
Troubleshooting

World Wind requires a modern graphics card with a current driver. Most display problems are caused by out-of-date graphics drivers. On Windows, visit your graphics card manufacturer's web site for the latest driver: NVIDIA, ATI or Intel. The drivers are typically under a link named Downloads or Support. If you're using a laptop, the latest drivers are found at the laptop manufacturer's web site.

JOGL Native Binaries

JOGL 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 by modifying World Wind Java's JOGL distribution to load native binaries directly from the library path instead of dynamically using the native binary JAR files as follows:

  1. Extract the GlueGen and JOGL native binary JAR files for the desired platform. These JAR files follow the naming pattern gluegen-rt-natives-PLATFORM.jar and jogl-all-natives-PLATFORM.jar
  2. Place the extracted native binaries either in the program's working directory or in a location specified as the library path. The following JOGL user's guide page outlines supported library path variables: https://jogamp.org/jogl/doc/userguide/index.html#traditionallibraryloading
  3. Remove the GlueGen and JOGL native binary JAR files from your application's workspace. JOGL attempts to use the native binary JAR files before loading from the library path, so these files must not be deployed with the application.
  4. When running, specify the JVM argument -Djogamp.gluegen.UseTempJarCache=false

License

NASA WORLD WIND

Copyright (C) 2001 United States Government
as represented by the Administrator of the
National Aeronautics and Space Administration.
All Rights Reserved.

NASA OPEN SOURCE AGREEMENT VERSION 1.3

This open source agreement ("agreement") defines the rights of use, reproduction,
distribution, modification and redistribution of certain computer software originally
released by the United States Government as represented by the Government Agency
listed below ("Government Agency"). The United States Government, as represented by
Government Agency, is an intended third-party beneficiary of all subsequent
distributions or redistributions of the subject software. Anyone who uses, reproduces,
distributes, modifies or redistributes the subject software, as defined herein, or any
part thereof, is, by that action, accepting in full the responsibilities and obligations 
contained in this agreement.

Government Agency: National Aeronautics and Space Administration (NASA)
Government Agency Original Software Designation: ARC-15166-1
Government Agency Original Software Title: NASA World Wind
User Registration Requested. Please send email with your contact information to Patrick.Hogan@nasa.gov
Government Agency Point of Contact for Original Software: Patrick.Hogan@nasa.gov

You may obtain a full copy of the license at:

    https://worldwind.arc.nasa.gov/LICENSE.html