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

is_CaptureVideo

uEye Camera Manual Version 3.80

is_CaptureVideo

Windows_Logo

Linux_Logo

USB 2.0

GigE

USB 2.0

GigE

Syntax

INT is_CaptureVideo (HIDS hCam, INT Wait)

Description

is_CaptureVideo() activates the camera's live video mode (free run mode). The driver transfers the images to an allocated image memory or, if Direct3D is used, to the graphics card. The image data (DIB mode) is stored in the memory created using is_AllocImageMem() and designated as active image memory using is_SetImageMem(). Using is_GetImageMem(), you can query the memory address.

If ring buffering is used, the image capturing function cycles through all image memories used for storing the images of a capture sequence in an endless loop. Sequence memories locked by is_LockSeqBuf() will be skipped. If the last available sequence memory has been filled, the sequence event or message will be triggered. Capturing always starts with the first element of the sequence.

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

IS_GET_LIVE

Returns if live capture is enabled.

Return Values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

IS_TRIGGER_ACTIVATED

The function cannot be used because the camera is waiting for a trigger signal.

When used with

IS_GET_LIVE

TRUE if live capture is enabled

Related Functions

is_FreezeVideo()
is_StopLiveVideo()
is_SetExternalTrigger()
is_ForceTrigger()
is_SetTimeout()
is_GetCaptureErrorInfo()

Sample Programs

SimpleLive (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