Ajout du script epsnorm.pl et mise à jour de la doc des scripts

[pst-anamorphosis.git] / opt / pst-anamorphosis-doc-scripts.tex

diff --git a/opt/pst-anamorphosis-doc-scripts.tex b/opt/pst-anamorphosis-doc-scripts.tex
index 84be60e..7300e09 100644 (file)
--- a/opt/pst-anamorphosis-doc-scripts.tex
+++ b/opt/pst-anamorphosis-doc-scripts.tex
@@ -199,7 +199,7 @@ la valeur \texttt{n} de votre choix à 4 avec cette option.
 
 \begin{center}
 \begin{pspicture}(-2,-2)(2,2)
-\input{../exemplespst/tiger.pst}
+\input{../pst/tiger.pst}
 \end{pspicture}\\
 \verb|\input{tiger.pst}|
 \end{center}
@@ -230,4 +230,52 @@ de ne pas être harmonieux...
 
 \end{itemize}
 
+\section{epsnorm}
+
+Ce script transforme un fichier \textsf{EPS} vers un fichier au format
+\textit{Flattened PostScript} et en modifiant la \textsf{BoundingBox} de
+façon à ce qu'elle soit centrée sur l'origine \((0,0)\), sa dimension
+maximale étant fixée (procédure décrite dans la documentation de
+\textsf{pst-anamorphosis}: \emph{normalisation d'un fichier EPS}).
+
+Cette transformation permet d'obtenir un fichier directement exploitable
+par la macro \verb|\psanamorphosis|, ce qui explique  aussi que l'option
+\verb|-noclip| soit passée à \textsf{pstoedit} pour éviter tout
+\emph{clipping}.
+
+\subsection{Usage}
+\begin{gbar}[OrangePale]
+\begin{boxedverbatim}
+$> epsnorm.pl [-dimmax n] monfichier.{eps|ps}
+\end{boxedverbatim}
+\end{gbar}%$
+
+Le fichier est alors transformé, le contenu initial étant
+sauvegardé dans \verb+monfichier-original.{eps|ps}+.
+
+\subsection{Option}
+
+\begin{description}
+\item[\texttt{-dimmax n}] La transformation effectuée par le script
+centre l'image sur \((0,0)\) et la met à l'échelle telle que la plus
+grande des deux dimensions soit 4 cm par défaut. Vous pouvez substituer
+la valeur \texttt{n} de votre choix à 4 avec cette option.
+\end{description}
+
+\subsection{Notes}
+
+\begin{itemize}
+
+\item Pour les utilisateurs de \textsf{windows}: il faut, au préalable,
+éditer le script et remplacer la chaîne \texttt{<chemin vers
+pstoedit.exe>} (vers la ligne 12) par le chemin complet d'accès à
+\textsf{pstoedit} sur votre sytème. Pour \textsf{Linux} ou
+\textsf{MacOS}, l'hypothèse est faite que le programme est accessible
+via la variable \texttt{PATH}.
+
+\item Le fichier à traiter ne doit comporter qu'une seule page, le
+résultat peut être surprenant dans le cas contraire...
+
+\end{itemize}
+
 \end{document}
\ No newline at end of file