Descriptinos du nouveau gradient conique et des nouveaux parametres

possibiles pour les gradients
Ajout des delta de la 3.2.94

1 files changed, 52 insertions, 17 deletions

diff --git a/doc/refman.tex b/doc/refman.tex
index 4218dc5..6602c1f 100644
--- a/doc/refman.tex
+++ b/doc/refman.tex
@@ -36,7 +36,7 @@
     citecolor=webbrightgreen,
     pdftitle={Zinc, an advanced scriptable Canvas.},
     pdfauthor={Patrick Lecoanet, Christophe Mertz, Centre d'Étude de la Navigation Aérienne},
-    pdfsubject={The pre-3.3 (3.2.94) Reference Manual.},
+    pdfsubject={The pre-3.3 (3.2.95) Reference Manual.},
     pdfkeywords={tk tcl perl x11 canvas opengl script gui TkZinc},
     pagebackref,
     pdfpagemode=None,
@@ -208,9 +208,9 @@
 \setlength{\marginparwidth}{20pt}
 \setlength{\textwidth}{480pt}
 
-\title{Zinc, an advanced scriptable Canvas.\\The pre 3.3 (3.2.94) Reference Manual.\\\small{[CENA technical Note NT03-532]} }
+\title{Zinc, an advanced scriptable Canvas.\\The pre 3.3 (3.2.95) Reference Manual.\\\small{[CENA technical Note NT03-532]} }
 \author{Patrick Lecoanet, Christophe Mertz}
-\date{13 June 2003}
+\date{27 June 2003}
 
 
 \begin{document}
@@ -291,11 +291,13 @@ This document is also referenced as CENA technical note NT03-532.
 
 \section{Differences with previous version}
 
-\subsection{Differences between 3.2.94 and 3.2.6 release}
+\subsection{Differences between 3.2.95 and 3.2.6 release}
 \begin{itemize}
 \item  TkZinc now works on windows (with Tcl).
 \item  compilation on Linux works fine now.
-\item  png images with transparencies acan now be displayed (requires openGL rendering only)
+\item  A powerful perl module Tk::Zinc::Graphics has been added to help creating
+complex curves 
+\item  png images with transparencies can now be displayed (requires openGL rendering only)
 \item  bezier items have been suppressed; they can now be easily replaced by curve items.
 \item  curve items support now a higher level of description: they may be composed of line
 segments, and bezier segments. In the future they may also support other kinds of segments
@@ -310,11 +312,12 @@ It has been replaced by the GLU library. So TkZinc is again fully free software.
 \item  curve item have a new -fillrule attribute. 
 \item  the syntax of gradient has been changed, mainly to accomodate with any color specification
 defined for X. {\bf Beware that old gradient are no more compatible}
+\item  conical gradient type has been added; gradient paramaters has been extended.
 \item  TkZinc comes now with a ZincTrace.pm module to trace every TkZinc method call
 \item  the hierarchical view in ZincDebug.pm can now display some choosen attributes
 in a choosen format.
-\item  4 new Perl demos in zinc-demos: ``pathTags'', ``tiger'' and ``curve with bezier control points''
-and ``fillrule''. Most Perl/Tk demos have been ported to Tcl/Tk.
+\item  6 new Perl demos in zinc-demos: ``testGraphics'',  ``magic Lens'', ``pathTags'', ``tiger'' and ``curve with bezier control points''
+and ``fillrule''. Many Perl/Tk demos have been ported to Tcl/Tk.
 \item  pathTags introduced in 3.2.6 have been documented. Label and label
 format documentation has been enhanced.
 \end{itemize}
@@ -4103,21 +4106,53 @@ The following figure shows the effect of fillrule value on curves with multiple
   The string may consist in a single color specification that will be used to paint a solid surface
   or a color with an alpha value or a list of gradient steps separated by \verb+|+ characters.
 
-  The general pattern is:
+  \begin{itemize}
+  \item  The general pattern for an axial gradient is :
   
-  \verb+"=axial degre | gradient_step1 | ... | gradient_stepn"+ for an axial gradient,
+  \verb+"=axial degre | gradient_step1 | ... | gradient_stepn"+ or
+
+  \verb+"=axial x1 y1 x2 y2 | gradient_step1 | ... | gradient_stepn"+
+
+  The \verb+degre+ parameter defines the angle of the axe in the usual
+  trigonometric sense. It defaults to 0. The \verb+x1 y1 x2 y2+ parameters
+  define both the angle and the extension of the axe.
+
+
+  \item The general pattern for a radial gradient is :
+
+  \verb+"=radial x y | gradient_step1 | ... | gradient_stepn"+ or
+
+  \verb+"=radial x1 y1 x2 y2 | gradient_step1 | ... | gradient_stepn"+
+
+  The \verb+x y+ parameters define the center of the radial. The \verb+x1 y1 x2 y2+
+  parameters define both the center and the extension of the radial.
+
 
-  \verb+"=radial x y | gradient_step1 | ... | gradient_stepn"+ for a radial gradient,
+  \item The general pattern for a path gradient is :
 
-  \verb+"=path x y | gradient_step1 | ... | gradient_stepn"+ for a path gradient.
+  \verb+"=path x y | gradient_step1 | ... | gradient_stepn"+
 
-  The \verb+degre+ parameter of an axial gradient defines the angle of the gradient in degres
-  in the usual trigonometric sense. It defaults to 0 degre.
+  The \verb+x y+ parameters define the center of the gradient.
+
+
+  \item The general pattern for a conical gradient is :
+
+  \verb+"=conical degre | gradient_step1 | ... | gradient_stepn"+ or
+
+  \verb+"=conical degre x y | gradient_step1 | ... | gradient_stepn"+ or
+
+  \verb+"=conical x1 y1 x2 y2 | gradient_step1 | ... | gradient_stepn"+
+
+  The \verb+degre+ parameter defines the angle of the cone in the usual
+  trigonometric sense. The optional \verb+x y+ parameters define the center of
+  the cone. By default, it is the center of the bounding-box.
+  The \verb+x1 y1 x2 y2+ parameters define the center and the angle of the cone.
+
+  \end{itemize}
 
-  The \verb+x y+ parameters of radial or path gradient define the center of the gradient.
-  The center is expressed in percentage of the bounding box, relatively to the center of
-  the bounding box. So \verb+0 0+ means the center while \verb+-50 -50+ means the lower
-  left corner of the bounding box.
+  All x and y coordinates are expressed in percentage of the bounding box, relatively
+  to the center of the bounding box. So \verb+0 0+ means the center while \verb+-50 -50+
+  means the lower left corner of the bounding box.
 
   If none of the above gradient type specification is given, the gradient will be drawn as
   an axial gradient with a null angle.