Module NMesh :: Class NMFace
[frames | no frames]

Class NMFace


The NMFace object

This object holds mesh face data.

Example:
import Blender
from Blender import NMesh

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

Note: 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).

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

Class Variable Summary
  col: The list of vertex colours.
  flag: Bit vector specifying selection flags (see NMesh.FaceFlags).
  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].
  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)

Append a vertex to this face's vertex list.
Parameters:
vertex - An NMVert object.
           (type=NMVert)

Class Variable Details

col

The list of vertex colours.

flag

Bit vector specifying selection flags (see NMesh.FaceFlags).

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].

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), ...].

v

The list of face vertices (up to 4).
Type:
list

Generated by Epydoc 2.1 on Thu Aug 12 21:47:30 2004 http://epydoc.sf.net