EasyManuals Logo

THORLABS DCU223 SERIES User Manual

THORLABS DCU223 SERIES
530 pages
To Next Page IconTo Next Page
To Next Page IconTo Next Page
To Previous Page IconTo Previous Page
To Previous Page IconTo Previous Page
Page #358 background imageLoading...
Page #358 background image
© 2013 Thorlabs GmbH356
DCx Cameras
4.3.102 is_WaitForNextImage
USB 2.0
USB 3.0
USB 2.0
USB 3.0
Syntax
INT is_WaitForNextImage(HIDS hCam, UINT timeout, char** ppcMem, INT* imageID)
Description
is_WaitForNextImage() returns the pointer and sequence ID of the first (i.e. oldest) image in a memory
sequence. The queue mode has to be enabled for the memory sequence (see is_InitImageQueue() ). If the
sequence does not contain images, is_WaitForNextImage() waits until a new image arrives or until the
specified time has elapsed.
Note
Note that also image capture errors are added to the ImageQueue like images. If a call of
is_WaitForNextImage() returns the IS_CAPTURE_STATUS return value then you can check by a new call of
the function, if any further images were enqueued into the ImageQueue after the error.
Attention
Image memories in a sequence with queue mode are automatically locked. The image memories will have to be
unlocked with is_UnlockSeqBuf() in order to be re-used in the sequence.
Input parameters
hCam
Camera handle
timeout
Timeout in ms. Range 0…2
32
-1
If no images are in the sequence and no image arrives during the timeout, the
function returns IS_TIMED_OUT.
ppcMem
Pointer to a variable which will receive the address of the last image in the
sequence.
imageID
Pointer to a variable which will receive the sequence ID of the oldest image in
the sequence.
Return values
IS_CANT_COMMUNICATE_WITH_DRIVER
Communication with the driver failed because no driver
has been loaded.
IS_CANT_OPEN_DEVICE
An attempt to initialize or select the camera failed (no
camera connected or initialization error).
IS_INVALID_CAMERA_HANDLE
Invalid camera handle
IS_INVALID_MEMORY_POINTER
Invalid pointer or invalid memory ID
IS_INVALID_PARAMETER
One of the submitted parameters is outside the valid
range or is not supported for this sensor or is not
available in this mode.
IS_IO_REQUEST_FAILED
An IO request from the uc480 driver failed. Possibly the
versions of the uc480_api.dll (API) and the driver file
(uc480_usb.sys) do not match.
IS_NO_SUCCESS
General error message
IS_SUCCESS
Function executed successfully
IS_TIMED_OUT
A timeout occurred. An image capturing process could
not be terminated within the allowable period.
IS_CAPTURE_STATUS
A transfer error occurred or no image memory was
available for saving.
The parameter IS_CAPTURE_STATUS replaces the
previous parameter IS_TRANSFER_FAILED.
278
354

Table of Contents

Other manuals for THORLABS DCU223 SERIES

Questions and Answers:

Question and Answer IconNeed help?

Do you have a question about the THORLABS DCU223 SERIES and is the answer not in the manual?

THORLABS DCU223 SERIES Specifications

General IconGeneral
BrandTHORLABS
ModelDCU223 SERIES
CategorySecurity Camera
LanguageEnglish

Related product manuals