insert_halfedge

Mesh.insert_halfedge(face, origin, target)

Insert face diagonal.

Splits face into two polygonal parts.

Parameters:

• face (Face) – Polygonal face of a mesh.

• origin (Vertex) – Origin vertex, incident with face.

• target (Vertex) – Target vertex, incident with face and different from origin.

Raises:

• ValueError – In case of invalid input.

• NonManifoldError – If something goes wrong.

Returns:

The newly inserted halfedge. The face to its left is equal to face.

Return type:

Halfedge

Note

This method cannot be used to split off parts of a mesh’s boundary. Use add_face() for that.