wxGUI.html 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608
  1. <h2>DESCRIPTION</h2>
  2. wxGUI is native <em>Graphical User Interface</em> (GUI) for GRASS GIS.
  3. <p>
  4. If the wxGUI is not the default user interface, it can defined as default by
  5. typing at the GRASS command line prompt:
  6. <div class="code"><pre>
  7. g.gui -u wxpython
  8. </pre></div>
  9. Alternatively it may be defined in the settings file
  10. <tt>$HOME/.grass7/rc</tt> with the 'GUI' variable:
  11. <div class="code"><pre>
  12. GUI: wxpython
  13. </pre></div>
  14. or it can be set with the shell environmental variable <tt>GRASS_GUI</tt>.
  15. <p>
  16. The GUI can be quit by selecting the 'File -&gt; Exit' menu item. The GUI
  17. can be restarted from the GRASS command line prompt by typing
  18. <div class="code"><pre>
  19. g.gui wxpython
  20. </pre></div>
  21. or, to restart with previously saved workspace type:
  22. <div class="code"><pre>
  23. g.gui wxpython workspace=file.gxw
  24. </pre></div>
  25. <p>
  26. The user can also start GRASS from the shell command line with the wxGUI
  27. specifying the <tt>-gui</tt> (or, <tt>-wxpython</tt>) switch:
  28. <div class="code"><pre>
  29. grass70 -gui
  30. </pre></div>
  31. <p>
  32. The GUI is composed of <em>two</em> main components:
  33. <ul>
  34. <li>The <b>Layer Manager</b> includes map layer management, integrated
  35. command-line prompt, and command output window tab.</li>
  36. <li>The <b>Map Display Window</b> integrates basic tools for
  37. zooming, panning, data querying, and map elements (north arrows,
  38. barscale, etc.). Each display window is associated with its own
  39. set of map layers in the layer manager. The user may start multiple map
  40. displays during a session. The map layers for each display are grouped
  41. under different tabs in the Layer Manager.</li>
  42. </ul>
  43. <h3>Layer Manager</h3>
  44. The <em>Layer Manager</em> provides an interactive graphical interface for
  45. creating and managing GRASS displays. There is a toolbar to manage displayed
  46. map layers, a layer tree frame in which map layers for display are organized,
  47. a command output window tab, and interactive command line prompt. On Linux
  48. and Windows platforms, the layer manager also has a menu bar with a set of
  49. pull-down menus for all GRASS GIS functions (analysis, file I/O, GIS
  50. configuration and management); on a Mac, the GRASS functions menu is at the
  51. top of the screen.
  52. <center>
  53. <br><img src="wxGUI_layer_manager.jpg" border="1"><br><br>
  54. </center>
  55. The top left button of the toolbar opens a new <em>Map Display
  56. Window</em>. Each map display has a unique set of layers to display
  57. and region settings. Other toolbar buttons add layers of different
  58. types for display in the selected map display window. There are
  59. additional buttons for saving or opening workspace file, and others.
  60. <p>
  61. Map layers are listed in the window frame below the toolbar. Layers can
  62. include raster and vector maps, vector labels, and commands (where any
  63. GRASS command can be written). Layers are displayed as arranged in the layer
  64. tree: the bottom layer is displayed first and the top layer is displayed
  65. last, as if the layers were a series of stacked overlays.
  66. <p>
  67. The check box to the left of each layer makes it active or inactive
  68. for display. Only active layers are displayed/redisplayed when the
  69. display button is pressed. Layers can be organized into groups; entire
  70. groups can be activated or deactivated for display. Layer tree
  71. composition can be saved to a workspace file and opened in subsequent
  72. sessions, restoring all layers and their display options.
  73. <p>
  74. A right mouse click on a layer or left clicking the button to the right of
  75. the layer opens a dropdown menu with options to remove or rename the layer
  76. (g.remove, g.rename), change its display properties (d.rast and d.vect
  77. options such as color, symbol, etc.), show its metadata (r.info, v.info) or
  78. attributes, if applicable.
  79. <p>
  80. A left mouse double click on a layer opens GUI for its display options
  81. These options are those for the d.* command for each layer type (d.rast,
  82. d.vect, or d.grid, for example).
  83. <h4>Layer Manager Toolbar</h4>
  84. <dl>
  85. <dt><img src="icons/monitor-create.png">&nbsp;
  86. <em>Start new display / create new workspace</em></dt>
  87. <dd>Opens a new map display and creates empty layer tree tab in Layer
  88. Manager or creates new workspace for the current layer tree.
  89. <dl>
  90. <dt><img src="icons/monitor-create.png">&nbsp;
  91. <em>Start new map display</em></dt>
  92. <dd>Opens a new map display and creates empty layer tree tab in Layer Manager.</dd>
  93. <dt><img src="icons/create.png">&nbsp;
  94. <em>Create new workspace</em></dt>
  95. <dd>Removes all layers from the layer tree and creates a new, empty tree
  96. where new layers can be added.</dd>
  97. </dl>
  98. </dd>
  99. <dt><img src="icons/layer-open.png">&nbsp;
  100. <em>Load / import map layers into workspace</em></dt>
  101. <dd>Loads or imports selected raster or vector maps into current layer tree.
  102. <dl>
  103. <dt><img src="icons/layer-open.png">&nbsp;
  104. <em>Load map layers into workspace</em></dt>
  105. <dd>Loads selected raster or vector maps into current layer tree.</dd>
  106. <dt><img src="icons/layer-import.png">&nbsp;
  107. <em>Import raster data</em></dt>
  108. <dd>Import selected raster data into GRASS and load them into current layer tree.</dd>
  109. <dt><img src="icons/layer-import.png">&nbsp;
  110. <em>Import vector data</em></dt>
  111. <dd>Import selected vector data into GRASS and load them into current layer tree.</dd>
  112. <dt><img src="icons/layer-import.png">&nbsp;
  113. <em>Link external raster data</em></dt>
  114. <dd>Link selected external raster data as GRASS raster maps and load them into current layer tree.</dd>
  115. <dt><img src="icons/layer-import.png">&nbsp;
  116. <em>Link external vector data</em></dt>
  117. <dd>Link selected external vector data as GRASS vector maps and load them into current layer tree.</dd>
  118. </dl>
  119. </dd>
  120. <dt><img src="icons/open.png">&nbsp;
  121. <em>Open existing workspace file</em></dt>
  122. <dd>Opens an previously saved workspace file, containing a set of display
  123. layers and their option settings.</dd>
  124. <dt><img src="icons/save.png">&nbsp;
  125. <em>Save current workspace to file</em></dt>
  126. <dd>Saves current set of layers and their options to a workspace
  127. file.</dd>
  128. <dt><img src="icons/layer-raster-add.png">&nbsp;
  129. <em>Add raster map layer</em></dt>
  130. <dd>Adds raster map to layer tree, see <em><a href="d.rast.html">d.rast</a></em>.
  131. </dd>
  132. <dt><img src="icons/layer-raster-more.png">&nbsp;
  133. <em>Add various raster map layers (RGB, HIS, shaded relief...)</em></dt>
  134. <dd>Opens a dropdown menu that allows user to select to:
  135. <dl>
  136. <dt><img src="icons/layer-raster3d-add.png">&nbsp;
  137. <em>Add 3D raster map layer</em></dt>
  138. <dd>Adds 3D raster map to layer tree.</dd>
  139. <dt><img src="icons/layer-rgb-add.png">&nbsp;
  140. <em>Add RGB raster layer</em></dt>
  141. <dd>Combines and displays three raster maps defined as red, green,
  142. and blue channels to create an RGB color map,
  143. see <em><a href="d.rgb.html">d.rgb</a></em>.</dd>
  144. <dt><img src="icons/layer-his-add.png">&nbsp;
  145. <em>Add HIS raster layer</em></dt>
  146. <dd>Combines and displays two or three raster maps defined as hue,
  147. intensity, and (optionally) saturation channels to create a color map,
  148. see <em><a href="d.his.html">d.his</a></em>.</dd>
  149. <dt><img src="icons/layer-shaded-relief-add.png">&nbsp;
  150. <em>Add shaded relief raster map layer </em></dt>
  151. <dd>Adds shaded relief raster map layer,
  152. see <em><a href="d.shadedmap.html">d.shadedmap</a></em>.</dd>
  153. <dt><img src="icons/layer-aspect-arrow-add.png">&nbsp;
  154. <em>Add raster arrows layer</em></dt>
  155. <dd>Adds map of raster cells with directional arrows drawn. Arrow
  156. direction and length are determined by separate aspect/directional map
  157. and (optional) slope/intensity map,
  158. see <em><a href="d.rast.arrow.html">d.rast.arrow</a></em>.</dd>
  159. <dt><img src="icons/layer-cell-cats-add.png">&nbsp;
  160. <em>Add raster numbers layer</em></dt>
  161. <dd>Adds map of raster cells with numbers representing the cell values,
  162. see <em><a href="d.rast.num.html">d.rast.num</a></em>.</dd>
  163. </dl>
  164. </dd>
  165. <dt><img src="icons/layer-vector-add.png">&nbsp;
  166. <em>Add vector map layer</em></dt>
  167. <dd>Adds a vector map layer,
  168. see <em><a href="d.vect.html">d.vect</a></em>.</dd>
  169. <dt><img src="icons/layer-vector-more.png">&nbsp;
  170. <em>Add various vector map layers (thematic, chart...)</em></dt>
  171. <dd>Opens a dropdown menu that allows user to select to:
  172. <dl>
  173. <dt><img src="icons/layer-vector-thematic-add.png">&nbsp;
  174. <em>Add thematic area (choropleth) map layer
  175. (for all vector types)</em></dt>
  176. <dd>Adds layer for thematic display values from a numeric attribute
  177. column associated with a vector map. Options include: thematic display
  178. type (graduated colors or point sizes), methods for creating display
  179. intervals, SQL query of attribute column to limit vector objects to
  180. display, control of point icon types and sizes, control of thematic
  181. color schemes, creation of legend for thematic map, and saving the
  182. results of thematic mapping to a ps.map instructions file for later
  183. printing,
  184. see <em><a href="d.vect.thematic.html">d.vect.thematic</a></em>.</dd>
  185. <dt><img src="icons/layer-vector-chart-add.png">&nbsp;
  186. <em>Add thematic chart layer (for vector points)</em></dt>
  187. <dd>Adds layer in which pie or bar charts can be automatically created
  188. at vector point locations. Charts display values from selected columns
  189. in the associated attribute table. Options include: chart type, layer
  190. and attributes to chart, chart colors, and chart size (fixed or based
  191. on attribute column),
  192. see <em><a href="d.vect.chart.html">d.vect.chart</a></em>.</dd>
  193. </dl>
  194. </dd>
  195. <dt><img src="icons/layer-group-add.png">&nbsp;
  196. <em>Add group</em></dt>
  197. <dd>Adds an empty group. Layers can then be added to the group.</dd>
  198. <dt><img src="icons/layer-more.png">&nbsp;
  199. <em>Add grid or vector labels overlay</em></dt>
  200. <dd>Opens a dropdown menu that allows user to select to:
  201. <dl>
  202. <dt><img src="icons/layer-grid-add.png">&nbsp;
  203. <em>Add overlay grids and lines</em></dt>
  204. <dd>Adds layer to display regular grid (for all locations)
  205. see <em><a href="d.grid.html">d.grid</a></em></dd>
  206. <dt><img src="icons/layer-label-add.png">&nbsp;
  207. <em>Add labels layer for vector objects (from existing labels file)</em></dt>
  208. <dd>Add a layer of text from a labels file for vector objects
  209. created with the <em><a href="v.label.html">v.label</a></em> module.
  210. A labels file can also be created with a text editor,
  211. see <em><a href="d.labels.html">d.labels</a></em>.</dd>
  212. <dt><img src="icons/shortest-distance.png">&nbsp;
  213. <em>Add geodesic line layer</em></dt>
  214. <dd>Add layer to display geodesic line for latitude/longitude locations only,
  215. see <em><a href="d.geodesic.html">d.geodesic</a></em></dd>
  216. <dt><img src="icons/shortest-distance.png">&nbsp;
  217. <em>Add rhumbline layer</em>
  218. <dd>Add layer to display rhumblines (for latitude/longitude locations only),
  219. see <em><a href="d.rhumbline.html">d.rhumbline</a></em>.</dd>
  220. <dt><img src="icons/layer-command-add.png">&nbsp;
  221. <em>Add command layer</em></dt>
  222. <dd>Adds a layer in which a GRASS GIS command or command list can be entered.
  223. For a command list use the semi-colon (";") symbol as a separator.
  224. For example:
  225. <div class="code"><pre>
  226. d.rast soils;d.rast -o roads;d.vect streams col=blue
  227. </pre></div>
  228. Note that when an option of the command contains spaces, you need to
  229. "escape" them with the backslash ('\') character, for example:
  230. <div class="code"><pre>
  231. d.text text=Population\ density
  232. </pre></div>
  233. </dl>
  234. </dd>
  235. <dt><img src="icons/layer-remove.png">&nbsp;
  236. <em>Delete selected layer</em></dt>
  237. <dd>Removes selected map layer or map layer group from layer tree.</dd>
  238. <dt><img src="icons/edit.png">&nbsp;
  239. <em>Edit vector maps</em></dt>
  240. <dd>Opens <em><a href="wxGUI.Vector_Digitizer.html">vector digitizer</a></em> to allow editing selected vector map.</dd>
  241. <dt><img src="icons/table.png">&nbsp;
  242. <em>Show attribute table</em></dt>
  243. <dd>Opens <em><a href="wxGUI.Attribute_Table_Manager.html">attribute table manager</a></em> for selected vector map.</dd>
  244. <dt><img src="icons/modeler-main.png">&nbsp;
  245. <em>Start Graphical Modeler</em></dt>
  246. <dd>Opens <em><a href="wxGUI.Modeler.html">graphical modeler</a></em> to create models and run them.</dd>
  247. <dt><img src="icons/settings.png">&nbsp;
  248. <em>Show GUI settings</em></dt>
  249. <dd>Opens dialog to change GUI preferences.</dd>
  250. </dl>
  251. <h4>Key shortcuts</h4>
  252. <dl>
  253. <dt>Ctrl+Tab</dt>
  254. <dd>Switch 'Map layers' and 'Command output' tab</dd>
  255. <dt>Ctrl+Q</dt>
  256. <dd>Exit GUI</dd>
  257. </dl>
  258. <b>Workspace</b>
  259. <dl>
  260. <dt>Ctrl+N</dt>
  261. <dd>Create new workspace</dd>
  262. <dt>Ctrl+O</dt>
  263. <dd>Load workspace from file</dd>
  264. <dt>Ctrl+S</dt>
  265. <dd>Close workspace</dd>
  266. </dl>
  267. <b>Map Layers</b>
  268. <dl>
  269. <dt>Ctrl+Shift+L</dt>
  270. <dd>Add multiple raster or vector map layers to current map display</dd>
  271. <dt>Ctrl+Shift+R</dt>
  272. <dd>Add raster map layer to current map display</dd>
  273. <dt>Ctrl+Shift+V</dt>
  274. <dd>Add vector map layer to current map display</dd>
  275. <dt>Ctrl+W</dt>
  276. <dd>Close current map display</dd>
  277. </dl>
  278. <b>Command line prompt</b>
  279. <dl>
  280. <dt>Tab</dt>
  281. <dd>Show command tooltips</dd>
  282. <dt>Esc</dt>
  283. <dd>Hide command tooltips</dd>
  284. <dt>Ctrl+Space</dt>
  285. <dd>Map entries without arguments (as in <tt>r.info [mapname]</tt>)</dd>
  286. <dt>Up/Down</dt>
  287. <dd>List command history</dd>
  288. <dt>Enter</dt>
  289. <dd>Run command</dd>
  290. </dl>
  291. <h3>Map Display Window</h3>
  292. The map display window includes toolbar that can be docked and undocked from
  293. the window, a map canvas where a map composition of one or more layers is
  294. displayed, and a statusbar with information about the geographic region of
  295. the maps displayed.
  296. <center>
  297. <br><img src="wxGUI_map_display.jpg" alt="Map Display Window"><br><br>
  298. </center>
  299. Each Map Display Window has a unique layer tree (in the layer manager)
  300. and geographic <em>region</em> setting. At the top of the window is a
  301. toolbar with buttons to manage the map in the display (render, erase, zoom
  302. and pan), for query and and analysis (distance measurement, profile,
  303. and histogram creation), to overlay map elements onto the display (scale,
  304. north arrow, legend, and custom text), and to export or print the display.
  305. <p>
  306. In the statusbar, the user can choose to display the geographic coordinates
  307. under the cursor, current geographical region extent, computational region
  308. (including graphical visualization in map display), map display geometry
  309. (number of rows, columns, resolution) and map scale. Checking the
  310. <em>render</em> button in the statusbar will cause the map display to update
  311. automatically any time a map is added to, removed from, or changed in its
  312. layer tree.
  313. <p>
  314. It is important to note that zooming in any display will
  315. have <em>no</em> effect on the 'computational region' setting (set
  316. with <em><a href="g.region.html">g.region</a></em>). Only by selecting
  317. the 'Set current region to match display' item in the zoom menu (in
  318. the map display toolbar) will the current display extents be copied to
  319. the computational region extents.
  320. <h4>Map Display Toolbar</h4>
  321. <dl>
  322. <dt><img src="icons/show.png">&nbsp;
  323. <em>Display map</em></dt>
  324. <dd>Displays all active layers from layer tree and re-renders for display
  325. any layers that have changed since the last time the display was updated,
  326. including layers added or removed.</dd>
  327. <dt><img src="icons/layer-redraw.png">&nbsp;
  328. <em>Re-render map</em></dt>
  329. <dd>Re-renders all active layers regardless of whether they have changed
  330. or not.</dd>
  331. <dt><img src="icons/erase.png">&nbsp;
  332. <em>Erase display</em></dt>
  333. <dd>Erases the currently selected map display to a white background.
  334. see <em><a href="d.erase.html">d.erase</a>, <a href="d.frame.html">d.frame
  335. -e</a></em>.</dd>
  336. <dt><img src="icons/pointer.png">&nbsp;
  337. <em>Pointer</em></dt>
  338. <dd>Select arrow cursor for map display.</dd>
  339. <dt><img src="icons/info.png">&nbsp;
  340. <em>Query raster/vector maps</em></dt>
  341. <dd>Opens a dropdown menu that allows user to select to:
  342. <dl>
  343. <dt><em>Display mode</em></dt>
  344. <dd>Query selected raster, RGB raster (all three map channels will be
  345. queried), or vector map(s) using the mouse. Map(s) must be selected
  346. before query. Vector charts and thematic vector maps cannot be
  347. queried. The results of the query will be displayed in the console window,
  348. see <em><a href="r.what.html">r.what</a>, <a href="v.what.html">v.what</a></em>.</dd>
  349. <dt><em>Edit mode</em></dt>
  350. <dd>Query selected vector map in edit mode. The results of the query
  351. will be displayed in a form that permits editing of the queried vector
  352. attributes.</dd>
  353. </dl>
  354. </dd>
  355. <dt><img src="icons/pan.png">&nbsp;
  356. <em>Pan</em></dt>
  357. <dd>Interactive selection of a new center of view in the active
  358. display monitor. Drag the pan cursor while pressing the left mouse
  359. button to pan. Panning changes the location of the region displayed
  360. but not the size of the area displayed or the resolution. Panning
  361. does <em>not</em> affect the computational region for other GIS
  362. processes, see <em><a href="g.region.html">g.region</a></em>.</dd>
  363. <dt><img src="icons/zoom-in.png">&nbsp;
  364. <em>Zoom in</em></dt>
  365. <dd>Interactive zooming with the mouse in the active display monitor.
  366. Drawing a box or just click with the mouse (left button) and zoom-in
  367. cursor causes the display to zoom in so that the area defined by the
  368. box fills the display. The map resolution is not changed. Clicking
  369. with the zoom-in cursor causes the display to zoom in by 30%, centered
  370. on the point where the mouse is clicked. Zooming resets the display
  371. region extents (both size and location of area displayed). It
  372. does <em>not</em> affect the computational region for other GIS
  373. processes, see <em><a href="g.region.html">g.region</a></em>.</dd>
  374. <dt><img src="icons/zoom-out.png">&nbsp;
  375. <em>Zoom out</em></dt>
  376. <dd>Interactive zooming with the mouse in the active display monitor.
  377. Drawing a box or just click with the mouse (left button) and zoom-out
  378. cursor causes the display to zoom in so that the area displayed
  379. shrinks to fill the area defined by the box. The map resolution is not
  380. changed. Clicking with the zoom-out cursor causes the display to zoom
  381. out by 30%, centered on the point where the mouse is clicked. Zooming
  382. resets the display region extents (both size and location of area
  383. displayed). It does <em>not</em> affect the computational region for
  384. other GIS processes,
  385. see <em><a href="g.region.html">g.region</a></em>.</dd>
  386. <dt><img src="icons/zoom-extent.png">&nbsp;
  387. <em>Zoom to selected map(s)</em></dt>
  388. <dd>Set zoom extent based on selected raster or vector maps. Zooming
  389. resets the display region extents (both size and location of area
  390. displayed). It does <em>not</em> affect the computational region
  391. for other GIS processes,
  392. see <em><a href="g.region.html">g.region</a></em>.</dd>
  393. <dt><img src="icons/zoom-last.png">&nbsp;
  394. <em>Return to previous zoom</em></dt>
  395. <dd>Returns to the previous zoom extent. Up to 10 levels of zoom back are
  396. maintained, see <em><a href="g.region.html">g.region</a></em>.</dd>
  397. <dt><img src="icons/zoom-more.png">&nbsp;
  398. <em>Zoom options</em></dt>
  399. <dd>Opens a dropdown menu that allows user to:
  400. <ul>
  401. <li>Zoom to match the extents of a selected map</li>
  402. <li>Zoom to match the computational region (set with <em>g.region</em>)</li>
  403. <li>Zoom to match the extents of the default region</li>
  404. <li>Zoom to match the extents of a saved region</li>
  405. <li>Set computational region (the mapset's <tt>WIND</tt> file) to match the
  406. current display extents (does not change the resolution),
  407. see <em><a href="g.region.html">g.region</a></em>.
  408. <li>Save display geometry (current extents) to a named region file</li>
  409. </ul>
  410. </dd>
  411. <dt><img src="icons/layer-raster-analyze.png">&nbsp;
  412. <em>Analyze menu</em></dt>
  413. <dd>Opens a dropdown menu with:
  414. <dl>
  415. <dt><img src="icons/measure-length.png">&nbsp;
  416. <em>Distance measurement tool</em></dt>
  417. <dd>Interactive measurement of lengths defined with the mouse. The
  418. length of each segment and the cumulative length of all segments
  419. measuered is displayed in the command output window frame. Lengths are
  420. measured in the current measurement unit,
  421. see <em><a href="d.measure.html">d.measure</a></em>.</dd>
  422. <dt><img src="icons/layer-raster-profile.png">&nbsp;
  423. <em>Profile tool</em></dt>
  424. <dd>Interactively create profile of a raster map. Profile transect is
  425. drawn with the mouse in map display. The profile may be of the
  426. displayed map or a different map. Up to three maps can be profiled
  427. simultaneously,
  428. see <em><a href="gm_profile.html">Profile Tool help page</a></em>.</dd>
  429. <dt><img src="icons/layer-raster-histogram.png">&nbsp;
  430. <em>Histogram tool</em></dt>
  431. <dd>Displays histogram of selected raster map or image in new window,
  432. see <em><a href="d.histogram.html">d.histogram</a></em>.</dd>
  433. </dl>
  434. </dd>
  435. <dt><img src="icons/overlay-add.png">&nbsp;
  436. <em>Add overlay</em></dt>
  437. <dd>opens a dropdown menu that allows user to
  438. <dl>
  439. <dt><img src="icons/scalebar-add.png">&nbsp;
  440. <em>Add scalebar and north arrow</em></dt>
  441. <dd>Adds layer to display a combined scalebar and north arrow. Options
  442. include scalebar placement (using screen coordinates or a mouse),
  443. scalebar format, and scalebar colors,
  444. see <em><a href="d.barscale.html">d.barscale</a></em>.</dd>
  445. <dt><img src="icons/legend-add.png">&nbsp;
  446. <em>Add raster map legend</em></dt>
  447. <dd>Adds layer to display with legend of selected raster map,
  448. see <em><a href="d.legend.html">d.legend</a></em>.</dd>
  449. <dt><img src="icons/text-add.png">&nbsp;
  450. <em>Add text layer</em></dt>
  451. <dd>Adds layer to display a line of text using default GRASS font
  452. (selected with <em><a href="d.font.html">d.font</a></em>). Options
  453. include: text placement (screen coordinates); and text size, bolding,
  454. and color, see <em><a href="d.text.html">d.text</a></em>.</dd>
  455. </dl>
  456. </dd>
  457. <dt><img src="icons/map-export.png">&nbsp;
  458. <em>Save display to graphic file</em></dt>
  459. <dd>Save the visible image in map display to different raster graphic formats.</dd>
  460. <dt><img src="icons/print.png">&nbsp;
  461. <em>Print map</em></dt>
  462. <dd>Prints map on system native printer or PostScript device;
  463. saves visible map display (including PostScript text and labels) to PDF
  464. or EPS file.</dd>
  465. <dt><em>Map display mode</em></dt>
  466. <dd>Opens a dropdown menu for selecting different display mode
  467. <dl>
  468. <dt><em>2D view mode</em></dt>
  469. <dd>Normal GIS display. All active layers are composited and displayed
  470. in 2D mode.</dd>
  471. <dt><em>3D view mode</em></dt>
  472. <dd>Experimental replacement for NVIZ. Displays all active layers in
  473. 3D perspective using OpenGL. A new control panel opens to manage the
  474. 3D view. 3D view can be zoomed, panned, rotated, and tilted. The
  475. vertical exaggeration of rasters and 3D vectors can be set. Various
  476. color and lighten settings are possible. Not yet functional for
  477. Windows platforms</dd>
  478. <dt><em>Digitize mode</em></dt>
  479. <dd>Puts display into vector digitizing mode and opens a new digitizing
  480. toolbar. The user can digitize a new map or edit an existing
  481. map. Not yet functional for Windows platforms</dd>
  482. </dl>
  483. </dd>
  484. </dl>
  485. <h2>SEE ALSO</h2>
  486. wxGUI components:<br>
  487. <em>
  488. <a href="wxGUI.Vector_Digitizer.html">Vector Digitizer</a><br>
  489. <a href="wxGUI.Attribute_Table_Manager.html">Attribute Table Manager</a><br>
  490. <a href="wxGUI.Nviz.html">3D Viewer</a><br>
  491. <a href="wxGUI.Modeler.html">Graphical Modeler</a><br>
  492. <a href="wxGUI.GCP_Manager.html">Manage Ground Control Points</a><br>
  493. <a href="wxGUI.PsMap.html">Cartographic Composer</a><br>
  494. </em>
  495. <p>
  496. See also wxGUI <a href="http://grass.osgeo.org/wiki/WxGUI">wiki</a> page,
  497. and <a href="http://grass.osgeo.org/wiki/Quick_wxGUI_tutorial">Quick
  498. wxGUI Tutorial</a>.
  499. <h2>AUTHORS</h2>
  500. <a href="http://geo.fsv.cvut.cz/gwiki/Landa">Martin Landa</a>, <a href="http://www.fbk.eu">FBK-irst</a> (2007-2008), Trento, Italy, and <a href="http://www.cvut.cz">Czech Technical University in Prague</a>, Czech Republic<br>
  501. Michael Barton, Arizona State University, USA<br>
  502. Daniel Calvelo Aros<br>
  503. Jachym Cepicky<br>
  504. Markus Metz, Germany<br>
  505. Anna Kratochvilova, <a href="http://www.cvut.cz">Czech Technical University in Prague</a>, Czech Republic<br>
  506. Vaclav Petras, <a href="http://www.cvut.cz">Czech Technical University in Prague</a>, Czech Republic<br><br>
  507. Icons created by <a href="http://robert.szczepanek.pl">Robert Szczepanek</a>, Poland (<a href="https://svn.osgeo.org/osgeo/graphics/trunk/toolbar-icons/24x24/">SVN</a>)
  508. <p>
  509. <i>$Date$</i>