- les images allgradients.png allreliefs.png sont maintenant transparentes

en pdf et en html
- qqs modifs mineures de la doc

3 files changed, 49 insertions, 12 deletions

diff --git a/doc/allgradients.png b/doc/allgradients.png
index b708034..dc26472 100644
--- a/doc/allgradients.png
+++ b/doc/allgradients.png
diff --git a/doc/allreliefs.png b/doc/allreliefs.png
index f83d125..b3fe223 100644
--- a/doc/allreliefs.png
+++ b/doc/allreliefs.png
diff --git a/doc/refman.tex b/doc/refman.tex
index 7f63d09..f1f886a 100644
--- a/doc/refman.tex
+++ b/doc/refman.tex
@@ -201,7 +201,7 @@
 
 \title{Zinc, an advanced scriptable Canvas.\\The 3.2.4 Reference Manual.}
 \author{Patrick Lecoanet}
-\date{11 April 2002}
+\date{2 May 2002}
 
 
 \begin{document}
@@ -352,10 +352,12 @@ of it are derived from the Tk toolkit which is copyrighted under another open so
 license by The Regents of the University of California and Sun Microsystems, Inc. The
 general polygon clipper, GPC, is copyrighted by the Advanced Interfaces Group,
 Department of Computer Science, University of Manchester. GPC can't be used for
-commercial purposes. It is possible to use Zinc without including GPC, it is a
-compile time decision. The GL font rendering is derived from Mark Kilgard code
-described in ``A Simple OpenGL-based API for Texture Mapped Text'' and is copyrighted
-by Mark Kilgard under an open source license.
+commercial purposes without the agreement of the University of Manchester and a monetary
+contribution to the University of Manchester. Please contact them at gpc@cs.man.ac.uk
+or browse http://www.cs.man.ac.uk/aig/staff/alan/software/ It is possible to use Zinc
+without including GPC, it is a compile time decision. The GL font rendering is derived
+from Mark Kilgard code described in ``A Simple OpenGL-based API for Texture Mapped
+Text'' and is copyrighted by Mark Kilgard under an open source license.
 
 
 \section{Authors and credits}
@@ -987,6 +989,11 @@ can be mixed.
 ($xo, $yo, $xc, $yc) = $zinc->bbox("(red && black)||(pink && !$thisitem)");
 \end{verbatim}
 
+Some methods only operate on a single item at a time;  if \ident{tagOrId} is specified
+in a way that names multiple items, then the normal behavior is for the methods is to
+use the first (lowest) of these items in the display list that is suitable for
+the method.  Exceptions are noted in the method descriptions below.
+
 Tags can be associated with items by giving a tag list to the \ident{-tags} attribute or
 by using the more powerful \cmdref{addtag} command. A tag can be removed by the
 \cmdref{dtag} command, by setting the \ident{-tags} attribute to the empty list, all tags
@@ -1675,7 +1682,9 @@ false.
   various {\tt args}. The items are sorted in drawing order, topmost first. \\
   For example:\\
   \code{ \# to get the item under the mouse cursor:\\ \$item = \$zinc->find('withtag',
-  'current');}
+  'current');\\
+  \# to get the closest item of a point:\\ \$closest = \$zinc->find ('closest', \$x, \$y);
+}
 
 \end{blockindent}
 
@@ -3025,7 +3034,7 @@ value is {\tt 360}.}
 
 \attribute{arc}{fillcolor}{gradient}{ Specifies the color that will be used to fill
 the arc if requested by the \attributeref{arc}{filled} attribute. The default value is a one color
-gradient based on the current value of the widget option \optref{forecolor}.}
+gradient based on the current value of the widget option \optref{backcolor}.}
 
 \attribute{arc}{filled}{boolean}{Specifies if the item should be filled. The default value
 is {\tt false}.}
@@ -3114,7 +3123,7 @@ with the local transform. The default value is {\tt true}.}
 
 \attribute{curve}{fillcolor}{gradient}{Specifies the color that will be used to fill
 the curve if requested by the \attributeref{curve}{filled} attribute. The default value is
-a one color gradient based on the current value of the widget option \optref{forecolor}.}
+a one color gradient based on the current value of the widget option \optref{backcolor}.}
 
 \attribute{curve}{filled}{boolean}{Specifies if the item should be filled. The default
 value is {\tt false}.}
