Пользовательские библиотеки Engee

Пользовательские библиотеки user library 1 — это файлы с расширением .nglib, которые могут содержать любые блоки Engee. Эти файлы позволяют использовать собственные блоки из библиотеки блоков Engee .

Создание собственных библиотек позволяет:

Хранить часто используемые блоки в удобном формате, чтобы значительно упростить и ускорить процесс моделирования;
Добавлять нужные элементы сразу из пользовательской библиотеки, вместо создания новых блоков для каждой модели.

Преимущества пользовательских библиотек заключаются в их гибкости и возможности повторного использования. Такие библиотеки помогают стандартизировать компоненты, обеспечивая единообразие в моделях и снижая вероятность ошибок. Кроме того, пользовательские библиотеки позволяют легко делиться разработанными блоками, что способствует более эффективной командной работе и экономии времени.

Чтобы скачать файлы пользовательских библиотек других пользователей или загрузить свои — воспользуйтесь сайтом удаленного репозитория Engee. Подробнее о том как работать с удаленным репозиторием читайте в наших статьях по Git.

После добавления своих блоков в библиотеку Engee, вы не сможете их удалить, пока сессия активна. Чтобы убрать эти блоки, нужно полностью остановить сессию Engee и запустить ее заново. Это очистит все пользовательские библиотеки, и если они понадобятся, их придется загрузить повторно.

Для работы с пользовательскими библиотеками:

Создайте файл библиотеки .nglib в окне файлового браузера и задайте желаемое имя:
Создайте нужный блок или подсистему в модели Engee. Подсистема позволяет сохранить внутри себя множество блоков одновременно. Поэтому, чтобы добавить в библиотеку группу блоков, объедините их в подсистему.
Сохраните файл .nglib в файловом браузере или навигационной панели:

Директория, в которой сохранен файл, не влияет на его расположение в библиотеке блоков.
Чтобы блоки появились в библиотеке блоков Engee , переместите файл .nglib в папку и добавьте ее в путь через редактор пути:
Добавленные файлы будут помещены в раздел Пользовательские библиотеки, где имя файла .nglib станет именем соответствующего подраздела:
К блокам ранее созданной или загруженной пользовательской библиотеки можно обратиться через поиск в рабочем пространстве также, как и для обычных блоков Engee:

Многоуровневые библиотеки

Большие пользовательские библиотеки часто требуют вложенной структуры — например, когда вы хотите разложить блоки по категориям и подкатегориям. Для этого в папку с библиотекой нужно добавить специальный файл engee_library.toml, в котором описывается структура иерархии. Пример такого файла:

image3 ru

[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 .
files — список .nglib файлов, которые будут загружены в этот раздел.

Файлы можно свободно размещать в разных подкаталогах — главное, чтобы пути в files были указаны корректно.

Таким образом, вы можете:

Сгруппировать блоки по папкам и подкатегориям (например, cat1 и cat2);
Загружать несколько файлов в один раздел;
Четко структурировать большие библиотеки по тематике, типу блоков и т.д.

После создания engee_library.toml и размещения нужных .nglib файлов в указанных папках, добавьте корневую папку библиотеки в путь через редактор пути, и ваша иерархия появится в библиотеке блоков.

Пользовательские библиотеки Engee

Многоуровневые библиотеки

Полезные ссылки