summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-xxcolor.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-xxcolor.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-xxcolor.tex79
1 files changed, 36 insertions, 43 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-xxcolor.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-xxcolor.tex
index 603d46945b3..2a114913a68 100644
--- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-xxcolor.tex
+++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-xxcolor.tex
@@ -10,32 +10,29 @@
\section{Extended Color Support}
-This section documents the package \texttt{xxcolor}, which is
-currently distributed as part of \pgfname. This package extends the
-\texttt{xcolor} package, written by Uwe Kern, which in turn extends
-the \texttt{color} package. I hope that the commands in
-\texttt{xxcolor} will some day migrate to \texttt{xcolor}, such that
-this package becomes superfluous.
+This section documents the package \texttt{xxcolor}, which is currently
+distributed as part of \pgfname. This package extends the \texttt{xcolor}
+package, written by Uwe Kern, which in turn extends the \texttt{color} package.
+I hope that the commands in \texttt{xxcolor} will some day migrate to
+\texttt{xcolor}, such that this package becomes superfluous.
-The main aim of the \texttt{xxcolor} package is to provide an
-environment inside which all colors are ``washed out'' or ``dimmed.''
-This is useful in numerous situations and must typically be achieved
-in a roundabout manner if such an environment is not available.
+The main aim of the \texttt{xxcolor} package is to provide an environment
+inside which all colors are ``washed out'' or ``dimmed''. This is useful in
+numerous situations and must typically be achieved in a roundabout manner if
+such an environment is not available.
\begin{environment}{{colormixin}\marg{mix-in specification}}
- The mix-in specification is applied to all colors inside
- the environment. At the beginning of the environment, the mix-in is
- applied to the current color, i.\,e., the color that was in effect
- before the environment started. A mix-in specification is a number
- between 0 and 100 followed by an exclamation mark and a color
- name. When a |\color| command is
- encountered inside a mix-in environment, the number states what
- percentage of the desired color should be used. The rest is
- ``filled up'' with the color given in the mix-in
- specification. Thus, a mix-in specification like |90!blue|
- will mix in 10\% of blue into everything, whereas |25!white| will
- make everything nearly white.
-
+ The mix-in specification is applied to all colors inside the environment.
+ At the beginning of the environment, the mix-in is applied to the current
+ color, i.\,e., the color that was in effect before the environment started.
+ A mix-in specification is a number between 0 and 100 followed by an
+ exclamation mark and a color name. When a |\color| command is encountered
+ inside a mix-in environment, the number states what percentage of the
+ desired color should be used. The rest is ``filled up'' with the color
+ given in the mix-in specification. Thus, a mix-in specification like
+ |90!blue| will mix in 10\% of blue into everything, whereas |25!white| will
+ make everything nearly white.
+ %
\begin{codeexample}[width=4cm]
\begin{minipage}{3.5cm}\raggedright
\color{red}Red text,%
@@ -51,26 +48,25 @@ in a roundabout manner if such an environment is not available.
and back to red.
\end{minipage}%
\end{codeexample}
+ %
\end{environment}
-Note that the environment only changes colors that have been installed
-using the standard \LaTeX\ |\color| command. In particular,
-the colors in images are not changed. There is, however, some support
-offered by the commands |\pgfuseimage| and
-|\pgfuseshading|. If the first command is invoked
-inside a |colormixin| environment with the parameter, say,
-|50!black| on an image with the name |foo|, the command
-will first check whether there is also a defined image with the name
-|foo.!50!black|. If so, this image is used instead. This allows
-you to provide a different image for this case. If you nest
-|colormixin| environments, the different mix-ins are all appended. For
-example, inside the inner environment of
-the above example, |\pgfuseimage{foo}| would first check whether
-there exists an image named |foo.!25!white!25!black|.
+Note that the environment only changes colors that have been installed using
+the standard \LaTeX\ |\color| command. In particular, the colors in images are
+not changed. There is, however, some support offered by the commands
+|\pgfuseimage| and |\pgfuseshading|. If the first command is invoked inside a
+|colormixin| environment with the parameter, say, |50!black| on an image with
+the name |foo|, the command will first check whether there is also a defined
+image with the name |foo.!50!black|. If so, this image is used instead. This
+allows you to provide a different image for this case. If you nest |colormixin|
+environments, the different mix-ins are all appended. For example, inside the
+inner environment of the above example, |\pgfuseimage{foo}| would first check
+whether there exists an image named |foo.!25!white!25!black|.
\begin{command}{\colorcurrentmixin}
- Expands to the current accumulated mix-in. Each nesting of a
- |colormixin| adds a mix-in to this list.
+ Expands to the current accumulated mix-in. Each nesting of a |colormixin|
+ adds a mix-in to this list.
+ %
\begin{codeexample}[]
\begin{minipage}{\linewidth-6pt}\raggedright
\begin{colormixin}{75!white}
@@ -84,8 +80,5 @@ there exists an image named |foo.!25!white!25!black|.
\end{colormixin}
\end{minipage}
\end{codeexample}
+ %
\end{command}
-
-
-
-