diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/refman.tex | 58 |
1 files changed, 49 insertions, 9 deletions
diff --git a/doc/refman.tex b/doc/refman.tex index 8af2ff7..6f200aa 100644 --- a/doc/refman.tex +++ b/doc/refman.tex @@ -201,7 +201,7 @@ \setlength{\marginparwidth}{20pt} \setlength{\textwidth}{480pt} -\title{Zinc, an advanced scriptable Canvas.\\The 3.2.6 Reference Manual.} +\title{Zinc, an advanced scriptable Canvas.\\The 3.2.6 Reference Manual.\\\small{[CENA technical Note NT02-782]} } \author{Patrick Lecoanet} \date{4 July 2002} @@ -221,6 +221,8 @@ %% \chapter{Introduction} \concept{introduction} + + \section{What is Zinc ?} Zinc widgets are very similar to Tk Canvases in that they support @@ -272,6 +274,44 @@ This document is Tcl/Tk and Perl/Tk oriented but it should be easy for Python or programmers to adapt. Every time a Zinc command is described in this document, it is given first in Tcl/Tk idiom and then in Perl/Tk idiom. +This document is also referenced as the CENA technical note NT02-782. + +\section{Differences with previous version} + +\subsection{Differences between 3.2.6 and 3.2.4 release} +\begin{itemize} +\item many bug corrections, of course! +\item this documentation has been improved (changelog, new figures, completions) +\item the contour command can return the contour number +\item the ZincDebug.pm perl module has been fairly augmented +\item the find command may return item ancestor(s) +\item the zinc command may return the version number +\item icom items may be scaled and rotated (needs openGL) +\item anti-overlapping of tracks labels works again +\item tsave can now be used to know if a named transformation is already defined +\item gname can now be used to know if a named gradient is already defined +\item new tags can now be used : ``pathtags'' to go through groups. Yet to be documented! +\item find and addtag commands have been modified to be ``pathtag'' compliant +\item the clone command only clone one item when using a tag. +\item all items have now a -composealpha option +\item it is again an error to configure an unexisting option of an item +\item all items can now get the keyboard focus; thus focus and 'select item' return a list of two elements. +\item new tagged index (bol, eol, bow, eow, up, down) for text items and labels of track, waypoint and tabular +\end{itemize} + +\subsection{Differences between 3.2.4 and 3.2.2 release} +\begin{itemize} +\item many bug corrections, of course! +\item Zinc can now use openGL capablities +\item many new item options (due to openGL capablilites) and a new triangles item +\item a new perl module : ZincDebug.pm to interactively browse the item hierarchy +\item as color are all gradient (with alpha transparency) the -alpha option has been removed +\item a set of zinc demontrations are available with the zinc-demos command +\item many new explanations in this doc: groups, item ids and tags ... +\item the postscript version of this doc has been replaced by a pdf version +\item configuring an unexisting option of an item is no more an error (this was a design mistake) +\item a perl module ZincText.pm make it easier to implement text input +\end{itemize} \section{Where can I find Zinc and documentation ?} @@ -1801,7 +1841,7 @@ false. \zinccmd{focus}{?tagOrId?} -{\tt\large \$item = \$zinc->{\bf focus}();}\\ +{\tt\large (\$item, \$part) = \$zinc->{\bf focus}();}\\ {\tt\large \$zinc->{\bf focus}(tagOrId);} \begin{blockindent} @@ -1809,8 +1849,9 @@ false. more than one item, the first item in display list order that accept the focus is used. If no such item exists, the command has no effect. If {\tt tagOrId} is an empty string the focus is reset and no item has the focus. If {\tt tagOrId} is not specified, - the command returns the id of the item with the focus or an empty string if no item has - the focus. + the command returns a list of two elements. The first is the id of the item with the focus + or an empty string if no item has the focus. The second is the item part or an empty + string if not appliable. When the focus has been set to an item that support an insertion cursor, the item will display its cursor and the keyboard events will be directed to that item. @@ -1818,8 +1859,6 @@ false. The widget receive keyboard events only if it has the window focus. It may be necessary to use the Tk \ident{focus} command to force the focus to the widget window. - \emph{NB: currently (Version 3.2.4) only text items are really getting the focus. - Focus management will be extended to all other items in a near future.} \end{blockindent} @@ -2136,10 +2175,11 @@ false. \item{\tt\large pathname {\bf select} item\\ - \$item = \$zinc->{\bf select}('item');} + (\$item, \$part) = \$zinc->{\bf select}('item');} - Returns the id of the selected item, if the selection is in an item on this - widget. Otherwise the command returns an empty string. + Returns a list of two elements. The first is the id of the selected item if the selection + is in an item on this widget; Otherwise the first element is an empty string. The second + element is the part of the item (track, waypoint or tabular item only) or the empty string. \item{\tt\large pathname {\bf select} to tagOrId index\\ |