User`s guide

vii
Identifying Video Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Suggested Algorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Instantiating an Adaptor Object . . . . . . . . . . . . . . . . . . . . . . 4-11
Suggested Algorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Implementing Your Adaptor Class Constructor . . . . . . . . . . 4-12
Implementing Your Adaptor Class Destructor . . . . . . . . . . . 4-13
Acquiring Image Data
5
Acquiring Image Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
User Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Triggering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Overview of Virtual Functions Used to Acquire Data . . . . . . 5-3
Specifying the Format of the Image Data . . . . . . . . . . . . . . . 5-5
Specifying Image Dimensions . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Specifying Frame Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
Opening and Closing Connection with a Device . . . . . . . . . 5-10
Suggested Algorithm for openDevice() . . . . . . . . . . . . . . . . . 5-10
Suggested Algorithm for closeDevice() . . . . . . . . . . . . . . . . . 5-13
Starting and Stopping Image Acquisition . . . . . . . . . . . . . . 5-15
Suggested Algorithm for startCapture() . . . . . . . . . . . . . . . 5-15
Suggested Algorithm for stopCapture() . . . . . . . . . . . . . . . . 5-17
Implementing the Acquisition Thread Function . . . . . . . . . 5-18
User Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
Suggested Algorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
Supporting ROIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24
Implementing Software ROI . . . . . . . . . . . . . . . . . . . . . . . . 5-24
Implementing Hardware ROI . . . . . . . . . . . . . . . . . . . . . . . 5-26
Supporting Hardware Triggers . . . . . . . . . . . . . . . . . . . . . . . 5-27
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28