mediaLib Library Functions           mlibImageSetPaddings(3MLIB)



NAME
     mlibImageSetPaddings - set paddings

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     mlibstatus mlibImageSetPaddings(mlibimage *img, mlibu8 left,
          mlibu8 top, mlibu8 right, mlibu8 bottom);


DESCRIPTION
     The mlibImageSetPaddings() function sets new values for the
     paddings field of the mlibimage structure as follows:

       img->paddings[0] = left;
       img->paddings[1] = top;
       img->paddings[2] = right;
       img->paddings[3] = bottom;



     By default, an image structure creation  function,  such  as
     mlibImageCreate(),       mlibImageCreateStruct(),       or
     mlibImageCreateSubimage(), sets the paddings field  of  the
     mlibimage structure as follows:

       img->paddings[0] = 0;
       img->paddings[1] = 0;
       img->paddings[2] = 0;
       img->paddings[3] = 0;



     Note that this function is needed only when the edge  condi-
     tion MLIBEDGESRCPADED is used.


     The mlibimage->paddings field denotes the  amount  of  pad-
     dings  on  each  side of an image, from which the real image
     border can be seen. When MLIBEDGESRCPADED  is  specified
     as  the edge condition, a geometric function uses the "real"
     source image border for clipping the destination image.

PARAMETERS
     The function takes the following arguments:

     img       Pointer to image data structure.


     left      Number of columns padded on the left side.




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions           mlibImageSetPaddings(3MLIB)



     top       Number of rows padded on the top.


     right     Number of columns padded on the right side.


     bottom    Number of rows padded at the bottom.


RETURN VALUES
     The function returns MLIBSUCES if  successful.  Otherwise
     it returns MLIBFAILURE.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     mlibImageGetPaddings(3MLIB),       mlibImageCreate(3MLIB),
     mlibImageCreateStruct(3MLIB),
     mlibImageCreateSubimage(3MLIB),    mlibImageAffine(3MLIB),
     attributes(5)






















SunOS 5.11           Last change: 2 Mar 2007                    2