doc/par-codejps.tex

   1 \section {Le code jps}
   2
   3 Nous appelons \textsl {code jps\/} tout code postscript utilisant la
   4 bibliothèque développée pour le logiciel \textsl {jps2ps}.
   5
   6 Le fichier \verb+solides.pro+ du package \verb+solides3d+
   7 est essentiellement constitué d'éléments en provenance de cette
   8 bibliothèque, qui contient environ $4\, 500$~fonctions et
   9 procédures.
  10
  11 Son utilisation permet de disposer de commandes adaptées au dessin
  12 mathématique, sans qu'il soit besoin de tout reconstruire à partir des
  13 primitives \verb+moveto+, \verb+lineto+, \verb+curveto+, etc...
  14
  15 Par exemple, on peut définir une fonction $F$ telle que $F(t) =
  16 (3\cos^3 t, 3\sin^3 t)$, et demander le tracé de la courbe avec la
  17 code jps \texttt{0 360 {F} CourbeR2}.
  18
  19 Si on veut seulement le chemin de cette courbe, on utilise le code
  20 \verb+0 360 {F} CourbeR2_+, et si on veut le dépot sur la pile des
  21 points de la courbe, on utilise \texttt{0 360 {F} CourbeR2+}.
  22
  23 Dans chacun des $3$~exemples ci-dessus, le nombre de points est
  24 déterminé par la variable globale \textsl {resolution}.
  25
  26 Autrement dit, avec la fonction $F$ précitée et une résolution fixée à
  27 36, le code jps
  28 \begin{verbatim}
  29    0 350 {F} CourbeR2+
  30 \end{verbatim}
  31 est  équivalent au code postscript
  32 \begin{verbatim}
  33    0 10 350 {
  34       /angle exch def
  35       3 angle cos 3 exp mul
  36       3 angle sin 3 exp mul
  37    } for
  38 \end{verbatim}
  39
  40 Nous n'avons pas encore développé la documentation sur la partie
  41 spécifique de cette bibliothèque embarquée dans le fichier
  42 \verb+solides.pro+. Pour le moment, nous renvoyons le lecteur
  43 intéressé au \textsl {Guide de l'utilisateur de jps2ps\/} disponible
  44 sur le site \url {melusine.eu.org/syracuse/bbgraf}.