Home > Function descriptions > History back  Previous chapter  Next chapter  Print  

FreezeImage

uEye ActiveX Manual Version 4.00

FreezeImage

Syntax

LONG FreezeImage (LONG timeout)

Description

FreezeImage() captures an image and transfers it to the active image memory.

Parameters

timeout

 

[0]

Don’t wait for completion of image acquisition. Function returns immediately.

[1]

Wait for completion of image acquisition.

[10…21474836]

Wait max. timeout for completion of image acquisition. Wait time in 10 ms steps.

Return values

IS_SUCCESS

Function executed successfully

IS_NO_SUCCESS

General error message

Example

//Capture one image and don’t wait (function returns immediately):
ret = FreezeImage(0);
//Capture one image with timeout value of 2 seconds
(useful if working with an external trigger):
ret = FreezeImage(200);   //200 * 10ms = 2s

Related functions

StartLiveVideo()

SetExternalTrigger()

HasVideoStarted()

IsVideoFinish()


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

For technical questions please contact you local distributor or use the support form on our website.


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