Martin Landa 2e6ef9dd06 wxversion doesn't work with bundled wxpython cont'ed 16 years ago
..
compat db49180dd7 welcome to GRASS 7.0.svn 17 years ago
docs 663d4a7664 HTML fixes 16 years ago
gui_modules 2e6ef9dd06 wxversion doesn't work with bundled wxpython cont'ed 16 years ago
icons 2e6ef9dd06 wxversion doesn't work with bundled wxpython cont'ed 16 years ago
images db49180dd7 welcome to GRASS 7.0.svn 17 years ago
nviz c8576679cf wxGUI osgeo4w patch applied (by jef) - trac https://trac.osgeo.org/grass/ticket/519 16 years ago
scripts 3adfa9b1c2 fix path 16 years ago
support db49180dd7 welcome to GRASS 7.0.svn 17 years ago
vdigit 27885d177f wxGUI/vdigit: revert previous changes to allow compiling without gcdc (trac https://trac.osgeo.org/grass/ticket/525) 16 years ago
xml 7f2557eb5a merge GUI changing tools from devbr6, https://trac.osgeo.org/grass/changeset/36030 / trac https://trac.osgeo.org/grass/ticket/500 16 years ago
Makefile a20d3df9d7 generate entry for wxpython GUI 16 years ago
README c3fb096f21 numpy is basic requirement for wxGUI 16 years ago
gis_set.py 2e6ef9dd06 wxversion doesn't work with bundled wxpython cont'ed 16 years ago
wxgui db49180dd7 welcome to GRASS 7.0.svn 17 years ago
wxgui.py 2e6ef9dd06 wxversion doesn't work with bundled wxpython cont'ed 16 years ago
wxpythonlib.dox 5599ac8fc0 doxygen fix 16 years ago

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
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: tcktk (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.