diff options
| -rw-r--r-- | doc/refman.tex | 69 |
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. |