cairo:mask (cr pattern)

cr -- a cairo:context-t instance
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.