Редактирование: Управление отображением

[[Категория:Макро]]
Команды, описываемые в данном разделе не создают и не изменяют объектов сцены. Они служат для работы с видовыми окнами в смысле отображения информации.

== Создать эпюр Монжа ==

<code>'''epure''' ''&lt;VPort&gt;''</code>

Команда '''epure''' располагает проекции на видовых окнах таким образом, чтобы получился эпюр Монжа с базовым видом — по видовому окну с номером <code>''&lt;VPort&gt;''</code>. Эпюром Монжа (назван в честь Гаспара Монжа, французского архитектора) называют направление видов чертежа, применяемое сейчас при черчении. Отличительная особенность — наличие проекционной связи между видами чертежа.

== Скрыть невидимые линии ==
<code>'''hide'''</code>

Команда '''hide''' осуществляет векторное удаление невидимых линий в текущем окне. В '''K3''' существует возможность растрового удаления невидимых линий. Поэтому следует различать растровое удаление невидимых линий и векторное, описанное в данном разделе.

== Погасить объекты ==

Команда '''invisible''' имеет несколько режимов работы, которые представлены ниже.


<code>'''invisible''' [partly|wholly] ''&lt;Objects&gt;''</code>

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


<code>'''invisible''' allvport [partly|wholly] ''&lt;Objects&gt;''</code>

Команда гасит (делает невидимыми на всех видовых окнах) объекты <code>''&lt;Objects&gt;''</code>. Данная команда является синонимом предыдущей команды.


<code>'''invisible''' rendervport [partly|wholly] ''&lt;Objects&gt;''</code>

Команда гасит (делает невидимыми на всех '''полутоновых''' видовых окнах) объекты <code>''&lt;Objects&gt;''</code>.


<code>'''invisible '''norendervport [partly|wholly] ''&lt;Objects&gt;''</code>

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

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

== Включить погашенные объекты ==

Команда '''visible''' имеет несколько режимов работы, которые представлены ниже.


<code>'''visible''' [partly|wholly] ''&lt;Objects&gt;''</code>

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


<code>'''visible '''allvport [partly|wholly] ''&lt;Objects&gt;''</code>

Команда включает (делает видимыми на всех видовых окнах) объекты <code>''&lt;Objects&gt;''</code>. Данная команда является синонимом предыдущей команды.


<code>'''visible''' rendervport [partly|wholly] ''&lt;Objects&gt;''</code>

Команда включает (делает видимыми на всех '''полутоновых''' видовых окнах) объекты <code>''&lt;Objects&gt;''</code>.


<code>'''visible''' norendervport [partly|wholly] ''&lt;Objects&gt;''</code>

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

== Перерисовать изображение ==

<code>'''redraw''' all | ''&lt;VPort&gt;''</code>

Команда '''redraw''' перерисовывает изображение на видовом окне с номером <code>''&lt;VPort&gt;''</code> или на всех видовых окнах (<code>all</code>).

Данная команда не изменяет режим отображения (векторный, растровый) и не отменяет команду удаления невидимых линий. Команда лишь «освежает» изображение, восстанавливая те части, которые «пострадали» в результате работы над изображением. Такое возможно, например, если был удален объект, рёбра которого совпадают с рёбрами объекта, находящегося в сцене. Тогда рёбра последнего объекта не будут видны четко.

<code>'''immediately'''</code>

Команда '''immediately''' мгновенно обновляет текущее изображение во всех видовых окнах.  

Во время исполнения макропрограммы '''К3-Мебель''' работает в режиме отложенного вывода, то есть изменения, происходящие с объектами, будут отображены тогда, когда будет осуществлён выход в интерактивный режим работы или выполнение макропрограммы будет завершено. Но иногда требуется отобразить текущее состояние объектов. Такая необходимость может возникнуть, например, если в скрипте на '''Python''' создано диалоговое окно, из которого вызываются команды '''К3-Мебель'''. Чтобы результат работы команды был отображён на экране сразу, а не после закрытия диалогового окна, необходимо вызвать команду '''immediately'''. 

