callouts (16mar17)

git-svn-id: svn://tug.org/texlive/trunk@43515 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 122 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/callouts/A319neo.jpg b/Master/texmf-dist/doc/latex/callouts/A319neo.jpg
new file mode 100644
index 00000000000..4e8b0efc82d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/callouts/A319neo.jpg
diff --git a/Master/texmf-dist/doc/latex/callouts/README.md b/Master/texmf-dist/doc/latex/callouts/README.md
new file mode 100644
index 00000000000..05d28006332
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/callouts/README.md
@@ -0,0 +1,18 @@
+# callouts: put notes inside a picture
+
+This LaTeX package enables to define the _annotation_ environment, in which callouts, notes, arrows, and the like can be placed to describe certain parts of the picture. _annotation_ opens a TikZ environment and certain often re-occurring commands are summarized as custom commands. A grid can be displayed to aid the placement of annotations. The so placed annotations remain in the same position if the picture scale is changed, while the font size is kept constant. A global color scheme for the annotations can also be defined via an option.
+
+This directory contains the following files:
+
+README.md		- The present file
+callouts.sty		- The package file - requires TikZ.sty
+callouts.tex		- A user's guide to the package with an example
+callouts.pdf		- Compiled user's guide
+A319neo.jpg		- Picture to annotate, (c) Airbus S.A.S. 2014
+
+I'd be happy to receive feedback, suggestions, or complaints at <markus.stuetz@gmail.com>
+
+Best regards,
+_Markus Stuetz_
+
+Graz, Austria on March 17, 2017
diff --git a/Master/texmf-dist/doc/latex/callouts/callouts.pdf b/Master/texmf-dist/doc/latex/callouts/callouts.pdf
new file mode 100644
index 00000000000..216728af8e0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/callouts/callouts.pdf
diff --git a/Master/texmf-dist/doc/latex/callouts/callouts.tex b/Master/texmf-dist/doc/latex/callouts/callouts.tex
new file mode 100644
index 00000000000..2b43fc637ad
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/callouts/callouts.tex
@@ -0,0 +1,104 @@
+\documentclass[a4paper,11pt]{article}
+\usepackage[american]{babel}
+\usepackage[utf8]{inputenc}
+\usepackage{geometry}
+
+\usepackage{booktabs}  
+\usepackage{graphicx} 
+\usepackage{listings}
+\lstset{%
+backgroundcolor=\color{cyan!10},
+basicstyle=\ttfamily,
+numbers=left,numberstyle=\scriptsize
+}
+
+\usepackage[wby]{callouts}
+
+\title{The \LaTeX-package \texttt{callouts}}
+\author{Markus Stuetz}
+
+\begin{document}
+
+\maketitle
+
+\section{Introduction}
+In some reports or documents it may be necessary to annotate, draw arrows or put notes inside a picture. This may be done by editing the picture itself in a graphics tool or using the package TikZ. The former has the disadvantage of a different font and probably font size, the latter may require a lot of source code when using the same commands repeatedly. The package \texttt{callouts} provides a simple approach to annotate pictures.
+
+\section{Using the package}
+
+The package is included in the preamble as follows, with currently four color options, listed in table \ref{tab:colors}. If no or a wrong option is specified, the package will use \texttt{plain}.
+
+\begin{lstlisting}
+ \includepackage{callouts}[option] 
+\end{lstlisting}
+
+\begin{table}[htb]
+ \centering
+ \caption{Color options}\label{tab:colors}
+ \begin{tabular}{cccc}
+ \toprule
+  option & text & background & arrow \\
+  \midrule
+  \texttt{plain}& black & black & none \\
+  \texttt{bwr}	& black & white & red \\
+  \texttt{wby}	& white & black & yellow \\
+  \texttt{bww}	& black & white & white\\
+  \bottomrule
+ \end{tabular}
+\end{table}
+
+The environment itself is called \texttt{annotate} and may be put inside a \texttt{figure}-float. The environment requires two variables: The image path including a width option and the annotation scale. Make sure to put the same number in the \texttt{width}-option and the coordinate scale. If you decide to change the scale later on, change both numbers equally, then the relative position of the annotations will remain.
+\begin{lstlisting}
+ \begin{annotate}
+ {\includegraphics[0.5\textwidth]{<picture file name>} {0.5}
+ \end{annotate}
+\end{lstlisting}
+
+\section{Commands for annotations}
+There are currently four commands included which may follow the first two variables of the package.
+
+\subsection{Helpgrid}
+First of all, you may want to use a help grid to place your annotations. With \texttt{\textbackslash helpgrid}, a grid is drawn. The grid's coodinate origin is indicated by the large dot in the center. The grid lines display integers, coordinates are given in positive and negative decimal numbers.
+
+\subsection{Callouts, notes, arrows }
+A callout is a note, indicating to a point with an arrow. The syntax for this object is
+\begin{lstlisting}
+ \callout{xn,yn}{<note>}{xa,ya}
+\end{lstlisting}
+Here, \texttt{xn}, \texttt{yn} are the center coordinates for the note and \texttt{xa}, \texttt{ya} the coordinates for the arrow tip.
+
+You may put a note withouth an arrow, or an arrow alone, respectively, by writing
+\begin{lstlisting}
+ \note{xn,yn}{<note>}
+ \arrow{xs,ys}{xa,ya}
+\end{lstlisting}
+
+\newpage
+\subsection{An example}
+The following source code results in figure \ref{fig:Airbus}. The color option used here is \texttt{wby}. Note that the \texttt{annotate}-environment opens a \texttt{tikzpicture} environment. Hence, all TikZ-commands such as \texttt{\textbackslash draw} can be used as well, as for example in line 8.
+\begin{lstlisting}
+ \begin{annotate}{\includegraphics[width=0.7\textwidth]...
+ ...{A319neo.jpg}}{0.7}
+   % \helpgrid
+   \callout{5,-3}{Engine}{1.6,-2}
+   \arrow{-3,-2.4}{-4.5,-3}
+   \arrow{-4.7,-3.2}{-5.5,-2.4}
+   \note{1,5}{Wingtip}
+   \draw [thick,\arcol] (2.5,3.8) rectangle (4,5);
+ \end{annotate}
+\end{lstlisting}
+
+\begin{figure}[htb]
+  \centering
+  \begin{annotate}{\includegraphics[width=0.7\textwidth]{A319neo.jpg}}{0.7}
+    % \helpgrid
+    \callout{5,-3}{Engine}{1.6,-2}
+    \arrow{-3,-2.4}{-4.5,-3}
+    \arrow{-4.7,-3.2}{-5.5,-2.4}
+    \note{1,5}{Wingtip}
+    \draw [thick,\arcol] (2.5,3.8) rectangle (4,5);
+  \end{annotate}
+  \caption{Airbus A319neo\protect\footnotemark}\label{fig:Airbus}
+\end{figure}
+ \footnotetext{Image courtesy: AIRBUS S.A.S. 2014, \texttt{www.airbus.com}, accessed 3.3.2017}
+\end{document}