© 2016 Thorlabs Scientific Imaging
4 Programming (SDK)
193
This is the earliest possible moment for a new
capturing process. The image must then be
post-processed by the driver and will be
available after the IS_FRAME processing event.
A new image is available.
A new camera was connected.
This is independent of the device handle (hCam
is ignored).
IS_SET_EVENT_OVERLAY_DATA_LOST
Direct3D/OpenGL mode: Because of a re-
programming the parameters of the overlay are
invalid. The overlay must be draw new.
A camera was removed.
This is independent of the device handle (hCam
is ignored).
A camera initialized with is_InitCamera() was
disconnected.
The sequence is completed.
IS_SET_EVENT_STATUS_CHANGED
Linux only:
The availability of a camera has changed, e.g.
an available camera was opened.
An image extracted from the overlay is
available.
The automatic white balance control is
completed.
Return values
One of the submitted parameters is outside the valid
range or is not supported for this sensor or is not available
in this mode.
Function executed successfully
Related functions
is_DisableEvent()
Windows only: is_InitEvent()
Windows only: is_ExitEvent()
Linux only: is_WaitEvent()
Example Windows
HANDLE hEvent = CreateEvent(NULL, FALSE, FALSE, NULL);
is_InitEvent(hCam, hEvent, IS_SET_EVENT_FRAME);
is_EnableEvent(hCam, IS_SET_EVENT_FRAME);
is_FreezeVideo(hCam, IS_DONT_WAIT);
DWORD dwRet = WaitForSingleObject(hEvent, 1000);
if (dwRet == WAIT_TIMEOUT)
{
/* wait timed out */