CONVENTIONS ET RÈGLES DE NOMMAGE 2024 + ./instanced_cubes 🙂

This commit is contained in:
Jean Sirmai 2024-10-03 09:10:37 +02:00
parent 07aba7fae5
commit eab476145e
Signed by: jean
GPG Key ID: FB3115C340E057E3
3 changed files with 62 additions and 21 deletions

View File

@ -1,6 +1,6 @@
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* Gem-graph client * * Gem-graph client *
* Alphabetic Index of functions names * * Alphabetic Index of functions names *
* * * *
* Copyright © 2021 Libre en Communs <contact@a-lec.org> * * Copyright © 2021 Libre en Communs <contact@a-lec.org> *
* Copyright © 2024 Jean Sirmai <jean@a-lec.org> * * Copyright © 2024 Jean Sirmai <jean@a-lec.org> *
@ -21,6 +21,57 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>. * * along with this program. If not, see <http://www.gnu.org/licenses/>. *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/* * * * * * * * * * * * * * * * * * * * * * * * * * *
*
* C O N V E N T I O N S E T R È G L E S D E N O M M A G E - 2 0 2 4
*
* Toute fonction qui peut être appelée à partir d'un autre module
* doit indiquer, par son nom:
*
* - le lieu (le fichier) où elle est définie,
* - le type d'action qu'elle exécute et
* - l'objet ou les objets modifié.s par cette action.
*
* - - -
*
* Ces informations sont encodées au moyen de "préfixes" standardisés et
* le nom de chaque fonction est une combinaison/concaténation de ces préfixes.
* En octobre 2024, la première version de cet index classe en trois listes
* l'ensemble des préfixes préférentiellement utilisés.
*
* Ces listes sont en cours d'élaboration.
* Elles ne sont ni limitatives ni ordonnées.
*
* - - -
*
* Les fichiers sont définis par leur adresse dans la hiérarchie "src":
* ex: /graphics/draw/
* /fsm/measures/manager/
* /util/draw/gl/
* /widget/one_rule/algebra/assign/
*
* Liste des préfixes indiquant la fonction:
* get, set, reset, read, write, print, edit, concat, design,
* init, create, add, remove, trigger, draw, erase, restore, push
* setup, shutdown, update, list, sort, seek, select, fix, debug,
* render, realize, unrealize, activate, exec, stop, signal,
*
* Liste des objets sur lesquels agissent les fonctions:
* number, string, view, window, list, tree, stack,
* state, rules, data, results, image, stock,
* widget, button, slider, color,
* glarea, shader, file, buffer,
* point, line, plan, space_unit, site, arrow, slot, vertex, ridge,
* callback, signal,
*
* * * * * * * * * * * * * * * * * * * * * * * * * * */
concat util/strings_op concat util/strings_op
create_axis_slider util/draw/gl 223 create_axis_slider util/draw/gl 223
free_stack_slot graphics/init 36 free_stack_slot graphics/init 36

BIN
instanced_cubes Executable file

Binary file not shown.

View File

@ -33,28 +33,18 @@
* https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93viewmodel * https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93viewmodel
* https://en.wikipedia.org/wiki/Multitier_architecture * https://en.wikipedia.org/wiki/Multitier_architecture
* *
* Le nom de toute fonction qui peut être appelée d'un autre module doit comporter :
* - 1) le nom du module auquel elle appartient (widget, graphics, parse,...)
* - 2) une indication sur son action (get, set, rec, fix, create, add,...)
* - 3) une indication sur l'objet de cette action (state, rules, stock,...)
*
* ex: on_save_current_model()
* model_get_dim_value()
*
* Le fichier 'state.c' est devenu un dossier contenant
* les fichiers 'top.c', 'middle.c', 'bottom.c' et 'distrib.c' (2024-08)
*
* 'middle.c' deviendra, s'il est trop volumineux, un dossier 'middle'
* contenant, par exemple, les fichiers 'camera.c' ou 'contrasts.c' et d'autres
* et ainsi de suite ...
*
* Une fonction comme : get_zoom_box()
* devra alors être renommé : state_camera_get_zoom_box() (par exemple)
*
* _________________
* *
* *
* ORGANISATION ACTUELLE * gcc `pkg-config --cflags --libs gtk4 epoxy glib-2.0` -lm -o instanced_cubes instanced_cubes.c
* ./instanced_cubes
*
*
*
*
*
*
*
* ORGANISATION ACTUELLE (Octobre 2024)
* *
* 1) Les structures hiérarchiques. * 1) Les structures hiérarchiques.
* -------------------------------- * --------------------------------