Face3d

A 3DFACE (DXF Reference) is real 3D solid filled triangle or quadrilateral. Access vertices by name (entity.dxf.vtx0 = (1.7, 2.3)) or by index (entity[0] = (1.7, 2.3)).

Unlike the entities Solid and Trace, the vertices of Face3d have the expected vertex order:

msp.add_3dface([(0, 0), (10, 0), (10, 10), (0, 10)])

Subclass of	ezdxf.entities.DXFGraphic
DXF type	'3DFACE'
Factory function	ezdxf.layouts.BaseLayout.add_3dface()
Inherited DXF attributes	Common graphical DXF attributes

Warning

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

class ezdxf.entities.Face3d

The class name is Face3d because 3dface is not a valid Python class name.

dxf.vtx0

Location of 1. vertex (3D Point in WCS)

dxf.vtx1

Location of 2. vertex (3D Point in WCS)

dxf.vtx2

Location of 3. vertex (3D Point in WCS)

dxf.vtx3

Location of 4. vertex (3D Point in WCS)

dxf.invisible_edge

invisible edge flag (int, default=0)

1	first edge is invisible
2	second edge is invisible
4	third edge is invisible
8	fourth edge is invisible

Combine values by adding them, e.g. 1+4 = first and third edge is invisible.

transform(m: Matrix44) → Face3d

Transform the 3DFACE entity by transformation matrix m inplace.

wcs_vertices(close: bool = False) → list[ezdxf.math._vector.Vec3]

Returns WCS vertices, if argument close is True, last vertex == first vertex.

returns 4 vertices when close=False and 5 vertices when close=True. Some edges may have 0 length.

Compatibility interface to SOLID and TRACE. The 3DFACE entity returns already WCS vertices.