WIP: version stable avant la création des fonctions add / remove_an_arrow

TODO (next version).txt

@@ -0,0 +1,46 @@
+L'utilisation d'OpenGL fait que la première version de Gem-graph sera tout naturellement en 3D. Le modèle de marche aléatoire de dimères sera aussi facile à y réaliser que dans un modèle 1D (on pourrait même se servir d'une seule règle au lieu de deux !) (mais deux règles permettront un meilleur rendu).
+
+Modifier la forme des flèches ? 
+Pour cette première version, la forme "central star" + "cône" a l'avantage de la simplicité.
+La "central star" de chaque cube est commune aux six flèches possibles qui sont orientées chacune vers une face différente.
+Dans la version actuelle, elle est redessinée si plusieurs flèches sont dans le même cube.
+Ce dessin est peu coûteux (deux lignes superposées pour chaque nouvelle flèche)
+et ce cas (plusieurs flèches dans le même cube) sera peu fréquent dans les premiers modèles développés. Mais... TODO
+
+Le plus simple serait un trait allant du centre d'un cube au centre d'une de ses faces. Ce serait peu lisible pour des objets mais pourrait avoir un intérêt pour les tags (balises) éventuellement associés aux objets ou situations. Ces tags seraient machine-readable. Nécessairement. Seraient-ils human-readable aussi ? Ce serait idéal ! A inventer ou essayer, en tout cas. 
+Un seul trait aurait sûrement un intérêt dans la représentation de voisinages de Moore 3D (Je préfère ne pas imaginer ça pour l'instant !  Il va falloir choisir de ne représenter ou de ne visualiser qu'une partie des connexions à la fois...).
+
+Le premier objectif des versions à venir est l'extension du voisinage. Un voisinage type von Neumann 3D - le plus simple possible si on le veut symétrique par rapport aux axes de l'espace - est tout à fait indiqué pour cette première version. Mais les versions à venir devraient travailler en priorité avec des voisinages type Moore 3D approximativement spériques de rayon proche de celui de l'espace local. 
+Par ailleurs, Gem-graph ne peut avoir sa puissance théorique maximale que s'il peut utiliser un voisinage étendu à tout l'espace. Mais cette puissance est vraisemblablement inutile, sauf pour les démonstrations mathématiques d'équivalence avec les automates cellulaires, par exemple, ou d'autres formalismes.
+Par ailleurs, il est d'ores et déjà possible d'utiliser pleinement le "poids" (weight) ou la "charge" (load) des flèches.
+
+! WARNING !   J'ai inversé pôle Nord et pôle Sud. Et c'est à corriger, je pense. 👀️
+Ce sera une convention, bien sûr. Mais comment la choisir ? J'ai imaginé superposer repère orthonormé et repère géodésique. 
+Si je regarde un repère orthonormé 3D:
+les +x sont à ma droite, les -x à ma gauche  (Est - Ouest)
+les +y en haut, les -y en bas   (Zénith - Nadir)   et...  si l'axe des z vient vers moi,
+les +z sont derrière moi et les -z devant.   Donc les -z sont au Nord (que je regarde) et les +z sont au Sud.
+
+Les vertex situés aux intersections des "grilles" (X-X, Y-Y et Z-Z) sont-ils utiles ?
+Ils le seraient si ses cubes individuels étaient coloriés ou soulignés pour mettre en valeur des flèches qu'ils contiennent ou d'autres particularités.
+Mais tant qu'il n'est pas possible de rendre sélectivement transparentes les parois de cubes individuels (ou de tel ou tel objet dessiné par les flèches), cette fonction est inutilisable et les vertex situés aux intersections des grilles sont donc inutiles.
+On pourrait ne garder que ceux situés sur les faces de l'espace qui, eux, servent à tracer les grilles X-X, Y-Y et Z-Z.
+Le nombre de vertex de l'espace serait alors de 12 par cube-unité (soit 12 * x * y * z) plus les vertex intersections des seules faces de l'espace (soit (x * y + x * z + y * z) * 2). 
+A raison, bien sûr de trois nombres par vertex plus les couleurs.
+
+Je comprends (maintenant seulement !) que si des régions du buffer lignes (idem pour le buffer triangles) sont laissées vides (occupées par des zéros) elles seront néanmoins redessinées en permanence et que le seul moyen d'éviter cela est de réallouer la taille du buffer à chaque délétion ou chaque ajout de flèche.
+
+Néanmoins, lorsque le nombre de flèches présent dans l'espace est invariant, - cas de mes premiers modèles - il peut être avantageux de travailler dans un buffer de taille fixe. Il faut, pour cela, fixer une "densité maximale de flèches dans l'espace" nécessairement arbitraire. 
+Bien que ce nombre reste toujours arbitraire, on peut estimer que certaines de ses valeurs seront plus utiles/utilisables que d'autres :
+- un espace totalement vide ou totalement saturé ne pourrait rien représenter
+- un espace trop vide ou trop plein (à définir - c'est intuitif) aurait peu de chances de représenter des phénomènes intéressants. La marche aléatoire d'un seul ou de quelques dimères dans un grand espace, par exemple, servira plus de test pour le bon fonctionnement de Gem-graph que de modèle d'étude.
+- on peut considérer un espace rempli de flèches aux 2/3 comme équivalent à un espace repli au tiers (1/3) mais où les flèches seraient écrites "en creux" et, par conséquent, moins lisibles. Inutile, donc, de remplir plus de la moitié de l'espace. 
+D'expérience,
+- les densités de l'ordre du tiers (1/3 des unités de l'espace occupées par au moins une flèche) suffisent à représenter un nombre de phénomènes tel qu'il n'est pas nécessaire, au moins dans un premier temps, de prévoir davantage (mais des réalloc sont toujours possibles) et les densités trop fortes sont peu lisibles.
+Un buffer lignes pourrait donc avoir une taille fixe qui serait calculée selon les paramètres suivants :
+-   x * y * z = nombre de cubes
+-   nombre de flèches moyen par cube  = 2   (il s'agit d'un nombre "moyen" qui surestime très probablement le nombre de flèches utilisé par la plupart des modèles)
+-   dessin d'une flèche seule dans un cube = 3 + 4 traits (soit 14 nombres)
+Faut-il coder cette option ?
+
+

src/graphics/buffers.c

@@ -432,12 +432,15 @@ static void draw_a_central_star(GLuint *lines_origin, long n)
     draw_line (lines_origin, n + 4, n + 5);
 }
 
