%% $Id: pst-news21.tex 263 2021-09-24 17:58:30Z herbert $
\RequirePackage{pdfmanagement-testphase}
\DeclareDocumentMetadata{}
\documentclass[11pt,english,BCOR=10mm,DIV=12,bibliography=totoc,parskip=false,headings=small,
    headinclude=false,footinclude=false,twoside,usegeometry]{pst-doc}
    
\usepackage{libertinus}
\usepackage{hvlogos}
\listfiles
%\usepackage[svgnames,dvipsnames,x11names,pspdf=-dALLOWPSTRANSPARENCY]{pstricks-pdf}
\usepackage{showexpl,pst-arrow}
\lstset{explpreset={pos=l,width=-99pt,overhang=0pt,hsep=\columnsep,vsep=\bigskipamount,rframe={},extendedchars},
    escapechar=?}

\usepackage{biblatex}
\addbibresource{PSTricks.bib}
\def\Lcs#1{\texttt{\textbackslash#1}}
\begin{document}

\title{\texttt{News -- \the\year}\\ \Large new macros and bugfixes for the basic package.}
\author{Herbert Voß}
\date{\today}

\settitle

\tableofcontents

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

This version of the News was run with \verb|lualatex| \emph{without} using Ghostscript.
The PDF file was created in a direkt way by Lua. If you want to try it, then look
at \url{https://github.com/zauguin/luapstricks}.

By default the dots are now taken from a Type1 version of the font file. For
lualatex it uses the OpenType version.

The dot part is now in an own file \texttt{pstricks-dots.tex}.

%--------------------------------------------------------------------------------------
\section{\texttt{pstricks.sty}}
%--------------------------------------------------------------------------------------
The optional argument \texttt{gsfonts} can be used to load only the symbol font from GhostScript.
Otherwise the one from URW or the system is used, which is the default.



%--------------------------------------------------------------------------------------
\section{\texttt{pstricks.tex} (v. 3.08 -- 2021/09/10)}
%--------------------------------------------------------------------------------------

\subsection{Colors}

There are two new macros to get the color values:

\begin{verbatim}
\psgetRGBColorValues{<color macro>}
\psgetCMYKColorValues{<color macro>}
\end{verbatim}

An Example:

\begin{LTXexample}[width=5cm]
\psset{linecolor=red!40}
\psgetRGBColorValues{\pslinecolor}

\colorlet{Blue}[cmyk]{blue}
\psset{linecolor=Blue!40}
\psgetCMYKColorValues{\pslinecolor}
\end{LTXexample}


\subsection{Arrows}


There are new arrow types and a new optional argument \texttt{tipcolor}:


\begin{LTXexample}[width=5cm]
\begin{pspicture}[showgrid](4.2,3.25)
\psline{-T>}(0,1)(4,1)
\psline[arrowscale=2]{<T-T>}(0,2)(4,2)
\psline[tipcolor=red,arrowscale=2]{<T-}(0,3)(4,3)
\end{pspicture}
\end{LTXexample}



\LPack{pstricks} defines the following "`arrows"':

  \def\myline#1{\psline[linecolor=red,linewidth=0.5pt,arrowscale=1.5]{#1}(0,1ex)(1.3,1ex)}%
  \def\mylineA#1{\psline[linecolor=red,linewidth=0.5pt,arrowscale=4.5]{#1}(0,1ex)(2,1ex)}%
  \psset{arrowscale=1.5}
  \begin{longtable}{@{} c @{\qquad} p{3cm} l @{}}%
    Value & Example & Name \\[2pt]\hline
    \Lnotation{-}      & \myline{-}      & None\\
    \Lnotation{<->}    & \myline{<->}    & Arrowheads.\\
    \Lnotation{>-<}    & \myline{>-<}    & Reverse arrowheads.\\
    \Lnotation{<{<}-{>}>}  & \myline{<<->>}  & Double arrowheads.\\
    \Lnotation{{>}>-{<}<}  & \myline{>>-<<}  & Double reverse arrowheads.\\
    \Lnotation{{|}-{|}}    & \myline{|-|}    & T-bars, flush to endpoints.\\
    \Lnotation{{|}*-{|}*}  & \myline{|*-|*}  & T-bars, centered on endpoints.\\
    \Lnotation{[-]}    & \myline{[-]}    & Square brackets.\\
    \Lnotation{]-[}    & \myline{]-[}    & Reversed square brackets.\\
    \Lnotation{(-)}    & \myline{(-)}    & Rounded brackets.\\
    \Lnotation{)-(}    & \myline{)-(}    & Reversed rounded brackets.\\
    \Lnotation{o-o}    & \myline{o-o}    & Circles, centered on endpoints.\\
    \Lnotation{*-*}    & \myline{*-*}    & Disks, centered on endpoints.\\
    \Lnotation{oo-oo}  & \myline{oo-oo}  & Circles, flush to endpoints.\\
    \Lnotation{**-**}  & \myline{**-**}  & Disks, flush to endpoints.\\
    \Lnotation{{|}<->{|}}  & \myline{|<->|}  & T-bars and arrows.\\
    \Lnotation{{|}>-<{|}}  & \myline{|>-<|}  & T-bars and reverse arrows.\\
    \Lnotation{h-h{}}   & \myline{h-h}    & left/right hook arrows.\\
    \Lnotation{H-H{}}   & \myline{H-H}    & left/right hook arrows.\\
    \Lnotation{v-v}   & \myline{v-v}    & left/right inside vee arrows.\\
    \Lnotation{V-V}   & \myline{V-V}    & left/right outside vee arrows.\\
    \Lnotation{f-f}   & \myline{f-f}    & left/right inside filled arrows.\\
    \Lnotation{F-F}   & \myline{F-F}    & left/right outside filled arrows.\\
    \Lnotation{t-t}   & \myline{t-t}    & left/right inside slash arrows.\\[5pt]
    \Lnotation{T-T}   & \myline{T-T}    & left/right outside slash arrows.\\
%
    \Lnotation{<D-D>}   & \mylineA{<D-D>}    & curved  arrows.\\
    \Lnotation{<D<D-D>D>}   & \mylineA{<D<D-D>D>}    & curved doubled arrows.\\
    \Lnotation{D>-<D}   & \mylineA{D>-<D}    & curved  arrows, tip inside.\\
    \Lnotation{<T-T>}   & \myline{<T-T>}    & curved lines.\\
%    \Lnotation{>T-T<}   & \mylineA{>T-T<}    & \TikZ\ like arrows.\\
    \hline
  \end{longtable}




%\@namedef{psas@T>}{ false \psk@arrowinset \psk@arrowlength \psk@arrowsize \tx@ArrowT }%	hv 20210531
%\@namedef{psas@<T}{ %	hv 20071211
%  true \psk@arrowinset \psk@arrowlength \psk@arrowsize \tx@ArrowT
%}


With version 3.04 all arrow specific base code is moved to the file \LPack{pstricks-arrows}, which
is not of interest for the default user..

\subsection{Symbolfont}


Use by default the URW or system symbol font for \Lcs{psdot}. This can be changes by using
the optional argument \texttt{gsfonts}:

\begin{verbatim}
\usepackage[gsfonts]{pstricks}
\end{verbatim}

\TeX-users have to define the switch and

\begin{verbatim}
\newif\ifpstGSfonts
\pstGSfontsfalse % or true for using GS font

\input pstricks
...
\end{verbatim}


\subsection{Fillstyle \texttt{penrose}}

There was a bug if this fillstyle was used together with a line sequence.


\psset{unit=1cm}
\centering\vspace{5cm}
\pspicture[showgrid=false](-0.5\linewidth,-4.5)(0.5\linewidth,5)
\rput(0,0){\parbox{4.5cm}{%
  \psclip{\psccurve[linestyle=none,fillstyle=penrose,psscale=.2](-3,-2)%
  (0.3,-1.5)(2.3,-2)(4.3,-1.5)(6.3,-2)(8,-1.5)(8,2)(-3,2)}
  ``One of the best new plays I have seen all year: cool, poetic,
  ironic \ldots'' proclaimed \emph{The Guardian} upon the London
  premiere of this extraordinary play about a Czech director and
  his actress wife, confronting exile in America.
  \endpsclip}}
  \psline[linearc=0.5cm,showpoints=true,dotstyle=|]{<<->>}(-1,-2)(0,-4)(1,-2)
\endpspicture



\begin{lstlisting}
\pspicture[showgrid=false](-0.5\linewidth,-4.5)(0.5\linewidth,5)
\rput(0,0){\parbox{4.5cm}{%
  \psclip{\psccurve[linestyle=none,fillstyle=penrose,psscale=.2](-3,-2)
  (0.3,-1.5)(2.3,-2)(4.3,-1.5)(6.3,-2)(8,-1.5)(8,2)(-3,2)}
 ``One of the best new plays I have seen all year: cool, poetic,
  ironic \ldots'' proclaimed \emph{The Guardian} upon the London
  premiere of this extraordinary play about a Czech director and
  his actress wife, confronting exile in America.
  \endpsclip}}%
  \psline[linearc=0.5cm,showpoints=true,dotstyle=|]{<<->>}(-1,-2)(0,-4)(1,-2)
\endpspicture
\end{lstlisting}


\iffalse



\pspicture[showgrid=false](-0.5\linewidth,-4.5)(0.5\linewidth,5)
\rput(0,0){\parbox{4.5cm}{%
  \psclip{\psccurve[linestyle=none,fillstyle=penroseA,psscale=.2](-3,-2)
  (0.3,-1.5)(2.3,-2)(4.3,-1.5)(6.3,-2)(8,-1.5)(8,2)(-3,2)}\color{white}
  ``One of the best new plays I have seen all year: cool, poetic,
  ironic \ldots'' proclaimed \emph{The Guardian} upon the London
  premiere of this extraordinary play about a Czech director and
  his actress wife, confronting exile in America.
  \endpsclip}}%
  \psline[linearc=0.5cm,showpoints=true,dotstyle=|]{<<->>}(-1,-2)(0,-4)(1,-2)
\endpspicture

\begin{lstlisting}
\pspicture[showgrid=false](-0.5\linewidth,-4.5)(0.5\linewidth,5)
\rput(0,0){\parbox{4.5cm}{%
  \psclip{\psccurve[linestyle=none,fillstyle=penrose,psscale=.2](-3,-2)
  (0.3,-1.5)(2.3,-2)(4.3,-1.5)(6.3,-2)(8,-1.5)(8,2)(-3,2)}\color{white}
  ``One of the best new plays I have seen all year: cool, poetic,
  ironic \ldots'' proclaimed \emph{The Guardian} upon the London
  premiere of this extraordinary play about a Czech director and
  his actress wife, confronting exile in America.
  \endpsclip}}%
  \psline[linearc=0.5cm,showpoints=true,dotstyle=|]{<<->>}(-1,-2)(0,-4)(1,-2)
\endpspicture\end{lstlisting}


\fi


\section{\LuaLaTeX}\label{lua}
Currently one has to use package \LPack{auto-pst-pdf-lua} if a document with
\PSTricks-code should be run \emph{directly} with  \LuaLaTeX, without using
GhostScript. This version has experimental basic support for the lua package
\LPack{luapstricks.lua}, available from \url{https://github.com/zauguin/luapstricks}.

\nocite{*}
\printbibliography


\end{document}

