📝

Text Note

Layout
Ejecutar el ejemplo en vivo Gratis · sin registro · funciona en tu navegador

El bloque TextNote proporciona notas de texto enriquecido directamente sobre el lienzo para documentar diagramas de bloques, ecuaciones matemáticas, instrucciones de operación y arquitecturas de subsistemas. No posee entradas ni salidas de señal y no genera ninguna carga computacional sobre el motor de simulación. Cuenta con representación de fórmulas matemáticas integrada (código LaTeX/KaTeX entre signos de dólar foˊrmulafórmula), redimensionamiento automático o manual, tipografía y paletas de color configurables, así como sincronización dinámica de color con los cables de señal a los que se ancle.

Modelo Matemático

El bloque opera como un elemento estático de diseño visual. Las cadenas de texto SS y los atributos de estilo se renderizan directamente en el DOM del lienzo sin influir en los estados numéricos del resolvedor:

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

El texto delimitado por signos de dólar es procesado por el motor tipográfico KaTeX:

$foˊrmula$  ⟹  KaTeX(foˊrmula)\$ \text{fórmula} \$ \implies \text{KaTeX}(\text{fórmula})

Cuando textColor = "signal" y la nota está anclada a una conexión, el texto adquiere dinámicamente el color del cable:

colortext={colorwire,textColor="signal"∧ancladocolorpalette,en otro caso\text{color}_{\text{text}} = \begin{cases} \text{color}_{\text{wire}}, & \text{textColor} = \text{"signal"} \land \text{anclado} \\ \text{color}_{\text{palette}}, & \text{en otro caso} \end{cases}

Parámetros

Parámetros Label Tipo Por defecto Descripción
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

Ejemplos de Uso

Ejemplo 1: Documentación de ecuaciones diferenciales de un sistema físico

Colocación de un TextNote sobre un modelo de masa-resorte-amortiguador para exponer la ecuación de Newton-Euler subyacente. Escribiendo userNotes = "Equilibrio de Newton-Euler:\nmx¨+cx˙+kx=F(t)m \ddot{x} + c \dot{x} + k x = F(t)" se representa la ecuación con calidad de libro de texto sobre el lienzo.

Ejemplo 2: Aviso de límite operativo sincronizado con el cable de señal

Anotación sobre un conductor de tensión de armadura crítica. Configuración con userNotes = "Tensión máxima de armadura: ±24V", textColor = "signal", fillColor = "yellow" y border = "solid". El anclaje al cable del actuador sincroniza el color del texto con la señal, destacando el límite de seguridad mediante el fondo amarillo.

Observaciones y Buenas Prácticas

  • Tipografía matemática KaTeX: Las fórmulas entre signos de dólar (p. ej. Jω˙=τJ \dot{\omega} = \tau) se renderizan de forma limpia sin necesidad de módulos externos.
  • Sincronización con el cable: El ajuste textColor = "signal" proporciona claridad y coherencia visual en esquemas complejos con múltiples buses de señales.
  • Cero sobrecarga de simulación: Se ignora durante la ordenación topológica y la resolución numérica de ecuaciones diferenciales.
  • Párrafos multilínea: Permite saltos de línea con autoajuste de anchura.

Bloques Relacionados

  • Area: Delimita visualmente subsistemas funcionales con fondos de color degradados.
  • Subsystem: Encapsula topologías modulares complejas para su reutilización.
  • NumericDisplay: Indicador digital numérico en tiempo real.
  • Scope: Visualización gráfica de formas de onda.