Changeset 4350
- Timestamp:
- Apr 26, 2014 9:12:47 AM (10 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/packages/vizservers/geovis/geovis_protocol.txt
r4346 r4350 3 3 Protocol for geovis render server. 4 4 5 Commands take the general form of command and arguments using Tcl syntax and are 5 Commands take the general form of command and arguments using Tcl syntax and are 6 6 terminated by a newline. Some command arguments expect a Tcl list which can be 7 7 sent by enclosing the list in curly braces to prevent the interpreter from … … 27 27 ================================================================================ 28 28 29 == General dataset,scene and renderer commands ==29 == General scene and renderer commands == 30 30 31 31 camera delete <name> … … 50 50 Option all resets orientation/rotation as well as pan/zoom/clip range 51 51 camera restore <name> <?duration?> 52 Set viewpoint to a named viewpoint, with optional animation duration in seconds 52 Set viewpoint to a named viewpoint, with optional animation duration in 53 seconds 53 54 camera rotate <x> <y> 54 55 Specify relative rotation in viewport coordinates … … 56 57 Save current viewpoint to a named viewpoint 57 58 camera set <x> <y> <z> <heading> <pitch> <distance> <?duration?> <?srs?> <?vertDatum?> 58 Explicitly set camera parameters, with optional animation duration in seconds 59 Explicitly set camera parameters, with optional animation duration in 60 seconds 59 61 <x>, <y> = Map coordinates of focal point 60 62 <z> = Altitude of focal point (see vertDatum) … … 64 66 <srs> = coordinate system, defaults to map coordinate system 65 67 <vertDatum> = vertical datum for interpreting z coordinate 68 camera throw <bool> 69 Enable/disable throw inertia for panning/rotating when using mouse events 70 through protocol 66 71 camera zoom <y> 67 72 Specify zoom by viewport coordinates (i.e. normalized y mouse coords) 68 73 69 74 clientinfo <list> 75 76 colormap add <colorMapName> <colorMap> <opacityMap> 77 (Re-)define a colormap. If colorMapName doesn't exist, it is created, 78 otherwise the colormap is redefined and all users will be updated. 79 colorMap = Tcl list of {value r g b} control points 80 opacityMap = Tcl list of {value alpha} control points 81 colormap define <colorMapName> <colorMap> <opacityMap> 82 (Re-)define a colormap (same as 'add') 83 colormap delete <?colorMapName?> 84 colormap res <numberOfTableEntries> 85 Set the "resolution" or number of lookup table entries in the colormap 86 <numberOfTableEntries> = integer or "default" 87 88 renderer render 89 Force a new image to be rendered 90 91 screen bgcolor <r> <g> <b> 92 screen size <width> <height> 93 94 == Mouse and Keyboard Events == 70 95 71 96 key press <key> … … 79 104 mouse scroll <direction> 80 105 81 renderer render 82 Force a new image to be rendered 83 84 screen bgcolor <r> <g> <b> 85 screen size <width> <height> 106 == Map Commands == 86 107 87 108 map coords <x> <y> 88 109 Translate screen/mouse coordinates into map coordinates 110 111 map grid <bool> <?type?> 112 Toggle graticule and set type 113 <type> = geodetic|utm|mgrs 89 114 90 115 General form: 91 116 map layer add <type> <driver> <url> ... <layerName> 92 117 <type> = image|elevation|line|point|polygon|text 93 <driver> = gdal| wms|tms|xyz94 95 Specific layer types:118 <driver> = gdal|tms|wms|xyz 119 120 Specific image layer types: 96 121 map layer add image gdal <url> <layerName> 97 122 Add a GDAL image layer from a file or URL … … 105 130 Add a TMS image layer from a URL 106 131 <url> = URL of TMS service 132 map layer add image xyz <urlPattern> <layerName> 133 Add an image layer from a web map using a template URL 134 135 Elevation layers: 107 136 map layer add elevation <driver> <url> <layerName> 108 137 Add an elevation image layer from a file or URL 109 138 <driver> = gdal|tms|wms 139 140 Feature/model layers: 110 141 map layer add point <url> <layerName> 111 142 Add a point feature layer from a file or URL … … 121 152 map layer move <pos> <layerName> 122 153 map layer visible <bool> <layerName> 154 123 155 map load data follows <nbytes> 124 156 Send an .earth file over the wire … … 127 159 map load url <url> 128 160 Load an .earth file from a network address 161 162 map posdisp <bool> <?format?> <?precision?> 163 Toggle coordinate/position display, set format and precision 164 <format> = latlong_decimal_degrees|latlong_degrees_decimal_minutes| 165 latlong_degrees_minutes_seconds|mgrs 166 <precision> = integer number of digits to display 167 129 168 map reset <type> <?profile?> <?xmin?> <?ymin?> <?xmax?> <?ymax?> 130 169 Clear the scene and rebuild a new map from scratch. When resetting the … … 137 176 xmin,ymin,xmax,ymax = map bounds (in profile projection/units) 138 177 178 map scalebar <bool> <?units?> 179 Toggle scale label/bar 180 <units> = meters|feet|us_survey_feet|nautical_miles 181 map setpos <x> <y> 182 Set the coordinate/position display based on mouse coordinates 183 map terrain edges <bool> 184 *Not currently implemented* 185 map terrain lighting <bool> 186 map terrain linecolor <r> <g> <b> 187 *Not currently implemented* 188 map terrain vertscale <val> 189 Set scale factor for terrain height 190 map terrain wireframe <bool> 191 139 192 ================================================================================ 140 193 Replies: … … 142 195 nv>image -type image -bytes <nbytes> 143 196 <binary RGB data> 144 nv>dataset coords <x> <y> <z> 197 nv>map coords <x> <y> <z> <?mouseX?> <?mouseY?> 198 Reply to query of map coordinates. If reply is to a request with mouse 199 coordinates, the mouse coordinates are included. 200 nv>map coords invalid <mouseX> <mouseY> 201 Reply indicating an off-map click/query 145 202 nv>ok -token <seqnum> 146 203 Reply indicated commands through <seqnum> (numbered beginning at 1) have been
Note: See TracChangeset
for help on using the changeset viewer.
