Block.faces_attributes

Block.faces_attributes(names=None, values=None, keys=None)

Get or set multiple attributes of multiple faces.

Parameters:

nameslist[str], optional

The names of the attribute. Default is None.

valueslist[Any], optional

The values of the attributes. Default is None.

keyslist[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.

See also

face_attribute(), face_attributes(), faces_attribute()

edges_attributes()

vertices_attributes()