User`s guide
Getting Started Doing Image Acquisition Programmatically
1-13
vid
Summary of Video Input Object Using 'XCD-X700 1.05'.
Acquisition Source(s): input1 is available.
Acquisition Parameters: 'input1' is the current selected source.
10 frames per trigger using the selected source.
'Y8_1024x768' video data to be logged upon START.
Grabbing first of every 1 frame(s).
Log data to 'memory' on trigger.
Trigger Parameters: 1 'immediate' trigger(s) on START.
Status: Waiting for START.
0 frames acquired since starting.
0 frames available for GETDATA.
Step 4: Preview the Video Stream (Optional)
After you create the video input object, MATLAB is able to access the image acquisition
device and is ready to acquire data. However, before you begin, you might want to see a
preview of the video stream to make sure that the image is satisfactory. For example, you
might want to change the position of the camera, change the lighting, correct the focus,
or make some other change to your image acquisition setup.
Note This step is optional at this point in the procedure because you can preview a video
stream at any time after you create a video input object.
To preview the video stream in this example, enter the preview function at the
MATLAB prompt, specifying the video input object created in step 3 as an argument.
preview(vid)
The preview function opens a Video Preview figure window on your screen containing
the live video stream. To stop the stream of live video, you can call the stoppreview
function. To restart the preview stream, call preview again on the same video input
object.
While a preview window is open, the video input object sets the value of the Previewing
property to 'on'. If you change characteristics of the image by setting image acquisition
object properties, the image displayed in the preview window reflects the change.
The following figure shows the Video Preview window for the example.