<BODY BGCOLOR="#ffffff">
<CENTER>
<TABLE BORDER=+3>
<TD align=center>
<IMG SRC="//www.infres.enst.fr/gif/logo-enst-89a.gif" WIDTH=120) ALIGN=middle>
<p>
Département
<b>INFORMATIQUE</b>
</TD>
</TABLE>
<p>
<H1>
Mode d'emploi de la bibliothèque graphique.h <BR>
sur stations de travail</H1>
<p>
<H3>Interface de programmation permettant
dans une application écrite en C<BR>
d'utiliser des fonctions graphiques de base <BR>
développées sous X11</H3>
<p>
</CENTER>
<IMG SRC="../images/rainbolg.gif" border=1>
<H1>Sommaire</H1>
<DL>
<DL>
<DT><A href="#AVERTISSEMENT">Avertissement</A></DT>
<DT><A href="#FONCTIONS">Fonctions graphiques </A></DT>
<DD><A href="#FENETRE">Création et suppression d'une fenêtre graphique</A></DD>
<DD><A href="#TRACES">Tracés élémentaires</A></DD>
<DD><A href="#COULEURSDEBASE">Couleurs disponibles par défaut pour les traits et contours</DD></A>
<DD><A href="#INTERFACE">Interface avec l'utilisateur</DD></A>
<DT><A href="#EXEMPLE">Un exemple utilisant graphique.h</DT></A>
<DT><A href="#MAKEFILE">Un modèle de Makefile</DT></A>
</DL>
</DL
<p>
<IMG SRC="../images/rainbolg.gif" border=1>
<p>
<A NAME="AVERTISSEMENT"></A>
<h2>Avertissement</h2>
Cette bibliothèque doit être correctement mentionnée pour la compilation (<tt>#include <graphiqu.h></tt>) et pour l'édition de liens (<tt>gcc -lgraphic</tt>). Elle permet de réaliser simplement
quelques tracés graphiques de base. Il est à noter que toutes les
fonctions travaillent avec des coordonnées utilisateur, c'est à
dire relativement aux intervalles de valeurs définis lors de la
création d'une fenêtre graphique.<p>
En ce qui concerne les couleurs, une palette est définie par
défaut avec 256 couleurs dont les 16 premières sont les
mêmes que les 16 premières couleurs des PC.<p>
Une fonction vous permettra de redéfinir vos propres couleurs avec leurs
composantes (Rouge, Vert, Bleu).
<p>
<IMG SRC="../images/rainbolg.gif" border=1>
<A NAME="FONCTIONS"></A>
<h2>Fonctions graphiques </h2>
<A NAME="FENETRE"></A>
<h3>Création et suppression d'une fenêtre graphique</h3>
<DL>
<DT><tt>void Initialisation_Graphique (float xmin, float ymin, float xmax, float ymax);</tt><BR></DT>
<DD><font size=-1>Cette fonction ouvre une fenêtre graphique dont les dimensions sont délimitées par le rectangle (xmin, ymin,xmax, ymax). Les coordonnées sont des coordonnées <u>utilisateurs</u> (nombres réels).<BR>
(xmin,ymin) est le point en bas à gauche et (xmax,ymax) est le point en haut à droite.</font></DD><P>
<DT><tt>void Fin_Graphique(void);</tt><BR></DT>
<DD><font size=-1>L'appel de cette fonction est <u>obligatoire</u> pour supprimer la fenêtre graphique, faute de quoi le processus qui la gère ne s'arrêtera pas et nécessitera d'être tué.</font></DD>
<DT><tt><p>void Efface(void);</tt><BR></DT>
<DD>Efface le contenu de la fenêtre.</font></DD>
</DL>
<p>
<IMG SRC="../images/rainbolg.gif" border=0>
<A NAME="TRACES"></A>
<h3>Tracés élémentaires</h3>
<DL>
<DT><tt>void Trait (float x1, float y1, float x2, float y2, int couleur);</tt></DT><BR>
<DD><font size=-1>Tracé d'un trait entre les points (x1,y1) et (x2,y2) avec la couleur numéro <tt>couleur</tt>.</font></DD><p>
<DT><tt>void Croix (float x, float y, int couleur);</tt></DT><BR>
<DD><font size=-1>Tracé d'une croix autour du point de coordonnées (x,y) dans un trait de la couleur numéro <tt>couleur</tt></font></DD>.<p>
<DT><tt>void Point (float x, float y, int couleur);</tt></DT><BR>
<DD><font size=-1>Tracé du point de coordonnées (x,y) de la couleur numéro <tt>couleur</tt>.</font></DD><p>
<DT><tt>void Cercle (float x, float y, int rayon, int couleur);</tt></DT><BR>
<DD><font size=-1>Tracé d'un cercle de centre (x,y) et de rayon <tt>rayon</tt> avec la couleur numéro <tt>couleur</tt>.</font></DD><p>
<DT><tt>void Disque (float x, float y, int rayon, int couleur);</tt></DT><BR>
<DD><font size=-1>Remplissage dans la couleur numéro <tt>couleur</tt> d'un cercle de centre (x,y) et de rayon <tt>rayon</tt>.</font></DD><p>
<DT><tt>void DrawPoly(int nbr_points, float *poly_points, int couleur);</tt></DT><BR>
<DD><font size=-1>Tracé avec la couleur numéro <tt>couleur</tt> d'un polygone dont les coordonnées sont stockées dans le tableau de réels <tt>poly_points</tt>. Le nombre de points du polygone est spécifié dans la variable <tt>nbr_points</tt>.</font></DD><P>
<DT><tt>void FillPoly(int nbr_points, float *poly_points, int couleur);</tt></DT><BR>
<DD><font size=-1>Remplissage dans la couleur <tt>couleur</tt> d'un polygone dont les coordonnées sont stockées dans le tableau de réels <tt>poly_points</tt>. Le nombre de points du polygone est spécifié dans la variable <tt>nbr_points</tt>.</font></DD><P>
<DT><tt>void DrawTriangle(float *poly_points, int couleur);</tt></DT><BR>
<DD><font size=-1>Tracé avec la couleur numéro <tt>couleur</tt> d'un triangle dont les coordonnées sont stockées dans le tableau de réels <tt>poly_points</tt>.</font></DD><P>
<DT><tt>void FillTriangle(float *poly_points, int couleur);</tt></DT><BR>
<DD><font size=-1>Remplissage dans la couleur <tt>couleur</tt> d'un triangle dont les coordonnées sont stockées dans le tableau de réels <tt>poly_points</tt>.</font></DD><P>
<DT><tt>void DrawRectangle(float x1, float y1, float x2, float y2, int couleur);</tt></DT><BR>
<DD><font size=-1>Tracé avec la couleur numéro <tt>couleur</tt> d'un rectangle déterminé par les points de coordonnées (x1,y1) et (x2,y2).</font></DD><P>
<DT><tt>void FillRectangle(float x1, float y1, float x2, float y2, int couleur);</tt></DT><BR>
<DD><font size=-1>Remplissage avec la couleur numéro <tt>couleur</tt> d'un rectangle déterminé par les points de coordonnées (x1,y1) et (x2,y2).</font></DD><P>
<DT><tt>void Ecrit(float x1, float y1, char *chaine, int couleur);</tt></DT><BR>
<DD><font size=-1>Ecriture de la chaine de caractères chaine dans la couleur numéro <tt>couleur</tt> à partir du point de coordonnées (x1,y1).</font></DD>
</DL>
<p>
<IMG SRC="../images/rainbolg.gif" border=>
<A NAME="COULEURSDEBASE"></A>
<h3>Couleurs disponibles par défaut pour les traits et contours</h3>
<table width=100%>
<TR>
<TD>0 = Black<BR>1 = Blue<BR>2 = Green<BR>3 = Cyan</TD>
<TD>4 = Red<BR>5 = Magenta<BR>6 = Brown<BR>7 = LightGray</TD>
<TD>8 = DarkGray<BR>9 = LightBlue<BR>10 = LightGreen<BR>11 = LightCyan</TD>
<TD>12 = LightRed<BR>13 = LightMagenta<BR>14 = Yellow<BR>15 = White</TD>
</TR>
</TABLE>
<p>
<IMG SRC="../images/rainbolg.gif" border=>
<A NAME="COULEUR"></A>
<h3>Création de couleurs</h3>
<DL>
<DT><tt>void CreateColorRGB(int numero,int R,int G,int B);</tt></DT>
<DD><font size=-1>Changement de définition de la couleur numéro <tt>numero</tt> en lui donnant les composantes (<tt>R,G,B</tt>)<BR>
Le numéro de la couleur varie entre 0 et 255.<BR>
Les valeurs des composantes sont des entiers compris entre 0 et 255.
</font></DD>
</DL>
<p>
<IMG SRC="../images/rainbolg.gif" border=0>
<A NAME="TEXTE"></A>
<h3>Manipulation de texte</h3>
<DL>
<DT><tt>void Hauteur_Texte(float hauteur);</tt><BR></DT>
<DD><font size=-1>Change la hauteur d'écriture de texte à l'écran.</font></DD><p>
<DT><tt>void itoa (int n, char s[]);</tt><BR></DT>
<DD><font size=-1>Convertit l'entier <tt>n</tt> dans la chaîne de caractères <tt>s</tt>.</font></DD>
</DL>
<p>
<IMG SRC="../images/rainbolg.gif" border=0>
<A NAME="INTERFACE"></A>
<h3>Interface avec l'utilisateur</h3>
<DL>
<DT><tt>void Deplace (float x1, float y1);</tt><BR></DT>
<DD><font size=-1>On se positiojnne au point de coordonnées (x,y).</font></DD><p>
<DT><tt>void Ecrit (char *chaine,int couleur);</tt></DT><BR>
<DD><font size=-1>Ecrit la chaîne de caractères <tt>chaine</tt> avec la couleur numéro <tt>couleur</tt>, à partir de la position courante.</font></DD><p>
<DT><tt>void EcritXY (float x, float y, char *chaine,int couleur);</tt></DT><BR>
<DD><font size=-1>Ecrit la chaîne de caractères <tt>chaine</tt> avec la couleur numéro <tt>couleur</tt>, à la position <tt>(x,y)</tt>.</font></DD><p>
<DT><tt>int Lit(void);</tt></DT><BR>
<DD><font size=-1>Ouverture d'une fenêtre de dialoque permettant l'acquisition de valeurs entières.<BR>
Retourne l'entier rentré au clavier.</font></DD><p>
<DT><tt>void Attente(void);</tt></DT><BR>
<DD><font size=-1>Attente d'un laps de temps.</font></DD>
</DL>
<p>
<IMG SRC="../images/rainbolg.gif" border=1>
<A NAME="EXEMPLE"></A>
<h1>Un exemple utilisant graphiqu.h</h1>
L'exemple suivant a été créé pour être utilisé et testé sur les ordinateurs PC de l'ENST et utilisant la bibliothèque mise à la disposition des élèves.
<BR>
A condition d'écrire correctement le <tt>Makefile</tt> destiné à créer le programme exécutable, il peut être utilisé sur les stations de travail de la même façon que sur les PC.<p>
<IMG SRC="../images/ind2.gif"><TT>demo.c</TT> : <A HREF="demo.c">Exemple de programme utilisant la bibliothèque graphique</A></b>
<p>
<IMG SRC="../images/rainbolg.gif" border=1>
<A NAME="MAKEFILE"></A>
<h1>Un modèle de Makefile</h1>
Les programmes compilés ne peuvent pas tourner indifféremment sur système solaris ou sunos. Il est donc indispensable d'effectuer la compilation adéquate pour lancer toute exécution de vos programmes.<P>
Pour organiser correctement votre travail nous vous conseillons de créer
3 fichiers différents:<BR>
- Makefile<BR>
- Makefile.solaris<BR>
- Makefile.sunos<BR>
<p>
similaires à ceux que vous trouverez ci-après. Il suffira ensuite de lancer la commande make solaris ou make sunos selon votre environnement.<p>
<p>
<IMG SRC="../images/ind2.gif"><TT>Makefile</TT> : <A HREF="Makefile">Fichier Makefile </A><BR>
<IMG SRC="../images/ind2.gif"><TT>Makefile.solaris</TT> : <A HREF="Makefile.solaris">Pour créer un exécutable sous solaris</A><BR>
<IMG SRC="../images/ind2.gif"><TT>Makefile.sunos</TT> : <A HREF="Makefile.sunos">Pour créer un exécutable sous sunos</A></b>
<CENTER>
</BODY>
<p>
<IMG SRC="../images/rainbolg.gif" border=1><p>
<CENTER>
<A HREF="http://www.infres.enst.fr/index.html"><IMG SRC="../images/inf.gif" width=40 border=0></A><br>
<font size=-1><A HREF="http://www.enst.fr/index-inf.html">Informatique</font></A><BR>
<A HREF="http://www.enst.fr/web/"><IMG SRC="../images/homepage.gif" border=0 align=middle></A>
<A HREF="mailto:danzart@inf.enst.fr"><IMG SRC="../images/mail.gif" width=50 align=middle></A>
<BR>
</CENTER>
<IMG SRC="../images/rainbolg.gif" border=1>
<CENTER>
<ADDRESS> Page maintenue par
<A HREF="HTTP://www.infres.enst.fr/~danzart">Annie Danzart </A>
</ADDRESS>
</CENTER>
<IMG SRC="../images/rainbolg.gif" border=1>