01626 typedef struct _StructBufferStatus
01627 {
01629 long ImageBufferCount;
01638 unsigned char **ImageBuffers;
01644 int LastValidFrame;
01647 long TotalFramesSavedToBuffer;
01653 float ImageBufferSizeInMegabytes;
01655 } StructBufferStatus;
long ImageBufferCount
The number of image buffers that are curerently allocated.
unsigned char ** ImageBuffers
A pointer to the image buffers.
int LastValidFrame
The index of the last frame in the buffer that has been written to, when receiving images from the camera.
long TotalFramesSavedToBuffer
The total number of frames that have been saved to the image buffers, since the current capture or download was started.
float ImageBufferSizeInMegabytes
The number of megabytes that have been reserved for the image buffers.
MS_CAMERACONTROL_API const StructBufferStatus MS_GetBufferStatus ( long CameraID,
int * pStatus = NULL
)
Returns:
a struct containing the current values of the status
Parameters:
CameraID This is the unique Camera ID value of the camera you want to apply this function to.
This must be the same value that was returned by MS_InitializeCameraID() when you initialized this camera.
pStatus Returns the status code of the operation. See Status Codes for more information.
This parameter is optional. If it is not passed, then the status will not be returned.
MS_CAMERACONTROL_API int MS_GetGrayscaleImage ( long CameraID,
unsigned char * pIn,
unsigned char * pOut,
int * pStatus = NULL
)
Attention:
You must manually allocate the buffer pOut before you call this function, and free this buffer when you are finished using it.
The size of this buffer must be StructCurrentImageSize.ImageWidthFromCamera * StructCurrentImageSize.ImageHeightFromCamera * 1, because each pixel will be 8 bits.
Returns:
the value of *pStatus
Parameters:
CameraID This is the unique Camera ID value of the camera you want to apply this function to.
This must be the same value that was returned by MS_InitializeCameraID() when you initialized this camera.
pIn This is the pointer to the image buffer to process.
This should be set to either a frame from the StructBufferStatus::ImageBuffers, or the pImage pointer passed to one of the callback functions.
pOut This is the pointer to the processed image.
pStatus Returns the status code of the operation. See Status Codes for more information.
This parameter is optional. If it is not passed, then the status will not be returned.