== Регенерировать изображение ==

<code>'''regen''' all | ''&lt;VPort&gt;''</code>

Команда '''regen''' регенерирует (пересоздает) изображение на видовом окне с номером <code>''&lt;VPort&gt;''</code> или на всех видовых окнах (<code>all</code>).

== Панорама изображения ==

<code>'''pan'''<nowiki> [auto] </nowiki>''^x1,y1,z1 ^x2,y2,z2''</code>

Команда '''pan''' панорамирует (перемещает '''изображение, а не объекты!''') в текущем окне. То есть, точка на плоскости видового окна с координатами <code>''x1,y1,z1''</code> перемещается в точку <code>''x2,y2,z2''</code>. Соответствующим образом перемещается и изображение.

Необязательный ключ <code>auto</code> позволяет зациклить команду.

== Масштабирование изображения ==
Команда '''zoom''' осуществляет масштабирование '''изображения '''(не объектов, а '''изображения''') в видовых окнах. Команда имеет несколько режимов работы, которые представлены ниже.


<code>'''zoom'''<nowiki> [viewall | oneview] </nowiki>''&lt;Scale&gt;''</code>

Команда изменяет масштаб изображения в текущем видовом окне согласно параметру <code>''&lt;Scale&gt;</code>. ''Параметр должен быть строго больше нуля. Значение параметра больше единицы увеличивает изображение, меньше единицы - уменьшает изображение. Необязательный ключ <code>viewall</code> позволяет устанавливать масштаб не в текущем, а во всех видовых окнах. Необязательный ключ <code>oneview</code> позволяет устанавливать масштаб не во всех видовых окнах, а в текущем видовом окне.


<code>'''zoom'''<nowiki> [viewall | oneview] all</nowiki></code>

Команда устанавливает масштаб изображения в текущем видовом окне таким образом, чтобы все изображение поместилось в видовое окно. Необязательный ключ <code>viewall</code> позволяет устанавливать масштаб не в текущем, а во всех видовых окнах. Необязательный ключ <code>oneview</code> позволяет устанавливать масштаб не во всех видовых окнах, а в текущем видовом окне.


<code>'''zoom'''<nowiki> [viewall | oneview] extents</nowiki></code>

Команда устанавливает масштаб изображения в текущем видовом окне таким образом, чтобы  весь габаритный параллелепипед модели поместился в видовое окно. Необязательный ключ <code>viewall</code> позволяет устанавливать масштаб не в текущем, а во всех видовых окнах. Необязательный ключ <code>oneview</code> позволяет устанавливать масштаб не во всех видовых окнах, а в текущем видовом окне.


<code>'''zoom''' window ''^x1,y1,z1 ^x2,y2,z2''</code>

Команда изменяет масштаб изображения таким образом, чтобы в видовое окно поместилась часть изображения, попадающая в рамку с диагональю от токи с координатами  <code>''^x1,y1,z1</code> ''до точки с координатами <code>''^x2,y2,z2''</code>.


<code>'''zoom''' adjust ''&lt;VPort&gt;''</code>

Команда позволяет установить масштаб изображение в видовых окнах таким образом, чтобы изображения находились в проекционной связи между собой. За базовый берется вид в видовом окне с номером <code>''&lt;VPort&gt;''</code>.


<code>'''zoom''' previous</code><blockquote>'''''Начиная с версии 8.0 ключ previous больше не поддерживается. Вместо zoom previous можно использовать [[view save]] - [[view restore]]'''''</blockquote>Команда позволяет установить масштаб изображения, который был предыдущим установленным.


<code>'''zoom''' [viewall] byobjects [partly | wholly] ''&lt;Objects&gt;''</code>

