Редактирование: Работа со структурными объектами

[[Category:Макро]]
Данные команды не создают геометрических объектов, а служат для добавления, извлечения, развала структурных объектов, представляющих собой совокупность одного или нескольких структурных или геометрических объектов, то есть группу.

==Группировка объектов==
<code>'''[#var] group''''' &lt;Objects&gt;''</code>

Команда '''group''' создаёт группу из объектов <code>''&lt;Objects&gt;''</code>.

Если задана '''#var''', то переменной '''var''' присвоится ссылка на созданную группу.

ЛСК созданной группы будет расположена в ПСК.

==Добавление объектов в группу==
<code>'''add''''' ''<nowiki>[</nowiki>partly] ''&lt;Object&gt; &lt;Objects&gt;''</code>

Команда '''add''' добавляет объекты <code>''&lt;Objects&gt;''</code> в группу'' <code>&lt;Object&gt;''</code>.

==Извлечение объектов из группы==
<code>'''extract''''' ''<nowiki>[partly] </nowiki>''&lt;Object&gt; &lt;Objects&gt;''</code>

Команда '''extract''' извлекает объекты <code>''&lt;Objects&gt;''</code> из группы <code>''&lt;Object&gt;''</code>.

==Удаление объекта в группе==
<code>'''delobjing''''' &lt;Object&gt;''</code>

Команда '''delobjing''' удаляет объект <code>''&lt;Object&gt;''</code> из группы, в которую он входит.

==Замена объекта в группе==
<code>'''replobjing''''' &lt;Object1&gt; &lt;Object2&gt;''</code>

Команда '''replobjing''' заменяет объект <code>''&lt;Object1&gt;''</code>, находящийся внутри группы на объект <code>''&lt;Object2&gt;''</code>. Объекты <code>''&lt;Object1&gt;</code> ''и <code>''&lt;Object2&gt;''</code> должны быть структурными объектами типа "'''контур'''" или "'''группа'''".

==Создание контура==
Команда '''path''' имеет несколько режимов работы, представленных ниже.

<code>'''path''' ''&lt;Object&gt;'' create|dublicate</code>

Команда создаёт контур из '''отрезков''', '''дуг''' '''окружностей''', '''сплайнов'''. Объект <code>''&lt;Object&gt;''</code> задаёт начальный объект контура. Объекты в контур включаются при выполнении следующих условий: объект является объектом нужного типа ('''отрезок''', '''дуга''' '''окружности''', '''сплайн''') и начальная точка каждого последующего объекта совпадает с конечной точкой предыдущего объекта, начиная с объекта <code>''&lt;Object&gt;''</code>. В макропрограммах использовать такой способ создания контуров не рекомендуется, поскольку возможна неоднозначность, пример которой представлен на рисунке. В интерактивном режиме '''K3''' выдаст соответствующий запрос о  том, что нужно выбрать продолжаемый объект, а в макропрограмме такое невозможно.

[[Файл:Path-ambigueco.png|800px|thumb|center|<code>path ''<Object>''</code>. Какой из объектов включать в контур — отрезок или дугу?]]

Ключ <code>create</code> создаёт контур из указанных объектов. При этом сами объекты удаляются. 

Ключ <code>dublicate</code> создаёт контур из указанных объектов. При этом сами объекты не удаляются.


<code>'''path''' select ''&lt;Objects&gt; &lt;Object&gt; ''create|dublicate</code>

Команда создаёт контур из '''отрезков''', '''дуг окружностей''', '''сплайнов'''. Объект <code>''&lt;Object&gt;''</code> задаёт начальный объект контура. Объекты в контур включаются при выполнении следующих условий: объект является объектом нужного типа ('''отрезок''', '''дуга окружности''', '''сплайн'''), входит в число выбранных объектов <code>''&lt;Objects&gt;''</code> и начальная точка каждого последующего объекта совпадает с конечной точкой предыдущего объекта, начиная с объекта <code>''&lt;Object&gt;''</code>. 

Ключ <code>create</code> создаёт контур из указанных объектов. При этом сами объекты удаляются. 

Ключ <code>dublicate</code> создаёт контур из указанных объектов. При этом сами объекты не удаляются.


<code>'''path '''polyline ''&lt;Object&gt;''</code>

Команда создает контур на основе полилинии <code>''&lt;Object&gt;''</code>. Исходная полилиния удаляется.

==Создание блока==
<code>'''block''''' &lt;Objects&gt; &lt;Point&gt; &lt;Name&gt;''</code>

