Документация

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

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

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

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

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

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

Чтобы просмотреть все свойства объекта получения изображений, с их текущими значениями, используют функцию 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]

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. Можно также получить информацию о конкретном свойстве в командной строке при помощи функций imaqhelp или propinfo.

Функция 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(vid)