-#define EAST   0
+// I'm standing on Earth (any planet or star or spinning spheroid, in fact)
-#define WEST   1
+// and looking towards its North pole
-#define ZENITH 2
+
-#define NADIR  3
+#define EAST   0 // + x  rouge
-#define NORTH  4
+#define WEST   1 // - x  cyan
-#define SOUTH  5
+#define ZENITH 2 // + y  vert
+#define NADIR  3 // - y  magenta
+#define NORTH  4 // + z  bleu
+#define SOUTH  5 // - z  jaune
 
 static void draw_some_arrows_demo (GLuint *lines_origin,
                               long s, long x, long y, long z,
@@ -542,10 +545,15 @@ static void show_user_choices(long model_size_x,
         i, *(arrows + i * 5 + 0), *(arrows + i * 5 + 1), *(arrows + i * 5 + 2), *(arrows + i * 5 + 3), *(arrows + i * 5 + 4));
 
     printf("NB   If you play : 'draw_some_arrows_demo(...)',\
-    1) don't forget to set model_arrows_nb to 6 (line 573 in graphics.c) and \
+    don't forget to set model_arrows_nb to 6 (line 555 in graphics.c). \
-    2) nombre_de_cases_contenant_des_fleches to 6 (line 576)   ( ;- ))\n");
+    The 'nombre_de_cases_contenant_des_fleches' is automatically set to 6 (line 560)   ( ;- ))\n");
+
     printf("NB   The same is true if you play : 'draw_some_arrows(...)',\
-    and modify the number of arrows described above the line 555.\n");
+    and modify the number of arrows described above the line 570.\n");
+
+    printf("NB   If you play : 'draw_some_arrows(...)' and add some more arrows (above the line 570),\
+    you must also increase the number of arrows (line 555) \n\
+    The 'nombre_de_cases_contenant_des_fleches' is automatically set equal to the number of arrows  (line 560).\n");
 }
 
 

src/graphics/graphics.c

@@ -542,25 +542,6 @@ bool graphics_init_shaders(const void *gl_area)
 
 
 
-
-
-
-
-
-
-
-
-
-
-GLuint arrows[] = {
-     1,    0,  0, 0, 0,
-     1,    1,  1, 0, 0,
-     1,    2,  2, 1, 1,
-     1,    3,  2, 2, 1,
-     1,    4,  3, 0, 1,
-     1,    5,  3, 0, 2
-// load, site, x, y, z
-};
 
 static void get_model_data_and_user_preferences(){
 
@@ -571,12 +552,12 @@ static void get_model_data_and_user_preferences(){
 
     // XXX ONLY space drawed, no arrows yet
 
-    model_arrows_nb = 6; //  assert : l'emplacement des flèches est contraint
+    model_arrows_nb = 9; //  assert : l'emplacement des flèches est contraint
                          //  par model_space_size_x, y, z et le nombre de sites
 
-    nombre_de_cases_contenant_des_fleches = 6;  //  à calculer   TODO
+    nombre_de_cases_contenant_des_fleches = 8;  //  à calculer   TODO
-
+    // !  WARNING  !  Pour l'instant égal au nombre de flèches ! (central stars réécrites)
-
+    nombre_de_cases_contenant_des_fleches = model_arrows_nb;
 
 //    pref_mark_unit_space = 0;       // 0 = no marks, 1 = 1st, 2 = last, 3 = both
 //    pref_style_lines_planes = 0;    // 0 = arrows as lines, 1 = as planes, 2 = mix
@@ -586,6 +567,20 @@ static void get_model_data_and_user_preferences(){
     pref_test_diagonal = 0;
 }
 
+GLuint arrows[] = {
+     1,    0,  0, 0, 0,
+     1,    1,  1, 0, 0,
+     1,    2,  2, 1, 1,
+     1,    3,  2, 2, 1,
+     1,    4,  3, 0, 1,
+     1,    5,  3, 0, 2,
+     1,    1,  3, 0, 2,
+     1,    0,  2, 0, 2,
+     1,    5,  2, 1, 1,
+// load, site, x, y, z
+};
+
+
 
 
 
@@ -624,7 +619,7 @@ static void compute_buffers_sizes(int model_space_size_x,
 
     buffer_colors_size = buffer_vertex_size;
 
-    buffer_plans_size = 0;
+    buffer_plans_size = 3;
 
     long grids_lines =
         (pref_show_grid % 2 == 0) * (model_space_size_x + 1) * (model_space_size_y + 1)
@@ -643,8 +638,7 @@ static void compute_buffers_sizes(int model_space_size_x,
 
 //    buffer_lines_size += 16 + 20;  // draw a small cube with diagonals
 
- //   buffer_lines_size -= 2;
+//    buffer_lines_size -= 2;  TEST !
-//    buffer_lines_size += 30;
 
     if (1) printf("allocated buffers sizes  :%4d/3 = %3d vertices, %4d/3 = %3d colors,\
  %4d/2 = %3d lines, %4d/3 = %3d plans.\n",