summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/hobby
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-08-16 21:45:29 +0000
committerKarl Berry <karl@freefriends.org>2014-08-16 21:45:29 +0000
commit555761b02e9d39a42e9a72dc9f90955c65036740 (patch)
treee4d97a65928f81d51ee21b70dcb104095c0ba85d /Master/texmf-dist/doc/latex/hobby
parent9caacf53d7d2a1620a603aa644617293a60183e2 (diff)
hobby (16aug14)
git-svn-id: svn://tug.org/texlive/trunk@34953 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/hobby')
-rw-r--r--Master/texmf-dist/doc/latex/hobby/README2
-rw-r--r--Master/texmf-dist/doc/latex/hobby/hobby.pdfbin366952 -> 368666 bytes
-rw-r--r--Master/texmf-dist/doc/latex/hobby/hobby_doc.pdfbin488046 -> 522544 bytes
-rw-r--r--Master/texmf-dist/doc/latex/hobby/hobby_doc.tex49
4 files changed, 49 insertions, 2 deletions
diff --git a/Master/texmf-dist/doc/latex/hobby/README b/Master/texmf-dist/doc/latex/hobby/README
index d48c4b90e17..04af0731d63 100644
--- a/Master/texmf-dist/doc/latex/hobby/README
+++ b/Master/texmf-dist/doc/latex/hobby/README
@@ -1,7 +1,7 @@
----------------------------------------------------------------
hobby --- a TikZ/PGF library for drawing smooth(ish) curves using
Hobby's algorithm (implemented in LaTeX3)
-E-mail: stacey@math.ntnu.no
+E-mail: loopspace@mathforge.org
Released under the LaTeX Project Public License v1.3c or later
See http://www.latex-project.org/lppl.txt
----------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/hobby/hobby.pdf b/Master/texmf-dist/doc/latex/hobby/hobby.pdf
index 4f581c840cf..07ada0caba0 100644
--- a/Master/texmf-dist/doc/latex/hobby/hobby.pdf
+++ b/Master/texmf-dist/doc/latex/hobby/hobby.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/hobby/hobby_doc.pdf b/Master/texmf-dist/doc/latex/hobby/hobby_doc.pdf
index c3b008ed70e..b63f4142a6b 100644
--- a/Master/texmf-dist/doc/latex/hobby/hobby_doc.pdf
+++ b/Master/texmf-dist/doc/latex/hobby/hobby_doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/hobby/hobby_doc.tex b/Master/texmf-dist/doc/latex/hobby/hobby_doc.tex
index a00a4d525a0..ed83ded58ce 100644
--- a/Master/texmf-dist/doc/latex/hobby/hobby_doc.tex
+++ b/Master/texmf-dist/doc/latex/hobby/hobby_doc.tex
@@ -9,6 +9,7 @@
\usepackage{fancyvrb}
\usetikzlibrary{hobby,decorations.pathreplacing}
\usepackage{listings}
+\usepackage{hyperref}
\pgfplotsset{compat=1.9}
\lstloadlanguages{[LaTeX]TeX}
\lstset{breakatwhitespace=true,breaklines=true,language=TeX}
@@ -146,7 +147,14 @@ It can be loaded with
\begin{verbatim}
\usetikzlibrary{hobby}
\end{verbatim}
-%%
+
+\textbf{Warning}: This package makes extensive use of \LaTeX3.
+On occasion, updates to \LaTeX3 packages have resulted in this package behaving oddly or not working at all.
+The most up to date version of this package can be obtained from the \href{http://bazaar.launchpad.net/~tex-sx/tex-sx/development/files}{TeX-SX Launchpad page} (download \Verb+hobby.dtx+ and run \Verb+tex hobby.dtx+ to generate the files).
+Often, such issues are reported on the \href{http://tex.stackexchange.com}{TeX-SX} site and workarounds quickly found so it is worth checking there as well.
+
+\bigskip
+
There are a variety of ways of specifying the data to the algorithm to generate the curve.
\subsection{As a \textsf{to path}.}
@@ -224,6 +232,38 @@ However, the Hobby algorithm is designed to draw a curve in 2D-{}space and does
\end{tikzpicture}
\end{example}
+\subsection{Basic Level PGF Commands}
+
+(Suggested by the question \href{http://tex.stackexchange.com/q/159896/86}{How to combine Hobby paths with PGF Basic Layer commands?} on TeX-SX.)
+
+In some circumstances, it is convenient to bypass TikZ and use more basic PGF commands for building a path.
+It is possible to add a path built using Hobby's algorithm in this fashion.
+The commands are:
+
+\begin{itemize}
+\item \Verb+\pgfpathhobby+ to initialise the path.
+If this is followed by a braced group then the contents of that are taken as options to the algorithm.
+
+\item \Verb+\pgfpathhobbypt{<pgf point specification>}+ to add a point to the path.
+If this is followed by a braced group then the contents of that are taken as options for that point.
+
+\item \Verb+\pgfpathhobbyend+ finalises the path.
+This applies the algorithm to the set of specified points and adds it to the current path.
+\end{itemize}
+
+\begin{example}
+\begin{tikzpicture}
+\pgfpathmoveto{\pgfpoint{0}{0}}
+\pgfpathlineto{\pgfpoint{1cm}{0}}
+\pgfpathhobby{closed=true}
+\pgfpathhobbypt{\pgfpoint{1cm}{2cm}}{tension in=2}
+\pgfpathhobbypt{\pgfpoint{2cm}{1cm}}
+\pgfpathhobbypt{\pgfpoint{3cm}{0cm}}
+\pgfpathhobbyend
+\pgfusepath{stroke}
+\end{tikzpicture}
+\end{example}
+
\section{Customisation}
There are various ways to customise the path generated by the Hobby algorithms.
@@ -865,6 +905,13 @@ The actual curves are then produced from the angles using the same formulae for
At the last stage, we render both segments of the generated curve.
+\section{Acknowledgements}
+
+This package began life as an answer to the question \href{http://tex.stackexchange.com/q/54771/86}{Curve through a sequence of points with Metapost and TikZ}.
+Once released upon the unsuspecting world, various questions on the \href{http://tex.stackexchange.com}{TeX-SX} site have prompted new features (and bug-fixes).
+Most of these can be found by looking at the \href{http://tex.stackexchange.com/questions/tagged/hobby}{list of questions tagged ``hobby''} on that site.
+
+
\begin{thebibliography}{1} \bibitem{MR834054} John~D. Hobby. \newblock Smooth, easy to compute interpolating splines. \newblock {\em Discrete Comput. Geom.}, 1:123--140, 1986. \end{thebibliography}
\end{document}