Changeset 4636 for geovis/trunk/geovis_protocol.txt

Timestamp:

Sep 19, 2014, 12:04:45 PM (10 years ago)

Author:

ldelgass

Message:

screen coords command now takes a list of coordinates

File:

• geovis/trunk/geovis_protocol.txt (modified) (3 diffs)

geovis/trunk/geovis_protocol.txt

@@ -90 +90 @@
 
 screen bgcolor <r> <g> <b>
-screen coords <token> <x> <y> <z> <?srs?> <?verticalDatum?>
+screen coords <token> <coordList> <?srs?> <?verticalDatum?>
        Transate map coordinates to screen/mouse coordinates.
        <token> - String token, included in response
-       <x>,<y>,<z> - Map coordinates.  If srs not given, these are in the map's 
-       coordinate system.
+       <coordList> - A list of x,y,z map coordinates.  If <srs> is not given,
+       these are in the map's coordinate system.
        <srs> - Optional horizontal srs init string for coordinate system of 
        x,y,z
@@ -115 +115 @@
 == Map Commands ==
 
-map coords <token> <x> <y> <?srs?> <?verticalDatum?>
+map coords <token> <coordList> <?srs?> <?verticalDatum?>
     Translate screen/mouse coordinates into map coordinates.
     <token> - String token, included in response
-    <x>,<y> - Screen/mouse coordinates
+    <coordList> - A list of x,y screen/mouse coordinates
     <srs> - Optional horizontal srs init string for coordinate system to return
     <verticalDatum> - Optional vertical srs init string for coordinate system to
@@ -209 +209 @@
 nv>image -type image -bytes <nbytes>
   <binary RGB data>
-nv>map coords <token> <mapX> <mapY> <mapZ> <screenX> <screenY> <?srs?> <?verticalDatum?>
-   Reply to query of map coordinates from screen coordinates.  srs of the map
-   coordinates may be included if not in map's native coordinate system
-nv>map coords <token> invalid <mouseX> <mouseY>
-   Reply indicating an off-map click/query
-nv>screen coords <token> <screenX> <screenY> <screenZ> <mapX> <mapY> <mapZ>
-   Reply to query of screen coordinates from map coordinates
-nv>screen coords <token> invalid <mapX> <mapY> <mapZ>
-   Reply indicating requested point is out of the view frustum
+nv>map coords <token> <mapCoordList> <?srs?> <?verticalDatum?>
+   Reply to query of map coordinates from screen coordinates.  The mapCoordList
+   is a list of x,y,z map coordinates.  The srs of the map coordinates may be 
+   included if not in map's native coordinate system.  NaN in the results 
+   indicates off-map input coordinates.
+nv>screen coords <token> <screenCoordList>
+   Reply to query of screen coordinates from map coordinates.  The
+   screenCoordList is a list of x,y,z screen coordinates (z is the depth).  NaN
+   in the results indicates a point outside the view frustum or invalid input
+   map coordinate
 nv>ok -token <seqnum>
    Reply indicated commands through <seqnum> (numbered beginning at 0) have been