Типы событий

Программное обеспечение 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 свойство.