Mesh.vertices_attribute

Mesh.vertices_attribute(name, value=None, keys=None)

Get or set an attribute of multiple vertices.

Parameters:

namestr

The name of the attribute.

valueobject, optional

The value of the attribute. Default is None.

keyslist[int], optional

A list of vertex identifiers.

Returns:

list[Any] | None

The value of the attribute for each vertex, or None if the function is used as a “setter”.

Raises:

KeyError

If any of the vertices does not exist.

See also

vertex_attribute(), vertex_attributes(), vertices_attributes()

edges_attribute()

faces_attribute()