summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-paths.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-paths.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-paths.tex30
1 files changed, 30 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-paths.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-paths.tex
index 340a5cef081..ac0d0080b64 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-paths.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-paths.tex
@@ -1387,3 +1387,33 @@ experts and should only be used deep inside clever macros, not on normal paths.
\end{codeexample}
%
\end{command}
+
+
+\subsection{Interacting with the Soft Path subsystem}
+
+During construction \tikzname\ stores the path internally as a \emph{soft
+path}. Sometimes it is desirable to save a path during the stage of
+construction, restore it elsewhere and continue using it. There are two keys
+to facilitate this operation, which are explained below. To learn more about
+the soft path subsystem, refer to section~\ref{section-soft-paths}.
+
+\begin{key}{/tikz/save path=\meta{macro}}
+ Save the current soft path into \meta{macro}.
+\end{key}
+
+\begin{key}{/tikz/use path=\meta{macro}}
+ Set the current path to the soft path stored in \meta{macro}.
+\end{key}
+
+\begin{codeexample}[]
+\begin{tikzpicture}
+ \path[save path=\pathA,name path=A] (0,1) to [bend left] (1,0);
+ \path[save path=\pathB,name path=B]
+ (0,0) .. controls (.33,.1) and (.66,.9) .. (1,1);
+
+ \fill[name intersections={of=A and B}] (intersection-1) circle (1pt);
+
+ \draw[blue][use path=\pathA];
+ \draw[red] [use path=\pathB];
+\end{tikzpicture}
+\end{codeexample}