Class MFace

The MFace object

This object holds mesh face data.

import Blender
from Blender import Mesh, Window

in_emode = Window.EditMode()
if in_emode: Window.EditMode(0)

me = Mesh.Get("Mesh")
faces = me.faces

## Example for editmode faces selection:
selected_faces = []
for f in faces:
  if f.sel:
    selected_faces.append(f)
# ... unselect selected and select all the others:
for f in faces:
  f.sel = 1 - f.sel # 1 becomes 0, 0 becomes 1

## Example for UV textured faces selection:
selected_faces = []
SEL = Mesh.FaceFlags['SELECT']
# get selected faces:
for f in faces:
  if f.flag & SEL:
    selected_faces.append(f)
# ... unselect selected and select all the others:
for f in faces:
  if f.flag & SEL:
    f.flag &= ~SEL # unselect these
  else:
    f.flag |= SEL # and select these

if in_emode: Window.EditMode(1)
Blender.Redraw()

Notes:

• there are regular faces and textured faces in Blender, both currently with their own selection and visibility states, due to a mix of old and new code. To (un)select or (un)hide regular faces (visible in EditMode), use MFace.sel and MFace.hide attributes. For textured faces (UV Face Select and Paint modes in Blender) use the MFace.flag attribute. Check the example above and note Window.EditMode.
• Assigning UV textures to mesh faces in Blender works like this:
  1. Select your mesh.
  2. Enter face select mode (press f) and select at least some face(s).
  3. In the UV/Image Editor window, load / select an image.
  4. Play in both windows (better split the screen to see both at the same time) until the UV coordinates are where you want them. Hint: in the 3D window, the 'u' key opens a menu of default UV choices and the 'r' key lets you rotate the UV coords.
  5. Leave face select mode (press f).