mirror of
https://github.com/NASAWorldWind/WebWorldWind.git
synced 2026-01-18 15:12:57 +00:00
f23f70d59a
* Updated readme and community health files for upcoming release * Improved readme formatting. Added 'mailto:' to email links. Co-authored-by: Mark Peterson <markpet@yahoo.com>
85 lines
4.3 KiB
Markdown
85 lines
4.3 KiB
Markdown
<img src="https://worldwind.arc.nasa.gov/img/nasa-logo.svg" height="100"/>
|
||
|
||
# Web WorldWind
|
||
|
||
Web WorldWind 0.11.0 is now available on GitHub. The summary of changes is as follows:
|
||
|
||
- Improvements to COLLADA 3D model support.
|
||
- Added ability to obtain locations of a click in a 3D model.
|
||
- Added visualization support to COLLADA models with wrongly formatted normals.
|
||
- Transparent placemark picking has been fixed.
|
||
- Improvements to Well-Known Text format support.
|
||
- Various fixes to example code files.
|
||
|
||
Development environment changes:
|
||
- Added Chrome and Firefox headless browsers and removed PhantomJS.
|
||
- Switched IDEs from WebStorm to Visual Studio Code.
|
||
- Updated development dependencies to latest versions.
|
||
|
||
WorldWind's API remains largely unchanged in this release and we are committed to maintaining a consistent API in future releases.
|
||
|
||
For additional information, please refer to the [releases list](https://github.com/NASAWorldWind/WebWorldWind/releases). Please direct any questions to our email address: [arc-worldwind@mail.nasa.gov](mailto:arc-worldwind@mail.nasa.gov).
|
||
|
||
***
|
||
|
||
Web WorldWind is a 3D planetary globe engine built in JavaScript for the web, developed by NASA. The European Space Agency has provided valuable
|
||
contributions to this platform since 2015. Web WorldWind provides a geographic context complete with terrain, and a
|
||
collection for shapes for displaying and interacting with geographic or geo-located information in 3D and 2D in any
|
||
modern web browser. High-resolution terrain and imagery is retrieved from remote servers automatically as needed, while
|
||
enabling developers to include their own custom terrain, imagery, 3D shapes, and position markings.
|
||
|
||
The project's website, [worldwind.arc.nasa.gov](https://worldwind.arc.nasa.gov) has setup instructions, developer guides, API documentation and more.
|
||
|
||
## Get Started
|
||
|
||
The Web WorldWind [Developer's Guide](https://worldwind.arc.nasa.gov/web) has a complete description of Web WorldWind's
|
||
functionality. In there, you will find many Web WorldWind resources, including a user guide and documentation for every module file.
|
||
For complete beginners on WorldWind, the [Get Started](https://worldwind.arc.nasa.gov/web/get-started/) tutorial is the place to go.
|
||
|
||
The latest Web WorldWind release provides many simple [examples](https://github.com/NASAWorldWind/WebWorldWind/tree/develop/examples) showing
|
||
how to use most of Web WorldWind's functionality, as well as more involved small [applications](https://github.com/NASAWorldWind/WebWorldWind/tree/develop/apps)
|
||
for reference on how to use Web WorldWind in domain-focused GIS development.
|
||
|
||
## Building
|
||
|
||
[](https://travis-ci.com/NASAWorldWind/WebWorldWind)
|
||
|
||
[Install NodeJS](https://nodejs.org). The build is known to work with Node.js 12.18.0 LTS.
|
||
|
||
- `npm install` downloads WorldWind's dependencies and builds everything
|
||
|
||
- `npm run build` builds everything
|
||
|
||
- `npm run doc` generates the WorldWind API documentation
|
||
|
||
- `npm run test` runs WorldWind's unit tests
|
||
|
||
- `npm run test:watch` automatically runs WorldWind's unit tests when source code changes
|
||
|
||
## License
|
||
|
||
Copyright 2003-2006, 2009, 2017, 2020, 2022 United States Government, as represented
|
||
by the Administrator of the National Aeronautics and Space Administration.
|
||
All rights reserved.
|
||
|
||
The NASAWorldWind/WebWorldWind 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.
|
||
|
||
NASAWorldWind/WebWorldWind also contains the following 3rd party Open Source
|
||
software:
|
||
|
||
- ES6-Promise – under MIT License
|
||
- libtess.js – SGI Free Software License B
|
||
- Proj4 – under MIT License
|
||
- JSZip – under MIT License
|
||
|
||
A complete listing of 3rd Party software notices and licenses included in
|
||
WebWorldWind can be found in the Web WorldWind 3rd-party notices and licenses PDF file found in its code directory.
|