From e84a9df5327b917d94a73d9876feed70056f3e65 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 20 Mar 2021 22:21:18 +0000 Subject: tzplot (20mar21) (branch) git-svn-id: svn://tug.org/texlive/branches/branch2020.0@58568 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/tzplot/tzplot-doc-A-v1.0.1.tex | 134 + .../doc/latex/tzplot/tzplot-doc-A-v1.0.tex | 128 - .../doc/latex/tzplot/tzplot-doc-B-v1.0.1.tex | 1956 +++++++++ .../doc/latex/tzplot/tzplot-doc-B-v1.0.tex | 1943 --------- .../doc/latex/tzplot/tzplot-doc-C-v1.0.1.tex | 4132 ++++++++++++++++++++ .../doc/latex/tzplot/tzplot-doc-C-v1.0.tex | 3981 ------------------- .../doc/latex/tzplot/tzplot-doc-D-v1.0.1.tex | 1807 +++++++++ .../doc/latex/tzplot/tzplot-doc-D-v1.0.tex | 1792 --------- Master/texmf-dist/doc/latex/tzplot/tzplot-doc.pdf | Bin 808794 -> 827727 bytes Master/texmf-dist/doc/latex/tzplot/tzplot-doc.tex | 16 +- Master/texmf-dist/tex/latex/tzplot/tzplot.sty | 61 +- 11 files changed, 8079 insertions(+), 7871 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/tzplot/tzplot-doc-A-v1.0.1.tex delete mode 100644 Master/texmf-dist/doc/latex/tzplot/tzplot-doc-A-v1.0.tex create mode 100644 Master/texmf-dist/doc/latex/tzplot/tzplot-doc-B-v1.0.1.tex delete mode 100644 Master/texmf-dist/doc/latex/tzplot/tzplot-doc-B-v1.0.tex create mode 100644 Master/texmf-dist/doc/latex/tzplot/tzplot-doc-C-v1.0.1.tex delete mode 100644 Master/texmf-dist/doc/latex/tzplot/tzplot-doc-C-v1.0.tex create mode 100644 Master/texmf-dist/doc/latex/tzplot/tzplot-doc-D-v1.0.1.tex delete mode 100644 Master/texmf-dist/doc/latex/tzplot/tzplot-doc-D-v1.0.tex diff --git a/Master/texmf-dist/doc/latex/tzplot/tzplot-doc-A-v1.0.1.tex b/Master/texmf-dist/doc/latex/tzplot/tzplot-doc-A-v1.0.1.tex new file mode 100644 index 00000000000..1d949a67682 --- /dev/null +++ b/Master/texmf-dist/doc/latex/tzplot/tzplot-doc-A-v1.0.1.tex @@ -0,0 +1,134 @@ +%!TEX root = tzplot-doc.tex +%\begin{document} + +%%%================= +\part{Getting Ready} +%%%================= +\label{p:intro} + +%%================================== +\chapter{Introduction} + +\section{About \texttt{tzplot.sty}} + +The |tzplot| package is just a collection of macros based on \TikZ\ to save you time typing \Tikz\ code. + +In |pstricks|, a line connecting two points |(A)| and |(B)| is drawn by |\psline(A)(B)|. +With the package |tzplot|, you can do it by |\tzline(A)(B)|. + +\begin{tztikz}{} +\tzline(A)(B) % is an abbreviation of: + \draw (A) -- (B); +\end{tztikz} +% +\begin{tztikz}{} +\tzline[blue](A)(B){my line}[r] % is an abbreviation of: + \draw [blue] (A) -- (B) node [right] {my line}; +\end{tztikz} + +Some macros in this package represent one or a few lines of code, but some represent dozens of lines of \Tikz\ code. + +All of the drawing macros of |tzplot| are prefixed by |\tz|. Of course, it means \Tikz. +The syntax of the |tzplot| macros comes from |tikz| and |pstricks|. +However, the input mode is more like |pstricks|. + +To use the |tzplot| package you have to load the package in the preamble of your document as follows: + +\begin{verbatim} + \usepackage{tzplot} +\end{verbatim} + +The package depends on the packages |tikz|, |xparse|, and |expl3|. +And it uses the following \Tikz\ libraries: +\begin{verbatim} + calc,backgrounds,positioning,intersections,arrows,shapes,patterns,plotmarks, + decorations.pathreplacing,calligraphy +\end{verbatim} + +This package sets the basic arrow style to |stealth|. +If you don't like this, as an alternative, you can set the style like |\tikzset{>=to}| after the |tzplot| package is loaded. + +This package was originally motivated by drawing graphs in economics. +Therefore, the macros in this package have been selected and developed for drawing graphs efficiently in economics. However, this package will do a good job of drawing basic graphics in any fields. + +Finally, note that this is far from a \Tikz\ tutorial. +To make good use of this package, you need to familiarize yourself with \Tikz. + +\section{Preoccupied style names} +\label{s:stylenames} + +This package does not provide any environment. +Since all the drawing macros prefixed by |\tz| are just abbreviations of \Tikz\ code, +you can use the macros in the |tikzpicture| environment together with any \Tikz\ commands. + +However, there are some preoccupied style names that you should not overwrite. +Those are as follows: + +\begin{verbatim} + tzdot tzmark tzdotted + tzdashed tzhelplines tznode + tzshorten tzextend tzshowcontrols +\end{verbatim} + +This package also predefined \iisw{abbreviations} of \Tikz's basic placement options as follows: +\label{abbreviations} + +\begin{tzsty}{} +% preoccupied (alias) styles +\tikzset{% + a/.style={above=#1}, + b/.style={below=#1}, + c/.style={centered=#1}, + l/.style={left=#1}, + r/.style={right=#1}, + al/.style={above left=#1}, + ar/.style={above right=#1}, + bl/.style={below left=#1}, + br/.style={below right=#1}, +} +\end{tzsty} +You can use these abbreviations to place \Tikz's \iisw{main node}\xem{s} but not \iisw{label node}\xem{s}. To place label nodes, use non-abbreviated options or angles instead. + + +The |tzplot| package also defines graphic layers as follows: + +\begin{tzsty}{} +\pgfdeclarelayer{background} +\pgfdeclarelayer{behind} +\pgfdeclarelayer{above} +\pgfdeclarelayer{foreground} + +\pgfsetlayers{background,behind,main,above,foreground} +\end{tzsty} +Therefore, you can select the graphic layers in sequence: |background|, |behind|, |main|, |above|, and |foreground|. +For example, you can change the layer of a straight line from |main| (default) to |background| as follows: + +\begin{tzcode}[listing only]{1} +\begin{tikzpicture} +\tzhelplines(4,3) + + +\begin{pgfonlayer}{background} + \tzline[blue](0,0)(3,1) +\end{pgfonlayer} +\end{tikzpicture} +\end{tzcode} + +\section{How to read this document} + +In drawing graphs, too many factors are involved: line style, color, fill, label, positioning, shift, and so on. +Almost all macros of this package have many arguments that control these factors. +Some are mandatory and some are optional. +Optional arguments are hidden when not used. + +The document has three essential parts: Part II, Part III, and Part IV. +Part II introduces essential macros with only frequently used options. +There are many options hidden in the macros introduced in Part II. +Some macros are not introduced in Part II. +Part III and IV describe all the features of all macros. + +You must get started with Part II. +Part II is sufficient for drawing needs in most cases. + +Unless you are an experienced user of \Tikz, it is recommended to move on to Part III and Part IV once you become familiar with Part II. In the meantime, use Part III and Part IV for reference only. Use the list of contents and the index efficiently to find macros you need. + diff --git a/Master/texmf-dist/doc/latex/tzplot/tzplot-doc-A-v1.0.tex b/Master/texmf-dist/doc/latex/tzplot/tzplot-doc-A-v1.0.tex deleted file mode 100644 index 67d2e2e2aa8..00000000000 --- a/Master/texmf-dist/doc/latex/tzplot/tzplot-doc-A-v1.0.tex +++ /dev/null @@ -1,128 +0,0 @@ -%!TEX root = tzplot-doc.tex -%\begin{document} - -%%%================= -\part{Getting Ready} -%%%================= -\label{p:intro} - -%%================================== -\chapter{Introduction} - -\section{About \texttt{tzplot.sty}} - -The |tzplot| package is just a collection of macros based on \TikZ\ to save you time in typing \Tikz\ code. - -In |pstricks|, a line connecting two points |(A)| and |(B)| is drawn by |\psline(A)(B)|. -With the package |tzplot|, you can do it by |\tzline(A)(B)|. - -\begin{tztikz}{} -\tzline[blue](A)(B){my line}[right] % is an abbreviation of: - \draw [blue] (A) -- (B) node [right] {my line}; -\end{tztikz} - -Some macros in this package represent one or a few lines of code, but some represent dozens of lines of \Tikz\ code. - -All of the drawing macros of |tzplot| are prefixed by |\tz|. Of course, it means \Tikz. -The syntax of the |tzplot| macros comes from |tikz| and |pstricks|. -However, the input mode is more like |pstricks|. - -To use the |tzplot| package you have to load the package in the preamble of your document as follows. - -\begin{verbatim} - \usepackage{tzplot} -\end{verbatim} - -The package depends on the packages |tikz|, |xpars|, and |expl3|. -And it uses the following \Tikz\ libraries. -\begin{verbatim} - calc,backgrounds,positioning,intersections,arrows,shapes,patterns,plotmarks, - decorations.pathreplacing,calligraphy - -\end{verbatim} - -This package sets the basic arrow style to |stealth|. -If you don't like this, as an alternative, you can set the style like |\tikzset{>=to}| after the |tzplot| package is loaded. - -This package was originally motivated by drawing graphs in economics. -Therefore, the macros in this package have been selected and developed for drawing graphs efficiently in economics. However, this package will do a good job of drawing basic graphics in any fields. - -Finally, note that this is far from a \Tikz\ tutorial. -To make good use of this package, you need to familiarize yourself with \Tikz. - -\section{Preoccupied style names} -\label{s:abbreviations} - -This package does not provide any environment. -Since all the drawing macros, prefixed |\tz|, are just abbreviations of \Tikz\ code, -you can use the macros in the |tikzpicture| environment together with any \Tikz\ commands. - -However, there are some preoccupied style names that you should not overwrite. -Those are as follows: - -\begin{verbatim} - tzdot tzmark tzdotted - tzdashed tzhelplines tznode - tzshorten tzextend tzshowcontrols -\end{verbatim} - -This package also predefined aliases of \Tikz's basic placement options as follows: - -\begin{tzsty}{} -% preoccupied (alias) styles -\tikzset{% - a/.style={above=#1}, - b/.style={below=#1}, - c/.style={centered=#1}, - l/.style={left=#1}, - r/.style={right=#1}, - al/.style={above left=#1}, - ar/.style={above right=#1}, - bl/.style={below left=#1}, - br/.style={below right=#1}, -} -\end{tzsty} - -The |tzplot| package also defines layers as follows: - -\begin{tzsty}{} -\pgfdeclarelayer{background} -\pgfdeclarelayer{behind} -\pgfdeclarelayer{above} -\pgfdeclarelayer{foreground} - -\pgfsetlayers{background,behind,main,above,foreground} -\end{tzsty} - -Therefore, you can select the graphic layers in sequence: |background|, |behind|, |main|, |above|, and |foreground|. -For example, you can change the layer of a tangent line from |behind| (default) to |main| as follows: - -\begin{tzcode}[listing only]{1} -\begin{tikzpicture} -\tzaxes(10,10) - - -\begin{pgfonlayer}{main} -\tztangentat{curve}{5}[1:8] -\end{pgfonlayer} -\end{tikzpicture} -\end{tzcode} - -\section{How to read this document} - -In drawing graphs, too many factors are involved: line style, color, fill, label, positioning, shift, and so on. -Almost all macros of this package have many arguments that control these factors. -Some are mandatory and some are optional. -Optional arguments are hidden when not used. - -The document has three essential parts: Part II, Part III, and Part IV. -Part II introduces essential macros with only frequently used options. -There are many options hidden in the macros introduces in Part II. -Some macros are not introduced in Part II. -Part III and IV describe all the features of all macros. - -You must get started with Part II. -Part II is sufficient for drawing needs in most cases. - -Unless you are an experienced user of \Tikz, it is recommended to move on to Part III and Part IV once you become familiar with Part II. In the meantime, use Part III and Part IV for reference only. Use the list of contents and the index efficiently to find macros you need. - diff --git a/Master/texmf-dist/doc/latex/tzplot/tzplot-doc-B-v1.0.1.tex b/Master/texmf-dist/doc/latex/tzplot/tzplot-doc-B-v1.0.1.tex new file mode 100644 index 00000000000..6cd6e61fab6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/tzplot/tzplot-doc-B-v1.0.1.tex @@ -0,0 +1,1956 @@ +%!TEX root = tzplot-doc.tex +%\begin{document} + +%%%================================== +\part{Getting Started} +%%%================================== +\label{p:gettingstarted} + +%%================================== +\chapter{An Intuitive Introduction I: Basics} +\label{ci:introI} + +All drawing macros provided in this package work within |tikzpicture| environment, just like any other \Tikz\ commands. + +%%------------------------------------------------------------ +\section{Lines: Basics: \protect\cmd{\tzline(0,0)(3,1)}} +\label{si:lines} + +To draw a line from $(0,0)$ to $(3,1)$, just do |\tzline(0,0)(3,1)|. + +\begin{tzcode}{.3} +% \tzline +\begin{tikzpicture} +\tzhelplines(4,2) +\tzline(0,0)(3,1) +\end{tikzpicture} +\end{tzcode} + +You can use \Tikz\ options to change the style of a line. + +\begin{tzcode}{.3} +% \tzline: change line style +\begin{tikzpicture} +\tzhelplines(4,3) +\tzline(0,0)(3,1) +\tzline[dashed](0,1)(3,2) +\tzline[->,blue,thick](0,3)(4,1) +\end{tikzpicture} +\end{tzcode} + +\begin{tztikz}{} +\tzline[dashed](0,1)(3,2) % works like: + \draw [dashed] (0,1) -- (3,2); +\end{tztikz} + + +%%------------------------------------------------------------ +\section{Dots: Basics} +\label{si:dots} + +\subsection{A circle dot: \protect\cmd{\tzcdot(0,0)}} +\label{ssi:tzcdot} + +\icmd{\tzcdot}|(0,0)| prints a `circle dot' \tikz \tzcdot(0,0);, with the \xem{radius} |1.2pt| by default, at the point |(0,0)|. The starred version \icmd{\tzcdot*} prints a filled dot \tikz \tzcdot*(0,0);. + +\begin{tzcode}{.3} +% \tzcdot: circle dot +\begin{tikzpicture} +\tzhelplines(4,3) +\tzcdot(0,0) +\tzcdot*(3,1) +\tzcdot [red] (0,1)(3pt) % radius=3pt +\tzcdot*[green](3,2)(3pt) % radius=3pt +\end{tikzpicture} +\end{tzcode} + +You can change of the size of a dot by specifying the \xem{radius} of the circle, like, for example, |\tzcdot(0,0)(3pt)|. + +\begin{tztikz}{} +\tzcdot*[green](3,2)(3pt) % is an abbreviation for: + \draw [fill,green] (0,0) circle (3pt); +\end{tztikz} + +\begin{tzcode}{.3} +% \tzcdot +\begin{tikzpicture} +\tzhelplines(4,3) +\tzcdot(0,0) \tzcdot*(3,1) +\tzcdot[red](0,1)(2mm) % radius=2mm +\tzcdot*[green](3,2)(3pt) % radius=3pt +\tzline(0,0)(3,1) +\tzline(0,1)(3,2) +\end{tikzpicture} +\end{tzcode} + + +\subsection{A circle node dot: \protect\cmd{\tzdot(0,0)}} +\label{ssi:tzdot} + +\icmd{\tzdot} draws a `circle node dot' at a specified coordinate. +The starred version \icmd{\tzdot*} prints a filled dot. The default size (\xem{diameter} or |minimum size|) is |2.4pt|. + +\begin{tzcode}{.3} +% \tzdot: node dot +\begin{tikzpicture} +\tzhelplines(4,3) +\tzdot(0,0) \tzdot*(3,1) +\tzdot[red](0,1)(4mm) % minimum size=4mm +\tzdot*[green](3,2)(6pt) % minimum size=6pt +\tzline(0,0)(3,1) +\tzline(0,1)(3,2) +\end{tikzpicture} +\end{tzcode} + + +The size (\xem{diameter} or |minimum size|) of a node dot can be changed by the second (or the last) parenthesis option, like |(6pt)|. + +\begin{tzcode}{.3} +% \tzcdot +\begin{tikzpicture} +\tzhelplines(4,3) +\tzdot(0,0)(5pt) \tzdot*(3,1) +\tzdot[red](0,1)(4mm) \tzdot*[green](3,2)(6pt) +\tzline(0,0)(3,1) +\tzline(0,1)(3,2) +\end{tikzpicture} +\end{tzcode} + +\begin{tztikz}{} +\tzdot[green](0,0)(6pt) % works like: + \draw [green] (0,0) node [tzdot,minimum size=6pt] {}; + % tzdot style is predefined +\end{tztikz} + + +\subsection{Difference between \protect\cmd{\tzcdot} and \protect\cmd{\tzdot}} +\label{ssi:difference} + +A `circle dot' drawn by |\tzcdot| is affected by |xscale| or |yscale| in \Tikz, but a `circle node dot' drawn by |\tzdot| is not. +Note also that |\tzcdot| controls the \xem{radius} of a circle dot (following \Tikz\ practice), while |\tzdot| controls the \xem{diameter} of a circle node dot. + +\begin{tzcode}{.3} +% \tzdot: size not changed by scaling +\begin{tikzpicture}[xscale=.5,yscale=1.1] %% +\tzhelplines(4,3) +\tzdot(0,0) \tzdot*(3,1) +\tzdot[red](0,1)(4mm) \tzdot*[green](3,2)(6pt) +\tzline(0,0)(3,1) +\tzline(0,1)(3,2) +\end{tikzpicture} +\end{tzcode} + + +\remark +The circle dots drawn by |\tzcdot| are affected by \Tikz\ |scale| factors. It gets bigger or smaller by |scale|. +Let us see what happens to circle dots, especially when |xscale| and |yscale| are not symmetric. + +\begin{tzcode}{.3} +% \tzcdot: distorted +\begin{tikzpicture}[xscale=.5,yscale=1.1] %% +\tzhelplines(4,3) +\tzcdot(0,0) \tzcdot*(3,1) +\tzcdot[red](0,1)(2mm) \tzcdot*[green](3,2)(3pt) +\tzline(0,0)(3,1) +\tzline(0,1)(3,2) +\end{tikzpicture} +\end{tzcode} + + + + +%%------------------------------------------------------------ +\section{Coordinates: Basics: \protect\cmd{\tzcoor(0,0)(A)}} +\label{si:coordinates} + +To define a coordinate, use \icmd{\tzcoor} with a coordinate followed by its name in parentheses. + +\begin{tztikz}{} +\tzcoor(0,0)(A) % works like: + \path (0,0) coordinate (A); + % or + \coordinate (A) at (0,0); +\end{tztikz} + +\begin{tzcode}{.3} +\begin{tikzpicture} +\tzhelplines(4,3) +\tzcoor(0,0)(A) \tzcoor(60:3cm)(B) +\tzline[->](A)(B) +\tzdot(A)(5pt) +\tzcoor(0,1)(C) \tzcoor(4,2)(D) +\tzline[dashed](C)(D) +\end{tikzpicture} +\end{tzcode} + +The starred version \icmd{\tzcoor*} prints a filled node dot at a specified coordinate. + +\begin{tzcode}{.3} +\begin{tikzpicture} +\tzhelplines(4,3) +\tzcoor(0,0)(A) \tzcoor(60:3cm)(B) +\tzline[->](A)(B) +\tzdot(A)(5pt) +\tzcoor*(0,1)(C) \tzcoor*[fill=none](4,2)(D) +\tzline[dashed](C)(D) +\end{tikzpicture} +\end{tzcode} + +%%------------------------------------------------------------ +\section{Curves: Basics} +\label{si:curves} + +\subsection{\protect\cmd{\tzto(0,0)(4,2)}} +\label{ssi:tzto} + +\icmd{\tzto} connects two points with a line or a curve. + +\begin{tzcode}{.3} +\begin{tikzpicture} +\tzhelplines(4,3) +\tzto(0,0)(4,2) +\tzto[bend right,dashed](0,1)(3,2) +\tzto[out=90,in=-90,->,blue](0,2)(4,1) +\end{tikzpicture} +\end{tzcode} + +\begin{tztikz}{} +\tzto[bend right](0,1)(3,2) % works like: + \draw [bend right] (0,1) to (3,2); +\end{tztikz} + +\subsection{\protect\cmd{\tzbezier}} +\label{ssi:tzbezier} + +\icmd{\tzbezier} draws a B\'{e}zier curve with one or two control points. +The style |tzshowcontrols|, which is predefined in the package, reveals the control point(s). + +\begin{tzcode}{.3} +\begin{tikzpicture} +\tzhelplines(4,3) +\tzbezier[blue,thick](0,0)(2,0)(4,2) +\tzbezier[->,tzshowcontrols](0,2)(1,3)(3,0)(4,1) +\end{tikzpicture} +\end{tzcode} + +\begin{tztikz}{} +\tzbezier[blue](0,0)(2,0)(4,2) % works like: + \draw [blue] (0,0) .. controls (2,0) .. (4,2); +\tzbezier(0,2)(1,3)(3,0)(4,1) % works like: + \draw (0,2) .. controls (1,3) and (3,0) .. (4,1); +\end{tztikz} + +\subsection{\protect\cmd{\tzparabola}} +\label{ssi:tzparabola} + +\icmd{\tzparabola} draws a parabola controlled by several options of \Tikz's |parabola| operation. + +\begin{tztikz}{} +\tzparabola(0,0)(2,4) % works like: + \draw (0,0) parabola (2,4); +\tzparabola(2,0)(3,3)(4,1) % works like: + \draw (2,0) parabola bend (3,3) (4,1); +\end{tztikz} + + +\begin{tzcode}{.3} +\begin{tikzpicture} +\tzhelplines(4,4) +\tzparabola(0,0)(2,4) +\tzparabola[bend at end,dashed](0,0)(2,4) +\tzparabola(2,0)(3,3)(4,1) +\tzparabola[bend pos=.33,dashed](1,0)(4,4) +\end{tikzpicture} +\end{tzcode} + + + + + +%%------------------------------------------------------------ +\section{Adding text: Nodes and placement} +\label{si:addingtext} + +\subsection{\protect\cmd{\tznode(3,1)\{text\}[right]}} +\label{ssi:tznode} + +With \icmd{\tznode}|(){}[]|, you can put some text at a specified position. +The starred version \icmd{\tznode*} draws the node perimeter, which is a |rectangle| by default. + +\begin{tzcode}{.3} +\begin{tikzpicture} +\tzhelplines(4,3) +\tznode(0,0){A} +\tznode*(1,1){text} +\tzdot*(2,2) +\tznode(2,2){Text}[above right,blue] +\end{tikzpicture} +\end{tzcode} + + +\begin{tztikz}{} +\tznode(0,0){A} % works like: + \node at (0,0) {A}; +\tznode(2,2){Text}[above right,blue] % works like: + \draw (2,2) node [above right,blue] {Text}; +\end{tztikz} + +\subsection{Review: Main nodes and label nodes in \Tikz} +\label{ssi:mainnodes} + +In \Tikz, there are two kinds of nodes: main nodes and label nodes. + +When a \iisw{main node} with text in it is placed at a specific point, its \iisw{label node} with a label in it is optionally placed in the \xem{direction} of a designated \xem{angle} relative to the main node. + +\begin{tzcode}{.3} +\begin{tikzpicture} +\tzhelplines(4,3) +\tznode*(2,1){main node} + [scale=2,label={[draw,red]90:label node}] +\tznode*(3,3){A}[label={above:a},label={0:r}] +\end{tikzpicture} +\end{tzcode} + +The angles for label nodes can be replaced by the corresponding placement words. For example, the angle |90| degree for a label node can be replaced by |above|, |0| by |right|, |-135| by |below left|, and the like. Note that the angle expression \xem{cannot} be used for placing a main node. + +\xmedskip1 +\remark +\begin{itemize} +\item +In this package, macros related to `dots' or `coordinates' (like |\tzcdot|, |tzdot|, and |\tzcoor|) can optionally have `label nodes,' while macros related to `lines' and `curves' (like |\tzline|, |\tzto|, |\tzbezier| and |\tzparabola|) optionally have `main nodes' or `text nodes.' +\item +There is one exception: |\tzshoworigin|. |\tzshoworigin| can have a label, but its location is controlled by positional words such as |below left| but not by ||. +(See Section \ref{s:tzshoworigin} on page \pageref{s:tzshoworigin} for more details.) +\end{itemize} + +\subsection{Abbreviations of \Tikz\ basic placement options: \texttt{a}, \texttt{b}, \texttt{l}, \texttt{r}, \texttt{ar}, \texttt{bl}, etc.} +\label{ssi:abbreviations} + +You can use \isw{abbreviations} |a| for |above|, |r| for |right|, |bl| for |below left|, and so on to place \iisw{main node}\xem{s}. + +\begin{tzcode}{.3} +\begin{tikzpicture}[font=\ttfamily,text=blue] +\tzhelplines[thick](2,2) +\tznode(1,1){centered}[draw] % default: centered +\tznode(1,2){a} [a] \tznode(1,0){b} [b] +\tznode(0,1){l} [l] \tznode(2,1){r} [r] +\tznode(0,2){al}[al] \tznode(2,2){ar}[ar] +\tznode(0,0){bl}[bl] \tznode(2,0){br}[br] +\end{tikzpicture} +\end{tzcode} + +\warning The abbreviations of \Tikz\ basic placement options \xem{cannot} be used to place \xem{labels}. +To place labels, use \xem{angles} or the unabridged placement options of \Tikz\ such as |above| and |below left|. + +%%------------------------------------------------------------ +\section{Labeling dots and coordinates} +\label{si:labelingdots} + +\subsection{\protect\cmd{\tzdot}, \protect\cmd{\tzcdot}} +\label{ssi:labeling:tzdot} + +To add a label to a dot generated by |\tzdot| or |\tzcdot|, you should specify, \xem{right after a coordinate}, |{