Типы событий

Программное обеспечение Image Acquisition Toolbox™ поддерживает несколько различных типов событий. Каждый тип события имеет связанное свойство объекта ввода видео, которое можно использовать, чтобы задать функцию, которая выполняется, когда событие имеет место.

Эта таблица приводит поддерживаемые типы событий, имя свойства объекта ввода видео, сопоставленного с событием и кратким описанием события. Для получения дальнейшей информации об этих свойствах коллбэка, см. список ссылок свойства в Image Acquisition Toolbox Properties.

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

Примечание

Коллбэки, включая ErrorFcn, выполняются только, когда видео объект находится в состоянии выполнения. Если необходимо использовать коллбэк ErrorFcn для обработки ошибок во время предварительного просмотра, необходимо запустить видео объект перед предварительным просмотром. Чтобы сделать это, не регистрируя данные, используйте ручной триггер.

События и свойства функции обратного вызова

Событие

Свойство коллбэка

Описание

Ошибка

ErrorFcn

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

Когда ошибочное событие имеет место, тулбокс выполняет функцию, заданную свойством ErrorFcn. По умолчанию тулбокс выполняет функцию обратного вызова по умолчанию для этого события, imaqcallback, который отображает сообщение об ошибке в командной строке MATLAB®.

Полученные кадры

FramesAcquiredFcn

Тулбокс генерирует, кадры получили событие, когда конкретное количество кадров было получено. Вы используете свойство FramesAcquiredFcnCount задать этот номер.

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

Запуск

StartFcn

Тулбокс генерирует событие запуска, когда объект запускается. Вы используете функцию start, чтобы запустить объект.

Когда событие запуска имеет место, тулбокс выполняет функцию, заданную свойством StartFcn.

Примечание

Коллбэк StartFcn выполняется синхронно. Если вы задаете функцию обратного вызова StartFcn, тулбокс ожидает функции, чтобы закончить выполняться прежде, чем выполнить любую другую обработку. Если ошибка происходит в функции обратного вызова запуска, объект никогда не запускается.

Остановка

StopFcn

Тулбокс генерирует событие остановки, когда объект прекращает запускаться. Объект прекращает запускаться, когда функция stop вызвана, конкретное количество кадров получено, или ошибка времени выполнения происходит.

Когда событие остановки имеет место, тулбокс выполняет функцию, заданную свойством StopFcn.

Примечание

Коллбэк StopFcn выполняется синхронно. Если вы задаете функцию обратного вызова StopFcn, тулбокс ожидает функции, чтобы закончить выполняться прежде, чем выполнить любую другую обработку.

Таймер

TimerFcn

Тулбокс генерирует событие таймера, когда заданное количество времени истекает. Время измеряется относительно того, когда объект начинает запускаться. Вы используете свойство TimerPeriod задать количество времени.

Примечание

Некоторые события таймера не могут выполниться, если вашу систему значительно замедляют или если TimerPeriod установлен слишком маленький.

Когда событие таймера имеет место, тулбокс выполняет функцию, заданную свойством TimerFcn.

Триггер

TriggerFcn

Тулбокс генерирует триггерное событие, когда триггер выполняется. Объект ввода видео выполняет мгновенные триггеры. Вы выполняете ручные триггеры путем вызывания функции trigger. Устройство получения изображений выполняет аппаратные триггеры, когда заданное условие соблюдают.

Когда триггерное событие имеет место, тулбокс выполняет функцию, заданную the TriggerFcn свойством.