--- title: "Using the Color Detector" slug: "using-the-color-detector" updated: 2023-10-31T17:07:22Z published: 2023-10-31T17:07:22Z canonical: "support.tulip.co/using-the-color-detector" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Использование детектора цвета ## Использование детектора цвета *Настройка и использование детектора цвета Vision для поиска событий изменения цвета в виде камеры и управления триггерами приложения.* Перед прочтением этой статьи ознакомьтесь с разделом " [Начало работы с Vision](https://support.tulip.co/docs/getting-started-with-vision) ", чтобы получить представление о функциональных возможностях и требованиях Vision, а также получить инструкции по настройке камеры. ## Обзор детектора цвета С помощью детектора цвета можно отслеживать заранее определенные области в потоке камеры для обнаружения заданных цветов в режиме реального времени. Затем можно использовать события обнаружения цвета для построения логики в приложении. **В этой статье вы узнаете...** - Как настроить детектор цвета - Использование событий детектора цвета в триггерах приложения - Как настроить параметры детектора цвета ## Настройка детектора цвета После завершения настройки конфигурации камеры вы должны увидеть видеопоток. Чтобы настроить детектор цвета, выберите регион, в котором будет осуществляться мониторинг цвета. Возможно, придется создать новый регион, щелкнув и перетащив изображение для определения области: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Color%20Detector_337257348.png) Назовите регион коротким содержательным описанием. Это имя в дальнейшем будет использоваться для срабатывания триггеров на основе региона, поэтому убедитесь, что оно запоминается (предпочтите имя типа "Widgets Bin", а не "Region 1"). Затем создайте детектор цвета, нажав на ссылку Create Detector. Назовите детектор, дайте ему описание (необязательно) и выберите тип детектора "Цвет". Включите детектор цвета для данного региона с помощью тумблера. Вы должны увидеть, что теперь в потоке камеры у региона появилось поле "Сходство: NN%". ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Color%20Detector_337257781.png) Граница региона окрасится в зеленый цвет в зависимости от "Порога начала определения цвета". Если этот порог равен 50%, то обнаруженный цвет в этом регионе должен быть более чем на 50% похож на цвет, указанный в настройках региона детектора цвета. Именно в этот момент в приложении, использующем данную *конфигурацию камеры*, будет инициировано событие. ## Настройки региона детектора цвета Скорее всего, вам потребуется изменить настройки региона, чтобы получить результаты, соответствующие вашему сценарию использования. Чтобы изменить настройки региона, щелкните на конфигурации камеры и выберите регионы, которые необходимо настроить. Доступны следующие настройки: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Color%20Detector_337258324.png) ### **Порог обнаружения начального цвета** Это процентное сходство между обнаруженными и заданными цветами, которое должно измениться, чтобы произошло событие "Начало обнаружения цвета". Если необходимо, чтобы цвета были очень похожи, можно установить более высокое значение порога, например 75-80%. Любое значение, превышающее этот порог, вызовет событие Color Detection Began, если до этого не было обнаружено ни одного цвета. ### Конечный порог обнаружения цвета Это процентное сходство между обнаруженным и заданным цветами, которое должно измениться, чтобы произошло событие "Обнаружение цвета закончилось". Если цвета менее похожи, можно установить значение около 60-65%. Любое значение, меньшее этого порога, приведет к возникновению события "Обнаружение цвета завершено", если до этого происходило обнаружение какого-либо цвета. ### Установка цвета для обнаружения Вы можете выбрать цвет для обнаружения с помощью кнопки*"Задать цвет текущего региона*", которая автоматически берет среднее значение цвета для выбранного региона, или использовать инструмент "Выбор цвета" для задания цвета вручную (щелчком по цветовому прямоугольнику). Таким образом, задается цвет, который необходимо обнаружить в регионе. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Color%20Detector_337258899.png) Убедитесь, что выбор цвета прошел успешно, наблюдая за увеличением значения сходства до высокого значения, например 95%. ## Использование детектора цвета в приложении Перейдите в редактор приложений и создайте новый **триггер Device Output Trigger**. Все *конфигурации камер* появятся в подсписке **Specific device**. Выберите *конфигурацию камеры* из выпадающего списка. Обратите внимание, что раздел **Specific** **device** позволяет использовать несколько камер в одном приложении. Любая станция, на которой запущено это приложение, должна иметь определенную *конфигурацию камеры*, выбранную для этой камеры. В противном случае при запуске приложения будет показано предупреждение. Теперь вы увидите выпадающий список различных событий, по которым можно запустить триггер: Для данного примера выберите из списка событий пункт **Начало обнаружения цвета**. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Color%20Detector_337264993.png) Если в вашем шаге используется виджет предварительного просмотра видео, обратите внимание на опцию "Show Overlay", позволяющую отключить показ регионов поверх видео. Включите наложение слоя "COLOR DETECTOR" для отображения информации об обнаружении цвета. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Color%20Detector_337265455.png) Запустите приложение на станции, которой была назначена *конфигурация камеры*. При открытии шага с **виджетом Vision Camera Widget** в проигрывателе вы увидите видеопоток с камеры. При перемещении внутри области объекта, имеющего цвет, аналогичный указанному в настройках, граница области станет зеленой, и произойдет действие триггера. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Using%20the%20Color%20Detector_337267085.png) Теперь вы успешно настроили детектор цвета как в конфигурации камеры, так и в приложении. ## Дальнейшее чтение - [Использование джиг-детектора](https://support.tulip.co/docs/using-the-jig-detector) - [Использование виджета Vision Camera Widget в приложениях](https://support.tulip.co/docs/using-the-vision-camera-widget-in-apps) - [Использование функции моментального снимка в приложениях](https://support.tulip.co/docs/using-visions-snapshot-feature) - [Рекомендации по аппаратному обеспечению для Vision](https://support.tulip.co/docs/hardware-recommendations-for-vision)