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 ezdxf.entities.Image
Factory function ezdxf.layouts.BaseLayout.add_wipeout()
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[Union[Sequence[float], ezdxf.math._vector.Vec2, ezdxf.math._vector.Vec3]]) → None

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