Aller au contenu

Dessin : SVG-Line et SVG LineBox ​

Les guides complets sont disponibles sur des pages dédiées : SVG-Line – Lignes de connexion et animation et SVG LineBox – Collecte et transmission de valeurs · SVG LineBox Math. La page consacrée à la LineBox intègre également des vidéos pour l'éditeur et l'environnement d'exécution (runtime). Cette vue d'ensemble est conservée pour assurer la pérennité des liens existants.

Le widget de ligne est disponible dans la palette sous HA Grafik – Spezial → SVG-Line. Il permet, par exemple, de relier visuellement deux panneaux solaires à un onduleur ou de regrouper plusieurs flux en un point de convergence. Pour l'animation, SVG-Line peut lire une entité Home Assistant ; quant à la SVG LineBox, elle permet d'additionner les valeurs numériques issues de plusieurs lignes et de les transmettre à une ligne de sortie.

Dessiner une connexion ​

  1. Insérez un élément SVG-Line (ligne SVG) et sélectionnez-le. Ses deux extrémités apparaissent sous forme de cercles déplaçables. Faites glisser une extrémité libre vers un point d'ancrage situé sur un autre widget. Vous pouvez également, via les options Début et Fin, sélectionner un widget ainsi qu'un point d'ancrage spécifique, ou saisir manuellement des coordonnées X/Y.
  2. Activez le groupe de propriétés Points d'ancrage sur le widget cible. Pour les nouveaux widgets, les douze positions sont désactivées par défaut. L'option Tous les points permet de les activer ou de les désactiver simultanément ; si seule une partie des points est sélectionnée, un état mixte s'affiche. Les points peuvent aussi être activés individuellement : à gauche et à droite (en haut, au milieu, en bas) ; en haut et en bas (à 1/4, au milieu et à 3/4 de la largeur). La case à cocher située dans l'en-tête du groupe permet d'activer ou de désactiver l'ensemble de la zone. Il est possible de configurer l'affectation multiple, le nombre maximal de connexions, l'espacement des lignes ainsi que l'affichage permanent.
  3. Choisissez le type de tracé : droit, à angles droits automatiques, courbe, ou tracé manuel en zigzag/à points multiples. Un clic sur la ligne fait apparaître, en son centre, la boîte de dialogue Point intermédiaire ou Point de regroupement ; « Point intermédiaire » est sélectionné par défaut. Après validation par OK, un point intermédiaire déplaçable est créé et le tracé passe en mode manuel à points multiples. Ces points peuvent également être nommés et positionnés via des coordonnées X/Y dans l'éditeur de propriétés.

Un point de regroupement activé peut servir de point de départ ou d'arrivée pour une autre ligne. Vous pouvez également faire glisser une extrémité de ligne libre vers un point de regroupement visible : elle s'y fixera, mémorisant ainsi la connexion. Le simple croisement de lignes ou leur proximité spatiale ne suffit jamais à établir une connexion. Si vous désactivez le point de regroupement, aucune nouvelle ligne ne s'y rattachera. Plusieurs lignes peuvent aboutir à un point de regroupement activé. Pour les lignes qui, jusqu'à présent, ne faisaient qu'effleurer visuellement le point, vous devez procéder à un nouveau raccordement.

Apparence et flux ​

  • Ligne : Couleur de base, seconde couleur d'animation, épaisseur, opacité, style (continu/pointillés/tirets), longueur des traits et des espaces, extrémités des lignes et rayon des angles.
  • Pointes de flèche : Définies séparément pour le début et la fin ; choix parmi : aucune, flèche pleine, flèche évidée ou cercle. La taille et la couleur sont réglables.
  • Animation : Flux bicolore, traits en mouvement, effet de pulsation ou point lumineux. Sous Source de direction, une seule option peut être active : Manuel (avec définition de la direction et de la durée), Entité numérique ou Entité booléenne. Pour une entité numérique, une valeur positive indique un mouvement du début vers la fin, une valeur négative de la fin vers le début, et zéro signifie l'arrêt. La valeur absolue divisée par le Diviseur (par défaut : 1) détermine le nombre de cycles par seconde (plage autorisée : 0,05 à 20). Exemple : 1000 W ÷ 100 = 10 cycles/s. L'entité booléenne permet de définir le sens : on/true/1 pour le sens direct, et off/false/0 pour le sens inverse ; cette attribution peut être inversée. Si l'état est indisponible ou invalide, l'animation s'arrête. Les pointes de flèche suivent la direction active. Le moteur d'exécution (runtime) interroge régulièrement l'entité HA sélectionnée. Grâce à l'option Reprendre le rythme d'animation de la ligne principale, une ligne secondaire suit le rythme de sa ligne principale tout en conservant ses propres couleurs durant l'animation. Si elle est raccordée à un point de jonction de la ligne principale et que cette dernière n'est pas animée, la ligne secondaire s'arrête également et affiche la couleur de base de la ligne principale, pointes de flèche incluses. Vos paramètres de couleur et d'animation personnalisés restent enregistrés et redeviennent actifs après la dissociation. La synchronisation permet d'obtenir une cadence identique ou une arrivée simultanée au point de convergence. En cas de définition manuelle d'une direction vers un point de convergence, l'animation s'oriente automatiquement vers ce point.
  • Croisements et empilement : Superposition, espace visuel ou pont/arche, ainsi qu'un mode « z-index » (ordre d'empilement) réglable sur « automatique », « au-dessus », « en-dessous » ou manuellement. Un z-index plus élevé place l'élément visuellement devant un élément ayant un z-index plus faible ; cela ne crée aucune connexion.

