summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-11-28 23:47:56 +0000
committerKarl Berry <karl@freefriends.org>2016-11-28 23:47:56 +0000
commit3bb968911fe7c1366654b04283a2b0c90968f212 (patch)
tree07a7bcdabc295e16cdf5c0782c4cf7187f134e0c /Master/texmf-dist/doc
parent17096b7bd77fd18fc0e73e628b1ce5ab1dddca60 (diff)
tikzpeople (28nov16)
git-svn-id: svn://tug.org/texlive/trunk@42598 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/tikzpeople/README.md29
-rw-r--r--Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.pdfbin465590 -> 499029 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.tex76
3 files changed, 75 insertions, 30 deletions
diff --git a/Master/texmf-dist/doc/latex/tikzpeople/README.md b/Master/texmf-dist/doc/latex/tikzpeople/README.md
index aff8e5cd50e..ec927b9ca6d 100644
--- a/Master/texmf-dist/doc/latex/tikzpeople/README.md
+++ b/Master/texmf-dist/doc/latex/tikzpeople/README.md
@@ -1,24 +1,27 @@
The tikzpeople package provides people shaped nodes to be used in tikz.
The available node shapes are:
- alice, bob, bride, builder, businessman, charlie, chef, conductor, cowboy,
- criminal, dave, graduate, groom, guard, jester, judge, mexican, nun, nurse,
- physician, pilot, police, priest, sailor, santa, surgeon
+alice, bob, bride, builder, businessman, charlie, chef, conductor, cowboy,
+criminal, dave, devil, duck, graduate, groom, guard, jester, judge, maninblack,
+mexican, nun, nurse, physician, pilot, police, priest, sailor, santa, surgeon
-The package has three options:
- - The "draft" option causes all tikzpeople to be rendered as a basic outline
+The package has four options:
+- The "draft" option causes all tikzpeople to be rendered as a basic outline
of a person.
- - The "demo" option adds two commands.
- The command \alltikzpeople{<width>}{<options>} produces a series of figures
- of all available shapes with the given width and the provided options
- applied. The command \tikzpeoplecolors{<shapename>} produces a figure
- showing the available color keys for the shape.
- - The "nonbeards" option removes all beards.
+- The "demo" option adds two commands.
+ The command \alltikzpeople{<width>}{<options>} produces a series of figures
+ of all available shapes with the given width and the provided options
+ applied. The command \tikzpeoplecolors{<shapename>} produces a figure
+ showing the available color keys for the shape.
+- The "nonbeards" option removes all beards.
+- The "saturated" option causes the tikzpeople to be drawn with saturated colors.
The nodes have the following hopefully self explanatory options:
- evil, good, female, mirrored, monitor
+
+evil, good, female, mirrored, monitor, saturated, shield, sword
+
All options can be combined freely.
The tikzpeople package is licensed under the LaTeX Project Public License
- -- Nils Fleischhacker <mail@nilsfleischhacker.de> 08 Nov 2016
+ -- Nils Fleischhacker <mail@nilsfleischhacker.de> 28 Nov 2016
diff --git a/Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.pdf b/Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.pdf
index 5f3ca3d216b..6f75824716f 100644
--- a/Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.pdf
+++ b/Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.tex b/Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.tex
index 9f9ab712bff..8746c33588c 100644
--- a/Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.tex
+++ b/Master/texmf-dist/doc/latex/tikzpeople/tikzpeople.tex
@@ -82,7 +82,7 @@
lefthand width=#2,tikz lower,fillbackground,
#1}
-\title{The \textsf{tikzpeople} package}
+\title{\tikz{\node[graduate,shield,sword,minimum height=2cm]{}}\\The \textsf{tikzpeople} package}
\author{Nils Fleischhacker}
\date{}
@@ -98,7 +98,7 @@
\end{abstract}
\section{Introduction}
- Let me start with a word of warning:
+ Let me start with a word of warning:
The node-shapes defined by this package are heavily influenced by a type of clip art included in the \textsf{Microsoft Visio} software.
I am by no means an expert on copyright law and as such can make no claim under which circumstances using these shapes might infringe on Microsoft's copyright.
I do not expect that there are any problems, but be aware of this.
@@ -175,6 +175,12 @@
In particular, \textsf{tikzpeople} marked as evil no longer have goatees.
This option exists because I have been informed that having evil \textsf{tikzpeople} with goatees is very insensitive and discriminatory against people with goatees.
For a little bit of petty defiance, this option also removes Santa's beard.
+
+ \DescribeOption{saturated}
+ The \textsf{saturated} option causes all nodes to be rendered with saturated colors.
+ Standard nodes are rendered with somewhat washed out colors.
+ This works well on light backgrounds but can look weird on dark background.
+ The |saturated| option can also be used on individual nodes.
\subsection{Available Shapes}
Once the package is loaded, any of the defined shapes can be used as the shape of any \tikzname node just like any other predefined shape.
@@ -226,7 +232,8 @@
\node[priest,evil,minimum size=1cm] {};
\end{codeexample}
This is especially useful to depict attackers in a cryptographic or security setting.
- Unaffected by this option are: \texttt{guard,santa}.
+ Unaffected by this option are: \texttt{guard,santa,devil}.
+ The color of the horns is controlled with the |horns| key.
\DescribeOption{female} The |female| option is supposed to make stereotypically male nodes look just a tad more feminine.
For most tikzpeople this is accomplished by adding longer hair and losing the beard -- though surprisingly, evil women still tend to have a goatee.
@@ -246,6 +253,7 @@
\end{codeexample}
This could be useful to, e.g., depict a trusted party in a security context.
Unaffected by this option are: \texttt{guard, mexican, santa}.
+ The color of the halo is controlled with the |halo| key.
\DescribeOption{mirrored} The \textsf{mirrored} option makes nodes face to the left instead of the right.
\begin{codeexample}{3.2cm}
@@ -260,11 +268,36 @@
\node[judge,monitor,minimum size=1cm]{};
\end{codeexample}
This could be useful to emphasize that parties are actually using a computer and not doing complex computations in their head.
+
+ \DescribeOption{saturated} The \textsf{saturated} option causes the node to be rendered with saturated colors.
+ \begin{codeexample}{3.2cm}
+\node[pilot,minimum size=1cm,xshift=-1.2cm]{};
+\node[pilot,saturated,minimum size=1cm]{};
+ \end{codeexample}
+ Standard nodes are rendered with somewhat washed out colors.
+ This works well on light backgrounds but can look weird on dark background.
+ The |saturated| option can also be used as a global package option.
+
+ \DescribeOption{shield} The \textsf{shield} option gives the node a shield.
+ \begin{codeexample}{4cm}
+\node[alice,minimum size=1cm,xshift=-1.2cm]{};
+\node[alice,shield,minimum size=1cm]{};
+ \end{codeexample}
+ This could be useful to symbolize that a party is defending something and combines well with the |sword| option.
+ The colors of the shield are controlled using the keys |shieldmid|, |shieldedge|, and |shieldrivets|.
+
+ \DescribeOption{sword} The \textsf{sword} option gives the node a sword.
+ \begin{codeexample}{4cm}
+\node[dave,minimum size=1cm,xshift=-1.2cm]{};
+\node[dave,sword,minimum size=1cm]{};
+ \end{codeexample}
+ This could be useful to symbolize that a party is attacking or defending something and combines well with the |shield| option.
+ The colors of the sword are controlled using the keys |swordblade|, |swordguard|, |swordpommel|, and |swordgrip|.
All of these options can be arbitrarily combined. So, e.g., |good| \textsf{tikzpeople} can very well be |evil| at the same time.
\begin{codeexample}{4cm}
\node[chef,evil,female,good,mirrored,monitor,
- minimum size=1.5cm]{};
+ saturated,shield,sword,minimum size=1.5cm]{};
\end{codeexample}
\subsection{Color Options}
Almost all the colors used in the \textsf{tikzpeople} shapes can be specified separately.
@@ -280,19 +313,24 @@
\DescribeMacro{\tikzpeoplecolors} If the package is loaded with the |demo| option, you can use the command |\tikzpeoplecolors|\marg{shapename} to produce a figure giving you an idea, which color keys can be used for which shape.
For your convenience, all of those figures are included in \autoref{app:colors}.
- \subsubsection{Known Problems}
- There is some weird behaviour if you try to mix colors when setting color options.
- Say we want a policeman with a light purple jacket\footnote{Wouldn't those guys seem much more approachable and friendly? Just think about it.} and we mix purple from 25\% blue and 50\% red by setting |shirt=red!50!blue!50|.
- Here we get some cryptic error messages, that seem to have to do with the fact that the colors are once again mixed for the style of the jacket to produce a nice shading.
- I'm unsure why it fails.
- If we set |shirt=red!50!blue!100| to get a deep purple, we do not get an error, but there is no shading.
- Whatever the cause, in both cases we get the expected result by adding an additional exclamation mark to the end, though I'm not sure why.
- \begin{codeexample}{3cm}
-\node[police,shirt=red!50!blue!50!, hat=red!50!blue!50!, minimum size=1.5cm]{};
- \end{codeexample}
- \begin{codeexample}{3cm}
-\node[police,shirt=red!50!blue!100!, hat=red!50!blue!100!, minimum size=1.5cm]{};
- \end{codeexample}
+
+ \subsection{Text Options}
+ Some \textsf{tikzpeople} have include customizable text, such as the |businessman|'s monogram.
+ These texts can be specified with pgfkeys just as with the color options.
+ \vspace{.75em}
+ \begin{codeexample}{3cm}
+\path [clip] (0cm,1cm) rectangle (1.5cm,-1cm);
+\node[businessman, monogramtext=ER ,minimum size=5cm]{};
+ \end{codeexample}
+
+ \vspace{1em}
+
+ All texts are scaled to fit the available space. Specifying significantly longer text will therefore cause it to be unreadable.
+
+ \DescribeOption{monogramtext} The |monogramtext| option is available for |businessman| shapes and changes the text of the monogram.
+ While you can change the monogram to any arbitrary text, you should be aware that the monogram is rendered as |\mathcal| and anything except for uppercase letters will probably lead to unexpected results.
+
+ \DescribeOption{badgetext} The |badgetext| option is available for |nurse| shapes and changes the text printed on the badge.
\subsection{Anchors}
\tikzset{shape example/.style={color=black!30, draw, fill=yellow!30, minimum size=3cm}}
@@ -352,6 +390,7 @@ Namely into ``Dimension to large'' errors in the |\pgfmath@function@veclen| comm
Apparently this happens because we are working with numbers that are too small.
As per this \TeX-stackexchange answer \url{http://tex.stackexchange.com/a/20888/15636}, \textsf{tikzpeople} redeclares |\pgfmath@function@veclen| with a fixed version.
+
\clearpage
\begin{appendices}
\section{Color Options}
@@ -367,11 +406,14 @@ As per this \TeX-stackexchange answer \url{http://tex.stackexchange.com/a/20888/
\vfill\tikzpeoplecolors{cowboy}
\vfill\tikzpeoplecolors{criminal}
\vfill\tikzpeoplecolors{dave}
+ \vfill\tikzpeoplecolors{devil}
+ \vfill\tikzpeoplecolors{duck}
\vfill\tikzpeoplecolors{graduate}
\vfill\tikzpeoplecolors{groom}
\vfill\tikzpeoplecolors{guard}
\vfill\tikzpeoplecolors{jester}
\vfill\tikzpeoplecolors{judge}
+ \vfill\tikzpeoplecolors{maninblack}
\vfill\tikzpeoplecolors{mexican}
\vfill\tikzpeoplecolors{nun}
\vfill\tikzpeoplecolors{nurse}