Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mlib_imageresetstruct(3mlib) [opensolaris man page]

mlib_ImageResetStruct(3MLIB)				    mediaLib Library Functions				      mlib_ImageResetStruct(3MLIB)

NAME
mlib_ImageResetStruct - reset image data structure SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ] #include <mlib.h> mlib_status mlib_ImageResetStruct(mlib_image *image, mlib_type type, mlib_s32 channels, mlib_s32 width, mlib_s32 height, mlib_s32 stride, const void *datbuf); DESCRIPTION
The mlib_ImageResetStruct() function resets a mediaLib image data structure using parameters supplied by the user. The mlib_ImageResetStruct() function returns MLIB_FAILURE if the supplied parameters do not pass the following sanity checks: o image should not be NULL o type should be MLIB_BIT, MLIB_BYTE, MLIB_SHORT, MLIB_USHORT, MLIB_INT, MLIB_FLOAT, or MLIB_DOUBLE o channels should be between 1 and 4 o width should be greater than 0 o height should be greater than 0 o stride should be no less than width * channels * (size of type in bytes) Whenever MLIB_FAILURE is returned, the original image data structure is not changed. When datbuf is NULL, the original data buffer is reused. If mlib_ImageIsUserAllocated(image)==0, such as the case the image data structure was created by mlib_ImageCreate(), and the data buffer size required by the parameters supplied is larger than the original, MLIB_FAILURE is returned. When datbuf is not NULL, if mlib_ImageIsUserAllocated(image)==0, the original data buffer is freed, otherwise the original data buffer is not freed. If datbuf points to the original data buffer, it is not freed. PARAMETERS
The function takes the following arguments: image Pointer to the image data structure. type Image data type. It can be MLIB_BIT, MLIB_BYTE, MLIB_SHORT, MLIB_USHORT, MLIB_INT, MLIB_FLOAT, or MLIB_DOUBLE. channels Number of channels in the image. width Width of image in pixels. height Height of image in pixels. stride Stride of each row of the data space in bytes. datbuf Pointer to the image data buffer. RETURN VALUES
MLIB_SUCCESS is returned if the image data structure is reset successfully. MLIB_FAILURE is returned when the image data structure can not be reset according to the parameters supplied. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
mlib_ImageCreate(3MLIB), mlib_ImageCreateSubimage(3MLIB), mlib_ImageCreateStruct(3MLIB), mlib_ImageSetStruct(3MLIB), mlib_ImageDelete(3MLIB), mlib_ImageSetFormat(3MLIB), mlib_ImageSetPaddings(3MLIB), attributes(5) SunOS 5.11 2 Mar 2007 mlib_ImageResetStruct(3MLIB)

Check Out this Related Man Page

mlib_ImageChannelInsert(3MLIB)				    mediaLib Library Functions				    mlib_ImageChannelInsert(3MLIB)

NAME
mlib_ImageChannelInsert - channel insert SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ] #include <mlib.h> mlib_status mlib_ImageChannelInsert(mlib_image *dst, const mlib_image *src, mlib_s32 cmask); DESCRIPTION
In the mlib_ImageChannelInsert() function, all N channels in the source image are copied into the selected channels in the destination image, where N is the number of channels in the source image. If more than N channels are selected, then the leftmost N channels are inserted. If less than N channels are selected, then the function returns failure status. The channel mask is defined with respect to the destination image. The data type of the image can be MLIB_BYTE, MLIB_SHORT, MLIB_USHORT, MLIB_INT, MLIB_FLOAT, or MLIB_DOUBLE. PARAMETERS
The function takes the following arguments: dst Pointer to a destination image. src Pointer to a source image. cmask Source or destination channel selection mask. Each bit of the mask represents a channel in the image data. The least significant bit (LSB) of the mask corresponds to the last channel in the image data. A bit with a value of 1 indicates that the channel is selected. RETURN VALUES
The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
mlib_ImageChannelCopy(3MLIB), mlib_ImageChannelExtract(3MLIB), mlib_ImageChannelMerge(3MLIB), mlib_ImageChannelSplit(3MLIB), attributes(5) SunOS 5.11 2 Mar 2007 mlib_ImageChannelInsert(3MLIB)
Man Page