The WIPEOUT entity (DXF Reference) is a polygonal area that masks underlying objects with the current background color. The WIPEOUT entity is based on the IMAGE entity, but usage does not require any knowledge about the IMAGE entity.

The handles to the support entities ImageDef and ImageDefReactor are always “0”, both are not needed by the WIPEOUT entity.

Subclass of


DXF type


Factory function


Inherited DXF attributes

Common graphical DXF attributes

Required DXF version

DXF R2000 ('AC1015')


Do not instantiate entity classes by yourself - always use the provided factory functions!

class ezdxf.entities.Wipeout
set_masking_area(vertices: Iterable[UVec]) None

Set a new masking area, the area is placed in the layout xy-plane.