
This is a Beta version of GraceGTK, derived from grace-5.1.22,
using the GTK+ API

All the help to enhance the code and the Web site is welcomed,

GraceGTK is on  http://gracegtk.sourceforge.net
	 in the "dev" directory

Windows binaries
================
The files gracegtk-x.y.z_bin.zip  are windows binaries.
You have just to unzip the file in the place of your choice,
go into the bin directory and run ggrace.exe

Warning : the GUI size is configured too use at least a 17 inches
screen. If yours is smaller you have to set GRACEGTK_GUI_SIZE
environment variable to a convenient size 
(see doc/GraceGTK.pdf for more details)

NEWS:
====


2011.10.11
---------- gracegtk-0.4.4
Mainly a maintenance version.
* Mouse button 3 in spin button used to set x1, y1, x2 and y2 
  in object right pane window fires a  menu to set min ,max, 
  step and value of the entry xill be scanned by the command
  interpreter.


---------- gracegtk-0.4.3 "Mouse button 3"
* Mouse button 3 in TreeView allows to create/break/prune
  directly compounds
* Mouse button 3 in some right pane menu entries fires 
  the Font tool popup.
* Menubar/Plot entries now open TreeView instead of old
   grace-5 menus
* The "special" tab in the Explorer/Set pane has been revised
* and as usual, some bugs are corrected...

2011.08.13
---------- gracegtk-0.4.2 "CUPS"
* Added CUPS support.
* Known standard page sizes are extended to ISO 216 
  A0 to A9 and B0 to B9
* Mouse Button3 menus are revisited.
* Bugs corrected:  rescaling compounds, 
  rescaling in another graph...

2011.07.14
--------- gracegtk-0.4.1 "Wavelets"
* Added one dimension wavelet transforms
* Experimental differential "Savs as..."  option  to avoid
  printing parameters identical to hard coded templates
* And some bugs corrections...


---------- gracegtk-0.4.0 "X-splines" and "Polylines"
The successor of gracegtk-0.3.4
* The "Line" type is extended to "Polyline" that can be
  interpolated into a smooth curve.
* New X-spline (borrowed to xfig) interpolation is introduced
  in 3 places:
  + in Data/Transformation/Interpolate to create new sets,
  + in Explorer/Set/Line tab to connect points
  + in Explorer/Polyline to smooth polylines.
Bugs corrections:
* in Data/Transformations/Interpolation splines
  when trying to use the abscissas from another set.
* Added a if to have always the Colorbar of xycmap sets
  oriented upward with increasing values of z.
* Bug introduced by instant_update when changing
  obj (arc,..)  attachment to gno and coord. type
* When rescaling object in compound with world loctyp
* Lack of UTF-8 <-> Latin-1 conversion for labels in treeview.


INSTALLATION
============

To get a short documentation, read doc/README
A more detailed account is given in doc/GraceGTK.pdf 
(or if the file does not exist in doc/GraceGTK.tex)

Prerequisites: 
--------------
A working GTK+-2 install rev >= 2.12
If rev is >= 2.10 and < 2.12, the program should run but the tooltips are disabled.  

Contour level curves need a FORTRAN compiler: gfortran is just fine.
The compiler is detected by configure through the environment variable FC, 
e.g. if gfortran is the name of the compiler:
     export FC=gfortran

INTEL FORTRAN ifort compiler: in src/Makefile uncomment the two lines
for LDFLAGS and LD

For other compilers, you have to adapt yourself the Makefile.

To compile from the present directory:
----------
./configure 
make

The name of executable produced is ggrace.

Before runing ggrace:
export GRACEGTK_HOME=<the_present_directory>
or
make install 
export GRACEGTK_HOME=<the_install_directory> 

The default installation directory is  /usr/local/gracegtk

To have a better localization of bugs:
./configure --enable-debug

Windows XP and Vista
--------------------
To compile, you must have MinGW, MSYS and GTK+ installed. 

