# Класс «objectSensor»

Видеокамера в режиме датчика объекта. Захватывает контрастный объект в центре кадра и возвращает его координаты и размер в кадре.

| Метод             | Описание                                                                                                                                                                          |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [detect](#detect) | Определяет доминирующий цвет в центре кадра и запоминает его как цвет объекта.                                                                                                    |
| [init](#init)     | Включает видеокамеру и инициализирует её в режиме датчика объекта.                                                                                                                |
| [read](#read)     | Возвращает массив с координатой по оси X центра объекта относительно центра кадра, координатой по оси Y центра объекта относительно центра кадра, относительным размером объекта. |
| [stop](#stop)     | Выключает видеокамеру и прекращает работу датчика.                                                                                                                                |

## detect

Определяет доминирующий цвет в центре кадра и запоминает его как цвет объекта. После этого метод «[read](#read)» начинает возвращать данные для объекта.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```
brick.objectSensor().detect()
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
brick.objectSensor().detect();
```

{% endtab %}
{% endtabs %}

## init

Включает видеокамеру и инициализирует её в режиме датчика объекта. Булевый параметр определяет, выводить ли на экран изображение с камеры (`true` — выводить).

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```python
brick.objectSensor().init(True)
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
brick.objectSensor().init(true);
```

{% endtab %}
{% endtabs %}

Булевый параметр определяет, выводить ли на экран изображение с камеры:

* `true` — выводить,
* `false` — не выводить.

## read

Возвращает массив, в ячейках которого находятся следующие данные:

* в нулевой ячейке координата по оси X центра объекта относительно центра кадра (от -100 до 100, -100 — центр объекта на краю кадра слева);
* в первой ячейке — координата по оси Y центра объекта относительно центра кадра (от -100 до 100, -100 — центр объекта на краю кадра сверху);
* во второй ячейке — относительный размер объекта, число от 0 до 100 (100 — объекта занимает почти весь кадр, 0 — объекта нет на кадре).

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```
brick.objectSensor().read()
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
brick.objectSensor().read();
```

{% endtab %}
{% endtabs %}

## stop

Выключает видеокамеру и прекращает работу датчика.

#### Синтаксис

{% tabs %}
{% tab title="Python" %}

```
brick.objectSensor().stop()
```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
brick.objectSensor().stop();
```

{% endtab %}
{% endtabs %}