Giter Club home page Giter Club logo

worldwindjava's Introduction

WorldWind Java - Community Edition (WWJ-CE)

Build Status

WWJ-CE is community supported fork of the ubiquitous WorldWind Java SDK from NASA.

WorldWind Java is a 3D virtual globe API for desktop Java, developed by NASA. It 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. The SDK provides a collection of shapes for displaying and interacting with geographic data and representing a range of geometric objects.

Notice from NASA

On March 8, 2019, NASA announced a suspension of the WorldWind project.

WorldWind team would like to inform you that starting May 3, 2019, NASA WorldWind project will be suspended. All the WorldWind servers providing elevation and imagery will be unavailable. While you can still download the SDKs from GitHub, there will be no technical support. If you have questions and/or concerns, please feel free to email at:

[email protected]

WWJ-CE seeks to mitigate the effects of the suspension and continue the development of WorldWind Java.

Contributing to the Community Edition

Contributions to WWJ-CE are welcomed in the form of issues and pull requests.

Before Submitting an Issue

Please fulfill the following requirements before submitting an issue to this repository:

Before Submitting a Pull Request

Please read Contributing to WorldWind Java and adhere to the WorldWind Java Design and Coding Guidelines.

Releases and Roadmap

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

Run a Demo

From a Web Browser
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 user’s 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

GDAL

GDAL is a translator library for raster and vector geospatial data formats provided by the Open Source Geospatial Foundation. GDAL libraries and native binaries are not provided by WorldWindEarth/WorldWind Java, but are needed to build. The Gradle build will pull the necessary libraries from Maven. Please see the file GDAL_README.txt for details on where to obtain the native binaries and other details.

License

NASA WORLDWIND

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 WorldWind
User Registration Requested. Please send email with your contact information to [email protected]
Government Agency Point of Contact for Original Software: [email protected]

You may obtain a full copy of the license at:

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

worldwindjava's People

Contributors

pdavidc avatar wcmatthysen avatar emxsys avatar gbburkhardt avatar tag3 avatar robmilton avatar xranby avatar zglueck avatar eirizarry avatar mainstringargs avatar combatvision avatar moovida avatar andrewmcloud avatar lucgirardin avatar markpet49 avatar petedavis avatar rhstone avatar caller avatar christianliebl avatar twistedtwin avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.