Home > C: Programming > Function Descriptions > | History back Previous chapter Next chapter Print |
is_FreezeVideo |
uEye Camera Manual Version 3.80
is_FreezeVideo
USB 2.0 GigE |
USB 2.0 GigE |
Syntax
INT is_FreezeVideo (HIDS hCam, INT Wait)
Description
is_FreezeVideo() acquires a single image from the camera. In DIB mode, the image is stored in the active image memory. If ring buffering is used in DIB mode, the captured image is transferred to the next available image m emory of the sequence. Once the last available sequence memory has been filled, the sequence event or message will be triggered.
In Direct3D mode, the is directly copied to the graphics card buffer and then displayed.
Image capture will be started by a trigger if you previously enabled the trigger mode using is_SetExternalTrigger(). A hardware triggered image acquisition can be cancelled using is_StopLiveVideo() if exposure has not started yet.
For further information on the image capture modes of the uEye camera, see the How To Proceed: Image Capture section.
Input Parameters
hCam |
Camera handle |
Wait |
|
IS_DONT_WAIT |
Timeout value for image capture (see also the How To Proceed: Timeout Values for Image Capture section) |
IS_WAIT |
|
Time t |
Return Values
IS_SUCCESS |
Function executed successfully |
IS_NO_SUCCESS |
General error message |
Related Functions
Example
Enable trigger mode, set high-active flash mode and capture an image:
is_SetExternalTrigger(hCam, IS_SET_TRIGGER_SOFTWARE);
is_SetFlashStrobe(hCam, IS_SET_FLASH_HI_ACTIVE);
is_FreezeVideo(hCam, IS_WAIT);
Sample Programs
• | SimpleAcquire (C++) |
• | uEyeC# Demo (C#) |