summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/pgf/frontendlayer/libraries/tikzlibraryexternal.code.tex
blob: 67d199476ea2e472ef2c82b6dc45f1d99d101d05 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
% Copyright 2008 by Christian Feuersaenger
%
% This file may be distributed and/or modified
%
% 1. under the LaTeX Project Public License and/or
% 2. under the GNU Public License.
%
% See the file doc/generic/pgf/licenses/LICENSE for more details.
%
% 
% This file provides a high-level automatic export feature for tikz pictures.
% It allows to export EACH SINGLE FIGURE into a separate PDF.
%
% The simplest way is to use 
%
% \tikzexternalize{myarticle}
%
% it simply converts every figure using the write18 method. If that is not possible,
% you need to reconfigure \tikzexternalize: it can generate a list of figure file names 
% and you need to generate these figures manually (or with a script).
%
% It replaces \tikzpicture/ \endtikzpicture and \tikz and invokes \beginpgfgraphicnamed ... \endpgfgraphicnamed
% commands if necessary.

% load this package in order to get \pdf@mdfivesum .
% \pdf@mdfivesum is available for pdftex and lualatex and computes the
% md5 sum. Note that pdftex has \pdfmdfivesum, but lualatex does not
% have it.
%
% ... also used for \pdf@shellescape.
\usepackage{pdftexcmds}
\pgfutil@IfFileExists{atveryend.sty}{%
	\usepackage{atveryend}%
}{%
	\message{! Package tikz Warning: \string\usepackage{atveryend} impossible. Automatic resolving of references within external files impossible.}%
}%

% source generic implementation:
\input tikzexternalshared.code.tex

\pgfutil@IfUndefined{pdf@mdfivesum}{}{%
	\let\tikzexternal@mdfivesum=\pdf@mdfivesum
}%

\def\tikzexternal@TEXDIALECT@begpicture{\begin{tikzpicture}}
\def\tikzexternal@TEXDIALECT@endpicture{\end{tikzpicture}}%

% this latex specific this assumes it starts at the beginning of an
% environment. The environment is named
% '\tikzexternal@laTeX@collect@until@end@tikzpicturetikzpicturestring'.
%
% Everything up to \end{<name>} will be collected and passed as
% argument to the macro '#1'.
%
% This does also work if <name> is NOT tikzpicture!
\def\tikzexternal@TEXDIALECT@collectpicture#1{%
	\begingroup
	\t@tikzexternal@tmpa={}%
	\tikzexternal@laTeX@collect@until@end@tikzpicture{#1}%
}

% Loop until we find '\end{tikzpicture}'.  We have to make sure that
% even strings like '#1' are allowed inside of the collected argument.
\long\def\tikzexternal@laTeX@collect@until@end@tikzpicture#1#2\end#3{%
	\def\tikzexternal@laTeX@collect@until@end@tikzpicture@{#3}%
	\ifx\tikzexternal@laTeX@collect@until@end@tikzpicture@\tikzexternal@laTeX@collect@until@end@tikzpicturetikzpicturestring
		\t@tikzexternal@tmpa=\expandafter{\the\t@tikzexternal@tmpa #2}%
		\edef\tikzexternal@TEXDIALECT@collectpicture@next{%
			\noexpand\endgroup
			\noexpand#1{\the\t@tikzexternal@tmpa}%
		}%
		\t@tikzexternal@tmpa={}% release memory.
	\else
		\t@tikzexternal@tmpa=\expandafter{\the\t@tikzexternal@tmpa #2\end{#3}}%
		\def\tikzexternal@TEXDIALECT@collectpicture@next{%
			\tikzexternal@laTeX@collect@until@end@tikzpicture{#1}}%
	\fi
	\tikzexternal@TEXDIALECT@collectpicture@next
}%
\def\tikzexternal@laTeX@collect@until@end@tikzpicturetikzpicturestring{tikzpicture}%

\def\tikzexternal@handle@landscape{%
	\ltx@ifpackageloaded{pdflscape}{%
		% Work around a bug in conjunction with pdflscape and
		% external: without this optimize-away-instruction, the
		% externalized image would be rotated - and it will be rotated
		% once more again when it is included.
		%
		% if we "optimize it away", the landscape stuff will be
		% omitted. I hope this is enough... might not be entirely
		% fool-proof; perhaps we need to set it to \relax. For now, it
		% will probably do the job
		\tikzset{
			external/.cd,
			optimize command away=\landscape,
			optimize command away=\endlandscape
		}%
	}{%
	}%
}%

\AtBeginDocument{%
	\pgfutil@ifundefined{tikzexternalrealjob}{%
		\global\let\tikzexternalrealjob=\jobname
	}{}%
	\tikzexternal@handle@landscape
}%