Команда '''block''' создаёт объект типа '''«Блок»''' с именем <code>''&lt;Name&gt;''</code> из объектов <code>''&lt;Objects&gt;''</code> и базовой точкой <code>''&lt;Point&gt;''</code>.

==Вставка блока в сцену==
<code>'''insert''' &lt;Name&gt;''<nowiki> [other</nowiki>'' &lt;Name1&gt;'']'' &lt;Point1&gt;, …,''<nowiki> [other</nowiki>'' &lt;NameN&gt;'']'' &lt;PointN&gt; ''done</code>

Команда '''insert''' вставляет объект типа '''«Блок»''' с именем <code>''&lt;Name&gt;''</code> в точки с координатами <code>''&lt;Point1&gt;</code>, …, <code>&lt;PointN&gt;''</code>. Ключ <code>other</code> позволяет указать другое имя блока для вставки.

==Создание набора==
<code>'''frame''''' &lt;Objects&gt;''</code>

Команда '''frame''' создаёт набор (каркас) из линейных объектов <code>''&lt;Objects&gt;''</code>.

==Развал структурных объектов==
<code>'''explode''''' &lt;Objects&gt;''</code>

Команда '''explode''' разваливает структурные объекты <code>''&lt;Objects&gt;''</code>.

Однако, в системе присутствуют объекты, которые не разваливаются при помощи команды '''explode'''.

В частности, в системе '''Мебель''' это:

*    Мебельная панель
*    Мебельный профиль
*    Мебельный каркас
*    Мебельная комната
*    Комплектующий
*    Линейка свободного крепежа
*    Длинномер
*    Линейка свободного отверстия

==Поиск объекта в группе - GetObjHold, FindObjHoldG==

<code>logical '''GetObjHold'''(object ''&lt;Obj&gt;'', varname ''&lt;Hold&gt;'')</code>

Функция присваивает переменной <code>''&lt;Hold&gt;''</code> ссылку на родителя объекта <code>''&lt;Obj&gt;''</code>. Функция возвращает:

:'''1'''     – присвоение прошло успешно
:'''0'''     – ошибка (объект не имеет родителя и пр.)


<code>Logical '''FindObjHoldG'''(object ''&lt;Group&gt;'', object ''&lt;Obj&gt;''<nowiki>[, varname </nowiki>''&lt;Hold&gt;''])</code>

Функция проверяет, находится ли объект <code>''&lt;Obj&gt;''</code> в группе <code>''&lt;Group&gt;''</code> на любом уровне. Если задан необязательный параметр <code>''&lt;Hold&gt;''</code>, то ему присваивается ссылка на непосредственного родителя объекта <code>''&lt;Obj&gt;''</code>. Функция возвращает:

:'''1     '''– объект <code>''&lt;Obj&gt;''</code> находится в составе группы <code>''&lt;Group&gt;''</code>.
:'''0     '''– объект <code>''&lt;Obj&gt;''</code> не находится в составе группы <code>''&lt;Group&gt;''</code>.

==Подсчет количества и заполнение массива объектами==
===GetCntObjG===

<code>INT '''GetCntObjG'''(OBJECT ''&lt;Obj&gt;'')</code>

Функция возвращает количество объектов первого уровня, входящих в структурный объект <code>''&lt;Obj&gt;''</code>. Если объект <code>''&lt;Obj&gt;''</code> не является структурным объектом, функция возвращает ноль.

Пример:
 #obj1 circle 0,0,0 100;
 #obj2 circle 0,0,100 100;
 =GetCntObjG(obj1);
 <font color="008800">0</font>
 #obj3 group obj1,obj2 done;
 =GetCntObjG(obj3);
 <font color="008800">2</font>
 #obj4 circle 0,0,200 100;
 #obj5 group obj3,obj4 done;
 =GetCntObjG(obj5);
 <font color="008800">2</font>

===GetArrObjG, GetCntObjS, GetArrObjS, GetCntObjA===
<code>INT '''GetArrObjG'''(OBJECT ''&lt;Obj&gt;'', varname ARRAY ''&lt;Arr&gt;'')</code>

Функция заполняет массив <code>''&lt;Arr&gt;''</code> ссылками на объекты первого уровня структурного объекта <code>''&lt;Obj&gt;''</code> и возвращает количество заполненных элементов массива.


<code>Int '''GetCntObjS'''()</code>

Функция возвращает количество объектов верхнего уровня в сцене. Данная функция полностью аналогична функции '''SysVar'''(<code>60</code>).


