Редактирование: Слои

[[Категория:Макро]]
{{Макро}}
----
[[Файл:Clip2018.png|thumb|right|Состояние слоев]] 
[[Файл:Clip2019.png|thumb|right|Редактирование слоёв]]
В '''K3''' возможна работа со слоями. Работа со слоями в '''K3''' представляет собой набор инструментов, практически идентичных работе со слоями в других системах автоматизированного проектирования (САПР). 

В общем случае слои в '''K3''' можно представить как набор прозрачных "пленок", наложенных одна на другую. Каждый слой в '''K3''' может иметь свое имя, цвет, толщину линии и другие характеристики. Слой может быть включен или выключен, на слое может быть разрешено или не разрешено редактирование объектов.

В интерактивном режиме практически вся работа со слоями осуществляется при помощи диалоговых окон, представленных на рисунках.

Команды и функции работы со слоями повторяют опции данных диалоговых окон.

В данном разделе собрано описание команд и функций, позволяющих осуществлять операции по работе со слоями.

== Работа со слоями ==

<code>'''layers''''' ''<nowiki>[</nowiki>''&lt;Params&gt; ''done]</code>

Команда '''layers''' осуществляет работу со слоями, согласно параметрам <code>''&lt;Params&gt;''</code>, представленным в следующих разделах. Если параметры <code>''&lt;Params&gt;</code> ''отсутствуют, работа осуществляется при помощи диалогового окна, представленного на рисунке выше. 

Если в команде опустить параметр с именем слоя, с которым нужно произвести те или иные действия (<code>''&lt;Name&gt;''</code>), то выбор слоя осуществляется при помощи диалогового окна, представленного на рисунке выше. Для выбора слоя в данном случае его нужно указать в первой колонке диалогового окна.

{| class="prettytable"
|-
|valign="top"|[[image:pluso.png]]
|Слой с именем "0" не может быть ни удален, ни переименован.
|}

{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''В процессе работы со слоями можно устанавливать цвет, толщину и тип линии объектов слоя, а также графический коэффициент. При этом, если объект имеет одну из указанных характеристик "'''По слою'''", то именно этот цвет (толщину, тип линии, графический коэффициент) он и получит. При этом любую из указанных характеристик объект может иметь явно и отличную от характеристик слоя. Например, для слоя установлен цвет - зеленый. Этим цветом по-умолчанию будут отображаться все объекты в слое, если только объекту явно не приписан другой цвет.''
|}

=== Создание нового слоя ===

<code>layers new ''&lt;Name&gt;''</code>

Команда создает новый слой в списке слоев с именем <code>''&lt;Name&gt;''</code>. Текущим при этом остается слой, который был до создания нового. Максимальное число созданных слоев - 255.


<code>layers make ''&lt;Name&gt;''</code>

Команда создает новый слой в списке слоев с именем <code>''&lt;Name&gt;</code> ''и делает его текущим.

{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''Если слой с именем <code>&lt;Name&gt;</code> удален, то команда'' <code>layers make''</code> снимает пометку на удаление.''
|}


<code>layers rename ''&lt;OldName&gt; &lt;NewName&gt;''</code>

Команда переименовывает слой в списке слоев с именем <code>''&lt;OldName&gt;</code> ''и устанавливает у него имя <code>''&lt;NewName&gt;''</code>.

===Смена текущего слоя===

<code>layers set ''&lt;Name&gt;''</code>

Команда делает текущим слой именем <code>''&lt;Name&gt;''</code>. Слой с данным именем уже должен существовать. 

{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''Если слой с именем <code>&lt;Name&gt;</code> удален, то команда'' <code>layers set''</code> снимает пометку на удаление.''
|}

===Включение/выключение слоя===

<code>layers {on | off''} ''{''&lt;Name&gt;'' | all}</code>

Команда включает (<code>on</code>) или выключает (<code>off</code>) слой с именем <code>''&lt;Name&gt;''</code>. Если указан ключ <code>all</code>, то команда включает (или выключает) все слои. Объекты, расположенные на выключенном слое не отображаются.

{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''Действие этой (и некоторых других) команд работы со слоями распространяется только на слои, непомеченные к удалению (см. рисунок выше, второй столбец справа). Подробнее об удалении слоев см. раздел "[[Слои#Удаление слоя|Удаление слоя]]"''
|}

===Блокировка слоя===

<code>layers {lock | unlock''} ''{''&lt;Name&gt;'' | all}</code>

Команда блокирует (<code>lock</code>) или разблокирует (<code>unlock</code>) слой с именем <code>''&lt;Name&gt;''</code>. Если указан ключ <code>all</code>, то команда блокирует (или разблокирует) все слои. Объекты, расположенные на заблокированном слое нельзя ни отредактировать, ни удалить. Добавление новых объектов допускается.

{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''Действие этой (и некоторых других) команд работы со слоями распространяется только на слои, непомеченные к удалению (см. рисунок выше, второй столбец справа). Подробнее об удалении слоев см раздел "[[Слои#Удаление слоя|Удаление слоя]]"''
|}

