Machine Vision Camera SDK (C) Developer Guide
consuming exists when transform the image to BGR24 format, this API may cause frame loss
when the data frame rate is too high.
● Before calling this API to get image data frame, call MV_CC_StartGrabbing to start image
acquisition. This API can get frame data actively, the upper layer program should control the
frequency of calling this API according to the frame rate.
● This API is not supported by CameraLink device.
4.4.5 MV_CC_GetImageForRGB
Get a frame of RGB24 data, search the frame data in the memory and transform it to RGB24
format for return. Setting timeout is supported.
API Definition
int MV_CC_GetImageForRGB(
void
*handle,
unsigned char
*pData,
unsigned int
nDataSize,
MV_FRAME_OUT_INFO_EX *pFrameInfo,
int
nMsec
);
Parameters
handle
[IN] Device handle, which is returned by MV_CC_CreateHandle or
MV_CC_CreateHandleWithoutLog .
pData
[IN] Buffer address used to save image data
nDataSize
[IN] Buffer size
pFrameInfo
[OUT] Obtained frame information, RGB24 format, see the structure
MV_FRAME_OUT_INFO_EX for details.
nMsec
[IN] Waiting timeout, unit: millisecond
Return Value
Return MV_OK(0) on success, and return Error Code on failure.
Remarks
● Each time the API is called, the internal buffer is checked for data. If there is data, it will be
transformed as RGB24 format for return, if there is no data, return error code. As time-
93
