Home > C: Programming > Function Descriptions > History back  Previous chapter  Next chapter  Print  

is_FreezeVideo

uEye Camera Manual Version 3.80

is_FreezeVideo

Windows_Logo

Linux_Logo

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

is_HasVideoStarted()
is_IsVideoFinish()
is_SetExternalTrigger()
is_ForceTrigger()
is_CaptureVideo()
is_SetTimeout()
is_GetCaptureErrorInfo()

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#)

Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!


© 2010 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com