Типы событий

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

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

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

Примечание

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

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

Событие

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

Описание

Ошибка

ErrorFcn

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

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

Полученные системы координат

FramesAcquiredFcn

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

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

Начать

StartFcn

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

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

Примечание

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

Стоп

StopFcn

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

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

Примечание

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

Таймер

TimerFcn

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

Примечание

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

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

Спусковой механизм

TriggerFcn

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

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