aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/refman.tex69
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.