3 Ускоряемся с библиотеками построений

Достаточно часто нам приходится использовать одну и ту же последовательность действий, например поиск середины отрезка, многократно как в разных фигурах, так и внутри одной. Если такая последовательность действий ещё и продолжительная, а промежуточные шаги не представляют интереса, то они могут серьёзно загромождать чертёж. Для упрощения работы пакет MoebInv и его графическая оболочка предлагает удобное средство—библиотекb построений. В терминах языков программирования построения соответствуют макросам или процедурам. В оболочке Yaglom есть все средства для работы и управления с библиотеками построений.

Пример работы с библиотеками построениями показан здесь: Прямая Симпсона и библиотеки построений: (или на YouTube).

3.1 Как пройти в библиотеку?

Во время работы с оболочкой можно использовать построения из двух библиотек:

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

Любое построение из фигуры может быть добавлено в текущую загружаемую библиотеку. Для этого щелчком ПКМ на требуемом построении из фигуры вызовите его контекстное меню и выберите Добавить в библиотеку ⊕. Другие операции над библиотеками описаны в последующих секциях.

3.2 Использование построений

Что бы использовать любое доступное в данный момент построение вызовите его контекстное меню щелчком ПКМ и выберите Использовать построение ⚙. В появившемся диалоге будет дано описание этого построения и назначение требуемых параметров в определённом порядке.

В окошке под описанием надо указать метки циклов (разделённые запятыми) из текущей фигуры, которые будут применены в качестве параметров этого построения. циклы созданные в построении могут быть отнесены к определённому поколению, как обсуждалось ранее, см. 3.
Совет: Выбранное построение может быть одновременно использовано для нескольких наборов параметров с использованием фигурных скобок. Вот несколько примеров для построения серединной точки:

• Задав два цикла A,B построит серединную точку на отрезке AB.
• Ввод строки {A,B},C произведёт две серединные точки отрезков AC и BC.
• Параметры {A,B},{C,D} зададут четыре серединные точки отрезков AC, BC, AD и BD .

3.3 Как создать построение?

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

1. В построении должно быть некоторое число циклов без предков, которые рассматриваются как параметры. Эти циклы должны именоваться как variable000, variable001, …. Важно:
   1. По крайней мере цикл с меткой variable000 должен присутствовать в каждом построении.
   2. Если построению требуется n+1 параметр, то они должны именоваться последовательными метками variable000, variable001, …, variable00n без пробелов.
   3. Метка параметра должна иметь в точности три десятичных цифры начиная с необходимого числа нулей. Таким образом построение не может иметь более 1000 параметров.
   4. В построении используемые циклы будут подставляться на место циклов без предков с метками variable000, variable001, …в порядка возрастания номеров. Число задаваемых циклов не должно превышать доступного числа параметров.
   5. Если число заданных циклов менее числа параметров, то незаполненные переменные сохранят те значения, которые были им присвоены при создании построения.
2. Результатом построения являются все циклы без наследников в поколении-1 или после. Другими все циклы, которые
   • имеют предков и
   • не являются промежуточным итогом,
   будут считаться результатом построения.
3. Только циклы, являющиеся результатом построения будут явно добавлены в объемлющую фигуру.
4. Построение должно иметь ясное описание. Описание может быть добавлено в подменю Изменить→Свойства. Напоминание об описании также будет дано при попытке добавить построение в библиотеку. В описании должно быть две части:
   1. Краткий (<80 символов) чёткий заголовок оканчивающийся точкой и переводом строки. Этот заголовок будет использован для представления построения в библиотечном списке.
   2. Оставшаяся часть описания должна ясно описывать
      • суть построения;
      • число и порядок параметров, а так же значения по умолчанию необязательных параметров;
      • результат построения.

Совет: так как параметры построения должны иметь вполне определённые вид меток, то они должны быть или заданны вручную или соответствующими настройками автоматического наименования. Второе будет для вас сделано при использовании Построения→ Новое построение меню. Все метки в построении, кроме параметров, могут быть произвольными.

3.4 Добавление фигуры в библиотеку построений

Если фигура выполнена с соблюдением правил из предыдущей подсекции вы можете:

1. Сохранить её как обычную фигуру в отдельной записи через подменю Запись→Сохранить фигуру как.
2. Дописать в конец текущей загруженной библиотеки через подменю Построения→Добавить к библиотеке. Впоследствии позиция внутри библиотеки может быть изменена.
3. Вставить в произвольное место используемой библиотеки через её контекстное меню: вызвав это меню ПКМ на некотором построении из библиотеки выбрать строку Добавить фигуру перед этой.

При добавление построения пакет Yaglom проведёт некоторые проверки на соответствие правилам построений из предыдущего подраздела. Если необходимо дополнительные диалоги и сообщения будут выведены на экран.

Так же можно объединить текущую и ранее сохранённую (см. пункт 1 в § 3.6) библиотеки, это делается через подменю Построения→ Добавить запись к текущей библиотеке.

3.5 Редактирование текущей библиотеки

Контекстное меню текущей библиотеки (вызывается ПКМ) позволяет использовать любое из построений (см. § 3.2) или изменить библиотеку следующими действиями:

1. Переупорядочить список библиотеки, перемещая за один раз построение вниз или вверх по списку.
2. Изменить какое-либо построение загрузив его для редактирования в оболочку. Изменённое построение может быть добавлено в текущую библиотеку или сохранено в записи (которая впоследствии может быть добавлена в другую библиотеку).
3. Удалить выбранное построение из библиотеки.
   Внимание: эту операцию нельзя будет откатить и построение будет потеряно навсегда если библиотека не была сохранена. Вы можете предпочесть вначале сохранить удаляемую фигуру.
4. Добавить текущую фигуру (если она удовлетворяет всем требованиям из § 3.3) как построение, см. § 3.4.

3.6 Управление библиотеками

Следующие операции доступны из главного меню Построения для управления библиотеками:

1. Сохранить текущую библиотеку в отдельную запись.
2. Загрузить другую библиотеку с носителя.
3. Добавить запись какой-либо библиотеки с носителя к уже загруженной библиотеки. Объединение можно повторять неоднократно. Объединённая библиотека может быть сохранена в новой записи.
4. Сохранить и сделать по умолчанию: сохранённая библиотека будет автоматически загружаться при последующих запусках оболочки Yaglom. Библиотека по умолчанию может быть так же задана в подменю Инструменты→Настройки→Оболочка.

Комбинация действий из §§ 3.5–3.6 позволяет создавать неограниченное количество библиотек заточенных под конкретные задачи.