Инструменты пользователя

Инструменты сайта


developers:references:tlc:load:start

Загрузка TLC в проект


Раздел на модерации

Подготовьте редактор VS Code и создайте в нём файл tlc-скрипта. (см. раздел "Создание, редактирование и синтаксис TLC"). Опишите в нём компонент или просто скопируйте пример ниже:

my_construction.tlc
; Блок определение компонента
(defcomponent "My Custom Construction" "SmdxElement"
  ; Блок определения геометрии компонента
  (defgeometry
    ; Создание 3D-тела
    ; путём выдавливания профиля вдоль вектора
    (v-extrude
      ; Квадратный профиль шириной 1.0
      (v-profile-rect 1.0)
      ; Вектор выдавливания
      (vec 0 0 1)
    )
  )
)

Пример выше описывает очень простую конструкцию. В ней нет свойств, но определена её геометрия. На основании геометрии будет автоматически сгенерирован вид конструкции на плане. Если блока геометрии нет и не определён вид компонента сверху, то у модели не будет отображения на плане и выбрать её курсором будет невозможно.

Выбрать конструкцию, которая не имеет отображения на плане можно через команду «Сервис» → «Быстрый выбор…»

Теперь необходимо загрузить эту конструкцию в проект. Для этого выберите пункт меню

«Задачи» → «Визуализация» → «Добавить 3D сборку»

В открывшемся диалоговом окне укажите tlc-скрипт вашей конструкции:

Далее программа предложит вам указать точку вставки конструкции. После указания точки на плане активной модели появится вставленная конструкция:

Важно! После вставки конструкции в проект, связь с исходным tlc-скриптом разрывается. Вставленная конструкция хранит в себе личную копию кода. Изменения в исходном tlc-скрипте не приведут к изменениям конструкции в проекте.

Чтобы изменить загруженную в проект конструкцию нажмите на кнопку редактирования кода TLC в окне свойств:

После нажатия на кнопку, откроется новое окно редактора VS Code, в котором будет открыт временный tlc-файл с кодом конструкции:

Внесите изменения в скрипт и сохраните файл. Все внесённые изменения сразу же загрузятся в конструкцию. Например изменим тип профиля конструкции на 8-ой строке на (v-profile-round 1.0), так чтобы код имел форму:

my_construction.tlc
; Блок определение компонента
(defcomponent "My Custom Construction" "SmdxElement"
  ; Блок определения геометрии компонента
  (defgeometry
    ; Создание 3D-тела
    ; путём выдавливания профиля вдоль вектора
    (v-extrude
      ; Цилиндрический профиль диаметром 1.0
      (v-profile-round 1.0)
      ; Вектор выдавливания
      (vec 0 0 1)
    )
  )
)

После сохранения файла скрипта, конструкция изменит свою геометрию:

После закрытия окна VS Code временный tlc-файл будет удалён.

Не забудьте сохранить ваш проект после внесения изменений в скрипт иначе изменения могут быть потеряны в случае аварийного закрытия программы.
Важно! Если в процессе написания скрипта вы допустили ошибку в синтаксисе и при сохранении в командной строке отобразился стек трассировки с похожим содержанием: Это означает, что работа менеджера транзакций текущей модели проекта нарушена и сохранение проекта не будет гарантировать сохранение текущей модели проекта, а следовательно, изменения внесённые в tlc-конструкцию не будут зафиксированы.

Изменение и сохранение tlc-скрипта по прежнему будут отображаться, но после закрытия проекта, все изменения с момента последнего сохранения будут утеряны.

Чтобы не потерять изменения, найдите и скопируйте временный файл tlc-скрипта. В окне редактора VS Code, нажмите правой кнопкой на файле скрипта и выберите пункт «Показать в проводнике»:

В открывшемся окне проводника вы увидите выделенный файл tlc-скрипта. Скопируйте его в другую директорию. Закройте проект и откройте снова. Повторите действия по загрузке скрипта описанные в начале статьи.

developers/references/tlc/load/start.txt · Последние изменения: 2023/06/08 17:45 — proxor