mediaLib Library Functions          mlibImageCopySubimage(3MLIB)



NAME
     mlibImageCopySubimage - copy subimage

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

     mlibstatus mlibImageCopySubimage(mlibimage *dst, const mlibimage *src,
          mlibs32 xd, mlibs32 yd, mlibs32 xs, mlibs32 ys, mlibs32 w,
          mlibs32 h);


DESCRIPTION
     The mlibImageCopySubimage()  function  copies  a  specified
     rectangular  area  from  one  image  to  a specified area of
     another image. The data type of the images can be  MLIBIT,
     MLIBYTE, MLIBSHORT, MLIBUSHORT, MLIBINT, MLIBFLOAT, or
     MLIBDOUBLE.


     It uses the following equation:

       dst[xd]i][yd]j][i] = src[xs]i][ys]j][i]



     where i = 0, 1, ..., w-1; j = 0, 1, ..., h-1.

PARAMETERS
     The function takes the following arguments:

     dst    Pointer to destination image.


     src    Pointer to source image.


     xd     X coordinate of the area origin in the destination.


     yd     Y coordinate of the area origin in the destination.


     xs     X coordinate of the area origin in the source.


     ys     Y coordinate of the area origin in the source.


     w      Width of the area to be copied.





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions          mlibImageCopySubimage(3MLIB)



     h      Height of the area to be copied.


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
     mlibImageCopy(3MLIB),            mlibImageCopyArea(3MLIB),
     mlibImageCopyMask(3MLIB),     mlibImageCopyMaskFp(3MLIB),
     attributes(5)





























SunOS 5.11           Last change: 2 Mar 2007                    2