.. _external:

Внешние программы
=================

.. _METLAB: https://dipaul.ru/catalog/element/metlab/

Программа MeterVision достигает максимальной эффективности в сочетание с другими программами, которые способны
обрабатывать результаты распознавания машинного зрения. Например, такой программой может быть `METLAB`_ или программа пользователя

Для этих целей предусмотрены возможности отправлять результаты распознавания из данной программы во внешние двумя
способами, о которых было подробно написано ранее в разделе :ref:`res`

Также из внешних программ можно управлять некоторыми функция программы MeterVision. Для этого нужно создать текстовый файл
input/commands.txt в :ref:`catalog`, в котором будут описаны команды для MeterVision. Причем в файл можно записать сразу
несколько команд, но каждая команда должна быть на отдельной строке. Порядок выполнения команд - от первой строки к последней

Возможны следующие команды:

1. Закрыть программу MeterVision

.. code-block::

   exit

2. Сохранить :ref:`screen`

* В папку по умолчанию (output/screenshots/ в :ref:`catalog`) с названием файла по умолчанию (дата и время создания)

.. code-block::

   screenshot

* В папку по умолчанию с другим названием

.. code-block::

   screenshot my_name.png

* В указанную папку с другим названием

.. code-block::

   screenshot path/to/my/dir/my_name.png

3. Открыть файл настроек зон

.. code-block::

   open path/to/my/dir/settings.mv

4. Зафиксировать фон (только для стрелочных методов)

.. code-block::

   fix_background n

Где n - номер целевой зоны

5. Снять фиксацию фона (только для стрелочных методов)

.. code-block::

   unfix_background n

Где n - номер целевой зоны

6. Зафиксировать центр (только для стрелочных методов)

.. code-block::

   fix_center n

Где n - номер целевой зоны

7. Снять фиксацию центра (только для стрелочных методов)

.. code-block::

   unfix_center n

Где n - номер целевой зоны

8. Забыть статистику зоны (только для стрелочных методов)

.. code-block::

   forget_stats n

Где n - номер целевой зоны

9. Забыть фон (только для стрелочных методов)

.. code-block::

   forget_background n

Где n - номер целевой зоны

10. Переключиться на другую шкалу (только для стрелочных методов)

.. code-block::

   scale n m

Где n - номер целевой зоны, m - номер шкалы, на которую нужно переключиться


Пример файла input/commands.txt
--------------------------------

.. code-block::

   screenshot my_name.png
   unfix_background 1
   fix_center 1
   scale 1 3