cairo-mask (cr pattern)

cr -- a cairo-t context
pattern -- a cairo-pattern-t instance

A drawing operator that paints the current source using the alpha channel of pattern as a mask. Opaque areas of pattern are painted with the source, transparent areas are not painted.