Reference Manual - 1.1.1
IDirectFBSurface   SetSourceMask

Set the surface to be used as a mask for blitting.

DFBResult SetSourceMask (
  IDirectFBSurface   * thiz,
  IDirectFBSurface   * mask,
  int   x,
  int   y,
  DFBSurfaceMaskFlags   flags
);

The mask applies when DSBLIT_SRC_MASK_ALPHA or DSBLIT_SRC_MASK_COLOR is used.

Depending on the flags reading either starts at a fixed location in the mask with absolute x and y, or at the same location as in the source, with x and y used as an offset.

Example with DSMF_STENCIL:

              Blit from 19,  6 in the source
                    and  0,  0 in the mask (x =  0, y =  0)
                     or -5, 17             (x = -5, y = 17)
                     or 23, 42             (x = 23, y = 42)
        

Example without:

              Blit from 19,  6 in the source
                    and 19,  6 in the mask (x =  0, y =  0)
                     or 14, 23             (x = -5, y = 17)
                     or 42, 48             (x = 23, y = 42)
        

See also IDirectFBSurface::SetBlittingFlags().

Creative Commons License This work is licensed under a Creative Commons Attribution-Share Alike 3.0 License