Synopsis
Put data from a user-supplied array into a 2D area of a buffer.
Format
void MbufPut2d(DestBufId, OffX, OffY, SizeX, SizeY, UserArrayPtr)
| MIL_ID DestBufId; | Destination buffer identifier |
| long OffX; | X pixel offset relative to destination buffer origin |
| long OffY; | Y pixel offset relative to the destination buffer origin |
| long SizeX; | Width of destination buffer area in which to put data |
| long SizeY; | Height of destination buffer area in which to put data |
| void *UserArrayPtr; | Source user array |
Description
This function copies data from a user-supplied array to a two-dimensional area of the specified MIL destination buffer.
The DestBufId parameter specifies the identifier of the destination buffer.
The OffX and OffY parameters specify the horizontal and vertical pixel offset, respectively, of the destination buffer area in which to put data in relation to the top-left destination buffer coordinate.
The SizeX and SizeY parameters specify the width and height, respectively, of the destination buffer area in which to copy the data (starting from the specified offsets OffX and OffY).
The UserArrayPtr parameter specifies the address of the user array from which to copy data into the destination buffer. Ensure that there are enough entries in the user array to fill the specified destination buffer area. MbufPut2d?assumes that the array is of the same data type as the destination buffer.
Note, for multi-band buffers, MbufPut2d behaves like MbufPutColor(DestBufId, M_PLANAR, M_ALL_BAND, UserArrayPtr), but puts the data in the specified two-dimensional region. Refer to MbufPutColor for more details.
See also
MbufPut, MbufPut1d, MbufPutColor, MbufGet, MbufGet1d, MbufGet2d, MbufGetColor