<code>Int '''GetArrObjS'''(varname array ''&lt;Arr&gt;'')</code>

Функция заполняет массив <code>''&lt;Arr&gt;''</code> ссылками на объекты верхнего уровня в сцене. Функция возвращает количество заполненных элементов массива. Массив предварительно должен быть описан. Если размерность массива меньше количества объектов, функция возвращает ноль.


<code>Int '''GetCntObjA'''()</code>

Функция возвращает количество листьев (объектов нижнего уровня) у всех объектов сцены.

Пример:
 #obj1 circle 0,0,0 100;
 #obj2 circle 0,0,100 100;
 =GetCntObjS();
 <font color="008800">2</font>
 #obj3 group obj1,obj2 done;
 =GetCntObjS();
 <font color="008800">1</font>
 =GetCntObjA();
 <font color="008800">2</font>
 =SysVar(60);
 <font color="008800">1</font>

===GetCntObjGA===
<code>INT '''GetCntObjGA'''(OBJECT ''&lt;Obj&gt;'')</code>

Функция возвращает количество листьев (объектов нижнего уровня) у объекта <code>''&lt;Obj&gt;''</code>. Если объект <code>''&lt;Obj&gt;''</code> не является структурным объектом, функция возвращает ноль.

===ScanScene, ScanAll, ScanG===
<code>Int '''ScanScene'''(varname array ''&lt;Arr&gt;''<nowiki>[, INTEGER &lt;</nowiki>''BegNum&gt;''])</code>

Функция заполняет массив <code>''&lt;Arr&gt;''</code> ссылками на все объекты всех уровней сцены. Вставки ('''Inserts''') считаются одним объектом. Функция возвращает количество заполненных элементов массива. Массив предварительно должен быть описан. Если размерность массива меньше количества объектов, функция заполняет доступные элементы массива. Если задан необязательный параметр <code>&lt;''BegNum&gt;''</code>, то в массив помещаются ссылки на объекты, начиная с номера <code>&lt;''BegNum&gt;''</code>.


<code>Int '''ScanAll'''(varname array ''&lt;Arr&gt;'')</code>

Функция заполняет массив <code>''&lt;Arr&gt;''</code> ссылками на все листья (объекты нижнего уровня) сцены. Вставки ('''Inserts''') считаются одним объектом. Функция возвращает количество заполненных элементов массива. Массив предварительно должен быть описан. Если размерность массива меньше количества объектов, функция возвращает ноль.


<code>Int '''ScanG'''(object ''&lt;Obj&gt;'', varname array ''&lt;Arr&gt;'')</code>

Функция заполняет массив <code>''&lt;Arr&gt;''</code> всеми листьями (объектами нижнего уровня) в структурном объекте <code>''&lt;Obj&gt;''</code>. Функция возвращает количество заполненных элементов массива. Если размерность массива меньше количества объектов, функция возвращает ноль.

Пример:
 #c1 circle 0,0,0 10;
 #c2 circle 0,0,100 20;
 defarr arr[100];
 =scang(c1,arr)&nbsp;;
 <font color="008800">0</font>
 #g1 group c1,c2 done;
 =scang(g1,arr);
 <font color="008800">2</font>
 #c3 ciircle 0,0,200 30;
 #g2 group g1,c3 done;
 =scang(g2,arr);
 <font color="008800">3</font>

===Scan_Scene===
<code>'''Scan_Scene''' ''&lt;Array&gt; &lt;Condition&gt;''</code>

Команда сканирует все объекты сцены, в том числе и невидимые, и заносит в массив <code>''&lt;Array&gt;''</code> ссылки на те, для которых заданное логическое выражение <code>''&lt;Condition&gt;''</code> истинно (выражение в качестве переменных использует имена атрибутов). 

В переменную <code>n</code> заносится количество заполненных элементов в массиве.

Если размерность массива меньше количества объектов, удовлетворяющих логическому выражению <code>''&lt;Condition&gt;''</code>, то оставшиеся объекты в массив не заносятся.
Пример:
 Defarr Array[100];
 #n Scan_Scene Array "UnitPos==1";

==Изменение цвета у объекта в группе==

<code>Logical '''ChObjColorG'''(object ''&lt;Obj&gt;'', int ''&lt;Color&gt;'')</code>

Функция изменяет цвет объекта <code>''&lt;Obj&gt;''</code> на цвет <code>''&lt;Color&gt;''</code> (целое число от 0 до 239). Функция возвращает:

:'''1'''     – успешное завершение функции
:'''0'''     – ошибка.