cc [ flag... ] file... –lmlib [ library... ]
#include <mlib.h>
mlib_status mlib_ImageReformat(void **dstData, const void **srcData,
mlib_s32 numBands, mlib_s32 xSize, mlib_s32 ySize,
mlib_type dstDataType, const mlib_s32 *dstBandoffsets,
mlib_s32 dstScanlinestride, mlib_s32 dstPixelstride,
mlib_type srcDataType, const mlib_s32 *srcBandoffsets,
mlib_s32 srcScanlinestride, mlib_s32 srcPixelstride);
The mlib_ImageReformat() function copies and casts, if needed, an image from one buffer to another. The formats and data types of the two buffers may be different.
dstPixel[x][y][i] = (dstDataType) srcPixel[x][y][i]
where the values of a pixel at position (x, y) and in channel i are:
srcPixel[x][y][i] = srcData[i][srcBandoffsets[i] +
srcScanlinestride*y +
srcPixelstride*x]
dstPixel[x][y][i] = dstData[i][dstBandoffsets[i] +
dstScanlinestride*y +
dstPixelstride*x]
It is the user's responsibility to make sure that the data buffers supplied are suitable for this operation. The srcData and dstData can have 1, 2, 3, or 4 channels, and they must have the same number of channels. The srcDataType and dstDataType can be MLIB_BYTE, MLIB_SHORT , MLIB_USHORT, MLIB_INT, MLIB_FLOAT, or MLIB_DOUBLE.
The conversions between different data types are implemented as described in the following table:
|
The actions are defined in C-style pseudo-code. All type casts follow the rules of standard C. clamp() can be defined as a macro: #define clamp(x, low, high) (((x) < (low)) ? (low) : (((x) > (high)) ? (high) : (x)))
The function takes the following arguments:
The pointer to the destination image data buffer.
The pointer to the source image data buffer.
The number of channels of the image data buffers.
The width of the image.
The height of the image.
The data type of the dstData buffer.
The initial pixel's offsets in the dstData buffer in terms of destination data buffer elements.
The scanline stride of the dstData buffer in terms of destination data buffer elements.
The pixel stride of the dstData buffer in terms of destination data buffer elements.
The data type of the srcData buffer.
The initial pixel's offsets in the srcData buffer in terms of source data buffer elements.
The scanline stride of the srcData buffer in terms of source data buffer elements.
The pixel stride of the srcData buffer in terms of source data buffer elements.
The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.
See attributes(5) for descriptions of the following attributes:
|