This object provides sequence and iterator access to the mesh's
faces.
Add zero or more faces and edges to the mesh. Faces which already
exist in the mesh, or faces which contain the same vertex multiple times
are ignored. Sequences of two vertices are accepted, but no face will be
created.
vertseq
ignoreDups
indexList
smooth
Note:
Since Blender 2.44 all new faces are selected.
Example:
import Blender
from Blender import Mesh
me = Mesh.Get("Plane") # get the mesh data called "Plane"
v = me.verts # get vertices
if len(v) >= 6: # if there are enough vertices...
me.faces.extend(v[1],v[2],v[3]) # add a single edge
l=[(v[0],v[1]),[0,2,4,5]]
me.faces.extend(l) # add another face
Warning:
Faces using the first vertex at the 3rd or 4th location in the
face's vertex list will have their order rotated so that the zero
index on in the first or second location in the face. When creating
face data with UVs or vertex colors, you may need to work around
this, either by checking for zero indices yourself or by adding a
dummy first vertex to the mesh that can be removed when your script
has finished.
Deletes one or more faces (and optionally the edges associated with
the face(s)) from the mesh.
deledges
faces
Sorts the faces using exactly the same syntax as pythons own list
sorting function.
import Blender
from Blender import Mesh
me = Mesh.Get('mymesh')
me.faces.sort(key=lambda f: f.area)
me.faces.sort(key=lambda f: f.cent)
Note:
Internally faces only refer to their index, so after sorting, faces
you alredy have will not have their index changed to match the new
sorted order.
Get selected faces.