summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tikz-ext
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-10-31 19:42:12 +0000
committerKarl Berry <karl@freefriends.org>2022-10-31 19:42:12 +0000
commit17077c45e5abbed7d2e4990baab2739aa2f4dcd5 (patch)
treedc3cdc03e506ff7e20278f24ec2fd6ced58945a6 /Master/texmf-dist/doc/latex/tikz-ext
parent77742dcf233f4881b1cb58713324c2b54ad2e91f (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/tikz-ext')
-rw-r--r--Master/texmf-dist/doc/latex/tikz-ext/README.md1
-rw-r--r--Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-library-scalepicture.tex113
-rw-r--r--Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-body.tex9
-rw-r--r--Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual-en-main-preamble.tex1
-rw-r--r--Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.pdfbin574442 -> 424759 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tikz-ext/tikz-ext-manual.tex4
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
index 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
Binary files differ
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}
}{}