%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%	Ce fichier contient la definition de l'environnement LaTeX\ 
% utilise' ainsi que les appels des fichiers a inclure pour
% l'e'laboration du guide d'utilisation des macros colorrgb.tex
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\font\myl=manfnt
\def\panneau{{\myl\char"7F}}
\def\lettrepanneau{\noindent\hangindent=8mm\hangafter=-2
\hskip-8mm\smash{\raise-2mm\hbox to 8mm{\panneau\hfill}}\ignorespaces}

	\input{colorrgb.tex}
	\documentstyle[12pt,mancolor]{colorrap}

% format standard, centre'
	\setlength{\oddsidemargin}{1mm}
	\setlength{\evensidemargin}{1mm}
	\setlength{\textwidth}{160mm}
	\setlength{\textheight}{230mm}
	\setlength{\topmargin}{-18mm}

% 1 mm entre chaque paragraphe
	\setlength{\parskip}{1mm}
	\pagestyle{headings}
\def\ggf{\raise.4ex\hbox{%
        $\scriptscriptstyle\langle\!\langle\;$}}
\def\gdf{\raise.4ex\hbox{%
        $\scriptscriptstyle\;\rangle\!\rangle\;$}}

\begin{document}
\date{17 d\'ecembre 1993}

\begin{titlepage}
    \vspace*{1.0in}
    \begin{flushright}
          {\huge\bf ColorRgb.\TeX ~: guide d'utilisation
des macros de mise en couleur} \\[.25cm]
          {\rule[.1in]{4.5in}{.02in}}\\[.25cm]
          {\large\bf Manuel de R\'ef\'erence} \\[2.0cm]
          {\large\bf Version 3.3} \\[2.5cm]
          {\bf Christophe C\'erin}\\[7mm]
	  {Universit\'e de Picardie}\\
	  {Facult\'e de Math\'ematique et d'Informatique}\\
	  {Lamifa}\\
          {33, rue St Leu -- 80039 Amiens}\\
          {tel : 22-82-75-03}\\
	  \&\\
          {Universit\'e de Paris Sud}\\
          {LRI bat 490}\\
	  {91405 Orsay - France}\\
	  {mail : cerin@lri.lri.fr}\\
	  {tel : 69-41-70-82}
    \end{flushright}
\end{titlepage}

\pagenumbering{roman}

\chapter*{Petite histoire de ces macros}

Dans un article des Cahiers Gutenberg \cite{cc}, nous pr\'esentions les
avantages d'utilisation de la couleur dans le traitement de texte \TeX\ au
travers de deux jeux de macros~: color\-rgb.tex et co\-lorcmyk.tex
fonctionnant pour les imprimantes couleur PostScript des cons\-truc\-teurs
QMS, Oc\'e, Hitachi, Seiko.

Dans cet article, nous discutions de la couleur en g\'en\'eral, comment la
sp\'ecifier, la repr\'esen\-ter, puis, nous d\'egagions des classes de
probl\`emes qui appellent des classes de solutions communes, des
algorithmes communs. Cela nous conduisait \`a proposer un ensemble minimal
de primitives permettant de r\'esoudre les probl\`emes identifi\'es
suivants~: action sur une entit\'e syntaxique (lettre, mot, phrase,
paragraphe) et action sur une entit\'e graphique~: vecteur ou fl\`eche de
l'environnement \verb!picture! de \LaTeX .

Au moyen des constructeurs de base \verb[\begincolor[ et \verb[\endcolor[,
nous r\'ealisions des d\'egrad\'es de couleur sur des cha\^\i nes de
caract\`eres~: la couleur d'une lettre d\'epend de celle de ses voisines
ou, plus g\'en\'eralement, de param\`etres sp\'ecifiant l'interaction des
couleurs.

La version 2.9 des macros b\'en\'eficiait de l'ajout de primitives comme
la cr\'eation de bo\^\i tes en couleur contenant du texte dans une couleur
diff\'erente. Vous trouviez \'egalement des macros pour \'ecrire du texte
sur un fond d\'egrad\'e et des primitives pour dessiner des courbes de
Bezier en couleur et en particulier des contours ferm\'es quelconques,
des cercles hachur\'es ainsi que la possibilit\'e de placer du texte le
long d'une courbe.

Les principaux ajouts de la version 3.3 sont les suivants : dessins de
fl\`eches compos\'es d'un spline et d'un symbole de fl\`eche, le symbole
de la fl\`eche pouvant \^etre positionn\'e n'importe o\`u le long du
spline. Nous proposons \'egalement une macros pour dessiner la
repr\'esentation graphique d'une fonction math\'ematique et diverses
solutions pour tracer des \'echelles gradu\'ees et des grilles ainsi que
des macros pour tracer des boites 3D orientables. Vous disposez aussi de
macros pour dessiner d'une part des logos de fl\`eches (il y a une macro
pour positionner ces logos dans la marge gauche) et d'autre part des logos
de stations de travail, de disque, de serveur et de routeur.

L'implantation des constructeurs initiaux propos\'ee est r\'ealis\'ee en
partie avec Post\-Script, par l'interm\'ediaire de la commande
\verb[special[ dans la syntaxe reconnue par le translateur
\verb[dvips 5.4x[ de Tom Rokicki, et en \TeX . L'ensemble des macros est
\'ecrit pour fonctionner avec \LaTeX .

\raggedbottom
\pagenumbering{arabic}
\pagestyle{headings}
%\chapter*{Description des macros}

\begin{manpage}{Librairie RGB}{Guide d'utilisation}{Version 3.3}

\subtitle*{Mod\`eles RGB, CMYK et HSB}

Ce module d\'ecrit l'ensemble des primitives qui sp\'ecifient la couleur
dans les mod\`eles RGB, CMYK et HSB. Il est constitu\'e d'une partie
per\-met\-tant de d\'eclarer des variables, d'une partie permet\-tant
d'effectuer des initialisations sur ces variables et d'une partie qui
d\'ecrit la manipulation de la couleur sur des cha\^\i nes de caract\`eres.
Nous proposons ensuite les descriptions des macros graphiques puis nous
listons quelques macros de confort qui d\'eclarent des couleurs
pr\'ed\'efinies.

\subtitle*{Primitives de base pour le changement de couleur}

\function*{$\backslash$beginrgbcolor( \{rouge\}\{vert\}\{bleu\} ) }
Passage, dans le mod\`ele RGB, dans la couleur sp\'ecifi\'ee par les
param\`etres.

\function*{$\backslash$endrgbcolor( {} ) }
Retour \`a la couleur avant l'appel \`a \verb|\beginrgbcolor|.

\function*{$\backslash$rgbcolor(\{rouge\}\{vert\}\{bleu\} ) }
Effectue un \verb|\beginrgbcolor| suivi d'un \verb|\endrgbcolor| sur le
groupe (cf d\'efinition d'un group dans \cite{mt}) courant.

\function*{$\backslash$beginhsbcolor(\{hue\}\{saturation\}\{brightness\} ) }
Passage, dans le mod\`ele HSB, dans la couleur sp\'ecifi\'ee par les
param\`etres.

\function*{$\backslash$endhsbcolor( {} ) }
Retour \`a la couleur avant l'appel \`a \verb|\beginhsbcolor|.

\function*{$\backslash$begincmykcolor(\{cyan\}\{yellow\}\{magenta\}\{black\} ) }
Passage, dans le mod\`ele CMYK, dans la couleur sp\'ecifi\'ee par les
param\`etres.

\function*{$\backslash$endcmykcolor( {} ) }
Retour \`a la couleur avant l'appel \`a \verb|\begincmykcolor|.

\subtitle*{D\'eclarations concernant les couleurs}

\function*{$\backslash$rouge(=int ) }
contient la valeur de la composante rouge.

\function*{$\backslash$vert(=int ) }
contient la valeur de la composante verte.

\function*{$\backslash$bleu(=int ) }
contient la valeur de la composante bleue.

\function*{$\backslash$increrouge(=long ) }
contient la valeur de l'incr\'ement du rouge.

\function*{$\backslash$increvert(=long ) }
contient la valeur de l'incr\'ement du vert.

\function*{$\backslash$increbleu(=long ) }
contient la valeur de l'incr\'ement du bleu.

\function*{$\backslash$modulo(=long ) }
valeur du nombre de lettres dans la m\^eme couleur.

\function*{$\backslash$maxrouge(=int ) }
contient la valeur de la composante rouge maximale.

\function*{$\backslash$maxvert(=int ) }
contient la valeur de la composante verte maximale.

\function*{$\backslash$maxbleu(=int ) }
contient la valeur de la composante bleue maximale.

\subtitle*{Primitives d'initialisation des couleurs}

\function*{$\backslash$initcolor(\{rouge\}\{vert\}\{bleu\} , \{maxrouge\}\{maxvert\}\{maxbleu\}\{modulo\} ) }
Proc\'edure d'initialisation des couleurs, des couleurs maximales et du
param\`etre \ggf modulo\gdf permettant de sp\'ecifier le nombre de 
caract\`eres devant \^etre imprim\'es dans la m\^eme couleur.

\function*{$\backslash$initinc(\{rouge\}\{vert\}\{bleu\} ) }
Proc\'edure d'initialisation des valeurs d'incr\'ement de chaque couleur 
par des valeurs de type \verb+int+.

\subtitle*{D\'eclarations concernant la forme des traits}

Pour certaines primitives pr\'esent\'ees plus loin, vous avez la
possibilit\'e d'affecter la forme des traits en appelant d'abort les
\hbox{primitives suivantes :}

\function*{$\backslash$CCap,$\backslash$Join( {} ) }
Ces variables permettent de modifier la forme des bouts de traits
et la forme des jointures entre traits. Les seules valeurs
autoris\'ees sont $0,1$ et $2$ (cf op\'erateurs PostScript \verb|setlinecap| 
et \verb|setlinejoin|). Par d\'efaut, ces valeurs sont fix\'ees comme suit :
\verb|\CCap=1\Join=1|.

\function*{$\backslash$InitCapJoinMatrix(\{cap\}\{join\} ) }
Cette macro r\'ealise l'initialisation des variables \verb|CCap, Join|.

\function*{$\backslash$SetCapJoinMatrix(\{cap\}\{join\} ) }
Cette macro permet de modifier, au niveau du code PostScript, les valeurs
des formes des traits en ex\'ecutant les ordres \verb|setlinecap| et
\verb|setlinejoin|.

\subtitle*{Couleur sur les cha\^\i nes}

\function*{$\backslash$fboxcolor(\{texte\}\{rouge\}\{vert\}\{bleu\} ) }
Boite dont le contour est trac\'e en couleur. La macro est inspir\'ee de
la macro \LaTeX\ \verb[\fbox[ et elle utilise les variables \verb[\fboxrule[
et \verb[\fboxsep[. Elle ne peut donc s'utiliser que sous \LaTeX .

\function*{$\backslash$boxcolor(\{texte\}\{rouge\}\{vert\}\{bleu\} ) }
Boite dont le contenu est en couleur. Cette macro est inspir\'ee de la macro
\LaTeX\ \verb[\fbox[ et elle utilise les variables
\LaTeX\ \verb[\fboxrule[ et \verb[\fboxsep[. De plus, on utilise une
nouvelle bo\^\i te \verb[\@myboxb[ et une nouvelle dimension \verb[\@mydimb[
afin d'\'eviter certains conflits de variables si l'on effectue un
\verb[\fbox{}[ de la bo\^\i te en couleur.

\function*{$\backslash$underlinecolor(\{texte\}\{rouge\}\{vert\}\{bleu\} ) }
Le texte \verb[texte[ est soulign\'e en couleur.

\function*{$\backslash$dentdescie(\{texte\} ) } 
Cette proc\'edure prend une cha\^\i ne de caract\`eres et imprime les \ggf
mo\-du\-lo\gdf premiers caract\`eres dans la couleur sp\'ecifi\'ee par les
trois compo\-santes rouge, vert, bleu d\'efinies au moyen de la primitive
\hbox{\verb[\initcolor[ ;} puis d\'ecr\'emente chaque composante d'une valeur
sp\'ecifi\'ee au moyen de la primitive \verb[\initinc[ et imprime encore
\ggf mo\-du\-lo\gdf caract\`eres dans cette nouvelle couleur jusqu'\`a ce
que \ggf modulo\gdf atteigne une valeur maximale. Dans ce cas, on
recommence l'affichage des \ggf mo\-du\-lo\gdf pre\-miers caract\`eres
sui\-vants \`a partir de la couleur initiale sp\'e\-ci\-fi\'ee par les trois 
premiers param\`etres de la primitive \verb[\initcolor[.

\function*{$\backslash$echelon(\{texte\} ) }
Cette proc\'edure prend une cha\^\i ne de caract\`eres et imprime les
\ggf mo\-du\-lo\gdf premiers caract\`eres dans la couleur sp\'ecifi\'ee
par les trois compo\-santes rouge, vert, bleu d\'efinies au moyen de la
primitive \hbox{\verb+\initcolor+ ;} puis incr\'emente chaque composante d'une
valeur d\'efinie au moyen de la primitive \verb+\initinc+ et imprime
encore \ggf modulo\gdf ca\-rac\-t\`e\-res dans cette nouvelle couleur jusqu'\`a
ce que \ggf modulo\gdf atteigne une borne max. Dans ce cas, on recommence
l'affichage des \ggf modulo\gdf ca\-rac\-t\`e\-res suivants en d\'ecr\'ementant
les couleurs jusqu'aux valeurs initiales qui sont sauvegard\'ees dans les
variables \verb+\sauvxxx+. La varia\-ble globale \verb+\sens+
initialis\'ee \`a 1 d\'etermine un \'eclaircissement progressif des
couleurs alors que \verb+\sens+ = 0 d\'etermine un noircissement
progressif des couleurs.

\function*{$\backslash$degrade(\{texte\} ) }
Cette macro prend une cha\^\i ne de caract\`eres puis r\'epartit
uniform\'ement les gammes de couleurs d\'efinies par la primitive
\verb+\initcolor+ sur l'en\-sem\-ble de la cha\^\i ne.

\function*{$\backslash$longueur([texte] ) }
Cette macro calcule la longueur d'une cha\^\i ne de caract\`eres. Le
r\'esultat est rang\'e dans la variable globale \verb+\lg+. Le
param\`etre doit \^etre entre crochets.

\subtitle*{Comment cr\'eer des effets sp\'eciaux ?} 

Voici des macros qui effectue des d\'egrad\'es concentriques sur des
cercles ou lin\'eaires sur des bo\^\i tes.  L'utilisateur peut placer du texte
(\'eventuellement en couleur) au milieu des cercles ou des bo\^\i tes et
passer des bo\^\i tes \TeX\ comme param\`etres aux proc\'edures.

\function*{$\backslash$CercleCouleur( \{texte\}\{max\}\{min\}\{couleur\}\{nb-nuances\} ) }
Macro qui trace des cercles degrad\'es sous le texte \ggf texte\gdf
en commen\c cant par un grand cercle de couleur \ggf max\gdf jusqu'au 
petit cercle de couleur \ggf min\gdf en tracant \ggf nb-nuances\gdf
nuances de couleur \ggf couleur\gdf . Si le param\`etre de la couleur
vaut 1 on effectue un d\'egrad\'e en rouge, si le param\`etre de la couleur
vaut 2 on effectue un d\'egrad\'e en vert,  si le param\`etre de la couleur
vaut 3 on effectue un d\'egrad\'e en bleu. Remarquer que \ggf
nb-nuances\gdf doit \^etre > 0 pour \'eviter des divisions par 0 !

\function*{$\backslash$CercleGeneral( \{texte\}\{rouge\}\{vert\}\{bleu\} ,
\{maxrouge\}\{maxvert\}\{maxbleu\}\{nb-nuances\} ) } 
Cette macro trace des cercles degrad\'es sous le texte \ggf texte\gdf en
commencant par un grand cercle de couleur \ggf rouge, vert, bleu\gdf
jusqu'au petit cercle de couleur \ggf maxrouge, maxvert, maxbleu\gdf en
tracant \ggf nb-nuances\gdf nuances de couleur. Cette macro est une
g\'en\'eralisation de la pr\'ec\'edente que l'on conserve pour raison
historique.  De plus, l'utilisateur peut sp\'ecifier un d\'ecalage pour le centre du
cercle au moyen des variables \verb+\xtrans+ et \verb+ytrans+. On peut alors
obtenir l'effet d'une boule d\'egrad\'ee (cf exemples).
Remarquer que \ggf nb-nuances\gdf doit \^etre > 0 pour
\'eviter des divisions par 0 !

\function*{$\backslash$RectangleDegrade( \{texte\}\{rouge\}\{vert\}\{bleu\} ,
\{maxrouge\}\{maxvert\}\{maxbleu\}\{nb-nuances\} ) } 
Cette macro trace des rectangles d\'egrad\'es sous le texte \ggf texte\gdf
en commencant par un rectangle de couleur \ggf rouge, vert, bleu\gdf
jus\-qu'au rectangle de couleur \ggf maxrouge, maxvert, maxbleu\gdf en
tracant \ggf nb-nuances\gdf rectangles de couleur differentes. Pour
choisir le sens du d\'e\-gra\-d\'e (de gauche \`a droite ou de haut en bas),
vous utiliserez un bool\'een repr\'esent\'e en \TeX\ par
\verb+\ifhorizontal+. Si vous souhaitez un d\'egrad\'e de couleurs
dispos\'ees de haut en bas, vous \'ecrirez \verb+\horizontaltrue+ ; si
vous souhaitez une disposition de cou\-leurs de la gauche vers la droite,
vous \'ecrirez \verb+\horizontalfalse+ avant l'appel \`a
\verb+\RectangleDegrade+.  Remarquer que \ggf nb-nuances\gdf doit \^etre >
0 pour \'eviter des divisions par 0 !

\subtitle*{Tracer des courbes}

\function*{$\backslash$bezierps( \ liste $\backslash${\bf endbezierps} , 
\{wd\}\{dash1\}\{dash2\}\{red\}\{green\}\{blue\} ) }
Cette macro trace une courbe de bezier en couleur avec les points du 
param\`etre \verb+liste+  qui est un tableau de tableaux au sens PostScript. 
Le param\`etre \verb+wd+ contient la largeur des traits. 
Lorsque l'on veut tracer des courbes pointill\'ees, il faut
positionner le bool\'een \verb+\ifdashps+ \`a vrai (\verb+\dashpstrue+)
et \`a ce moment \verb+dash1+ sp\'ecifie la forme des pointill\'es (voir 
la commande Postscript \verb+setdash+) et \verb+dash2+ d\'efinit le 
d\'eplacement (\`a partir du d\'ebut du trait) apr\`es lequel
d\'ebutera le trac\'e. Si on a positionn\'e \verb+\dashpsfalse+ alors
la courbe est continue. Attention, les unit\'es sont des millim\`etres
et il faut un blanc avant \verb+\endbezierps+. Enfin,
l'ordre des param\`etres est :

\verb+\bezierps [ [ x0 y0 x1 y1 x2 y2 x3 y3 ]...] +\\
\quad\quad\quad\verb+\endbezierps {}{}{}{}{}+

avec les points $x_0,y_0,x_1,y_1$ d\'efinissant la premi\`ere tangente \`a
la courbe et les points $x_2,y_2,x_3,y_3$ d\'efinissant la deuxi\`eme
tangente \`a la courbe.

\function*{$\backslash$ellipseps(\{l\}\{h\}\{line\}\{dash\}\{deb\}\{rouge\}\{vert\}\{bleu\} ) }
Trace une ellipse avec les dimensions $(l,h)$. Le param\`etre $l$
repr\'esente la "largeur" de l'ellipse et $h$ la hauteur (exprim\'ees en
mm). Le param\`etre $line$ contient la largeur des traits. Lorsque l'on
veut tracer une ellipse en pointill\'ees, il faut positionner le boolean
\verb|\ifdashps| \`a vrai (faire la commande \verb|\dashpstrue|) et \`a ce
moment $dash$ contient le nombre total d'espaces noirs et d'espaces blancs
selon les unit\'es de mesures courantes ; $deb$ d\'efinit le nombre
d'unit\'es \`a placer en d\'ebut de trait. Ces deux param\`etres sont de
la forme [9] 4 ($dash = [9], deb=4$) car ils doivent correspondre aux
param\`etres de la commande PostScript \verb|setdash|. Si on a
positionn\'e \verb|\dashpsfalse| alors la courbe est continue.  Attention,
les unit\'es sont des MILLIMETRES. Le param\`etre ``rouge'' sp\'ecifie
l'intensit\'e du rouge qui remplit l'ellipse (cette valeur doit \^etre
inf\'erieure \`a
$256$), ``vert'' l'intensit\'e du vert (cette valeur doit \^etre inf\'erieure \`a $256$)
et ``bleu'' l'intensit\'e du bleu (valeur inf\'erieure \`a $256$). Enfin, le trait du
contour de l'ellipse est trac\'e dans la couleur actuelle d\'efinie par les
composantes \verb|\rouge, \vert, \bleu|.

\function*{$\backslash$Line( \ liste\ $\backslash${\bf endLine}\{larg\}\{dash\}\{deb\}\{rouge\}\{vert\}\{bleu\} ) }
Trace une ligne avec les points du param\`etre ``liste'' qui est un tableau
de tableaux. Le param\`etre ``larg'' contient la largeur des traits. Lorsque
l'on veut tracer des lignes pointill\'ees, il faut positionner le bool\'een
\verb|\ifdashps| a vrai au moyen d'un ordre \verb|\dashpstrue| et \`a ce
moment ``dash'' contient le nombre total d'espaces noirs et d'espaces
blancs selon les unit\'es de mesures courantes ; ``deb'' d\'efinit le nombre
d'unit\'es \`a placer en debut de trait (cf commande pr\'ec\'edente).  Si
on a positionner \verb|\dashpsfalse| alors la courbe est continue.
Attention les unit\'es sont des MILLIMETRES et il faut un blanc avant
\verb|\endLine|.  Le param\`etre ``rouge'' sp\'ecifie l'intensit\'e du
rouge du trait (cette valeur doit \^etre inf\'erieure \`a $256$), ``vert'' l'intensit\'e
du vert (cette valeur doit \^etre inf\'erieure \`a $256$) et ``bleu'' l'intensit\'e du
bleu (valeur inf\'erieure \`a $256$). Enfin les valeur courantes de \verb|CCap| et
\verb|Join| sont utilis\'ees pour le rendu des traits (cf commande
\verb|\SetCapJoinMatrix|)

Pour tracer une ligne bris\'ee il faut taper :
\begin{verbatim}
	\Line [ [ x0 y0 x1 y1 ] [ x1 y1 x2 y2 ] ...] \endLine{}{}...
\end{verbatim} 
En fait, cet appel provoque, en sous main, la r\'ep\'etition de la
fonction qui trace un trait.

\function*{$\backslash$CourbeRempliee( \ liste $\backslash${\bf endcourbe} ,
\{wd\}\{dash1\}\{dash2\}\{red\}\{green\}\{blue\} ) }
Trace une courbe ferm\'ee au moyen de courbes de Bezier avec les points
du param\`etre \verb+liste+ qui est un tableau de tableaux. Le param\`etre 
wd contient la largeur des traits du contour.  Lorsque l'on veut
tracer des courbes pointill\'ees, il faut positionner le bool\'een
\verb+\ifdashps+ \`a vrai (\verb+\dashpstrue+) et \`a ce moment
\verb+dash1+ sp\'ecifie la forme des pointill\'es (voir la commande
Postscript \verb+setdash+) et \verb+dash2+ d\'efinit le d\'eplacement (\`a
partir du d\'ebut du trait) apr\`es lequel d\'ebutera le trac\'e. Si on a
positionn\'e \verb+\dashpsfalse+ alors la courbe est continue. (cf
fonction \verb+\bezierps+). Attention, les unit\'es sont des millim\`etres et
il faut un blanc avant \verb+\endcourbe+. L'ordre des param\`etres est le
m\^eme que celui de la fonction \verb+\bezierps+. Le remplissage est
effectu\'e avec les couleurs sp\'ecifi\'ees par les trois derniers
param\`etres. Le contour est trac\'e dans la couleur actuelle d\'efinie par
les composantes \verb+\rouge, \vert, \bleu+. Le contour est ferm\'e si le
bool\'een \verb+\ifclosepath+ est positionn\'e \`a vrai
(\verb+\closepathtrue+). Enfin, tous les points sont en positions relatives
par rapport \`a $x_0,y_0$ contrairement aux points d\'efinissant les
tangentes dans la macro \verb+\bezierps+ et il faut respecter les blancs
\hbox{convenablement :}

\verb+\CourbeRempliee [ [ x0 y0 x1 y1 x2 y2 x3 y3 ]...] +\\
\quad\quad\quad\verb+\endcourbe{}{}{}{}{}+

\subtitle*{Les objets graphiques ``hachur\'es''}

\function*{$\backslash$CercleHachure( \{rayon\}\{wdrayon\}\{wd\}
\{angle\}\{r\}\{g\}\{b\}\{space\} ) }
Cette macro trace un cercle de rayon \verb+rayon+ mm et d'\'epaisseur
\verb+wdrayon+ mm, puis remplit ce cercle avec des hachures de largeur
\'egale \`a \verb+wd+ mm inclin\'ees de \verb+angle+ degr\'es. La couleur
est specifi\'ee par les param\`etres r, g, b. Le param\`etre \verb+space+
donne l'espacement entre les hachures. Les angles doivent \^etre compris
entre 0 et 180 degr\'es.

\function*{$\backslash$CarreHachure( \{ht\}\{wd1\}\{wd2\}
\{angle\}\{r\}\{g\}\{b\}\{space\} ) }
Cette macro trace un carr\'e de hauteur \verb+2*ht+ mm et d'\'epaisseur
\verb+wd1+ mm, puis remplit ce cercle avec des hachures de largeur \'egale
\`a \verb+wd2+ mm inclin\'ees de \verb+angle+ degr\'es. La couleur est 
specifi\'ee par les param\`etres r, g, b. Le param\`etre \verb+space+
donne l'espacement entre les hachures. Les angles doivent \^etre 
compris entre 0 et 180 degr\'es.

\subtitle*{Faire une rotation}

\function*{$\backslash$RotObj( \{angle\}\{texte\} ) }
Pour mettre du texte en rotation ou tout autre chose, programmez avec la
macro \verb+\RotObj+. Le point \`a partir duquel la rotation se fait
peut varier suivant l'appel \`a certaines macros : par d\'efaut ce point
est fix\'e au premier caract\`ere du texte. Par exemple, l'appel
\verb+\mc+ possitionne ce point au milieu de la cha\^\i ne, l'appel
\verb+\fc+ \`a la fin, et l'appel \verb+\dc+ au d\'ebut. Il y a seulement
cr\'eation d'une boite de largeur nulle, donc il n'y a pas de place de
r\'eserv\'ee pour l'objet. Voici un exemple de \hbox{programmation :}\\
\verb+\mc\RotObj{45}{\Huge\bf Exemple}+.

\subtitle*{Mettre automatiquement du texte le long d'une courbe}

\function*{$\backslash$TraceTexte( \{texte\}\{$x_0$\}\{$y_0$\}\{$x_1$\}\{$y_1$\}\{$x_2$\}\{$y_2$\}\{$x_3$\}\{$y_3$\} ) }
Cette macro r\'epartit pas \`a pas chaque caract\`ere de la cha\^\i ne
\verb+texte+ le long de la courbe sp\'ecifi\'ee par les 4 points
$x_0,y_0,x_1,y_1,x_2,y_2,x_3,y_3$ (cf macro \verb+bezierps+). La formule
math\'ematique de la courbe de Bezier est d\'eriv\'ee de la paire
d'\'equation cubique param\'etrique de param\`etre $t\, (0\leq t\leq 1)$
suivante\ :

\setbox2=\hbox{\it coordonn\'ees en x}
\setbox3=\hbox{\it coordonn\'ees en y}

$$
\begin{array}{ccl}
x(t) & = & a_{x}t^{3} + b_{x}t^{2} + c_{x}t + x_{0}\quad\quad\box2\nonumber\\
y(t) & = & a_{y}t^{3} + b_{y}t^{2} + c_{y}t + y_{0}\quad\quad\box3\nonumber
\end{array}
$$

Les points de contr\^ole sont d\'efinis par :

$$
\begin{array}{ll}
x_1=x_0+c_x/3 & y_1=y_0+c_y/3\nonumber\\
x_2=x_1+(c_x+b_x)/3 & y_2=y_1+(c_y+b_y)/3\nonumber\\
x_3=x_0+c_x+b_x+a_x & y_3=y_0+c_y+b_y+a_y\nonumber
\end{array}
$$

Pour chaque lettre \`a positionner, les diff\'erentes valeurs du
param\`etre $t$ sont calcul\'ees en fonction de la largeur des caract\`eres et de la
tantente \`a la courbe. Par exemple, supposons que l'on cherche \`a
positionner le caract\`ere \verb+c+ de la figure \ref{fd:one} page
\pageref{fd:one}. On connait la valeur $t'$ et les coordonn\'ees $(x',y')$
du point sur la courbe, obtenu au moyen des \'equations param\'etriques,
qui nous ont servi \`a positionner le carac\`ere \verb+a+. Pour calculer
la tangente, nous cherchons la valeur de $t''$ correspondant \`a un
d\'eplacement le long de la courbe \'egal \`a la longueur du caract\`ere
\verb+c+. Soit $(x'',y'')$ les coordon\'ees du point sur la courbe
associ\'e \`a $t''$. On pose\ :

\begin{equation}
tan (\alpha)=\frac{y' - y''}{x' - x''}\nonumber
\end{equation}

Le caract\`ere est positionn\'e \`a partir de $(x',y')$ en le faisant
pivot\'e de l'angle $\alpha$. On continue ce m\^eme traitement avec le
prochain caract\`ere de la cha\^\i ne \`a partir du point $(x'',y'')$. Les
conditions initiales sont : le premier caract\`ere \`a positionner est le
premier caract\`ere de la cha\^\i ne, $t=0$, l'angle est d\'etermin\'e au
moyen du proc\'ed\'e d\'ecrit plus haut et ne correspond pas \`a la
tangente d\'efinie par les points $x_0,y_0,x_1,y_1$ qui est la tangente au
point $x_0,y_0$ (un caract\`ere a une largeur non nulle).

La variable \verb+\BlancInterLettre+ vous permet de rajouter de l'espace
entre les caract\`eres. Par d\'efaut, sa valeur est fix\'ee \`a 1mm (on
rappelle que l'unit\'e de tous les param\`etres num\'eriques doit \^etre
le mm).

L'implantation est r\'ealis\'ee en \TeX\ pour ce qui est de l'application
r\'ecursive des calculs et de l'obtention de la largeur des caract\`eres.
Les calculs num\'eriques sont implant\'es, quant \`a eux, en PostScript.
L'utilisation successive, dans le corps de la macro, de plusieurs ordres
\verb+\special+ pour ins\'erer du code PostScript n\'ecessite des
traitements particuliers car l'implantation du \verb+\special+ introduit
des ordres de positionnement, en plus du code PostScript que l'on souhaite
ins\'er\'e, qui perturbent le bon fonctionnement. La macro a donc \'et\'e
test\'ee et ne fonctionne pour l'instant qu'avec le translateur
\verb+dvips 5.4+. De petits ajustements de ces macros sont n\'ecessaires pour
des versions ant\'erieures du translateur \verb!dvips!.

\function*{$\backslash$ColleTexte( \{texte\}\{$x_0$\}\{$y_0$\}\{$x_1$\}\{$y_1$\}\{$x_2$\}\{$y_2$\}\{$x_3$\}\{$y_3$\} ) }
Cette macro r\'epartit la cha\^\i ne \verb+texte+ le long de la {\bf
totalit\'e} de la courbe de Bezier sp\'ecifi\'ee par les points
$x_0,y_0,x_1,y_1,x_2,y_2,x_3,y_3$. Le calcul des diff\'erentes valeurs du
param\`etre $t$ est plus facile que dans le cas de la macro
\verb+TraceTexte+ : la nouvelle valeur du param\`etre est obtenue en
augmentant la derni\`ere valeur du param\`etre de la quantit\'e
$\displaystyle\frac{1}{\mid texte - 1\mid}$ (attention : une croissance
lin\'eaire de $t$ n'entraine pas n\'ecessairement un espacement identique
entre chaque caract\`ere du fait de l'\'equation cubique param\'etrique
utilis\'ee). Un exemple est pr\'esent\'e \`a la figure \ref{fd:one} page
\pageref{fd:one}.

\hbox to\textwidth{\hrulefill}
\lettrepanneau\ \`A partir de maintenant, les courbes trac\'ees
avec les macros qui suivent sont dans la couleur courante sp\'ecifi\'ee
par \verb|\rouge|, \verb|\vert|, \verb|\bleu|. Il convient donc de
positionner convenablement chacune de ces valeurs avant les appels.\par
\hbox to\textwidth{\hrulefill}

\subtitle*{Tracer des grilles et des \'echelles gradu\'ees}

On vous offre la possibilit\'e de tracer une grille sans graduations ou
bien de tracer une grille et des \'echelles gradu\'ees.  Pour tracer des
grilles, les variables suivantes sont utilis\'ees :

\begin{enumerate}
   \item \verb|\pasx| contient le ``pas'' d'espacement en (mm) pour les
gra\-dua\-tions de l'axe des x ; \verb|\pasy| contient le ``pas''
d'espacement en (mm) pour les graduations de l'axe des y ;
   \item \verb|\vinitx| et \verb|\vincx| contiennent respectivement les
valeurs initiales et d'incr\'ementation des puissances sur l'axe des x ;
   \item \verb|\vinity| et \verb|\vincy| contiennent respectivement les
valeurs initiales et d'incr\'ementation des puissances sur l'axe des y ;
\end{enumerate}

La macro de base pour tracer une grille est la suivante :

\Function*{$\backslash$Grille! (larg ,haut)(esp-x ,esp-y)\{dash1\}\{dash2\}\{wd\} ! }
Trace une grille au point courant sur larg mm en largeur et de haut mm
en hauteur. Les lignes de la grille sont espac\'ees de esp-x mm selon l'axe
des x et de esp-y mm selon l'axe des y. Les param\`etres dash1 et dash2 
sont les  param\`etres du setdash dans le cas ou l'on souhaite tracer 
des lignes pointill\'ees : dans ce cas, le bool\'een \verb|dashps| doit \^etre
positionn\'e \`a true. wd est la largeur des traits.

\Function*{$\backslash$GridNumNum! (x1 ,y1)(l ,h)(esp-x ,esp-y)\{dash1\}\{dash2\}\{wd\} ! }
Trace une grille avec des \'echelles gradu\'ees au point $(x1,y1)$. Les
gra\-dua\-tions sur l'axes des x et des y sont des entiers. Les autres
param\`etres de cette macro ont les significations de ceux de Grille. 
Les valeurs de \verb|\pasx| et \verb|\pasy| sont les valeurs en mm 
d'espacement entre 2 graduations cons\'ecutives.

\Function*{$\backslash$GridNumPuiss! (x1 ,y1)(l ,h)(esp-x ,esp-y)\{dash1\}\{dash2\}\{wd\} ! }
Trace une grille avec des \'echelles gradu\'ees au point $(x1,y1)$. Les
gra\-dua\-tions sur l'axes des x sont des entiers de la forme de
\verb|\vinitx|, les graduations sur l'axes des y des entiers de la forme
\verb|\vinity^\vincy|. Les autres param\`etres de cette macro ont les
m\^emes significations que ceux de Grille. Les valeurs de
\verb|\pasx| et \verb|\pasy| sont les valeurs en mm d'espacement entre 2 graduations
cons\'ecutives.

\Function*{$\backslash$multiputnum! (x1 ,y1)(x-t ,y-t)\{num\}\{obj\}\{inc\} ! }
Place num objets a partir de $(x1,y1)$ en se translatant de x-t et y-t
\`a chaque nouvel objet. L'objet de d\'epart est $obj$, puis $obj + inc$ (pas
d'it\'eration), puis $obj + (2 * inc)$\ldots Attention, obj doit \^etre de
type entier.

\Function*{$\backslash$multiputpuissance!(x1 ,y1)(x-trans ,y-trans)\{num\}\{x\}\{y\} ! }
Place num objets de la forme $x^y$ \`a partir de $(x1,y1)$ en se
translatant de x-trans mm selon l'axe des x et y-trans mm selon l'axe des
y \`a chaque nouvel objet.  L'objet de d\'epart est $x^y$, puis
$x^{\hbox{$y+1$}}$, puis $x^{\hbox{$y+2$}}$\ldots Attention, x doit \^etre
un entier ainsi que le param\`etre num.

\newpage

\subtitle*{Tracer des fonctions math\'ematiques}

\function*{$\backslash$plotfunction( \{deb\}\{fin\}\{x-fact\}\{y-fact\}\{width\}\{dash\}\{fct\} ) }
Trace une fonction d\'ecrite au format PostScript par le param\`etre fct.
Le param\`etre en x \`a faire figurer doit s'appeler XX. La valeur de XX
varie de deb \`a fin. On applique le facteur d'echelle x-fact selon l'axe
des x et le facteur y-fact selon l'axe des y. Attention, l'unit\'e par
d\'efaut est ici le centim\`etre. width est l'\'epaisseur des traits en cm.
dash sp\'ecifie le param\`etre des pointill\'es si le bool\'een dashps est
vrai (\verb|dashpstrue|). La fonction est trac\'ee dans la couleur
sp\'ecifi\'ee par \verb|\rouge, \vert, \bleu|.

\subtitle*{Tracer des fl\`eches}

Vous avez la possibilit\'e de tracer des fl\`eches avec le symbole de
fl\`eche d\'epos\'e n'importe o\`u sur le trait ou encore une fl\`eche
comportant deux symboles de fl\`eche, un \`a chaque extr\'emit\'e du
trait. Les traits des fl\`eches sont d\'efinis comme des splines.

Les bool\'eens suivant permettent de choisir un endroit pour d\'eposer les
fl\`eches :

\begin{itemize}
   \item \verb|\ifarrowheads| positionn\'e \`a la valeur true vous permet
d'avoir deux symboles de fl\`eches ;
   \item \verb|\ifarrowheadleft| positionn\'e \`a la valeur true vous
permet d'obtenir un symbole de fl\`eche au d\'ebut du trait de fl\`eche ;
   \item \verb|\ifarrowheadright| positionn\'e \`a la valeur true vous
permet d'obtenir un symbole de fl\`eche en fin du trait de fl\`eche ;
\end{itemize}

\function*{$\backslash$ArrowForm( \{sens\} ) } 
Cette macro permet d'initialiser la forme des fl\`eches. Un appel avec le
param\`etre sens valant h va s\'electionner le mode``deux symboles de
fl\`eches'', un appel avec le param\`etre sens valant l va s\'electionner
le mode ``symbole de fl\`eches au d\'ebut'' et un appel avec le param\`etre
sens valant r va s\'electionner le mode ``symboles de fl\`eches \`a
droite''.  Au moment de la compilation, un message vous averti si vous avez
effectu\'e un appel \`a cette macro avec un param\`etre autre que ceux
explicit\'es ici.

Pour tracer les fl\`eches proprement dites vous avez \`a votre disposition
les macros suivantes :

\function*{$\backslash$Fleche( ~spline $\backslash${\bf endfleche}\{pourc\}\{prof\}\{haut\}\{larg\}\{pt-size\} , \{wd\}\{dash1\}\{dash2\} ) } 
Les param\`etres de cette macro sont les suivants : spline est un tableau
de tableaux \`a deux cases. La premi\`ere case contient du texte, la
seconde 4 points d\'efinissant le spline support de la fl\`eche, pourc est
le pour\-cen\-ta\-ge de la longueur du spline o\`u va figurer le symbole
de fl\`eche, prof est la profondeur de la fl\`eche, haut sa hauteur, larg
sa largeur, pt-size est la hauteur de la fonte pour le texte wd (cf
exemples d'utilisation) est l'epaisseur des traits dash1 et dash2
permettent de tracer des pointill\'es (cf commande PostScript
\verb|setdash|).

\function*{$\backslash$FlecheSpeciale( ~spline $\backslash${\bf endflechespeciale}\{pos\}\{prof\} , \{haut\}\{larg\}\{pt-size\}\{wd\}\{dash1\}\{dash2\} ) }
Cette macro est un raccourci pour tracer une fl\`eche avec le(s) symbole(s)
de fl\`eche \`a l'une des extr\'emit\'es du trait. Le param\`etre pos est
soit un h soit un r soit un l (cf au dessus pour les d\'efinitions de ces
symboles). Les autres param\`etres sont les m\^emes que ceux de
\verb|Fleche|.

{\catcode`\|=\active \def|{$\mid$}
\Function*{$\backslash$TraceArrow! (x1 ,y1)(x2 ,y2)|shape| ! }
\catcode`\|=13
}Trace deux symboles de fl\`eches aux extr\'emit\'es d'une droite fictive
d\'efinie par les points $(x_1,y_1)$ et $(x_2,y_2)$. Le param\`etre shape
est de la forme "p h w" ou p, h, w sont respectivement la profondeur la
hauteur et la largeur de la fl\`eche.  Enfin, si on a le bool\'een
\verb|\externe| positionn\'e \`a true alors les fl\`eches sont tourn\'ees
vers l'ext\'erieur, sinon vers l'int\'erieur. Cette macro est d'une
utilit\'e pour le trac\'e des cotations.

Pour tracer des cotations vous disposez des macros suivantes :

{\catcode`\|=\active \def|{$\mid$}
\Function*{$\backslash$Cotes! (x1 ,y1)(x2 ,y2)[ep ,ep-per][lg-g ,lg-d]|dash| ! }
\catcode`\|=13
}Trace une droite du point $A=(x_1,y_1)$ au point $B=(x_2,y_2)$
d'\'epaisseur ep mm puis deux traits perpendiculaires \`a la droite
pr\'ec\'edente d'\'epaisseur ep-per et de longueurs respectives lg-g mm du
point A et lg-d mm du point B.  Enfin, si le bool\'een \verb|\dashps| est
positionn\'e \`a true alors dash sp\'ecifie les pointill\'es. Ainsi, dash
doit \^etre de la forme : \verb|[ xx ] yy| (cd commande PostScript
\verb|setdash|).

{\catcode`\|=\active \def|{$\mid$}
\Function*{$\backslash$CotesFleche! (x1 ,y1)(x2 ,y2)[ep ,ep-per][lg-g ,lg-d]|shape| ! }
\catcode`\|=13
}Cette macro est tr\`es semblable \`a la pr\'ec\'edente. On ajoute des
symboles de fl\`eches au bout des traits.  Elle commence par tracer une
droite du point $A=(x_1,y_1)$ au point $B=(x_2,y_2)$ d'\'epaisseur ep mm
puis deux traits perpendiculaires \`a la droite pr\'ec\'edente
d'\'epaisseur ep-per et de longueurs respectives lg-g mm du point A et
lg-d mm du point B.  Le param\`etre shape est de la forme w h w pour un
appel a Arrow.  Enfin, si on a \verb|externetrue| alors les fl\`eches sont
tourn\'ees vers l'ext\'erieur, sinon vers l'int\'erieur.

Pour tracer des logos de fl\`eches vous disposez des fonctions suivantes :

\function*{$\backslash$LogoFlecheOne( \{epaisseur\}\{scale-x\}\{scale-y\} ) }
Trace un logo de fl\`eche dont les traits sont d'\'epaisseur "epaisseur".
Les facteurs "scale-x" et "scale-y" permettent de grossir ou de diminuer
la taille du dessin selon l'axe des x et l'axe des y respectivement. Le
symbole est dessin\'e dans la couleur des param\`etres \verb|\rouge|,
\verb|\vert|, \verb|bleu|.

\function*{$\backslash$LeftLogoFlecheOne( {} ) }
Positionne dans la marge gauche le logo pr\'ec\'edent.  Le
symbole est dessin\'e dans la couleur des param\`etres \verb|\rouge|,
\verb|\vert|, \verb|bleu|.

\function*{$\backslash$LogoFlecheTwo( \{epaisseur\}\{scale-x\}\{scale-y\} ) }
Pour la d\'efinition des param\`etres, voir la macro \verb|LogoFlecheOne|.

\function*{$\backslash$LeftLogoFlecheTwo( {} ) }
Positionne dans la marge gauche le logo pr\'ec\'edent.  Le
symbole est dessin\'e dans la couleur des param\`etres \verb|\rouge|,
\verb|\vert|, \verb|bleu|.

\subtitle*{Tracer des boites 3D pour r\'ealiser des histogrammes}

{\catcode`\|=\active \def|{$\mid$}
\function*{$\backslash$TroisDbox(\{h\}\{w\}\{ang\}\{c-box\}\{c-inner\} , \{x-retrait\}\{y-retrait\}\{rayon\} ) }
\catcode`\|=13
}Trace une boite 3D de hauteur h.mm et w.mm orient\'e de ang.  La couleur
de la boite est donn\'ee par le param\`etre c-box qui doit \^etre un
triplet de la forme 'rouge vert bleu'. Le parametre c-inner est la couleur
des faces. Ces faces ont une hauteur \'egale a h $-$ 2$*$x-retrait (mm) et
une largeur de w $-$ 2$*$y-retrait (mm). Le param\`etre rayon est le rayon
des arrondis aux quatre coins des faces. Noter que si ce param\`etre vaut
0 alors on obtient le dessin d'un rectangle. De plus, lorsque le bool\'een
innerbox est True (\verb|\innerboxtrue|) la face avant de la boite ne
comporte pas de boite int\'erieure en couleur.

\subtitle*{Pour obtenir des logos informatiques}

\function*{$\backslash$SunStation( \{epaisseur\}\{scale-x\}\{scale-y\} ) } 
Trace un logo de station de travail dont les traits sont d'\'epaisseur
"epaisseur".  Les facteurs "scale-x" et "scale-y" permettent de grossir ou
de diminuer la taille du dessin selon l'axe des x et l'axe des y
respectivement.  Le symbole est dessin\'e dans la couleur des param\`etres
\verb|\rouge|, \verb|\vert|, \verb|bleu|.

\function*{$\backslash$SunDisk( \{epaisseur\}\{scale-x\}\{scale-y\} ) }
Trace un logo d'unit\'e de disque dont les traits sont d'\'epaisseur
"epaisseur".  Les facteurs "scale-x" et "scale-y" permettent de grossir ou
de diminuer la taille du dessin selon l'axe des x et l'axe des y
respectivement.  Le symbole est dessin\'e dans la couleur des param\`etres
\verb|\rouge|, \verb|\vert|, \verb|bleu|.

\function*{$\backslash$SunServer( \{epaisseur\}\{scale-x\}\{scale-y\} ) }
Trace un logo de serveur dont les traits sont d'\'epaisseur "epaisseur".
Les facteurs "scale-x" et "scale-y" permettent de grossir ou de diminuer
la taille du dessin selon l'axe des x et l'axe des y respectivement.  Le
symbole est dessin\'e dans la couleur des param\`etres \verb|\rouge|,
\verb|\vert|, \verb|bleu|.

\function*{$\backslash$SunRouter( \{epaisseur\}\{scale-x\}\{scale-y\} ) }
Trace un logo de routeur de communication dont les traits sont
d'\'epaisseur "epaisseur".  Les facteurs "scale-x" et "scale-y" permettent
de grossir ou de diminuer la taille du dessin selon l'axe des x et l'axe
des y respectivement.  Le symbole est dessin\'e dans la couleur des
param\`etres \verb|\rouge|, \verb|\vert|, \verb|bleu|.

\subtitle*{Quelques macros de confort}

Afin de faciliter la manipulation de textes, de graphiques en couleur 
nous proposons quelques raccourcis.

\function*{$\backslash$icone(~ ) }
Equivalent \`a un \verb+\item+ et place sur la feuille un point en bleu.

\function*{$\backslash$ictwo(~ ) }
Equivalent \`a un \verb+\item+ et place sur la feuille un diamand en bleu.

\function*{$\backslash$bcrouge(~ ) }
Remplace la couleur courante par la couleur rouge.

\function*{$\backslash$bcbleu(~ ) }
Remplace la couleur courante par la couleur bleue.

\function*{$\backslash$bcjaune(~ ) }
Remplace la couleur courante par la couleur jaune.

\function*{$\backslash$bcvert(~ ) }
Remplace la couleur courante par la couleur vert.

\function*{$\backslash$bcmauve(~ ) }
Remplace la couleur courante par la couleur mauve.

\function*{$\backslash$bcmagenta(~ ) }
Remplace la couleur courante par la couleur magenta.

\function*{$\backslash$bcorange(~ ) }
Remplace la couleur courante par la couleur orange.

\function*{$\backslash$bcvj(~ ) }
Remplace la couleur courante par la couleur vert-jaune.

\function*{$\backslash$bcblanc(~ ) }
Remplace la couleur courante par la couleur blanche.

\function*{$\backslash$ec(~ ) }
Substitue la couleur sauvegard\'ee \`a la couleur courante.

Pour changer de couleur, vous disposez \'egalement de macros qui portent
les noms des primitives qui permettent de sp\'ecifier une couleur sous
l'environement X11 : \verb+\MediumAquamarine+, \verb+\coral+,
\verb+\DarkOliveGreen+, \verb+\MediumOrchid+ \ldots Reportez-vous au
fichier \verb+colorrgb.tex+ pour obtenir toutes les red\'efinitions.

\chapter*{Exemples d'utilisation dans le mod\`ele RGB}

Pour mettre en couleur le mot \ggf bonjour\gdf dans cette phrase, 
il suffit de baliser le mot par \verb+\beginrgbcolor{255}{0}{0}+ (ou
\verb+\bcrouge+) et \verb+\endrgbcolor+ (ou \verb+\ec+) pour obtenir
\beginrgbcolor{255}{0}{0} bonjour \endrgbcolor. De la m\^eme fa\c con, on peut
baliser des traits, des fl\`eches de l'environnement \verb+\picture+.

Par exemple, le trait qui suit est cod\'e de la mani\`ere suivante~:

\begin{verbatim}
\bcbleu %un trait bleu de longueur 8cm
\hrule height 2pt width 8cm %et d'epaisseur 2pt
\ec
\end{verbatim}

{\bcbleu %un trait bleu de longueur 8cm
\hbox{\hbox to 92pt{\ \hfill}\hbox to 8cm{\hrulefill\ }}%92
%et d'epaisseur 2pt
\ec}

Voici un exemple d'utilisation de la macros \verb+\echelon+ avec
initialisation des couleurs et des incr\'ements de chaque couleur. Les
couleurs sont initialis\'ees avec la valeur 20 et on d\'esire qu'elles
croissent jusqu'\`a la valeur 210 par saut de 40 entre chaque caract\`eres
(modulo = 1).

\begin{verbatim}
{% debut de groupe
\Huge\bf
% rouge=bleu=vert=20
% maxrouge=maxvert=maxbleu=210
% chaque caractere change de couleur
\initcolor{20}{20}{20}{210}{210}{210}{1}
% increrouge=increvert=increbleu=40
\initinc{40}{40}{40}
\echelon{la\ fonction\ echelon}
}% fin du groupe
\end{verbatim}

{% debut de groupe
\Huge\bf
% rouge=bleu=vert=20
% maxrouge=maxvert=maxbleu=210
% chaque caractere change de couleur
\initcolor{20}{20}{20}{210}{210}{210}{1}
% increrouge=increvert=increbleu=40
\initinc{40}{40}{40}
\echelon{la\ fonction\ echelon}
}% fin du groupe

\vskip 1cm

\hbox{\hbox to 92pt{\ \hfill}\hbox to 8cm{\hrulefill\ }}%92

\vskip 1cm

Pour construire des boites dont le fond est en couleur, et le texte sur
deux colonnes dans une autre couleur, nous programmons~:

\begin{verbatim}
\setbox2=\vbox{\hsize=0.485\textwidth
Dans un article r\'ecent \cite{cc}, nous pr\'esentions 
les avantages d'utilisation de la couleur dans le 
traitement de texte \TeX\  au travers de deux jeux 
de macros~: Color\TeX rgb et color\TeX cmyk fonctionnant 
pour les imprimantes couleur PostScript des constructeurs
QMS, Oc\'e, Hitachi, Sei\-ko.

identifi\'es suivants~: action sur une entit\'e 
syntaxique (lettre, mot, phrase, paragraphe) ; et action 
sur une entit\'e graphique~: vecteur ou fl\`eche de 
l'environnement {\bf picture} de \LaTeX .
\par
}% fin de la bo\^\i te numero 2
% on annule le blanc interbo\^\i te
\splittopskip=0pt
% on coupe la bo\^\i te 2 en deux selon la hauteur
% et on range dans la bo\^\i te 1
\setbox1=\vsplit2 to 0.5\ht2%
\setbox1=\vbox{\unvbox1}%
% on pose sur la feuille les deux bo\^\i tes
\hbox{\boxcolor{\box1}{200}{255}{255}\quad\vrule\quad
      \boxcolor{\box2}{50}{255}{255}}
\end{verbatim}

On remarque que le texte est coll\'e sur le bord de la bo\^\i te en
\hbox{couleur ;} pour ajouter du blanc, il faut utiliser la variable \LaTeX\
\verb+\fboxsep+.

\setbox2=\vbox{\hsize=0.485\textwidth
Dans un article r\'ecent \cite{cc}, nous pr\'e\-sen\-tions les avantages
d'utilisation de la cou\-leur dans le traitement de texte
\TeX\  au travers de deux jeux de macros~: Color\TeX rgb et color\TeX cmyk
fonctionnant pour les im\-pri\-man\-tes couleur PostScript des constructeurs
QMS, Oc\'e, Hitachi, Seiko.

Dans cet article, nous discutions de la cou\-leur en g\'en\'eral, comment
la sp\'ecifier, la re\-pr\'e\-sen\-ter, puis, nous d\'egagions des
clas\-ses de pro\-bl\`e\-mes qui appellent des classes de solutions
communes, des algorithmes communs. Cela nous conduisait \`a proposer un
ensemble minimal de primitives permettant de r\'e\-sou\-dre les probl\`emes
identifi\'es suivants~: action sur une entit\'e syn\-ta\-xique (lettre,
mot, phrase, paragraphe) ; et action sur une entit\'e gra\-phi\-que~:
vecteur ou fl\`eche de l'environnement {\bf picture} de \LaTeX .
\par
}% fin de la bo\^\i te numero 2
% on annule le blanc interbo\^\i te
\splittopskip=0pt
% on coupe la bo\^\i te 2 en deux selon la hauteur
% et on range dans la bo\^\i te 1
\setbox1=\vsplit2 to 0.5\ht2%
\setbox1=\vbox{\unvbox1}%
% on pose sur la feuille les deux bo\^\i tes
\hbox{\boxcolor{\box1}{200}{255}{255}\quad\vrule\quad
      \boxcolor{\box2}{50}{255}{255}}

\vskip 1cm

\hbox{\hbox to 92pt{\ \hfill}\hbox to 8cm{\hrulefill\ }}%92

\vskip 1cm

Nous pr\'esentons maintenant le codage d'un tableau avec les pourtours en
magenta. On notera l'utilisation de la macro \verb+\halign+ avec la
s\'equence \verb+\bcmagenta\tvc#\endrgbcolor&+ ce qui provoque un passage \`a
la couleur magenta pour tous les traits verticaux s\'eparant les colonnes.
Pour une explication d\'etaill\'ee de la s\'equence \verb+#&+ dans
l'environnement d'un \verb+\halign+, le lecteur est invit\'e \`a se
reporter \`a \cite{rs}, pages 126 et suivantes.

\begin{verbatim}
$$\vbox{\offinterlineskip
\def\cc#1{\kern .2em\hfill\raise 1.5mm%
                 \hbox{#1}\hfill\kern .2em}
\def\tvi{\vrule height 24pt depth 2pt width 0pt}
\def\tvc{\tvi\vrule width 1mm}
\halign{\bcmagenta\tvc#\endrgbcolor&%
&\cc{$\displaystyle#$}&\bcmagenta\tvc#\endrgbcolor\cr
\noalign{\bcmagenta\hrule height 1mm\endrgbcolor}
&\omit\cc{\bf Fonction}&&\omit\cc{\bf Primitive}&\cr
\noalign{\bcmagenta\hrule height 1mm\endrgbcolor}
     height 34pt depth 30pt&{ 1 \over 1 + x^2 }&&{\rm 
         Arctg}\,(x)+C&\cr
\noalign{\bcmagenta\hrule height 1mm\endrgbcolor}
}}$$
\end{verbatim}

$$\vbox{\offinterlineskip
\def\cc#1{\kern .2em\hfill\raise 1.5mm%
                 \hbox{#1}\hfill\kern .2em}%
\def\tvi{\vrule height 24pt depth 2pt width 0pt}%
\def\tvc{\tvi\vrule width 1mm}%
\halign{\bcmagenta\tvc#\endrgbcolor&%
&\cc{$\displaystyle#$}&\bcmagenta\tvc#\endrgbcolor\cr%
\noalign{\bcmagenta\hrule height 1mm\endrgbcolor}%
&\omit\cc{\bf Fonction}&&\omit\cc{\bf Primitive}&\cr%
\noalign{\bcmagenta\hrule height 1mm\endrgbcolor}height 34pt depth 30pt
&1\over 1+{x^2} &&{\rm Arctg}\,(x)+C&\cr%
\noalign{\bcmagenta\hrule height 1mm\endrgbcolor}%
}}$$

\vskip 1cm

\hbox{\hbox to 92pt{\ \hfill}\hbox to 8cm{\hrulefill\ }}%92

\vskip 1cm

Pour coder une bo\^\i te en couleur avec un cadre dans une autre \hbox{couleur
:}

\begin{verbatim}
{\Large
\fboxsep=0pt% on initialise le blanc
\fboxrule=3pt% la dimension du cadre est de 3pt
\fboxcolor{\fboxsep=8pt\fboxrule=0pt
    \boxcolor{du texte en noir}%
            {255}{255}{0}}{255}{0}{0}
}
\end{verbatim}

{\Large
\fboxsep=0pt% on initialise le blanc
\fboxrule=3pt% la dimension du cadre est de 3pt
\fboxcolor{\fboxsep=8pt\fboxrule=0pt\boxcolor{du texte en noir}{255}{255}{0}}%
          {255}{0}{0}
}


\vskip 1cm

\hbox{\hbox to 92pt{\ \hfill}\hbox to 8cm{\hrulefill\ }}%92

\vskip 1cm

Pour tracer un cercle avec des d\'egrad\'es concentriques qui partent de
la couleur rouge jusqu'au noir en d\'ecalant le centre (effet boule
d\'egrad\'ee), on programme\ :

\setbox100=\vbox{\Huge\bf\beginrgbcolor{255}{255}{255}
\halign{\quad#&\quad#&\quad#\cr
& LRI& \cr
LRI& LRI& LRI\cr
& LRI& \cr}
\endrgbcolor}
% rouge=(255,0,0)  noir=(0,0,0)   nb-nuances=10
\xtrans=50pt% on decale le centre de 50pt vers la droite
\ytrans=50pt% et 50pt vers le haut
\centerline{
\CercleGeneral{\copy100}{255}{0}{0}{0}{0}{0}{10}
}

\begin{verbatim}

\setbox100=\vbox{\Huge\bf
\halign{\quad#&\quad#&\quad#\cr
\beginrgbcolor{255}{255}{255}
& LRI& \cr
LRI& LRI& LRI\cr
& LRI& \cr}
\endrgbcolor}
\xtrans=50pt% on decale le centre de 50pt vers la droite
\ytrans=50pt% et 50pt vers le haut
\CercleGeneral{\copy100}{255}{0}{0}{0}{0}{0}{10}

\end{verbatim}

\vskip 1cm

\hbox{\hbox to 92pt{\ \hfill}\hbox to 8cm{\hrulefill\ }}%92

\vskip 1cm

Pour tracer une bo\^\i te dont le contenu est d\'egrad\'e, on programme\ :

\vskip 8mm

\setbox101=\vbox{\hsize=0.68\textwidth\bf%
\beginrgbcolor{255}{255}{255}%
Dans un article r\'ecent, nous pr\'esentions 
les avantages d'utilisation de la couleur dans le 
traitement de texte \TeX\  au travers de deux jeux 
de macros~: Color\TeX rgb et color\TeX cmyk fonctionnant 
pour les impri\-man\-tes couleur PostScript des constructeurs\break
QMS, Oc\'e, Hitachi, Seiko.\endrgbcolor
\par}
\horizontaltrue
\centerline{
\RectangleDegrade{\copy101}{255}{255}{0}{0}{0}{0}{50}
}

\begin{verbatim}
\setbox10=\vbox{\hsize=0.6\textwidth\bf
\beginrgbcolor{255}{255}{255}% texte blanc
Dans un article r\'ecent, nous pr\'esentions 
les avantages d'utilisation de la couleur dans le 
traitement de texte \TeX\  au travers de deux jeux 
de macros~: Color\TeX rgb et color\TeX cmyk fonctionnant 
pour les impri\-man\-tes couleur PostScript des constructeurs
QMS, Oc\'e, Hitachi, Seiko.

\par
}
\horizontaltrue % des degrades de haut en bas
\centerline{%
\RectangleDegrade{\copy10}{255}{255}{0}{0}{0}{0}{50}}
\end{verbatim}

\vskip 1cm

\hbox{\hbox to 92pt{\ \hfill}\hbox to 8cm{\hrulefill\ }}%92

Pour tracer les courbes de bezier des figures \ref{extre} et
\ref{extretwo}, on pourra marquer avec \verb+Pictex+ ou \verb+TexCad+
les points d\'efinissant les tangentes, puis r\'ecup\'erer la
valeur de ces points sous \'editeur et programmer :

\begin{verbatim}
\begin{figure}[th]
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(74.00,61.00)
\put(0.00,0.00){\framebox(74.00,61.00)[t]{}}
\put(3.97,10.00){\vector(1,0){28.10}}
....
% debut de la premiere courbe de bezier (celle de gauche)
\put(0,0){\bezierps [ [ 2.06 36.98 6.03 39.00 10.95 39.00 
 14.03 29.02][14.03 29.02 19.05 16.06 23.02 16.98 30.00 13.97]] 
 \endbezierps{.4}{3}{2}{255}{0}{0}}
% fin de la premiere courbe de bezier (celle de droite)
% debut de la 2 courbe de bezier (celle de gauche)
\put(0,0){\bezierps [[33.97 39.00 37.94 39.00 40.00 37.94
42.06 34.92] [42.06 34.92 44.92 26.98 50.95 16.98 66.98 12.06]]
\endbezierps{.4}{3}{2}{255}{0}{0}}
% fin de la 2 courbe de bezier
% je place un cercle hachure
\put(6.03,38){\CercleHachure{4.5}{.5}{.1}{60}{255}{60}{255}{2}}
\put(42,35){\CarreHachure{4}{.6}{.1}{135}{255}{0}{255}{1}}
....
\put(6.03,54){\makebox(0,0)[cc]{$f(x)$}}
\put(42,54){\makebox(0,0)[cc]{$f(x)$}}
\end{picture}
\caption{{\it extremum particulier}}
\label{extre}
\end{center}
\end{figure}
\end{verbatim}

\begin{figure}[th]
\begin{center}
\unitlength=1.00mm
% \special{em:linewidth 0.4pt}
\linethickness{0.4pt}
\begin{picture}(74.00,61.00)
\put(0.00,0.00){\framebox(74.00,61.00)[t]{}}
\put(3.97,10.00){\vector(1,0){28.10}}
\put(39.05,10.00){\vector(1,0){30.00}}
\put(6.03,7.94){\vector(0,1){39.05}}
\put(42.06,7.94){\vector(0,1){39.05}}
\put(9.05,43.97){\makebox(0,0)[lc]{$A(0,a)$}}
% debut de la premiere courbe de bezier (celle de gauche)
\put(0,0){\bezierps [ [ 2.06 36.98 6.03 39.00 10.95 39.00 
 		14.03 29.02 ] [ 14.03 29.02 19.05 16.06 23.02 16.98 30.00 13.97 ] ] 
 		\endbezierps{.4}{3}{2}{255}{0}{0}}
%\put(2.06,36.98){\makebox(0,0)[cc]{1}}
%\put(6.03,40.00){\makebox(0,0)[cc]{2}}
%\put(10.95,40.00){\makebox(0,0)[cc]{3}}
%\put(16.03,33.02){\makebox(0,0)[cc]{4}}
%\put(16.03,33.02){\makebox(0,0)[cc]{5}}
%\put(19.05,22.06){\makebox(0,0)[cc]{6}}
%\put(23.02,16.98){\makebox(0,0)[cc]{7}}
%\put(30.00,13.97){\makebox(0,0)[cc]{8}}
% fin de la premiere courbe de bezier (celle de gauche)
% debut de la 2 courbe de bezier (celle de gauche)
\put(0,0){\bezierps [ [ 33.97 39.00 37.94 39.00 40.00 37.94
		42.06 34.92 ] [ 42.06 34.92 44.92 26.98 50.95 16.98 66.98 12.06 ] ]
		\endbezierps{.4}{3}{2}{255}{0}{0}}
%\put(33.97,40.00){\makebox(0,0)[cc]{1}}
%\put(37.94,39.05){\makebox(0,0)[cc]{2}}
%\put(40.00,37.94){\makebox(0,0)[cc]{3}}
%\put(42.06,34.92){\makebox(0,0)[cc]{4}}
%\put(42.06,34.92){\makebox(0,0)[cc]{5}}
%\put(44.92,26.98){\makebox(0,0)[cc]{6}}
%\put(50.95,16.98){\makebox(0,0)[cc]{7}}
%\put(66.98,12.06){\makebox(0,0)[cc]{8}}
% fin de la 2 courbe de bezier (celle de gauche)
\put(42.06,34.92){\circle*{1.90}}
% je place un cercle hachure
\put(6.03,38){\CercleHachure{4.5}{.5}{.1}{60}{255}{60}{255}{2}}
\put(42,35){\CarreHachure{6}{.6}{.1}{135}{255}{0}{255}{1}}
\put(8.5,31){\makebox(0,0)[cc]{$V$}}
\put(6.03,38.00){\circle*{1.90}}
\put(30,6){\makebox(0,0)[cc]{$x$}}
\put(61,6){\makebox(0,0)[cc]{$x$}}
\put(6.03,54){\makebox(0,0)[cc]{$f(x)$}}
\put(42,54){\makebox(0,0)[cc]{$f(x)$}}
\end{picture}
\caption{{\it extremum particulier}}
\label{extre}
\end{center}
\end{figure}

\begin{verbatim}
\begin{figure}[th]
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(74.00,61.00)
\put(0.00,0.00){\framebox(74.00,61.00)[t]{}}
....
% debut de la courbe de bezier
\put(0,0){\bezierps [ 
[ 16.03 14.92 20.00 16.03 26.98 39.05 33.97 43.02 ]
[ 33.97 43.02 42.06 40.95 43.97 20.95 47.94 19.05 ]
[ 47.94 19.05 52.06 20.95 54.92 49.05 56.98 52.06 ]
[ 56.98 52.60 60.00 49.05 62.06 32.06 64.92 17.94 ] 
] \endbezierps{.4}{2}{.5}{255}{0}{0}}
....
\end{picture}
\caption{{\it extremums locaux et globaux}}
\label{extretwo}
\end{center}
\end{figure}
\end{verbatim}

\begin{figure}[th]
\begin{center}
\unitlength=1.00mm
% \special{em:linewidth 0.4pt}
\linethickness{0.4pt}
\begin{picture}(74.00,61.00)
\put(0.00,0.00){\framebox(74.00,61.00)[t]{}}
\put(10.00,10.95){\vector(1,0){54.92}}
\put(12.06,7.94){\vector(0,1){48.10}}
\put(68.00,4.92){\makebox(0,0)[cc]{$x$}}
% debut de la premiere courbe de bezier (celle de gauche)
\put(0,0){\bezierps [ 
	[ 16.03 14.92 20.00 16.03 26.98 39.05 33.97 43.02 ]
	[ 33.97 43.02 42.06 40.95 43.97 20.95 47.94 19.05 ]
	[ 47.94 19.05 52.06 20.95 54.92 49.05 56.98 52.06 ]
	[ 56.98 52.60 60.00 49.05 62.06 32.06 64.92 17.94 ] 
] \endbezierps{.4}{2}{.5}{255}{0}{0}}
% \put(16.03,14.92){\makebox(0,0)[cc]{1}}
%\put(20.00,16.03){\makebox(0,0)[cc]{2}}
%\put(26.98,39.05){\makebox(0,0)[cc]{3}}
%\put(33.97,43.02){\makebox(0,0)[cc]{4}}
%\put(33.97,43.02){\makebox(0,0)[cc]{5}}
%\put(42.06,40.95){\makebox(0,0)[cc]{6}}
%\put(43.97,20.95){\makebox(0,0)[cc]{7}}
%\put(47.94,19.05){\makebox(0,0)[cc]{8}}
%\put(47.94,19.05){\makebox(0,0)[cc]{9}}
%\put(52.06,20.95){\makebox(0,0)[cc]{10}}
%\put(54.92,49.05){\makebox(0,0)[cc]{11}}
%\put(56.98,52.06){\makebox(0,0)[cc]{12}}
%\put(56.98,52.06){\makebox(0,0)[cc]{13}}
%\put(60.00,49.05){\makebox(0,0)[cc]{14}}
%\put(62.06,32.06){\makebox(0,0)[cb]{15}}
%\put(64.92,17.94){\makebox(0,0)[cc]{16}}
\put(20.00,10.06){\line(0,1){12.04}}
\put(30.00,10.06){\line(0,1){31.04}}
\put(40.00,10.06){\line(0,1){30.04}}
\put(50.00,12.06){\line(0,-1){2.04}}
\put(60.00,12.06){\line(0,-1){2.04}}
\put(10.95,52.06){\line(1,0){2.14}}
\put(10.95,43.02){\line(1,0){25.14}}
\put(10.95,39.02){\line(1,0){21.14}}
\put(10.95,20.02){\line(1,0){12.00}}
\put(20.00,4.92){\makebox(0,0)[cc]{$a$}}
\put(30.00,4.92){\makebox(0,0)[cc]{$b$}}
\put(40.00,4.92){\makebox(0,0)[cc]{$c$}}
\put(50.00,4.92){\makebox(0,0)[cc]{$d$}}
\put(20.00,10.95){\makebox(0,0)[cc]{\bf [}}
\put(40.00,10.95){\makebox(0,0)[cc]{\bf ]}}
%\put(6.03,51.06){\makebox(0,0)[cc]{$max$}}
\put(6.03,56.03){\makebox(0,0)[cc]{$f(x)$}}
\put(6.03,38.52){\makebox(0,0)[cc]{$f(b)$}}
\put(6.1,43.02){\makebox(0,0)[cc]{$M$}}
\end{picture}
\caption{{\it extremums locaux et globaux}}
\label{extretwo}
\end{center}
\end{figure}

\vskip 1cm

\hbox{\hbox to 92pt{\ \hfill}\hbox to 8cm{\hrulefill\ }}%92

Pour tracer des objets quelconques au moyen de courbes de Bezier dont le
fond est en couleur, nous programmons :

\begin{verbatim}
\begin{figure}
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(124,100)
\put(0,0){\framebox(124,100)[cc]{}}
\put(20,80){\makebox(0,0)[cc]{\Large\bf\LaTeX}}
\put(97,5){\makebox(0,0)[cc]{\small 
          $\copyright - lri - 1991$}}
% Definition de la couleur du contour.
% Le trait est en pointille.
\rouge=255\vert=0\bleu=255\dashpstrue
\put(0.00,0.00){\CourbeFermee [ 
[ 20 10 10 50 25 75 50 80 ] 
[ 50 80 25 55  20 10 0 0 ] 
] \endcourbe{1}{1}{1}{255}{0}{0}}
% Le contour n'est plus en pointille
\dashpsfalse\closepathfalse
\rouge=0\vert=0\bleu=255
\put(0.00,0.00){\CourbeFermee 
   [ [ 70 10 5 90 30 75 40 40 ]
] \endcourbe{1}{1}{1}{255}{255}{0}}
\end{picture}
\caption{{\it Des courbes remplies}}
\label{f:remplie}
\end{center}
\end{figure}
\end{verbatim}

qui produit le r\'esultat de la figure \ref{f:remplie}

\begin{figure}
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(124,100)
\put(0,0){\framebox(124,100)[cc]{}}
\put(20,80){\makebox(0,0)[cc]{\Large\bf\LaTeX}}
\put(97,5){\makebox(0,0)[cc]{\small $\copyright - lri - 1991$}}
% Definition de la couleur du contour.
% Le trait est en pointille.
\rouge=255\vert=0\bleu=255\dashpstrue
\put(0.00,0.00){\CourbeFermee [ 
[ 20 10 10 50 25 75 50 80 ] 
[ 50 80 25 55  20 10 0 0 ] 
] \endcourbe{1}{1}{1}{255}{0}{0}}
% Le contour n'est plus en pointille
\dashpsfalse\closepathfalse
\rouge=0\vert=0\bleu=255
\put(0.00,0.00){\CourbeFermee 
   [ [ 70 10 5 90 30 75 40 40 ]
] \endcourbe{1}{1}{1}{255}{255}{0}}
\end{picture}
\caption{{\it Des courbes remplies}}
\label{f:remplie}
\end{center}
\end{figure}

\vskip 1cm

\hbox{\hbox to 92pt{\ \hfill}\hbox to 8cm{\hrulefill\ }}%92

Pour placer du texte le long de courbes de Bezier il faut programmer, par
exemple, qui produit le r\'esultat de la figure \ref{fd:one} :

\hbox to\textwidth{\hrulefill}
\lettrepanneau\ Il y a un bug lorsque l'on demande une impression
\`a une r\'esolution autre que 300dpi : les lettres ne sont pas
plac\'ees au bon endroit.\par
\hbox to\textwidth{\hrulefill}


\begin{verbatim}
\Huge\bf
\BlancInterLettre=1% 1 mm entre les lettres
\begin{figure}[htp]
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(95,70)
\put(0,0){\LightBlue\TraceTexte{TraceTexte}
      {5}{65}{15}{35}{35}{35}{90}{65}\ec}
\put(0,0){\bcvert\ColleTexte{ColleTexte}
      {5}{5}{15}{35}{15}{35}{81}{5}\ec}
\put(0.00,0.00){\framebox(95,70)[cc]{}}
\end{picture}
\caption{{\it courbes sur un texte}}
\label{fd:one}
\end{center}
\end{figure}
\end{verbatim}

{\Huge\bf
\BlancInterLettre=1% 1 mm entre les lettres
\begin{figure}[htp]
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(95,70)
\put(0,0){\LightBlue\TraceTexte{TraceTexte}{5}{65}{15}{35}{35}{35}{90}{65}\ec}
\put(0,0){\bcvert\ColleTexte{ColleTexte}{5}{5}{15}{35}{15}{35}{81}{5}\ec}
\put(0.00,0.00){\framebox(95,70)[cc]{}}
\put(19,48){\circle*{1}}
\put(23,44){\circle*{1}}
\put(18,49){\line(1,-1){7}}
\put(14,43){\line(1,0){10.5}}
\put(17,45){\makebox(0,0)[cc]{{\small $\alpha$}}}
\put(11,49){\makebox(0,0)[cc]{{\small $(x',y')$}}}
\put(18,40.5){\makebox(0,0)[cc]{{\small $(x'',y'')$}}}
\end{picture}
\caption{{\it courbes sur un texte}}
\label{fd:one}
\end{center}
\end{figure}
}

\section*{Manipulation des grilles, des \'echelles gradu\'ees}

Pour tracer une grille simple (sans axes et en ``trait plein'') faites :

\begin{center}
\unitlength=1mm
\linethickness{0.4pt}
\begin{picture}(70,70)
\put(0.00,0.00){\framebox(70,70)[t]{}}
\put(10.00,10.00){\Grille(50,50)(2,5){2}{4}{0.1}}
\end{picture}
\end{center}

\begin{verbatim}
\begin{center}
\unitlength=1mm
\linethickness{0.4pt}
\begin{picture}(70,70)
\put(0.00,0.00){\framebox(70,70)[t]{}}
\put(10.00,10.00){\Grille(50,50)(2,5){2}{4}{0.1}}
\end{picture}
\end{center}
\end{verbatim}

Pour tracer une grille compl\'et\'e d'axes gradu\'es avec, sur l'axe des
$x$ des valeurs augmentant de $10$ en $10$ et sur l'axe des $y$ des valeurs
d'exposant augmentant de $1$ en $1$, vous pouvez faire :

\begin{center}
\unitlength=1mm
\linethickness{0.4pt}
\vinitx=0
\vincx=10
\vinity=10
\vincy=1
\begin{picture}(70,70)
\put(0.00,0.00){\framebox(70,70)[t]{}}
\GridNumPuiss(10,10)(50,50)(2,5){2}{4}{0.1}
\end{picture}
\end{center}

\begin{verbatim}
\begin{center}
\unitlength=1mm
\linethickness{0.4pt}
\vinitx=0
\vincx=10
\vinity=10
\vincy=1
\begin{picture}(70,70)
\put(0.00,0.00){\framebox(70,70)[t]{}}
\GridNumPuiss(10,10)(50,50)(2,5){2}{4}{0.1}
\end{picture}
\end{center}
\end{verbatim}

La variante pour obtenir le dessin qui suit se code :

\begin{center}
\unitlength=1mm
\linethickness{0.4pt}
\vinitx=0
\vincx=10
\vinity=0
\vincy=20
\begin{picture}(70,70)
\put(0.00,0.00){\framebox(70,70)[t]{}}
\GridNumNum(10,10)(50,50)(2,5){2}{4}{0.1}
\end{picture}
\end{center}

\begin{verbatim}
\begin{center}
\unitlength=1mm
\linethickness{0.4pt}
\vinitx=0
\vincx=10
\vinity=0
\vincy=20
\begin{picture}(70,70)
\put(0.00,0.00){\framebox(70,70)[t]{}}
\GridNumNum(10,10)(50,50)(2,5){2}{4}{0.1}
\end{picture}
\end{center}
\end{verbatim}

\section*{Pour tracer des fonctions}

Pour tracer en rouge la fonction $\log_2$ pour x variant entre $0.3$ et
$5.1$ accompagn\'ee des axes et de la grille de fond pointill\'ee, vous
pouvez faire :

\begin{center}
\unitlength=1mm
\linethickness{0.4pt}
\begin{picture}(80,80)
\put(0.00,0.00){\framebox(80,80)[t]{}}
\dashpstrue
\put(10.00,10.00){\Grille(65,65)(5,5){3 1 3 1}{1}{0.1}}
\dashpsfalse
\put(10,30){\vector(1,0){65}}
\put(10,10){\vector(0,1){65}}
\multiputnum(11.5,25)(10,0){7}{0}{1}
\multiputnum(5,10)(0,10){7}{-2}{1}
\multiput(8.5,10)(0,10){7}{\traith{3}}
\multiput(10,28)(10,0){6}{\traitv{4}}
\rouge=255\vert=0\bleu=0
\put(10,30){\plotfunction{0.3}{5.1}{1}{1}{0.1}{0}{XX  ln 2 ln div}}
\end{picture}
\end{center}

\begin{verbatim}
\begin{center}
\unitlength=1mm
\linethickness{0.4pt}
\begin{picture}(80,80)
\put(0.00,0.00){\framebox(80,80)[t]{}}
%%% grille en pointillee
\dashpstrue
\put(10.00,10.00){\Grille(65,65)(2,5){3 1 3 1}{1}{0.1}}
\dashpsfalse% fin des traits pointilles
%%% les axes
\put(10,30){\vector(1,0){65}}
\put(10,10){\vector(0,1){65}}
\multiputnum(11.5,25)(10,0){7}{0}{1}
\multiputnum(5,10)(0,10){7}{-2}{1}
\multiput(8.5,10)(0,10){7}{\traith{3}}
\multiput(10,28)(10,0){6}{\traitv{4}}
%%% la fonction
\put(10,30){\plotfunction{0.3}{5.1}{1}{1}{0.1}{0}%
           {XX  ln 2 ln div}}
\end{picture}
\end{center}
\end{verbatim}

Noter que l'on a pas acc\'es en PostScript \`a la fonction $\log_2$ si bien
que nous avons d\^u la composer : $\log_2(x)=\frac{ln(x)}{ln(2)}$.
Reportez vous aux r\'ef\'erences \cite{psu} \cite{psd} et \cite{pst} pour
obtenir la liste des fonctions (arithm\'etiques\ldots) disponibles en
PostScript. De plus, il est rappel\'e que le nom de la va\-ria\-ble des
fonctions est \verb|XX| par convention.

\section*{Manipulation des fl\`eches}

%\ArrowForm{h} % pour obtenir des fleches des deux cotes
%\ArrowForm{l} % pour obtenir des fleches "a gauche"
%\ArrowForm{r} % pour obtenir des fleches "a droite"
%\unitlength=1mm
%\linethickness{0.4pt}
%\begin{picture}(36.02,33.01)
%\put(0.00,0.00){\framebox(36,33)[t]{}}
%\put(36.00,33.00){\line(-1,0){18.03}}
%\put(17.97,33.01){\line(0,-1){6.02}}
%\put(17.97,26.99){\line(1,-1){6.02}}
%\put(23.98,20.98){\line(1,0){12.03}}
%\put(36.02,20.98){\line(0,1){12.03}}
%
%\put(5.00,33.00){\line(1,0){7.03}}
%\put(12.03,33.01){\line(0,-1){12.03}}
%\put(12.03,20.98){\line(-1,0){7.02}}
%\put(5.02,20.98){\line(0,1){12.03}}
%\put(5.00,27.00){\line(1,0){7.03}}
%
%\put(18.00,12.00){\line(1,0){18.02}}
%\put(36.02,12.03){\line(0,-1){7.02}}
%\put(36.02,5.01){\line(-1,0){18.05}}
%\put(17.97,5.01){\line(0,1){7.02}}
%
%\put(9.00,30.00){\circle{4.00}}
%\put(18.00,32.00){\dashbox{0.5}(18.00,0.00)[cc]{}}
%\put(18.00,28.00){\dashbox{0.5}(18.00,0.00)[cc]{}}
%%%% trait qui descend
%\put(24.00,12.00){\dashbox{0.5}(0.00,-9.00)[cc]{}}
%\put(18.00,11){\dashbox{0.5}(18.00,0.00)[cc]{}}
%\put(18.00,7){\dashbox{0.5}(18.00,0.00)[cc]{}}
%\end{picture}

L'exemple de la Figure \ref{fd:f} illustre les diff\'erentes formes de
fl\`eches que l'on peut obtenir avec \verb|colorrgb.tex| :

\begin{figure}[htp]
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(135,165)
\put(0.00,0.00){\framebox(135,165)[t]{}}
%%% debut des axes
\put(10,10){\vector(1,0){110}}
\put(10,10){\vector(0,1){150}}
\multiputnum(10,5)(10,0){10}{0}{1000}
\multiputpuissance(5,10)(0,10){15}{10}{1}
\multiput(8.5,20)(0,10){14}{\traith{3}}
\multiput(20,8)(10,0){9}{\traitv{4}}
%%%% fin des echelles graduees
\dashpstrue\rouge=0\vert=0\bleu=0
\put(0,0){\dashpsfalse\rouge=0\vert=0\bleu=0%
		\FlecheSpeciale [
	 	[[(C)] [120 10 120 120 120 120 10 120] ]
		] \endflechespeciale{h}{1}{3}{2}{4}{0.1}{3}{4}}%
\put(0,0){\Fleche{[[[()] [10 10 20 20 30 70 40 80]]
	 	[[()] [120 150 100 150 40 150 10 150] ]
		]} \endfleche{70}{1}{3}{2}{4}{0.1}{3}{4}}%
\put(0,0){\dashpsfalse\rouge=0\vert=0\bleu=0%
		\FlecheSpeciale [
	 	[[(BB)] [40 80 50 70 60 20 100 10]]
		] \endflechespeciale{l}{1}{3}{2}{4}{0.1}{3}{4}}%
\put(0,0){\dashpstrue\rouge=0\vert=0\bleu=0%
	\Cotes(10,10)(80,40)[1,0.4][16,36]| [ 3 2 3 2 ] 1 | }
\put(0,0){\dashpsfalse\rouge=0\vert=0\bleu=0\externefalse
	\CotesFleche(10,60)(100,80)[1,0.4][16,36]|1 5 2.2| }
\end{picture}
\caption{{\it Dessins de fl\`eches}}
\label{fd:f}
\end{center}
\end{figure}

\begin{verbatim}
\begin{figure}[htp]
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(135,165)
\put(0.00,0.00){\framebox(135,165)[t]{}}
%%% debut des axes
\put(10,10){\vector(1,0){110}}
\put(10,10){\vector(0,1){150}}
\multiputnum(10,5)(10,0){10}{0}{1000}
\multiputpuissance(5,10)(0,10){15}{10}{1}
\multiput(8.5,20)(0,10){14}{\traith{3}}
\multiput(20,8)(10,0){9}{\traitv{4}}
%%%% fin des echelles graduees
\dashpstrue\rouge=0\vert=0\bleu=0
\put(0,0){\dashpsfalse\rouge=0\vert=0\bleu=0%
		\FlecheSpeciale [
	 	[[(C)] [120 10 120 120 120 120 10 120] ]
		] \endflechespeciale{h}{1}{3}{2}{4}{0.1}{3}{4}}%
\put(0,0){\Fleche{[[[()] [10 10 20 20 30 70 40 80]]
	 	[[()] [120 150 100 150 40 150 10 150] ]
		]} \endfleche{70}{1}{3}{2}{4}{0.1}{3}{4}}%
\put(0,0){\dashpsfalse\rouge=0\vert=0\bleu=0%
		\FlecheSpeciale [
	 	[[(BB)] [40 80 50 70 60 20 100 10]]
		] \endflechespeciale{l}{1}{3}{2}{4}{0.1}{3}{4}}%
\put(0,0){\dashpstrue\rouge=0\vert=0\bleu=0%
		\Cotes(10,10)(80,40)[1,0.4][16,36]|[ 3 2 3 2 ] 1|}%
\put(0,0){\dashpsfalse\rouge=0\vert=0\bleu=0\externefalse%
		\CotesFleche(10,60)(100,80)[1,0.4][16,36]|1 5 2.2|}
\end{picture}
\caption{{\it Dessins de fl\`eches}}
\label{fd:f}
\end{center}
\end{figure}
\end{verbatim}

\section*{Tracer des boites 3D}

Pour tracer des boites 3D vous pouvez vous inspirer du code suivant pour
obtenir le r\'esultat de la Figure \ref{fd:box} :

\begin{verbatim}
\begin{figure}[htp]
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(135,135)
\put(0.00,0.00){\framebox(135,135)[t]{}}
%%%% debut des boites
\put(35,10){\TroisDbox{60}{30}{-10}{ 1 0 0 }%
           { 1 1 0.5 }{2}{1}{5.25}}
\innerboxfalse
\put(95,20){\TroisDbox{50}{20}{10}{ 1 0 0 }%
           { 1 1 0.5 }{1}{1}{1.25}}
\innerboxtrue
\put(95,100){\TroisDbox{20}{20}{0}{ 0 0.5 1 }%
           { 1 1 0.5 }{1}{1}{1.25}}
%%%% fin des boites
\put(35,105){\makebox(0,0)[lc]{\large\bf Boites 3D}}
\end{picture}
\caption{{\it Boites 3D}}
\label{fd:box}
\end{center}
\end{figure}
\end{verbatim}

\begin{figure}[htp]
\begin{center}
\unitlength=1.00mm
\linethickness{0.4pt}
\begin{picture}(135,135)
\put(0.00,0.00){\framebox(135,135)[t]{}}
%%%% debut des boites
\put(35,10){\TroisDbox{60}{30}{-10}{ 1 0 0 }{ 1 1 0.5 }{2}{1}{5.25}}
\innerboxfalse
\put(95,20){\TroisDbox{50}{20}{10}{ 1 0 0 }{ 1 1 0.5 }{1}{1}{1.25}}
\innerboxtrue
\put(95,100){\TroisDbox{20}{20}{0}{ 0 0.5 1 }{ 1 1 0.5 }{1}{1}{1.25}}
%%%% fin des boites
\put(35,105){\makebox(0,0)[lc]{\large\bf Boites 3D}}
\end{picture}
\caption{{\it Boites 3D}}
\label{fd:box}
\end{center}
\end{figure}

\section*{Quelques logos de fl\`eches}

Les macros qui suivent permettent\LeftLogoFlecheOne\ de tracer des logos
repr\'esentant des symboles de fl\`eches ; il s'agit de
\verb|\LogoFlecheOne| et \verb|LogoFlecheTwo|. De plus, un support est
pr\'evu pour \'ecrire ces symboles dans la marge gauche au travers des
macros \verb|\LeftLogoFlecheOne| et \verb|LeftLogoFlecheTwo| que l'on
place au sein d'un paragraphe.

Par exemple, le symbole\LeftLogoFlecheTwo\ que vous voyez appara\^{\i}tre
dans la marge gauche est cod\'e :

\begin{verbatim}
Par exemple, le symbole\LeftLogoFlecheTwo\ que vous voyez 
appara\^{\i}tre dans la marge gauche est cod\'e :
\end{verbatim}

\section*{Logos informatiques : dessins de stations de travail, de
disques, de routeurs\ldots}

Voici maintenant un exemple o\`u est r\'esum\'e l'utilisation des symboles
informatiques :

\begin{center}
\rouge=0\vert=0\bleu=0% c'est du noir !
\setlength{\unitlength}{0.11mm}
\begin{picture}(1020,498)(-580,240)
\put(-580,240){\framebox(1020,500){}}
\put(220,260){\small\bf (Amiens)}
\put(220,300){\small\bf Lamifa}
\put(-500,260){\small\bf (Rouen)}
\put(-500,300){\small\bf Crihan}
\put(-380,660){\small\sf TCP/IP}
\put(-380,700){\small\sf Ethernet}
\put(-160,320){\small\sf TCP/IP}
\put(-160,360){\small\sf Ethernet}
\put(-200,480){\small\sf France T\'el\'ecom}
\put(-200,520){\small\sf Num\'eris}
\put(-280,620){\line(1,0){40}}
\put(-200,420){\line(0,-1){40}}
\put(-240,400){\line(1,0){170}}
\put(-240,440){\line(0,-1){40}}
\put(-280,480){\line(1,-1){40}}
\put(-220,500){\line(-3,-1){60}}
\put(-280,540){\line(3,-2){60}}
\put(-220,560){\line(-3,-1){60}}
\put(-260,600){\line(1,-1){40}}
\put(-260,640){\line(0,-1){40}}
\put(-400,640){\line(1,0){140}}
%---- Site du crihan ---------
\put(-500,340){\SunStation{0.21}{0.85}{0.85}}
\put(-460,470){\SunServer{0.21}{0.6}{0.7}}
\put(-565,470){\SunDisk{0.21}{0.6}{0.85}}
\put(-500,620){\SunRouter{0.21}{1.2}{1.2}}
\put(-517,282){\closepathfalse%
\LogoFlecheTwo{0.02}{0.55}{0.55}}
%---- Site du Lamifa ---------
\put(218,610){\SunStation{0.21}{0.85}{0.85}}
\put(55,610){\SunStation{0.21}{0.85}{0.85}}
\put(218,470){\SunStation{0.21}{0.85}{0.85}}
\put(218,340){\SunStation{0.21}{0.85}{0.85}}
\put(55,450){\SunServer{0.21}{0.6}{0.6}}
\put(62,340){\SunDisk{0.21}{0.6}{0.6}}
\put(-91,400){\SunRouter{0.21}{1.2}{1.2}}
\put(200,285){\closepathfalse
\LogoFlecheOne{0.04}{0.9}{0.9}}
\end{picture}
\end{center}

La programmation est la suivante :

\begin{verbatim}
\rouge=0\vert=0\bleu=0% c'est du noir !
\setlength{\unitlength}{0.11mm}
\begin{picture}(1020,498)(-580,240)
\put(-580,240){\framebox(1020,500){}}
\put(220,260){\small\bf (Amiens)}
\put(220,300){\small\bf Lamifa}
\put(-500,260){\small\bf (Rouen)}
\put(-500,300){\small\bf Crihan}
\put(-380,660){\small\sf TCP/IP}
\put(-380,700){\small\sf Ethernet}
\put(-160,320){\small\sf TCP/IP}
\put(-160,360){\small\sf Ethernet}
\put(-200,480){\small\sf France T\'el\'ecom}
\put(-200,520){\small\sf Num\'eris}
\put(-280,620){\line(1,0){40}}
\put(-200,420){\line(0,-1){40}}
\put(-240,400){\line(1,0){170}}
\put(-240,440){\line(0,-1){40}}
\put(-280,480){\line(1,-1){40}}
\put(-220,500){\line(-3,-1){60}}
\put(-280,540){\line(3,-2){60}}
\put(-220,560){\line(-3,-1){60}}
\put(-260,600){\line(1,-1){40}}
\put(-260,640){\line(0,-1){40}}
\put(-400,640){\line(1,0){140}}
%---- Site du crihan ---------
\put(-500,340){\SunStation{0.21}{0.85}{0.85}}
\put(-460,470){\SunServer{0.21}{0.6}{0.7}}
\put(-565,470){\SunDisk{0.21}{0.6}{0.85}}
\put(-500,620){\SunRouter{0.21}{1.2}{1.2}}
\put(-517,282){\closepathfalse%
\LogoFlecheTwo{0.02}{0.55}{0.55}}
%---- Site du Lamifa ---------
\put(218,610){\SunStation{0.21}{0.85}{0.85}}
\put(55,610){\SunStation{0.21}{0.85}{0.85}}
\put(218,470){\SunStation{0.21}{0.85}{0.85}}
\put(218,340){\SunStation{0.21}{0.85}{0.85}}
\put(55,450){\SunServer{0.21}{0.6}{0.6}}
\put(62,340){\SunDisk{0.21}{0.6}{0.6}}
\put(-91,400){\SunRouter{0.21}{1.2}{1.2}}
\put(200,285){\closepathfalse
\LogoFlecheOne{0.04}{0.9}{0.9}}
\end{picture}
\end{verbatim}

\end{manpage}

\begin{thebibliography}{99}{\TeX}

\bibitem{cc}Christophe C\'erin et Beno\^\i t Lemaire {\em Vers
l'introduction de la couleur dans \TeX}, Cahiers GUTenberg num\'ero 5,
pages .

\bibitem{pst}Adobe Systems Incorporated.  {\em PostScript Language
Reference Manual}, Addison-Wesley, October 1986.

\bibitem{psd}Adobe Systems Incorporated.  {\em PostScript Language
Tutorial and Cookbook}, Addison-Wesley, March 1987.

\bibitem{psu}Adobe Systems Incorporated.  {\em PostScript Language Program
Design}, Addison-Wesley, February 1988.

\bibitem{mt} Donald E.Knuth, {\em The \TeX book}, Addison-Wesley, 1986.

\bibitem{latex} Leslie Lamport.  {\em \LaTeX~user's guide \& reference
Manual}, Addison-Wesley, 1986.

\bibitem{rs} Raymond Seroul,  {\em Le petit livre de \TeX}, InterEdition,
mai 1989.

\end{thebibliography}

\end{document}
