From 5ab17f932f63c1c6cded36de80cf157042a05d5d Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 16 Jun 2015 21:22:12 +0000 Subject: colorspace (1jun15) git-svn-id: svn://tug.org/texlive/trunk@37573 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/colorspace/README | 22 ++-- .../texmf-dist/doc/latex/colorspace/colorspace.pdf | Bin 96854 -> 104967 bytes .../texmf-dist/doc/latex/colorspace/colorspace.tex | 122 ++++++++++++++++++--- 3 files changed, 114 insertions(+), 30 deletions(-) (limited to 'Master/texmf-dist/doc/latex/colorspace') 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 Binary files a/Master/texmf-dist/doc/latex/colorspace/colorspace.pdf and b/Master/texmf-dist/doc/latex/colorspace/colorspace.pdf 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} -- cgit v1.2.3