summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfsys-commands.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfsys-commands.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfsys-commands.tex119
1 files changed, 91 insertions, 28 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfsys-commands.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfsys-commands.tex
index fb302c207b6..9c10da526c8 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfsys-commands.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfsys-commands.tex
@@ -459,14 +459,6 @@ force. For this escaping, the following command is used:
\end{command}
}
-\begin{command}{\pgfsys@stroke@opacity\marg{value}}
- Sets the opacity of stroking operations.
-\end{command}
-
-\begin{command}{\pgfsys@fill@opacity\marg{value}}
- Sets the opacity of filling operations.
-\end{command}
-
\subsection{Color System Commands}
@@ -760,26 +752,6 @@ The system layer provides some commands for image inclusion.
\end{command}
-\begin{command}{\pgfsys@definemask}
- This command declares a mask for usage with images. It works similar
- to |\pgfsys@defineimage|: Certain macros are set when the command is
- called. The result should be to set the macro |\pgf@mask| to a pdf
- object count that can subsequently be used as a soft mask. The
- following macros will be set when this command is invoked:
-
- \begin{itemize}
- \item \declare{|\pgf@filename|}
- File name of the mask to be defined.
-
- \item \declare{|\pgf@maskmatte|}
- The so-called matte of the mask (see the \pdf\ documentation for
- details). The matte is a color specification consisting of 1, 3 or
- 4 numbers between 0 and 1. The number of numbers depends on the
- number of color channels in the image (not in the mask!). It will
- be assumed that the image has been preblended with this color.
- \end{itemize}
-\end{command}
-
\subsection{Shading System Commands}
@@ -821,6 +793,97 @@ The system layer provides some commands for image inclusion.
\end{command}
+\begin{command}{\pgfsys@radialshading\marg{name}\marg{lower left
+ corner}\meta{upper right corner}\marg{type 4 function}}
+ Declares a shading using a PostScript-like function that provides a
+ color for each point. Like the previous macros, this command
+ should setup the macro |\@pgfshading|\meta{name}|!| so that it will
+ produce a box containing the desired shading.
+
+ Parameter \meta{name} is the name of the shading. Parameter
+ \meta{type 4 function} is a
+ Postscript-like function (type 4 function of the PDF specification)
+ as described in Section 3.9.4 of the PDF Specification version 1.7.
+ Parameters \meta{lower left corner} and \meta{upper right corner} are
+ \pgfname\ points that specifies the lower left and upper right
+ corners of the shading.
+
+ When \meta{type 4 function} is evaluated, the coordinate of the current
+ point will be on the (virtual) PostScript stack in bp units. After
+ the function has been evaluated, the stack should consist of three
+ numbers (not integers! -- the Apple PDF renderer is broken in this
+ regard, so add cvr's at the end if needed) that represent the red,
+ green, and blue components of the color.
+
+ A buggy function will result is \emph{totally unpredictable chaos} during
+ rendering.
+\end{command}
+
+
+
+\subsection{Transparency System Commands}
+
+\begin{command}{\pgfsys@stroke@opacity\marg{value}}
+ Sets the opacity of stroking operations.
+\end{command}
+
+\begin{command}{\pgfsys@fill@opacity\marg{value}}
+ Sets the opacity of filling operations.
+\end{command}
+
+\begin{command}{\pgfsys@transparencygroupfrombox\marg{box}}
+ This takes a TeX box and converts it into a transparency
+ group. This means that any transparency settings apply to the box as
+ a whole. For instance, if a box contains two overlapping black
+ circles and you draw the box and, thus, the two cirlces normally
+ with 50\% transparency, then the overlap will be darker than the
+ rest. By comparison, if the circles are part of a transparency
+ group, the overlap will get the same color as the rest.
+\end{command}
+
+\begin{command}{\pgfsys@fadingfrombox\marg{name}\marg{box}}
+ Declares the fading \meta{name}. The \meta{box} is a \TeX-box. Its
+ contents luminosity determines the opacity of the resulting
+ fading. This means that the lighter a pixel inside the box, the more
+ opaque the fading will be at this position.
+\end{command}
+
+\begin{command}{\pgfsys@usefading\meta{name}\marg{a}\marg{b}\marg{c}\marg{d}\marg{e}\marg{f}}
+ Installs a previously declared fading \meta{name} in the current
+ graphics state. Afterwards, all drawings will be masked by the
+ fading. The fading should be centered on the origin and have its
+ original size, except that the parameters \meta{a} to \meta{f}
+ specify a transformation matrix that should be applied additionally
+ to the fading before it is installed. The transformtion should not
+ apply to the following graphics, however.
+\end{command}
+
+
+\begin{command}{\pgfsys@definemask}
+ This command declares a fading (known as a soft mask in this
+ context) based on an image and for usage with images. It
+ works similar to |\pgfsys@defineimage|: Certain macros are set when
+ the command is called. The result should be to set the macro
+ |\pgf@mask| to a pdf object count that can subsequently be used as a
+ transparency mask. The following macros will be set when this command is
+ invoked:
+
+ \begin{itemize}
+ \item \declare{|\pgf@filename|}
+ File name of the mask to be defined.
+
+ \item \declare{|\pgf@maskmatte|}
+ The so-called matte of the mask (see the \pdf\ documentation for
+ details). The matte is a color specification consisting of 1, 3 or
+ 4 numbers between 0 and 1. The number of numbers depends on the
+ number of color channels in the image (not in the mask!). It will
+ be assumed that the image has been preblended with this color.
+ \end{itemize}
+\end{command}
+
+
+
+
\subsection{Reusable Objects System Commands}
\begin{command}{\pgfsys@invoke\marg{literals}}