mediaLib Library Functions       mlibGraphicsDrawPointSet(3MLIB)



NAME
     mlibGraphicsDrawPointSet,      mlibGraphicsDrawPointSet8,
     mlibGraphicsDrawPointSet32, mlibGraphicsDrawPointSetX8,
     mlibGraphicsDrawPointSetX32,
     mlibGraphicsDrawPointSetB8,
     mlibGraphicsDrawPointSetB32,
     mlibGraphicsDrawPolypoint8, mlibGraphicsDrawPolypoint32,
     mlibGraphicsDrawPolypointX8,
     mlibGraphicsDrawPolypointX32,
     mlibGraphicsDrawPolypointB8,
     mlibGraphicsDrawPolypointB32 - draw a set of points

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

     mlibstatus mlibGraphicsDrawPointSet8(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c);


     mlibstatus mlibGraphicsDrawPointSet32(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c);


     mlibstatus mlibGraphicsDrawPointSetX8(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints,
          mlibs32 c, mlibs32 c2);


     mlibstatus mlibGraphicsDrawPointSetX32(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints,
          mlibs32 c, mlibs32 c2);


     mlibstatus mlibGraphicsDrawPointSetB8(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c,
          mlibs32 a);


     mlibstatus mlibGraphicsDrawPointSetB32(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c,
          mlibs32 a);


     mlibstatus mlibGraphicsDrawPolypoint8(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c);


     mlibstatus mlibGraphicsDrawPolypoint32(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c);





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions       mlibGraphicsDrawPointSet(3MLIB)



     mlibstatus mlibGraphicsDrawPolypointX8(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c,
          mlibs32 c2);


     mlibstatus mlibGraphicsDrawPolypointX32(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c,
          mlibs32 c2);


     mlibstatus mlibGraphicsDrawPolypointB8(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c,
          mlibs32 c2);


     mlibstatus mlibGraphicsDrawPolypointB32(mlibimage *buffer,
          const mlibs16 *x, const mlibs16 *y, mlibs32 npoints, mlibs32 c,
          mlibs32 c2);


DESCRIPTION
     Each    of     the     mlibGraphicsDrawPointSet*()     and
     mlibGraphicsDrawPolypoint*()  functions  draws  a  set  of
     points at (x1,y1), (x2,y2), ..., and (xn,yn).


     Each    of    the    mlibGraphicsDrawPointSetX*()     and
     mlibGraphicsDrawPolypointX*()  functions  draws  a set of
     points at (x1,y1), (x2,y2), ..., and (xn,yn) in Xor mode  as
     follows:

           data[x,y] ^= c ^ c2



     Each    of    the    mlibGraphicsDrawPointSetB*()     and
     mlibGraphicsDrawPolypointB*()  functions  draws  a set of
     points at (x1,y1), (x2,y2),  ...,  and  (xn,yn)  with  alpha
     blending as follows:

           data[x,y] = (data[x,y] * (255 - a) ] c * a) / 255



     The mlibGraphicsDrawPolypoint*() functions are aliases  of
     the mlibGraphicsDrawPointSet*() functions.

PARAMETERS
     Each of the functions takes some of the following arguments:

     buffer     Pointer to the image into which the  function  is
                drawing.



SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions       mlibGraphicsDrawPointSet(3MLIB)



     x          Pointer to array of X coordinates of the points.


     y          Pointer to array of Y coordinates of the points.


     npoints    Number of points in the arrays.


     c          Color used in the drawing.


     c2         Alternation color.


     a          Alpha value for blending. 0 < a < 255.


RETURN VALUES
     Each of the functions 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
     mlibGraphicsDrawPoint(3MLIB), attributes(5)
















SunOS 5.11           Last change: 2 Mar 2007                    3