| Reference Manual - 1.4.13

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().

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