summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pst-optic
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-05-17 22:14:06 +0000
committerKarl Berry <karl@freefriends.org>2024-05-17 22:14:06 +0000
commita96a92d3f03a2a9af25b815c66adfe7ebadae768 (patch)
tree81b3d06c4ca550d5e85daaab3fa629c2d9e0eb9d /Master/texmf-dist/doc/generic/pst-optic
parent2d942b76b287ee0cb254b45a7a5c013b24a2fdab (diff)
pst-optic (18may24)
git-svn-id: svn://tug.org/texlive/trunk@71278 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pst-optic')
-rw-r--r--Master/texmf-dist/doc/generic/pst-optic/Changes1
-rw-r--r--Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.bib11
-rw-r--r--Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.pdfbin463729 -> 516250 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.tex52
4 files changed, 46 insertions, 18 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-optic/Changes b/Master/texmf-dist/doc/generic/pst-optic/Changes
index a078ae43c34..9d04151b682 100644
--- a/Master/texmf-dist/doc/generic/pst-optic/Changes
+++ b/Master/texmf-dist/doc/generic/pst-optic/Changes
@@ -1,4 +1,5 @@
---- pst-optic.tex
+1.03 2024-05-17 - small fixes to code and documentation
1.02a 2023-05-07 - fix documentation for \psRefractionRay
1.02 2016-07-10 - added option onlyrays, preset to false
1.01 2010-07-23 - bugfixes for \psset[pst-optic,pstricks]
diff --git a/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.bib b/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.bib
index 6eea9647803..740cf6db592 100644
--- a/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.bib
+++ b/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.bib
@@ -96,7 +96,7 @@
@Article{dtk02.1:voss:mathematischen,
- author = {Herbert Vo{\ss}},
+ author = {Herbert Voß},
title = {Die mathematischen {F}unktionen von {P}ostscript},
journal = dtk,
year = 2002,
@@ -105,7 +105,7 @@
altnumber = 14,
month = mar,
pages = {40--47},
- annote = bretter,
+ annote = "Bretter, die die Welt bedeuten",
abstract = { \PS, faktisch genauso alt wie {\TeX}, ist im
Verh{\"a}ltnis dazu allgemein noch weniger bekannt, wenn es
darum geht zu beurteilen, was es denn nun im eigentlichen
@@ -117,10 +117,3 @@
gezeigt. }
}
-@ctan{pstlens:2001,
- Title = {PST-lens - {\PS} macros for Generic TeX},
- Author = {Denis Girou and Manuel Luque},
- url = {/graphics/pstricks/contrib/pst-lens/},
- year = 2001,
-}
-
diff --git a/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.pdf b/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.pdf
index a3e3c438ae3..35ec09b5b84 100644
--- a/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.pdf
+++ b/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.tex b/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.tex
index 275db43b5ab..96ca28bbec9 100644
--- a/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.tex
+++ b/Master/texmf-dist/doc/generic/pst-optic/pst-optic-doc.tex
@@ -1,4 +1,4 @@
-%% $Id: pst-optic-doc.tex 717 2023-05-07 18:46:46Z herbert $
+%% $Id: pst-optic-doc.tex 896 2024-05-17 10:13:27Z herbert $
\DocumentMetadata{}
\documentclass[11pt,english,bibliography=totoc,parskip=false,headings=small,
@@ -10,6 +10,7 @@
\let\belowcaptionskip\abovecaptionskip
%
%\usepackage[style=dtk]{biblatex}
+%\addbibresource[location=remote]{https://mirror.ctan.org/biblio/ctan-bibdata/ctan.bib}
\addbibresource{\jobname.bib}
\begin{document}
@@ -44,7 +45,8 @@ of having older versions, go to \url{http://www.CTAN.org/} and load the newest v
\vfill\noindent
Thanks to: \\
Jean-C\^ome Charpentier,
-Arnaud Schmittbuhl.
+Arnaud Schmittbuhl,
+Keno Wehr
\end{abstract}
\section{General Options}
@@ -129,10 +131,35 @@ It can be overwritten in the same way with \Lcs{newpsstyle}.
There are macros for the convergent and divergent lens
\begin{BDef}
\Lcs{lens}\OptArgs\\
-\Lcs{lensCVG}\OptArgs\% \textbf{C}on\textbf{v}er\textbf{g}ent (Collecting lens ) -- default\\
-\Lcs{lensDVG}\OptArgs\% \textbf{D}i\textbf{v}er\textbf{g}ent (Scatter lens )
+\Lcs{lensCVG} \% \textbf{C}on\textbf{v}er\textbf{g}ent (Collecting lens ) -- default\\
+\Lcs{lensDVG} \% \textbf{D}i\textbf{v}er\textbf{g}ent (Scatter lens )
+\Lcs{pslensCVG}\OptArgs \Largb{lens width}\Largb{lens height}\\
+\Lcs{pslensDVG}\OptArgs \Largb{lens width}\Largb{lens height}\\
\end{BDef}
+
+% \psscalebox{\psk@optic@lensScale}{%
+% \pscustom[linewidth=0.75\pslinewidth]{%
+% \pslensCVG{\psk@optic@lensWidth}{\psk@optic@lensHeight}
+% \fill[fillstyle=solid,fillcolor=BleuVerre]
+
+
+The predefined options for \Lcs{lens} are \texttt{xLeft=-7.5, xRight=7.5, yBottom=-3, yTop=3}.
+
+
+\subsection{Short forms}
+The two macros \Lcs{lensCVG} and \Lcs{lensDVG} are only short forms of the main macro \Lcs{lens}
+with the setting \Lkeyval{lensType}\texttt{=CVG|DVG}.
+The only valid arguments are \Lkeyword{lensScale}, \Lkeyword{lensWidth}, and \Lkeyword{lensHeight},
+which must be set by \Lcs{psset}.
+
+%\begin{verbatim}
+%lensType=CVG, OA=-7, lensHeight=6, lensWidth=1.5, refractB=2
+%\end{verbatim}
+
+The two macros \Lcs{pslensCVG} and \Lcs{pslensDVG} have two mandatory
+arguments: lens width and lens height.
+
\subsection{The Coordinates of the predefined Nodes}
The following figure shows the coordinates of the predefined nodes (see Table~\ref{tab:generalOptions}).
@@ -157,6 +184,9 @@ The following figure shows the coordinates of the predefined nodes (see Table~\r
\end{pspicture*}}
\captionof{figure}{Coodinates of the predefined Nodes}\label{fig:nodes}
+
+\clearpage
+
\subsection{The Lens Type}
\begin{LTXexample}[wide=false]
@@ -171,7 +201,7 @@ The following figure shows the coordinates of the predefined nodes (see Table~\r
\vspace*{-2ex}
\captionof{figure}{Plan Collecting lens}
-\enlargethispage{2ex}
+%\enlargethispage{2ex}
\begin{LTXexample}[wide=false]
\psscalebox{0.75}{\lens[lensType=DVG,focus=-2,spotAi=270,spotBi=90]}
@@ -185,7 +215,7 @@ The following figure shows the coordinates of the predefined nodes (see Table~\r
\vspace*{-2ex}
\captionof{figure}{Plan Scatter lens}
-\clearpage
+%\clearpage
Using \Lcs{lens}\OptArg{\Lkeyword{lensType}=\ldots} gives the in figures \ref{fig:defaultCVG} and
\ref{fig:defaultDVG} shown lenses with the default values from Table~\ref{tab:defaultLens}.
@@ -204,7 +234,7 @@ Using \Lcs{lens}\OptArg{\Lkeyword{lensType}=\ldots} gives the in figures \ref{fi
Lense height in cm & \Lkeyword{lensHeight} & 5cm\\
Lense width in cm & \Lkeyword{lensWidth} & 0.5cm\footnotemark\\
vertical scale (obsolet) & \Lkeyword{lensScale} & 1\\
- View the lens & \Lkeyword{lensGlass} & \false\\
+ View the lens & \Lkeyword{lensGlass} & \true\\
show onyl the rays & \Lkeyword{onlyrays} & \false\\
Second lens & \Lkeyword{lensTwo} & \false\\
Focus in cm & \Lkeyword{focus} & 2\\
@@ -515,7 +545,11 @@ The macro doesn't draw any lines, only the coordinates of the new point are save
\subsection{\nxLcs{symPlan}}
-\verb|\symPlan| allows to mirroring complete plain graphical objects along a virtual center line. Figure \ref{fig:symPlan} shows that this mirroring is a mathematical one and not a physical one. For more examples look at \cite{pstoptic:2001}. The syntax is:
+\verb|\symPlan| allows to mirroring complete plain graphical objects along a virtual
+center line. Figure \ref{fig:symPlan}
+shows that this mirroring is a mathematical one and not a physical one.
+%For more examples look at \cite{pstoptic:2001}.
+The syntax is:
\begin{BDef}
\Lcs{symPlan}\Largr{node1}\Largr{node2}\Largb{graphic object}
@@ -1071,7 +1105,7 @@ Syntax:
\begin{BDef}
\Lcs{eye}
\end{BDef}
-There are no Options for this symbol of an human eye (Figure~\ref{fig:auge}).
+There are no Options for this symbol of an human eye.
Use the \Lcs{rput}-macro to put the eye elsewhere.
\begin{LTXexample}[width=2cm,pos=l,wide=false]