bf56b09422
Affiche les relations comme des nœuds indépendants et persistants. Généralise le stockage des positions aux entités et aux relations. Finalise la création de relation et le rafraîchissement du graphe.
126 lines
3 KiB
C
126 lines
3 KiB
C
/******************************************************************************
|
|
* @file graph_node_position.h
|
|
* @brief Modèle représentant la position persistée d'un nœud du graphe.
|
|
******************************************************************************/
|
|
|
|
#ifndef LABFY_INVESTIGATION_GRAPH_NODE_POSITION_H
|
|
#define LABFY_INVESTIGATION_GRAPH_NODE_POSITION_H
|
|
|
|
#include <glib.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/**
|
|
* @brief Modèle opaque représentant une position de nœud.
|
|
*/
|
|
typedef struct GraphNodePosition GraphNodePosition;
|
|
|
|
/**
|
|
* @brief Codes d'erreur produits par GraphNodePosition.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GRAPH_NODE_POSITION_ERROR_INVALID_ARGUMENT,
|
|
GRAPH_NODE_POSITION_ERROR_INVALID_IDENTIFIER,
|
|
GRAPH_NODE_POSITION_ERROR_INVALID_COORDINATE,
|
|
GRAPH_NODE_POSITION_ERROR_INVALID_DATE
|
|
} GraphNodePositionError;
|
|
|
|
/**
|
|
* @brief Domaine d'erreur du modèle GraphNodePosition.
|
|
*/
|
|
#define GRAPH_NODE_POSITION_ERROR \
|
|
graph_node_position_error_quark()
|
|
|
|
/**
|
|
* @brief Retourne le domaine d'erreur du modèle.
|
|
*/
|
|
GQuark graph_node_position_error_quark(void);
|
|
|
|
/**
|
|
* @brief Crée une position persistée de nœud.
|
|
*
|
|
* Toutes les chaînes sont copiées.
|
|
*
|
|
* node_identifier doit être un UUID valide.
|
|
* x et y doivent être des nombres finis.
|
|
* updated_at doit respecter le format UTC YYYY-MM-DDTHH:MM:SSZ.
|
|
*
|
|
* @param node_identifier UUID du nœud (entité ou relation).
|
|
* @param x Coordonnée horizontale logique.
|
|
* @param y Coordonnée verticale logique.
|
|
* @param updated_at Date UTC de dernière modification.
|
|
* @param error Emplacement facultatif recevant une erreur.
|
|
*
|
|
* @return Nouvelle position, ou NULL lorsque les données sont invalides.
|
|
*/
|
|
GraphNodePosition *graph_node_position_new(
|
|
const char *node_identifier,
|
|
double x,
|
|
double y,
|
|
const char *updated_at,
|
|
GError **error
|
|
);
|
|
|
|
/**
|
|
* @brief Libère une position.
|
|
*
|
|
* Cette fonction accepte NULL.
|
|
*
|
|
* @param position Position à libérer.
|
|
*/
|
|
void graph_node_position_free(
|
|
GraphNodePosition *position
|
|
);
|
|
|
|
/**
|
|
* @brief Retourne l'UUID du nœud (entité ou relation).
|
|
*
|
|
* La chaîne retournée appartient au modèle.
|
|
*
|
|
* @param position Position à consulter.
|
|
*
|
|
* @return UUID emprunté, ou NULL.
|
|
*/
|
|
const char *graph_node_position_get_node_identifier(
|
|
const GraphNodePosition *position
|
|
);
|
|
|
|
/**
|
|
* @brief Retourne la coordonnée horizontale.
|
|
*
|
|
* @param position Position à consulter.
|
|
*
|
|
* @return Coordonnée horizontale, ou 0.0 si position est NULL.
|
|
*/
|
|
double graph_node_position_get_x(
|
|
const GraphNodePosition *position
|
|
);
|
|
|
|
/**
|
|
* @brief Retourne la coordonnée verticale.
|
|
*
|
|
* @param position Position à consulter.
|
|
*
|
|
* @return Coordonnée verticale, ou 0.0 si position est NULL.
|
|
*/
|
|
double graph_node_position_get_y(
|
|
const GraphNodePosition *position
|
|
);
|
|
|
|
/**
|
|
* @brief Retourne la date UTC de dernière modification.
|
|
*
|
|
* La chaîne retournée appartient au modèle.
|
|
*
|
|
* @param position Position à consulter.
|
|
*
|
|
* @return Date empruntée, ou NULL.
|
|
*/
|
|
const char *graph_node_position_get_updated_at(
|
|
const GraphNodePosition *position
|
|
);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif
|