SuperAPI AI 工具集

simulink-create-block-icon

编程与开发

查看项目

更新于 11-05 00:01

技能介绍

用途 该技能用于以编程方式创建、设计并注册 Simulink 模块图标。它采用 MathWorks 推荐的方式:将 DVG 格式的 SVG 注册到模块上(而不是 MaskDisplay 绘图),从而保持图标可在 IconEditor 中编辑。

主要能力

  • 为模块生成 SVG 图标,包括 masked、普通以及 Simscape 组件模块。
  • 添加动态图标行为:可见性条件、实时表达式或参数文本、LaTeX 公式、相对定位、First Fit 尺寸适配。
  • 绘制端口标签并锚定到模块图标上。
  • 将已有的图标 SVG 注册到模块,或在 IconEditor 中打开模块图标。
  • 提供一整套脚本函数(均需 Simulink R2026a 或更高版本):inspect_block(读取模块的 mask 参数、端口、尺寸、现有图标、Simscape 信息)、svg_to_dvg(把普通 SVG 转换为 DVG 就绪骨架)、dvg_set(设置动态属性)、dvg_add_part(附加部件或 First Fit 层级)、dvg_add_equation(添加 LaTeX 公式元素)、dvg_validate(注册前校验)、register_icon(注册图标并验证渲染)、open_in_iconeditor(在 IconEditor 中打开)。

使用方式 流程分为多个阶段:先收集需求,确认目标模块路径和视觉描述;目标模块必须位于已打开的模型中,并且需要先运行 inspect_block 来获取画布尺寸、mask 参数、端口等信息;再给出结构化图标计划并等待确认;随后生成扁平 SVG,经 svg_to_dvg 转换,再用 dvg_set、dvg_add_equation、dvg_add_part 添加动态行为;接着用 dvg_validate 校验;最后通过 register_icon 选择存储模式注册:file(外部文件,所在目录需在 MATLAB 路径上)、model(随模型保存)、simscape(保存在组件文件旁)。如需手动微调,可调用 open_in_iconeditor。

适用场景 需要为 Simulink 模块制作图形化图标、根据参数显示不同状态、在图标上显示表达式或公式、标注端口标签,以及把现有 SVG 图标接入模块等场景。

限制 该技能不适用于编辑模型结构、参数、端口或连接(如增删模块、连线、修改模块参数、Stateflow 内部),也不适用于为模型构建注册或配置 .slx 模块库。所需前置信息缺失时(如端口尚不存在),需先说明超出范围。运行依赖 Simulink R2026a 或更高版本。