summaryrefslogtreecommitdiff
path: root/graphics/pstricks/contrib/pst-ovl/doc/pst-ovl-doc.tex
blob: 98f30a10379ea76064853c9276cd71215fe27641 (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
%% $Id: pst-func-doc.tex 599 2011-11-03 19:38:28Z herbert $
\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,
   smallheadings, headexclude,footexclude,oneside]{pst-doc}
\usepackage[utf8]{inputenc}
\usepackage{pst-ovl}
\let\pstOVLFV\fileversion
\renewcommand\bgImage{}

\addbibresource{\jobname.bib}


\lstset{language=PSTricks,
    morekeywords={psPrintValue},basicstyle=\footnotesize\ttfamily}
%
\begin{document}

\title{\texttt{pst-ovl}}
\subtitle{Helper functions for overlays; v.\pstOVLFV}
\author{Herbert Vo\ss}
\docauthor{}
\date{\today}
\maketitle

\tableofcontents
\psset{unit=1cm}

\section{Overlays}

Overlays are mainly of interest for making slides, and the overlay macros
described in this section are mainly of interest to \TeX{} macro writers who
want to implement overlays in a slide macro package.  For example, the
\LPack{seminar} package, a \LaTeX{} style for notes and slides, uses PSTricks to
implement overlays.

Overlays are made by creating an "`\Lcs{hbox}"' and then outputting the box several
times, printing different material in the box each time. The box is created by
the commands
\begin{lstlisting}
  \Lcs{psoverlaybox} < stuff >\Lcs{endpsoverlaybox}
\end{lstlisting}
\LaTeX{} users can instead write:
\begin{lstlisting}
  \begin{psoverlaybox} <stuff> \end{psoverlaybox}
\end{lstlisting}

The material for overlay \texttt{<number>} should go within the scope of the command

  \Lcs{psoverlay}\Largb{number}

\texttt{<number>} can be any any number, after expansion. Anything not in the scope of any
\Lcs{psoverlay} command goes on overlay "`0"', and material within the scope of
\Lcs{psoverlay}\Largb{-1} goes on all the overlays. \Lcs{psoverlay}
commands can be nested and can be used in math mode.
The command

\Lcs{putoverlaybox}\Largb{number}

then prints overlay \texttt{<number>}.
%
Here is an example:

\begin{LTXexample}[pos=t]
\psoverlaybox
\psoverlay{-1}
\psframebox[framearc=.15,linewidth=1.5pt]{%
  \psoverlay{0}
  \parbox{3.5cm}{\raggedright
    Foam Cups Damage Environment {\psoverlay{1} Less than
    Paper Cups,} Study Says.}}
 \endpsoverlaybox

\psputoverlaybox{0} \hspace{.5in} \psputoverlaybox{1}
\end{LTXexample}

It is possible to define macros which hold the numbers:

\begin{LTXexample}[pos=t]
\def\all{-1} \def\main{0} \def\one{1}
\psoverlaybox 
\psoverlay{\all}
\psframebox[framearc=.15,linewidth=1.5pt]{%
  \psoverlay{\main}
  \parbox{3.5cm}{\raggedright
    Foam Cups Damage Environment {\psoverlay{\one} Less than
    Paper Cups,} Study Says.}}
 \endpsoverlaybox

\psputoverlaybox{\main} \hspace{.5in} \psputoverlaybox{\one}
\end{LTXexample}



\clearpage
\section{List of all optional arguments for \texttt{pst-ovl}}

\xkvview{family=pst-ovl,columns={key,type,default}}




\bgroup
\raggedright
\nocite{*}
\printbibliography
\egroup

\printindex



\end{document}