diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
commit | 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch) | |
tree | 90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/xcolor | |
parent | 950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff) |
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/xcolor')
-rw-r--r-- | Master/texmf-dist/doc/latex/xcolor/ChangeLog | 266 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xcolor/README | 57 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xcolor/xcolor.lox | 56 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xcolor/xcolor.pdf | bin | 0 -> 606645 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xcolor/xcolor1.tex | 182 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xcolor/xcolor2.pdf | bin | 0 -> 95240 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/xcolor/xcolor2.tex | 157 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xcolor/xcolor3.tex | 131 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/xcolor/xcolor4.tex | 131 |
9 files changed, 980 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/xcolor/ChangeLog b/Master/texmf-dist/doc/latex/xcolor/ChangeLog new file mode 100644 index 00000000000..0434350886b --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcolor/ChangeLog @@ -0,0 +1,266 @@ +Package `xcolor' by Dr. Uwe Kern +(xcolor at ukern dot de) + +History +======= + +2005/10/15 v2.06 +* New features: + - color model `wave' for (approximate) visualisation of light + wavelengths, still somewhat experimental; + - pseudo-model `ps' for colors defined by literal PostScript code + in conjunction with `pstricks and `dvips'; an illustrative + example for a gamma-correction approach is given in xcolor2.tex; + - \substitutecolormodel command for replacement of missing or + faulty driver-specific color models; + - improved detection and handling of driver-specific color models; + - `dvipdfmx' and `xetex' options to support these drivers; + - generic driver test file xcolor4.tex. +* Changes: + - \XC@strip@comma doesn't generate a trailing space anymore, which + improves also the output of the `testcolors' environment. + +2005/09/30 v2.05 +* New features: + - `testcolors' environment helps to test colors in different models, + showing both the visual result and the model-specific parameters; + - \extractcolorspecs puts model/color specification into two + separate commands, as opposed to \extractcolorspec; + - color names `pink' and `olive' added to the set of predefined + colors. +* Bugfixes: + - \definecolor{foo}{named}{bar} did not work in v2.04. + +2005/09/23 v2.04 +* New features: + - preparation for usage of additional - driver-provided - color + models; + - `pstricks' users may now specify explicit color parameters within + \psset and related commands, e.g., \psset{linecolor=[rgb]{1,0,0}}; + an illustrative example is given in xcolor2.tex. +* Changes: + - color model names sanitized (i.e., turned to catcode 12) + throughout the package; + - \@namelet command deprecated because of name clash with + `memoir' - please use \XC@let@cc instead + (more \XC@let@.. commands are available as well); + - simplified color conversion code by using the new \XC@ifxcase + command; + - some minor changes to internal macros. + +2005/06/06 v2.03 +* New features: + - `fixpdftex' option loads `pdfcolmk' package in order to improve + pdfTeX's color behaviour during page breaks. +* Changes: + - some minor changes to internal macros. +* Bugfixes: + - due to an incorrect \if statement within \XC@info, \colorlet + caused trouble whenever its second argument started with two + identical letters, e.g., \colorlet{rab}{oof}; + - argument processing of \XC@getcolor caused incompatibility with + `msc' package; + - `prologue' option caused incompatibility with `preview' package. + +2005/03/24 v2.02 +* New features: + - \aftergroupedef command to reproduce \aftergroupdef's behaviour + prior to v2.01; + - xcolor's homepage www.ukern.de/tex/xcolor.html now provides also + a ready-to-run TDS-compliant archive containing all required + files. +* Changes: + - \rowcolors and friends are solely enabled by the `table' option; + - \@ifxempty changed back to more robust variant of v2.00. +* Bugfixes: + - \psset{linecolor=\ifcase\foo red\or green\or blue\fi} did not work + with `pstricks' (error introduced in v2.01). + +2005/03/15 v2.01 +* New features: + - `prologue' option for comprehensive `named' color support in + conjunction with `dvips': on-the-fly generation of PostScript + prologue files with all color definitions, ready for dvips + inclusion and/or post-processing with device-specific parameters + (e.g., spot colors); + - dvips prologue file xcolor.pro to support additional `named' + colors; + - \colorlet may now also be used to create named colors from + arbitrary color expressions; + - enhanced color definition syntax to allow for target-model + specific color parameters, e.g., + \definecolor{red}{rgb/cmyk}{1,0,0/0,1,1,0}, facilitating the + usage of tailor-made colors both for displays and printers; + - `deferred definition' of colors: \preparecolor and + \definecolors enable decoupling of color specification and control + sequence generation, especially useful (= memory saving) for large + lists of colors, of which only a few names are actually used; + - `dvipsnames*' and `svgnames*' options to support deferred + definition. +* Changes: + - higher accuracy: most complement calculations are now exact for + all 5-digit decimals; + - \rangeRGB and similar variables may now be changed at any point + in a document; + - \aftergroupdef now performs only a first-level expansion of its + code argument; + - \XCfileversion and similar internal constants removed from .sty + and .def files; + - improved memory management (reduced generation of `multiletter + control sequences' by \@ifundefined tests); + - several internal macros improved and/or renamed. +* Bugfixes: + - \XC@getcolor could cause unwanted spaces when \psset was used + inside |pspicture| environments (`pstricks'); + - arithmetic overflow could happen when too many decimal digits + were used within color parameters, e.g., as a result of `fp' + calculations. + +2004/07/04 v2.00 +* New features: + - extended functionality for color expressions: mix colors like a + painter; + - support for color blending: specify color mix expressions that + are being blended with every displayed color; + - \xglobal command for selective control of globality for color + definitions, blends, and masks; + - multiple step operations (e.g., \color{foo!!+++}) and access to + individual members (e.g., \color{foo!![7]}) in color series; + - \providecolor command to define only non-existent colors; + - \definecolorset and \providecolorset commands to facilitate the + construction of color sets with common underlying color model; + - additional 147 predefined color names according to SVG 1.1 + specification; + - `xpdfborder' key for setting the width of hyperlink borders in a + more driver-independent way if `dvips' is used. +* Changes: + - `color' package now completely integrated within `xcolor'; + - `override', `usenames', `nodvipsnames' options and \xdefinecolor + command no longer needed; + - `dvips' and `dvipsnames' options now independent of each other; + - \tracingcolors's behaviour changed to make it more versatile and + reduce log file size in standard cases; + - \rdivide's syntax made more flexible (divide by numbers and/or + dimensions); + - code restructured, some internal commands renamed; + - documentation rearranged and enhanced. +* Bugfixes: + - \definecolor{foo}{named}{bar} did not work (error introduced in + v1.11); + - more robust behaviour of conditionals within `pstricks' + key-values. + +2004/05/09 v1.11 +* New features: + - switch \ifglobalcolors to control whether color definitions are + global or local; + - option `hyperref' provides color expression support for the + border colors of hyperlinks, e.g., + \hypersetup{xurlbordercolor=red!50!yellow}; + - internal hooks \XC@bcolor, \XC@mcolor, and \XC@ecolor for + additional code that has to be executed immediately before/after + the current color is being displayed. +* Changes: + - \XC@logcolor renamed to \XC@display, which is now the core color + display command; + - improved interface to `pstricks'. + +2004/03/27 v1.10 +* New features: + - support for `named' model; + - support for `dvips' colors + (may now be used within color expressions); + - internal representation of `ordinary' and `named' colors merged + into unified data structure; + - allow multiple `-' signs at the beginning of color expressions. +* Bugfixes: + - commands like \color[named]{foo} caused errors when color masking + or target model conversion were active; + - incompatibility with `soul' package: commands \hl, \ul, etc. + could yield unexpected results. +* Documentation: + - added formula for general color expressions; + - enhanced text and index; + - removed dependence of index generation on local configuration + file. + +2004/02/16 v1.09 +* New features: + - color model `HTML', a 24-bit hexadecimal `RGB' variant; + allows to specify colors like \color[HTML]{AFFE90}; + - color names `orange', `violet', `purple', and `brown' added to + the set of predefined colors. +* New xcolor homepage: www.ukern.de/tex/xcolor.html +* Bugfix: \xdefinecolor sometimes did not normalise its parameters. +* Changes: + - slight improvements of the documentation; + - example file xcolor1.tex reorganised and abridged. + +2004/02/04 v1.08 +* New commands/features: + - \selectcolormodel to change the target model within a document; + - \adjustUCRBG to fine-tune undercolor-removal and + black-generation during conversion to `cmyk'. +* Bugfix: color expressions did not work correctly in connection with + active `!' character, e.g., in case of \usepackage[frenchb]{babel}. +* Code re-organisation: + - \XC@xdefinecolor merged into \xdefinecolor, making the first + command obsolete; + - several internal commands improved/streamlined. + +2004/01/20 v1.07 +* New feature: support for color masking and color separation. +* New commands: + - \rmultiply to multiply a dimension register by a real number; + - \xcolorcmd to pass commands that are to be executed at the end + of the package. +* Changes: + - more consistent color handling: extended colors now always take + precedence over standard colors; + - several commands improved by using code from the LaTeX kernel. +* Documentation: some minor changes. +* Example files: additional `pstricks' examples (file xcolor2.tex). + +2003/12/15 v1.06 +* New feature: extended color expressions, allowing for cascaded mix + operations, e.g., \color{red!30!green!40!blue}. +* Documentation: new section on color expressions. +* Bugfix: color series stepping did not work correctly within + non-displaying commands like \extractcolorspec{foo!!+} + (this bug was introduced in v1.05). +* Renamed commands: \ukfileversion and similar internal constants + renamed to \XCfileversion etc. +* Removed commands: \ifXCpst and \ifXCtable made obsolete by a simple + trick. + +2003/11/21 v1.05 +* Bugfixes: + - package option `hideerrors' should now work as expected; + - usage of `.' in the first color expression in a document caused + an error due to incorrect initialisation. +* Code re-organisation: \extractcolorspec now uses \XC@splitcolor, + making \XC@extract obsolete. + +2003/11/09 v1.04 +* New feature: easy access to current color within color expressions. +* New option: `override' to replace \definecolor by \xdefinecolor. +* New command: \tracingcolors for logging color-specific information. + +2003/09/21 v1.03 +* Change: bypass strange behaviour of some drivers. +* New feature: driver-sharing with `hyperref'. + +2003/09/19 v1.02 +* Change: \extractcolorspec and \colorlet now also accept color series + as arguments. + +2003/09/15 v1.01 +* New feature: \definecolorseries and friends. +* Documentation: removed some `doc'-related side-effects. +* Code re-organisation: all calculation-related tools put to one place. +* Bugfixes: + - \@rdivide: added \relax to fix problem with negative numerators; + - \rowc@l@rs: replaced \@ifempty by \@ifxempty. + +2003/09/09 v1.00 +* First published release. diff --git a/Master/texmf-dist/doc/latex/xcolor/README b/Master/texmf-dist/doc/latex/xcolor/README new file mode 100644 index 00000000000..155040a75f4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcolor/README @@ -0,0 +1,57 @@ +Package `xcolor' by Dr. Uwe Kern +(xcolor at ukern dot de) + +v2.06 (2005/10/15) + +`xcolor' provides easy driver-independent access to several kinds of +colors, tints, shades, tones, and mixes of arbitrary colors by means of +color expressions like \color{red!50!green!20!blue}. +It allows to select a document-wide target color model and offers tools +for automatic color schemes, conversion between nine color models, +alternating table row colors, color blending and masking, and color +separation. + +Installation instructions +========================= + +Extract all package files: + `latex xcolor.ins' + +Put the generated files to their respective locations +within the TeX installation: + *.sty -> /tex/latex/xcolor/ + *.def -> /tex/latex/xcolor/ + *.pro -> /dvips/xcolor/ + +Create the documentation: + `latex xcolor.dtx' + `latex xcolor.dtx' + `makeindex -s gind.ist xcolor.idx' + `latex xcolor.dtx' + `latex xcolor.dtx' + +Run the test files (N=1,2,...): + `latex xcolorN.tex' + `latex xcolorN.tex' + +Notes +===== + +- `xcolor1.tex' should run with both LaTeX and pdfLaTeX, it yields a + 50-page document with several systematic color conversion examples +- `xcolor2.tex' is a 3-page `pstricks' example document that won't run + with pdfLaTeX +- `xcolor3.tex' is a 1-page example for demonstrating the logging + facilities +- `xcolor4.tex' is a 1-page driver test file; + uncomment the relevant code line in the header and run it with the + appropriate program, e.g., `latex xcolor4' or any other processor; + apply any desired post-processing like dvips, dvipdfm, etc. +- If the file `xcolor.ins' is missing, run `latex xcolor.dtx' once + and quit the LaTeX compiler as soon as the first error message + appears. + +History +======= + +See file `ChangeLog'. diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor.lox b/Master/texmf-dist/doc/latex/xcolor/xcolor.lox new file mode 100644 index 00000000000..adccdddbf87 --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcolor/xcolor.lox @@ -0,0 +1,56 @@ +%% +%% This is file `xcolor.lox', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% xcolor.dtx (with options: `extract') +%% +%% IMPORTANT NOTICE: +%% +%% For the copyright see the source file. +%% +%% Any modified versions of this file must be renamed +%% with new filenames distinct from xcolor.lox. +%% +%% For distribution of the original source see the terms +%% for copying and modification in the file xcolor.dtx. +%% +%% This generated file may be distributed as long as the +%% original source files, as listed above, are part of the +%% same distribution. (The sources need not necessarily be +%% in the same archive or directory.) +%% +%% ---------------------------------------------------------------- +%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de> +%% ---------------------------------------------------------------- +%% +\def\XCfileversion{v2.06}% +\def\XCfiledate{2005/10/15}% +\def\ukfile#1#2#3#4% + {\def\ukhead + {\ifnum#1>2 \perCent!^^J\fi + \defaultpreamble^^J\MetaPrefix^^J% + \ifcase#1 + \string\ProvidesPackage{#2}^^J\or + \string\ProvidesFile{#2}^^J\or + \string\ProvidesFile{#2.def}^^J\or + \MetaPrefix\space #2.pro (PostScript/dvips header file)^^J\MetaPrefix\space + \fi + \space[\XCfiledate\space\XCfileversion\space#4\space(UK)]} + \usepreamble\ukhead + \file{#2.\ifcase#1sty\or tex\or def\or pro\fi}{\from{xcolor.dtx}{#3}}} +\generate{ +\ukfile0{xcolor}{package}{LaTeX color extensions} +\ukfile2{svgnam}{svgnames}{Predefined colors according to SVG 1.1} +\ukfile1{xcolor1}{test1}{Color conversion test} +\ukfile1{xcolor2}{test2}{Pstricks color test} +\ukfile1{xcolor3}{test3}{Color logging test} +\ukfile1{xcolor4}{test4}{Color driver test} +\def\PStail{\MetaPrefix\space End of file `\outFileName'.} +\usepostamble\PStail +\ukfile3{xcolor}{dvips}{LaTeX color extensions} +} +\endinput +%% +%% End of file `xcolor.lox'. diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor.pdf b/Master/texmf-dist/doc/latex/xcolor/xcolor.pdf Binary files differnew file mode 100644 index 00000000000..e1806f83fa2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcolor/xcolor.pdf diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor1.tex b/Master/texmf-dist/doc/latex/xcolor/xcolor1.tex new file mode 100644 index 00000000000..74215b2d4bb --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcolor/xcolor1.tex @@ -0,0 +1,182 @@ +%% +%% This is file `xcolor1.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% xcolor.dtx (with options: `test1') +%% +%% IMPORTANT NOTICE: +%% +%% For the copyright see the source file. +%% +%% Any modified versions of this file must be renamed +%% with new filenames distinct from xcolor1.tex. +%% +%% For distribution of the original source see the terms +%% for copying and modification in the file xcolor.dtx. +%% +%% This generated file may be distributed as long as the +%% original source files, as listed above, are part of the +%% same distribution. (The sources need not necessarily be +%% in the same archive or directory.) +%% +\ProvidesFile{xcolor1} + [2005/10/15 v2.06 Color conversion test (UK)] +%% +%% ---------------------------------------------------------------- +%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de> +%% ---------------------------------------------------------------- +%% +\def\XCfileversion{v2.06}% +\def\XCfiledate{2005/10/15}% +\documentclass[a4paper]{article} + +\usepackage{array,multicol,multido,textcomp} +\usepackage{xcolor}[2005/03/24] +\usepackage[hmargin={1.25cm,.75cm},vmargin=1.25cm,footskip=.5cm,nohead]{geometry} + +\newdimen\Argwd +\newdimen\Errsum +\newdimen\Errmax +\newcount\Colors +\newcount\Errors +\newcount\Loops +\newif\ifColor + +\makeatletter + +\def\DisplayColor#1#2#3% + {\global\advance\Loops\@ne + \@tempdima=#1\p@ \edef\@tempa{\the\@tempdima}% + \edef\Colori{\strip@pt\@tempdima}% + \ifColor + \@tempdimb=#2\p@ \edef\@tempb{\the\@tempdimb}% + \@tempdimc=#3\p@ \edef\@tempc{\the\@tempdimc}% + \edef\Colori{\Colori,\strip@pt\@tempdimb,\strip@pt\@tempdimc}% + \fi + \Make12\Make23\Make34\Make45\Make56\Make67% + \begin{tabular}{@{}ll*4{@{ }p{\Argwd}}@{}} + \Row1\Row2\Row3\Row4\Row5\Row6\noalign{\medskip} + \end{tabular} + \global\advance\Colors1 \relax\ifnum\Colors=30 \newpage\global\Colors=0 \fi} + +\def\Make#1#2% + {\edef\@@tmp + {\noexpand\definecolor{Color\romannumeral#1}% + {\@nameuse{Model\romannumeral#1}}{\@nameuse{Color\romannumeral#1}}% + }\@@tmp + \relax\ifnum#1<6 + \convertcolorspec + {\@nameuse{Model\romannumeral#1}}{\@nameuse{Color\romannumeral#1}}% + {\@nameuse{Model\romannumeral#2}}\@@tmp + \XC@let@cN{Color\romannumeral#2}\@@tmp + \fi} +\def\Row#1% + {\edef\@@tmp{\@nameuse{Color\romannumeral#1}\@nameuse{Row\romannumeral#1}}% + \expandafter\@Row\@@tmp} + +\def\@Row#1,#2,#3,#4,#5#6% + {\fcolorbox{black}{Color\romannumeral#5}{\phantom{000}}& + \csname Model\romannumeral#5\endcsname & + \ifodd#6 \@Error{#1}\@tempa \else #1\fi & + \ifColor\ifodd#6 \@Error{#2}\@tempb \else #2\fi\else #2\fi & + \ifColor\ifodd#6 \@Error{#3}\@tempc \else #3\fi\else #3\fi & + #4\\} + +\def\defModel#1#2#3#4% number, name, commas, check + {\@namedef{Model\romannumeral#1}{#2}\@namedef{Row\romannumeral#1}{#3#1#4}} + +\def\@Error#1#2% + {\ifdim#1\p@=#2\relax #1\else + \textcolor{red}{#1}\global\advance\Errors\@ne + \dimen@#2\advance\dimen@-#1\p@ \ifdim\dimen@<\z@\dimen@-\dimen@\fi + \global\advance\Errsum\dimen@ + \ifdim\dimen@>\Errmax \global\Errmax\dimen@ + \dimen@\@tempa \edef\@@tempa{\strip@pt\dimen@}% + \ifColor + \dimen@\@tempb \edef\@@tempb{\strip@pt\dimen@}% + \dimen@\@tempc \edef\@@tempc{\strip@pt\dimen@}% + \xdef\Errcase{\@@tempa\noexpand~\@@tempb\noexpand~\@@tempc}% + \else + \xdef\Errcase{\@@tempa}% + \fi + \fi + \fi} + +\newenvironment{ColorTest}[1]% + {\addcontentsline{toc}{section}{Color conversion chain: #1} + \Colors\z@ \Errors\z@ \Loops\z@ \Errsum\z@ \Errmax\z@ + \begin{multicols}{3}\centering}% + {\end{multicols}\bigskip + \begin{tabular}{@{}l@{ = }l@{}} + \multicolumn2{@{}l@{}}{Rounding error statistics of color conversion test}\\ + \multicolumn2{@{}l@{}}% + {$\textbf\Modeli\rightarrow \textbf\Modelii\rightarrow \textbf\Modeliii\rightarrow + \textbf\Modeliv\rightarrow \textbf\Modelv\rightarrow \textbf\Modelvi$:}\\[1ex] + number of examples& \number\Loops\\ + number of errors& \number\Errors\\ + sum of absolute errors& \strip@pt\Errsum\\ + \ifnum\Errors>\z@ + average error& \Errsum100\Errsum \dimen@\Errors\p@ \divide\dimen@\@m + \rdivide\Errsum\dimen@ \strip@pt\Errsum\textperiodcentered10\textsuperscript{-5}\\ + maximum error& \strip@pt\Errmax{} @ \Modeli~\Errcase\\ + \fi + \end{tabular}\newpage} + +\def\thepage{\sffamily\footnotesize\@nameuse{@arabic}\c@page} + +\makeatother + +\parindent0pt +\setcounter{secnumdepth}{-1} + +\begin{document} + +\title{Color conversion with the \textsf{xcolor} package --- Examples} +\author{Dr. Uwe Kern\thanks{This file is part of the \textsf{xcolor} distribution which can be downloaded from the CTAN mirrors (\texttt{macros/latex/contrib/xcolor/}) or the homepage \texttt{www.ukern.de/tex/xcolor.html}. Please send error reports and suggestions for improvements to \texttt{xcolor@ukern.de}.}} +\date{\XCfileversion{} (\XCfiledate)} +\maketitle + +\begin{center} +\begin{minipage}{.75\textwidth} +\tableofcontents +\end{minipage} +\end{center} +\newpage + +\sffamily\footnotesize +\fboxrule.25pt +\settowidth\Argwd{0.00000} + +\defModel1{rgb}{,,}0 +\defModel2{cmy}{,,}0 +\defModel3{cmyk}{,}0 +\defModel4{hsb}{,,}0 +\defModel5{rgb}{,,}1 +\defModel6{gray}{,,,,}0 +\Colortrue + +\begin{ColorTest}{rgb, cmy, cmyk, hsb, rgb, gray} +\multido{\nR=1+-.1}{11}% + {\multido{\nG=1+-.1}{11}% + {\multido{\nB=1+-.1}{11}% + {\DisplayColor{\nR}{\nG}{\nB}}}}% +\end{ColorTest} + +\defModel1{gray}{,,,,}0 +\defModel2{rgb}{,,}0 +\defModel3{cmy}{,,}0 +\defModel4{cmyk}{,}0 +\defModel5{hsb}{,,}0 +\defModel6{gray}{,,,,}1 +\Colorfalse + +\begin{ColorTest}{gray, rgb, cmy, cmyk, hsb, gray} +\multido{\nG=1+-.01}{101}{\DisplayColor{\nG}{}{}}% +\end{ColorTest} + +\end{document} +\endinput +%% +%% End of file `xcolor1.tex'. diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor2.pdf b/Master/texmf-dist/doc/latex/xcolor/xcolor2.pdf Binary files differnew file mode 100644 index 00000000000..a71b77c8ca5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcolor/xcolor2.pdf diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor2.tex b/Master/texmf-dist/doc/latex/xcolor/xcolor2.tex new file mode 100644 index 00000000000..38f04d8a5d4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcolor/xcolor2.tex @@ -0,0 +1,157 @@ +%% +%% This is file `xcolor2.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% xcolor.dtx (with options: `test2') +%% +%% IMPORTANT NOTICE: +%% +%% For the copyright see the source file. +%% +%% Any modified versions of this file must be renamed +%% with new filenames distinct from xcolor2.tex. +%% +%% For distribution of the original source see the terms +%% for copying and modification in the file xcolor.dtx. +%% +%% This generated file may be distributed as long as the +%% original source files, as listed above, are part of the +%% same distribution. (The sources need not necessarily be +%% in the same archive or directory.) +%% +\ProvidesFile{xcolor2} + [2005/10/15 v2.06 Pstricks color test (UK)] +%% +%% ---------------------------------------------------------------- +%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de> +%% ---------------------------------------------------------------- +%% +\def\XCfileversion{v2.06}% +\def\XCfiledate{2005/10/15}% +\listfiles +\documentclass{article} + +\usepackage{pstricks,pst-tree,pst-slpe,multido} +\makeatletter +\@ifpackagelater{pstricks}{2004/05/12}{}{\usepackage[pst]{xcolor}} +\makeatother +\usepackage{fvrb-ex} + +\def\textfraction{0.01} +\def\topfraction{0.99} +\def\bottomfraction{0.99} +\def\floatpagefraction{0.70} +\setlength\abovecaptionskip{12pt} +\setlength\belowcaptionskip{10pt} +\parindent0pt + +\begin{document} +\title{Color extensions with the \textsf{xcolor} package --- \textsf{pstricks} examples} +\author{Dr. Uwe Kern\thanks{This file is part of the \textsf{xcolor} distribution which can be downloaded from the CTAN mirrors (\texttt{macros/latex/contrib/xcolor/}) or the homepage \texttt{www.ukern.de/tex/xcolor.html}. Please send error reports and suggestions for improvements to \texttt{xcolor@ukern.de}.}} +\date{\XCfileversion{} (\XCfiledate)} +\maketitle + +\centerline{\fcolorbox{red}{yellow!50}{This document is not suitable for pdf\LaTeX! Please use \LaTeX{} + \texttt{dvips} etc.}} + +\begin{figure}[htb]\caption{Modified version of an example from the \textsf{pstricks} manual; requires \textsf{pst-tree}} +\begin{SideBySideExample}[fontsize=\footnotesize,xrightmargin=.45\textwidth] + \begin{pspicture}[.5](-0.5,-2)(3,2) + \cnode(0,0){.5cm}{root} + \cnode*[linecolor=red](3,1.5){4pt}{A} + \cnode*[linecolor=red!72.5375!blue](3,0){4pt}{B} + \cnode*[linecolor=-red](3,-1.5){4pt}{C} + \psset{nodesep=3pt} + \ncline[linecolor=green!50!red]{root}{A} + \ncline[linecolor=blue]{root}{B} + \ncline[linecolor=-green!50!red]{root}{C} + \end{pspicture} +\end{SideBySideExample} +\end{figure} + +\begin{figure}[htb]\caption{Moving from one color to its complement; requires \textsf{pst-slpe}} +\begin{SideBySideExample}[fontsize=\footnotesize,xrightmargin=.45\textwidth] + \begin{pspicture}(4,1) + \psframe[fillstyle=slope, + slopeangle=30, + slopebegin=red!72.5375!blue, + slopeend=-red!72.5375!blue](4,1) + \end{pspicture} +\end{SideBySideExample} +\end{figure} + +\begin{figure}[htb]\caption{Explicit color specification via a loop command; requires \textsf{multido}} +\begin{SideBySideExample}[fontsize=\footnotesize,xrightmargin=.45\textwidth] + \psset{unit=1.75}% + \begin{pspicture}(0,-1)(2,1) + \multido{\rHue=0.00+0.01}{100}% + {\pscircle[linewidth=0.01, + linecolor={[hsb]{\rHue,1,1}}](1,0){\rHue}} + \end{pspicture} +\end{SideBySideExample} +\end{figure} + +\begin{figure}[htb]\caption{Color series --- modified version of an example from the \textsf{pst-fill} manual; note that the \texttt{\string\multirput} command does not give the desired result here} +\begin{SideBySideExample}[fontsize=\footnotesize,xrightmargin=.45\textwidth] + \newcommand*\Sheep + {\begin{pspicture}(3,1.5) + \pscustom[liftpen=2,fillstyle=solid,fillcolor=sheep!!+]% + {\pscurve(0.5,-0.2)(0.6,0.5)(0.2,1.3)(0,1.5)(0,1.5) + (0.4,1.3)(0.8,1.5)(2.2,1.9)(3,1.5)(3,1.5)(3.2,1.3) + (3.6,0.5)(3.4,-0.3)(3,0)(2.2,0.4)(0.5,-0.2)} + \pscircle*(2.65,1.25){0.12\psunit}% Eye + \psccurve*(3.5,0.3)(3.35,0.45)(3.5,0.6)(3.6,0.4)% Muzzle + \pscurve(3,0.35)(3.3,0.1)(3.6,0.05)% Mouth + \pscurve(2.3,1.3)(2.1,1.5)(2.15,1.7) + \pscurve(2.1,1.7)(2.35,1.6)(2.45,1.4)% Ear + \end{pspicture}} + \definecolorseries + {sheep}{rgb}{step}[rgb]{.95,.85,.55}{.17,.47,.37} + \resetcolorseries{sheep} + \psset{unit=0.4} + \begin{pspicture}(-3,-6)(0,7.5) + \Multido{\ry=6.0+-1.5}{5}% + {\rput(0,\ry){\Multido{}{5}{\Sheep}}} + \resetcolorseries{sheep}% + \multirput(-6,-6)(3,0)5{\Sheep} + \end{pspicture} +\end{SideBySideExample} +\end{figure} + +\begin{figure}[htb]\caption{Interaction with native PostScript code --- $\gamma$-corrected wavelengths} +\begin{Example}[fontsize=\footnotesize,xrightmargin=.45\textwidth] + \newcount\WL \unitlength.75pt + \def\WaveToPS#1% + {\definecolor{tmp}{wave}{#1}\extractcolorspec{tmp}\tmp + \expandafter\convertcolorspec\tmp{rgb}\tmp \expandafter\WaveToPSi\tmp,} + \def\WaveToPSi#1,#2,#3,{\pstVerb{/Red{#1}def /Green{#2}def /Blue{#3}def}} + \def\DisplayBar#1#2% + {\linethickness{1.25\unitlength}\WL=360 + \pstVerb{/Gamma{#1}def}% + \multiput(360,#2)(1,0){456}% + {\WaveToPS{\the\WL}{\color{lambda}\line(0,1){50}}\global\advance\WL1}% + \linethickness{0.25\unitlength}\WL=360 + \multiput(360,#2)(20,0){23}% + {\picture(0,0) + \line(0,-1){5}\multiput(5,0)(5,0){3}{\line(0,-1){2.5}}% + \put(0,-10){\makebox(0,0){\the\WL}}\global\advance\WL20 + \endpicture}% + \put(350,#2){\makebox(0,50)[r]{\small$\gamma$\,=\,#1}}} + \pstVerb{/Corr{dup 0 gt {Gamma exp}if}def} + \definecolor[ps]{lambda}{rgb}{Red Corr Green Corr Blue Corr}% + \begin{picture}(510,345)(310,-10) + \sffamily\tiny + \DisplayBar{0.4}{0}% + \DisplayBar{0.6}{70}% + \DisplayBar{0.8}{140}% + \DisplayBar{1.0}{210}% + \DisplayBar{1.2}{280}% + \end{picture} +\end{Example} +\end{figure} + +\end{document} +\endinput +%% +%% End of file `xcolor2.tex'. diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor3.tex b/Master/texmf-dist/doc/latex/xcolor/xcolor3.tex new file mode 100644 index 00000000000..a9e6dc0613b --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcolor/xcolor3.tex @@ -0,0 +1,131 @@ +%% +%% This is file `xcolor3.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% xcolor.dtx (with options: `test3') +%% +%% IMPORTANT NOTICE: +%% +%% For the copyright see the source file. +%% +%% Any modified versions of this file must be renamed +%% with new filenames distinct from xcolor3.tex. +%% +%% For distribution of the original source see the terms +%% for copying and modification in the file xcolor.dtx. +%% +%% This generated file may be distributed as long as the +%% original source files, as listed above, are part of the +%% same distribution. (The sources need not necessarily be +%% in the same archive or directory.) +%% +\ProvidesFile{xcolor3} + [2005/10/15 v2.06 Color logging test (UK)] +%% +%% ---------------------------------------------------------------- +%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de> +%% ---------------------------------------------------------------- +%% +\def\XCfileversion{v2.06}% +\def\XCfiledate{2005/10/15}% +\listfiles +\documentclass{article} +\usepackage[table,dvipsnames]{xcolor}[2005/03/24] + +\tracingcolors=4 +%%\tracingcolors=3 +%%\tracingcolors=2 +%%\tracingcolors=1 +%%\tracingcolors=0 + +\parindent0pt +\pagecolor{gray!25} + +\begin{document} +\title{Color extensions with the \textsf{xcolor} package --- log file example} +\author{Dr. Uwe Kern\thanks{This file is part of the \textsf{xcolor} distribution which can be downloaded from the CTAN mirrors (\texttt{macros/latex/contrib/xcolor/}) or the homepage \texttt{www.ukern.de/tex/xcolor.html}. Please send error reports and suggestions for improvements to \texttt{xcolor@ukern.de}.}} +\date{\XCfileversion{} (\XCfiledate)} +\maketitle + +The purpose of this file is to demonstrate the logging facilities of the \textsf{xcolor} package. +By playing around with different values of \texttt{\string\tracingcolors}, one can observe the different behavior in the \texttt{log} file. + +\bigskip +Table example: +\rowcolors[\hline]{1}{green!25}{yellow!50} +\begin{tabular}{ll} +test & row \number\rownum\\ +test & row \number\rownum\\ +\rowcolor{blue!25} +test & row \number\rownum\\ +test & row \number\rownum\\ +\hiderowcolors +test & row \number\rownum\\ +test & row \number\rownum\\ +\showrowcolors +test & row \number\rownum\\ +test & row \number\rownum\\ +\multicolumn{1}% + {>{\columncolor{red!12}}l}{test} & row \number\rownum\\ +\end{tabular} + +\bigskip +\providecolor{dummy}{rgb}{.6,.5,.4} +\definecolor{dummy}{rgb}{.6,.5,.4} +\providecolor{dummy}{rgb}{.6,.5,.4} +\hbox{\textcolor{dummy}{Test with \texttt{\string\definecolor}}} + +{\color[rgb]{.4,.5,.6}Test with \texttt{\string\color}} + +\bigskip +Current color application:\par +\def\test{current, \textcolor{.!50}{50\%}, \textcolor{-.}{complement}, + \textcolor{yellow!50!.}{mix}} +\textcolor{blue}{\test} and \textcolor{red}{\test},\par +\def\Test{\color{.!80}Test} +\textcolor{blue}{\Test\Test\Test\Test\Test} and +\textcolor{red}{\Test\Test\Test\Test\Test}. + +\bigskip +Current color test with \texttt{\string\definecolorseries}:\par +\begingroup +\color{blue} +\definecolorseries{foo}{rgb}{last}{.}{-.} +\resetcolorseries[5]{foo} +\def\test{\hbox to 1em{{\color{foo!!+}\vrule width 1em height 1.5ex}}} +Test\test\test\test\test\test\test Test + +\resetcolorseries[5]{foo} +\def\test{\hbox to 1em{{\color{foo!!++}\vrule width 1em height 1.5ex}}} +Test\test\test\test\test\test\test Test + +\resetcolorseries[5]{foo} +\def\test{\hbox to 1em{{\color{foo!![2]}\vrule width 1em height 1.5ex}}} +Test\test\test\test\test\test\test Test + +\bigskip +\color{black} +Test with named colors:\par +\color{blue} +Test: \textcolor[named]{JungleGreen}{JungleGreen}; +Test: \textcolor{JungleGreen}{JungleGreen}; +Test: \textcolor{JungleGreen!50!DarkOrchid}{JungleGreen!50!DarkOrchid}; +Test: \textcolor{green!50!red}{green!50!red}. +\endgroup + +Type test: +\makeatletter +\@namedef{\string\color@foo1}{foo1{}{}{}{}}\edef\tempa{\XC@type{foo1}}\tempa +\@namedef{\string\color@foo2}{\xcolor@{foo2}{}{}{}}\edef\tempb{\XC@type{foo2}}\tempb +\@namedef{\string\color@foo3}{\xcolor@{}{foo3}{}{}}\edef\tempc{\XC@type{foo3}}\tempc +\@namedef{\string\color@foo4}{\xcolor@{}{}{foo4}{}}\edef\tempd{\XC@type{foo4}}\tempd +\makeatother + +\textcolor{rgb:red!50,4;green!25,2}{Extended color expression (rgb:red!50,4;green!25,2)}. + +\end{document} +\endinput +%% +%% End of file `xcolor3.tex'. diff --git a/Master/texmf-dist/doc/latex/xcolor/xcolor4.tex b/Master/texmf-dist/doc/latex/xcolor/xcolor4.tex new file mode 100644 index 00000000000..17d14c18a4a --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcolor/xcolor4.tex @@ -0,0 +1,131 @@ +%% +%% This is file `xcolor4.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% xcolor.dtx (with options: `test4') +%% +%% IMPORTANT NOTICE: +%% +%% For the copyright see the source file. +%% +%% Any modified versions of this file must be renamed +%% with new filenames distinct from xcolor4.tex. +%% +%% For distribution of the original source see the terms +%% for copying and modification in the file xcolor.dtx. +%% +%% This generated file may be distributed as long as the +%% original source files, as listed above, are part of the +%% same distribution. (The sources need not necessarily be +%% in the same archive or directory.) +%% +\ProvidesFile{xcolor4} + [2005/10/15 v2.06 Color driver test (UK)] +%% +%% ---------------------------------------------------------------- +%% Copyright (C) 2003-2005 by Dr. Uwe Kern <xcolor at ukern dot de> +%% ---------------------------------------------------------------- +%% +\def\XCfileversion{v2.06}% +\def\XCfiledate{2005/10/15}% +\listfiles +\documentclass[a4paper]{article} +\usepackage{xcolor} +%%\usepackage[dvipdf]{xcolor} +%%\usepackage[dvipdfm]{xcolor} +%%\usepackage[dvipdfmx]{xcolor} +%%\usepackage[dvips]{xcolor} +%%\usepackage[dvipsone]{xcolor} +%%\usepackage[dviwin]{xcolor} +%%\usepackage[emtex]{xcolor} +%%\usepackage[pctex32]{xcolor} +%%\usepackage[pctexhp]{xcolor} +%%\usepackage[pctexps]{xcolor} +%%\usepackage[pctexwin]{xcolor} +%%\usepackage[pdftex]{xcolor} +%%\usepackage[tcidvi]{xcolor} +%%\usepackage[textures]{xcolor} +%%\usepackage[truetex]{xcolor} +%%\usepackage[vtex]{xcolor} +%%\usepackage[xetex]{xcolor} +%%\usepackage[dviwindo]{xcolor} +%%\usepackage[oztex]{xcolor} +%%\usepackage[xdvi]{xcolor} +\usepackage[margin=1.25cm,noheadfoot]{geometry} +\pagestyle{empty} +\parindent0pt +\nofiles +\let\familydefault\sfdefault +\begin{document} +\vbox to\textheight{\vss\centering +{\Large\textbf{xcolor} driver test: `\csname XC@@drv\endcsname'} +\vskip0.5cm +\begin{testcolors}[rgb,hsb,cmyk,gray,HTML] +\testcolor{magenta} +\testcolor[rgb]{1,0,1} +\testcolor[hsb]{0.83333,1,1} +\testcolor[cmyk]{0,1,0,0} +\testcolor[gray]{0.41} +\noalign{\medskip} +\testcolor{blue} +\testcolor[rgb]{0,0,1} +\testcolor[hsb]{0.66667,1,1} +\testcolor[cmyk]{1,1,0,0} +\testcolor[gray]{0.11} +\testcolor[wave]{440} +\noalign{\medskip} +\testcolor{cyan} +\testcolor[rgb]{0,1,1} +\testcolor[hsb]{0.5,1,1} +\testcolor[cmyk]{1,0,0,0} +\testcolor[gray]{0.7} +\testcolor[wave]{490} +\noalign{\medskip} +\testcolor{green} +\testcolor[rgb]{0,1,0} +\testcolor[hsb]{0.33333,1,1} +\testcolor[cmyk]{1,0,1,0} +\testcolor[gray]{0.59} +\testcolor[wave]{510} +\noalign{\medskip} +\testcolor{yellow} +\testcolor[rgb]{1,1,0} +\testcolor[hsb]{0.16667,1,1} +\testcolor[cmyk]{0,0,1,0} +\testcolor[gray]{0.89} +\testcolor[wave]{580} +\noalign{\medskip} +\testcolor{red} +\testcolor[rgb]{1,0,0} +\testcolor[hsb]{0,1,1} +\testcolor[cmyk]{0,1,1,0} +\testcolor[gray]{0.3} +\testcolor[wave]{645} +\noalign{\medskip} +\testcolor{black} +\testcolor[rgb]{0,0,0} +\testcolor[hsb]{0,0,0} +\testcolor[cmyk]{0,0,0,1} +\testcolor[gray]{0} +\noalign{\medskip} +\testcolor{gray} +\testcolor[rgb]{0.5,0.5,0.5} +\testcolor[hsb]{0,0,0.5} +\testcolor[cmyk]{0,0,0,0.5} +\testcolor[gray]{0.5} +\noalign{\medskip} +\testcolor{white} +\testcolor[rgb]{1,1,1} +\testcolor[hsb]{0,0,1} +\testcolor[cmyk]{0,0,0,0} +\testcolor[gray]{1} +\end{testcolors} +\vskip0.5cm +{\footnotesize This table was generated with \textbf{xcolor4.tex} which is part of the \textbf{xcolor} package \XCfileversion{} (\XCfiledate) by Uwe Kern.} +\vss} +\end{document} +\endinput +%% +%% End of file `xcolor4.tex'. |