Конфигурирование свойств объектов получения изображений

О свойствах объектов получения изображений

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

Свойства объектов ввода видео управляют аспектами приобретения, которые характерны для всех устройств получения изображений. Например, можно использовать FramesPerTrigger свойство задать объем данных вы хотите получить.

Свойства объектов источника видеосигнала управляют аспектами приобретения, сопоставленного с конкретным источником. Набор свойств, поддержанных объектом источника видеосигнала, меняется в зависимости от каждого устройства. Например, некоторые устройства получения изображений поддерживают свойства, которые позволяют вам управлять качеством производимого изображения, такого как Brightness, Hue, и Saturation.

С любым типом объекта можно использовать те же функции тулбокса для

  • Просмотрите список всех свойств, поддержанных объектом с их текущими значениями

  • Просмотрите значение конкретного свойства

  • Получите информацию о свойстве

  • Установите значение свойства

Примечание

Три триггерных свойства объекта ввода видео требуют использования специальной функции конфигурирования. Для получения дополнительной информации смотрите Setting Trigger Properties.

Просмотр значений свойств объектов

Чтобы просмотреть все свойства объекта получения изображений, с их текущими значениями, используют get функция. Можно также использовать inspect функционируйте, чтобы просмотреть список свойств объектов в окне Property Inspector, где можно также отредактировать их значения.

Этот пример использует get функционируйте, чтобы отобразить список всех свойств объекта vid ввода видео. Просмотр Свойств Объекта Источника видеосигнала описывает, как сделать это для объектов источника видеосигнала.

Если вы не задаете возвращаемое значение, get функционируйте отображает свойства объектов в четырех категориях: Общие Настройки, Настройки Функции обратного вызова, Триггерные Настройки и Источники Приобретения.

get(vid)
  General Settings:
    DeviceID = 1
    DiskLogger = []
    DiskLoggerFrameCount = 0
    EventLog = [1x0 struct]
    FrameGrabInterval = 1
    FramesAcquired = 0
    FramesAvailable = 0
    FramesPerTrigger = 10
    Logging = off
    LoggingMode = memory
    Name = M_RS170-matrox-1
    NumberOfBands = 1
    Previewing = off
    ReturnedColorSpace = grayscale
    ROIPosition = [0 0 640 480]
    Running = off
    Tag = 
    Timeout = 10
    Type = videoinput
    UserData = []
    VideoFormat = M_RS170
    VideoResolution = [640 480]

  Callback Function Settings:
    ErrorFcn = @imaqcallback
    FramesAcquiredFcn = []
    FramesAcquiredFcnCount = 0
    StartFcn = []
    StopFcn = []
    TimerFcn = []
    TimerPeriod = 1
    TriggerFcn = []

  Trigger Settings:
    InitialTriggerTime = [0 0 0 0 0 0]
    TriggerCondition = none
    TriggerFrameDelay = 0
    TriggerRepeat = 0
    TriggersExecuted = 0
    TriggerSource = none
    TriggerType = immediate

  Acquisition Sources:
    SelectedSourceName = CH0
    Source = [1x8 videosource]

Просмотр свойств объекта источника видеосигнала

Чтобы просмотреть свойства, поддержанные объектом источника видеосигнала (или объектами) сопоставленный с объектом ввода видео, используйте getselectedsource функция, чтобы получить в настоящее время выбранный объект источника видеосигнала. Этот пример перечисляет свойства, поддержанные объектом источника видеосигнала, сопоставленным с объектом vid ввода видео. Отметьте специфичные для устройства свойства, которые включены.

Примечание

Объект источника видеосигнала для вашего устройства не может включать специфичные для устройства свойства. Например, к устройствам получают доступ с 'winvideo' адаптер, такой как веб-камеры, то использование Видео для Windows® (VfW) драйвер, не может обеспечить путь к тулбоксу, чтобы программно запросить для свойств устройства. Используйте инструменты конфигурирования, предоставленные производителем, чтобы сконфигурировать эти устройства.

get(getselectedsource(vid))
  General Settings:
    Parent = [1x1 videoinput]
    Selected = on
    SourceName = CH0
    Tag = 
    Type = videosource

  Device Specific Properties:
    InputFilter = lowpass
    UserOutputBit3 = off
    UserOutputBit4 = off
    XScaleFactor = 1
    YScaleFactor = 1

Просмотр значения конкретного свойства

Чтобы просмотреть значение конкретного свойства объекта получения изображений, получите доступ к значению свойства, когда вы были бы поле в структуре MATLAB®.

Этот пример иллюстрирует, как получить доступ к свойству путем ссылки на объект, как будто это была структура MATLAB с помощью записи через точку.

vid.Previewing

ans =

off

Свойства объектов Получения информации о

Чтобы получить информацию о конкретном свойстве, смотрите Image Acquisition Toolbox Properties. Можно также получить информацию о конкретном свойстве в командной строке при помощи propinfo или imaqhelp функции.

propinfo функция возвращает структуру, которая содержит информацию о свойстве, таком как его тип данных, значение по умолчанию и список всех возможных значений, если свойство поддерживает такой список. Этот пример использует propinfo получить информацию о LoggingMode свойство.

propinfo(vid,'LoggingMode')

ans = 

               Type: 'character vector'
         Constraint: 'enum'
    ConstraintValue: {'memory'  'disk'  'disk&memory'}
       DefaultValue: 'memory'
           ReadOnly: 'whileRunning'
     DeviceSpecific: 0

imaqhelp функция возвращает справочную информацию о свойстве с полным описанием. Этот пример использует imaqhelp получить информацию о LoggingMode свойство.

imaqhelp(vid,'LoggingMode')

Устанавливание значения свойства объекта

Чтобы установить значение конкретного свойства объекта получения изображений, вы присваиваете значение свойству, когда вы были бы поле в структуре MATLAB, с помощью записи через точку.

Примечание

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

Этот пример устанавливает значение свойства путем присвоения значения объекту, как будто это была структура MATLAB.

vid.LoggingMode = 'disk';

% Verify the property setting. 
vid.LoggingMode

ans =

disk

Просмотр списка всех устанавливаемых свойств объектов

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

set(vid)

Установка триггерных свойств

Значения определенных триггерных свойств, TriggerType, TriggerCondition, и TriggerSource, взаимосвязаны. Например, некоторый TriggerCondition значения только допустимы с определенными значениями TriggerType свойство.

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

  • triggerinfo функция возвращает все допустимые комбинации значений для заданного объекта ввода видео.

  • triggerconfig функция устанавливает значения этих свойств.

Для получения дополнительной информации смотрите Триггерный Тип Определения, Источник и Условие.

Примечание

Чтобы получить список опций, можно использовать на функции, нажать клавишу Tab после ввода функции на командной строке MATLAB. Список расширяется, и можно прокрутить, чтобы выбрать свойство или значение. Для получения информации об использовании этой функции завершения вкладки "Дополнительно" смотрите Используя Заполнение клавишей Tab для Функций.