Mesh.faces_attribute

Mesh.faces_attribute(name, value=None, keys=None)[source]

Get or set an attribute of multiple faces.

Parameters

  • name (str) – The name of the attribute.

  • value (obj, optional) – The value of the attribute. Default is None.

  • keys (list of int, optional) – A list of face identifiers.

Returns

list or None – A list containing the value per face of the requested attribute, or None if the function is used as a “setter”.

Raises

KeyError – If any of the faces does not exist.