diff options
author | Karl Berry <karl@freefriends.org> | 2022-10-31 19:42:12 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-10-31 19:42:12 +0000 |
commit | 17077c45e5abbed7d2e4990baab2739aa2f4dcd5 (patch) | |
tree | dc3cdc03e506ff7e20278f24ec2fd6ced58945a6 /Master/texmf-dist/doc/latex | |
parent | 77742dcf233f4881b1cb58713324c2b54ad2e91f (diff) |
tikz-ext (31oct22)
git-svn-id: svn://tug.org/texlive/trunk@64877 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/tikz-ext/README.md | 1 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-library-scalepicture.tex | 113 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-body.tex | 9 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-preamble.tex | 1 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.pdf | bin | 574442 -> 424759 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.tex | 4 |
6 files changed, 124 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/latex/tikz-ext/README.md b/Master/texmf-dist/doc/latex/tikz-ext/README.md index 76ea094357b..33ec46d366e 100644 --- a/Master/texmf-dist/doc/latex/tikz-ext/README.md +++ b/Master/texmf-dist/doc/latex/tikz-ext/README.md @@ -31,7 +31,6 @@ These are * `ext.shapes.heatmark` * `ext.shapes.rectangleroundedcorners` * `ext.shapes.superellipse` - * `ext.shapes.uncenteredrectangle` These were developed in response to questions on tex.stackexchange.com. Some of these can be find by searching for my [user id](https://tex.stackexchange.com/search?q=user%3A16595+%22my+library%22).
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-library-scalepicture.tex b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-library-scalepicture.tex new file mode 100644 index 00000000000..b14c4c4f0fb --- /dev/null +++ b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-library-scalepicture.tex @@ -0,0 +1,113 @@ +% !TeX spellcheck = en_US +% !TeX root = tikz-ext-manual.tex +% Copyright 2022 by Qrrbrbirlbel +% +% This file may be distributed and/or modified +% +% 1. under the LaTeX Project Public License and/or +% 2. under the GNU Free Documentation License. +% +\clearpage +\section{Scaling Pictures to a Specific Size} +\label{library:scalepicture} + +\begin{tikzlibrary}{ext.scalepicture} + This library scales \tikzname\ pictures to a specific width or height + by scaling the whole picture. +\end{tikzlibrary} + +\begin{multicols}{2} +If one of the keys below are used on a \tikzname\ picture, i.\,e. +as an option to |\tikzpicture| or \texttt{\textbackslash begin\{tikzpicture\}} +the size of the picture\footnote{This is the size of the pseudo-node \texttt{current bounding box}.} +will be measured and written to the \filetype{aux} file +so that it will be available at the next compilation run +and an appropriate scaling for the picture can be installed. + +\begin{command}{\tikzextpicturewidth} + Returns the last measured width of the picture. + + This will expand to |0pt| if the picture hasn't been measured before. +\end{command} +\begin{command}{\tikzextpictureheight} + Returns the last measured height of the picture. + + This will expand to |0pt| if the picture hasn't been measured before. +\end{command} + +\begin{stylekey}{/tikz/save picture size} + This key is usually used by the keys provided by this library. + Normally, this is not needed to be explicitly given. +\end{stylekey} +\subsection{Keeping the aspect ratio} +The following \emph{unstarred} keys do not change the aspect ratio of the picture. + +\begin{key}{/tikz/picture width=\meta{dimension}} + Scales the picture so that the width of the picture will be \meta{dimension}. + This will keep the aspect ratio the same. +\end{key} + +\begin{key}{/tikz/minimum picture width=\meta{dimension}} + As above but will not change the size of the picture + if its width is greater than \meta{dimension}. +\end{key} + +\begin{key}{/tikz/maximum picture width=\meta{dimension}} + As above but will not change the size of the picture + if its width is less than \meta{dimension}. +\end{key} + +\begin{key}{/tikz/picture height=\meta{dimension}} + Scales the picture so that the height of the picture will be \meta{dimension}. + This will keep the aspect ratio the same. +\end{key} + +\begin{key}{/tikz/minimum picture height=\meta{dimension}} + As above but will not change the size of the picture + if its height is greater than \meta{dimension}. +\end{key} + +\begin{key}{/tikz/maximum picture height=\meta{dimension}} + As above but will not change the size of the picture + if its height is less than \meta{dimension}. +\end{key} + +\begin{key}{/tikz/minimum picture size=\marg{width}\marg{height}} + Scales the picture so that its height will be at least \meta{width} + and its height will be at least \meta{height}. +\end{key} + +\begin{key}{/tikz/maximum picture size=\marg{width}\marg{height}} + Scales the picture so that its height will be at most \meta{width} + and its height will be at most \meta{height}. +\end{key} + +\subsection{Changing the aspect ratio.} +The following \emph{starred} keys do change the aspect ratio. +\begin{key}{/tikz/picture width*=\meta{dimension}} + Scales the picture so that the width of the picture will be \meta{dimension}. + This will only scale the $x$ axis. +\end{key} + +\begin{key}{/tikz/minimum picture width*=\meta{dimension}} + As above but will not change the size of the picture + if its width is greater than \meta{dimension}. +\end{key} + +\begin{key}{/tikz/maximum picture width*=\meta{dimension}} + As above but will not change the size of the picture + if its width is less than \meta{dimension}. +\end{key} + +\begin{key}{/tikz/picture height*=\meta{dimension}} + Scales the picture so that the height of the picture will be \meta{dimension}. + This will only scale the $y$ axis. +\end{key} + +\begin{key}{/tikz/picture size*=\marg{width}\marg{height}} + Scales the picture so that its width will be \meta{width} + and its height will be \meta{height}. + + This will scale both axes but independent from each other. +\end{key} +\end{multicols}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-body.tex b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-body.tex index 41e56c390ec..bf6620a2be8 100644 --- a/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-body.tex +++ b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-body.tex @@ -8,7 +8,7 @@ % 2. under the GNU Free Documentation License. % \newcommand*\tikzextname{Ti\textit kZ-Extensions} -\newcommand*\tikzextversion{0.4.1} +\newcommand*\tikzextversion{0.4.2} \begin{document} {\colorlet{blue}{black}% links shall be black \title{\bfseries The \tikzextname\space Package\\ @@ -71,6 +71,8 @@ These libraries only work with \tikzname. \tikzsetfigurename{patterns.images} \include{tikz-ext-manual-en-library-patterns.images} \tikzsetfigurename{positioning-plus} \include{tikz-ext-manual-en-library-positioning-plus} +\tikzsetfigurename{scalepicture} +\include{tikz-ext-manual-en-library-scalepicture} \tikzsetfigurename{topaths.arcthrough} \include{tikz-ext-manual-en-library-topaths.arcthrough} \tikzsetfigurename{trans} @@ -170,6 +172,11 @@ These libraries (should) work with both \pgfname\space and \tikzname. \section*{Changelog}\addcontentsline{toc}{section}{Changelog} \begin{multicols}{2}\raggedright \noindent +Version 0.4.2 +\begin{itemize} +\item \addTikz{scalepicture} +\item Bugfixes to |shapes.uncenteredrectangle|, |paths.ortho|, |positioning-plus| and |pgfcalender-ext|. +\end{itemize} Version 0.4.1 \begin{itemize} \item Cleaned up directory structure of documentary. diff --git a/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-preamble.tex b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-preamble.tex index 2ba6defa100..682b83b4352 100644 --- a/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-preamble.tex +++ b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-preamble.tex @@ -115,6 +115,7 @@ ext.paths.timer, ext.patterns.images, ext.positioning-plus, + ext.scalepicture, ext.shapes.heatmark, ext.shapes.circlearrow, ext.shapes.circlecrosssplit, diff --git a/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.pdf b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.pdf Binary files differindex 51ba04c7d10..855ee19374d 100644 --- a/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.pdf +++ b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.pdf diff --git a/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.tex b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.tex index 253944ca7db..30705854870 100644 --- a/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.tex +++ b/Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.tex @@ -19,8 +19,8 @@ %mode=list and make, %mode=list only,export=true,% simply skips EVERY picture -> good for debugging the text. ] - \tikzexternalenable -% \tikzexternaldisable +% \tikzexternalenable + \tikzexternaldisable \tikzifexternalizing{ \pgfkeys{/pdflinks/codeexample links=false} }{} |