NASA World Wind in Java
 
 
Go to file
Miguel Del Castillo 9ccf6b8ed2
Merge pull request #247 from NASAWorldWind/develop
Version 2.2.1 Release Changes
2022-06-03 15:49:01 -05:00
lib-external License and release updates (#206) 2020-08-12 15:37:38 -05:00
milstd2525 License and release updates (#206) 2020-08-12 15:37:38 -05:00
nbproject Bump version number and update release docs 2022-05-25 15:18:54 -05:00
src Bump version number and update release docs 2022-05-25 15:18:54 -05:00
test/gov/nasa/worldwind License and release updates (#206) 2020-08-12 15:37:38 -05:00
testData License and release updates (#206) 2020-08-12 15:37:38 -05:00
testFunctional/gov/nasa/worldwind License and release updates (#206) 2020-08-12 15:37:38 -05:00
travis Travis CI adjustments 2017-06-12 20:14:01 -07:00
.gitignore Remove nbproject/private folder 2019-08-30 16:27:28 -05:00
.travis.yml Move to JDK 11 and latest JOGL 2.4 on Linux 2019-09-10 13:26:08 -05:00
Apache License 2.0.pdf Final release adjustments (#207) 2020-08-12 15:05:45 -07:00
CONTRIBUTING.md License and release updates (#206) 2020-08-12 15:37:38 -05:00
Design and Coding Guidelines.html License and release updates (#206) 2020-08-12 15:37:38 -05:00
GDAL_README.txt License and release updates (#206) 2020-08-12 15:37:38 -05:00
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md (#170) 2019-09-10 16:47:06 -05:00
LICENSE.gdal.TXT Add gdal license (#203) 2020-06-29 15:03:57 -05:00
LICENSE.jackson.txt Add jackson license (#202) 2020-06-29 14:38:17 -05:00
PULL_REQUEST_TEMPLATE.md Update WorldWind Java documentation (#128) 2017-08-17 13:11:27 -07:00
README.md Rewording in README.md 2022-05-25 15:21:30 -05:00
README_DEVELOPER.txt License and release updates (#206) 2020-08-12 15:37:38 -05:00
RELEASE_NOTES.txt Bump version number and update release docs 2022-05-25 15:18:54 -05:00
VPF_README.txt License and release updates (#206) 2020-08-12 15:37:38 -05:00
WorldWind.iml JOGL and Java 11+ updates 2019-08-27 16:20:05 -05:00
WorldWindJava-v2.2 3rd-party notices and licenses.pdf Final release adjustments (#207) 2020-08-12 15:05:45 -07:00
build.xml JOGL and Java 11+ updates 2019-08-27 16:20:05 -05:00
gdal.jar Initial commit 2015-10-26 18:15:51 -07:00
gluegen-rt-natives-linux-amd64.jar JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
gluegen-rt-natives-macosx-universal.jar JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
gluegen-rt-natives-windows-amd64.jar JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
gluegen-rt.jar JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
gluegen.LICENSE.txt JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
jogl-all-natives-linux-amd64.jar JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
jogl-all-natives-macosx-universal.jar JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
jogl-all-natives-windows-amd64.jar JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
jogl-all.jar JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
jogl.LICENSE.txt JOGL and Java 11+ updates 2019-08-27 16:20:05 -05:00
jogl.README.txt JOGL refresh (#199) 2020-06-18 15:56:36 -05:00
junit-4.5.jar Move libraries from ant/lib to more appropriate locations 2016-12-08 11:55:56 -08:00
logging.properties License and release updates (#206) 2020-08-12 15:37:38 -05:00
release-build.macros.xml License and release updates (#206) 2020-08-12 15:37:38 -05:00
release-build.properties License and release updates (#206) 2020-08-12 15:37:38 -05:00
release-build.xml Bump version number and update release docs 2022-05-25 15:18:54 -05:00
run-demo.bash License and release updates (#206) 2020-08-12 15:37:38 -05:00
run-demo.bat License and release updates (#206) 2020-08-12 15:37:38 -05:00
vpf-symbols.jar Initial commit 2015-10-26 18:15:51 -07:00

README.md

WorldWind Java

New version of WorldWind Java released

WorldWind Java 2.2.1 is now available on GitHub. This version of WorldWind Java is a maintenance release that addresses small fixes (typos, bad references, etc.) to various areas of the code and removes references to services that are no longer supported by the WorldWind servers.

WorldWind's API remains unchanged in this release and we are committed to maintaining a consistent API in future releases. More information on the release can be found at this link: WorldWind Java 2.2.1.

Please direct questions to our new email address: arc-worldwind@mail.nasa.gov.

Build Status

3D virtual globe API for desktop Java, developed by NASA. Provides a geographic context with high-resolution terrain, for visualizing geographic or geo-located information in 3D and 2D. Developers can customize the globe's terrain and imagery. Provides a collection of shapes for displaying and interacting with geographic data and representing a range of geometric objects.

Releases and Roadmap

Official WorldWind Java releases have the latest stable features, enhancements and bug fixes ready for production use.

Run a Demo

The following options are available to run a WorldWind Java demo:

From the Apache NetBeans IDE

Clone the SDK with git, open the WorldWind Java project with Apache Netbeans and run demos via the Netbeans interface.

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

WorldWind 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 users temp directory. Runtime extraction can be avoided by by modifying WorldWind 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

Copyright 2006-2009, 2017, 2020 United States Government, as represented by the Administrator of the National Aeronautics and Space Administration. All rights reserved.

The NASA World Wind Java (WWJ) platform is licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

NASA World Wind Java (WWJ) also contains the following 3rd party Open Source software:

Jackson Parser  Licensed under Apache 2.0
GDAL  Licensed under MIT
JOGL  Licensed under  Berkeley Software Distribution (BSD)
Gluegen  Licensed under Berkeley Software Distribution (BSD)

A complete listing of 3rd Party software notices and licenses included in NASA World Wind Java (WWJ) can be found in the WorldWindJava-v2.2 3rd-party notices and licenses PDF found in code directory.