Типы событий
Программное обеспечение Image Acquisition Toolbox™ поддерживает несколько различных типов событий. Каждый тип события имеет связанное свойство объекта ввода видео, которое можно использовать для указания функции, выполняемой при возникновении события.
В этой таблице перечислены поддерживаемые типы событий, имя свойства объекта ввода видео, связанного с событием, и краткое описание события. Дополнительные сведения об этих свойствах обратного вызова см. в списке ссылок на свойства в разделе Свойства панели инструментов получения изображений.
Панель инструментов создает определенный набор информации для каждого события и сохраняет его в структуре события. Дополнительные сведения о содержимом этих структур событий и получении этой информации см. в разделе Получение информации о событиях.
Примечание
Обратные вызовы, в том числе 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 функция. Устройство получения изображения выполняет аппаратные триггеры при выполнении указанного условия. При возникновении события триггера панель инструментов выполняет функцию, заданную параметром TriggerFcn собственность. |
