/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Gem-graph client * * Finite state machine header * * * * Copyright © 2021 Libre en Communs * * Copyright © 2024 Jean Sirmai * * * * This file is part of Gem-graph. * * * * This program is free software: you can redistribute it and/or modify it * * under the terms of the GNU Affero General Public License * * as publishedby the Free Software Foundation, * * either version 3 of the License, or (at your option) any later version. * * * * This program is distributed in the hope that it will be useful, * * but WITHOUT ANY WARRANTY; without even the implied warranty of * * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * * See the GNU Affero General Public License for more details. * * * * You should have received a copy of the GNU Affero General Public License * * along with this program. If not, see . * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ #pragma once #include #include #include #include /******************************************************************************/ /* S T A T E M A C H I N E */ /******************************************************************************/ // called by widgets through signal functions enum fsm_select_EXEC_EDIT { EXEC, EDIT }; enum fsm_select_STATE_RULES_DATA { SYNTH, STATE, RULES, DATA }; enum fsm_select_STORE_RESTORE_RESET { STORE, RESTORE, RESET }; enum fsm_measure_type {DATE_RULE_EXEC, RULE_EXEC_NB, OBJECT_NB, ELAPSED_TIME }; #define n_rules 128 // arbitrary #define n_objects 32 // arbitrary too, #define n_situations 128 // and so on... typedef struct tool_list {int value; struct tool_list *suiv;} tool_list ; typedef struct data_list {int value; struct data_list *suiv;} data_list ; typedef struct disp_list {int value; struct disp_list *suiv;} disp_list ; /******************************************************************************/ /* J O U R N A L */ /******************************************************************************/ /* * * * * - J O U R N A L M E T A R U L E S - * * * * * * Un seul fsm_journal_event() par fonction * ? sauf si cette fonction génère plusieurs autres fonctions d'intérêt ? * * S'il y a deux fsm_journal_event() (begin / end) dans une fonction * ils doivent avoir la même étiquette : MESSAGE, SOURCE, TARGET * * * * * * - J O U R N A L M E T A R U L E S - * * * */ enum severity {CRITICAL, ERROR, WARNING, INFO, MESSAGE, DEBUG, REPETITIVE, SPEW}; enum source { SOURCE, TARGET, JOURNAL, FSM, PREFER, MAIN, APP, WIDGETS, SIGNAL, MAIN_WINDOW, DIALOG_WINDOW, MODAL_WINDOW, TEXT_WINDOW, AUTO_NOTIFICATION, TOPBAR, TOPBAR_LEFT, TOPBAR_RIGHT, TOPBAR_CENTER, SYNTH_PAGE, STATE_PAGE, RULES_PAGE, MEASURES_PAGE, RESULTS_PAGE, SYNTH_GLAREA, SYNTH_ALL_RESULTS, SYNTH_TIME_DEP_RESULTS, SYNTH_TIME_INDEP_RESULTS, STATE_TOP, STATE_BOTTOM, STATE_GLAREA, STATE_CAMERA, RULE_GEOMETRY, RULE_GLAREA, RULE_CAMERA, RULE_ALGEBRA, RULE_CONDITION, RULE_ASSIGN, RULE_ID, RULES_TREE, RULES_COMPARE, RULES_USE, MEASURES_TOOLS, MEASURES__ACTIVITY, MEASURES__DISPLAY, RESULTS, TIME_DEP_RESULTS, TIME_INDEP_RESULTS, WIDGET, BUTTON, SCROLL, GLAREA, TEXT, LABEL, TREE, SLIDER, EXPANDER, ENTRY, SWITCH_STATE_RULES_DATA, SLIDER_X, SLIDER_Y, SLIDER_Z, SLIDER_A, SLIDER_B, SLIDER_C, }; enum value {VALUE}; // to use or not to use ... (plutôt non) #define JOURNAL_LOG_MAX_LENGTH 255 typedef struct unit {long yy_dd_mm; long usec; const char *file_source; const char *function_source; const char *string_value; struct unit *prev; struct unit *next;} unit; // journal unit structure typedef struct {unit *first; unit *last;} journal; // journal unit access structure void fsm_journal_init (journal *jj); // init from main void fsm_journal_push_front (journal *jj, // add an évènement at the journal front const char *file_source, // def: fsm/dispatch const char *function_source, // call: any call that does not have const char *string_value); // the log address void fsm_journal_clear (journal *jj, const char *file_source, const char *function_source, const char *string_value); // empty the journal long fsm_journal_pop_back (journal *jj, // removes an évènement const char *file_source, // at the journal end const char *function_source, const char *string_value); int fsm_journal_length (journal jj); // journal length void fsm_journal_seek (journal jj, // seek for an évènement long usec, // in the journal const char *file_source, const char *function_source, const char *string_value); void fsm_journal_publish (journal jj); // display the journal // ----------------------------------------------------------------------------- // ref: sudo cat /var/log/messages // journal fsm_get_journal(); // def: fsm/dispatch call: fsm/prefer/fsm_store_restore_reset() void fsm_journal_publication_request (); // def: fsm/dispatch call: main; void fsm_journal_event (int severity, int source, const char *file_source, const char *function_source, const char *string_value); // def: fsm/dispatch call: widget/dispatch; // ----------------------------------------------------------------------------- void fsm_init (char *message); // def: fsm/dispatch; call: main; void fsm_engine_init(); // def: fsm/engine/engine; call main void fsm_preferences_list_init(); // def: fsm/prefer; call: fsm/dispatch; void fsm_measures_list_init(); // def: fsm/measure/manage.c; call: fsm/dispatch; void fsm_results_list_init(); // def: fsm/results; call: fsm/dispatch; void fsm_displayable_list_init(); // def: fsm/prefer; call: fsm/dispatch; int fsm_get_exec_edit(); // def: fsm/dispatch; call: signal; // widget/state/dispatch; // widget/rules/selected/dispatch; int fsm_get_state_rules_data(); // def: fsm/dispatch; call: signal; void fsm_set_exec_edit (int value);// def: fsm/dispatch; call: signal; void fsm_set_state_rules_data (int value); // def: fsm/dispatch; call: signal; void fsm_store_restore_reset (int choice, int value);// def: prefer; call: signal; bool fsm_get_preferences_state(); // def: fsm/dispatch; call: - - - void fsm_set_preferences_modified (bool value); // def: fsm/dispatch; // call: signal; fsm/prefer; void fsm_add_measure (char *measure_name); // def: fsm/measure/manage.c; // call: widget/measure/dispatch; void fsm_add_result (char *result_name); // def: fsm/result; call: - - - void fsm_add_displayable (char *displayable_name);// def: fsm/prefer; call: fsm/prefer; void fsm_reset_all_situations_transparencies_at_value (int value); // provisoire... // def: fsm/prefer; call: signal; // --------------------------------------------------------------- WIP ------ // def: measure/tool_list call: measure/tool_list (about the following functions...) void fsm_tools_list_insert (tool_list **tl, int value); int fsm_tools_list_pop (tool_list **tl); int fsm_tools_list_length (tool_list *tl); void fsm_tools_list_clear (tool_list **tl); void fsm_tools_list_view (tool_list *tl); void fsm_tools_list_test(); // def: measure/manage; call: measure/manage; // def: fsm/measure/manage/; call: rule exec void fsm_rule_trig_measure (int rule_id, int object_id, int measure_id); // --------------------------------------------------------------- WIP ------ void fsm_add_data (data_list d, int *p_data, int *p_target); int fsm_get_data (data_list d, int from, int to); void fsm_remove_data (data_list d, int *p_data); // --------------------------------------------------------------- WIP ------ void fsm_disp_add_chart (disp_list d, int *p_chart); int fsm_disp_get_chart (disp_list d, int from, int to); void fsm_disp_remove_chart (disp_list d, int *p_chart);