📝

Text Note

Layout
运行在线示例 免费 · 无需注册 · 直接在浏览器中运行

TextNote(文本注释)模块在画布上提供无边框或带样式的富文本排版注释,用于对系统框图模型、数学物理方程、操作指南及子系统架构进行图文说明。该模块没有信号输入和输出端口,不会为仿真求解引擎增加任何计算负荷。它集成了数学公式渲染引擎(在单个美元符号 公式公式 之间书写 LaTeX/KaTeX 数学公式)、自动或手动图块尺寸调节、可配置的文字排版与颜色调色板,并支持与所锚定的信号连线进行动态颜色同步。

数学模型

该模块作为画布上的静态视觉排版组件工作。输入的文本字符串 SS 与排版样式属性直接渲染至画布文档对象模型(DOM)中,对数值解算器状态不产生任何影响:

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

包含在单美元符号之间的文本被解析并通过 KaTeX 排版引擎高质量呈现:

$公式$  ⟹  KaTeX(公式)\$ \text{公式} \$ \implies \text{KaTeX}(\text{公式})

当 textColor = "signal" 且该注释卡片吸附锚定至某条信号连线时,文本颜色会自动继承该信号线的笔画颜色:

colortext={colorwire,textColor="signal"∧已锚定colorpalette,其他\text{color}_{\text{text}} = \begin{cases} \text{color}_{\text{wire}}, & \text{textColor} = \text{"signal"} \land \text{已锚定} \\ \text{color}_{\text{palette}}, & \text{其他} \end{cases}

参数

参数 Label 类型 默认值 描述
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

使用示例

示例 1: 在框图上方标注受控对象的微分方程

在质量-弹簧-阻尼系统框图上方放置一个 TextNote 模块,直接标注底层的二阶牛顿-欧拉动力学方程。输入 userNotes = "牛顿-欧拉动量平衡方程:\nmx¨+cx˙+kx=F(t)m \ddot{x} + c \dot{x} + k x = F(t)",即可在画布上渲染出印刷级的 KaTeX 优雅公式,方便教学讲解与工程协同。

示例 2: 绑定信号线颜色的关键电平越限警告提示

对电动机电枢供电导线进行标注。配置 userNotes = "电机电枢极限工作电压: ±24V"、textColor = "signal"、fillColor = "yellow" 以及 border = "solid"。将注释框锚定在电机驱动线上,文字将自动同步导线颜色,而醒目的黄色背景可清晰提示电气安全限值。

说明与最佳实践

  • KaTeX 数学公式原生排版: 在单美元符号内(例如 Jω˙=τJ \dot{\omega} = \tau)编写的公式可直接由内置 KaTeX 引擎快速排版,无需外部插件。
  • 信号线颜色同步: 设置 textColor = "signal" 可让文本颜色与所吸附的信号连线完美保持一致,在复杂多分支拓扑中极大提升可读性。
  • 零仿真运算开销: 在拓扑排序和数值积分计算时被直接忽略,不占用 CPU 解算周期与内存开销。
  • 支持多行文本换行: 支持标准换行符并具备自适应自动折行能力。

相关模块

  • Area: 区域模块,使用半透明彩色矩形背景分组包裹功能子系统。
  • Subsystem: 子系统模块,将复杂的框图拓扑封装为可复用的组件。
  • NumericDisplay: 实时标量数字读数显示表。
  • Scope: 多通道时域动态波形示波器。