imgSnapArea
Usage
rval imgSnapArea(SESSION_ID sid, void** bufAddr, uInt32 top, uInt32 left, uInt32 height, uInt32 width, uInt32 rowPixels);
Purpose
Acquires a single image. This function operates the same as imgSnap, but is used to acquire only a portion of the image.
Parameters
| Name | Type | Direction |
| sid | SESSION_ID | input |
| bufAddr | void** | input/output |
| top | uInt32 | input |
| left | uInt32 | input |
| height | uInt32 | input |
| width | uInt32 | input |
| rowPixels | uInt32 | input |
| rval | Int32 | output |
Parameter Discussion
sid: valid SESSION_ID.
bufAddr: pointer to a pointer to an area of memory in which to store the image. If the parameter points to a NULL pointer, this call allocates a buffer, acquires an image, and returns the buffer address in the location specified by bufAddr. If the parameter points to a non-NULL pointer, this function acquires into that buffer.
top: top offset of the first pixel to acquire.
left: left offset of the first pixel to acquire.
height: height of the area to acquire.
width: width of the area to acquire.
rowPixels: total number of pixels in each image line. Passing a zero for this parameter causes the function to ignore the parameter and use the IMG_ATTR_ROWPIXELS attribute instead. Use this parameter for byte alignment or if the image buffer contains a border for image processing.
Return Value
This function returns 0 on success. On failure, this function returns an error code. For more information, call imgShowError.