Merge pull request #58 from camerons/www_review

Review of WorldWind docs

en/overview/javaworldwind_overview.rst

@@ -1,109 +1,113 @@
-:Author: Gabriele Prestifilippo
-:Version: World Wind Java SDK 2.0
-:License: `NASA OPEN SOURCE AGREEMENT VERSION 1.3 <http://worldwind.arc.nasa.gov/worldwind-nosa-1.3.html/>`_ 
-
-
-
-.. image:: ../../images/project_logos/logoNasaJWW.png
-  :alt: project logo
-  :align: right
-  :target: http://goworldwind.org/
-
-World Wind Java SDK
-================================================================================
-
-
-Features
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-World Wind provides a rich set of features for displaying and interacting with geographic data and representing a wide range of geometric objects.
-
-_____________________________
-General Features
-_____________________________
-
-* Open-source, high-performance 3D Virtual globe API and SDK
-* Adds 3D geographic visualization to any application
-* Runs on Windows, Mac OS X, Linux, iOS (partial) and Android (partial)
-* Runs in web pages in Java applets
-* Free run-time and development license
-* Unencumbered use on any number of devices
-* Huge collection of high-resolution imagery and terrain from NASA servers
-* Displays high-resolution imagery, terrain and geographic information from any open-standard public or private source
-* Open-standard interfaces to GIS services and databases
-* Large collection of geometric and geographic shapes
-* Simple to extend and modify, designed to be extensible
-* Uses Java and OpenGL
-
-_____________________________
-Graphics Capabilities
-_____________________________
-
-* Point, Path, Polygon, Curtain
-* Volumes: Extruded Polygon, Ellipsoid, Sphere, Cylinder, Cone, Pyramid, Box, Airspaces (see below)
-* Terrain conforming shapes: Path, Polygons, Ellipse, Circle, Quadrilateral, Rectangle, Square, Text, Image, Icon
-* Airspaces: Box, Cake, Capped Cylinder (full and partial), Curtain, Orbit, PolyArc, Polygon, Route, Sphere, Track
-* Annotation: Text, Text Balloon, HTML5 web-browser Balloon, Image, Icons, all with geo-located and screen versions
-* Placenames, Political boundaries
-* 2.5D “Flat Globe” with terrain
-* Transparency
-* Picking, Selection
-* Navigation and Viewing: Orbit View, First Person, Stereo, application-defined
-* Multiple World Wind windows
-* Interactive shape editors
-* 2525C Tactical Symbols and Tactical Graphics
-
-_____________________________
-Data Formats
-_____________________________
-
-* Imagery: JPG, PNG, GeoTIFF, JPEG2000 and many others
-* Government formats: NITF, MrSID, RPF (CADRG, CIB, etc.), DTED and many others
-* GIS formats: Shapefile, KML, VPF, GML, GeoJSON, GeoRSS, GPX, NMEA and many others
-* Coordinate Systems: Lat/Lon, UTM, MGRS.
-* Datums: WGS84, NAD27 and many others
-
-_____________________________
-Analysis Capabilities
-_____________________________
-
-*  Measurement,  geometric and terrain following
-* Line of site with high-resolution terrain and shapes
-* Terrain intersection
-* Shape interactions
-
-_____________________________
-Miscellaneous Capabilities
-_____________________________
-
-* Deploy as Java Application, Java Applet or Java Web Start Application
-* GIS web service protocols: WMS, WFS
-* Swing, AWT and JOGL integration
-* Layer model with visibility and transparency control
-* Highly configurable and customizable
-* Automatic image and terrain retrieval from web services
-* Animation: View, globe, object
-* Local data cache
-* Automatic region sorting
-* Over 100 programming examples
-* API documentation
-* Community support forum
-
-
-Details
---------------------------------------------------------------------------------
-
-**Website:** http://goworldwind.org/
-
-**Licence:** NASA OPEN SOURCE AGREEMENT VERSION 1.3
-
-**Software Version:** World Wind Java SDK 2.0
-
-**Supported Platforms:** Windows, Linux, Mac
-
-**Forum:** http://forum.worldwindcentral.com/
-
-Quickstart
---------------------------------------------------------------------------------
-
-:doc: `Quickstart documentation <../quickstart/NasaJWW_quickstart>`_
+:Author: Gabriele Prestifilippo
+:Reviewer: Cameron Shorter, LISAsoft
+:Version: osgeo-live9.5
+:License: Creative Commons Attribution 3.0 Unported (CC BY 3.0)
+
+.. image:: ../../images/project_logos/logoNasaJWW.png
+  :alt: project logo
+  :align: right
+  :target: http://goworldwind.org/
+
+Java World Wind
+================================================================================
+Desktop Virtual Globe
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. Cameron Comment: This implies that Java World Wind is not a product in its
+  own right, but just an API. Ie, before I can use Java World Wind, I need to
+  write a program. Is that correct? (This would be an issue for many new users)
+
+Java World Wind provides an Application Programming Interface (API) to display and interact with a virtual globe. 
+
+.. Cameron Comment: There is overlap with sentence above and below. I think these sentences could merge.
+
+Written in Java so as to be cross-platform and easy-to-use, Java World Wind allows developers to quickly and easily create interactive visualizations of a 3 dimensional globe and geographical information.
+
+World Wind provides a rich set of features for displaying and interacting with geographic data and representing a wide range of geometric objects.
+
+Organizations across the world use World Wind to monitor weather patterns, visualize cities and terrain, track the movement of planes, vehicles and ships, analyze geospatial data, and educate people about the earth.
+
+.. Cameron Comment: I sugges that referencing an award in 2009, without noting a more recent achievement implies the project was great once, but is no longer relevant. Might be better to remove the reference. 
+
+In November 2009 was awarded NASA Software of the Year.  Since then it has developed a global community of users, from government, education, the non-profit sector, as well as private industry.
+
+.. image:: ../../images/screenshots/1024x768/javaworldwind_main.png
+ :scale: 50 %
+ :alt: Java World Wind Example
+ :align: right
+
+Core Features
+--------------------------------------------------------------------------------
+
+* High-performance 3 dimensional Virtual globe API and Software Development Kit (SDK)
+* Adds 3 dimensional geographic visualization to any application
+* Runs on Windows, Mac OS X, Linux, iOS and Android
+* Runs in web pages in Java applets
+* Accesses a huge collection of high-resolution imagery and terrain from NASA servers
+* Displays high-resolution imagery, terrain and geographic information from any open-standard public or private source
+
+.. Cameron comment: Try not to duplicate statements, this "open standard" line below can probably be removed or merged with one above.
+
+* Open-standard interfaces to GIS services and databases
+* Large collection of geometric and geographic shapes
+* Simple to extend and modify
+* Uses Java and OpenGL
+
+Graphics Capabilities:
+
+* Point, Path, Polygon, Curtain
+* Volumes: Extruded Polygon, Ellipsoid, Sphere, Cylinder, Cone, Pyramid, Box, Airspaces (see below)
+* Terrain conforming shapes: Path, Polygons, Ellipse, Circle, Quadrilateral, Rectangle, Square, Text, Image, Icon
+* Airspaces: Box, Cake, Capped Cylinder (full and partial), Curtain, Orbit, PolyArc, Polygon, Route, Sphere, Track
+* Annotation: Text, Text Balloon, HTML5 web-browser Balloon, Image, Icons, all with geo-located and screen versions
+* Placenames, Political boundaries
+* 2.5D “Flat Globe” with terrain
+* Transparency
+* Picking, Selection
+* Navigation and Viewing: Orbit View, First Person, Stereo, application-defined
+* Multiple World Wind windows
+* Interactive shape editors
+* 2525C Tactical Symbols and Tactical Graphics
+
+Data Formats:
+
+* Imagery: JPG, PNG, GeoTIFF, JPEG2000 and many others
+* Government formats: NITF, MrSID, RPF (CADRG, CIB, etc.), DTED and many others
+* GIS formats: Shapefile, KML, VPF, GML, GeoJSON, GeoRSS, GPX, NMEA and many others
+* Coordinate Systems: Lat/Lon, UTM, MGRS.
+* Datums: WGS84, NAD27 and many others
+
+Analysis Capabilities:
+
+*  Measurement,  geometric and terrain following
+* Line of site with high-resolution terrain and shapes
+* Terrain intersection
+* Shape interactions
+
+Implemented Standards
+--------------------------------------------------------------------------------
+
+* GML 2.0, 1
+* KML 2.3, 2.2
+* WFS 2.0, 1.0
+* WMS 1.1, 1.3
+* WMTS 1.0
+* OWS 1.0
+
+Details
+--------------------------------------------------------------------------------
+
+**Website:** http://goworldwind.org/
+
+**Licence:** NASA Open Source Agreement Version 1.3
+
+**Software Version:** World Wind Java SDK 2.0
+
+**Supported Platforms:** Windows, Linux, Mac, Android, iOS
+
+**Forum:** http://forum.worldwindcentral.com/
+
+Quickstart
+--------------------------------------------------------------------------------
+
+:doc: `Quickstart documentation <../quickstart/NasaJWW_quickstart>`_

