📝

Text Note

Layout
Lancer l’exemple en direct Gratuit · sans inscription · dans votre navigateur

Le bloc TextNote permet d'insérer des annotations textuelles enrichies directement sur le canevas afin de documenter les schémas-blocs, les équations mathématiques, les consignes d'exploitation et les architectures de sous-systèmes. Dépourvu d'entrées et de sorties, il n'induit aucune charge de calcul pour le moteur de simulation. Il intègre le rendu de formules mathématiques (code LaTeX/KaTeX délimité par des symboles dollar formuleformule), le dimensionnement automatique ou manuel, une typographie et des palettes de couleurs configurables, ainsi qu'une synchronisation dynamique de couleur avec les fils de connexion auxquels il est rattaché.

Modèle Mathématique

Le bloc agit comme une annotation visuelle statique. Les chaînes de texte SS et leurs attributs de style sont directement injectés dans le DOM du schéma sans affecter l'état du solveur numérique :

DOMnote=render⁡(SuserNotes,stylevisual)\text{DOM}_{\text{note}} = \operatorname{render}(S_{\text{userNotes}}, \text{style}_{\text{visual}})

Les expressions délimitées par des symboles dollar sont analysées et composées par le moteur KaTeX :

$formule$  ⟹  KaTeX(formule)\$ \text{formule} \$ \implies \text{KaTeX}(\text{formule})

Lorsque textColor = "signal" et que la note est ancrée à une ligne de signal, la couleur du texte hérite automatiquement de la couleur du tracé :

colortext={colorwire,textColor="signal"∧ancreˊcolorpalette,sinon\text{color}_{\text{text}} = \begin{cases} \text{color}_{\text{wire}}, & \text{textColor} = \text{"signal"} \land \text{ancré} \\ \text{color}_{\text{palette}}, & \text{sinon} \end{cases}

Paramètres

Paramètres Label Type Défaut Description
userNotes Content text
autoSize Auto-size boolean true
fontSize Size select medium
textColor Text color select default Text colour. "Match signal" follows the anchored signal's colour.
fillColor Fill select none
border Border select accent
textAlign Align select left

Exemples d'Utilisation

Exemple 1 : Documentation des équations différentielles d'un procédé

Placement d'une TextNote au-dessus d'un modèle masse-ressort-amortisseur pour expliciter l'équilibre de Newton-Euler. Saisir userNotes = "Équilibre de Newton-Euler :\nmx¨+cx˙+kx=F(t)m \ddot{x} + c \dot{x} + k x = F(t)" affiche directement l'équation KaTeX de façon élégante sur le schéma.

Exemple 2 : Repère d'avertissement de tension asservi à la couleur du signal

Repérage d'une ligne d'alimentation moteur critique. Configuration avec userNotes = "Tension d'induit maximale : ±24V", textColor = "signal", fillColor = "yellow" et border = "solid". L'ancrage de la note au conducteur synchronise la couleur du texte avec le signal, tandis que le fond jaune signale le seuil électrique critique.

Remarques & Bonnes Pratiques

  • Composition mathématique KaTeX : Les équations insérées entre dollars (ex. Jω˙=τJ \dot{\omega} = \tau) sont compilées nativement par KaTeX sans plug-in externe.
  • Harmonie des couleurs de signaux : L'option textColor = "signal" garantit la lisibilité et l'harmonie des schémas denses à faisceaux multiples.
  • Zéro impact sur la simulation : Totalement ignoré lors du tri topologique et de l'intégration numérique ; aucune ressource CPU ou mémoire n'est consommée par le solveur.
  • Retours à la ligne et retours chariot : Supporte la mise en page multiligne avec retour automatique à la ligne.

Composants Associés

  • Area : Encadre visuellement des sous-systèmes fonctionnels au moyen d'une zone d'arrière-plan colorée.
  • Subsystem : Encapsule des schémas modulaires réutilisables.
  • NumericDisplay : Affichage numérique en temps réel.
  • Scope : Visualisation graphique des formes d'onde temporelles.