Боковое меню и управление изображением
======================================

Боковое меню выглядит следующим образом

.. image:: img/side_menu.png
   :alt: Боковое меню программы
   :width: 234px
   :align: center

.. note::

   Для красоты нажатия на кнопки подсвечиваются зеленым

Рассмотрим его функции

Сохранение и загрузка настроек
------------------------------


.. |save_icon| image:: img/save.png
   :alt: Сохранить настройки
   :width: 32px
.. |open_icon| image:: img/open.png
   :alt: Загрузить настройки
   :width: 32px

|save_icon| — сохранить настройки зон

|open_icon| — загрузить сохранённые настройки зон

Точно так же это можно сделать с помощью команд в разделе :ref:`file` в главном меню программы.

.. _screen:

Скриншот
--------

.. |screen_icon| image:: img/screen.png
   :alt: Скриншот
   :width: 32px

Кнопка |screen_icon| позволяет сделать скриншоты с нанесением результатов распознавания.
Полученные изображения сохраняются в папке output/screenshots в :ref:`catalog`.

Пример такого изображения:

.. image:: img/screenshot.png
   :alt: Пример скриншота
   :width: 600px
   :align: center

.. _size:

Управление положением и размерами
---------------------------------

Остальные кнопки этого меню позволяют управлять положением и размерами изображения:

|arrow_icon| — сдвиг (влево, вправо, вверх, вниз)

|zoom_in_icon| — увеличить

|zoom_out_icon| — уменьшить

|reset_icon| — вернуть настройки по умолчанию

|rotate_cw_icon| — повернуть по часовой стрелке

|rotate_ccw_icon| — повернуть против часовой стрелки

|flip_h_icon| — отразить по горизонтали

|flip_v_icon| — отразить по вертикали

Ползунок "шаг настройки" регулирует плавность, с которой будет изменяться положение и размер изображения.

.. |arrow_icon| image:: img/arrow.png
   :alt: сдвиг
   :width: 32px
.. |zoom_in_icon| image:: img/plus.png
   :alt: Увеличить
   :width: 32px
.. |zoom_out_icon| image:: img/minus.png
   :alt: Уменьшить
   :width: 32px
.. |reset_icon| image:: img/default.png
   :alt: Сбросить
   :width: 32px
.. |rotate_cw_icon| image:: img/rotate_1.png
   :alt: Повернуть по часовой стрелке
   :width: 32px
.. |rotate_ccw_icon| image:: img/rotate_2.png
   :alt: Повернуть против часовой стрелки
   :width: 32px
.. |flip_h_icon| image:: img/h_flip.png
   :alt: Отразить по горизонтали
   :width: 32px
.. |flip_v_icon| image:: img/v_flip.png
   :alt: Отразить по вертикали
   :width: 32px


Также все эти команды можно выполнить с клавиатуры (стрелками и кнопками "+" и "-") или с помощью мыши (нажатием и
удерживанием левой кнопки мыши с перемещением для изменения положения и колесиком для изменения размера).

Также есть возможность перемещать зоны относительно изображения клавишами **w, s, a, d** на величину **шага настройки** (в пикселях).
Клавиши **w, s, a, d** перемещают выделенные зоны в списке зон соответственно **вверх, вниз, влево, вправо**, при этом зоны
не могу выйти за границы изображения.

.. note::

   Внимание! Если в списке зон выделена хотя бы одна зона, нажатие мыши приведет к повторному выбору границ для этой
   зоны, а не к перемещению изображение. Чтобы перемещать изображение с помощью мыши, в списке зон не должно быть
   выделенных зон

Область изображения
-------------------

В области изображения также есть несколько дополнительных кнопок.

Если в качестве источника изображения выбрана камера или видео, то кнопки |play_icon| и |stop_icon| в левом нижнем углу позволяют
запустить/остановить видеопоток.

Если источник — видео, внизу также появляется ползунок, который позволяет управлять текущим кадром видео.

Кнопка "дублировать" |duplicate_icon| в правом верхнем углу открывает дополнительные окна, в которых показываемое изображение
будет продублировано.

.. |play_icon| image:: img/play.png
   :alt: Запустить воспроизведение
   :width: 16px
.. |stop_icon| image:: img/pause.png
   :alt: Остановить воспроизведение
   :width: 16px
.. |duplicate_icon| image:: img/duplicate.png
   :alt: Дублировать окно
   :width: 16px

.. note::

   Большое количество дополнительных окон замедляют работу программы

Кнопки |rocket_icon| и |snail_icon| (ракета и улитка) позволяют ускорить работу программы или переключить её в обычный режим соответственно.
Нажатие на кнопку с ракетой |rocket_icon| приостанавливает обновления кадров в главном окне программы, но обновление кадров
продолжается в дополнительных окнах. Нажатие на улитку |snail_icon| возвращает программу в обычный режим.

.. |rocket_icon| image:: img/rocket.png
   :alt: Режим ускорения (ракета)
   :width: 16px
.. |snail_icon| image:: img/snail.png
   :alt: Обычный режим (улитка)
   :width: 16px

.. note::

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