diff options
author | Karl Berry <karl@freefriends.org> | 2008-02-23 00:49:54 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2008-02-23 00:49:54 +0000 |
commit | 4fc1af1461e934c39f8f5e10d5d8788681d82223 (patch) | |
tree | 7716e8a3e8787a3d11c5ce728d21b808f786ce7d /Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pgfsys-commands.tex | |
parent | 6f5a4edf390b6e05291d7a4b816782b14122a205 (diff) |
tikz/pgf 2.0 first attempt (22feb08)
git-svn-id: svn://tug.org/texlive/trunk@6741 c570f23f-e606-0410-a88d-b1316a301751
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.tex | 119 |
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}} |