Mesh.faces_attributes

Mesh.faces_attributes(names=None, values=None, keys=None)[source]

Get or set multiple attributes of multiple faces.

Parameters

  • names (list of str, optional) – The names of the attribute. Default is None.

  • values (list of obj, optional) – The values of the attributes. Default is None.

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

Returns

dict, list or None – If the parameter names is None, a list containing per face an attribute dict with all attributes (default + custom) of the face. If the parameter names is None, a list containing per face a list of attribute values corresponding to the requested names. None if the function is used as a “setter”.

Raises

KeyError – If any of the faces does not exist.