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 #280 background imageLoading...
Page #280 background image
© 2013 Thorlabs GmbH278
DCx Cameras
4.3.62 is_InitImageQueue
USB 2.0
USB 3.0
USB 2.0
USB 3.0
Syntax
INT is_InitImageQueue (HIDS hCam, INT nMode)
Description
is_InitImageQueue() enables the queue mode for existing image memory sequences. New images will be
added to the end of the queue on arrival (FIFO principle). The image memory sequence has to be created with
is_AddToSequence() prior to calling is_InitImageQueue(). With is_WaitForNextImage() you can
query the pointer and sequence ID of the first (i.e. oldest) image in the sequence.
Note
Image memory sequences can also be used without queue mode. In this case the current image memory has to be
queried with is_GetActSeqBuf() on every frame event. Disadvantage of this proceeding is that at very high
frame rates it may happen that additional images arrive between the frame event and accessing/locking the
memory. The images arriving in this period will be skipped when you query the current image.
When the queue mode is used (is_InitImageQueue()), however, you can be sure to always receive the oldest
image which has not yet been queried. In addition, image memories are automatically locked immediately after
receiving the image. This prevents images from being overwritten when very high frame rates and few image
memories are used.
Input parameters
hCam
Camera handle
nMode
Queue mode. Currently only nMode = 0 is supported.
Return values
IS_INVALID_CAMERA_HANDLE
Invalid camera handle
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_NO_SUCCESS
General error message
IS_SUCCESS
Function executed successfully
Related functions
is_ExitImageQueue()
is_WaitForNextImage()
is_AddToSequence()
Example
// A previously initialized camera continuously captures images
// until a timeout or transfer error occurs.
// Note: image memories have to be allocated before this
is_InitImageQueue (m_hCam, 0);
INT nMemID = 0;
char *pBuffer = NULL;
while (IS_SUCCESS == is_WaitForNextImage(m_hCam, 1000, &pBuffer, &nMemID))
{
is_SaveImageMem (m_hCam, "image.bmp", pBuffer, nMemID);
is_UnlockSeqBuf (m_hCam, nMemID, pBuffer);
}
is_ExitImageQueue (m_hCam);
156 356
226
215
356
156

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