en/overview/webworldwind_overview.rst

@@ -0,0 +1,85 @@
+:Author: Gabriele Prestifilippo
+:Reviewer: Cameron Shorter, LISAsoft
+:Version: osgeo-live9.5
+:License: Creative Commons Attribution 3.0 Unported (CC BY 3.0)
+
+.. Cameron Comment:
+.. Logo size needs to be 125x125 pixles (Currently it is 250x250)
+.. Cameron Comment:
+.. The logo for Web World Wind, and World Wind Java are the same. 
+.. I suggest making them different.
+
+.. Gabriele Comment: Resized the logo and add the "WWW" in the web version. Even If i'm waiting to have an official one that will come   .. soon.
+
+.. image:: ../../images/project_logos/logoNasaWWW.png
+  :alt: project logo
+  :align: right
+  :target: http://webworldwind.org/
+
+Web World Wind
+================================================================================
+
+Virtual Globe in a browser
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. Cameron comment: there is overlap between introduction setence and following
+  The statement about Web World Wind use is the same for both Java World Wind
+  and Web World Wind. (It is a good statement). But it looks like a
+  cut-and-paste, which reduces its credibility. Better to select different use
+  cases for each.
+
+Web World Wind is a browser based, 3 dimensional virtual globe. It allows users to zoom from satellite altitude to any place on earth, experiencing the earth in 3 dimensions, as if really there. It is easy to use, only requiring a two button mouse.  It is used to monitor weather patterns, visualize cities and terrain, track the movement of planes, vehicles and ships, analyze geospatial data, and educate people about the Earth.
+
+Web World Wind provides an extensible, javascript platform which enables web developers to quickly create custom globes and 2 dimensional maps which can express, manipulate and analyze spatial data.  You can show terrain and high-resolution imagery, include a compass, map coordinates, and view controls.
+
+.. image:: ../../images/screenshots/1024x768/webworldwind_main.png
+ :scale: 50 %
+ :alt: Web World Wind Example
+ :align: right
+
+Core Features
+--------------------------------------------------------------------------------
+
+* High-performance, 3 dimensional virtual globe for web pages and web applications
+* 2 dimensional map mode with selectable and extensible map projections
+* JavaScript Application Programming Interface (API) for automating all aspects of interaction and visualization
+* Access to a large collection of high-resolution imagery and terrain
+* Display high-resolution imagery, terrain and geographic data from any public or private source
+* Supports REST, WMS and Bing map layers
+* Large collection of geometric and geographic shapes for representing information
+* Navigation and Viewing, Picking
+* Display multiple globes and maps on the same page
+* Simple to use, extend and modify
+
+Graphics Capabilities:
+
+* Placemark, Path and Curtain, Polygon and Extruded Polygon, Text
+* Terrain conforming shapes: Path, Polygon, Ellipse, Circle, Quadrilateral, Square
+* Imagery: JPEG, PNG
+* Graticules
+* Shapefiles
+
+Implemented Standards
+--------------------------------------------------------------------------------
+
+* WMS 1.1, 1.3
+* WMTS 1.0
+* OWS 1.0
+
+Details
+--------------------------------------------------------------------------------
+
+**Website:** http://webworldwind.org/
+
+**Licence:** NASA Open Source Agreement Version 1.3
+
+**Software Version:** World Wind Pre-release
+
+**Supported Platforms:** Windows, Linux, Mac
+
+**Forum:** http://forum.worldwindcentral.com/forumdisplay.php?60-Web-World-Wind
+
+Quickstart
+--------------------------------------------------------------------------------
+
+:doc: `Quickstart documentation <../quickstart/webworldwind_quickstart>`

