Aperçu
Information
- La modification des fonctions graphiques est une fonctionnalité avancée qui requiert la maîtrise de JavaScript. Le support eGauge ne peut pas vous aider à écrire ou à déboguer du code JavaScript.
Les fonctions graphiques permettent d'utiliser JavaScript pour calculer de nouvelles valeurs à partir des données enregistrées dans les registres de la configuration du compteur.
Prérequis
- Connaissance de JavaScript requise.
Instructions
Étape 1 : Accédez à l’« Éditeur de fonctions de graphique » en utilisant le menu hamburger en haut à gauche, puis choisissez « Graphique » > « Modifier les fonctions ».
Étape 2 : Cliquez sur une fonction graphique existante pour la modifier ou sur l’icône « Ajouter une fonction » pour en ajouter une nouvelle. Cliquez sur la croix (X) pour supprimer une fonction graphique existante.
Étape 3 : Cliquer sur « Ajouter une fonction » ou modifier une fonction existante ouvrira la fenêtre « Modifier la fonction ». Voici un exemple de fonction.
use , qui reçoit la valeur instantanée du registre virtuel « Usage » de l'eGauge (défini comme « $"Usage » ), et bat , qui reçoit la valeur instantanée du registre virtuel « Battery » (défini comme « $"Battery » ). « Usage » et « Battery » sont des valeurs de registre définies dans les paramètres d'installation de l'eGauge (lien) du compteur. Nom de la fonction (champ obligatoire) : Nom unique et arbitraire choisi par l’utilisateur. Ce nom est utilisé uniquement dans le graphique eGauge et ne doit pas nécessairement correspondre à un nom de fonction JavaScript valide. Dans l’exemple de script ci-dessus, le nom de la fonction est « use+charge ».
Renvoie une valeur cumulée : activez cette option pour renvoyer une valeur cumulée. Laissez-la désactivée pour renvoyer une valeur instantanée.
Unité de la valeur de retour (champ obligatoire) : sélectionne l’unité d’affichage de la valeur renvoyée par la fonction. Dans l’exemple de script ci-dessus, cette unité est définie sur Watts . Cette valeur doit être modifiée en fonction de l’unité de calcul utilisée par la fonction.
Arguments — Ce tableau définit la liste des valeurs à transmettre à la fonction. Seules les valeurs d’un registre peuvent être passées comme arguments. Les noms des arguments doivent être des identifiants JavaScript valides.
Corps du texte - Cette section définit les calculs à effectuer par la fonction.
Information
- Si un argument de fonction fait référence à un registre qui n'existe plus dans la configuration du compteur, sa valeur sera indéfinie. C'est pourquoi l'opérateur « ||0 » est utilisé dans le code ci-dessus : il garantit que si les registres virtuels d'utilisation ou de batterie sont indéfinis, la valeur 0 sera utilisée.
Le champ « Body » peut être le corps d'une fonction JavaScript quelconque et autorise les fonctions imbriquées.
function reg_or_zero(reg) {
return reg || 0;
}
return reg_or_zero(use);Documentation - Ce champ permet d'ajouter une description de la fonction.
Étape 4 : Cliquez sur « OK » pour enregistrer votre fonction graphique.
Étape 5 : Les fonctions graphiques enregistrées s’affichent dans la liste des valeurs à représenter après l’enregistrement des valeurs. Pour ajouter une fonction graphique enregistrée, ajoutez un nouvel élément de graphique et sélectionnez la fonction dans la liste déroulante « Valeur à représenter ». La fonction graphique se comportera comme n’importe quel autre élément de graphique.
