2018-10-21 19:42:58 +00:00
|
|
|
|
/**
|
|
|
|
|
* \file utilities.c
|
|
|
|
|
* \brief Implémentation des fonctions utilitaires
|
|
|
|
|
*
|
|
|
|
|
* Dans ce fichier sont implémentées les fonctions utilitaires pour la
|
|
|
|
|
* manipulation des structures de données déclarées dans le fichier header
|
|
|
|
|
* correspondant.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#include "utilities.h"
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Créé un nouveau pixel initialisé avec les arguments `r`, `g` et `b` et
|
|
|
|
|
* renvoie un pointeur vers ce pixel créé.
|
|
|
|
|
*
|
|
|
|
|
* \param[in] r Valeur rouge du pixel
|
|
|
|
|
* \param[in] g Valeur verte du pixel
|
|
|
|
|
* \param[in] b Valeur bleue du pixel
|
|
|
|
|
* \return Pointeur sur une structure de type \ref Pixel
|
|
|
|
|
*/
|
2018-11-21 09:46:01 +00:00
|
|
|
|
Pixel *newPixel(uint8_t t_r, uint8_t t_g, uint8_t t_b) {
|
|
|
|
|
Pixel *res;
|
|
|
|
|
res = (Pixel *)malloc(sizeof(Pixel));
|
2018-11-03 15:35:06 +00:00
|
|
|
|
res->r = t_r;
|
|
|
|
|
res->g = t_g;
|
|
|
|
|
res->b = t_b;
|
2018-10-21 19:42:58 +00:00
|
|
|
|
res->visited = false;
|
|
|
|
|
return res;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Constructeur d’un conteneur d’image. Les dimensions sont initialisées à zéro
|
|
|
|
|
* (0) et son tableau de pixels a été créé et initialisé en tableau vide. Le
|
|
|
|
|
* constructeur renvoie un pointeur vers la nouvelle structure \ref Image.
|
|
|
|
|
*
|
|
|
|
|
* \return Pointeur vers une structure \ref Image initialisée.
|
|
|
|
|
*/
|
2018-11-21 09:46:01 +00:00
|
|
|
|
Image *newImage() {
|
|
|
|
|
Image *res;
|
|
|
|
|
res = (Image *)malloc(sizeof(Image));
|
2018-10-21 19:42:58 +00:00
|
|
|
|
res->x = 0;
|
|
|
|
|
res->y = 0;
|
|
|
|
|
res->pixels = darrayNew(sizeof(Pixel));
|
|
|
|
|
return res;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Destructeur d’un conteneur d’image. Le destructeur appellera le destructeur
|
|
|
|
|
* du vecteur de pixels qui sera libéré de la mémoire, puis ultimement le
|
|
|
|
|
* destructeur libérera la structure \ref Image pointée par le pointeur passé
|
|
|
|
|
* en argument.
|
|
|
|
|
*
|
|
|
|
|
* \param[in] self Conteneur d’image à détruire
|
|
|
|
|
*/
|
2018-11-21 09:46:01 +00:00
|
|
|
|
void deleteImage(Image *t_self) {
|
2018-11-24 20:58:55 +00:00
|
|
|
|
DEBUG { printf("deleted all pixels\n"); }
|
2018-11-03 15:35:06 +00:00
|
|
|
|
darrayDelete(t_self->pixels);
|
|
|
|
|
free(t_self);
|
2018-10-21 19:42:58 +00:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Constructeur d’un conteneur de segment. Le constructeur va initialiser les
|
|
|
|
|
* valeurs qu’il contiendra avec les arguments qui lui seront passés lors de
|
|
|
|
|
* l’appel de la fonction.
|
|
|
|
|
*
|
|
|
|
|
* \param[in] y Ordonnée à laquelle le segment réside
|
|
|
|
|
* \param[in] xd Abscisse extrême droite du segment
|
|
|
|
|
* \param[in] xg Abscisse extrême gauche du segment
|
|
|
|
|
* \return Pointeur sur un conteneur de segment
|
|
|
|
|
*/
|
2018-11-24 20:33:47 +00:00
|
|
|
|
Segment *newSegment(uint32_t t_xd, uint32_t t_xg) {
|
|
|
|
|
Segment *res = (Segment *)malloc(sizeof(Segment));
|
2018-11-03 15:35:06 +00:00
|
|
|
|
res->xd = t_xd;
|
|
|
|
|
res->xg = t_xg;
|
2018-10-21 19:42:58 +00:00
|
|
|
|
return res;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* \brief function description
|
|
|
|
|
*
|
|
|
|
|
* Constructeur de conteneur de zone, initialise grâce aux arguments la couleur
|
|
|
|
|
* de la zone et initialise un tableau dynamique vide de \ref Segment. Renvoie
|
|
|
|
|
* un pointeur vers la structure nouvellement créée.
|
|
|
|
|
*
|
|
|
|
|
* \param[in] r Valeur rouge de la couleur de la zone
|
|
|
|
|
* \param[in] g Valeur verte de la couleur de la zone
|
|
|
|
|
* \param[in] b Valeur bleue de la couleur de la zone
|
|
|
|
|
* \return Pointeur vers la structure créée
|
|
|
|
|
*/
|
2018-11-21 09:46:01 +00:00
|
|
|
|
Zone *newZone(uint8_t t_r, uint8_t t_g, uint8_t t_b) {
|
2018-11-24 20:33:47 +00:00
|
|
|
|
Zone *res = (Zone *)malloc(sizeof(Zone));
|
2018-11-03 15:35:06 +00:00
|
|
|
|
res->r = t_r;
|
|
|
|
|
res->g = t_g;
|
|
|
|
|
res->b = t_b;
|
2018-10-21 19:42:58 +00:00
|
|
|
|
res->segments = darrayNew(sizeof(Segment));
|
|
|
|
|
return res;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
2018-11-24 20:33:47 +00:00
|
|
|
|
* Destructeur de zone, libère la zone mémoire utilisée pour stocker les
|
|
|
|
|
* segments. Ne libère pas \p t_self lui-même mais son membre `segments`.
|
2018-10-21 19:42:58 +00:00
|
|
|
|
*
|
|
|
|
|
* \param[in] self Conteneur de zone à détruire
|
|
|
|
|
*/
|
2018-11-24 20:58:55 +00:00
|
|
|
|
void deleteZoneContent(Zone *t_self) { darrayDelete(t_self->segments); }
|