Initialisation du projet pst-solides3d.git (SVN revision 142)
[pst-solides3d.git] / doc / par-presentation.tex
1 \section {Présentation}
2
3 Le package \texttt{pst-solides3d} permet d'obtenir, avec PSTricks, des
4 vues en 3d de solides prédéfinis ou construits par
5 l'utilisateur. On trouvera la plupart des solides usuels que l'on peut
6 représenter avec ou sans les arêtes cacheés et dont la couleur peut
7 varier avec l'éclairage.
8
9 Ce package permet également de projeter des textes ou des dessins
10 simples en 2d sur un plan quelconque ou sur une face d'un solide déjà
11 construit.
12
13 Du point de vue utilisateur, la plupart des fonctionnalités sont
14 accessibles par trois macros \TeX~: \verb+\psSolid+, qui sert à
15 manipuler les objets à $3$ dimensions, \verb+\psSurface+, cousine de
16 la première et dédiée à la représentation de surfaces définies par une
17 équation du type $f (x, y) = z$, et \verb+\psProjection+ qui permet de
18 projeter un dessin en $2$~dimensions sur un plan quelconque de la
19 scène $3$d représentée.
20
21 Dans l'utilisation, deux langages cohabitent~: d'une part PSTricks et
22 ses macros où l'utilisateur retrouvera la syntaxe usuelle, d'autre
23 part Postscript que l'on voit apparaître dans les argument optionnels
24 des précédentes.
25
26 Le parti pris a été de limiter strictement le champ d'action de
27 PSTricks, pour le cantonner au rôle d'interface entre \TeX {} et
28 Postscript. Plus précisément, le rôle de PSTricks a
29 strictement été circonscrit à celui de la transmission des paramètres
30 vers Postscript, ce dernier s'occupant de la totalité des calculs
31 nécessaires puis de l'affichage.
32
33 Pour l'ensemble de ces procédures de calculs et d'affichages, nous
34 utilisons une librairie Postscript développée pour
35 une autre application (le logiciel \textsl {jps2ps}).
36 Le code postscript utilisant cette librairie est appelé \textsl{code
37 jps}.
38
39 Le but de ce présent document est de décrire la syntaxe PSTricks pour
40 chacune des opérations offertes par le package.

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.