Engee 文档

恩吉用户图书馆

User libraries*user library 1 是扩展名为 .nglib 的文件,可包含任何 *Engee 区块。通过这些文件,您可以从 Engee 程序块库stateflow button library 中使用自己的程序块。

创建自己的库可以让您

  • 以方便的格式存储常用图块,大大简化和加快建模过程;

  • 直接从自定义库中添加所需元素,而无需为每个模型创建新的图块。

自定义库的优势在于其灵活性和可重用性。这些库有助于组件的标准化,确保各模型的统一性,减少出错的可能性。此外,自定义库还便于共享已开发的模块,从而提高团队工作效率并节省时间。

要下载其他用户的自定义库文件或上传自己的文件,请使用Engee Remote Repository。有关如何使用远程资源库的更多信息,请参阅Git 上的文章。
一旦你将区块添加到*Engee*库中,在会话激活时你将无法删除它们。要删除这些区块,需要完全停止*Engee*会话并重新启动。这将清除所有用户库,如果需要,则必须重新加载。

使用自定义库

  1. file browser iconFiles 窗口中创建 .nglib 库文件,并为其命名:

    user lib create

  2. Engee 模型中创建所需的块或子系统。子系统允许同时在其中存储多个程序块。因此,要将一组程序块添加到程序库中,可将它们组合成一个子系统。

    user lib custom blocks

  3. 在文件浏览器或导航栏中保存 .nglib 文件:

    user lib 2

    保存文件的目录不会影响文件在程序块库中的位置。
  4. 要使图块出现在 Engee 库窗口stateflow button library 中,请将 .nglib 文件移动到文件夹中,并使用路径编辑器 将其添加到路径中:

    path editor new

  5. 添加的文件将放在*用户库*部分,其中 .nglib 文件的名称将成为相应分节的名称:

    user lib save 1 1

  6. 也可通过搜索工作区访问之前创建或加载的用户库:

    user lib 4

分层图书馆

大型用户库通常需要嵌套结构—​例如,当你想将区块归类为类别和子类别时。为此,应在库文件夹中添加一个特殊的 engee_library.toml 文件,描述分层结构。该文件的示例如下

image3

[metadata]
format_version = "1"

[[categories]]
lib_path = "/my-lib_upd"
files = ["foo/a.nglib", "foo/b.nglib"]

[[categories]]
lib_path = "/my-lib_upd/cat1"
files = ["c.nglib"]

[[categories]]
lib_path = "/my-lib_upd/cat1/cat2"
files = ["d.nglib"]

在这个例子中

  • format_version = "1" - 文件格式版本。

  • lib_path - 库部分的路径,将显示在 Engee 块库窗口stateflow button library 中。

  • files - 将加载到此部分的 .nglib 文件列表。

    这些文件可以自由放置在不同的子目录中 - 重要的是应正确指定 files 中的路径。

因此,您可以

  • 将区块归入文件夹和子目录(例如,cat1`和`cat2);

  • 将多个文件加载到一个部分;

  • 按主题、区块类型等明确划分大型图书馆的结构。

创建 engee_library.toml 并将所需的 .nglib 文件放入指定文件夹后,通过路径编辑器 将根库文件夹添加到 Path 中,您的层次结构就会出现在块库窗口中。