Content-type: text/html
<BASE HREF="URL"><TITLE>THEMIS Documentation autonatique des programmes</TITLE>

<H1>Documentation d'un fichier</H1>
<address>miguel@themis.obspm.fr</address>
<HR>
<H3>Introduction:</H3>
Cette documentation admet une structure commune, il y a toujours une description <BR> 
générale du fichier au début puis une description des fonctions définies dans le fichier.<BR>
<P><HR><P>


<H3><U>FICHIER util_obscu.c</U></H3><BR>
</I><LI>-Auteur(s):<UL><I>Monique Savinelli
</UL></I><LI>-Rôle:<UL><I>
Le fichier regroupe les fonctions utiles pour la mesure des<BR>courants d'obscurité.<BR>
</UL>

</UL>
</UL>
</UL>

</UL>
</UL>
</UL></I><LI>-Fonctions:<UL><I></I><LI>Internes au fichier:<UL><I>
<A HREF="#add_fenetre">add_fenetre</A><BR>
<A HREF="#init_fenetre">init_fenetre</A><BR>
<A HREF="#affiche_fenetre">affiche_fenetre</A><BR>
<A HREF="#div_fenetre">div_fenetre</A><BR>


</UL>
</UL>
</UL></I><LI>-Commentaires:<UL><I>
Lorsque l'on fait des courants d'obscurité sur les caméras (ie<BR>des acquisitions avec l'obturateur fermé) on ajoute les résultats qui<BR>sont des fenêtres de taille maximale, dans une variable dont les<BR>valeurs vont grandir jusqu'à ce que l'on arrête les acquisitions. <BR>On fait alors une moyenne en divisant le résultat par le nombre de fois<BR>que l'on a ajouté une fenêtre.<BR>
</UL>
<P><HR><P>


<H3><U>Fonction <A NAME="add_fenetre">add_fenetre</A></U></H3><BR>
</I><LI>-Rôle:<UL><I>
Cette fonction ajoute une fenêtre à une autre de même taille<BR>
</UL>

</UL></I><LI>-Prototype:<UL><I>
void add_fenetre(nblig,nbcol,fen1,fen2)<BR>
</UL></I><LI>-Paramètres:<UL><I>
int nblig; nombre de lignes des fenêtres<BR>int nbcol; nombre de colonnes des fenêtres<BR>u_long *fen1;<BR>Datum *fen2;<BR>pointeurs sur les fenêtres.<BR>fen2 est passé par valeur<BR>fen1 est passé par valeur résultat.<BR>
</UL>

</UL>
</UL>
</UL>

</UL></I><LI>-Description:<UL><I>
Ajoute pixel par pixel les fenêtres et met le résultat dans fen1.<BR>
</UL>

</UL>
</UL>
</UL>

</UL>
</UL>
</UL>

</UL>
<P><HR><P>


<H3><U>Fonction <A NAME="init_fenetre">init_fenetre</A></U></H3><BR>
</I><LI>-Rôle:<UL><I>
Initialiser une fenêtre !<BR>
</UL>

</UL></I><LI>-Prototype:<UL><I>
u_long *init_fenetre(nblig,nbcol)<BR>
</UL></I><LI>-Paramètres:<UL><I>
int nblig,nbcol;<BR>
</UL>

</UL>
</UL>
</UL></I><LI>-Retour: <UL><I>Le pointeur sur la fenêtre.
</UL></I><LI>-Description:<UL><I>
effectue un malloc pour allouer le pointeur sur la fenêtre et met des 0<BR>partout dans la zone allouée.<BR>
</UL>

</UL>
</UL>
</UL>

</UL>
</UL>
</UL>

</UL>
<P><HR><P>


<H3><U>Fonction <A NAME="affiche_fenetre">affiche_fenetre</A></U></H3><BR>
</I><LI>-Rôle:<UL><I>
Affichage d'une fenêtre pour tester le développement des programmes.<BR>
</UL>

</UL></I><LI>-Prototype:<UL><I>
void affiche_fenetre(fen,nblig,nbcol)<BR>
</UL></I><LI>-Paramètres:<UL><I>
u_long	*fen;<BR>int	nblig,nbcol;<BR>
</UL>

</UL>
</UL>
</UL></I><LI>-Retour:<UL><I>
rien du tout.<BR>
</UL></I><LI>-Description:<UL><I>
on fait des "print", soit de toute la fenêtre, soit d'une petite partie,<BR>car les fenêtres réelles ne peuvent pas être affichées (elles sont trop<BR>grosses). Cependant, on peut tout afficher, si on travaille sur des <BR>petites fenêtres pour tester le programme.<BR>
</UL>

</UL>
</UL>
</UL>

</UL>
</UL>
</UL>

</UL>
<P><HR><P>


<H3><U>Fonction <A NAME="div_fenetre">div_fenetre</A></U></H3><BR>
</I><LI>-Rôle:<UL><I>
Effectue une moyenne sur la fenêtre.<BR>
</UL>

</UL></I><LI>-Prototype:<UL><I>
void div_fenetre(nblig,nbcol,nbfen,fen)<BR>
</UL></I><LI>-Paramètres:<UL><I>
int nblig,nbcol; dimension de la fenêtre.<BR>int nbfen:	Ce par quoi il faut diviser<BR>u_long	*fen;<BR>la fenêtre passé par résultat et par valeur.<BR>
</UL>

</UL>
</UL>
</UL>

</UL></I><LI>-Description:<UL><I>
On divise chaque pixel par nbfen.<BR>
</UL>

</UL>
</UL>
</UL>

</UL>
</UL>
</UL>

</UL></I><LI>-Commentaires:<UL><I>
Cette fonction sert à effectuer la moyenne. Lorsque l'on a ajouté<BR>toutes les fenêtres et stocké le résultat, on divise par le nombre<BR>de fenêtres que l'on a ajouté.<BR>
</UL>
<P><HR><P>