pst-cie MAKEpst

git-svn-id: svn://tug.org/texlive/trunk@41223 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 525 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/generic/pst-cie/Changes b/Master/texmf-dist/doc/generic/pst-cie/Changes
new file mode 100644
index 00000000000..7b69fdb0ade
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-cie/Changes
@@ -0,0 +1,28 @@
+
+..... pst-cie.tex
+1.05  2016-05-16  - split pro file into two files
+1.04  2016-05-15  - define \pstCIEContour as ClosedObj
+                  - fixed bug with scaling
+1.03  2016-04-26  - use always the internal area 0..1
+1.02  2016-04-25  - added support of Planckian locus
+                  - \pstPlanck
+                  - \pstCIEcontour
+1.01  2016-04-18  - initial version
+
+..... pst-cie.pro
+1.05  2016-05-16  - extract the data part to make it more
+                    maintainable
+1.04  2016-05-01  - fixed bug with scaling
+1.03  2016-04-25  - deleted tabxy
+1.02  2016-04-24  - added support of Planckian locus
+1.01  2016-04-18  initial version
+
+..... pst-cie-data.pro
+0.01  2016-05-16  - the data arrays
+
+..... pst-cie.sty
+      2016-04-18  first version
+
+..... pst-cie-doc.tex
+2016-04-18  initial version
+
diff --git a/Master/texmf-dist/doc/generic/pst-cie/README.md b/Master/texmf-dist/doc/generic/pst-cie/README.md
new file mode 100644
index 00000000000..30067125116
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-cie/README.md
@@ -0,0 +1,24 @@
+# CIE color space #
+
+Save the files pst-cie.sty|tex|pro in a directory, which is part of your 
+local TeX tree. The pro file should go into $TEXMF/dvips/pstricks/
+Then do not forget to run texhash to update this tree.
+For more information  see the documentation of your LATEX distribution 
+on installing packages into your local TeX system or read the 
+TeX Frequently Asked Questions:
+(http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages).
+
+PSTricks is PostScript Tricks, the documentation cannot be run
+with pdftex, use the sequence latex->dvips->ps2pdf or xelatex.
+
+pst-cie is a PSTricks related package to show the different
+CIE color spaces: 
+
+- Adobe, 
+- CIE, 
+- ColorMatch, 
+- NTSC, 
+- Pal-Secam,
+- ProPhoto, 
+- SMPTE, and 
+- sRGB.
diff --git a/Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.bib b/Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.bib
new file mode 100644
index 00000000000..0302427234f
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.bib
@@ -0,0 +1,86 @@
+@STRING{dtk	= {{D}ie {\TeX}nische {K}om{\"o}die} }
+
+@Book{Seve,
+  Author         = {Robert Sève},
+  Title          = {Physique de la couleur -- De l'apparence colorée à la technique colorimétrique},
+  Publisher      = {Masson},
+  Address        = {Paris},
+  date           = 1996,
+}
+@Book{PostScript,
+  Author         = {Kollock, Nikolai G.},
+  Title          = {PostScript richtig eingesetzt: vom Konzept zum
+                   praktischen Einsatz},
+  Publisher      = {IWT},
+  Address        = {Vaterstetten},
+  year           = 1989,
+}
+
+@Manual{pstricks,
+  Title          = {PSTricks - {\PS} macros for Generic TeX},
+  Author         = {Timothy Van Zandt},
+  Address        = {\url{http://www.tug.org/application/PSTricks}},
+  year           = 1993,
+}
+
+
+@Manual{vue3d:2002,
+  Title          = {PSTricks application},
+  Author         = {Manuel Luque},
+  url        = {http://pstricks.blogspot.de},
+  year           = 2016,
+}
+
+@Article{dtk02.2:jackson.voss:plot-funktionen,
+  author	= {Laura E. Jackson and Herbert Vo{\ss}},
+  title		= {Die {P}lot-{F}unktionen von {\texttt{pst-plot}}},
+  journal	= dtk,
+  year		= 2002,
+  volume	= {2/02},
+  altvolume	= 2,
+  altnumber	= 14,
+  month		= jun,
+  pages		= {27--34},
+  annote	= bretter,
+}
+
+@Article{dtk02.1:voss:mathematischen,
+  author	= {Herbert Vo{\ss}},
+  title		= {Die mathematischen {F}unktionen von {P}ostscript},
+  journal	= dtk,
+  year		= 2002,
+  volume	= {1/02},
+  altvolume	= 1,
+  altnumber	= 14,
+  month		= mar,
+  pages		= {40-47},
+  annote	= bretter,
+}
+
+@Book{tlgc2,
+  author	= {Michel Goosens and Frank Mittelbach and Sebastian Rahtz and Denis Roegel and Herbert Vo{\ss}},
+  title		= {The {\LaTeX} {G}raphics {C}ompanion},
+  publisher	= {{Addison-Wesley Publishing Company}},
+  edition	= {2},
+  year		= {2007},
+  address	= {Reading, Mass.}
+}
+
+
+@Book{PSTricks2,
+  author	= {Herbert Voß},
+  title		= {\texttt{PSTricks} -- {G}raphics for \TeX{} and \LaTeX},
+  edition	= {1},
+  publisher	= {UIT},
+  year		= {2011},
+  address	= {Cambridge}
+}
+
+@Book{voss:ref,
+  author	= {Herbert Voß},
+  title		= {\LaTeX\ quick reference},
+  publisher	= {UIT},
+  year		= {2011},
+  address	= {Cambridge}
+}
+
diff --git a/Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.pdf b/Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.pdf
new file mode 100644
index 00000000000..b85e6920d02
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.pdf
diff --git a/Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.tex b/Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.tex
new file mode 100644
index 00000000000..c3604139871
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.tex
@@ -0,0 +1,387 @@
+%% $Id: pst-cie-doc.tex 300 2016-05-05 19:05:57Z herbert $
+\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings,
+    headexclude,footexclude,oneside]{pst-doc}
+\listfiles
+
+\usepackage[utf8]{inputenc}
+\usepackage{pst-cie}
+\let\pstFV\fileversion
+\def\bgImage{\resizebox{7cm}{!}{\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[Planck,bgcolor=yellow!100!black!20,textcolor=black!70,ColorSpace=Pal-Secam]
+\rput(5.5,8){\textbf{Pal-Secam}}
+\end{pspicture}}}
+\lstset{explpreset={pos=l,width=-99pt,overhang=0pt,hsep=\columnsep,vsep=\bigskipamount,rframe={}}}
+\usepackage[style=dtk]{biblatex}
+\addbibresource{\jobname.bib}
+
+\def\tabCIE{%
+\begin{tabular}{|c|c|c|c|c|}
+\cline{2-5} \multicolumn{1}{c|}{} & Red      & Green   & Blue  & White \\\hline
+x&0.7355&0.2658&0.1669&0.3333\\\hline
+y&0.2645&0.7243&0.0085&0.3333\\\hline
+\end{tabular}%
+}
+\def\tabsRGB{%
+\begin{tabular}{|c|c|c|c|c|}\cline{2-5} 
+\multicolumn{1}{c|}{} & Red      & Green   & Blue  & White \\\hline
+x&0.6400&0.3000&0.1500&0.3127\\\hline
+y&0.3300&0.6000&0.0600&0.3290\\\hline
+\end{tabular}%
+}
+\def\tabSMPTE{%
+\begin{tabular}{|c|c|c|c|c|}\cline{2-5} 
+\multicolumn{1}{c|}{} & Red      & Green   & Blue  & White \\\hline
+x&0.6300&0.3100&0.1500&0.3127\\\hline
+y&0.3400&0.5950&0.0700&0.3290\\\hline
+\end{tabular}%
+}
+\def\tabAdobe{%
+\begin{tabular}{|c|c|c|c|c|}\cline{2-5} 
+\multicolumn{1}{c|}{} & Red      & Green   & Blue  & White \\\hline
+x&0.6400&0.2100&0.1500&0.3127\\\hline
+y&0.3300&0.7150&0.0600&0.3290\\\hline
+\end{tabular}%
+}
+\def\tabColorMatch{%
+\begin{tabular}{|c|c|c|c|c|}\cline{2-5} 
+\multicolumn{1}{c|}{} & Red      & Green   & Blue  & White \\\hline
+x&0.6300&0.2950&0.1500&0.3457\\\hline
+y&0.3400&0.6050&0.0750&0.3585\\\hline
+\end{tabular}%
+}
+\def\tabProPhoto{%
+\begin{tabular}{|c|c|c|c|c|}\cline{2-5} 
+\multicolumn{1}{c|}{} & Red      & Green   & Blue  & White \\\hline
+x&0.7347&0.1596&0.0366&0.3457\\\hline
+y&0.2653&0.8404&0.0001&0.3585\\\hline
+\end{tabular}%
+}
+\def\tabPal-Secam{%
+\begin{tabular}{|c|c|c|c|c|}\cline{2-5} 
+\multicolumn{1}{c|}{} & Red      & Green   & Blue  & White \\\hline
+x&0.6400&0.2900&0.1500&0.3127\\\hline
+y&0.3300&0.6000&0.0600&0.3290\\\hline
+\end{tabular}%
+}
+\def\tabNTSC{%
+\begin{tabular}{|c|c|c|c|c|}\cline{2-5} 
+\multicolumn{1}{c|}{} & Red      & Green   & Blue  & White \\\hline
+x&0.6700&0.2100&0.1400&0.3101\\\hline
+y&0.3300&0.7100&0.0800&0.3162\\\hline
+\end{tabular}%
+}
+
+\begin{document}
+\title{\texttt{pst-cie}: CIE xy chromaticity space\\
+\small v.\pstFV}
+%\docauthor{}
+\author{Manuel Luque\\Herbert Voß}
+\maketitle
+
+
+\section{Introductionj}
+
+
+
+
+Using data (CIE XYZ CIE XYZ 1931 and 1964)
+from the International Commission on Illumination (Commission internationale de l’éclairage)
+the package \LPack{pst-cie}  proposes to represent the color table and / or the chromaticity diagram for 
+different color spaces. Web page devoted to studies and performances diagrams and chromaticity 
+tables are numerous and it is difficult to distinguish one over another, 
+however here are some important informations:  
+\href{http://www.f-legrand.fr/scidoc/docmml/index.html}{Frédéric Legrand} 
+devoted to colorimetry, and those of Daniel Metz. Yu-Chang Sung realized with the software 
+\textsf{Mathematica} an interactive version of beauty: 
+\href{http://demonstrations.wolfram.com/CIEChromaticityDiagram/}{CIEChromaticityDiagram}
+as I do not own this software I tried to do pretty much the same with PSTricks, or at least 
+having almost the same functionality.
+
+The macro \Lcs{psChromaticityDiagram}\OptArgs supports the following optional arguments:
+
+\bigskip
+% \small\let\tbs\textbackslash
+\newcommand*\titretab[1]{\multicolumn{1}{c}{\emph{#1}}}
+\noindent
+\begin{tabularx}{\linewidth}{@{}l>{\ttfamily}llX@{}}
+  \toprule
+  \titretab{Option} & \titretab{Type} & \titretab{Défaut}
+& \titretab{Description}
+\\\toprule
+\Lkeyword{gamma}      & number   &2.2 & color correction\\
+\Lkeyword{contrast} &number   &1  & 0<contrast<=1 \\
+\Lkeyword{ColorSpace}        &name  & sRGB & colorspace \\
+\Lkeyword{datas}        &name  &CIE1931 & CIE\\
+\Lkeyword{primaries} &boolean & true & show primary points\\
+\Lkeyword{trianglecolor}   & color & black & color of the triangle \\
+\Lkeyword{bgcolor}   & color & black & background color \\
+\Lkeyword{textcolor} & color & white & textcolor \\
+\Lkeyword{Planck} & boolean & false & draw the Planck' locus \\ 
+\Lkeyword{showcontour} & boolean & false & \sloppy show the contour of the color space, only useful for using \Lcs{pstPlanck}.\\
+\Lkeyword{Tfontsize} & length & 4pt & fontsize for the temperature of the Planck curve\\
+\Lkeyword{unit}      & number & 1 & unit depending to the default size of 10cm$\times$10cm\\
+\Lkeyword{PSfont}    & PS font & Helvetica-Bold & \\
+\Lkeyword{fontscale} & 5 & PS font scale in pt\\
+\bottomrule
+\end{tabularx}
+
+\bigskip
+The color spaces which are available are: \Lkeyval{Adobe}, 
+\Lkeyval{CIE}, 
+\Lkeyval{ColorMatch}, 
+\Lkeyval{NTSC}, 
+\Lkeyval{Pal-Secam}, 
+\Lkeyval{ProPhoto}, 
+\Lkeyval{SMPTE}, and 
+\Lkeyval{sRGB}.
+
+Tabulated values available are those of the CIE XYZ 1931 and the CIE XYZ 1964.
+A low value of the contrast will highlight the work area of 
+the system displayed the colors it can represent, it is the triangle 
+with vertices the points of primary colors included in the 
+\emph{Iron horse} which represents all the colors visible to the human eye.
+
+
+\section{Examples}
+\begin{center}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram
+\rput(5.5,8){\white \textbf{Colorspace sRGB}}
+\rput(4,10){\tabsRGB}
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram
+\rput(5.5,8){\white \textbf{Colorspace sRGB}}
+\rput(4,10){\tabsRGB}
+\end{pspicture}
+\end{verbatim}
+\end{center}
+
+
+
+
+\begin{center}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[Planck,trianglecolor=black]
+\rput(5.5,8){\white \textbf{Colorspace sRGB}}
+\rput(4,10){\tabsRGB}
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[Planck,trianglecolor=black]
+\rput(5.5,8){\white \textbf{Colorspace sRGB}}
+\rput(4,10){\tabsRGB}
+\end{pspicture}
+\end{verbatim}
+\end{center}
+
+\begin{center}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[datas=CIE1964,ColorSpace=Adobe,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace Adobe}}
+\rput(4,10){\tabAdobe}
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[datas=CIE1964,ColorSpace=Adobe,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace Adobe}}
+\rput(4,10){\tabAdobe}
+\end{pspicture}
+\end{verbatim}
+
+
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[Planck,bgcolor=black!40,datas=CIE1964,
+                       ColorSpace=Adobe,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace Adobe}}
+\rput(4,10){\tabAdobe}
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[Planck,bgcolor=black!40,datas=CIE1964,
+                       ColorSpace=Adobe,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace Adobe}}
+\rput(4,10){\tabAdobe}
+\end{pspicture}
+\end{verbatim}
+
+
+\end{center}
+
+\begin{center}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=ProPhoto,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace ProPhoto}}
+\rput(4,10){\tabProPhoto}
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=ProPhoto,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace ProPhoto}}
+\rput(4,10){\tabProPhoto}
+\end{pspicture}
+\end{verbatim}
+\end{center}
+
+\begin{center}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=ColorMatch,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace ColorMatch}}
+\rput(4,10){\tabColorMatch}
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=ColorMatch,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace ColorMatch}}
+\rput(4,10){\tabColorMatch}
+\end{pspicture}
+\end{verbatim}
+\end{center}
+
+\begin{center}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=NTSC,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace NTSC}}
+\rput(4,10){\tabNTSC}
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=NTSC,contrast=0.1]
+\rput(5.5,8){\white \textbf{Colorspace NTSC}}
+\rput(4,10){\tabNTSC}
+\end{pspicture}
+\end{verbatim}
+\end{center}
+
+\begin{center}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=CIE]
+\rput(5.5,8){\white \textbf{Colorspace CIE}}
+\rput(4,10){\tabCIE}
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=CIE]
+\rput(5.5,8){\white \textbf{Colorspace CIE}}
+\rput(4,10){\tabCIE}
+\end{pspicture}
+\end{verbatim}
+\end{center}
+
+\begin{center}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=Pal-Secam]
+\rput(5.5,8){\white \textbf{Colorspace Pal-Secam}}
+\rput(4,10){\tabPal-Secam}
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[ColorSpace=Pal-Secam]
+\rput(5.5,8){\white \textbf{Colorspace Pal-Secam}}
+\rput(4,10){\tabPal-Secam}
+\end{pspicture
+\end{verbatim}
+
+
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[bgcolor=yellow!100!black!20,textcolor=black!70,ColorSpace=Pal-Secam]
+\rput(5.5,8){\white\textbf{Colorspace Pal-Secam}}
+\end{pspicture}
+
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(8.5,11)
+\psChromaticityDiagram[bgcolor=yellow!100!black!20,
+               textcolor=black!70,ColorSpace=Pal-Secam]
+\rput(5.5,8){\white\textbf{Colorspace Pal-Secam}}
+\end{pspicture}
+\end{verbatim}
+
+\begin{pspicture}(-1,-1)(10,10)
+\psaxes[Dx=0.1,dx=1,Dy=0.1,dy=1]{->}(0,0)(10,10)[$x$,-90][$y$,0]
+\pstPlanck[showcontour]
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(10,10)
+\psaxes[Dx=0.1,dx=1,Dy=0.1,dy=1]{->}(0,0)(10,10)[$x$,-90][$y$,0]
+\pstPlanck[showcontour]
+\end{pspicture}
+\end{verbatim}
+
+
+\clearpage
+
+\makeatletter
+\begin{pspicture}(-1,-1)(10,10)
+\psaxes[Dx=0.1,dx=1,Dy=0.1,dy=1]{->}(0,0)(10,10)[$x$,-90][$y$,0]
+\pstCIEcontour[linecolor=blue]%
+\pstCIEcontour[datas=CIE1964,linestyle=dashed]%
+\end{pspicture}
+\makeatother
+
+\begin{verbatim}
+\makeatletter
+\begin{pspicture}(-1,-1)(10,10)
+\psaxes[Dx=0.1,dx=1,Dy=0.1,dy=1]{->}(0,0)(10,10)[$x$,-90][$y$,0]
+\pstCIEcontour[linecolor=blue]%
+\pstCIEcontour[datas=CIE1964,linestyle=dashed]%
+\end{pspicture}
+\makeatother
+\end{verbatim}
+
+\begin{pspicture}(-1,-1)(15,15)
+\psChromaticityDiagram[unit=1.5,contrast=0.5]%
+\pstPlanck[unit=1.5]
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(15,15)
+\psChromaticityDiagram[unit=1.5,contrast=0.5]%
+\pstPlanck[unit=1.5]
+\end{pspicture}
+\end{verbatim}
+
+
+\begin{pspicture}(-1,-1)(15,15)
+\psaxes[Dx=0.2,dx=3,Dy=0.2,dy=3,
+  labelFontSize=\scriptscriptstyle]{->}(0,0)(15,15)[$x$,-90][$y$,0]
+\pstCIEcontour[unit=1.5,linecolor=blue]%
+\end{pspicture}
+
+\begin{verbatim}
+\begin{pspicture}(-1,-1)(15,15)
+\psaxes[Dx=0.2,dx=3,Dy=0.2,dy=3,
+  labelFontSize=\scriptscriptstyle]{->}(0,0)(15,15)[$x$,-90][$y$,0]
+\pstCIEcontour[unit=1.5,linecolor=blue]%
+\end{pspicture}
+\end{verbatim}
+
+\end{center}
+
+
+
+\clearpage
+\section{List of all optional arguments for \texttt{pst-cie}}
+\xkvview{family=pst-cie,columns={key,type,default}}
+
+\bgroup
+\RaggedRight
+\nocite{*}
+\printbibliography
+\egroup
+
+\printindex
+
+
+\end{document} 
\ No newline at end of file