Grilles (Grids)

Une grille est tout simplement un tableau à deux dimensions. Une grille présente une largeur et une hauteur définies par des entiers. La structure de la grille vous permet de déterminer et supprimer les valeurs de cellules de la grille en fournissant un index (devant débuter par 0 et ce pour les deux directions x et y). Mais il est également possible de déterminer des plages de valeurs, ajouter des valeurs particulières, de déterminer la somme, le maximum, le minimum ainsi que la valeur moyenne d'une plage donnée. Une grille peut être utile pour représenter par exemple un terrain de jeu. Bien que toutes ces fonctionnalités puissent également être réalisées à l'aide de tableaux à deux dimensions, les opérations sur des régions ou plages sont réalisées beaucoup plus rapidement en employant des grilles. Les fonctions suivantes existent :

ds_grid_create(w, h) Crée une nouvelle grille de largeur w et de hauteur h. La fonction retourne un entier représentant l'id de la grille qui devra être utilisé par toutes les fonctions devant accéder à la nouvelle grille créée.
ds_grid_destroy(id) Détruit la grille d'ID id, libérant ainsi la mémoire utilisée. Ne pas oublier d'invoquer cette fonction quand vous n'aurez plus besoin d'utiliser cette grille.
ds_grid_resize(id, w, h) Redimensionne la grille d'ID id avec les nouvelles largeur w et hauteur h. Les cellules déjà existantes conserveront leur valeur originale.
ds_grid_width(id) Retourne la largeur de la grille d'ID id.
ds_grid_height(id) Retourne la hauteur de la grille d'ID id.
ds_grid_clear(id, val) Initialise le contenu de la grille d'ID id, avec la valeur indiquée val (val peut être aussi bien un nombre qu'une chaîne).
ds_grid_set(id, x, y, val) Initialise la cellule indiquée x,y de la grille d'ID id avec la valeur mentionnée val (qui peut être un nombre ou une chaîne).
ds_grid_add(id, x, y, val) Ajoute la valeur val dans la cellule indiquée x,y de la grille d'ID id. En ce qui concerne les chaînes, cela correspond à une concaténation.
ds_grid_multiply(id, x, y, val) Multiplie la valeur val par la cellule indiquée x,y de la grille d'ID id. Cette fonction ne concerne uniquement que les nombres.
ds_grid_set_region(id, x1, y1, x2, y2, val) Initialise toutes les cellules d'une région donnée x1,y1,x2,y2 de la grille d'ID id avec la valeur indiquée val (concerne aussi bien les nombres que les chaînes de caractères).
ds_grid_add_region(id, x1, y1, x2, y2, val) Ajoute la valeur val aux cellules de la plage x1,y1,x2,y2 dans la grille d'ID id. En ce qui concerne les chaînes, cela correspond à une concaténation.
ds_grid_multiply_region(id, x1, y1, x2, y2, val) Multiplie par la valeur val les cellules de la plage x1,y1,x2,y2 de la grille d'ID id. Cette fonction ne concerne uniquement que les nombres.
ds_grid_set_disk(id, xm, ym, r, val) Initialise avec la valeur val toutes les cellules du disque avec comme centre xm,ym et rayon r.
ds_grid_add_disk(id, xm, ym, r, val) Ajoute la valeur val à toutes les cellules du disque de centre xm,ym et de rayon r.
ds_grid_multiply_disk(id, xm, ym, r, val) Multiplie par la valeur val toutes les cellules du disque de centre xm,ym et de rayon r.
ds_grid_get(id, x, y) Retourne la valeur de la cellule indiquée x,y de la grille d'ID id.
ds_grid_get_sum(id, x1, y1, x2, y2) Retourne la somme des valeurs de cellules de la plage x1,y1,x2,y2 de la grille d'ID id. Ne fonctionne que si les cellules ne contiennent que des nombres.
ds_grid_get_max(id, x1, y1, x2, y2) Retourne le maximum des valeurs de cellules de la plage x1,y1,x2,y2 de la grille d'ID id. Ne fonctionne que si les cellules ne contiennent que des nombres.
ds_grid_get_min(id, x1, y1, x2, y2) Retourne le minimum des valeurs de cellules de la plage x1,y1,x2,y2 de la grille d'ID id. Ne fonctionne que si les cellules ne contiennent que des nombres.
ds_grid_get_mean(id, x1, y1, x2, y2) Retourne la moyenne des valeurs de cellules de la plage x1,y1,x2,y2 de la grille d'ID id. Ne fonctionne que si les cellules ne contiennent que des nombres.
ds_grid_get_disk_sum(id, xm, ym, r) Retourne la somme des valeurs des cellules du disque.
ds_grid_get_disk_min(id, xm, ym, r) Retourne le minimum des valeurs des cellules du disque.
ds_grid_get_disk_max(id, xm, ym, r) Retourne le maximum des valeurs des cellules du disque.
ds_grid_get_disk_mean(id, xm, ym, r) Retourne la moyenne des valeurs des cellules du disque.
ds_grid_value_exists(id, x1, y1, x2, y2, val) Indique si la valeur val apparaît quelque part dans la plage x1,y1,x2,y2.
ds_grid_value_x(id, x1, y1, x2, y2, val) Retourne l'abscisse x de la cellule dans laquelle la valeur val apparaît dans la plage x1,y1,x2,y2.
ds_grid_value_y(id, x1, y1, x2, y2, val) Retourne l'ordonnée y de la cellule dans laquelle la valeur val apparaît dans la plage x1,y1,x2,y2.
ds_grid_value_disk_exists(id, xm, ym, r, val) Indique si la valeur val apparaît quelque part dans le disque.
ds_grid_value_disk_x(id, xm, ym, r, val) Retourne l'abscisse x de la cellule dans laquelle la valeur val apparaît dans le disque.
ds_grid_value_disk_y(id, xm, ym, r, val) Retourne l'ordonnée y de la cellule dans laquelle la valeur val apparaît dans le disque.

<< Traduction française par Philippe Ragni - (2005) >>