@@ -3211,7 +3220,7 @@ composed with the local transform. The default value is {\tt true}.}
 
 \attribute{bezier}{fillcolor}{gradient}{Specifies the color that will be used to fill
 the bezier if requested by the \attributeref{bezier}{filled} attribute. The default value is a one color
-gradient based on the current value of the widget option \optref{forecolor}.}
+gradient based on the current value of the widget option \optref{backcolor}.}
 
 \attribute{bezier}{filled}{boolean}{Specifies if the item should be filled. The default
 value is {\tt false}.}
@@ -3437,7 +3446,7 @@ depending on the label orientation.  The default value is {\tt "-"} which means
 dynamic alignment.}
 
 \attribute{field}{backcolor}{gradient}{ The field background color. The default value is the
-current value of the widget option \optref{forecolor}.}
+current value of the widget option \optref{backcolor}.}
 
 \attribute{field}{border}{edgelist}{ The border description edge by edge. The border is a
 one pixel wide outline that is drawn around the field outside the relief. Some border
@@ -3590,7 +3599,11 @@ by any new user of Zinc: \attrtyperef{gradient} and \attrtyperef{labelformat}.}
   bottom}, {\tt contour}, {\tt oblique} and {\tt counteroblique}. The {\tt contour} value
   is the same as the {\tt "left top right bottom"} list. The {\tt oblique} and {\tt
   counteroblique} values describe diagonal segments from top-left to bottom-right and from
-  top-right to bottom-left respectively.
+  top-right to bottom-left respectively. The following picture gives some edges examples.
+
+\fig{alledges}{edgelist examples}
+
+
 \end{blockindent}
 
 \attrtype{font}
@@ -3651,6 +3664,27 @@ by any new user of Zinc: \attrtyperef{gradient} and \attrtyperef{labelformat}.}
 
   A gradient segment can be specified as a single color. In this case a flat uniform fill
   will result.
+
+  The following picture gives many examples of gradients. They correspond to the following values:
+
+\verb+axial 1 :  'black|white/90'+
+
+\verb+axial 2 :  'black|white/90'+
+
+\verb+axial 3 :  'black|white/30'+
+
+\verb+axial 4 :  'black|black:0/30'+
+
+\verb+radial 1 : 'white|black(25 15'+
+
+\verb+radial 2 : 'white:50 0 70|black 50|white 100(35 25'+
+
+\verb+path 1 :   'white|black:80[25 15'+
+
+\verb+path 2 :   'white|white 30|black:80[25 15'+
+
+\fig{allgradients}{Examples of axial, radial and path gradients}
+
 \end{blockindent}
 
 \attrtype{gradientlist}
@@ -3703,7 +3737,7 @@ by any new user of Zinc: \attrtyperef{gradient} and \attrtyperef{labelformat}.}
 
   \verb+<sChar> ::= x|f|i|a|l+
 
-  \verb+<sChar>+ specifies the meaning of the following \verb+<fieldWidth>+ or \verb+<fieldHeight>+. Those are positive integers.   Values for \verb+sChar+ have the following meaning :
+  \verb+<sChar>+ specifies the meaning of the following \verb+<fieldWidth>+ or \verb+<fieldHeight>+. Those are positive integers.   Values for \verb+<sChar>+ have the following meaning :
 
   \begin{itemize}
   \item \verb+'x'+ : the corresponding dimension (either width or height) is in pixel,
@@ -3816,6 +3850,9 @@ by any new user of Zinc: \attrtyperef{gradient} and \attrtyperef{labelformat}.}
   Describes a border relief. The possible values are {\tt flat}, {\tt groove}, {\tt
   raised}, {\tt ridge}, {\tt sunken}, {\tt roundraised}, {\tt roundsunken},
   {\tt roundgroove}, {\tt roundridge}, {\tt sunkenrule}, {\tt raisedrule}.
+
+\fig{allreliefs}{Examples of all available reliefs}
+
 \end{blockindent}
 
 \attrtype{string}