README.txt

Notes on the useage of the QGIS custom designer plugins

                 Tim Sutton, 2006
--------------------------------------------------------

Introduction:

The purpose of the QGIS designer plugins is to all third
party developers to create GIS enabled QT4 based applications
with minimal programming. The idea being that you use the 
standard Qt4 Designer GUI design tool to create your user
interface and then add map canvas, legend, projection selector
etc. type of widgets from the toolbox of widgets in designer
- with QGIS having added its own group of custome widgets there.
The QGIS custom widgets can then be graphically 'programmed' by
setting widget properties and using interactive signal/slot 
connectors.

Plugin Paths:

There are two options for having Qt4 Designer find your
plugins at startup:

1) copy the plugin from {QGIS Install Prefix}/lib/qgis/designer
   into the standard Qt4 designer plugin directory at 
   $QTDIR/plugins/designer/

2) export the environment variable QT_PLUGIN_PATH with all the
   places designer should look for your plugins in. Separate
   each entry with a colon. So for example:
   
   export QT_PLUGIN_PATH={QGIS Install Prefix}/lib/qgis

   Note that the 'designer' directory is ommitted from the path.