aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/refman.tex21
1 files changed, 15 insertions, 6 deletions
diff --git a/doc/refman.tex b/doc/refman.tex
index f7b27dc..41a5fa1 100644
--- a/doc/refman.tex
+++ b/doc/refman.tex
@@ -897,9 +897,12 @@ identity (the default at creation time). In this way, it is possible to use the
space, which is then the same as the window space, as the target space of the
\cmdref{transform} command.
+If you need to manage many different transformations independently, it is a good
+practice to apply these transformations to different groups. For example, a group
+can be used for translation and an other group (father or son) for scaling.
When a rotation or a scale appear in a transformation, all items do not behave exactly in
-the same manner. For example text and icon items do not scale or rotate. Only their
+the same manner. For example text items do not scale or rotate. Only their
position moves according to the rotation or the scaling factor. Here is how items react
to the scale and rotation factors of the transformation.
@@ -912,8 +915,9 @@ to the scale and rotation factors of the transformation.
\item \objectref{waypoint} The position is fully transformed. The label position is computed
relative to the new position and new rotation but is otherwise rigid and its distance
(in pixels) to the position is unchanged.
-\item \objectref{tabular}, \objectref{text}, \objectref{icon} Only the position (relative to the
- anchor) is affected.
+\item \objectref{tabular}, \objectref{text} Only the position (relative to the
+ anchor) is affected.
+\item \objectref{icon} With openGL, icon items can be rotated and zoomed.
\item \objectref{reticle} Only the center and the spacing between circles are affected.
\item \objectref{map} lines and arcs are fully transformed. For texts and symbols only the position
is affected.
@@ -924,7 +928,8 @@ to the scale and rotation factors of the transformation.
However, every item has a couple of attributes \ident{-composescale} and
\ident{-composerotation} that can be used to control how the scale and rotation factors
are inherited from the parents' transformations. These attributes default to \ident{true}
-(i.e. rotation and scale from parents are meaningful. When one of these attributes is set
+(i.e. rotation and scale from parents are meaningful, except for \objectref{icon} where these attributes
+defaulted to \ident{false}). When one of these attributes is set
to false the corresponding factor is reset from the inherited transformation. Scale factors
are reset to 1.0 and rotation is reset to 0. Be careful that this applies to the inherited
transformation, \emph{not} to the item transformation itself which is composed \emph{after}
@@ -2844,7 +2849,7 @@ Applicable attributes for \ident{icon} are:
value is {\tt nw}.}
\attribute{icon}{color}{gradient}{Specifies the fill color used for drawing the
-bitmap. The default value is the current value of the widget option \optref{forecolor}.}
+bitmap. The default value is the current value of the widget option \optref{forecolor}.}
\attribute{icon}{composealpha}{boolean}{Specifies if the alpha value inherited from
the parent group should be composed with the alpha of this item. The default value is {\tt true}.}
@@ -4159,7 +4164,11 @@ useful for newcomers and as starting points for developing real applications.
\section{ZincText.pm}
\concept{zinctext}
-This perl module offers some text input fonctionalities... To be detailed!
+The Tk::ZincText perl module implements bindings for text input 'a la emacs'.
+It works for text item or for text fields of track, waypoint or tabular items.
+The item which require text input must just be tagged with the 'text' tag.
+
+Please read the man page for more details: {\tt man Tk::ZincText}
\section{C api for adding new items}
\concept{Capi}