Module Mesh :: Class MVert
[frames] | no frames]

Class MVert

The MVert object

This object holds mesh vertex data.


Warning: There are two kinds of UV texture coordinates in Blender: per vertex ("sticky") and per face vertex (UV in MFace). In the first, there's only one UV pair of coordinates for each vertex in the mesh. In the second, for each face it belongs to, a vertex can have different UV coordinates. This makes the per face option more flexible, since two adjacent faces won't have to be mapped to a continuous region in an image: each face can be independently mapped to any part of its texture.

Instance Methods
PVert
__init__(coord)
Create a new PVert object.
Instance Variables
vector (WRAPPED DATA) co
The vertex coordinates (x, y, z).
int hide
The face's edit mode visibility state (hidden=1).
int index
The vertex's index within the mesh (MVerts only).
vector no
The vertex's unit normal vector (x, y, z).
int sel
The vertex's selection state (selected=1).
vector (WRAPPED DATA) uvco
The vertex texture "sticky" coordinates (x, y), Note: These are not seen in the UV editor and they are not a part of UV a UVLayer.
Method Details

__init__(coord)
(Constructor)

 

Create a new PVert object.

Parameters:
  • coord (three floats or a Vector object) - the coordinate values for the new vertex
Returns: PVert
a new PVert object

Note: PVert-type objects are designed to be used for creating and modifying a mesh's vertex list, but since they do not "wrap" any Blender data there are some differences. The index and uvco attributes are not defined for PVerts, and the no attribute contains valid data only if the PVert was created from an MVert (using a slice operation on the mesh's vertex list.) PVerts also cannot be used as an argument to any method which expects data wrapping a Blender mesh, such as MVertSeq.delete().

Example:

       v = Blender.Mesh.MVert(1,0,0)
       v = Blender.Mesh.MVert(Blender.Mathutils.Vector([1,0,0]))

       m = Blender.Mesh.Get('Mesh')
       vlist = m.verts[:]   # slice operation also returns PVerts


Instance Variable Details

index

The vertex's index within the mesh (MVerts only). Read-only.
Type:
int

no

The vertex's unit normal vector (x, y, z). Note: if vertex coordinates are changed, it may be necessary to use Mesh.calcNormals() to update the vertex normals. Note: Vertex normals can be set, but are not wrapped so modifying a normal vector will not effect the verts normal. The result is only visible when faces have the smooth option enabled. Example:
       # This won't work.
       for v in me.verts:
               v.no.x= 0
               v.no.y= 0
               v.no.z= 1
       # This will work
       no= Blender.Mathutils.Vector(0,0,1)
       for v in me.verts:
               v.no= no
Type:
vector

sel

The vertex's selection state (selected=1). Note: a Mesh will return the selection state of the mesh when EditMode was last exited. A Python script operating in EditMode must exit EditMode before getting the current selection state of the mesh.
Type:
int

uvco

The vertex texture "sticky" coordinates (x, y), Note: These are not seen in the UV editor and they are not a part of UV a UVLayer. Use face UV's for that. if present. Available for MVerts only. Use Mesh.vertexUV to test for presence before trying to access; otherwise an exception will may be thrown. (Sticky coordinates can be set when the object is in the Edit mode; from the Editing Panel (F9), look under the "Mesh" properties for the "Sticky" button).
Type:
vector (WRAPPED DATA)