Команда устанавливает масштаб изображения таким образом, чтобы габариты объектов <code>''&lt;Objects&gt;</code> ''вписались в видовое окно. Если выбран ключ <code>viewall</code>, то масштаб изображения устанавливается на всех видовых окнах.
* <code>partly</code> — необязательный ключ, позволяющий выбирать объекты на любом уровне;
* <code>wholly</code> — необязательный ключ, позволяющий выбирать объекты только на верхнем уровне;

== Режимы отображения объектов на экране ==
===stdisplay===
Команда '''stdisplay''' позволяет изменить режимы отображения объектов на экране. Команда имеет несколько режимов работы, которые представлены ниже.


<code>'''stdisplay''' dbpoint on | off</code>

Команда включает (<code>on</code>) или отключает (<code>off</code>) отображение базовой точки.


<code>'''stdisplay''' vi_approximation ''&lt;D&gt;''</code>

Команда устанавливает точность аппроксимации дуг при отображении на экране равным параметру <code>''&lt;D&gt;''</code>.


<code>'''stdisplay''' margin ''&lt;Z&gt;''</code>

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


<code>'''stdisplay''' asize ''&lt;P&gt;''</code>

Команда устанавливает размер изображения осей '''ПСК''' (в '''пикселах''') равным <code>''&lt;P&gt;''</code>.


<code>'''stdisplay''' constr on | off</code>

Команда включает (<code>on</code>) или отключает (<code>off</code>) отображение конструктивных ребер.


<code>'''stdisplay''' sketch on | off</code>

Команда включает (<code>on</code>) или отключает (<code>off</code>) отображение очерковых ребер.


<code>'''stdisplay''' cond on | off</code>

Команда включает (<code>on</code>) или отключает (<code>off</code>) отображение условно-отображаемых ребер.


<code>'''stdisplay''' approch on | off</code>

Команда включает (<code>on</code>) или отключает (<code>off</code>) отображение ребер аппроксимации.


<code>'''stdisplay''' dummy on | off</code>

Команда включает (<code>on</code>) или отключает (<code>off</code>) отображение мусорных ребер.


<code>'''stdisplay''' full on | off</code>

Команда включает (<code>on</code>) или отключает (<code>off</code>) режим отображения всех ребер.


<code>'''stdisplay'''<nowiki> grfcoeff [absolute | relative] </nowiki>''&lt;Coeff&gt;''</code>

Команда позволяет установить общий графический масштаб равным значению параметра <code>''&lt;Coeff&gt;''</code>. Ключи <code>absolute</code> и <code>relative</code> определяют абсолютную или относительную величину графического масштаба соответственно. То есть, устанавливается ли масштаб равным значению параметра <code>''&lt;Coeff&gt;''</code> или вычисляется путем умножения текущего графического масштаба на величину <code>''&lt;Coeff&gt;''</code>. По умолчанию действует ключ <code>absolute</code>.

===rendmode===
<code>'''rendmode'''</code>

Команда позволяет задать способ отображения объектов сцены в видовом окне.


<code>'''rendmode '''''&lt;Vport&gt; &lt;Mode&gt;''</code>

Команда устанавливает способ отображение объектов в видовом окне с номером <code>''&lt;Vport&gt;</code> ''в соответствии в режимом <code>''&lt;Mode&gt;</code>. ''Режим <code>''&lt;Mode&gt;''</code> может принимать следующие значения:
:'''0 '''- каркасом;
:'''1 '''- с удалением невидимых линий;
:'''2 '''- полутоновое изображение.

== Динамические панорама и масштабирование ==
<code>'''dpan'''</code>

Команда '''dpan''' позволяет установить динамический режим панорамирования изображения с помощью мыши. Данная команда в макропрограммах не используется.


<code>'''dzoom'''</code>

Команда '''dzoom''' позволяет установить динамическое изменение масштаба с помощью мыши. Данная команда в макропрограммах не используется.

== Вывод изображения на экран ==

<code>'''vimage''' on | off</code>

