diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shadings.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shadings.tex | 261 |
1 files changed, 127 insertions, 134 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shadings.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shadings.tex index 2d7d9648ef5..5d3ebbc995b 100644 --- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shadings.tex +++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-library-shadings.tex @@ -12,89 +12,83 @@ \label{section-library-shadings} \begin{pgflibrary}{shadings} - The package defines a number of shadings in addition to the ball and - axis shadings that are available by default. + The package defines a number of shadings in addition to the ball and axis + shadings that are available by default. \end{pgflibrary} In the following, the shadings defined in the library are listed in -alphabetical order. The colors of some of these shadings can be -configured using special options (like |left color|). These options -implicitly select the shading. - -The three shadings |axis|, |ball|, and |radial| are always defined, -even when this library is not used. +alphabetical order. The colors of some of these shadings can be configured +using special options (like |left color|). These options implicitly select the +shading. +The three shadings |axis|, |ball|, and |radial| are always defined, even when +this library is not used. \begin{shading}{axis} - In this always-defined shading the colors change gradually - between three horizontal lines. The top line is at the top - (uppermost) point of the path, the middle is in the middle, the - bottom line is at the bottom of the path. - - \begin{key}{/tikz/top color=\meta{color}} - This option sets the color to be used at the top in an |axis| - shading. When this option is given, several things happen: - \begin{enumerate} - \item - The |shade| option is selected. - \item - The |shading=axis| option is selected. - \item - The middle color of the axis shading is set to the average of the - given top color \meta{color} and of whatever color is currently - selected for the bottom. - \item - The rotation angle of the shading is set to 0. - \end{enumerate} - + In this always-defined shading the colors change gradually between three + horizontal lines. The top line is at the top (uppermost) point of the path, + the middle is in the middle, the bottom line is at the bottom of the path. + % + \begin{key}{/tikz/top color=\meta{color}} + This option sets the color to be used at the top in an |axis| shading. + When this option is given, several things happen: + % + \begin{enumerate} + \item The |shade| option is selected. + \item The |shading=axis| option is selected. + \item The middle color of the axis shading is set to the average of + the given top color \meta{color} and of whatever color is + currently selected for the bottom. + \item The rotation angle of the shading is set to 0. + \end{enumerate} + % \begin{codeexample}[] \tikz \draw[top color=red] (0,0) rectangle (2,1); \end{codeexample} - \end{key} - - \begin{key}{/tikz/bottom color=\meta{color}} - This option works like |top color|, only for the bottom color. - \end{key} - - \begin{key}{/tikz/middle color=\meta{color}} - This option specifies the color for the middle of an axis - shading. It also sets the |shade| and |shading=axis| options, but it - does not change the rotation angle. - - \emph{Note:} Since both |top color| and |bottom color| change the - middle color, this option should be given \emph{last} if all of - these options need to be given: - + \end{key} + + \begin{key}{/tikz/bottom color=\meta{color}} + This option works like |top color|, only for the bottom color. + \end{key} + + \begin{key}{/tikz/middle color=\meta{color}} + This option specifies the color for the middle of an axis shading. It + also sets the |shade| and |shading=axis| options, but it does not + change the rotation angle. + + \emph{Note:} Since both |top color| and |bottom color| change the + middle color, this option should be given \emph{last} if all of these + options need to be given: + % \begin{codeexample}[] \tikz \draw[top color=white,bottom color=black,middle color=red] (0,0) rectangle (2,1); -\end{codeexample} - \end{key} - - \begin{key}{/tikz/left color=\meta{color}} - This option does exactly the same as |top color|, except that the - shading angle is set to $90^\circ$. - \end{key} - - \begin{key}{/tikz/right color=\meta{color}} - Works like |left color|. - \end{key} -\end{shading} +\end{codeexample} + \end{key} + + \begin{key}{/tikz/left color=\meta{color}} + This option does exactly the same as |top color|, except that the + shading angle is set to $90^\circ$. + \end{key} + \begin{key}{/tikz/right color=\meta{color}} + Works like |left color|. + \end{key} +\end{shading} \begin{shading}{ball} - This always-defined shading fills the path with a shading that ``looks like a - ball.'' The default ``color'' of the ball is blue (for no - particular reason). - - \begin{key}{/tikz/ball color=\meta{color}} - This option sets the color used for the ball shading. It sets the - |shade| and |shading=ball| options. Note that the ball will never - ``completely'' have the color \meta{color}. At its ``highlight'' spot - a certain amount of white is mixed in, at the border a certain - amount of black. Because of this, it also makes sense to say - |ball color=white| or |ball color=black| - + This always-defined shading fills the path with a shading that ``looks like + a ball''. The default ``color'' of the ball is blue (for no particular + reason). + + \begin{key}{/tikz/ball color=\meta{color}} + This option sets the color used for the ball shading. It sets the + |shade| and |shading=ball| options. Note that the ball will never + ``completely'' have the color \meta{color}. At its ``highlight'' spot a + certain amount of white is mixed in, at the border a certain amount of + black. Because of this, it also makes sense to say |ball color=white| + or |ball color=black| + % \begin{codeexample}[] \begin{tikzpicture} \shade[ball color=white] (0,0) circle (2ex); @@ -102,20 +96,17 @@ even when this library is not used. \shade[ball color=black] (2,0) circle (2ex); \end{tikzpicture} \end{codeexample} - \end{key} + \end{key} \end{shading} - - \begin{shading}{bilinear interpolation} - This shading fills a rectangle with colors that a bilinearly - interpolated between the colors in the four corners of the - rectangle. These four colors are called |lower left|, |lower right|, - |upper left|, and |upper right|. By changing these color, you can - change the way the shading looks. The library also defines four - options, called the same way, that can be used to set these colors - and select the shading implicitly. - + This shading fills a rectangle with colors that a bilinearly interpolated + between the colors in the four corners of the rectangle. These four colors + are called |lower left|, |lower right|, |upper left|, and |upper right|. By + changing these color, you can change the way the shading looks. The library + also defines four options, called the same way, that can be used to set + these colors and select the shading implicitly. + % \begin{codeexample}[] \tikz \shade[upper left=red,upper right=green, @@ -123,103 +114,105 @@ even when this library is not used. (0,0) rectangle (3,2); \end{codeexample} - \begin{key}{/tikz/lower left=\meta{color} (initially white)} - Sets the color to be used in a |bilinear interpolation| shading - for the lower left corner. Also, this options selects this shading - and sets the |shade| option. - \end{key} - - \begin{key}{/tikz/upper left=\meta{color} (initially white)} - Works like |lower left|. - \end{key} - \begin{key}{/tikz/upper right=\meta{color} (initially white)} - Works like |lower left|. - \end{key} - \begin{key}{/tikz/lower right=\meta{color} (initially white)} - Works like |lower left|. - \end{key} -\end{shading} + \begin{key}{/tikz/lower left=\meta{color} (initially white)} + Sets the color to be used in a |bilinear interpolation| shading for the + lower left corner. Also, this options selects this shading and sets the + |shade| option. + \end{key} + + \begin{key}{/tikz/upper left=\meta{color} (initially white)} + Works like |lower left|. + \end{key} + + \begin{key}{/tikz/upper right=\meta{color} (initially white)} + Works like |lower left|. + \end{key} + \begin{key}{/tikz/lower right=\meta{color} (initially white)} + Works like |lower left|. + \end{key} +\end{shading} \begin{shading}{color wheel} - \label{shading-color-wheel} - This shading fills the path with a color wheel. +\label{shading-color-wheel}% + This shading fills the path with a color wheel. + % \begin{codeexample}[] \tikz \shade[shading=color wheel] (0,0) circle (1.5); \end{codeexample} - To produce a color ring, cut out a circle from the color wheel: + % + To produce a color ring, cut out a circle from the color wheel: + % \begin{codeexample}[] \tikz \shade[shading=color wheel] [even odd rule] (0,0) circle (1.5) (0,0) circle (1); \end{codeexample} + % \end{shading} - \begin{shading}{color wheel black center} - This shading looks like a color wheel, but the brightness drops to - zero in the center. + This shading looks like a color wheel, but the brightness drops to zero in + the center. + % \begin{codeexample}[] \tikz \shade[shading=color wheel black center] (0,0) circle (1.5); \end{codeexample} + % \end{shading} - \begin{shading}{color wheel white center} - This shading looks like a color wheel, but the saturation drops to - zero in the center. + This shading looks like a color wheel, but the saturation drops to zero in + the center. + % \begin{codeexample}[] \tikz \shade[shading=color wheel white center] (0,0) circle (1.5); \end{codeexample} + % \end{shading} - - \begin{shading}{Mandelbrot set} - This shading is just for fun. It fills the path with a zoomable - Mandelbrot set. Note that this is \emph{not} a bitmap - graphic. Rather, the Mandelbrot set is \emph{computed by the - \textsc{pdf} renderer} and can be zoomed arbitrarily (give it a - try, if you have a fast computer). - + This shading is just for fun. It fills the path with a zoomable Mandelbrot + set. Note that this is \emph{not} a bitmap graphic. Rather, the Mandelbrot + set is \emph{computed by the \textsc{pdf} renderer} and can be zoomed + arbitrarily (give it a try, if you have a fast computer). + % \begin{codeexample}[] \tikz \shade[shading=Mandelbrot set] (0,0) rectangle (2,2); \end{codeexample} + % \end{shading} - - \begin{shading}{radial} - This always-defined shading fills the path with a gradual sweep from - a certain color in the middle to another color at the border. If the path is - a circle, the outer color will be reached exactly at the - border. If the shading is not a circle, the outer color will - continue a bit towards the corners. The default inner color is - gray, the default outer color is white. - - \begin{key}{/tikz/inner color=\meta{color}} - This option sets the color used at the center of a |radial| - shading. When this option is used, the |shade| and |shading=radial| - options are set. - + This always-defined shading fills the path with a gradual sweep from a + certain color in the middle to another color at the border. If the path is + a circle, the outer color will be reached exactly at the border. If the + shading is not a circle, the outer color will continue a bit towards the + corners. The default inner color is gray, the default outer color is white. + % + \begin{key}{/tikz/inner color=\meta{color}} + This option sets the color used at the center of a |radial| shading. + When this option is used, the |shade| and |shading=radial| options are + set. + % \begin{codeexample}[] \tikz \draw[inner color=red] (0,0) rectangle (2,1); \end{codeexample} - \end{key} + \end{key} - \begin{key}{/tikz/outer color=\meta{color}} - This option sets the color used at the border and outside of a - |radial| shading. - + \begin{key}{/tikz/outer color=\meta{color}} + This option sets the color used at the border and outside of a |radial| + shading. + % \begin{codeexample}[] \tikz \draw[outer color=red,inner color=white] (0,0) rectangle (2,1); \end{codeexample} - \end{key} + \end{key} \end{shading} -%%% Local Variables: +%%% Local Variables: %%% mode: latex %%% TeX-master: "pgfmanual-pdftex-version" -%%% End: +%%% End: |