The  grace_np directory will not be compiled under MS Windows.

You can have to hack autotools files to get a working configure.
The configure script works if run in a MSYS command windows.

No testing has been done with the CygWin environment.

It is a good idea to read the doc by directly opening the files in 
the doc directory with you favorite viewer.

IF configure DOES NOT WORK
--------------------------
Soft-link or copy ac-tools/configure.in  in the present directory,
then run "autoconf" to regenerate the configure file.

Tip: if you have problems with GTK configuration, try the command
     pkg-config --cflags  gtk+-2.0
that can inform you about what is going wrong.

Remark: Suse SLE server 11 (64 bits) has not a working GTK 64 bits library 

CUSTOMIZATION
=============
If the default size of the main window does not fill your needs,
use the GRACEGTK_GUI_SIZE environment variable.
A finest control of dialog sizes can be obtained by changing the values 
in the line 
        static gint popup_width = 450 ....
at the beginning of several gg*.c files 

Remember that GTK inherits from the current theme, but the windows
sizes in GraceGTK are given in pixels.


COMPATIBILITY with Grace-5 (Motif)
==================================
Some features of the Motif version are not yet implemented

Others such as monochrome or low resolution are for
those who live in the past: Motif is for them
and I have no intention of programing these options. 

I have never used NetCDF, thus it is not implemented.

The Window/Point_explorer menu is replaced by the Explorer/Set/Main
menu and the toolbar buttons with xfig icons.

The Window/Drawing menu is replaced by the menus in Explorer
right pane.


NEW FEATURES
============
The best way to know about them is to try the examples in 
    Menubar/Examples/GraceGTK  menu
and read the doc/GraceGTK.pdf  file

A short and incomplete list:
* Explorer (TreeView) popup
* Toolbar buttons
* Spline and interpolation
* Follow me mode
* The "layers" feature
* The color map and contour type of set
* The compound type of geometric object
* The Ellipse object is replaced by the more general Arc one

Import ASCII data selecting columns in the data file
----------------------------------------------------
This new option use a formatting string "Sel:" characterizing each
column by one letter surrounded by one (or more) blank with the
following meaning: 
  x is for the abscissa column
  y is for a new set y coordinates
  - is to ignore this column 
To ignore the last columns, just erase the corresponding  last "y"

The uniread function try to find in the first 10 lines a line with
only numbers and this line is used as the first data line.
It is possible to give a legend name to each column if the preceding
line begin with an exclamation mark (!) 
See src/1_echelette_courbe.res.tab.dat  file for an example.



==========
KNOWN BUGS
==========
The -pipe test is not working as expected with Linux i.e.
intermediate curves are not displayed and only the last one becomes
visible.  
Nevertheless, the grace_np library seems to work correctly.

Piping is completely disabled under MSWindows.

To fill polygons, GDK_EVEN_ODD_RULE is not woking as expected,
so I force:  setfillrule (FILLRULE_WINDING)

T1fonts anti-aliasing is made with respect to the page background
color, thus if a glyph is drawn on a colored box, it produces
sometimes poor results. 

If scale is not isometric (PAGE_FIXED), the circles objects in
world coordinates can be ellipses because they are circles in viewport
coordinates only.

The numbers displayed in the justification menu for strings is not the
number needed by commands in .agr scripts

The JPEG driver does not display grids in polar plots correctly: 
it seems that this bug is already present in grace-5.1.22.

When one of several graphs is a XYCMAP and other a XY,
the symbol size spin button, when repetition is used,
enter a circular dependency loop, which stops only at spin limits.

The "KNOWN BUGS" list is probably very incomplete.

Not implemented:
----------------
* the contextual help => replaced by tooltips
* the netCDF  interface
* the shortcut bindings


;;; Local Variables: ***
;;; mode: auto-fill  ***
;;; mode: flyspell   ***
;;; ispell-local-dictionary: "english" ***
;;; End: ***
