
.. include:: RESOURCE.rst  

.. _annotation:

.. index:: Аннотации

===============================
Аннотации
===============================

Аннотации (или текстовые объекты) предназначены для добавления пользовательских заметок 
в 2D редакторе и 3D видах.

---------------------------
Аннотации в 2D редакторе
---------------------------

^^^^^^^^^^^^^^^^^^^^^^^^^
Создание аннотаций 
^^^^^^^^^^^^^^^^^^^^^^^^^

Создать аннотацию в выбранном слое можно  
командой *Контекстное меню* | *Создать аннотацию*. 
Данная команда расположена в разделе **ДОПОЛНИТЕЛЬНО** :numref:`(Рис. %s)<sako_annotation_image>` контекстного меню двумерного редактора.

.. _sako_annotation_image:
.. figure:: pictures\\sako_annotation.png
   :align: center
   :scale: 100%

   Диалог контекстного меню

В качестве примера использования аннотации рассмотрим :numref:`(Рис. %s)<annotation_demo_image>`

.. _annotation_demo_image:
.. figure:: pictures\\annotation_demo.png
   :align: center
   :scale: 100%

   Пример использования аннотаций

   
.. _text_property_ref: 

^^^^^^^^^^^^^^^^^^^^^^^^^
Редактирование аннотаций 
^^^^^^^^^^^^^^^^^^^^^^^^^

Редактировать аннотации можно либо вручную, либо с помощью диалога управления параметрами, 
представленного на :numref:`(Рис. %s)<annotation_property_image>`:


.. _annotation_property_image:
.. figure:: pictures\\sako_annotation_property.png
           :align: center
           :scale: 60%

           Диалог управления параметрами аннотаций

            
Чтобы вызвать диалог, необходимо:

  1. выбрать аннотацию мышкой в окне двумерного редактора;
  2. воспользоваться командой *Контекстное меню* | *Управление параметрами*. 
  
В диалоге необходимо указать:

  * *Параметры* - основные параметры аннотации:
  
    * *X,Y* - координаты относительно окна двумерного редактора, [м];
    * *Текст* - текст аннотации;
    * *Угол поворота* (в градусах);
    * *Размер* - относительно текущего (в процентах);
    * *Высота текста в сцене*, [м];
    * *Ширина текста в сцене*, [м];
    
    * *Показать вспомогательную линию* - линию объекта аннотации;
    * *Показать вспомогательную точку* - точку объекта аннотации;

    
  * *Шрифт* ;
  * *Цвет*.
   
.. note::
        Аннотации нельзя удалять с помощью клавиши *Delete*,
        только через *Контекстное меню* или 
        *Дерево объектов слоя*.
    
^^^^^^^^^^^^^^^^^^^^
Работа с аннотацией 
^^^^^^^^^^^^^^^^^^^^

Если выбрать аннотацию в двумерном редакторе, то 
у нее появятся управляющие элементы - желтые и зеленые квадратики
    
    .. figure:: pictures\\sako_text_object.png
                :align: center
                :scale: 60%

		Вид аннотации

* Чтобы изменить положение аннотации в окне двумерного редактора, 
  нужно переместить ее, зажав левую кнопку мыши. 

* Чтобы повернуть аннотацию, нужно зажать мышкой желтый квадратик, 
  повернуть аннотацию и отпустить зажатый квадратик. 

* Чтобы изменить размер аннотации, нужно зажать мышкой зеленый квадратик, 
  растянуть (или сжать) аннотацию и отпустить зажатый квадратик. 

* Чтобы изменить положение указательной точки, 
  необходимо зажать ее мышкой и переместить в нужное место.
  
  
---------------------------
Аннотации в 3D редакторе
---------------------------
При нажатии команды |show_annotation| (Режим работы с аннотациями) в 3D сцене активируется режим 
работы с аннотациями. В нем можно создавать, редактировать и перемещать аннотации.

