sunos man page for mlib_imagesetstruct

mlib_ImageSetStruct(3MLIB)												mlib_ImageSetStruct(3MLIB)

NAME
       mlib_ImageSetStruct - set image data structure

SYNOPSIS
       cc [ flag... ] file... -lmlib [ library... ]
       #include <mlib.h>

       mlib_status  mlib_ImageSetStruct(mlib_image  *image,  mlib_type	type, mlib_s32 channels, mlib_s32 width, mlib_s32 height, mlib_s32 stride,
       const void *datbuf);

       The mlib_ImageSetStruct() function sets a mediaLib image data structure using parameters supplied by the user.

       The mlib_ImageSetStruct() 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)

	 o  datbuf should not be NULL

       Whenever MLIB_FAILURE is returned, the original image data structure is not changed.

       If the data buffer in the image data structure is not NULL, it is the user's responsibility to free it if necessary.

       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.

       MLIB_SUCCESS is returned if the image data structure is set successfully. MLIB_FAILURE is returned when the image data structure can not be
       set according to the parameters supplied.

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

       mlib_ImageCreate(3MLIB),        mlib_ImageCreateSubimage(3MLIB),        mlib_ImageCreateStruct(3MLIB),	     mlib_ImageResetStruct(3MLIB),
       mlib_ImageDelete(3MLIB), mlib_ImageSetFormat(3MLIB), mlib_ImageSetPaddings(3MLIB), attributes(5)

								    1 Mar 2005						mlib_ImageSetStruct(3MLIB)