Module NMesh :: Class NMFace

Class NMFace

The NMFace object

This object holds mesh face data.

Example:

import Blender
from Blender import NMesh, Window

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

me = NMesh.GetRaw("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 = NMesh.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

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

Notes:

there are normal 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 normal faces (visible in editmode), use sel and hide variables. For textured faces (Face Select mode in Blender) use the old flag bitflag. Also 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 coordinates.
5. Leave face select mode (press f).

Instance Methods

append(vertex)
Append a vertex to this face's vertex list.

source code

Instance Variables
	col The list of vertex colors.
	flag Bit vector specifying selection / visibility flags for uv textured faces (visible in Face Select mode, see NMesh.FaceFlags).
bool	hide The visibility state (1: hidden, 0: visible) of this NMesh's faces in edit mode.
	image The Image used as a texture for this face.
	mat Same as materialIndex below.
	materialIndex The index of this face's material in its NMesh materials list.
	mode The display mode (see Mesh.FaceModes)
	normal (or just no) The normal vector for this face: [x,y,z].
bool	sel The selection state (1: selected, 0: unselected) of this NMesh's faces in edit mode.
	smooth If non-zero, the vertex normals are averaged to make this face look smooth.
	transp Transparency mode bit vector (see NMesh.FaceTranspModes).
	uv List of per-face UV coordinates: [(u0, v0), (u1, v1), ...].
list	v The list of face vertices (up to 4).

Method Details

append(vertex)

source code

Append a vertex to this face's vertex list.

Parameters:

vertex (NMVert) - An NMVert object.

Instance Variable Details

hide

The visibility state (1: hidden, 0: visible) of this NMesh's faces *in edit mode*. This is not the same as the visibility state of the textured faces (see flag).

Type:: bool

sel

The selection state (1: selected, 0: unselected) of this NMesh's faces *in edit mode*. This is not the same as the selection state of the textured faces (see flag).

Type:: bool