Text Note
Layout
运行在线示例
免费 · 无需注册 · 直接在浏览器中运行
TextNote(文本注释)模块在画布上提供无边框或带样式的富文本排版注释,用于对系统框图模型、数学物理方程、操作指南及子系统架构进行图文说明。该模块没有信号输入和输出端口,不会为仿真求解引擎增加任何计算负荷。它集成了数学公式渲染引擎(在单个美元符号 之间书写 LaTeX/KaTeX 数学公式)、自动或手动图块尺寸调节、可配置的文字排版与颜色调色板,并支持与所锚定的信号连线进行动态颜色同步。
数学模型
该模块作为画布上的静态视觉排版组件工作。输入的文本字符串 与排版样式属性直接渲染至画布文档对象模型(DOM)中,对数值解算器状态不产生任何影响:
包含在单美元符号之间的文本被解析并通过 KaTeX 排版引擎高质量呈现:
当 textColor = "signal" 且该注释卡片吸附锚定至某条信号连线时,文本颜色会自动继承该信号线的笔画颜色:
参数
| 参数 | 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 = "牛顿-欧拉动量平衡方程:\n",即可在画布上渲染出印刷级的 KaTeX 优雅公式,方便教学讲解与工程协同。
示例 2: 绑定信号线颜色的关键电平越限警告提示
对电动机电枢供电导线进行标注。配置 userNotes = "电机电枢极限工作电压: ±24V"、textColor = "signal"、fillColor = "yellow" 以及 border = "solid"。将注释框锚定在电机驱动线上,文字将自动同步导线颜色,而醒目的黄色背景可清晰提示电气安全限值。
说明与最佳实践
- KaTeX 数学公式原生排版: 在单美元符号内(例如
)编写的公式可直接由内置 KaTeX 引擎快速排版,无需外部插件。 - 信号线颜色同步: 设置
textColor = "signal"可让文本颜色与所吸附的信号连线完美保持一致,在复杂多分支拓扑中极大提升可读性。 - 零仿真运算开销: 在拓扑排序和数值积分计算时被直接忽略,不占用 CPU 解算周期与内存开销。
- 支持多行文本换行: 支持标准换行符并具备自适应自动折行能力。
相关模块
- Area: 区域模块,使用半透明彩色矩形背景分组包裹功能子系统。
- Subsystem: 子系统模块,将复杂的框图拓扑封装为可复用的组件。
- NumericDisplay: 实时标量数字读数显示表。
- Scope: 多通道时域动态波形示波器。