summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-05-17 22:00:58 +0000
committerKarl Berry <karl@freefriends.org>2016-05-17 22:00:58 +0000
commitdd0a035eacf0e8cc64e1ea6049661f27cfb9a425 (patch)
tree84dd2c131821719bedc9cb10010e2df62bd93df5 /Master/texmf-dist/doc/generic
parent089e7e2b5f7b92b6dfc6c6bf0c73b582c503eaaf (diff)
pst-cie MAKEpst
git-svn-id: svn://tug.org/texlive/trunk@41223 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic')
-rw-r--r--Master/texmf-dist/doc/generic/pst-cie/Changes28
-rw-r--r--Master/texmf-dist/doc/generic/pst-cie/README.md24
-rw-r--r--Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.bib86
-rw-r--r--Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.pdfbin0 -> 21802039 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pst-cie/pst-cie-doc.tex387
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
Binary files differ
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