Martin Landa c54d976bdd Fix svn prop (revision) 16 سال پیش
..
compat db49180dd7 welcome to GRASS 7.0.svn 17 سال پیش
docs eb4941da02 wxGUI: note "experimental prototype in manual pages of vdigit and nviz extensions" 16 سال پیش
gui_modules f8c5596f5b Fix wxGUI location wizard: Search in description with 0 hits (trac https://trac.osgeo.org/grass/ticket/554) 16 سال پیش
icons 80c0035551 wxGUI: cosmetics in globalvar import 16 سال پیش
images db49180dd7 welcome to GRASS 7.0.svn 17 سال پیش
nviz f736662617 Build wxGUI Python extension using distutils 16 سال پیش
scripts 3adfa9b1c2 fix path 16 سال پیش
support db49180dd7 welcome to GRASS 7.0.svn 17 سال پیش
vdigit f736662617 Build wxGUI Python extension using distutils 16 سال پیش
xml 8444568318 menu calls r.mfilter.fp instead of r.mfilter. 16 سال پیش
Makefile a20d3df9d7 generate entry for wxpython GUI 16 سال پیش
README 96c595e9e4 wxPython <= 2.8.9.2 requires swig <= 1.3.36 because of name changes: PySwig* to SwigPy* 16 سال پیش
build_ext.py f736662617 Build wxGUI Python extension using distutils 16 سال پیش
gis_set.py ab090365cd wxGUI startup gui: shade start and double click mapset (trac https://trac.osgeo.org/grass/ticket/557) 16 سال پیش
wxgui db49180dd7 welcome to GRASS 7.0.svn 17 سال پیش
wxgui.py c54d976bdd Fix svn prop (revision) 16 سال پیش
wxpythonlib.dox 5599ac8fc0 doxygen fix 16 سال پیش

README

wxPython GRASS Graphical User Interface
=======================================

$Date$

1 - REQUIREMENTS

GRASS GIS >= 6.3
Python >= 2.4 (Python 3 not supported)
Python ElementTree (only for Python <= 2.4)
wxPython >= 2.8.1.1 (wxPython <= 2.8.9.2 requires swig <= 1.3.36)
swig >= 1.3.31 (required only for vector digitizer)
NumPy >= 1.0.4

Get wxPython 2.8.x packages from:
* Source: http://www.wxpython.org/download.php
* Debian GNU/Linux: http://wiki.wxpython.org/InstallingOnUbuntuOrDebian
[ deb http://apt.wxwidgets.org/ etch-wx main ]
http://www.bitpim.org/developer.html -> "Install wxPython"
* Fedora: http://www.wxpython.org/download.php
http://mpa.itc.it/markus/wxpython_rpms/fedora/
* Mandriva: included in main distribution. but the following fix is
required:
ln -s /usr/lib/wxPython/include/wx-2.8/wx /usr/lib64/wx/include/
* MS-Windows: http://www.wxpython.org/download.php
* OS X: http://www.wxpython.org/download.php
* OpenSuSe: http://download.opensuse.org/repositories/Application:/Geo/
* Ubuntu: deb http://wxpython.wxcommunity.com/apt/ubuntu/dapper /
deb http://wxpython.wxcommunity.com/apt/ubuntu/feisty /

Get Python from:
* Python.org for Source, MS-Windows, OS X: http://www.python.org/download/
* ActiveStates for AIX, HP-UX, Linux (x86), Linux 64-bit (x86_64 AMD64), Mac OS X,
Solaris (SPARC), Windows:
http://www.activestate.com/store/download.aspx?prdGUID=b08b04e0-6872-4d9d-a722-7a0c2dea2758

E.g. On Debian GNU/Linux install these packages:
apt-get install libwxbase2.8-0 libwxbase2.8-dbg libwxbase2.8-dev \
libwxgtk2.8-0 libwxgtk2.8-dbg libwxgtk2.8-dev \
python-wxgtk2.8 wx2.8-doc wx2.8-examples \
wx2.8-headers wx2.8-i18n python-numpy

MS-WINDOWS ONLY REQUIREMENTS

Python Extensions for MS-Windows >= Build 210

Get Python Extensions for MS-Windows from:
http://sourceforge.net/project/platformdownload.php?group_id=78018
Get NumPy from:
http://sourceforge.net/project/showfiles.php?group_id=1369&package_id=175103

NVIZ EXTENSION REQUIREMENTS

PyOpenGL: http://pyopengl.sourceforge.net

On Debian GNU/Linux install package:
apt-get install python-opengl

2 - STARTUP WITH GRASS INITIALIZATION

If you want to launch wxPython GUI automatically when you start
GRASS, edit your .grassrc7 file to replace

GRASS_GUI: tcltk (or whatever you have here)

with

GRASS_GUI: wxpython

or easier start new GRASS session with -wxpython switch.

$ grass70 -wxpython


3 - STARTUP FROM GRASS TERMINAL

Simply run

$ g.gui wxpython

from the GRASS terminal.

You can also specify workspace file to load on startup.

$ g.gui gui=wxpython workspace=myworkspace.gxw


4 - CLI Display scripts

Note: This section is out-dated!

This is going to be replacement for command line tools like d.rast and
d.vect.

Now add directory "scripts" in gui directory to your $PATH. These
little programs should later go to GRASS Scripts directory or became
Python scripts or C programs. Now they are only small BASH wrappers
which can be easily and fast customized.

$~ export PATH=scripts/:$PATH

Start GRASS:

$~ grass70 ~/grassdata/spearfish60/user1

Use command p.mon (shell script in gui/scripts directory) to start map
display:

GRASS> p.mon anything

After a while, new window should appear. If this is your case, add some
raster layer to the map display:

GRASS> p.rast aspect

What about a bit transparency?

GRASS> p.rast elevation.dem opacity=0.5

And try the vector layer too

GRASS> p.vect roads

NOTE: only map name is currently supported. No other option will influence
the map layout

Alternatively you can use more universal p.cmd:

GRASS> p.cmd "d.rast map=elevation.dem@PERMANENT catlist=1300-1400 -i"

You should be able to zoom && pan through the map, once the layers are
displayed. You should be also able to store the display content as well as
clear the display and start from scratch.


5 - DEBUGGING

To enable GUI debug messages on given level set GRASS_DEBUG_WX
environment variable, e.g.

$ export GRASS_WX_DEBUG=3


6 - ICON THEMES

Currently two icon themes are available:

* original GRASS (based on TCL/TK GUI prototype)
* Silk-based (default)

User can change icon theme in Preferences dialog
('Config->Preferences').


7 - VECTOR DIGITIZER

To enable digitizer you need to compile 'vdigit'
component. Note that you must configure GRASS with C++ (--with-cxx),
Python (--with-python) and wxWidgets (--with-wxwidgets) support.