Underlay

The UNDERLAY entity (DXF Reference) links an underlay file to the DXF file, the file itself is not embedded into the DXF file, it is always a separated file. The (PDF)UNDERLAY entity is like a block reference, you can use it multiple times to add the underlay on different locations with different scales and rotations. But therefore you need a also a (PDF)DEFINITION entity, see UnderlayDefinition.

The DXF standard supports three different file formats: PDF, DWF (DWFx) and DGN. An Underlay can be clipped by a rectangle or a polygon path. The clipping coordinates are 2D OCS coordinates in drawing units but without scaling.

Subclass of ezdxf.entities.DXFGraphic
DXF type internal base class
Factory function ezdxf.layouts.BaseLayout.add_underlay()
Inherited DXF attributes Common graphical DXF attributes
Required DXF version DXF R2000 ('AC1015')
class ezdxf.entities.Underlay

Base class of PdfUnderlay, DwfUnderlay and DgnUnderlay

dxf.insert

Insertion point, lower left corner of the image in OCS.

dxf.scale_x

Scaling factor in x-direction (float)

dxf.scale_y

Scaling factor in y-direction (float)

dxf.scale_z

Scaling factor in z-direction (float)

dxf.rotation

ccw rotation in degrees around the extrusion vector (float)

dxf.extrusion

extrusion vector, default is (0, 0, 1)

dxf.underlay_def_handle

Handle to the underlay definition entity, see UnderlayDefinition

dxf.flags
dxf.flags Value Description
UNDERLAY_CLIPPING 1 clipping is on/off
UNDERLAY_ON 2 underlay is on/off
UNDERLAY_MONOCHROME 4 Monochrome
UNDERLAY_ADJUST_FOR_BACKGROUND 8 Adjust for background
dxf.contrast

Contrast value (20 - 100; default is 100)

dxf.fade

Fade value (0 - 80; default is 0)

clipping

True or False (read/write)

on

True or False (read/write)

monochrome

True or False (read/write)

adjust_for_background

True or False (read/write)

scale

Scaling (x, y, z) tuple (read/write)

boundary_path

Boundary path as list of vertices (read/write).

Two vertices describe a rectangle (lower left and upper right corner), more than two vertices is a polygon as clipping path.

get_underlay_def()

Returns the associated DEFINITION entity. see UnderlayDefinition.

set_underlay_def()

Set the associated DEFINITION entity. see UnderlayDefinition.

reset_boundary_path() → None

Removes the clipping path.

PdfUnderlay

Subclass of ezdxf.entities.Underlay
DXF type 'PDFUNDERLAY'
Factory function ezdxf.layouts.BaseLayout.add_underlay()
Inherited DXF attributes Common graphical DXF attributes
Required DXF version DXF R2000 ('AC1015')
class ezdxf.entities.PdfUnderlay

PDF underlay.

DwfUnderlay

Subclass of ezdxf.entities.Underlay
DXF type 'DWFUNDERLAY'
Factory function ezdxf.layouts.BaseLayout.add_underlay()
Inherited DXF attributes Common graphical DXF attributes
Required DXF version DXF R2000 ('AC1015')
class ezdxf.entities.DwfUnderlay

DWF underlay.

DgnUnderlay

Subclass of ezdxf.entities.Underlay
DXF type 'DGNUNDERLAY'
Factory function ezdxf.layouts.BaseLayout.add_underlay()
Inherited DXF attributes Common graphical DXF attributes
Required DXF version DXF R2000 ('AC1015')
class ezdxf.entities.DgnUnderlay

DGN underlay.