User`s guide

4 Connecting to Hardware
format, the toolbox creates a video source object for each connection. For
anexampleshowingthevideosourceobje cts created with another video
format, see “Specifying the Video Format” on page 4-12.
3 The Acquisition Parameters section liststhevaluesofkeyvideoinputobject
properties. These properties control various aspects of the acquisition,
such as the number of frames to acquire and the location where acquired
frames are stored. For information about these properties, see Chapter
5, “Acquiring Image D ata”.
4 The Trigger Parameters section lists the trigger type configured for the
object and the number of times the trig ger is t o be executed. Trigger
execution initiates data logging, and the toolbox supports several types of
triggers. The example o bject is configured b y d efault with an immediate
trigger. Fo r m ore information about configuring triggers, see Chapte r 5,
“Acquiring Image D ata”.
5 The Status section lists the current state of the object. A video input object
can be in one of several states:
• Running or not running (stopped)
• Logging or not logging
• Previewing or not previewing
In the example, the object describes its state as
Waiting for START.This
indicates it is not running. For more information about the running state,
see “Starting and Stopping a Video Input Object” o n page 4-24. This section
also reports how many frames of data have been acquired and how many
frames are available in the buffer where the t oo lbox stores acquired frames.
For more information about these parameters, see “Controlling Logging
Parameters” on page 5-20.
Specifying the Video Format
Yo u can optionally specify the format of the video stream w h en you create
avideoinputobjectasathirdargumenttothe
videoinput function. This
argument can take two forms:
• Atextstringspecifyingavideoformat
• A name of a device configuration file, also known as a camera file
4-12