Команда '''vimage''' включает (<code>on</code>) или отключает (<code>off</code>) режим вывода результата графических команд в видовые окна. По умолчанию, режим включен. При выключенном режиме результат работы команд в видовые окна не выводится, а существует исключительно в памяти компьютера. Благодаря этому происходит ускорение работы команд.

== Параллелепипед видимости ==
Параллелепипедом видимости называется прямоугольный параллелепипед, грани которого ограничивают вывод отображения на экран. Он может быть включен, выключен, погашен и нарисован.
[[Файл:Visbox.png|thumb|center|700px|Изображение, отсеченное по параллелепипеду видимости]]
<code><nowiki>#st </nowiki>'''visbox'''<nowiki> {on | off | switch | offdisplay | ondisplay | {visbox [4points] </nowiki>''&lt;Point1&gt; &lt;Point2&gt; &lt;Point3&gt;''<nowiki> [</nowiki>''&lt;Point4&gt;'']} done</code>

Команда '''visbox''' осуществляет работу с параллелепипедом видимости согласно введенным ключам:

* <code>on</code> — включает отсечение параллелепипедом видимости;

* <code>off</code> — выключает отсечение параллелепипедом видимости;

* <code>switch</code> — переключает параллелепипед видимости. Если он был включен - включает. Если выключен - включает;

* <code>offdisplay</code> — выключает отображение параллелепипеда видимости. То есть объекты, находящиеся вне параллелепипеда видимости будут или не будут отображаться в зависимости от ключей <code>on</code> или <code>off</code>. В то время, как сам параллелепипед не будет виден на экране;

* <code>ondisplay</code> — включает отображение параллелепипеда видимости. То есть объекты, находящиеся вне параллелепипеда видимости будут или не будут отображаться в зависимости от ключей <code>on</code> или <code>off</code>. В то время, как сам параллелепипед будет виден на экране;

* <code>visbox</code> — задает положение и размеры параллелепипеда видимости по трем (по умолчанию) или по четырем (<code>4points</code>) точкам. В случае задания параллелепипеда по трем точкам, первые две точки (<code>''&lt;Point1&gt; &lt;Point2&gt;''</code>) задают диагональ основания параллелепипеда, а третья (<code>''&lt;Point3&gt;''</code>) определяет его высоту. В случае четырех точек (<code>4points</code>) первые две точки (<code>''&lt;Point1&gt; &lt;Point2&gt;''</code>) задают положение одной из сторон основания параллелепипеда, третья (<code>''&lt;Point3&gt;''</code>) - высоту основания параллелепипеда, а четвертая (<code>''&lt;Point4&gt;''</code>) - высоту самого параллелепипеда.

В переменную <samp>st</samp> помещается '''1''', если команда произвела какое-то действие и '''0''', если не произвела. Используется это с ключами <code>on</code> и <code>off</code> Например, если было отсечение, а после команды с ключом <code>off</code> отсечение выключено, то переменная примет значение '''1''', так как действие произведено - режим переключен. Если же отсечения не было, и выполнена команда с ключом <code>off</code>, то переменная получит значение '''0''', так как действие не произведено - отсечение и так было выключено.
@@ Строка 1: / Строка 1: @@
-[[Категория:Работа с видом]]
+[[Категория:Макро]]
-{{Работа с видом}}
-----
 Команды, описываемые в данном разделе не создают и не изменяют объектов сцены. Они служат для работы с видовыми окнами в смысле отображения информации.
@@ Строка 239: / Строка 237: @@
 В переменную <samp>st</samp> помещается '''1''', если команда произвела какое-то действие и '''0''', если не произвела. Используется это с ключами <code>on</code> и <code>off</code> Например, если было отсечение, а после команды с ключом <code>off</code> отсечение выключено, то переменная примет значение '''1''', так как действие произведено - режим переключен. Если же отсечения не было, и выполнена команда с ключом <code>off</code>, то переменная получит значение '''0''', так как действие не произведено - отсечение и так было выключено.
-----
-{{Работа с видом}}