Modification ​

ActionManipulation
Déplacer un point d'extrémité libreFaire glisser le cercle ou déplacer le cercle sélectionné à l'aide des touches fléchées ; Umschalt permet de faire passer le pas de déplacement de 1 à 10 pixels.
Détacher un point d'extrémitéMaintenir Strg enfoncé tout en faisant glisser le cercle ; l'utilisation de Strg combinée à une touche fléchée est également possible.
Déplacer un point intermédiaireSélectionner la ligne et faire glisser le point.
Déplacer la ligne entièreCliquer sur la ligne et la faire glisser. Les points d'ancrage de départ ou d'arrivée existants seront alors supprimés.
Ajouter un point sur la ligneCliquer sur la ligne (sans faire glisser), choisir le type de point et confirmer avec OK.

Ce widget est en phase expérimentale. L'affichage des croisements et des animations synchronisées peut encore faire l'objet d'améliorations, en fonction du tracé du chemin et du navigateur utilisé.

SVG LineBox en tant que répartiteur invisible ​

L'éditeur met régulièrement à jour les états des entités numériques et booléennes sélectionnées. Cela permet de vérifier les animations de lignes SVG ainsi que la valeur calculée de la SVG LineBox avant même de passer en mode exécution (Runtime).

L'élément HA Grafik – Spezial → SVG LineBox est visible et déplaçable dans l'éditeur. En mode exécution, son cadre reste invisible ; les lignes qui y sont raccordées se rejoignent en son centre. À cet endroit, un cercle est placé par défaut au-dessus des extrémités des lignes, masquant ainsi leur terminaison anguleuse. Dans la section Point de connexion (Verbindungspunkt), vous pouvez masquer ce cercle, mais aussi définir son diamètre, sa couleur de remplissage, la couleur de son contour et l'épaisseur de ce dernier. Si les lignes sont épaisses, le cercle s'agrandit automatiquement si nécessaire afin de continuer à masquer les extrémités. L'option Afficher la valeur de sortie (Ausgabewert anzeigen) propose les positions suivantes : Désactivé (par défaut), Au-dessus du cercle et En dessous du cercle. La valeur affichée correspond à la somme signée des entrées et se met à jour en temps réel, y compris lors du déplacement d'un curseur (slider). La SVG LineBox dispose des douze points d'ancrage habituels, comme les autres widgets. Par défaut, ils sont tous désactivés ; activez uniquement ceux dont vous avez besoin dans la section Points d'ancrage (Andockpunkte). Sous Connexions (Anschlüsse), chaque point actif se voit alors attribuer un rôle : Entrée, Neutre ou Sortie. La « Neutre » est le réglage par défaut et n'intervient pas dans le calcul. Les points désactivés ne permettent pas de choisir un rôle. Dans l'éditeur, les différents points d'ancrage restent distincts ; les points définis sur « Neutre » ne sont pas reliés au point central commun.

Pour effectuer un test, reliez deux lignes SVG aux entrées de la SVG LineBox, et une troisième ligne SVG à une sortie. Pour les deux lignes d'entrée, sélectionnez Entité numérique (Zahlen-Entität) sous Animation → Source de direction (Richtungsquelle) et saisissez un identifiant d'entité (Entity ID) Home Assistant valide. Si les lignes d'entrée aboutissent à la « SVG LineBox », leurs valeurs signées sont additionnées. Exemple : 1000 et -300 donnent 700. Une ligne qui part de la « SVG LineBox » est prise en compte à l'entrée avec un signe inversé. Les états manquants ou invalides ne sont pas comptabilisés.

Réglez le point de départ sur Sortie et activez l'option Transmettre la valeur calculée (désactivée par défaut). Activez l'animation sur la ligne de sortie ; celle-ci utilisera alors le signe et la valeur absolue de la somme pour déterminer la direction et la vitesse. Le paramètre Diviseur SVG LineBox (lors de la transmission) permet de définir le rapport : avec 700 et un diviseur de 100, la ligne se déplace à une cadence de 7 cycles/s. Les couleurs, les pointes de flèche et le style de ligne d'origine sont conservés. Si la somme est 0 ou en l'absence d'entrée valide, l'animation s'arrête. Si vous désactivez la transmission au niveau de la sortie, la ligne reprendra ses propres paramètres d'animation.

Le calcul et la transmission s'effectuent normalement en interne. Via la rubrique Sortie vers entité auxiliaire (Helper), vous pouvez également écrire la somme dans une entité auxiliaire (input_number) afin de pouvoir l'utiliser ailleurs dans Home Assistant. La transmission interne reste active. L'écriture ne se produit que lorsque la valeur de la somme change ; pour éviter toute boucle de rétroaction, il est impossible d'utiliser comme entité auxiliaire une entité qui sert simultanément de source d'entrée pour la même SVG LineBox. La plage de valeurs de l'entité auxiliaire doit être compatible avec les valeurs que peut prendre la somme.

La première version utilise des entités de type « nombre » (number entities) sur les lignes d'entrée. Il n'existe pas encore de contrôle d'entité spécifique pour chaque connexion de la SVG LineBox.

L'ancien nom « Linebox » reste disponible en tant que terme de recherche dans la palette. Les projets enregistrés continuent d'utiliser le type de widget technique linebox ; les noms personnalisés attribués aux widgets ne sont pas modifiés.