summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-drivers.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-drivers.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-drivers.tex43
1 files changed, 30 insertions, 13 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-drivers.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-drivers.tex
index 31bfd9a30ae..9ab6af46f1c 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-drivers.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-drivers.tex
@@ -1,4 +1,4 @@
-% Copyright 2006 by Till Tantau
+% Copyright 2019 by Till Tantau
%
% This file may be distributed and/or modified
%
@@ -44,7 +44,7 @@ files in the directory |generic/pgf|. For example, here is the content of the
file |latex/pgf/frontends/tikz.sty|:
%
\begin{codeexample}[code only]
-% Copyright 2006 by Till Tantau
+% Copyright 2019 by Till Tantau
%
% This file may be distributed and/or modified
%
@@ -219,9 +219,11 @@ program: it uses a different input format, but the output is exactly the same.
\item In \LaTeX\ mode it uses |graphicx| for the graphics inclusion
and does not support masking.
\item In plain \TeX\ mode it does not support image inclusion.
- \item Shading is fully implemented, but yields the same quality as
- the implementation for |dvips|.
- \item Opacity is not supported.
+ \item Shadings are approximated with discrete colors. This typically
+ leads to aliasing patterns in PostScript and \textsc{pdf} viewing
+ applications.
+ \item Opacity, Transparency Groups, Fadings and Blend Modes are not
+ supported.
\item Remembering of pictures (inter-picture connections) is not
supported.
\end{enumerate}
@@ -229,7 +231,7 @@ program: it uses a different input format, but the output is exactly the same.
It is also possible to produce a |.pdf|-file by first producing a PostScript
file (see below) and then using a PostScript-to-\pdf\ conversion program like
-|ps2pdf| or the Acrobat Distiller.
+|ps2pdf| or Acrobat Distiller.
\subsubsection{Producing PostScript Output}
@@ -242,13 +244,27 @@ file (see below) and then using a PostScript-to-\pdf\ conversion program like
following restrictions:
%
\begin{enumerate}
- \item In \LaTeX\ mode it uses |graphicx| for the graphics inclusion
- and does not support masking.
+ \item In \LaTeX\ mode it uses |graphicx| for the graphics inclusion.
+ Image masking is supported if the PostScript output is further
+ processed with |ps2pdf| to produce \textsc{pdf}.
\item In plain \TeX\ mode it does not support image inclusion.
- \item Shading is fully implemented, but the results will not be as
- good as with a driver producing |.pdf| as output.
- \item Opacity works only in conjunction with newer versions of
- Ghostscript.
+ \item Functional shadings are approximated with Type-0 functions
+ (sampled functions), because Type-4 functions are not available in
+ the latest (version 3) PostScript language definition. Due to
+ their fixed resolution, Type-0 functional shadings are of lesser
+ quality at higher zoom levels as compared to functional shadings
+ from \textsc{pdf} producing drivers. Axial and radial shadings are
+ fully supported. The same output quality (smooth shadings) is
+ achieved as with drivers that produce \textsc{pdf} output.
+ \item Although fully supported, opacity and fadings are \textsc{pdf}
+ features that become visible only after further processing the
+ PostScript output with |ps2pdf|. Note that newer Ghostscript
+ versions are necessary for producing opacity in the \textsc{pdf}
+ output. Also, beginning with version 9.52 of Ghostscript, command
+ line option |-dALLOWPSTRANSPARENCY| must be added:
+\begin{codeexample}[code only]
+ps2pdf -dALLOWPSTRANSPARENCY example.ps
+\end{codeexample}
\item For remembering of pictures (inter-picture connections) you
need to use a recent version of |pdftex| running in DVI-mode.
\end{enumerate}
@@ -258,7 +274,8 @@ file (see below) and then using a PostScript-to-\pdf\ conversion program like
This is a driver file for use with the \textsc{textures} program. It
includes |pgfsys-common-postscript.def|.
- This driver has exactly the same restrictions as the driver for |dvips|.
+ This driver shares the restrictions of the |vtex| driver, but adds limited
+ opacity support (no transparency groups, fadings and blend modes, though).
\end{filedescription}
You can also use the |vtex| program together with |pgfsys-vtex.def| to produce