summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/colorspace
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-06-16 21:22:12 +0000
committerKarl Berry <karl@freefriends.org>2015-06-16 21:22:12 +0000
commit5ab17f932f63c1c6cded36de80cf157042a05d5d (patch)
tree95245ad0e9e3c7113caa84ecb9544a1016829d2a /Master/texmf-dist/doc/latex/colorspace
parent1533fd06f8be031b9db6baf261cd9931923ae063 (diff)
colorspace (1jun15)
git-svn-id: svn://tug.org/texlive/trunk@37573 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/colorspace')
-rw-r--r--Master/texmf-dist/doc/latex/colorspace/README22
-rw-r--r--Master/texmf-dist/doc/latex/colorspace/colorspace.pdfbin96854 -> 104967 bytes
-rw-r--r--Master/texmf-dist/doc/latex/colorspace/colorspace.tex122
3 files changed, 114 insertions, 30 deletions
diff --git a/Master/texmf-dist/doc/latex/colorspace/README b/Master/texmf-dist/doc/latex/colorspace/README
index f5c998bc9f0..8f6fbab7dce 100644
--- a/Master/texmf-dist/doc/latex/colorspace/README
+++ b/Master/texmf-dist/doc/latex/colorspace/README
@@ -1,25 +1,23 @@
colorspace
-----------
-PDF color spaces. Currently, only spot colors and overprinting are
-supported (requires xcolor; only pdftex and luatex). To define a spot
-color, just say:
+PDF color spaces. Currently, it supports:
-\definespotcolor{foo}{BarTone 555 GN}{.3, .4, .5, .6}
+* spot colors
+* mixing inks (spot and process), up to 4
+* ICC based default CMYK, RGB and Gray spaces
+* overprinting
-That's all. You can use tints as usual in xcolor, like:
+It requires xcolor and currently only pdftex and luatex.
-\color{foo!60}
-\colorlet{foo60}{foo!60}
+For example, to define a spot color, just say:
-and even set tints from other tints. It seems to work with tikz.
+\definespotcolor{foo}{BarTone 555 GN}{.3, .4, .5, .6}
-Mixing spot colors (with process colors or other spots colors) and
-other functions related to the PDF color spaces (like indexed colors)
-are not yet suported, but they are under study.
+That's all.
Those docs, like the package itself, are still somewhat tentative, but
the basic behaviour described here will be preserved in future
versions.
-2015-05-11 \ No newline at end of file
+2015-06-01 \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/colorspace/colorspace.pdf b/Master/texmf-dist/doc/latex/colorspace/colorspace.pdf
index 7ea9c65501a..52984c76f63 100644
--- a/Master/texmf-dist/doc/latex/colorspace/colorspace.pdf
+++ b/Master/texmf-dist/doc/latex/colorspace/colorspace.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/colorspace/colorspace.tex b/Master/texmf-dist/doc/latex/colorspace/colorspace.tex
index 86cc87e25ce..eae643f99a8 100644
--- a/Master/texmf-dist/doc/latex/colorspace/colorspace.tex
+++ b/Master/texmf-dist/doc/latex/colorspace/colorspace.tex
@@ -21,34 +21,39 @@
%% This work consists of the files colorspace.tex and colorspace.sty.
\documentclass{article}
-\title{\textsf{colorspace}\\\large Version 1.0.0}
+\title{\textsf{colorspace}\\\large Version 1.1.0}
\author{Javier Bezos\\\texttt{http://www.tex-tipografia.com}}
\raggedright
\parskip=1ex
-\date{2015-05-11}
+\date{2015-06-01}
\begin{document}
\maketitle
-This package is essentially a reworking of the previous attempts to
-provide spot colors and other additional features by Jens Elstner,
-Stephan Lehmke and Siep Kroonenberg (with some inspiration from
-\textsf{ConTeXt}, too). It requires \textsf{xcolor}, which is loaded
-if it has not been before.
+This package is built on the previous attempts to provide spot colors
+and other additional features by Jens Elstner, Stephan Lehmke and Siep
+Kroonenberg (with some inspiration from \textsf{ConTeXt}, too). It
+requires \textsf{xcolor}, which is loaded if it has not been before.
-It provides a clean user interface, with a single command for
-defining a spot color. It seems to work with \textsf{tikz}. Currently
-only \textsf{pdftex} and \textsf{luatex} are supported. Mixing spot
-colors (with process colors or other spots colors) and other functions
-related to the PDF color spaces (like indexed colors) are not yet
-suported, but they are\texttt{} under study.
+It provides a clean user interface, with a single command for defining
+a spot color. It seems to work with \textsf{tikz}. Currently only
+\textsf{pdftex} and \textsf{luatex} are supported.
-Those docs, like the package itself, are still somewhat tentative, but
-the basic behaviour described here will be preserved in future versions.
+Mixing spot colors (with process colors or other spots colors) is
+supported to some extent (see below). You can also assign ICC profiles
+to the default CMYK, RGB and Gray spaces. Other functions related to
+the PDF color spaces (indexed, calibrated, Lab spaces) are not yet
+suported, but they are\texttt{} under study. They apply to text and
+line art only, not external images. Declarations are global. Using
+\verb|\selectcolormodel| does not work yet.
+
+Those docs, like the package itself, are still somewhat tentative (as
+you very likely have noticed), but the basic behaviour described here
+will be preserved in future versions.
For transparencies, see \textsf{transparent}, by Heiko Oberdiek.
@@ -71,9 +76,7 @@ You can use tints as usual in \textsf{xcolor}, like:
\color{foo!60}
\colorlet{foo60}{foo!60}
\end{verbatim}
-and even set tints from other tints, but this is the only operation
-currently supported. Something like \verb|spot!10!black| (mixing inks)
-does not work.
+and even set tints from other tints. To mix inks, see below.
The special PDF names \verb|All| (for all plates) and \verb|None| work
as expected:
@@ -94,6 +97,89 @@ set something like:
\end{verbatim}
(It can be empty.) To return to the default color space, which
contains all the defined spot colors, use \verb|\resetpagecolorspace|.
+Use this macro with care, because of the asynchronous nature of \TeX{}
+-- remember it affects the whole current page.
+
+\section{Mixing spot colors}
+
+To mix spot colors you must first declare a color space (or model)
+including them. This is done with something like:
+\begin{verbatim}
+\definecolorspace{name}{mixed}{color1,color2,color3}
+\end{verbatim}
+(The second argument is the type of color space.) For example, if we
+have two spot colors named \verb|spot1| and \verb|spot2|, and we want
+in addition yellow:
+\begin{verbatim}
+\definecolorspace{spot12y}{mixed}{spot1,spot2,yellow}
+\end{verbatim}
+A typical usage, for shades, would be:
+\begin{verbatim}
+\definecolorspace{shaded1}{mixed}{spot1,black}
+\end{verbatim}
+
+Due to internal limitations of \textsf{xcolor}, no more than four
+colors are allowed. The alternate color space in the PDF file is that
+of the spot colors (which means currently it is CMYK).
+
+Then, you can define a color with:
+\begin{verbatim}
+\definecolor{mix12y}{spot12y}{.5,.4,.6}
+\definecolor{sh1}{shaded1}{.6,.3}
+\end{verbatim}
+or set it with
+\begin{verbatim}
+\color[spot12y]{.5,.4,.3}
+\color[shaded1]{.6,.3}
+\end{verbatim}
+As in spot colors, the only operation allowed is \verb|!| for tints
+(ie, \verb|color!num|). But there is an easy trick to mix colors with
+\verb|!| and \verb|color,num| -- just define an ortogonal set of
+colors based on the new color model:
+\begin{verbatim}
+\definecolor{xspot1}{spot12y}{1,0,0}
+\definecolor{xspot2}{spot12y}{0,1,0}
+\definecolor{xyellow}{spot12y}{0,0,1}
+\end{verbatim}
+and then you can say:
+\begin{verbatim}
+\color{xspot1!30!xspot2!40!xyellow}
+\color{spot12y:xspot1,3;xspot2,2;xyellow,1}
+\end{verbatim}
+Of course, it is just a trick and a better and direct interface is
+under study.
+
+Color series are also partially supported. For example:
+\begin{verbatim}
+\definecolorseries{test}{spot12y}{grad}[spot12y]{.95,.85,.55}{3,11,17}
+\definecolorseries{test}{spot12y}{last}{xyellow!50}{xspotA}
+\end{verbatim}
+
+(The key is not to mix the new model with other color models.)
+
+\section{ICC Based spaces}
+
+The starred version \verb|\definecolorspace*| does not define a new
+color model, but sets the behaviour of the three basic color spaces
+(\verb|cmyk|, \verb|rgb| and \verb|gray|). When belonging to the same
+space, the last one for that space takes precedence. It cannot be used
+to define new colors or set them. Currently, only a type is supported --
+\verb|iccbased|. For example,
+\begin{verbatim}
+\definecolorspace*{sRGB}{iccbased}{sRGB Profile.icc}
+\end{verbatim}
+
+The space it applies to is read from the ICC profile. The name can be
+used in \verb|\pagecolorspace| (and must, if you want it to be
+active). Alternatively, there are 3 reserved names: \verb|*rgb|,
+\verb|*gray|, \verb|*cmyk|, which stand for the current default
+spaces. The former are not set by \verb|\resetpagecolorspace|, but the
+starred named are.
+
+Note those ICC spaces does not go to the output intent dictionary (see
+the \textsf{pdfx} package). The latter, as the PDF reference explains,
+supplements rather than replaces the ICC profiles in a default color
+space.
\section{Overprinting}