Создать аннотацию можно по команде **Создать аннотацию** из меню по правой кнопке мыши 
в области сцены :numref:`(Рис. %s)<creAno>`. 

.. _creAno:
.. figure:: pictures\\creAnnotMenu.png
            :align: center
            :scale: 70%
            
            Меню по правой кнопке мыши сцены

При создании соответствующей аннотации нужно указать текст, который отобразится на экране, 
и координаты точки привязки, которая по умолчанию задается точкой установки меню по правой 
кнопке мыши. Аннотации бывают двух видов:

* привязанные к точке модели (3D аннотация) :numref:`(Рис. %s)<3dannot>`; 
* привязанные к точке на экране (2D аннотация) :numref:`(Рис. %s)<2dannot>`.            


^^^^^^^^^^^^^^^^^^^^
2D аннотации 
^^^^^^^^^^^^^^^^^^^^
            
  .. _2dannot:
  .. figure:: pictures\\create2dAnn.png
            :align: center
            :scale: 70%
            
            Диалог создания 2D аннотации

Редактирование 2D аннотации можно вызвать командой **Параметры аннотации** в контекстном меню 
по правой кнопке мыши на самой аннотации :numref:`(Рис. %s)<editAno2DM>`. 

.. _editAno2DM:
.. figure:: pictures\\edit2DAnnotMenu.png
            :align: center
            :scale: 70%
            
            Меню создания 2D аннотации

В окне редактирования аннотаци можно :numref:`(Рис. %s)<editAno2D>`:

 * именить отображаемый текст; 
 * изменить точку привязки аннотации;
 * задать размер текста;
 * применить курсивное начертание к тексту;
 * применить полужирное начертание к тексту.

.. _editAno2D:
.. figure:: pictures\\edit2DAnnot.png
            :align: center
            :scale: 70%
            
            Диалог редактирования 2D аннотации

2D аннотацию можно переместить мышью, зажав левой кнопкой нужную аннотацию.
Удалить аннотации можно по команде **Удалить все аннотации** в контекстном меню по правой кнопке мыши
сцены :numref:`(Рис. %s)<menuAno>`.


^^^^^^^^^^^^^^^^^^^^
3D аннотации 
^^^^^^^^^^^^^^^^^^^^
.. _3dannot:
.. figure:: pictures\\create3dAnn.png
          :align: center
          :scale: 70%
            
          Диалог создания 3D аннотации

Команда **Управление аннотациями** в контекстном меню по правой кнопке мыши позволяет редактировать 3D аннотации
:numref:`(Рис. %s)<menuAno>`. 

.. _menuAno:
.. figure:: pictures\\AnnotMenu.png
            :align: center
            :scale: 70%
            
            Меню аннотаций

.. figure:: pictures\\3Dannot.png
            :align: center
            :scale: 70%
            
            Пример 3D аннотации
			
В окне редактирования аннотации можно :numref:`(Рис. %s)<editAno>`:

 * изменить отображаемый текст; 
 * задать размер текста;
 * применить полужирное начертание к тексту;
 * применить курсивное начертание к тексту;
 * изменить цвет текста;
 * изменить прозрачность подкладки;
 * скрыть аннотацию;
 * изменить точку привязки аннотации;
 * удалить или создать новую аннотацию.

Так же для удобства работы можно скрыть столбцы координат точки привязки аннотации 
и сохранить/загрузить из текстового файла.

.. _editAno:
.. figure:: pictures\\edit3DAnnot.png
            :align: center
            :scale: 70%
            
            Диалог редактирования 3D аннотации

Так же можно переместить аннотации вручную. Для 3D аннотации появляется команда **Переместить аннотацию**
в меню по правой кнопке мыши сцены :numref:`(Рис. %s)<menuAno>`. Она позволяет переместить аннотацию, выбранную в комбобоксе, 
в точку открытия меню.

Удалить аннотации можно по команде **Удалить все аннотации** в контекстном меню по правой кнопке мыши
сцены :numref:`(Рис. %s)<menuAno>`.

