diff options
author | Norbert Preining <norbert@preining.info> | 2020-09-29 03:02:54 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2020-09-29 03:02:54 +0000 |
commit | d043a18e288914d3c46a1b10af1f30ce2df00588 (patch) | |
tree | 888d8c0677d7b328602f1ec5c09d324a325043ec /graphics/pgf/base/doc/text-en/pgfmanual-en-drivers.tex | |
parent | 34310603e5253ef5742542e3f0123b341a70ee20 (diff) |
CTAN sync 202009290302
Diffstat (limited to 'graphics/pgf/base/doc/text-en/pgfmanual-en-drivers.tex')
-rw-r--r-- | graphics/pgf/base/doc/text-en/pgfmanual-en-drivers.tex | 43 |
1 files changed, 30 insertions, 13 deletions
diff --git a/graphics/pgf/base/doc/text-en/pgfmanual-en-drivers.tex b/graphics/pgf/base/doc/text-en/pgfmanual-en-drivers.tex index 31bfd9a30a..9ab6af46f1 100644 --- a/graphics/pgf/base/doc/text-en/pgfmanual-en-drivers.tex +++ b/graphics/pgf/base/doc/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 |