Machine Vision Camera SDK (C) Developer Guide
consuming exists when transform the image to RGB24 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.6 MV_CC_GetOneFrameTimeout
Get one frame of picture, support getting chunk information and setting timeout.
API Definition
int MV_CC_GetOneFrameTimeout(
void
*handle,
unsigned char
*pData,
unsigned int
nDataSize,
MV_FRAME_OUT_INFO_EX *pFrameInfo,
unsigned 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, including chunk information, 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
● 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 supports setting timeout, SDK
94
