pymel.core.general.MeshVertex

Inheritance diagram of MeshVertex

class MeshVertex(*args, **kwargs)
connectedEdges()
Return type:MeshEdge list
connectedFaces()
Return type:MeshFace list
connectedVertices()
Return type:MeshVertex list
geomChanged()

Reset the geom pointer in the MItMeshVertex . If you’re using MFnMesh to update Normals or Color per vertex while iterating, you must call geomChanged on the iteratior immediately after the MFnMesh call to make sure that your geometry is up to date. A crash may result if this method is not called. A similar approach must be taken for updating upstream vertex tweaks with an MPlug . After the update, call this method. Derived from api method maya.OpenMaya.MItMeshVertex.geomChanged

Undo is not currently supported for this method

getColor(*args, **kwargs)
getColorIndices(colorSetName=None)

This method returns the colorIndices into the color array see MFnMesh::getColors() of the current vertex.

Parameters :
colorSetName : unicode

Name of the color set.

Return type:

int list

Derived from api method maya.OpenMaya.MItMeshVertex.getColorIndices

getColors(colorSetName=None)

This method gets the colors of the current vertex for each face it belongs to. If no colors are assigned to the vertex at all, the return values will be (-1 -1 -1 1). If some but not all of the vertex/face colors have been explicitly set, the ones that have not been set will be (0, 0, 0, 1).

Parameters :
colorSetName : unicode

Name of the color set.

Return type:

Color list

Derived from api method maya.OpenMaya.MItMeshVertex.getColors

getNormal(space='preTransform')

Return the normal or averaged normal if unshared of the current vertex.

Parameters :
space : Space.Space

The transformation space.

values: ‘transform’, ‘preTransform’, ‘object’, ‘world’

Return type:

Vector

Derived from api method maya.OpenMaya.MSpace.getNormal

getNormalIndices()

This method returns the normal indices of the face/vertex associated with the current vertex.

Return type:int list

Derived from api method maya.OpenMaya.MItMeshVertex.getNormalIndices

getNormals(space='preTransform')

Return the normals of the current vertex for all faces

Parameters :
space : Space.Space

The transformation space.

values: ‘transform’, ‘preTransform’, ‘object’, ‘world’

Return type:

Vector list

Derived from api method maya.OpenMaya.MSpace.getNormals

getPosition(space='preTransform')

Return the position of the current vertex in the specified space. Object space ignores all transformations for the polygon, world space includes all such transformations.

Parameters :
space : Space.Space

The transformation space

values: ‘transform’, ‘preTransform’, ‘object’, ‘world’

Return type:

Point

Derived from api method maya.OpenMaya.MSpace.position

getUV(uvSet=None)

Get the shared UV value at this vertex

Parameters :
uvSet : unicode

Name of the uv set to work with.

Return type:

(float, float)

Derived from api method maya.OpenMaya.MItMeshVertex.getUV

getUVIndices(uvSet=None)

This method returns the uv indices into the normal array see MFnMesh::getUVs() of the current vertex.

Parameters :
uvSet : unicode

Name of the uv set.

Return type:

int list

Derived from api method maya.OpenMaya.MItMeshVertex.getUVIndices

getUVs(uvSet=None)

Get the UV values for all mapped faces at the current vertex. If at least one face was mapped the method will succeed.

Parameters :
uvSet : unicode

Name of the uv set to work with

Return type:

(float list, float list, int list)

Derived from api method maya.OpenMaya.MItMeshVertex.getUVs

hasColor()

This method determines whether the current Vertex has a color set for one or more faces.

Return type:bool

Derived from api method maya.OpenMaya.MItMeshVertex.hasColor

isConnectedTo(component)

pass a component of type MeshVertex, MeshEdge, MeshFace, with a single element

Return type:bool
isConnectedToEdge(index)

This method determines whether the given edge contains the current vertex

Parameters :index : int
Return type:bool

Derived from api method maya.OpenMaya.MItMeshVertex.connectedToEdge

isConnectedToFace(index)

This method determines whether the given face contains the current vertex

Parameters :index : int
Return type:bool

Derived from api method maya.OpenMaya.MItMeshVertex.connectedToFace

isOnBoundary()

This method determines whether the current vertex is on a Boundary

Return type:bool

Derived from api method maya.OpenMaya.MItMeshVertex.onBoundary

numConnectedEdges()

This Method checks for the number of connected Edges on this vertex

Return type:int

Derived from api method maya.OpenMaya.MItMeshVertex.numConnectedEdges

numConnectedFaces()

This Method checks for the number of Connected Faces

Return type:int

Derived from api method maya.OpenMaya.MItMeshVertex.numConnectedFaces

numUVs(uvSet=None)

This method returns the number of unique UVs mapped on this vertex

Parameters :
uvSet : unicode

Name of the uv set to work with

Return type:

int

Derived from api method maya.OpenMaya.MItMeshVertex.numUVs

setColor(color)
setPosition(point, space='preTransform')

Set the position of the current vertex in the given space.

Parameters :
point : Point

The new position for the current vertex

space : Space.Space

Transformation space

values: ‘transform’, ‘preTransform’, ‘object’, ‘world’

Derived from api method maya.OpenMaya.MSpace.setPosition

setUV(uvPoint, uvSet=None)

Set the shared UV value at this vertex

Parameters :
uvPoint : (float, float)

The UV value to set.

uvSet : unicode

Name of the UV set to work with

Derived from api method maya.OpenMaya.MItMeshVertex.setUV

setUVs(uArray, vArray, faceIds, uvSet=None)

Set the UV value for the specified faces at the current vertex. If the face is not already mapped, the value will not be set. If at least ne face was previously mapped, the method should succeed. If no faces were mapped, the method will fail.

Parameters :
uArray : float list

All the U values - in local face order

vArray : float list

The corresponding V values

faceIds : int list

The corresponding face Ids

uvSet : unicode

Name of the uv set to work with

Derived from api method maya.OpenMaya.MItMeshVertex.setUVs

translateBy(vector, space='preTransform')

Translate the current vertex by the amount specified by the given vector.

Parameters :
vector : Vector

The amount of translation

space : Space.Space

The transformation space

values: ‘transform’, ‘preTransform’, ‘object’, ‘world’

Derived from api method maya.OpenMaya.MSpace.translateBy

Undo is not currently supported for this method

updateSurface()

Signal that this polygonal surface has changed and needs to redraw itself. Derived from api method maya.OpenMaya.MItMeshVertex.updateSurface

Undo is not currently supported for this method

Previous topic

pymel.core.general.MeshUV

Next topic

pymel.core.general.MeshVertexFace

Core

Core Modules

Other Modules

This Page