Ajout du script epsnorm.pl et mise à jour de la doc des scripts
[pst-anamorphosis.git] / opt / pst-anamorphosis-doc-scripts.tex
index fb12202..7300e09 100644 (file)
 \vfill
 \begin{center}
 \textcolor{white}{\textbf{\today}}\\[0.3cm]
-\textcolor{white}{\url{http://melusine.eu.org/syracuse/G/pstricks/}}\\
+\textcolor{white}{\url{http://melusine.eu.org/syracuse/G/pst-anamorphosis/}}\\
 \includegraphics[scale=0.4]{../doc/logo_syracuse}
 \end{center}
 
 \newpage
 
 
-
+%$
 \section{Introduction}
 Pour multiplier les exemples d'anamorphoses et tester les macros de
 \textsf{pst-anamorphosis}, différents scripts ont été mis au point
@@ -158,7 +158,7 @@ requis pour l'exécution des scripts.
 Les scripts sont écrits en \textsf{PERL}, il est donc nécessaire de
 disposer de l'interpréteur sur sa machine.
 
-%$
+
 \section{psftopst}
 
 Ce script transforme un fichier au format \textit{Flattened
@@ -170,36 +170,36 @@ appellerons fichier \textsf{PST} dans la suite.
 Dans le cadre des anamorphoses, les fichiers \textsf{PST} présentent
 l'intérêt d'être directement incorporé dans le fichier qui sera, au
 final, transformé en PDF. Contrairement aux fichiers EPS qui le seront
-au moment de la transformation PS \(\to\) PDF ce qui demande le
+au moment de la transformation PS \(\to\) PDF, ce qui demande le
 positionnement de l'option \texttt{-dNOSAFER} de \textsf{Ghostscript} ou
 alors la précision du chemin complet pour \textsf{Distiller}.
 
 \subsection{Usage}
 \begin{gbar}[OrangePale]
 \begin{boxedverbatim}
-$> psftopst [-ps] [-dimmax n] monfichier.{eps|ps}
+$> psftopst.pl [-ps] [-dimmax n] monfichier.{eps|ps}
 \end{boxedverbatim}
 \end{gbar}%$
 
-Si tout se passe bien, \texttt{monfichier.pst} sera créé...
+Si tout se passe bien, \texttt{monfichier.pst} sera créé dans le
+répertoire de travail...
 
 \subsection{Options}
 
 \begin{description}
 \item[\texttt{-ps}] Si le fichier de départ n'a pas déjà été
-transformé par \textsf{pstoedit} alors cela sera fait avec cette
+transformé par \textsf{pstoedit}, cela sera fait avec cette
 option. Le fichier original sera alors sauvegardé avec le suffixe
 \texttt{-original}.
 \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 unités (\textit{i.e.} 4 cm par
-défaut). Vous pouvez substituer la valeur \texttt{n} de votre choix à
-4 avec cette option.
+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}
 
 \begin{center}
 \begin{pspicture}(-2,-2)(2,2)
-\input{../exemplespst/tiger.pst}
+\input{../pst/tiger.pst}
 \end{pspicture}\\
 \verb|\input{tiger.pst}|
 \end{center}
@@ -216,6 +216,62 @@ pstoedit.exe>} (vers la ligne 12) par le chemin complet d'accès à
 \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...
+
+\item L'unité graphique n'est pas fixée, elle est supposée égale au
+centimètre qui est l'unité par défaut avec \textsf{PSTricks}. Sachez
+que si vous modifiez celle-ci\footnote{Dans le fichier qui appelle le
+fichier \textsf{PST}.} et/ou que vous différentiez les unités en
+abscisse et ordonnée, les dimensions de l'image produite seront bien
+modifiées en conséquence mais pas les \emph{traits} qu'elle comporte,
+l'épaisseur de ceux-ci est figée en points (\textsf{pt}). Cela risque
+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...

Licence Creative Commons Les fichiers de Syracuse sont mis à disposition (sauf mention contraire) selon les termes de la
Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 4.0 International.