summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-transparency.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-transparency.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-transparency.tex26
1 files changed, 17 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-transparency.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-transparency.tex
index 0483ee57ad3..1e2a20aba7c 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-transparency.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-tikz-transparency.tex
@@ -1,4 +1,4 @@
-% Copyright 2006 by Till Tantau
+% Copyright 2019 by Till Tantau
%
% This file may be distributed and/or modified
%
@@ -17,7 +17,7 @@ Normally, when you paint something using any of \tikzname's commands (this
includes stroking, filling, shading, patterns, and images), the newly painted
objects totally obscure whatever was painted earlier in the same area.
-You can change this behaviour by using something that can be thought of as
+You can change this behavior by using something that can be thought of as
``(semi)transparent colors''. Such colors do not completely obscure the
background, rather they blend the background with the new color. At first
sight, using such semitransparent colors might seem quite straightforward, but
@@ -34,10 +34,17 @@ At the end of the section we address the problem of creating so-called
several times with a semitransparent color. Sometimes you want the effect to
accumulate, sometimes you do not.
-\emph{Note:} Transparency is best supported by the pdf\TeX\ driver. The
-\textsc{svg} driver also has some support. For PostScript output, opacity is
-rendered correctly only with the most recent versions of Ghostscript. Printers
-and other programs will typically ignore the opacity setting.
+\emph{Note:} Transparency (or Opacity, as it may be called as well) is best
+supported by the pdf\TeX\ driver. The \textsc{svg} driver also has some
+support. The PostScript file format does not know about transparency. In
+|dvips|-generated PostScript files, transparency of graphic objects is defined
+through special commands that need further processing to become visible in the
+\textsc{pdf} output. For this, a recent version of Ghostscript, preferably 9.52
+or newer, is required and its command line utility |ps2pdf| must be called with
+option |-dALLOWPSTRANSPARENCY|. Older versions may need option |-dNOSAFER|
+instead, but some advanced features, such as \emph{transparency groups} and
+\emph{fadings}, may not work at all. Printers and other programs will typically
+ignore opacity settings in PostScript files.
\subsection{Specifying a Uniform Opacity}
@@ -426,7 +433,7 @@ commands, which are \emph{only defined in the library}, namely the library
%
{\ifpgfmanualexternalize\tikzexternaldisable\fi
\begin{codeexample}[preamble={\usetikzlibrary{fadings,patterns}}]
-\begin{tikzfadingfrompicture}[name=fade right]
+\begin{tikzfadingfrompicture}[name=fade right with circle]
\shade[left color=transparent!0,
right color=transparent!100] (0,0) rectangle (2,2);
\fill[transparent!50] (1,1) circle (0.7);
@@ -439,7 +446,7 @@ commands, which are \emph{only defined in the library}, namely the library
\pattern [pattern=checkerboard,pattern color=black!30]
(-1.2,-1.2) rectangle (1.2,1.2);
- \fill [path fading=fade right,red] (-1,-1) rectangle (1,1);
+ \fill [path fading=fade right with circle,red] (-1,-1) rectangle (1,1);
\end{tikzpicture}
\end{codeexample}
%
@@ -449,7 +456,8 @@ commands, which are \emph{only defined in the library}, namely the library
\begin{codeexample}[preamble={\usetikzlibrary{fadings,patterns}}]
\begin{tikzfadingfrompicture}[name=tikz]
\node [text=transparent!20]
- {\fontencoding{T1}\fontfamily{ptm}\fontsize{45}{45}\bfseries\selectfont Ti\emph{k}Z};
+ {\fontencoding{T1}\fontfamily{ptm}\fontsize{45}{45}\bfseries\selectfont
+ Ti\emph{k}Z};
\end{tikzfadingfrompicture}
% Now we use the fading in another picture: