summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pst-uml/pst-uml-doc.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-09-02 23:51:36 +0000
committerKarl Berry <karl@freefriends.org>2006-09-02 23:51:36 +0000
commit42c0abb2794d602020c582f8072442de1322e2f5 (patch)
tree0016eae478cf70689dd4369c27a63b78010be189 /Master/texmf-dist/doc/generic/pst-uml/pst-uml-doc.tex
parent17ea463442b9240d86c066c8f2507e38bb8d457b (diff)
pst-uml update (29aug06)
git-svn-id: svn://tug.org/texlive/trunk@2074 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pst-uml/pst-uml-doc.tex')
-rw-r--r--Master/texmf-dist/doc/generic/pst-uml/pst-uml-doc.tex1559
1 files changed, 1559 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-uml/pst-uml-doc.tex b/Master/texmf-dist/doc/generic/pst-uml/pst-uml-doc.tex
new file mode 100644
index 00000000000..801b9e422d5
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-uml/pst-uml-doc.tex
@@ -0,0 +1,1559 @@
+\documentclass[11pt,a4paper,twoside]{article}
+\usepackage[T1]{fontenc}
+ % \usepackage[applemac]{inputenc}
+\usepackage[latin1]{inputenc}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ % Format de la mise en page
+ \setlength{\hoffset}{-1in}
+ \setlength{\voffset}{-1in}
+ \setlength{\oddsidemargin}{2cm}
+ \setlength{\evensidemargin}{2cm}
+ \setlength{\topmargin}{1.8cm}
+ % \setlength{\headheight}{0cm}
+ % \setlength{\headsep}{0cm}
+ \setlength{\textwidth}{16.5cm}
+ \setlength{\textheight}{24.0cm}
+
+ % Pour que LaTeX n'essaie pas de justifier les pages verticalement
+ \raggedbottom
+ \usepackage{pst-uml}
+
+
+% LA SUITE NE MARCHE PAS CAR "fvrb-ex" cherche "fancyvrb", meme
+% si celui-ci est deja chargé !
+%
+% % on utilise le nouveau package "fancyvrb.sty" de TVZ et son extension
+% % fvrb-ex.sty de Denis GIROU pour les exemples LATEX :
+%
+% \IfFileExists{fvrb-ex.sty}{%
+% \RequirePackage{fvrb-ex}%
+% }{%
+% \PackageWarning{doc_pst-uml}{%
+% *** You should install packages "fancyvrb" and "fvrb-ex" ***}%
+% \RequirePackage{needed/fancyvrb}%
+% \RequirePackage{needed/fvrb-ex}%
+% }
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+ % Utilisation de "fancyvrb.sty" :
+ %
+ % fournit l'environnement "Verbatim" (idem envir verbatim avec
+ % nombreuses options et la commande "\VerbatimInput"
+ %
+ % Exemple :
+ %
+ % \VerbatimInput{../SOURCES/iloveleda.cc}
+ %
+ % On peut aussi passer des options à la pstricks (au hasard :-)
+ % ou par la commande "\fvset{key1,value1,key2,value2,...}"
+ %
+ % \VerbatimInput[%
+ % baselinestretch=0.9,% pour tasser les lignes (si long listing)
+ % fontsize=\small,% pour un fonte plus petite
+ % numbers=left,% pour numeroter les lignes a gauche
+ % frame=single,% pour encadrer
+ % gobble=0% nbr de caratere de debut a ignorer
+ % ]{../SOURCES/iloveleda.cc}
+ %
+ \usepackage{fancyvrb}
+
+ % pour les environnement CenterExample...
+ \usepackage[pstricks]{fvrb-ex}
+ \fvset{frame=single,numbers=left}
+ %
+ \providecommand{\showgrid}{\psgrid[subgriddiv=0, griddots=10]}
+ \psset{subgriddiv=0, griddots=10}
+
+ \DefineShortVerb{\|}
+ % \UndefineShortVerb{\|} % pour annuler
+
+ \pagestyle{headings}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ % Quelques commandes locales
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ % \printtime
+ %
+ % commande d'impression de l'heure courante
+ %
+ % Exemple : "Fichier compil\'{e} le \today{} \`{a} \printtime."
+ \usepackage{calc}
+ \usepackage{ifthen}
+ \newcounter{hours}\newcounter{minutes}
+ \newcommand{\printtime}{%
+ \setcounter{hours}{\time/60}%
+ \setcounter{minutes}{\time-\value{hours}*60}%
+ \thehours h%
+ % on veut obtenir 15h03mn et non 15h3mn...
+ \ifthenelse{\theminutes<10}{0}{}\theminutes mn%
+ }
+
+% \Stabilo
+%
+% Permet de surligner en jaune (gris clair en NB) le parametre
+% La version \fStabilo rajoute une frame rouge autour.
+%
+% Syntaxe : \Stabilo{textInportant}
+
+\newcommand{\Stabilo}[1]{\colorbox[rgb]{1,1,0.2}{#1}}
+\newcommand{\fStabilo}[1]{\fcolorbox[rgb]{1,0,0}{1,1,0.2}{#1}}
+
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ % Quelques abbreviations
+ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+ % Conventions g\'{e}n\'{e}rales pour les formats de pr\'{e}sentation
+ \newcommand{\strong}[1]{\textbf{\emph{#1}}} % plus fort que \emph
+ \newcommand{\tech}[1]{\textsf{#1}} % terme technique
+ \newcommand{\file}[1]{\texttt{#1}} % noms de fichiers et de r\'{e}pertoires
+ \newcommand{\menu}[1]{\fbox{#1}} % nom d'un menu/sous-menu
+ \newcommand{\key}[1]{\fbox{\textbf{#1}}} % touche du clavier
+
+ % abreviations locales a ce document :
+ \newcommand{\uml}{\textsc{uml}}
+ \newcommand{\pstricks}{\texttt{PSTricks}}
+ \newcommand{\postscript}{\texttt{PostScript}}
+ \newcommand{\pstuml}{\texttt{pst-uml}}
+ % \newcommand{\bs}{\backslash}
+
+ % Pour les noms de commande TeX
+ % Exemple : \cs{fbox} => \fbox
+ \DeclareRobustCommand\cs[1]{\texttt{\char`\\#1}}
+
+\usepackage[colorlinks,linktocpage]{hyperref}
+% \usepackage{french}
+\usepackage[francais]{babel} % idem frenchb mais PAS french !
+% La suite evite que Babel impose un espace devant ":" mais n'est
+% pas disponible sur les vielles versions de Babel (comme à l'ENSTA).
+\NoAutoSpaceBeforeFDP
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\begin{document}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\title{Interface utilisateur du package \pstuml}
+\author{%
+ Maurice \textsc{Diamantini}%
+ \thanks{avec l'aide précieuse de Denis \textsc{Girou}} %
+ (email : \texttt{diam@ensta.fr})
+}
+\date{%
+ modif package : 27/08/06 \\
+ modif doc\ \ \ : 27/08/06\\
+ \pageref{verylast}~pages compilées le \today{} à \printtime{}.
+}
+
+\maketitle
+
+\tableofcontents
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Introduction}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{Présentation}
+
+Ce document présente l'utilisation d'un certain nombre de macro
+destinées à faciliter le dessin de diagramme de type \uml{} (Unified
+Modeling Langage) en utilisant le package \pstricks{} de
+Van Zandt \textsc{Timothy}, dont l'usage est supposé connu.
+
+Ce package est en cours de développement et n'est diffusé pour
+l'instant que à titre d'information. En particulier, la
+\strong{stabilité} des noms de commandes proposées, leurs paramètres
+ainsi que leur comportement même \strong{ne sont pas garantis}. Il en
+est de même que le nom et la fonction des options.
+
+
+Dans le cas de diagrammes \uml{} complexes, on peut augmenter la
+lisibilité du source, et donc faciliter les modifications du diagrammes
+en cours d'élaboration en divisant le travail en trois phases
+séparées~:
+
+\begin{enumerate}
+ \item définir graphiquement le dessin des différents éléments du
+ schémas, en particulier pour les objets complexes (nombreux
+ paramètres ou text important, ...) ;
+
+ \item placer%
+ \footnotemark{} %
+ ces boites grâce à \texttt{psmatrix} ou à des
+ \cs{rput} dans un environnement \texttt{pspicture}
+ Les objets positionnés sont alors associé à un nom de node (au
+ sens \pstricks). On peut également dans cette phase placer les labels
+ ou autres dessins complémentaires liés aux graphismes des objets
+ eux-mêmes (et non des connecteurs entre objets) ;
+
+ \item router%
+ \addtocounter{footnote}{-1}\footnotemark{} %
+ ces boites à l'aide des différentes commandes de connexion et
+ coller les labels ou autres fleches \uml{}.
+\end{enumerate}
+% \footnotetext[1]{désolé : déformation professionnelle !}
+\footnotetext{désolé : déformation professionnelle !}
+% \stepcounter{footnote}
+
+
+Les macro proposées tendent à suivre les conventions \pstricks{} et
+\texttt{graphicx} pour le passage des options : à savoir l'utilisation
+de couple de la forme \texttt{Key=value}. Cette fonctionnalité
+nécessite l'utilisation du package \texttt{pst-key} qui est proposée
+dans la distribution de \pstuml{} (en attendant une diffusion plus
+générale). Un des intérêts du package \texttt{pst-key} est de pouvoir
+rajouter des options sans changer la syntaxe de la commande de base.
+D'une manière générales, le nombre d'options de toutes les commandes
+complexes est appelé à croitre.
+
+
+\noindent Voici la syntaxe générale des commandes proposées :
+
+\begin{verbatim}
+ \umlCommand[option1=value1,option2=value2,...]{param1}{param2}...
+\end{verbatim}
+
+La valeur par défaut de chacune de ces options peut être redéfinie par
+la commande |\psset{...}| (comme toutes toutes les options de \pstricks).
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{Dépendances }
+
+Les packages suivants sont appelés par \pstuml{} (par la
+commande \cs{RequirePackage}):
+\begin{itemize}
+ \item \texttt{pstricks}
+
+ \item \texttt{pst-node}
+
+ \item \texttt{pst-tree}
+
+ \item \texttt{multido}
+
+ \item \texttt{calc}
+
+ \item \texttt{ifthenelse}
+
+ \item \texttt{pst-xkey.tex} (par \cs{input} car en \TeX{})
+\end{itemize}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Les macros de création d'objet}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{\cs{umlClass}}
+
+
+
+\begin{description}
+
+\item[Syntaxe] \mbox{}
+
+ \begin{verbatim}
+ \umlClass[keyOptions]{title}{body}
+ \end{verbatim}
+
+ Permet de dessiner une classe.
+
+\item[Paramètres] \mbox{}
+
+% % \subsubsection*{Paramètres}
+
+ \begin{description}
+
+ \item[\texttt{title} :] nom de la classe, celui-ci sera centré
+ et écrit en gras. Il peut tenir sur plusieurs lignes.
+
+ \item[\texttt{body} :] corps de la classe propremment dit. En
+ particulier contient les attributs et méthodes justifiées à gauche.
+ Les différentes lignes sont séparées par |\\| et éventuellement
+ des |\hline|.
+ \end{description}
+
+\item[Options] \mbox{}
+
+
+ \begin{description}
+
+ \item[\texttt{umlDoubleRuleSep} (dim : 2mm)] : distance%
+ \footnote{% protect car dans \item[xxx]
+ Comme pour toutes les dimensions passées à \pstricks{}, la
+ spécification de l'unité utilisée est facultative et vaut
+ \texttt{cm} par défaut, contrairement à \LaTeX{} ou il est
+ nécessaire de préciser une unité (même pour 0pt !).
+ } %
+ entre deux |\hline| (dans la zone |title| ou |body|).
+
+ \item[\texttt{umlShadow} (boolean : true)] :
+ si vrai, un cadre ombré de fond gris entoure la classe \\
+ sinon, un cadre simple sur fond blanc est utilisé.
+
+ \item[\texttt{umlParameter} (string : "")] :
+ si non vide, dessine un rectangle en pointillé
+ contenant la valeur sur le coin supérieur droit de la classe
+ (utilisé pour les classes paramétriques ou "Templates" en C++).
+
+ \end{description}
+
+\item[Exemples 1] \mbox{}
+
+ Les illustations suivantes présente une utilisation directe (i.e.
+ sans utilisation dans une boite ou par une commande) de la
+ commande de création d'une classe. Ces classes sont entourées par
+ un tiret pour montrer le positionnement vertical par rapport à la
+ ligne de base.
+
+ \bigskip\noindent
+ Exemples de classes standards
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ --\umlClass{standard 1}{%
+ attrib 1 \\
+ attrib 2 \\
+ attrib 3 \\
+ \hline
+ meth 1 \\
+ meth 2
+ }--
+ \end{SideBySideExample}
+
+ \bigskip\noindent
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ --\umlClass{standard 2}{%
+ attrib 1 \\
+ attrib 2 \\
+ attrib 3 \\
+ \hline
+ \hline
+ }--
+ \end{SideBySideExample}
+
+ \bigskip\noindent
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ --%
+ \umlClass[umlShadow=false,umlParameter=\ T\ ]{%
+ standard 3%
+ }{%
+ \hline
+ meth 1 \\
+ meth 2
+ }--
+ \end{SideBySideExample}
+
+ \bigskip\noindent
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ --\umlClass{standard 4}{}--
+ \end{SideBySideExample}
+
+ \bigskip\noindent
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ --\umlClass{standard 5}{%
+ \hline
+ \hline
+ }--
+ \end{SideBySideExample}
+
+
+\item[Exemples 2] \mbox{}
+
+ \bigskip\noindent On peut mettre plusieurs sauts de ligne dans
+ chaque paramètre de la commande. Pour le premier paramètre :
+ toutes les lignes sont centrées et en gras~:
+ \begin{SideBySideExample}[xrightmargin=7.5cm]
+ --%
+ \umlClass{Exemple 1 \\ avec \\
+ plusieurs lignes}{%
+ Champs r\'eserv\'e aux attributs\\
+ \hline
+ Champs r\'eserv\'e\\ aux m\'ethodes\\
+ \hline\hline
+ Champs bidon%
+ }--
+ \end{SideBySideExample}
+
+\item[Exemples 3] \mbox{}
+
+ \bigskip\noindent On peut souhaiter imposer une largeur minimale à
+ une classe, par exemple pour donner à plusieurs classes une
+ apparance identique. On met alors le titre dans une \cs{makebox}
+ (s'il n'y a qu'une seule ligne).
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ --%
+ \umlClass{\makebox[3.5cm]{Voici la classe 1}}{%
+ Largeur mini 3.5cm \\ \hline
+ M\'ethode1\\
+ M\'ethode2%
+ }--
+
+ \vspace{10mm}
+ --%
+ \umlClass{\makebox[3.5cm]{Classe 2}}{%
+ Les attributs \\ \hline
+ M\'ethode1\\
+ M\'ethode2%
+ }--
+
+ \vspace{10mm}
+ --%
+ \umlClass{\makebox[3.5cm]{Classe 3}}{%
+ \hline \hline
+ }--
+
+ \vspace{10mm}
+ --%
+ \umlClass{\makebox[3.5cm]{Classe 4}}{%
+ Cela peut m\^eme d\'epasser ! \\ \hline
+ M\'ethode1\\
+ M\'ethode2%
+ }--
+
+ \end{SideBySideExample}
+
+
+ \item[Bug] \mbox{} --
+
+ \item[\`A faire] \mbox{} --
+\end{description}
+
+% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% \subsection{\cs{umlSaveClass} et \cs{umlUseBox}}
+%
+% \begin{description}
+%
+% \item[\`A faire] \mbox{}
+%
+% Utilisation des commandes de classes complémentaires :
+% \cs{umlSaveClass} s'utilise comme \cs{umlClass}, mais au lieu de
+% dessiner une classe, celle-ci est sauvée dans une boite (au sens
+% \LaTeX{}) et doit être utilisé ultérieurement. Le titre de la
+% classe sert pour nommer la boite. Ce titre pouvant contenir des
+% espaces, il n'est pas possible d'utiliser simplement un \cs{usebox}
+% pour utiliser cette boite : d'où l'existance de la commande
+% \cs{umlUseBox}. Les caractéristiques de l'objet créé sont fixées
+% lors de la \emph{création} de la boîte par \cs{umlSaveClass}. Ceci
+% est trés important pour savoir quels sont les paramètres par défaut
+% qui seront pris en compte.
+%
+% \strong{Attention :} Ce nom contenant des espaces, il ne peut pas être
+% utilisé comme nom de node (sous peine d'erreurs \postscript).
+%
+% \item[Exemples 1] \mbox{}
+%
+%
+% \bigskip\noindent A vérifier : Les blocs ainsi définis en \LaTeX{}
+% sont globales même si elle sont définie à l'intérieur d'un
+% environnement ou d'un bloc |{}|.
+%
+% \begin{SideBySideExample}[xrightmargin=7cm]
+% % On cree et m\'emorise la classe
+% \umlSaveClass{Classe 1 bis}{%
+% mes attributs \\\hline
+% M\'ethode 2 \\
+% M\'ethode 2%
+% }
+% % On utilise la classe (en instanciant la boite
+% \rnode{Classe1bis}{\umlUseBox{Classe 1 bis}}
+% \end{SideBySideExample}
+%
+%
+% \item[Bug] \mbox{}
+%
+%
+% La boîte porte toujours le nom |#| et non pas le contenu de |#2| ou
+% |#1| suivant le cas. D'où l'écriture des caractères |2|  et |21|
+% entourant les boites placées.
+%
+% Pour les volontaires, voici le code de la commande
+% \cs{umlSaveClass}:
+%
+% \begin{Verbatim}
+% % CECI FONCTIONNE MAL (la boite cree s'appelle "#" )
+% % Je n'ai pas reussi en jonglant aves les \csname et autre \@nameuse
+% \newcommand{\umlSaveClass}[3][]{%
+% \newsavebox{\#2}%
+% \savebox{\#2}{%
+% \umlClass[#1]{#2}{#3}%
+% }%
+% }
+% % Pas de \umlUseClass car sera aussi utilisée pour les acteurs, ...
+% \newcommand{\umlUseBox}[1]{\usebox{\#1}}
+% \end{Verbatim}
+%
+% \end{description}
+%
+%
+%
+% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% \subsection{\cs{umlDefClass} et \cs{umlRunCmd}}
+%
+% \begin{description}
+%
+% \item[\`A faire] \mbox{}
+%
+% Une autre façon de prédéfinir les classes est de créer des
+% commandes dont le nom correspond au titre de la classe (malgré les
+% espaces et sauts de ligne). Contrairement à l'utilisation de la
+% commande \cs{umlSaveClass}, Les caractéristiques de l'objet créé
+% sont fixées au moment de l'utilisation de la commande par
+% \cs{umlRunCmd}.
+%
+% \bigskip\noindent A vérifier : de plus, la commande définie est
+% local à son environnement ou à son bloc |{}|.
+%
+% \item[Bug] \mbox{}
+%
+% A FAIRE (j'appréhende les mêmes problèmes que précédement)
+%
+% \end{description}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{\cs{umlActor}}
+
+\begin{description}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Syntaxe] \mbox{}
+
+ \begin{verbatim}
+ \umlClass[keyOptions]{title}
+ \end{verbatim}
+ Permet de dessiner un acteur représenté par un bonhomme avec un
+ nom. Le titre du bonhomme est vu comme une boîte vide par
+ \LaTeX{}, cela rend les liens dans les diagrammes des cas
+ d'utilisation (qui sont la principale utilisation des Acteurs) plus
+ agréable (les flèches sont positionnées par rapport au bonhomme et
+ non pas au texte qui peut occuper plusieurs lignes.
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Paramètres (un seul)] \mbox{}
+
+ \begin{description}
+
+ \item[\texttt{title} :] nom de l'acteur. Il peut contenir
+ plusieurs lignes séparées par |\\| et éventuellement des
+ \cs{hline}
+
+ \end{description}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Options] \mbox{}
+
+ \begin{description}
+
+ \item[\texttt{umlActorLineWidth} (dimension : 0.6mm )] :
+ Epaisseur de ligne pour le dessin de l'acteur.
+
+ \item[\texttt{unit} (dimension : 1 ou 1cm )] : option standard
+ de \pstricks{} permet de modifier la taille de l'Acteur. Les
+ options \texttt{xunit}, \texttt{yunit} sont également
+ utilisable mais déconseillés.
+
+ \end{description}
+
+ D'autres option standard à \pstricks{} telle que \texttt{unit}
+ (ainsi que xunit et yunit) peuvent être utilisées.
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Bug] \mbox{}
+
+
+ Un agrandissement par un \texttt{yunit} $> 1$, a pour effet de
+ décaler la tête vers le haut : il faut donc utiliser la commande
+ \cs{resizebox} pour assurer un agrandissement correct.
+
+ L'utilisation de \texttt{unit} pour le changement de taille semble
+ ne pas modifier pas la taille de la boite crée : d'ou l'encombre
+ pour les petites taille (on compense par un |\resizebox{}[][]{}|
+ approprié).
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[\`A faire] \mbox{}
+
+ Option : pour concerver la taille de la boîte correspondant au
+ Titre de l'acteur.
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Exemples 1] \mbox{}
+
+ Ces commandes étant courtes, on peut les créer au moment même de
+ placement qui se fait ici dans le corps du texte dans cet exemple
+ (en mode LR au sens \LaTeX{}).
+
+ \begin{CenterExample}
+ \umlActor{Client}--%
+ \umlActor[unit=0.5,umlActorLineWidth=1mm]{Minus 1}--%
+ \umlActor[unit=0.5,umlActorLineWidth=1mm]{Minus 2}--%
+ \umlActor[xunit=0.6,yunit=1.5, umlActorLineWidth=1pt]{Le Chef}--%
+ \umlActor{}--%
+ \psframebox{\umlActor{sur\\trois\\ligne}}--%
+ \end{CenterExample}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Exemples 2] \mbox{}
+
+ On peut séparer la création et le dessin du placement. Le
+ placement se fait également dans le texte même.
+
+ \begin{CenterExample}
+ % Actor2 :
+ \newcommand{\drawActorii}{%
+ \umlActor[umlActorLineWidth=1pt]{Act2 (1pt)}}
+ % Actor3 :
+ \newcommand{\drawActoriii}{%
+ \umlActor{Act3 \\ (par defaut)}}
+ % Actor4 :
+ \newcommand{\drawActoriv}{%
+ \umlActor[umlActorLineWidth=1mm,unit=0.5]{Act4 (1mm)\\unit=0.5}}
+ % Actor5 : (changement local d'une valeur par defaut)
+ \newcommand{\drawActorv}{%
+ \umlActor[umlActorLineWidth=2mm]{%
+ N'importe quoi\\sur trois lignes\\Act5 (2mm)}}
+ %
+ % utilisation des acteurs precedements definis :
+ --\drawActorii%
+ --\drawActoriii%
+ --\drawActoriv%
+ --\drawActorv%
+ \end{CenterExample}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Exemples 3] \mbox{}
+
+
+ On peut composer les objets Class et Actor (illustation du
+ stéréotype de l'acteur).
+
+ \begin{SideBySideExample}[xrightmargin=5cm]
+ +%
+ \umlClass{\umlStereoType{Actor} %
+ \umlActor[unit=0.5]{}}{%
+ }+%
+ \end{SideBySideExample}
+
+ \begin{SideBySideExample}[xrightmargin=5cm]
+ +%
+ \umlClass{<<Actor>> %
+ %\raisebox{<raisedlift>}[<height>][<depth>]{<text>}
+ \raisebox{-0.3\height}[3ex][2ex]{%
+ \umlActor[unit=0.5]{}%
+ }%
+ }{%
+ }+%
+ \end{SideBySideExample}
+
+
+\end{description}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{\cs{umlState}, \cs{umlPutStateIn} et \cs{umlPutStateOut} }
+
+\begin{description}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Syntaxe] \mbox{}
+
+ Les commandes suivantes permettent de dessiner à l'emplacement
+ courant respectivement un état, ou les pseudo-états d'entrée et de
+ sortie :
+
+ \begin{verbatim}
+ \umlState[keyOptions]{title}{body}
+ \umlStateIn
+ \umlStateOut
+ \end{verbatim}
+
+ \`A l'usage, les commandes de dessin de pseudo-état décrites
+ ci-dessus sont avantageusement remplacée par les deux commandes
+ suivantes :
+
+ \begin{verbatim}
+ \umlPutStateIn{coord}{nodeName}
+ \umlPutStateOut{coord}{nodeName}
+ \end{verbatim}
+
+ Elles permettent de dessiner et surtout de placer et connecter les
+ pseudo-états d'entrée et de sortie. Ces pseudo-état sont mis dans
+ un \cs{cnode} au moment de leur création, ce qui permet aux
+ connexions de toucher ces états même si le connecteur arrive à 45
+ degrés ; ce qui n'est pas le cas si on met la boite (donc de forme
+ carrée) créée par \cs{umlStateIn} à \emph{posteriori} dans un
+ \cs{cnode} !
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Paramètres] \mbox{}
+
+ \begin{description}
+
+ \item[\texttt{title} :] nom de l'état, peut-être vide.
+ Celui-ci sera centré et écrit en gras. Il peut tenir sur
+ plusieurs lignes (toutes seront en gras.
+
+ \item[\texttt{body} :] corps de l'état, peut-être vide.
+ Il peut contenir plusieurs lignes séparées par |\\| et
+ éventuellement des \cs{hline}. Il peut également contenir des
+ environnements |pspicture| ou d'autres \cs{umlState}.
+
+ \end{description}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[options] \mbox{}
+
+ \begin{description}
+
+ \item[\texttt{umlStateWidth} (dimension: 0 )]~: (NON
+ IMPL\'EMENT\'E) largeur de l'état. La valeur 0 représente la
+ dimension naturelle de cette boite.
+
+ \item[\texttt{umlStateHeight} (dimension: 0 )]~: (NON
+ IMPL\'EMENT\'E) hauteur du corps de l'état l'état. La valeur 0
+ représente la dimension naturelle de cette boite.
+
+ \end{description}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Bug] \mbox{}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[\`A faire] \mbox{}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Exemples 1] \mbox{}
+
+
+
+ Les états d'entrée et de sortie
+
+ \bigskip
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +\umlStateIn+ : Input State
+
+ +\umlStateOut+ : Output State
+ \end{SideBySideExample}
+
+ \bigskip
+ Exemples simples avec champs vides ou non
+
+ \bigskip
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \umlState{}{Body only}+%
+ \umlState{}{}+% Vide
+ \umlState{Title only}{}+
+ \end{SideBySideExample}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Exemples 2] \mbox{}
+
+ On peut mettre titre ou corps sur plusieurs lignes. Toutes les
+ lignes du titre sont en gras :
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \umlState{Title A\\Title B}{}+%
+ \umlState{}{Body A \\ Body B}+%
+ \end{SideBySideExample}
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +\umlState{Title A\\ Title B}{%
+ Voici le corps de l'état \\
+ avec les diff\'erentes\\
+ lignes\\
+ et d'autres...%
+ }+%
+ \end{SideBySideExample}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Exemples 3] \mbox{}
+
+ Il y a différents moyens pour réserver une place blanche de taille
+ arbitraire (en attendant l'implantation d'options spécialisées pour
+ ce besoin).
+
+ \bigskip\noindent On peut rajouter un \texttt{strut} (règle
+ invisible) pour agrandir un des champs, ainsi que pour créer un
+ champ vide. La \cs{fbox} n'est là que pour indiquer la place
+ qu'occupe les \texttt{struts}, de même l'épaisseur du \cs{strut} de
+ 1 cm (au lieu de 0 cm normalement) permet de le visualiser :
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \umlState{%
+ Utilis. de \cs{strut}\rule[-2ex]{1mm}{6ex}%
+ }{%
+ \fbox{\rule{0cm}{2cm}\rule{4cm}{0cm}}%
+ }+
+ \end{SideBySideExample}
+
+ \noindent Une commande \cs{umlEmptyBox} est proposée pour créer
+ une boite vide (mais est-elle bien utiles ??)
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \umlState{Utilis. de \cs{umlEmptyBox}}{%
+ \fbox{\umlEmptyBox{4cm}{2cm}}%
+ }+
+ \end{SideBySideExample}
+
+
+ \bigskip\noindent
+ On peut spécifier une boite "paragraphe" de largeur 4 cm et
+ optionnellement de hauteur 2 cm dans le corps. Il faut mettre
+ un espace forcé pour que le paragraphe ne soit pas vide.
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \umlState{%
+ etat vide par \cs{parbox}%
+ }{%
+ \parbox[c][2cm]{4cm}{\ }%
+ }+
+ \end{SideBySideExample}
+
+ \bigskip\noindent
+ On peut utiliser \cs{hspace*} et \cs{vspace*}, c'est la solution la
+ plus précise.
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \umlState{\cs{hspace*} et \cs{vspace*}}{%
+ \hspace*{4cm}\vspace*{2cm}%
+ }%
+ +
+ \end{SideBySideExample}
+
+ On pourrait encore utiliser le saut de ligne paramétré |\\[2cm]|
+ (moins précis, mais pratique dans les tableaux.
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\iffalse
+\item[Exemples 4] \mbox{}
+
+ Un état dans une pspicture. L'option |[shidt=0.5\psyunit]| de pspicture permet de
+ positionner la ligne de base de la boîte \texttt{pspicture} à 50\%
+ de la hauteur total (si on met |[]|, la ligne de base passera par
+ l'origine (0,0)).
+
+ \bigskip\noindent
+ \begin{CenterExample}
+ \begin{pspicture}[shift=6.5](-7,-5)(6,5)\psgrid
+ \rput(0,3.5){\textbf{pspicture 1}}
+ \rput(0,-0.5){\umlState{Etat interne vide}{%
+ \rule{0cm}{5cm}\rule{6cm}{0cm}%
+ }}%
+ \rput(-1,-1){\umlState{Etat 1}{%
+ Contenu 1\\contenu 2%
+ }}%
+ \rput(-1,1){\umlStateIn}%
+ \rput(1,1){\umlStateOut}%
+ \end{pspicture}+%
+ \end{CenterExample}
+\fi
+
+\end{description}
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{\cs{umlCase} et \cs{umlCasePut}}
+
+\begin{description}
+ \item[Syntaxe] \mbox{}
+
+ \begin{verbatim}
+ \umlCase[keyOptions]{body}
+ \end{verbatim}
+
+ Permet un bloc de texte dans un oval. Cependant la boite \LaTeX{}
+ résultante est forcément rectangulaire (comme toute boite \LaTeX{}
+ : il n'est plus possible alors de créer simplement un ovalnode par
+ la suite, d'où la quasi-inutilité de cette commande.
+
+ \begin{verbatim}
+ \umlCasePut[keyOptions]{coord}{nodeName}{body}
+ \end{verbatim}
+
+ Permet un bloc de texte dans un ovalnode. Personnellement je n'ai
+ utilisé que cette commande pour créer (et surtout connecté) des
+ \textsf{use-case)}.
+
+ \item[Paramètres] \mbox{}
+
+ \begin{description}
+
+ \item[\texttt{coord} :] coordonnées du centre de la boite à
+ positionner.
+
+ \item[\texttt{nodeName} :] nom du node (au sens \pstricks{}).
+ Celui-ci sera utilsaé pour les connexions ultérieures.
+
+ \item[\texttt{body} :] texte éventuellement sur plusieurs
+ lignes séparées par des |\\| (utilisation en interne de la
+ commande \cs{umlStack}).
+
+ \end{description}
+
+ \item[Options] \mbox{} : pas d'option spécifique pour l'instant
+
+
+ \item[Bug] \mbox{}
+
+ \item[\`A faire] \mbox{}
+
+ \item[Exemples 1] \mbox{}
+
+ Voir fichier séparé
+
+\end{description}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{\cs{umlNote}}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\begin{description}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Syntaxe] \mbox{}
+
+ \begin{verbatim}
+ \umlNote[keyOptions]{noteBody}
+ \end{verbatim}
+ Permet de dessiner une note dans un ardre au coin corné.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Paramètres] \mbox{}
+
+ \begin{description}
+
+ \item[\texttt{noteBody} :] corps de la note. Il
+ peut contenir plusieurs lignes séparées par |\\|.
+
+ \end{description}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Options] \mbox{}
+
+ \begin{description}
+
+ \item[\texttt{umlNoteCoin} (dimension: 1.5ex )]~: (NON
+ IMPL\'EMENT\'E) coin du petit carré replié.
+
+ \end{description}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Bug] \mbox{}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[\`A faire] \mbox{}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Exemples 1] \mbox{}
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \umlNote{Ceci est \\ un \\ exemple de note}%
+ +
+ \end{SideBySideExample}
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \umlNote[linewidth=2pt,umlAlign=c]{%
+ Ceci est \\ autre exemple \\ de note%
+ }%
+ +
+ \end{SideBySideExample}
+
+
+\end{description}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Les commandes auxiliaires de \pstuml{}}
+
+Ces commandes ne permettent pas de créer des boites
+au sens \uml{}, mais simplifient la vie lors du dessin des différents
+type de diagrammes.
+
+\subsection{\cs{umlStack}}
+
+\begin{description}
+\item[Syntaxe] \mbox{}
+
+ \begin{verbatim}
+ \umlStack[keyOptions]{stackBody}
+ \end{verbatim}
+
+ permet de mettre du texte sur plusieurs lignes dans un boite sans
+ avoir d'espace supplémentaire en utilisant un environnememt
+ \texttt{tabular}. Par rapport à la commande \LaTeX{} \cs{shortstack},
+ l'espacement entre ligne n'est pas nul et est régulier.
+
+\item[Paramètres (un seul)] \mbox{}
+
+ \begin{description}
+
+ \item[\texttt{stackBody} :] corps de la boite. Il
+ peut contenir plusieurs lignes séparées par |\\|.
+
+ \end{description}
+
+\item[Options] \mbox{}
+
+ \begin{description}
+
+ \item[\texttt{umlStackSep} (dim : 0)] : distance de séparation
+ entre le contenu de la boite et le bord (pour une frame
+ éventuelle).
+
+ Cette option utilise d'une part l'option \texttt{tabcolsep} de
+ \texttt{tabular} pour régler l'espacement sur les bords
+ verticaux, et d'autre part des \texttt{strut} pour rajouter
+ des espacements horizontaux avant la première ligne et après la
+ dernière ligne.
+
+ \item[\texttt{umlStackWidth} (dim : 0)] : largeur de la boite.
+ La valeur 0 indique une largeur automatique en fonction du contenu.
+
+ \item[\texttt{umlStackLinesStretch} (réel : 0.85)] : écart
+ relatif de l'espace interligne par rapport à un tableau normal.
+ La valeur par défaut de 0.85 permet de tasser suffisamment tout en
+ permettant une marge pour absorber les différences de profondeur ou
+ de hauteur des différentes
+ lettres (x, g, j, h, t, ...)
+
+ \item[\texttt{umlAlign} (l, c, r : c)] : alignement horizontal
+ du texte à l'intérieur de la boite.
+
+ \item[\texttt{umlPos} (t, c, b : c)] : alignement vertical
+ de la boite par rapport à la ligne de base.
+
+ \end{description}
+
+\item[Bug] \mbox{}
+
+\item[\`A faire] \mbox{}
+
+
+\item[Exemples 1 : comparaison de \cs{umlStack}, \cs{shortstack}
+ et \texttt{tabular}] \mbox{}
+
+ Dans les exemples suivants, les \cs{umlStack} utilsée sont
+ entourée d'une \cs{fbox} ayant une \cs{fboxsep} nulle de façon à
+ bien visualiser les limites réelles de la boite produite.
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \setlength{\fboxsep}{0pt}\fbox{%
+ \umlStack{Ceci est \\ un \\ exemple \\
+ de stack}%
+ }+%
+ \end{SideBySideExample}
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \setlength{\fboxsep}{0pt}\fbox{%
+ \shortstack{Ceci est \\ un \\ exemple \\
+ de stack}%
+ }+%
+ \end{SideBySideExample}
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +%
+ \setlength{\fboxsep}{0pt}\fbox{%
+ \begin{tabular}{c}
+ Ceci est \\ un \\ exemple \\
+ de stack
+ \end{tabular}%
+ }+%
+
+ \end{SideBySideExample}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Exemples 2 : utilisation des options] \mbox{}
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +\setlength{\fboxsep}{0pt}\fbox{%
+ \umlStack[
+ umlStackSep=1.5ex,
+ umlAlign=r,
+ umlPos=t,
+ umlStackLinesStretch=.9,
+ ]%
+ {Ceci est \\ un \\ autre \\
+ exemple \\ de stack}%
+ }+
+ \end{SideBySideExample}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\item[Exemples 3 : bug avec alignement à droite et
+ largeur imposée] \mbox{}
+
+ \begin{SideBySideExample}[xrightmargin=6cm]
+ +\setlength{\fboxsep}{0pt}\fbox{%
+ \umlStack[
+ umlStackWidth=4,
+ umlStackSep=1.5ex,
+ umlAlign=r,
+ ]%
+ {Ceci est \\ un \\ autre \\
+ exemple \\ de stack}%
+ }+
+ \end{SideBySideExample}
+
+\end{description}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Positionnement des objets}
+
+
+Le placement des différents objets peut se faire selon quatre méthodes :
+\begin{itemize}
+
+\item soit en utilisant les positions absolues dans un environnememnt
+|psgraphics| à l'aide de la commande \cs{rput} pour placer les objets et
+\cs{rnode} pour leur affecter un nom de noeud (en vue d'une future
+référence pour les connexions) ;
+
+\item soit à l'aide des commandes de haut niveau fournie par \pstricks{}
+à savoir l'environnement |psmatrix| et la commande \cs{pstree} ;
+
+\item soit à l'aide de commandes de placement relatif fournies par
+\pstuml{} (Merci à Denis \textsc{Girou}) ;
+
+
+\item soit tout simplement dans le texte comme dans certains exemples
+montrés précédement (en mode LR au sens \LaTeX{}).
+
+\end{itemize}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{Utilisation de \texttt{psgraphics} et \cs{rput}}
+
+
+Il consiste à plasser les boîtes (précédemment créés ou non) dans un
+environnement \texttt{pspicture} à l'aide des commandes \cs{rput}. La
+macro \cs{psgrid} (compte tenu des options prédéfinies par le package
+\pstuml{}) permet de visualiser une grille de 1cm de coté. Cette grille
+pourra être commentée une fois la mise au point de la figure terminée.
+Dans cet exemple, les objets sont créés au moment du placement car il
+sont simples. On remarque la création (par \cs{psdot})d'un noeud
+ponctuel "pnode1" invisible sur le graphique, mais qui pourra être
+utilisé comme point de connexion intermédiaire (le petit cercle n'est
+là que pour sa visualisation).
+
+\begin{CenterExample}
+ % positionnement des classes
+ \begin{pspicture}(17,5)\psgrid
+ \rput(3,3){\rnode{Objet1}{\umlClass{Objet 1}{}}}
+ \pnode(16.5,4.5){pnode1}\psdot(pnode1)% pour visu
+ \rput(9,4){\rnode{Objet2}{\umlClass{Objet 2}{}}}
+ \rput(2,1){\rnode{Objet3}{\umlClass{Objet 3}{}}}
+ \rput(12,1){\rnode{Objet4}{\umlClass{Objet 4}{}}}
+ \rput(5.5,1.5){\rnode{Objet5}{\umlClass{Objet 5}{}}}
+ %
+ \rput(15,2.5){\rnode{Objet6}{\umlActor{Objet6}}}
+ \end{pspicture}
+ %
+\end{CenterExample}
+
+% \clearpage
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\subsection{Utilisation de \texttt{psmatrix}}
+
+% % Ceci est un paragraphe avant psmatrix.
+% %
+Les boites précédemment définies peuvent être positionnées à l'aide
+des macros de haut niveau de \pstricks{} telles que les environnements
+\texttt{psmatrix} ou \texttt{psTree}.
+
+Ces macro sont plus simples à utiliser, mais sont moins souple au
+niveau du placement. Voici un exemple de placement utilisant
+l'environnement \texttt{psmatrix}. On peut remarquer l'utilisation
+d'une longueur négative pour la séparation des colonnes, ainsi que le
+changement possible de la longueur d'une seule colonne. De même, un
+changement d'espacement pour une ligne particulière peut se faire par
+\verb:\\[2cm]: ou même \verb:\\[-1cm]:.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\begin{CenterExample}
+ \psshadowbox[framesep=0]{
+ \begin{psmatrix}[rowsep=0.3,colsep=-0.5,mnode=r]
+ % Dessin de classes predefinies
+ [name=Chose1] Chose 1 & & & [colsep=2,name=P1] \\
+ & [name=Chose2] \pscirclebox{Chose 2} \\[2cm]
+ [name=Chose3] \umlClass{Chose 3}{} & & [name=Chose4] Chose 4
+ \end{psmatrix}
+ % Visualisation d'un moeud ponctuel invisible par un X :
+ \ncput{pnode1}{$\times$}
+ }
+\end{CenterExample}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Utilisation des commandes de placement relatif}
+
+
+Les lettre E, N, W et S sont utilisés à la place de Right, Left, ...
+pour des raisons de cohérence avec les commandes de connexion du style
+\cs{ncNE} vues plus loin. Les commandes de gestion du placement
+relatif sont les suivantes :
+
+\begin{itemize}
+ \item affectation en absolu du point courant par rapport à l'origine
+ (fixée à (0,0) pour l'instant) : \cs{ResetXY}, \cs{SetX},
+ \cs{SetY}, \cs{SetXY} en cours) ;
+
+ \item accés au point courant par \cs{X} et \cs{Y} ;
+
+ \item les commandes de base : \cs{incrX}, \cs{incrY}
+ (sont utilisées par les quatre suivantes) ;
+
+ \item les déplacements relatifs \cs{moveE},
+ \cs{moveN}, \cs{moveW}, \cs{moveS} ;
+
+ \item positionnement d'un objet au point courant \cs{rputXY}.
+
+ \item A FAIRE \cs{SetXY} pour l'affectation absolue du
+ point courant à partir d'une cordonnée d'un nom de node mémorisé.
+ Je n'ai pas trouvé la commande interne à \pstricks{} permettant de
+ convertir les coordonnées à partir d'un nom d'un node en
+ coordonnées X ou Y pour le point courant : (help) ;
+
+ \item A FAIRE \cs{setOri} pour changer la position de l'origine. Cela
+ affecte donc les commandes de positionnement absolues telles que
+ \cs{resetXY}. Le but est d'affecter l'origine à un noeud précédement
+ créé par un \cs{pnode} ou autre \cs{rnode} ;
+
+ Note : vérifier si l'option \texttt{origin=\{coor\}} de \pstricks{}
+ ne conviendrait pas !
+
+
+ \item A FAIRE \cs{move} (vers une direction incrémentale
+ arbitraire pouvant utiliser les coordonnées polaires ;
+\end{itemize}
+
+\begin{SideBySideExample}[xrightmargin=7cm]
+ \begin{pspicture}(-3,-3)(3,3)\psgrid
+ \ResetXY % X and Y are rest at startup
+ \rputXY{\pscirclebox{1}}
+ \moveE{2} \rputXY{\pscirclebox{2}}
+ \moveN{2} \rputXY{\pscirclebox{3}}
+ \moveW{2} \rputXY{\pscirclebox{4}}
+ \moveW{2} \rputXY{\pscirclebox{5}}
+ \moveS{2} \rputXY{\pscirclebox{6}}
+ \moveS{2} \rputXY{\pscirclebox{7}}
+ \moveE{2} \rputXY{\pscirclebox{8}}
+ \moveE{2} \rputXY{\pscirclebox{9}}
+ \end{pspicture}
+\end{SideBySideExample}
+
+\begin{SideBySideExample}[xrightmargin=7cm]
+ \begin{pspicture}(-3,-5)(3,5)\psgrid
+ %
+ \ResetXY % Don't forget !
+ %
+ \rputXY{\psovalbox{1: start}}
+ %
+ % mixing absolute and relative coords
+ \SetX{2}\SetY{2}\moveN{2}
+ \rputXY{\psframebox[linewidth=2pt]{Pos2}}
+ %
+ % use of negative coord, and coord with
+ % explicit units (10mm)
+ \moveW{4}\moveS{4}\moveE{-10mm}\moveE{1}
+ \rputXY{\Large 3}
+ % use of current coord X and Y as params
+ % for not using "\rputXY"
+ % (or for calcul : to be tested) :
+ \pscircle(\X,\Y){0.5}
+ %
+ % memorisation par un node
+ \moveE{4}\moveN{2}
+ \rputXY{\pnode{P4}}
+ \rputXY{P4}
+ \rputXY{\pscircle{0.5}}
+ %
+ % mixing absolute (SetX) and relative (moveN)
+ \SetX{-1.5}\moveN{1.5}
+ \rputXY{\pscirclebox{UN CERCLE}}
+ %
+ % use of current coord X and Y in calcul
+ % (doesn't work yet) :
+ \SetX{-2}\SetY{-2.5}
+ % \pssetlength allows \X+2 insteed of \X+2cm
+ \newlength{\tmpX}\setlength{\tmpX}{\X}
+ \newlength{\tmpY}\setlength{\tmpY}{\Y}
+ \psaddtolength{\tmpX}{5}
+ \psaddtolength{\tmpY}{1}
+ \rputXY{\pscircle{0.1}} % at curent point
+ \rputXY{%
+ \psframe(0,0)(\tmpX,\tmpY)%
+ }
+ %
+ % acces direct to a memorised point
+ % NOT YET DONE
+ % \SetXY{P4}
+ % \rputXY{\pscirclebox{UN CERCLE}}
+ %
+ \end{pspicture}
+\end{SideBySideExample}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Les connecteurs orthogonaux}
+
+
+En plus des divers connecteurs proposés par \pstricks{} tels que
+\cs{ncline}, \cs{ncbar}, \cs{ncdiag}, \cs{ncdiagg}, \cs{ncangle},
+\cs{ncangles} et \cs{nccurve} ; \pstuml{} propose un certain nombre de
+connecteurs basés sur les précédents (par \cs{newpsobject}).
+
+Le but est de simplifier le tracé des liens en se restreingnant aux
+directions horizontales et verticales. Le principe est d'indiquer
+dans le nom même de la commande le nombre de segments à tracer et
+leur direction.\\
+Par exemple, la première lettre (\texttt{E} dans \cs{ncEVW}) indique
+que le segment part vers l'Est, tourne verticalement (\texttt{V} : vers
+le haut ou vers le bas) puis tourne vers l'Ouest \texttt{W} pour se
+connecter.
+
+\begin{itemize}
+
+\item E, W, N, S pour Est, West, North, Sud,
+\item H, V pour Horizontal et Vertical,
+\item D pour diagonal,
+\item X pour indifférent.
+
+\end{itemize}
+
+\bigskip\noindent
+Les commandes suivantes sont proposées :
+
+\begin{itemize}
+
+\item un seul segment : \cs{ncE} \cs{ncW} \cs{ncN} \cs{ncS}
+
+\item deux segments : \cs{ncEN} \cs{ncES} \cs{ncWN} \cs{ncWS} \cs{ncNE}
+ \cs{ncNW} \cs{ncSE} \cs{ncSW}
+
+\item trois segment en U : \cs{ncEVW} \cs{ncWVE} \cs{ncSHN} \cs{ncNHS}
+
+\item trois segments en Z : \cs{ncEVE} \cs{ncWVW} \cs{ncNHN} \cs{ncSHS}
+
+\item trois segments en diagonale : \cs{ncEDE} \cs{ncWDW} \cs{ncNDN}
+ \cs{ncSDS}
+
+\item quatre segments (voir trois) : \cs{ncSXE} \cs{ncSXW} \cs{ncEXS}
+ \cs{ncEXN} \cs{ncWXS} \cs{ncWXN} \cs{ncNXE} \cs{ncNXW}
+
+\end{itemize}
+
+\subsubsection*{Bug}
+
+La position par défaut des labels (utilisée par des \cs{naput}...)
+peut être affectée : dans ce cas imposer le positionnement explicitement
+par :
+
+ |\ncE{nodeA}{nodeB}\naput[npos=0.5]{myLabel}|
+
+
+De même, dans les commandes à trois segments, quatre segments sont
+réellement dessinés : en cas de problème de positionnement des labels,
+il peut être utile d'imposer |armB=0| (en attendant un raffinement de
+ces commandes orthogonales).
+
+\subsection*{Exemples 1}
+
+A FAIRE (voir listing de dessin de classe ci-aprés)
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Essais d'icones "flèches" sur des courbes}
+
+Après des tentatives infructueuses (pour l'instant) de définir de
+nouvelle vraie flèche au sens \pstricks{} (sans passer par postscript :
+en n'utilisant que des commande \TeX{}), je propose une commande
+\cs{ncputicon} basée sur la command \cs{ncput}. Par défaut, l'icone est
+positionnée en début de connecteur (cf. Bug ci-dessous)
+
+\subsection*{Bug}
+
+\subsection*{\`A faire}
+
+Je souhairais que par défaut l'icone soit positionnée en fin de
+connecteur en mettant par exemple |\psset{npos=5}|. Cela ne marche pas
+pour tous les connecteurs (les \cs{ncline} et les \cs{nccurve}). C'est
+pour cette raison que la position par défaut est en début de connecteur
+(peut-être existe-t-il une variable \pstricks\ qui indique le nombre
+total de segments présents dans le dernier connecteur utilisé ??).
+
+\subsection*{Exemples 1}
+
+\begin{SideBySideExample}[xrightmargin=6cm]
+ \begin{pspicture}(0,0)(5,5)\psgrid
+ \rput[bl]{30}(0.5,0){\rnode{Node1}{%
+ \psframebox{\Large Node1}}}
+ \rput[tr]{45}(4.5,4){\rnode{Node2}{%
+ \psframebox{\Large Node2}}}
+
+ \nccurve[angleA=-45,angleB=135]{Node1}{Node2}
+ \ncput[nrot=:U,npos=0.8]{mylabel}
+ \ncputicon{umlHerit}
+
+ \nccurve[angleA=-30,angleB=-90]{Node2}{Node1}
+ \ncputicon{umlAgreg}
+
+ \nccurve[angleA=135,angleB=-135]{Node1}{Node2}
+ \ncputicon{umlCompos}
+ \ncputicon[nrot=:U,npos=0.7]{umlV}
+
+ \end{pspicture}
+\end{SideBySideExample}
+
+% \subsection*{Exemples 2}
+% A FAIRE (voir listing de dessin de classe ci-aprés)
+%
+%
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Principales commandes \pstricks{} utilisées (A FAIRE)}
+
+\cleardoublepage
+
+\appendix
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\section{Exemple de diagramme de classe}
+
+\input{diagClass.tex}
+\VerbatimInput[gobble=0]{diagClass.tex}
+
+% % % % % % % % % \end{document}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\clearpage
+\section{Exemple de diagramme des cas d'utilisation}
+
+
+\input{diagCase.tex}
+\VerbatimInput[gobble=0]{diagCase.tex}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\clearpage
+\section{Exemple de diagramme de séquences}
+
+
+\input{diagSeq.tex}
+\VerbatimInput[gobble=0]{diagSeq.tex}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\clearpage
+\section{Exemple de diagramme d'états}
+
+
+\input{diagState.tex}
+\VerbatimInput[gobble=0]{diagState.tex}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\clearpage
+\section{Listing du package \texttt{pst-uml.sty}}
+
+\VerbatimInput[%
+ baselinestretch=0.9,%
+ fontsize=\small,%
+ gobble=0% nbr de caratere de debut a ignorer
+]{pst-uml.sty}
+pour connaitre le numero de la derniere page
+\label{verylast}\mbox{}
+
+\end{document}
+
+% PRESSE-PAPIER :
+%
+% \begin{SideBySideExample}[xrightmargin=6cm]
+% \begin{pspicture}(0,0)(5,5)\psgrid
+%
+% \end{pspicture}
+% \end{SideBySideExample}
+% \begin{CenterExample}
+% \begin{pspicture}(0,0)(5,5)\psgrid
+%
+% \end{pspicture}
+% \end{CenterExample}
+
+%%%% EXEMPLE DE DESCRIPTION DE COMMANDE :
+%
+% \begin{description}
+% \item[Syntaxe] \mbox{}
+%
+% \begin{verbatim}
+% \umlClass[keyOptions]{title}{body}
+% \end{verbatim}
+%
+% Permet de dessiner une classe.
+%
+% \item[Paramètres (un seul)] \mbox{}
+%
+% \begin{description}
+%
+% \item[\texttt{title} :] nom de la classe, celui-ci sera centré
+% et écrit en gras. Il peut tenir sur plusieurs lignes.
+%
+% \item[\texttt{body} :] corps de la classe propremment dit. En
+% particulier contient les attributs et méthodes justifiées à gauche.
+% Les différentes lignes sont séparées par |\\| et éventuellement
+% des |\hline|.
+% \end{description}
+%
+% \item[Options] \mbox{}
+%
+% \begin{description}
+%
+% \item[\texttt{umlShadow} (boolean : true)] :
+% si vrai, un cadre ombré de fond gris entoure la classe \\
+% sinon, un cadre simple sur fond blanc est utilisé.
+%
+% \end{description}
+%
+% \item[Bug] \mbox{}
+%
+% \item[\`A faire] \mbox{}
+%
+% \item[Exemples 1] \mbox{}
+%
+% \end{description}
+