© 2016 Thorlabs Scientific Imaging214
DCx Camera Functional Description and SDK Manual
4.3.29 is_FreezeVideo
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 or OpenGL 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 DCx camera, see the How to proceed:
Image capture section.
Input parameters
Timeout value for image capture (see also the
How to proceed: Timeout values for image
capture section)
Return values
An internal structure has an incorrect size.
IS_CANT_COMMUNICATE_WITH_DRIVER
Communication with the driver failed because no driver
has been loaded.
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
A capturing operation is in progress and must be
terminated before you can start another one.
The image memory has an inappropriate size to store the
image in the desired format.
The camera type defined in the .ini file does not match the
current camera model.
This setting is not available for the currently set exposure
time.
IS_INVALID_MEMORY_POINTER
Invalid pointer or invalid memory ID
One of the submitted parameters is outside the valid
range or is not supported for this sensor or is not available
To Next Page
Loading...
Need help?
General