en/quickstart/webworldwind_quickstart.rst

@@ -0,0 +1,83 @@
+:Author: Gabriele Prestifilippo
+:Version: Pre-release
+:License: `NASA OPEN SOURCE AGREEMENT VERSION 1.3 <http://worldwind.arc.nasa.gov/worldwind-nosa-1.3.html/>`_ 
+
+
+
+.. image:: ../../images/project_logos/logoNasaWWW.png
+  :alt: project logo
+  :align: right
+  :target: http://webworldwind.org/
+
+
+********************************************************************************
+Web World Wind Quickstart 
+********************************************************************************
+___________
+Get Started
+___________
+
+Web World Wind is a 3D virtual globe API for HTML5 and JavaScript. Web pages include Web World Wind to provide one or more virtual globes on that page.
+
+It’s very easy to get started using Web World Wind. There’s nothing to download. You simply include a short script in an HTML page, as in this example: ::
+
+ <!DOCTYPE html>
+ <!-- This is a very simple example of using Web World Wind. -->
+ <html>
+ <head lang="en">
+     <meta charset="UTF-8">
+     <title>World Wind Example</title>
+     <!-- Include the Web World Wind library. -->
+     <script src="http://worldwindserver.net/webworldwind/worldwindlib.js" type="text/javascript"></script>
+ </head>
+ <body>
+ <div style="position: absolute; top: 50px; left: 50px;">
+     <!-- Create a canvas for Web World Wind. -->
+     <canvas id="canvasOne" width="1024" height="768">
+         Your browser does not support HTML5 Canvas.
+     </canvas>
+ </div>
+ <script>
+     // Register an event listener to be called when the page is loaded.
+     window.addEventListener("load", eventWindowLoaded, false);
+ 
+     // Define the event listener to initialize Web World Wind.
+     function eventWindowLoaded() {
+         // Create a World Window for the canvas.
+         var wwd = new WorldWind.WorldWindow("canvasOne");
+
+         // Add some image layers to the World Window's globe.
+         wwd.addLayer(new WorldWind.BMNGOneImageLayer());
+         wwd.addLayer(new WorldWind.BingAerialWithLabelsLayer());
+ 
+         // Add a compass, a coordinates display and some view controls to the World Window.
+         wwd.addLayer(new WorldWind.CompassLayer());
+         wwd.addLayer(new WorldWind.CoordinatesDisplayLayer(wwd));
+         wwd.addLayer(new WorldWind.ViewControlsLayer(wwd));
+     }
+ </script> 
+ </body>
+ </html>
+
+This example first includes the Web World Wind library, worldwindlib.js, then creates an HTML5 canvas, then defines a script that creates the World Window and populates it with two image layers and three control layers. Click this link to see the web page it creates in a new window. The page contains an interactive 3D virtual globe. Try zooming in with your mouse wheel or on a mobile device with a pinch gesture. Drag the mouse or your finger to pan around the globe. Drag the right mouse button or your two fingers upward to tilt the globe.
+
+_______________________________
+Running Locally inside a server
+_______________________________
+
+Tu run locally a Web World Wind Application, just browse to:
+
+ http://localhost/WebWorlWindexamples/BasicExample.html
+
+and you should see that Web World Wind example in your web browser.
+
+_______________________________
+Source Files
+_______________________________
+Opening: ::
+
+ /var/www/html/WebWorldWind
+
+you will find more Examples along all the source files
+
+| Web World Wind provides much more functionality than is available in this simple example. The Examples page illustrates much of that functionality in simple examples. The Developer’s Guide describes Web World Wind’s functionality in detail. The Deployments page explains how to deploy Web World Wind at  your own web site.