===Цвет объектов слоя===

<code>layers color ''&lt;Name&gt; &lt;Color&gt;''</code>

Команда устанавливает цвет <code>''&lt;Color&gt;</code> ''объектов слоя с именем <code>''&lt;Name&gt;''</code>.

===Применить цвет к объектам слоя===

''доступно с 2.03.2020''

<code>layers applycolor ''&lt;Name&gt; ''{Yes|No}</code>

Команда включает/выключает режим '''Применить цвет к объектам слоя''' для слоя с именем <code>''&lt;Name&gt;''</code>.

Если режим выключен, то при смене цвета слоя объекты, лежащие на этом слое, будут отображаться своим цветом. Если режим включен, объекты слоя будут отображаться цветом слоя. Аналогично при переносе с одного слоя на другой объекты отображаются цветом слоя-адресата только в том случае, если режим включен.

===Тип линии объектов слоя===

<code>layers ltype ''&lt;Name&gt; &lt;LineType&gt;''</code>

Команда устанавливает тип линии <code>''&lt;LineType&gt;</code> ''объектов слоя с именем <code>''&lt;Name&gt;''</code>.

===Толщина линии объектов слоя===

<code>layers lwidth ''&lt;Name&gt; &lt;LineWidth&gt;''</code>

Команда устанавливает толщину линии <code>''&lt;LineWidth&gt;</code> ''объектов слоя с именем <code>''&lt;Name&gt;''</code>.

===Графический коэффициент объектов слоя===

<code>layers grfcoeff ''&lt;Name&gt; ''<nowiki>[{absolute | relative}] </nowiki>''&lt;GrfCoeff&gt;''</code>

Команда устанавливает графический коэффициент (ключ <code>absolute</code> — по-умолчанию) или относительное изменение графического коэффициента относительно текущего (ключ <code>relative</code>) <code>''&lt;GrfCoeff&gt;</code> ''объектов слоя с именем <code>''&lt;Name&gt;''</code>.

===Удаление слоя===

<code>layers delete ''&lt;Name&gt;''</code>

<code>layers delete all</code>

Команда помечает к удалению слой в списке слоев с именем <code>''&lt;Name&gt;</code> ''или все слои, кроме слоя с именем "0", если выбран ключ <code>all</code>. Текущий слой и слой с именем "0" удалить нельзя.

{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''Механизм удаления слоев действует следующим образом. При удалении слоев реально слой не удаляется, а только помечается к удалению (галочка во втором справа столбце диалогового окна). Реально слой удалится при повторном открытии файла, в котором слои помечены к удалению. Снять пометку к удалению слоя можно исключительно при помощи диалогового окна.''
|}

===Список слоев===
<code>layers list</code>

Команда выводит в командное окно список существующих слоев с их характеристиками (см. рисунок).
[[Файл:Clip2020.png|thumb|center|750px|Характеристики списка  существующих слоев]]

== Функции работы со слоями ==

===CountLayers===
<code>INT '''CountLayers'''()</code>

Функция возвращает количество существующих, '''не удаленных '''слоев.

===NameLayers===
<code>INT '''NameLayers'''(varname ARRAY ''&lt;Arr&gt;''<nowiki>[,</nowiki>'' ''varname ARRAY ''&lt;Off&gt;''])</code>

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

===ExistsLayer===
<code>logical '''ExistsLayer'''(STRING ''&lt;NameLayer&gt;''<nowiki>[, </nowiki>varname INT ''&lt;Off&gt;''<nowiki>[, </nowiki>varname INT ''&lt;Lock&gt;'']])</code>

Функция определяет существование слоя по его имени. <code>''&lt;NameLayer&gt;''</code> — строка с названием слоя (регистр букв не важен). Дополнительные параметры определяют: <code>''&lt;Off&gt;''</code> - выключен ('''1''') или включен ('''0''') слой с именам <code>''&lt;NameLayer&gt;''</code>.; <code>''&lt;Lock&gt;''</code> — заблокирован ('''1''') или разблокирован('''0''') слой с именем <code>''&lt;NameLayer&gt;''</code>.

Функция возвращает: 
:'''1''' — слой с таким именем существует, 
:'''0''' — слоя с таким именем не существует;
:'''-1''' — слой с таким именем удален.

===GetLayer===
<code>String '''GetLayer'''(Object ''&lt;Obj&gt;'')</code>

Функция возвращает имя слоя, которому принадлежит объект <code>''&lt;Obj&gt;''</code>.
----
{{Макро}}
@@ Строка 172: / Строка 172: @@
 Функция возвращает имя слоя, которому принадлежит объект <code>''&lt;Obj&gt;''</code>.
-== См. также ==
-*[[Изменение_свойств_объектов#.D0.98.D0.B7.D0.BC.D0.B5.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5_.D1.81.D0.BB.D0.BE.D1.8F_.D0.BE.D0.B1.D1.8A.D0.B5.D0.BA.D1.82.D0.BE.D0.B2|Изменение слоя объектов]]
 ----
 {{Макро}}