summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pstricks/pst-news13.tex
blob: 5eafc5e809eb5138331639d6348bed355f90196b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
%% $Id: pst-news13.tex 781 2013-05-21 08:25:07Z herbert $
\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings
    headexclude,footexclude,oneside]{pst-doc}
\listfiles
\let\Lfile\LFile
\usepackage[utf8]{inputenc}
\usepackage{pst-node,pst-plot}
\usepackage{xkvview}
\let\pstnodeFV\fileversion
\let\pstnodeFD\filedate
\renewcommand\bgImage{\psscalebox{15}{\color{blue!20}2013}}
\def\textat{\char064}
\lstset{explpreset={pos=l,width=-99pt,overhang=0pt,hsep=\columnsep,vsep=\bigskipamount,rframe={}},
    escapechar=?}
\begin{document}

%\psset{PstDebug=1}
\title{\texttt{News -- 2013}\\ \Large new macros and bugfixes for the
basic package \nxLFile{pstricks}}
\author{Herbert Voß}
\date{\today}

\maketitle

\clearpage
\tableofcontents

\clearpage
\part{\texttt{pstricks} -- package}

%--------------------------------------------------------------------------------------
\section{\texttt{pstricks.sty}}
%--------------------------------------------------------------------------------------

There is a new optional argument \Lkeyword{monochrome} to convert all RGB and CMYK colors
into grayscale. The equations are:

\subsection{RGB to gray}
\[ \text{gray} = 0.07 \text{red} + 0.71 \text{green} + 0.21 \text{blue} \]

\subsection{CMYK to gray}
\begin{align*} 
    c &= c  (1 - k) + k\\
    m &= m  (1 - k) + k\\
    y &= y  (1 - k) + k\\
    r, g, b &= (1 - c), (1 - m), (1 - y)\\
  \text{gray} &= 0.299 r + 0.587 g + 0.114 b
\end{align*}


%--------------------------------------------------------------------------------------
\section{\texttt{pstricks.tex} (\pstricksFV -- \pstricksFD)}
%--------------------------------------------------------------------------------------
There is a new optional argument \Lkeyword{pgffunctions} for the environment \Lenv{pspicture}.
With this option one can force the loading of the special pgf PostScript function
which in some cases are missing, when using the package \LPack{auto-pst-pdf} and another
package which uses pgf macros.

\lstinline|\begin{pspicture}[pgffunctions,...](...)(...)|

\subsection{labelsep}
The \Lkeyword{labelsep} is the first -- optional -- argument of \Lcs{uput}. 
It is now possible to use the PostScript notation for this \emph{length}, eg \verb|{! 45 sin 3 mul}|.
Then the unit which is active when \Lcs{uput} is active is used. With a unit the PS notation
ist not allowed and leads to an error!



\subsection{Coordinates}
Additionally to the special pair of coordinates \verb|(*x f(x))| where $x$ must be a value in
PostScript notation and $f(x)$ in algebaric noatation, there is now a \verb|(+{x}, {f(x)})|.
Both expressions must be in algebraic notation and \verb|{x}| must expand to a value
or an expression which uses known system or user defined PostScript functions.

\begin{LTXexample}[width=5cm]
\begin{pspicture}[showgrid](3,2)
\pnode(+{sqrt(Pi)},{1.5*(sin(x)^2+cos(x)^2)}){A} 
\psdot(A)
\psline[arrowscale=1.5]{->}(A)
\end{pspicture}
\end{LTXexample}


\subsection{Fillstyle \texttt{dots}}
A fix for the fill style \Lkeyval{dots} to make it work again:

\begin{LTXexample}[width=5cm]
\pspicture(4,3) 
\psframe[fillstyle=dots](4,3) 
\endpspicture 
\end{LTXexample}

\subsection{New macro \nxLcs{psRing}}

\begin{BDef}
\LcsStar{psRing}\OptArgs\Largr{\CAny}\Largb{Inner Radius}\Largb{Outer Radius}
\end{BDef}


\begin{LTXexample}[width=5cm]
\begin{pspicture}[showgrid](4,4)
  \psRing[linecolor=red](2,2){0.3}{0.8}
  \psRing*[opacity=0.5](2,2){1}{2}
\psdot(2,2)
\end{pspicture}
\end{LTXexample}

\section{The PostScript header files}
\subsection{\nxLFile{pstricks.pro}}
%--------------------------------------------------------------------------------------

\clearpage
\part{Other packages}
\section{\texttt{pst-node} -- version \pstnodeFV\ | \pstnodeFD}

\ttfamily
1.27  2013-04-12 - added macro \Lcs{Cnodeput} which takes radius=...
                   into account\\
1.26  2013-04-09 - added macros \Lcs{psncurve} and \Lcs{psnccurve}
                   for a sequence of nodes created by \Lcs{curvepnodes}\\
1.25  2012-09-21 - Global node coordinates only with
                   saveNodeCoors

\rmfamily


\clearpage
\nocite{*}
\bibliographystyle{plain}
\bibliography{PSTricks}

\printindex


\end{document}