Mesh.faces_attributes

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

Get or set multiple attributes of multiple faces.

Parameters

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

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

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

Returns

list[dict[str, Any]] | list[list[Any]] | None – If the parameter names is empty, a list containing per face an attribute dict with all attributes (default + custom) of the face. If the parameter names is not empty, 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.